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 du Gestionnaire de conformité. Les audits peuvent prendre beaucoup de temps. Ce statut vous permet de suivre la progression de l'audit pendant son exécution.

Avant de commencer

Obtenir l'état d'un audit en cours

Console

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

    Accéder à "Afficher les audits"

  2. Sur la page Afficher les évaluations, vous pouvez consulter 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. Pour en savoir plus sur l'audit, cliquez sur son nom.

gcloud

La commande gcloud audit-manager operations describe 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. Les valeurs valides sont organization, folder et project.
  • RESOURCE_ID : ID de ressource de l'organisation, 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 d'Audit Manager. Par exemple : us-central1.
  • AUDIT_OPERATION_ID : identifiant 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 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 Le Gestionnaire d'audit crée un rapport d'audit à partir des données évaluées.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Le gestionnaire d'audit 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 Échec du processus de génération du rapport d'audit.

Chaque type 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. Une fois le processus 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 par 0. Une fois le processus 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 par 0. Une fois le processus 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. Les valeurs valides sont organizations, folders et projects.
  • RESOURCE_ID : ID de ressource de l'organisation, 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 d'Audit Manager. Par exemple : us-central1.
  • AUDIT_OPERATION_ID : identifiant 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 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 Le Gestionnaire d'audit crée un rapport d'audit à partir des données évaluées.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Le gestionnaire d'audit 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 Échec du processus de génération du rapport d'audit.

Chaque type 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. Une fois le processus 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 par 0. Une fois le processus 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. Une fois le processus 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"
  }
}

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

Étapes suivantes