Obtén el estado de una auditoría

En esta página, se describe cómo obtener el estado de una auditoría en curso que iniciaste con el Administrador de auditorías o el Administrador de cumplimiento. Las auditorías son operaciones de larga duración, y puede ser útil obtener el estado de una auditoría mientras se ejecuta la operación.

Antes de comenzar

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

Console

  1. En la consola de Google Cloud , 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 u 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.

gcloud

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

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

  • RESOURCE_TYPE: Es el tipo de recurso, ya sea un proyecto o una carpeta. Por ejemplo: folders o projects.
  • RESOURCE_ID: Es el ID del recurso del proyecto o la carpeta. Por ejemplo: 8767234.
  • LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditoría. 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 Es un estado no válido.
OPERATION_STATE_NOT_STARTED Aún no comenzó el proceso de generación del informe 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 El Administrador de auditorías está creando un informe de auditoría a partir de los datos evaluados.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE El Administrador de auditorías 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 evidencias al destino.
OPERATION_STATE_DONE Se completó el proceso de generación del informe de auditoría.
OPERATION_STATE_FAILED Se produjo un error en el proceso de generación del informe 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 la evaluación de la auditoría falla, este campo proporciona el motivo del error.
evaluation_percent_complete Si se inició la evaluación, este campo proporciona el porcentaje de 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 se inició la generación del informe, este campo proporciona el porcentaje de 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 se inició la carga del informe, este campo proporciona el porcentaje de 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, ya sea un proyecto o una carpeta. Por ejemplo: folders o projects.
  • RESOURCE_ID: Es el ID del recurso del proyecto o la carpeta. Por ejemplo: 8767234.
  • LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditoría. 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 Es un estado no válido.
OPERATION_STATE_NOT_STARTED Aún no comenzó el proceso de generación del informe 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 El Administrador de auditorías está creando un informe de auditoría a partir de los datos evaluados.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE El Administrador de auditorías 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 evidencias al destino.
OPERATION_STATE_DONE Se completó el proceso de generación del informe de auditoría.
OPERATION_STATE_FAILED Se produjo un error en el proceso de generación del informe 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 la evaluación de la auditoría falla, este campo proporciona el motivo del error.
evaluation_percent_complete Si se inició la evaluación, este campo proporciona el porcentaje de 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 se inició la generación del informe, este campo proporciona el porcentaje de 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 se inició la carga del informe, este campo proporciona el porcentaje de 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 REST correcta 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 sube un informe de auditoría, se devuelve un vínculo a él.

¿Qué sigue?