Obtenir l'état d'un audit

Cette page explique comment obtenir l'état d'un audit en cours que vous avez lancé à l'aide d'Audit Manager 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

  • Assurez-vous de disposer de l'un des rôles IAM suivants :

  • Identifiez l'audit dont vous souhaitez obtenir l'état.

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.

  4. (Aperçu) Facultatif : pour afficher l'état de l'audit à l'aide de la nouvelle interface de la console, procédez comme suit :

    1. Cliquez sur Passer à la nouvelle interface.

    2. Pour afficher plus d'informations sur l'audit, cliquez sur son nom.

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 une organisation (aperçu), un dossier ou un projet. Exemple : folders ou projects.
  • RESOURCE_ID : ID de ressource de l'organisation (aperçu), du projet ou du dossier. 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. 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. 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 Audit Manager évalue les ressources par rapport aux contrôles de conformité.
OPERATION_STATE_EVALUATION_DONE Audit Manager a terminé l'évaluation de la conformité.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager crée un rapport d'audit à partir des données évaluées.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager a terminé la génération du rapport d'audit.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager 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 l'une des 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 une organisation (aperçu), un dossier ou un projet. Exemple : folders ou projects.
  • RESOURCE_ID : ID de ressource de l'organisation (aperçu), du projet ou du dossier. 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. 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. 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 Audit Manager évalue les ressources par rapport aux contrôles de conformité.
OPERATION_STATE_EVALUATION_DONE Audit Manager a terminé l'évaluation de la conformité.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager crée un rapport d'audit à partir des données évaluées.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager a terminé la génération du rapport d'audit.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager 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 l'une des 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