Obtenir l'état d'un audit

Cette page explique comment obtenir l'état d'un audit en cours que vous avez lancé à l'aide du Gestionnaire d'audits ou de Compliance Manager. Les audits sont des opérations de longue durée. Il peut donc être utile d'obtenir l'état d'un audit pendant son exécution.

Avant de commencer

Obtenir l'état d'un audit en cours

Console

  1. Dans la Google Cloud console, accédez à la page Afficher les audits.

    Accéder à "Afficher les audits"

  2. Sur la page Afficher les évaluations, vous pouvez afficher l'état actuel d'un audit en cours ou obtenir plus d'informations sur un audit terminé.

  3. Pour afficher plus d'informations sur l'audit, cliquez sur le lien dans la colonne État.

gcloud

La gcloud audit-manager operations describe commande décrit une opération d'audit.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource, qui peut être un projet ou un dossier. Par exemple, folders ou projects.
  • RESOURCE_ID : ID de ressource du projet ou du dossier. Par exemple, 8767234.
  • LOCATION : emplacement du point de terminaison de l'API Audit Manager. Pour obtenir la liste des points de terminaison disponibles, consultez Emplacements du Gestionnaire d'audits. Par exemple, us-central1.
  • AUDIT_OPERATION_ID : ID unique de l'opération en cours qui a été inclus dans le corps de la réponse lorsque vous avez exécuté l'audit. Par exemple, 098234.

Exécutez la commande suivante :

Linux, macOS ou 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

Une réponse réussie inclut l'un des types d'état d'exécution suivants :

Type d'état Description
OPERATION_STATE_UNSPECIFIED État non valide.
OPERATION_STATE_NOT_STARTED Le processus de génération du rapport d'audit n'a pas encore commencé.
OPERATION_STATE_EVALUATION_IN_PROGRESS Le Gestionnaire d'audits évalue les ressources par rapport aux contrôles de conformité.
OPERATION_STATE_EVALUATION_DONE Le Gestionnaire d'audits a terminé l'évaluation de la conformité.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Le Gestionnaire d'audits crée un rapport d'audit à partir des données évaluées.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Le Gestionnaire d'audits a terminé la génération du rapport d'audit.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Le Gestionnaire d'audits importe le rapport d'audit et les preuves vers la destination.
OPERATION_STATE_DONE Le processus de génération du rapport d'audit est terminé.
OPERATION_STATE_FAILED Le processus de génération du rapport d'audit a échoué.

Chacun des types d'état d'exécution peut fournir les informations supplémentaires suivantes, le cas échéant :

État supplémentaire Description
failure_reason Si l'évaluation de l'audit échoue, ce champ indique la raison de l'échec.
evaluation_percent_complete Si l'évaluation a commencé, ce champ indique le pourcentage de progression. Lorsque le processus n'a pas encore commencé, le champ commence à 0. Lorsque le processus est terminé, le champ est défini sur 100.
report_generation_percent_complete Si la génération du rapport a commencé, ce champ indique le pourcentage de progression. Lorsque le processus n'a pas encore commencé, le champ commence à 0. Lorsque le processus est terminé, le champ est défini sur 100.
report_uploading_percent_complete Si l'importation du rapport a commencé, ce champ indique le pourcentage de progression. Lorsque le processus n'a pas encore commencé, le champ commence à 0. Lorsque le processus est terminé, le champ est défini sur 100.

Une réponse gcloud réussie ressemble à ceci :

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

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource, qui peut être un projet ou un dossier. Par exemple, folders ou projects.
  • RESOURCE_ID : ID de ressource du projet ou du dossier. Par exemple, 8767234.
  • LOCATION : emplacement du point de terminaison de l'API Audit Manager. Pour obtenir la liste des points de terminaison disponibles, consultez Emplacements du Gestionnaire d'audits. Par exemple, us-central1.
  • AUDIT_OPERATION_ID : ID unique de l'opération en cours qui a été inclus dans le corps de la réponse lorsque vous avez exécuté l'audit. Par exemple, 098234.

Méthode HTTP et URL : 

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante : 

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

Exécutez la commande suivante : 

$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

Une réponse réussie inclut l'un des types d'état d'exécution suivants :

Type d'état Description
OPERATION_STATE_UNSPECIFIED État non valide.
OPERATION_STATE_NOT_STARTED Le processus de génération du rapport d'audit n'a pas encore commencé.
OPERATION_STATE_EVALUATION_IN_PROGRESS Le Gestionnaire d'audits évalue les ressources par rapport aux contrôles de conformité.
OPERATION_STATE_EVALUATION_DONE Le Gestionnaire d'audits a terminé l'évaluation de la conformité.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Le Gestionnaire d'audits crée un rapport d'audit à partir des données évaluées.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Le Gestionnaire d'audits a terminé la génération du rapport d'audit.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Le Gestionnaire d'audits importe le rapport d'audit et les preuves vers la destination.
OPERATION_STATE_DONE Le processus de génération du rapport d'audit est terminé.
OPERATION_STATE_FAILED Le processus de génération du rapport d'audit a échoué.

Chacun des types d'état d'exécution peut fournir les informations supplémentaires suivantes, le cas échéant :

État supplémentaire Description
failure_reason Si l'évaluation de l'audit échoue, ce champ indique la raison de l'échec.
evaluation_percent_complete Si l'évaluation a commencé, ce champ indique le pourcentage de progression. Lorsque le processus n'a pas encore commencé, le champ commence à 0. Lorsque le processus est terminé, le champ est défini sur 100.
report_generation_percent_complete Si la génération du rapport a commencé, ce champ indique le pourcentage de progression. Lorsque le processus n'a pas encore commencé, le champ commence à 0. Lorsque le processus est terminé, le champ est défini sur 100.
report_uploading_percent_complete Si l'importation du rapport a commencé, ce champ indique le pourcentage de progression. Lorsque le processus n'a pas encore commencé, le champ commence à 0. Lorsque le processus est terminé, le champ est défini sur 100.

Une réponse REST réussie ressemble à ceci :

{
  "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"
  }
}

Lorsqu'un rapport d'audit est terminé et importé, un lien vers le rapport est renvoyé.

Étape suivante