Obtén el estado de una auditoría

Puedes obtener el estado de una auditoría en curso que iniciaste con Audit Manager o Compliance Manager. Las auditorías pueden tardar mucho en completarse, y hacer un seguimiento de este estado te ayuda a seguir el progreso de la auditoría mientras se ejecuta.

Antes de comenzar

Obtén el estado de una auditoría en curso

Console

  1. En la Google Cloud consola de, ve a la página Ver auditorías.

    Ir a Ver auditorías

  2. En la página Ver evaluaciones, puedes ver el estado actual de una auditoría en curso o obtener más información sobre una auditoría completada.

  3. Para ver más información sobre la auditoría, haz clic en el vínculo de la columna Estado.

  4. (Vista previa) Opcional: Para ver el estado de la auditoría con la nueva experiencia de la consola, completa lo siguiente:

    1. Haz clic en Cambiar a la nueva experiencia.

    2. Para ver más información sobre la auditoría, haz clic en su nombre.

gcloud

El gcloud audit-manager operations describe comando describe una operación de auditoría.

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • RESOURCE_TYPE: Es el tipo de recurso, que puede ser una organización (vista previa), una carpeta o un proyecto. Por ejemplo: folders o projects.
  • RESOURCE_ID: Es el ID de recurso de la organización (vista previa), el proyecto o la carpeta. Por ejemplo: 8767234.
  • LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de extremos disponibles, consulta Ubicaciones de Audit Manager. Por ejemplo: us-central1.
  • AUDIT_OPERATION_ID: Es el ID único de la operación en curso que se incluyó en el cuerpo de la respuesta cuando ejecutaste la auditoría. Por ejemplo: 098234.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud audit-manager operations describe AUDIT_OPERATION_ID \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

Windows (PowerShell)

gcloud audit-manager operations describe AUDIT_OPERATION_ID `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows (cmd.exe)

gcloud audit-manager operations describe AUDIT_OPERATION_ID ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

Una respuesta correcta incluye uno de los siguientes tipos de estado de ejecución:

Tipo de estado Descripción
OPERATION_STATE_UNSPECIFIED Un estado no válido.
OPERATION_STATE_NOT_STARTED Aún no comenzó el proceso de generación de informes de auditoría.
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager está evaluando los recursos en función de los controles de cumplimiento.
OPERATION_STATE_EVALUATION_DONE Audit Manager completó la evaluación de cumplimiento.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager está creando un informe de auditoría a partir de los datos evaluados.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager completó la generación del informe de auditoría.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager está subiendo el informe de auditoría y las pruebas al destino.
OPERATION_STATE_DONE Se completó el proceso de generación de informes de auditoría.
OPERATION_STATE_FAILED No se pudo realizar el proceso de generación de informes de auditoría.

Cada uno de los tipos de estado de ejecución puede proporcionar cualquiera de los siguientes datos adicionales, cuando corresponda:

Estado adicional Descripción
failure_reason Si falla la evaluación de auditoría, este campo proporciona el motivo de la falla.
evaluation_percent_complete Si comenzó la evaluación, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no comienza, el campo comienza en 0. Cuando finaliza el proceso, el campo se establece en 100.
report_generation_percent_complete Si comenzó la generación de informes, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no comienza, el campo comienza en 0. Cuando finaliza el proceso, el campo se establece en 100.
report_uploading_percent_complete Si comenzó la carga de informes, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no comienza, el campo comienza en 0. Cuando finaliza el proceso, el campo se establece en 100.

Una respuesta correcta de gcloud es similar a la siguiente:

done: true
name: projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID
response:
  '@type': type.googleapis.com/google.cloud.auditmanager.v1.AuditReport
  gcsUri: gs://testbucketauditmanager

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • RESOURCE_TYPE: Es el tipo de recurso, que puede ser una organización (vista previa), una carpeta o un proyecto. Por ejemplo: folders o projects.
  • RESOURCE_ID: Es el ID de recurso de la organización (vista previa), el proyecto o la carpeta. Por ejemplo: 8767234.
  • LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de extremos disponibles, consulta Ubicaciones de Audit Manager. Por ejemplo: us-central1.
  • AUDIT_OPERATION_ID: Es el ID único de la operación en curso que se incluyó en el cuerpo de la respuesta cuando ejecutaste la auditoría. Por ejemplo: 098234.

Método HTTP y URL: 

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID"

PowerShell

Ejecuta el siguiente comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID" | Select-Object -Expand Content

Una respuesta correcta incluye uno de los siguientes tipos de estado de ejecución:

Tipo de estado Descripción
OPERATION_STATE_UNSPECIFIED Un estado no válido.
OPERATION_STATE_NOT_STARTED Aún no comenzó el proceso de generación de informes de auditoría.
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager está evaluando los recursos en función de los controles de cumplimiento.
OPERATION_STATE_EVALUATION_DONE Audit Manager completó la evaluación de cumplimiento.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager está creando un informe de auditoría a partir de los datos evaluados.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager completó la generación del informe de auditoría.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager está subiendo el informe de auditoría y las pruebas al destino.
OPERATION_STATE_DONE Se completó el proceso de generación de informes de auditoría.
OPERATION_STATE_FAILED No se pudo realizar el proceso de generación de informes de auditoría.

Cada uno de los tipos de estado de ejecución puede proporcionar cualquiera de los siguientes datos adicionales, cuando corresponda:

Estado adicional Descripción
failure_reason Si falla la evaluación de auditoría, este campo proporciona el motivo de la falla.
evaluation_percent_complete Si comenzó la evaluación, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no comienza, el campo comienza en 0. Cuando finaliza el proceso, el campo se establece en 100.
report_generation_percent_complete Si comenzó la generación de informes, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no comienza, el campo comienza en 0. Cuando finaliza el proceso, el campo se establece en 100.
report_uploading_percent_complete Si comenzó la carga de informes, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no comienza, el campo comienza en 0. Cuando finaliza el proceso, el campo se establece en 100.

Una respuesta correcta de REST es similar a la siguiente:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.auditmanager.v1.AuditReport",
    "gcsUri": "gs://testbucketauditmanager"
  }
}

Cuando se completa y se sube un informe de auditoría, se muestra un vínculo al informe.

¿Qué sigue?