Les audits vous permettent de collecter les preuves dont vous avez besoin pour évaluer votre organisationGoogle Cloud par rapport aux frameworks compatibles. Vous pouvez planifier l'exécution d'un audit à intervalles réguliers ou exécuter un audit à la demande.
Un audit est une opération de longue durée qui peut prendre quelques heures. La durée dépend du nombre de ressources dans le champ d'application de l'audit, c'est-à-dire l'organisation, le projet ou le dossier que vous avez précédemment enregistré.
Vous ne pouvez créer une planification pour une combinaison de framework et de ressource spécifique que s'il n'existe pas déjà de planification active ou en pause pour cette combinaison.
Avant de commencer
Pour obtenir les autorisations nécessaires pour exécuter ou planifier un audit, demandez à votre administrateur de vous accorder l'un des rôles IAM (Identity and Access Management) suivants :
- Administrateur Audit Manager (
roles/auditmanager.admin) - Auditeur Audit Manager (
roles/auditmanager.auditor)
- Administrateur Audit Manager (
Enregistrez votre organisation, votre projet ou votre dossier pour l'audit.
Planifier et exécuter un audit
Vous pouvez créer une planification pour exécuter un audit de manière récurrente ou exécuter un audit à la demande.
Console
Dans la console Google Cloud , accédez à la page Exécuter l'évaluation dans Audit Manager.
Dans la section Choisir une ressource et une région, procédez comme suit :
Sélectionnez l'organisation, le dossier ou le projet que vous souhaitez auditer.
Sélectionnez l'emplacement où vous souhaitez traiter l'évaluation de l'audit. Pour obtenir la liste des emplacements acceptés, consultez Emplacements d'Audit Manager.
Cliquez sur Suivant.
Dans la section Choisir une réglementation, sélectionnez le framework par rapport auquel vous souhaitez auditer votre ressource, puis cliquez sur Suivant. Pour en savoir plus sur les frameworks compatibles, consultez Frameworks compatibles.
Facultatif : Si la section Configurer les paramètres s'affiche, procédez comme suit :
Cliquez sur Modifier la configuration.
Dans la fenêtre Configurer les paramètres, ajoutez les paramètres requis pour les contrôles cloud. Pour en savoir plus sur les paramètres, consultez la documentation de référence sur les contrôles cloud de Compliance Manager et les contrôles cloud d'Assured Workloads.
Cliquez sur Enregistrer.
Facultatif : Dans la section Afficher le plan d'évaluation, vous pouvez télécharger un fichier ODS contenant des informations sur le champ d'application de l'audit en fonction du framework que vous avez sélectionné. Pour télécharger le fichier, cliquez sur le lien, puis sur Suivant.
Dans la section Choisir un bucket de stockage, sélectionnez le bucket de stockage dans lequel vous souhaitez enregistrer le rapport d'audit et les preuves, puis cliquez sur OK. Si votre bucket n'est pas listé, demandez à votre administrateur d'enregistrer votre ressource avec votre bucket de stockage.
Facultatif : Dans la section Planification, définissez l'un des éléments suivants :
Fréquence de répétition de l'audit (quotidienne, hebdomadaire, mensuelle, trimestrielle ou annuelle)
Période à inclure dans l'audit. Si vous choisissez Sans fin, l'audit continuera de s'exécuter à partir de la date de début que vous spécifiez jusqu'à ce que vous l'arrêtiez manuellement.
Pour lancer l'audit, cliquez sur Exécuter l'audit ou Exécuter l'audit planifié.
Vous pouvez afficher l'état d'un audit à la demande sur la page Afficher les évaluations ou afficher vos audits planifiés dans l'onglet Plannings de la page Gestion des audits.
gcloud
Facultatif : générer une évaluation d'audit
Avant d'exécuter un audit, vous pouvez générer une évaluation ou un champ d'application de l'audit, qui inclut une répartition détaillée des tâches de l'audit en fonction du framework que vous choisissez.
La commande
gcloud audit-manager audit-scopes generate génère un champ d'application 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,folderetproject. -
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 Audit Manager. Par exemple :
us-central1. -
FRAMEWORK : ID du framework à auditer. Exemple :
builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans la console Google Cloud . - AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie.
Seul le format ODF est accepté :
AUDIT_REPORT_FORMAT_ODF. - OUTPUT_DIRECTORY : répertoire dans lequel la sortie doit être stockée. Exemple :
reports. -
OUTPUT_FILENAME : nom du fichier de sortie. N'incluez pas l'extension de fichier dans le nom de fichier. Par exemple,
scopeReport.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud audit-manager audit-scopes generate \ --RESOURCE_TYPE=RESOURCE_ID \ --location=LOCATION \ --compliance-framework=FRAMEWORK \ --report-format=AUDIT_REPORT_FORMAT \ --output-directory=OUTPUT_DIRECTORY \ --output-file-name=OUTPUT_FILENAME
Windows (PowerShell)
gcloud audit-manager audit-scopes generate ` --RESOURCE_TYPE=RESOURCE_ID ` --location=LOCATION ` --compliance-framework=FRAMEWORK ` --report-format=AUDIT_REPORT_FORMAT ` --output-directory=OUTPUT_DIRECTORY ` --output-file-name=OUTPUT_FILENAME
Windows (cmd.exe)
gcloud audit-manager audit-scopes generate ^ --RESOURCE_TYPE=RESOURCE_ID ^ --location=LOCATION ^ --compliance-framework=FRAMEWORK ^ --report-format=AUDIT_REPORT_FORMAT ^ --output-directory=OUTPUT_DIRECTORY ^ --output-file-name=OUTPUT_FILENAME
Exécuter un audit à la demande
La commande
gcloud audit-manager audit-reports generate exécute un 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,folderetproject. -
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 Audit Manager. Par exemple :
us-central1. -
FRAMEWORK : ID du framework à auditer. Exemple :
builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans la console Google Cloud . - BUCKET_URI : URI du bucket Cloud Storage. Exemple :
gs://testbucketauditmanager - AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie.
Seul le format ODF est accepté :
AUDIT_REPORT_FORMAT_ODF.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud audit-manager audit-reports generate \ --RESOURCE_TYPE=RESOURCE_ID \ --location=LOCATION \ --compliance-framework=FRAMEWORK \ --report-format=AUDIT_REPORT_FORMAT \ --gcs-uri=BUCKET_URI
Windows (PowerShell)
gcloud audit-manager audit-reports generate ` --RESOURCE_TYPE=RESOURCE_ID ` --location=LOCATION ` --compliance-framework=FRAMEWORK ` --report-format=AUDIT_REPORT_FORMAT ` --gcs-uri=BUCKET_URI
Windows (cmd.exe)
gcloud audit-manager audit-reports generate ^ --RESOURCE_TYPE=RESOURCE_ID ^ --location=LOCATION ^ --compliance-framework=FRAMEWORK ^ --report-format=AUDIT_REPORT_FORMAT ^ --gcs-uri=BUCKET_URI
Vous devriez obtenir un résultat semblable à celui-ci :
done: false name: projects/10398413/locations/987234/operations/operation-1726842525305-6228ddb4dca96-78a6db59-f9dd9a24
Planifier un audit
La commande
gcloud audit-manager audit-schedules create crée une programmation 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,folderetproject. -
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 Audit Manager. Par exemple :
us-central1. -
AUDIT_SCHEDULE_ID : ID de la planification d'audit. Exemple :
my-schedule-id. Pour trouver l'ID d'une programmation existante, consultez la page Gestion des audits dans la console Google Cloud . -
FRAMEWORK : ID du framework à auditer. Exemple :
builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans la console Google Cloud . -
AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie. Seul le format OpenDocument (ODF) est accepté :
odf. - BUCKET_URI : URI du bucket Cloud Storage. Exemple :
gs://testbucketauditmanager -
FREQUENCY : fréquence des exécutions d'audit planifiées. Les valeurs valides sont
daily,weekly,monthly,quarterlyetannually. Par exemple :weekly. -
SCHEDULE_START_TIME : date et heure de début de la première exécution d'audit, au format RFC 3339. Par exemple,
2026-10-25T10:00:00Z. -
DISPLAY_NAME (facultatif) : Nom à afficher pour la planification d'audit. Par exemple :
NIST 800-53 Weekly Audit. -
SCHEDULE_END_TIME (facultatif) : Date et heure d'arrêt de la planification d'audit, au format RFC 3339. Exemple :
2027-10-25T10:00:00Z. -
TIME_ZONE (facultatif) : Fuseau horaire de la planification d'audit au format IANA. Audit Manager utilise cette valeur pour interpréter l'heure de début et l'heure de fin. Si aucune valeur n'est spécifiée, la valeur par défaut est
UTC. Par exemple :America/New_York.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud audit-manager audit-schedules create \ --RESOURCE_TYPE=RESOURCE_ID \ --location=LOCATION \ --audit-schedule-id=AUDIT_SCHEDULE_ID \ --compliance-framework=FRAMEWORK \ --report-format=AUDIT_REPORT_FORMAT \ --gcs-uri=BUCKET_URI \ --start-time=SCHEDULE_START_TIME \ --frequency=FREQUENCY \ --display-name="DISPLAY_NAME" \ --end-time=SCHEDULE_END_TIME \ --time-zone=TIME_ZONE
Windows (PowerShell)
gcloud audit-manager audit-schedules create ` --RESOURCE_TYPE=RESOURCE_ID ` --location=LOCATION ` --audit-schedule-id=AUDIT_SCHEDULE_ID ` --compliance-framework=FRAMEWORK ` --report-format=AUDIT_REPORT_FORMAT ` --gcs-uri=BUCKET_URI ` --start-time=SCHEDULE_START_TIME ` --frequency=FREQUENCY ` --display-name="DISPLAY_NAME" ` --end-time=SCHEDULE_END_TIME ` --time-zone=TIME_ZONE
Windows (cmd.exe)
gcloud audit-manager audit-schedules create ^ --RESOURCE_TYPE=RESOURCE_ID ^ --location=LOCATION ^ --audit-schedule-id=AUDIT_SCHEDULE_ID ^ --compliance-framework=FRAMEWORK ^ --report-format=AUDIT_REPORT_FORMAT ^ --gcs-uri=BUCKET_URI ^ --start-time=SCHEDULE_START_TIME ^ --frequency=FREQUENCY ^ --display-name="DISPLAY_NAME" ^ --end-time=SCHEDULE_END_TIME ^ --time-zone=TIME_ZONE
Vous devriez obtenir un résultat semblable à celui-ci :
complianceFramework: builtin-cis-v8 gcsUri: gs://my-bucket name: projects/834/locations/us-central1/auditSchedules/my-schedule-id reportFormat: AUDIT_REPORT_FORMAT_ODF scheduleConfig: frequency: weekly startTime: '2026-10-25T10:00:00Z' state: SCHEDULE_STATE_ACTIVE
REST
Facultatif : générer une évaluation d'audit
Avant d'exécuter un audit, vous pouvez générer une évaluation ou un champ d'application de l'audit, qui inclut une répartition détaillée des tâches de l'audit en fonction du framework que vous choisissez.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
RESOURCE_TYPE : type de ressource. Les valeurs valides sont
organizations,foldersetprojects. -
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 Audit Manager. Par exemple :
us-central1. -
FRAMEWORK : ID du framework à auditer. Exemple :
builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans la console Google Cloud . - AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie.
Seul le format ODF est accepté :
AUDIT_REPORT_FORMAT_ODF.
Méthode HTTP et URL :
POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate
Corps JSON de la requête :
{
"compliance_framework" : "FRAMEWORK",
"report_format" : "AUDIT_REPORT_FORMAT"
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"scope_report_contents": "980u43nrf090834uhbkfehf......",
"name" : "folders/8767234/locations/us-west"
}
La réponse inclut les informations suivantes :
scope_report_contents: format d'octet du contenu du rapport, que vous devez convertir au format OpenDocument (ODF) avant de l'examiner.name: identifiant de chaîne unique de la ressource applicable.
Exécuter un audit à la demande
Pour exécuter un audit à la demande, envoyez une requête POST au point de terminaison auditReport:generate.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
RESOURCE_TYPE : type de ressource. Les valeurs valides sont
organizations,foldersetprojects. -
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 Audit Manager. Par exemple :
us-central1. -
FRAMEWORK : ID du framework à auditer. Exemple :
builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans la console Google Cloud . - BUCKET_URI : URI du bucket Cloud Storage. Exemple :
gs://testbucketauditmanager - AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie.
Seul le format ODF est accepté :
AUDIT_REPORT_FORMAT_ODF.
Méthode HTTP et URL :
POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate
Corps JSON de la requête :
{
"destination" : {
"gcs_uri" : "BUCKET_URI"
},
"compliance_framework" : "FRAMEWORK",
"report_format" : "AUDIT_REPORT_FORMAT"
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "organizations/834/projects/10398413/locations/987234/operations/098234",
"done": false
}
La réponse inclut les informations suivantes :
name: identifiant de chaîne unique pour la requête d'opération d'évaluation d'audit. Utilisez cet identifiant pour suivre la progression de l'évaluation d'audit. Par exemple :projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID.done: indicateur booléen qui indique si l'évaluation d'audit est terminée. Cette option est définie surfalseau début du processus et passe àtrueune fois l'évaluation d'audit terminée.
Planifier un audit
Pour planifier un audit récurrent, envoyez une requête POST au point de terminaison auditSchedules.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
RESOURCE_TYPE : type de ressource. Les valeurs valides sont
organizations,foldersetprojects. -
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 Audit Manager. Par exemple :
us-central1. -
AUDIT_SCHEDULE_ID : ID de la planification d'audit. Exemple :
my-schedule-id. Pour trouver l'ID d'une programmation existante, consultez la page Gestion des audits dans la console Google Cloud . -
FRAMEWORK : ID du framework à auditer. Exemple :
builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans la console Google Cloud . - BUCKET_URI : URI du bucket Cloud Storage. Exemple :
gs://testbucketauditmanager - AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie.
Seul le format ODF est accepté :
AUDIT_REPORT_FORMAT_ODF. -
FREQUENCY : fréquence des exécutions d'audit planifiées. Les valeurs valides sont
DAILY,WEEKLY,MONTHLY,QUARTERLYetANNUALLY. Par exemple :WEEKLY. -
SCHEDULE_START_TIME : date et heure de début de la première exécution d'audit, au format RFC 3339. Par exemple,
2026-10-25T10:00:00Z. -
DISPLAY_NAME (facultatif) : Nom à afficher pour la planification d'audit. Par exemple :
NIST 800-53 Weekly Audit. -
SCHEDULE_END_TIME (facultatif) : Date et heure d'arrêt de la planification d'audit, au format RFC 3339. Exemple :
2027-10-25T10:00:00Z. -
TIME_ZONE (facultatif) : Fuseau horaire de la planification d'audit au format IANA. Audit Manager utilise cette valeur pour interpréter l'heure de début et l'heure de fin. Si aucune valeur n'est spécifiée, la valeur par défaut est
UTC. Par exemple :America/New_York.
Méthode HTTP et URL :
POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID
Corps JSON de la requête :
{
"displayName": "DISPLAY_NAME",
"gcsUri": "BUCKET_URI",
"complianceFramework": "FRAMEWORK",
"reportFormat": "AUDIT_REPORT_FORMAT",
"scheduleConfig": {
"startTime": "SCHEDULE_START_TIME",
"endTime": "SCHEDULE_END_TIME",
"frequency": "FREQUENCY",
"timeZone": "TIME_ZONE"
}
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
"displayName": "My first audit schedule",
"gcsUri": "gs://my-bucket",
"complianceFramework": "builtin-cis-v8",
"reportFormat": "AUDIT_REPORT_FORMAT_ODF",
"scheduleConfig": {
"startTime": "2026-10-25T10:00:00Z",
"endTime": "2027-10-25T10:00:00Z",
"frequency": "WEEKLY",
"timeZone": "America/New_York"
},
"state": "SCHEDULE_STATE_ACTIVE",
"createTime": "2026-10-25T13:27:00Z",
"updateTime": "2026-10-25T13:27:00Z"
}
Afficher les audits planifiés
Vous pouvez afficher des détails sur vos audits planifiés, y compris le champ d'application, le framework et la configuration de la planification.
Console
Dans la console Google Cloud , accédez à la page Gestion des audits dans Audit Manager.
Dans l'onglet Planifications, affichez la liste des audits planifiés.
gcloud
Afficher la liste des audits planifiés
Pour afficher la liste des audits programmés, exécutez la commande
gcloud audit-manager audit-schedules list.
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,folderetproject. -
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 Audit Manager. Par exemple :
us-central1.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud audit-manager audit-schedules list \ --RESOURCE_TYPE=RESOURCE_ID \ --location=LOCATION
Windows (PowerShell)
gcloud audit-manager audit-schedules list ` --RESOURCE_TYPE=RESOURCE_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud audit-manager audit-schedules list ^ --RESOURCE_TYPE=RESOURCE_ID ^ --location=LOCATION
Vous devriez obtenir un résultat semblable à celui-ci :
┌────────────┬────────────┬──────────────┬────────────┬────────────┬───────────────┬─────────────────┬─────────────┬─────────────┬───────────────┬───────────────────┬───────────────┐
│ ID │ FRAMEWORK │ DISPLAY_NAME │ STATE │ GCS_URI │ REPORT_FORMAT │ SCHEDULE_CONFIG │ CREATE_TIME │ UPDATE_TIME │ NEXT_RUN_TIME │ LAST_TRIGGER_TIME │ ERROR_MESSAGE │
├────────────┼────────────┼──────────────┼────────────┼────────────┼───────────────┼─────────────────┼─────────────┼─────────────┼───────────────┼───────────────────┼───────────────┤
│ my-schedul │ builtin-ci │ My first aud │ SCHEDULE_S │ gs://my-bu │ AUDIT_REPORT_ │ {'frequency': │ 2026-10-25T │ 2026-10-25T │ │ │ │
│ e-id │ s-v8 │ it schedule │ TATE_ACTIV │ cket │ FORMAT_ODF │ 'weekly', │ 13:27:00Z │ 13:27:00Z │ │ │ │
│ │ │ │ E │ │ │ 'startTime': │ │ │ │ │ │
│ │ │ │ │ │ │ '2026-10-25T10: │ │ │ │ │ │
│ │ │ │ │ │ │ 00:00Z'} │ │ │ │ │ │
└────────────┴────────────┴──────────────┴────────────┴────────────┴───────────────┴─────────────────┴─────────────┴─────────────┴───────────────┴───────────────────┴───────────────┘
Afficher les détails d'un audit planifié
Pour afficher les détails d'un audit planifié spécifique, exécutez la commande
gcloud audit-manager audit-schedules describe.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
-
RESOURCE_TYPE : type de ressource. Les valeurs valides sont
organizations,foldersetprojects. -
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 Audit Manager. Par exemple :
us-central1. -
AUDIT_SCHEDULE_ID : ID de la planification d'audit. Exemple :
my-schedule-id. Pour trouver l'ID d'une programmation existante, consultez la page Gestion des audits dans la console Google Cloud .
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud audit-manager audit-schedules describe \ RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID
Windows (PowerShell)
gcloud audit-manager audit-schedules describe ` RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID
Windows (cmd.exe)
gcloud audit-manager audit-schedules describe ^ RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID
Vous devriez obtenir un résultat semblable à celui-ci :
complianceFramework: builtin-cis-v8 gcsUri: gs://my-bucket name: projects/834/locations/us-central1/auditSchedules/my-schedule-id reportFormat: AUDIT_REPORT_FORMAT_ODF scheduleConfig: frequency: weekly startTime: '2026-10-25T10:00:00Z' state: SCHEDULE_STATE_ACTIVE
REST
Afficher la liste des audits planifiés
Pour afficher la liste des audits planifiés, envoyez une requête GET au point de terminaison auditSchedules.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
RESOURCE_TYPE : type de ressource. Les valeurs valides sont
organizations,foldersetprojects. -
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 Audit Manager. Par exemple :
us-central1.
Méthode HTTP et URL :
GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules
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/auditSchedules"
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/auditSchedules" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"auditSchedules": [
{
"name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
"displayName": "My first audit schedule",
"gcsUri": "gs://my-bucket",
"complianceFramework": "builtin-cis-v8",
"reportFormat": "AUDIT_REPORT_FORMAT_ODF",
"scheduleConfig": {
"startTime": "2026-10-25T10:00:00Z",
"endTime": "2027-10-25T10:00:00Z",
"frequency": "WEEKLY",
"timeZone": "America/New_York"
},
"state": "SCHEDULE_STATE_ACTIVE",
"createTime": "2026-10-25T13:27:00Z",
"updateTime": "2026-10-25T13:27:00Z"
}
]
}
Afficher les détails d'un audit planifié
Pour afficher les détails d'un audit planifié spécifique, envoyez une requête GET au point de terminaison auditSchedules et spécifiez l'ID de la planification.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
RESOURCE_TYPE : type de ressource. Les valeurs valides sont
organizations,foldersetprojects. -
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 Audit Manager. Par exemple :
us-central1. -
AUDIT_SCHEDULE_ID : ID de la planification d'audit. Exemple :
my-schedule-id. Pour trouver l'ID d'une programmation existante, consultez la page Gestion des audits dans la console Google Cloud .
Méthode HTTP et URL :
GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_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/auditSchedules/AUDIT_SCHEDULE_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/auditSchedules/AUDIT_SCHEDULE_ID" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
"displayName": "My first audit schedule",
"gcsUri": "gs://my-bucket",
"complianceFramework": "builtin-cis-v8",
"reportFormat": "AUDIT_REPORT_FORMAT_ODF",
"scheduleConfig": {
"startTime": "2026-10-25T10:00:00Z",
"endTime": "2027-10-25T10:00:00Z",
"frequency": "WEEKLY",
"timeZone": "America/New_York"
},
"state": "SCHEDULE_STATE_ACTIVE",
"createTime": "2026-10-25T13:27:00Z",
"updateTime": "2026-10-25T13:27:00Z"
}
Mettre à jour les audits planifiés
Vous pouvez suspendre, reprendre et arrêter les audits récurrents. Pour modifier une planification, vous devez supprimer l'audit planifié existant, puis en créer un autre.
Console
Dans la console Google Cloud , accédez à la page Gestion des audits dans Audit Manager.
Dans l'onglet Programmations, recherchez l'audit programmé que vous souhaitez modifier.
Effectuez l'une des opérations suivantes :
Pour suspendre une planification d'audit, cliquez sur Suspendre la planification.
Pour redémarrer un audit que vous avez mis en pause, cliquez sur Reprendre la programmation.
Pour supprimer un audit planifié, cliquez sur Arrêter la planification.
gcloud
Pour suspendre, reprendre ou supprimer une planification d'audit, exécutez la commande
gcloud audit-manager audit-schedules update pour mettre à jour l'état de la planification.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
-
RESOURCE_TYPE : type de ressource. Les valeurs valides sont
organizations,foldersetprojects. -
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 Audit Manager. Par exemple :
us-central1. -
AUDIT_SCHEDULE_ID : ID de la planification d'audit. Exemple :
my-schedule-id. Pour trouver l'ID d'une programmation existante, consultez la page Gestion des audits dans la console Google Cloud . -
SCHEDULE_STATE : état cible de la planification d'audit. Définissez cette option sur l'une des valeurs suivantes :
paused: pour suspendre une programmation active.active: pour reprendre une programmation mise en pause.deleted: pour arrêter et supprimer une programmation.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud audit-manager audit-schedules update \ RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID \ --state=SCHEDULE_STATE
Windows (PowerShell)
gcloud audit-manager audit-schedules update ` RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID ` --state=SCHEDULE_STATE
Windows (cmd.exe)
gcloud audit-manager audit-schedules update ^ RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID ^ --state=SCHEDULE_STATE
Vous devriez obtenir un résultat semblable à celui-ci :
complianceFramework: builtin-cis-v8 gcsUri: gs://my-bucket name: projects/834/locations/us-central1/auditSchedules/my-schedule-id reportFormat: AUDIT_REPORT_FORMAT_ODF scheduleConfig: frequency: daily startTime: '2026-02-25T10:00:00Z' state: SCHEDULE_STATE_PAUSED
REST
Pour suspendre, reprendre ou supprimer une planification d'audit, envoyez une requête PATCH pour mettre à jour le champ state de la planification d'audit.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
RESOURCE_TYPE : type de ressource. Les valeurs valides sont
organizations,foldersetprojects. -
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 Audit Manager. Par exemple :
us-central1. -
AUDIT_SCHEDULE_ID : ID de la planification d'audit. Exemple :
my-schedule-id. Pour trouver l'ID d'une programmation existante, consultez la page Gestion des audits dans la console Google Cloud . -
SCHEDULE_STATE : état cible de la planification d'audit. Définissez cette option sur l'une des valeurs suivantes :
SCHEDULE_STATE_PAUSED: pour suspendre une programmation active.SCHEDULE_STATE_ACTIVE: pour reprendre une programmation mise en pause.SCHEDULE_STATE_DELETED: pour arrêter et supprimer une programmation.
Méthode HTTP et URL :
PATCH https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state
Corps JSON de la requête :
{
"state": "SCHEDULE_STATE"
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
"displayName": "My first audit schedule",
"gcsUri": "gs://my-bucket",
"complianceFramework": "builtin-cis-v8",
"reportFormat": "AUDIT_REPORT_FORMAT_ODF",
"scheduleConfig": {
"startTime": "2026-02-25T10:00:00Z",
"endTime": "2027-02-25T10:00:00Z",
"frequency": "DAILY",
"timeZone": "America/New_York"
},
"state": "SCHEDULE_STATE_PAUSED",
"createTime": "2026-02-25T13:27:00Z",
"updateTime": "2026-09-11T18:15:00Z"
}