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 en el Administrador de auditorías. Las auditorías son operaciones de larga duración, por lo que 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 Administrador de auditorías.

    Ir al Administrador de auditoría

  2. En la sección Auditorías de cumplimiento, haz clic en Ver auditorías.

  3. 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.

  4. 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: folder.
  • 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. 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

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: folder.
  • 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. 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/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/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/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: 

  
Status type
  Description
  

  OPERATION_STATE_UNSPECIFIED
  An invalid state.
  

  

  OPERATION_STATE_NOT_STARTED
  The audit report generation process has not yet started.
  

  

  OPERATION_STATE_EVALUATION_IN_PROGRESS
  Audit Manager is evaluating the resources against compliance
   controls.
  

  

  OPERATION_STATE_EVALUATION_DONE
  Audit Manager has completed
    compliance evaluation.
  

    

  OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS
  Audit Manager is creating an audit report from the evaluated data.
  

  

  OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE
  Audit Manager has completed the generation of the audit report.
  

  

  OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS
  Audit Manager is uploading the audit report and evidence to the destination.
  

  

  OPERATION_STATE_DONE
  The audit report generation process is completed.
  

  

  OPERATION_STATE_FAILED
  The audit report generation process has failed.
  




  
Each of the execution status types might provide any of the following additional information, when applicable:


  

  
Additional status
  Description
  

  failure_reason
  If the audit assessment fails, this field
   provides the reason for the failure.
  

  

  evaluation_percent_complete
  If evaluation has started, this
    field provides the percentage of the progress.
    When the process is yet to start, the field starts at 0.
    When the process is concluded, the field is
    set to 100.
  

  

  report_generation_percent_complete
  If the report generation has started, this
    field provides percentage of the progress. When the process is yet to start,
    the field starts at 0. When the process is concluded, the field is
    set to 100.
  

  

  report_uploading_percent_complete
  If the report uploading has started, this
    field provides percentage of the progress. When the process is yet to start,
    the field starts at 0. When the process is concluded, the field is set to 100.

Cuando se completa y sube un informe de auditoría, se devuelve un vínculo a él.

¿Qué sigue?