Cette page explique comment afficher l'historique des éléments. L'API Cloud Asset vous permet d'afficher l'historique des modifications d'événements de plusieurs éléments dont la période chevauche une période donnée au cours des 35 derniers jours. L'historique des modifications d'événements vous permet de voir tous les événements de création, de suppression et de mise à jour des éléments spécifiés au fil du temps.
Avant de commencer
gcloud
Vous devez activer l'API Cloud Asset avant de pouvoir utiliser gcloud CLI pour accéder à l'inventaire des éléments cloud. Notez que L'API ne doit être activée que sur le projet où vous exécutez l'API Cloud Asset à partir de ces commandes.
Installez la Google Cloud CLI sur votre client local.
REST
Vérifiez que vous avez accès à la commande
curl
.Assurez-vous que votre compte dispose de l'un des rôles suivants pour votre projet, votre dossier ou votre organisation :
Lecteur d'éléments Cloud (
roles/cloudasset.viewer
)Rôle de base Propriétaire (
roles/owner
)
Configurer un compte
Selon le paramètre contentType
de la requête API, pour appeler l'API Cloud Asset, votre compte doit disposer d'un rôle contenant les autorisations suivantes sur la ressource racine/parente (projet ou organisation) contenant les éléments pour lesquels vous souhaitez obtenir l'historique :
cloudasset.assets.exportResource
(pour les ressources et les relations)cloudasset.assets.exportIamPolicy
cloudasset.assets.exportOrgPolicy
cloudasset.assets.exportAccessPolicy
Si votre compte dispose du rôle Lecteur d'éléments Cloud (roles/cloudasset.viewer
), du rôle Propriétaire d'éléments Cloud (roles/cloudasset.owner
), ou du rôle de base Propriétaire (roles/owner
) sur la racine de la ressource, il possède déjà les autorisations suffisantes pour appeler l'API Cloud Asset.
Sinon, suivez les étapes décrites sur la page Configurer des autorisations.
Obtenir l'historique des éléments
Les exemples suivants montrent comment obtenir les fonctions l'historique des éléments au cours d'une période donnée. Obtenir l'historique des éléments d'une dossier non pris en charge.
Obtenir l'historique d'éléments spécifiques d'un projet, y compris toutes les métadonnées de ressources
gcloud
Projets
gcloud asset get-history \
--project=PROJECT_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--content-type=resource \
--start-time="START_TIME" \
--end-time="END_TIME"
Indiquez les valeurs suivantes :
PROJECT_ID
: ID du projet dont les éléments pour lesquels vous souhaitez consulter l'historique.ASSET_NAME
: liste d'éléments séparés par une virgule noms complets que vous souhaitez de l'historique de recherche.START_TIME
: début de la période. La valeur doit correspondre à l'heure actuelle ou à une heure ne dépassant pas 35 jours le passé. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.END_TIME
: facultatif. Point de fin de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Si aucune valeur n'est fournie, l'heure de fin est utilisée par défaut. correspond à l'heure actuelle. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.
Supprimez l'option --content-type
pour exclure les métadonnées de ressources.
Organisations
gcloud asset get-history \
--organization=ORGANIZATION_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--content-type=resource \
--start-time="START_TIME" \
--end-time="END_TIME"
Indiquez les valeurs suivantes :
ORGANIZATION_ID
: ID de l'organisation dont vous souhaitez consulter l'historique.Trouver un ID d'organisation Google Cloud
Console
Pour trouver un ID d'organisation Google Cloud, procédez comme suit :
-
Accédez à Google Cloud Console.
- Cliquez sur la case de sélecteur dans la barre de menu.
- Cliquez sur la zone Sélectionner à partir de, puis sélectionnez votre organisation.
- Cliquez sur l'onglet Tous. L'ID de l'organisation s'affiche à côté de son nom.
CLI gcloud
Vous pouvez récupérer un ID d'organisation Google Cloud à l'aide de la commande suivante:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
ASSET_NAME
: liste des noms complets des composants pour lesquels vous souhaitez obtenir l'historique, séparés par une virgule.START_TIME
: début de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.END_TIME
: facultatif. Point de fin de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Si aucune valeur n'est fournie, l'heure de fin est utilisée par défaut. correspond à l'heure actuelle. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.
Supprimez l'option --content-type
pour exclure les métadonnées de ressource.
REST
curl -X POST \
-H "X-HTTP-Method-Override: GET" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"assetNames": [
"ASSET_NAME_1",
"ASSET_NAME_2",
"..."
],
"contentType": "RESOURCE",
"readTimeWindow": {
"startTime": "START_TIME",
"endTime": "END_TIME"
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE:batchGetAssetsHistory
Indiquez les valeurs suivantes :
ASSET_NAME
: liste d'éléments séparés par une virgule noms complets que vous souhaitez de l'historique de recherche.START_TIME
: facultatif. depuis toujours au format RFC 3339. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours.END_TIME
: facultatif. Point de fin de la période, au format RFC 3339. La valeur doit correspondre à l'heure actuelle ou à une heure ne dépassant pas 35 jours de la passé. Si elle n'est pas fournie, l'heure de fin est supposée être l'heure actuelle.SCOPE
: un champ d'application peut être un projet, un dossier ou une organisation.Les valeurs autorisées sont les suivantes :
projects/PROJECT_ID
projects/PROJECT_NUMBER
Trouver un numéro de projet Google Cloud
Console
Pour trouver un numéro de projet Google Cloud, procédez comme suit:
-
Accédez à la page Tableau de bord de la console Google Cloud.
- Cochez la case Activer dans la barre de menu.
- Sélectionnez votre organisation dans le champ Sélectionner une organisation, puis recherchez le nom de votre projet.
- Cliquez sur le nom du projet pour y accéder. Le numéro de projet est indiqué dans Fiche Informations sur le projet.
CLI gcloud
Vous pouvez récupérer un numéro de projet Google Cloud à l'aide de la commande suivante :
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
organizations/ORGANIZATION_ID
Trouver un ID d'organisation Google Cloud
Console
Pour trouver un ID d'organisation Google Cloud, procédez comme suit :
-
Accédez à Google Cloud Console.
- Cochez la case Activer dans la barre de menu.
- Cliquez sur la zone Sélectionner à partir de, puis sélectionnez votre organisation.
- Cliquez sur l'onglet Tous. L'ID de l'organisation s'affiche à côté de son nom.
CLI gcloud
Vous pouvez récupérer un ID d'organisation Google Cloud à l'aide de la commande suivante:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
Supprimez la paire clé/valeur contentType
pour exclure les métadonnées de ressource.
Obtenir l'historique de toutes les stratégies IAM d'éléments spécifiques dans un projet
gcloud
Projets
gcloud asset get-history \
--project=PROJECT_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--content-type=iam-policy \
--start-time="START_TIME" \
--end-time="END_TIME"
Indiquez les valeurs suivantes :
PROJECT_ID
: ID du projet dont les éléments pour lesquels vous souhaitez consulter l'historique.ASSET_NAME
: liste des noms complets des composants pour lesquels vous souhaitez obtenir l'historique, séparés par une virgule.START_TIME
: début de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Pour en savoir plus sur les formats d'heure, consultez gcloud topic datetimesEND_TIME
: facultatif. Le point d'arrivée de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Lorsqu'elle n'est pas fournie, l'heure de fin est supposée être l'heure actuelle. Pour en savoir plus sur les formats d'heure, consultez gcloud topic datetimes
Organisations
gcloud asset get-history \
--organization=ORGANIZATION_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--content-type=iam-policy \
--start-time="START_TIME" \
--end-time="END_TIME"
Indiquez les valeurs suivantes :
ORGANIZATION_ID
: ID de l'organisation dont vous souhaitez consulter l'historique.Trouver un ID d'organisation Google Cloud
Console
Pour trouver un ID d'organisation Google Cloud, procédez comme suit :
-
Accédez à Google Cloud Console.
- Cliquez sur le boutons d'activation/de désactivation dans la barre de menu.
- Cliquez sur la zone Sélectionner à partir de, puis sélectionnez votre organisation.
- Cliquez sur l'onglet Tous. L'ID de l'organisation s'affiche à côté de son nom.
CLI gcloud
Vous pouvez récupérer un ID d'organisation Google Cloud à l'aide de la commande suivante:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
ASSET_NAME
: liste d'éléments séparés par une virgule noms complets que vous souhaitez de l'historique de recherche.START_TIME
: début de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Pour en savoir plus sur les formats d'heure, consultez gcloud topic datetimesEND_TIME
: facultatif. Le point d'arrivée de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Si aucune valeur n'est fournie, l'heure de fin est utilisée par défaut. correspond à l'heure actuelle. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.
REST
curl -X POST \
-H "X-HTTP-Method-Override: GET" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"assetNames": [
"ASSET_NAME_1",
"ASSET_NAME_2",
"..."
],
"contentType": "IAM_POLICY",
"readTimeWindow": {
"startTime": "START_TIME",
"endTime": "END_TIME"
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE:batchGetAssetsHistory
Indiquez les valeurs suivantes :
ASSET_NAME
: liste d'éléments séparés par une virgule noms complets que vous souhaitez de l'historique de recherche.START_TIME
: facultatif. depuis toujours au format RFC 3339. La valeur doit correspondre à l'heure actuelle ou à une heure située au moins 35 jours en arrière.END_TIME
: facultatif. Le point d'arrivée au format RFC 3339. La valeur doit correspondre à l'heure actuelle ou à une heure ne dépassant pas 35 jours de la passé. Si elle n'est pas fournie, l'heure de fin est supposée correspondre à l'heure actuelle.SCOPE
: un champ d'application peut être un projet, un dossier ou une organisation.Les valeurs autorisées sont les suivantes :
projects/PROJECT_ID
projects/PROJECT_NUMBER
Trouver un numéro de projet Google Cloud
Console
Pour trouver un numéro de projet Google Cloud, procédez comme suit:
-
Accédez à la page Tableau de bord de la console Google Cloud.
- Cliquez sur le boutons d'activation/de désactivation dans la barre de menu.
- Sélectionnez votre organisation dans le champ Sélectionner une organisation, puis recherchez le nom de votre projet.
- Cliquez sur le nom du projet pour y accéder. Le numéro de projet est indiqué dans Fiche Informations sur le projet.
CLI gcloud
Vous pouvez récupérer un numéro de projet Google Cloud à l'aide de la commande suivante :
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
projects/PROJECT_NUMBER
Trouver un numéro de projet Google Cloud
Console
Pour trouver un numéro de projet Google Cloud, procédez comme suit:
-
Accédez à la page Tableau de bord de la console Google Cloud.
- Cliquez sur la case de sélecteur dans la barre de menu.
- Sélectionnez votre organisation dans le champ Sélectionner une organisation, puis recherchez le nom de votre projet.
- Cliquez sur le nom du projet pour y accéder. Le numéro de projet est indiqué dans Fiche Informations sur le projet.
CLI gcloud
Vous pouvez récupérer un numéro de projet Google Cloud à l'aide de la commande suivante :
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
organizations/ORGANIZATION_ID
Trouver un ID d'organisation Google Cloud
Console
Pour trouver un ID d'organisation Google Cloud, procédez comme suit :
-
Accédez à Google Cloud Console.
- Cliquez sur la case de sélecteur dans la barre de menu.
- Cliquez sur la zone Sélectionner à partir de, puis sélectionnez votre organisation.
- Cliquez sur l'onglet Tous. L'ID de l'organisation s'affiche à côté de son nom.
CLI gcloud
Vous pouvez récupérer un ID d'organisation Google Cloud à l'aide de la commande suivante :
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
Obtenir l'historique de toutes les relations d'éléments spécifiques dans un projet
gcloud
Projets
gcloud asset get-history \
--project=PROJECT_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--content-type=relationship \
--start-time="START_TIME" \
--end-time="END_TIME"
Indiquez les valeurs suivantes :
PROJECT_ID
: ID du projet dont les éléments pour lesquels vous souhaitez consulter l'historique.ASSET_NAME
: liste d'éléments séparés par une virgule noms complets que vous souhaitez de l'historique de recherche.START_TIME
: début de la période. La valeur doit correspondre à l'heure actuelle ou à une heure ne dépassant pas 35 jours le passé. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.END_TIME
: facultatif. Le point d'arrivée de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Si aucune valeur n'est fournie, l'heure de fin est utilisée par défaut. correspond à l'heure actuelle. Pour en savoir plus sur les formats d'heure, consultez gcloud topic datetimes
Organisations
gcloud asset get-history \
--organization=ORGANIZATION_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--content-type=relationship \
--start-time="START_TIME" \
--end-time="END_TIME"
Indiquez les valeurs suivantes :
ORGANIZATION_ID
: ID de l'organisation dont vous souhaitez consulter l'historique.Trouver un ID d'organisation Google Cloud
Console
Pour trouver un ID d'organisation Google Cloud, procédez comme suit :
-
Accédez à Google Cloud Console.
- Cochez la case Activer dans la barre de menu.
- Cliquez sur la zone Sélectionner à partir de, puis sélectionnez votre organisation.
- Cliquez sur l'onglet Tous. L'ID de l'organisation s'affiche à côté de son nom.
CLI gcloud
Vous pouvez récupérer un ID d'organisation Google Cloud à l'aide de la commande suivante :
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
ASSET_NAME
Liste des noms complets des éléments pour lesquels vous souhaitez obtenir l'historique, séparés par une virgule.START_TIME
: début de la période. La valeur doit correspondre à l'heure actuelle ou à une heure ne dépassant pas 35 jours le passé. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.END_TIME
: facultatif. Le point d'arrivée de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Si aucune valeur n'est fournie, l'heure de fin est utilisée par défaut. correspond à l'heure actuelle. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.
REST
curl -X POST \
-H "X-HTTP-Method-Override: GET" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"assetNames": [
"ASSET_NAME_1",
"ASSET_NAME_2",
"..."
],
"contentType": "RELATIONSHIP",
"readTimeWindow": {
"startTime": "START_TIME",
"endTime": "END_TIME"
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE:batchGetAssetsHistory
Indiquez les valeurs suivantes :
ASSET_NAME
: liste des noms complets des composants pour lesquels vous souhaitez obtenir l'historique, séparés par une virgule.START_TIME
: facultatif. Début de la période, au format RFC 3339. La valeur doit correspondre à l'heure actuelle ou à une heure ne dépassant pas 35 jours de la passé.END_TIME
: facultatif. Point de fin de la plage temporelle, au format RFC 3339. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Si elle n'est pas fournie, l'heure de fin est supposée correspondre à l'heure actuelle.SCOPE
: un champ d'application peut être un projet, un dossier ou une organisation.Les valeurs autorisées sont les suivantes :
projects/PROJECT_ID
projects/PROJECT_NUMBER
Trouver un numéro de projet Google Cloud
Console
Pour trouver un numéro de projet Google Cloud, procédez comme suit:
-
Accédez à la page Tableau de bord de la console Google Cloud.
- Cliquez sur la case de sélecteur dans la barre de menu.
- Sélectionnez votre organisation dans le champ Sélectionner une organisation, puis recherchez le nom de votre projet.
- Cliquez sur le nom du projet pour y accéder. Le numéro de projet est indiqué dans Fiche Informations sur le projet.
CLI gcloud
Vous pouvez récupérer un numéro de projet Google Cloud à l'aide de la commande suivante :
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
organizations/ORGANIZATION_ID
Trouver un ID d'organisation Google Cloud
Console
Pour trouver un ID d'organisation Google Cloud, procédez comme suit :
-
Accédez à Google Cloud Console.
- Cochez la case Activer dans la barre de menu.
- Cliquez sur la zone Sélectionner à partir de, puis sélectionnez votre organisation.
- Cliquez sur l'onglet Tous. L'ID de l'organisation s'affiche à côté de son nom.
CLI gcloud
Vous pouvez récupérer un ID d'organisation Google Cloud à l'aide de la commande suivante :
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
Obtenir l'historique de relations spécifiques d'éléments spécifiques dans un projet
gcloud
Projets
gcloud asset get-history \
--project=PROJECT_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--content-type=relationship \
--relationship-types=INSTANCE_TO_INSTANCEGROUP \
--start-time="START_TIME" \
--end-time="END_TIME"
Indiquez les valeurs suivantes :
PROJECT_ID
: ID du projet dont vous souhaitez obtenir l'historique des composants.ASSET_NAME
: liste des noms complets des composants pour lesquels vous souhaitez obtenir l'historique, séparés par une virgule.START_TIME
: début de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Pour en savoir plus sur les formats d'heure, consultez gcloud topic datetimesEND_TIME
: facultatif. Le point d'arrivée de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Lorsqu'elle n'est pas fournie, l'heure de fin est supposée être l'heure actuelle. Pour en savoir plus sur les formats d'heure, consultez gcloud topic datetimes
Organisations
gcloud asset get-history \
--organization=ORGANIZATION_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--content-type=relationship \
--relationship-types=INSTANCE_TO_INSTANCEGROUP \
--start-time="START_TIME" \
--end-time="END_TIME"
Indiquez les valeurs suivantes :
ORGANIZATION_ID
: ID de l'organisation dont vous souhaitez consulter l'historique.Trouver un ID d'organisation Google Cloud
Console
Pour trouver un ID d'organisation Google Cloud, procédez comme suit :
-
Accédez à Google Cloud Console.
- Cliquez sur la case de sélecteur dans la barre de menu.
- Cliquez sur la zone Sélectionner à partir de, puis sélectionnez votre organisation.
- Cliquez sur l'onglet Tous. L'ID de l'organisation s'affiche à côté de son nom.
CLI gcloud
Vous pouvez récupérer un ID d'organisation Google Cloud à l'aide de la commande suivante:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
ASSET_NAME
: liste des noms complets des composants pour lesquels vous souhaitez obtenir l'historique, séparés par une virgule.START_TIME
: début de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.END_TIME
: facultatif. Point de fin de la période. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Si aucune valeur n'est fournie, l'heure de fin est utilisée par défaut. correspond à l'heure actuelle. Pour en savoir plus sur les formats de date et d'heure, consultez la section Date et heure gcloud.
REST
curl -X POST \
-H "X-HTTP-Method-Override: GET" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"assetNames": [
"ASSET_NAME_1",
"ASSET_NAME_2",
"..."
],
"contentType": "RELATIONSHIP",
"relationshipTypes": "INSTANCE_TO_INSTANCEGROUP",
"readTimeWindow": {
"startTime": "START_TIME",
"endTime": "END_TIME"
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE:batchGetAssetsHistory
Indiquez les valeurs suivantes :
ASSET_NAME
: liste des noms complets des composants pour lesquels vous souhaitez obtenir l'historique, séparés par une virgule.START_TIME
: facultatif. depuis toujours au format RFC 3339. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours.END_TIME
: facultatif. Point de fin de la période, au format RFC 3339. La valeur doit être l'heure actuelle ou une heure datant de moins de 35 jours. Si elle n'est pas fournie, l'heure de fin est supposée être l'heure actuelle.SCOPE
: un champ d'application peut être un projet, un dossier ou une organisation.Les valeurs autorisées sont les suivantes :
projects/PROJECT_ID
projects/PROJECT_NUMBER
Trouver un numéro de projet Google Cloud
Console
Pour trouver un numéro de projet Google Cloud, procédez comme suit:
-
Accédez à la page Tableau de bord de la console Google Cloud.
- Cliquez sur la case de sélecteur dans la barre de menu.
- Sélectionnez votre organisation dans le champ Sélectionner une organisation, puis recherchez le nom de votre projet.
- Cliquez sur le nom du projet pour y accéder. Le numéro de projet est indiqué dans Fiche Informations sur le projet.
CLI gcloud
Vous pouvez récupérer un numéro de projet Google Cloud à l'aide de la commande suivante :
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
organizations/ORGANIZATION_ID
Trouver un ID d'organisation Google Cloud
Console
Pour trouver un ID d'organisation Google Cloud, procédez comme suit :
-
Accédez à Google Cloud Console.
- Cochez la case Activer dans la barre de menu.
- Cliquez sur la zone Sélectionner à partir de, puis sélectionnez votre organisation.
- Cliquez sur l'onglet Tous. L'ID de l'organisation s'affiche à côté de son nom.
CLI gcloud
Vous pouvez récupérer un ID d'organisation Google Cloud à l'aide de la commande suivante:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-