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 Gestor de auditorías o 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 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 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.

  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 Gestor de auditorías. Para obtener una lista de extremos disponibles, consulta Ubicaciones de Gestor de auditorías. 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 Gestor de auditorías está evaluando los recursos en función de los controles de cumplimiento.
OPERATION_STATE_EVALUATION_DONE Gestor de auditorías completó la evaluación de cumplimiento.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Gestor de auditorías está creando un informe de auditoría a partir de los datos evaluados.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Gestor de auditorías completó la generación del informe de auditoría.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Gestor de auditorías está subiendo el informe de auditoría y las evidencias 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 la siguiente información adicional, 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 Gestor de auditorías. Para obtener una lista de extremos disponibles, consulta Ubicaciones de Gestor de auditorías. 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 Gestor de auditorías está evaluando los recursos en función de los controles de cumplimiento.
OPERATION_STATE_EVALUATION_DONE Gestor de auditorías completó la evaluación de cumplimiento.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Gestor de auditorías está creando un informe de auditoría a partir de los datos evaluados.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Gestor de auditorías completó la generación del informe de auditoría.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Gestor de auditorías está subiendo el informe de auditoría y las evidencias 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 la siguiente información adicional, 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?