Obtenir l'état d'un audit

Vous pouvez obtenir l'état d'un audit en cours que vous avez lancé à l'aide du Gestionnaire d'audits ou de Compliance Manager. Les audits peuvent prendre beaucoup de temps. Le suivi de leur état vous permet de suivre leur progression pendant leur 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.

  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 la section Emplacements du Gestionnaire d’audits. Exemple : us-central1.
  • AUDIT_OPERATION_ID : identifiant unique de l'opération en cours incluse 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 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 à ce qui suit :

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 la section Emplacements du Gestionnaire d’audits. Exemple : us-central1.
  • AUDIT_OPERATION_ID : identifiant unique de l'opération en cours incluse 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 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 à ce qui suit :

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

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

Étape suivante