Afficher les données de VM Manager

Cette rubrique explique comment configurer l'inventaire des éléments cloud et l'inventaire du système d'exploitation de VM Manager afin d'afficher les informations d'exécution de vos VM.

Avant de commencer

Avant de commencer, suivez les étapes ci-dessous.

Activez l'API Cloud Asset Inventory sur le projet dans lequel vous allez exécuter les commandes de l'API.

Activer l'API Cloud Asset Inventory
Configurez les autorisations requises pour appeler l'API Cloud Asset Inventory à l'aide de gcloud CLI ou de l'API.
Pour configurer votre environnement, procédez comme suit :
gcloud CLI
Pour configurer votre environnement afin qu'il utilise la gcloud CLI pour appeler l'API Cloud Asset Inventory, installez la Google Cloud CLI sur votre client local.
REST
Pour configurer votre environnement afin d'appeler l'API Cloud Asset Inventory à l'aide de la commande curl, procédez comme suit.
1. Vérifiez que vous avez accès à la commande curl.
2. Assurez-vous d'attribuer à votre compte l'un des rôles suivants sur votre projet, dossier ou organisation.
  - Rôle Lecteur d'éléments cloud (roles/cloudasset.viewer)
  - Rôle de base Propriétaire (roles/owner)

Activer l'inventaire d'OS

Pour activer l'inventaire du système d'exploitation, qui fait partie de la suite VM Manager, suivez les étapes correspondantes dans Configurer VM Manager.

Définir des autorisations

Assurez-vous que votre compte dispose de l'autorisation cloudasset.assets.exportOSInventories sur la ressource racine contenant les éléments que vous souhaitez exporter. Vous pouvez accorder cette autorisation individuellement ou attribuer l'un des rôles suivants sur la ressource racine.

Rôle Lecteur d'éléments cloud (roles/cloudasset.viewer)
Rôle Propriétaire d'éléments cloud (roles/cloudasset.owner)

Découvrez comment configurer les autorisations et les rôles IAM de l'inventaire des éléments cloud.

Exporter des données VM Manager vers BigQuery

Pour exporter un instantané d'inventaire du système d'exploitation à un horodatage donné, utilisez la commande suivante.

gcloud

Projets

gcloud asset export \
    --project=PROJECT_ID \
    --billing-project=BILLING_PROJECT_ID \
    --content-type=os-inventory \
    --snapshot-time="SNAPSHOT_TIME" \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --output-bigquery-force

Indiquez les valeurs suivantes :

PROJECT_ID: ID du projet dont les métadonnées sont en cours d'exportation.
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer vos ensembles de données et tables BigQuery. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
SNAPSHOT_TIME : facultatif. Heure à laquelle vous souhaitez prendre un instantané de vos éléments. La valeur doit correspondre à l'heure actuelle ou à une heure dans le passé. Par défaut, un instantané est pris à l'heure actuelle. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.
DATASET_ID : ID de l'ensemble de données BigQuery.
TABLE_NAME: table vers laquelle vous exportez vos métadonnées.

Autres indicateurs:

--output-bigquery-force: écrase la table de destination si elle existe.

Dossiers

gcloud asset export \
    --folder=FOLDER_ID \
    --billing-project=BILLING_PROJECT_ID \
    --content-type=os-inventory \
    --snapshot-time="SNAPSHOT_TIME" \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --output-bigquery-force

Indiquez les valeurs suivantes :

FOLDER_ID: ID du dossier dont les métadonnées sont en cours d'exportation.
Trouver un ID de dossier Google Cloud
Console

Pour trouver un ID de dossier Google Cloud, procédez comme suit:

Accédez à Google Cloud Console.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.

Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
gcloud CLI

Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.

Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:

gcloud resource-manager folders list --folder=FOLDER_ID
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer vos ensembles de données et tables BigQuery. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
SNAPSHOT_TIME : facultatif. Heure à laquelle vous souhaitez prendre un instantané de vos éléments. La valeur doit correspondre à l'heure actuelle ou à une heure dans le passé. Par défaut, un instantané est pris à l'heure actuelle. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.
DATASET_ID : ID de l'ensemble de données BigQuery.
TABLE_NAME: table vers laquelle vous exportez vos métadonnées.

Autres indicateurs:

--output-bigquery-force: écrase la table de destination si elle existe.

Organisations

gcloud asset export \
    --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID \
    --content-type=os-inventory \
    --snapshot-time="SNAPSHOT_TIME" \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --output-bigquery-force

Indiquez les valeurs suivantes :

ORGANIZATION_ID: ID de l'organisation dont les métadonnées sont exportées.
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.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ 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.
gcloud CLI

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))"
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer vos ensembles de données et tables BigQuery. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
SNAPSHOT_TIME : facultatif. Heure à laquelle vous souhaitez prendre un instantané de vos éléments. La valeur doit correspondre à l'heure actuelle ou à une heure dans le passé. Par défaut, un instantané est pris à l'heure actuelle. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.
DATASET_ID : ID de l'ensemble de données BigQuery.
TABLE_NAME: table vers laquelle vous exportez vos métadonnées.

Autres indicateurs:

--output-bigquery-force: écrase la table de destination si elle existe.

REST

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "contentType": "OS_INVENTORY",
          "readTime": "SNAPSHOT_TIME",
          "outputConfig": {
            "bigqueryDestination": {
              "dataset": "projects/PROJECT_ID/datasets/DATASET_ID",
              "table": "TABLE_NAME",
              "force": true
            }
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:exportAssets

Indiquez les valeurs suivantes :

BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer vos ensembles de données et tables BigQuery. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
SNAPSHOT_TIME : facultatif. Heure à laquelle vous souhaitez prendre un instantané de vos éléments, au format RFC 3339. La valeur doit correspondre à l'heure actuelle ou à une heure antérieure de 35 jours maximum. Lorsqu'il n'est pas fourni, un instantané est pris à l'heure actuelle.
PROJECT_ID: ID du projet dans lequel se trouve la table BigQuery.
DATASET_ID : ID de l'ensemble de données BigQuery.
TABLE_NAME: table vers laquelle vous exportez vos métadonnées.
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 dans la console Google Cloud.
  
  Accéder à Google Dashboard
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Sélectionnez votre organisation dans la zone Sélectionner à partir de, puis recherchez le nom de votre projet.
  
  Cliquez sur le nom du projet pour passer à celui-ci. Le numéro du projet est indiqué sur la fiche Informations sur le projet.
  
  gcloud CLI
  
  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)"
- folders/FOLDER_ID
  Trouver un ID de dossier Google Cloud
  Console
  
  Pour trouver un ID de dossier Google Cloud, procédez comme suit:
  
  Accédez à Google Cloud Console.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.
  
  Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
  
  gcloud CLI
  
  Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.
  
  Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- 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.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ 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.
  
  gcloud CLI
  
  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))"

Pour exporter des rapports sur les failles VM Manager d'un projet vers BigQuery, utilisez la commande suivante.

gcloud

Projets

gcloud asset export \
    --project=PROJECT_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=osconfig.googleapis.com/VulnerabilityReport \
    --content-type=resource \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --output-bigquery-force

Indiquez les valeurs suivantes :

PROJECT_ID: ID du projet dont les métadonnées sont en cours d'exportation.
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer vos ensembles de données et tables BigQuery. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
DATASET_ID : ID de l'ensemble de données BigQuery.
TABLE_NAME: table vers laquelle vous exportez vos métadonnées.

Autres indicateurs:

--output-bigquery-force: écrase la table de destination si elle existe.

Dossiers

gcloud asset export \
    --folder=FOLDER_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=osconfig.googleapis.com/VulnerabilityReport \
    --content-type=resource \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --output-bigquery-force

Indiquez les valeurs suivantes :

FOLDER_ID: ID du dossier dont les métadonnées sont en cours d'exportation.
Trouver un ID de dossier Google Cloud
Console

Pour trouver un ID de dossier Google Cloud, procédez comme suit:

Accédez à Google Cloud Console.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.

Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
gcloud CLI

Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.

Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:

gcloud resource-manager folders list --folder=FOLDER_ID
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer vos ensembles de données et tables BigQuery. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
DATASET_ID : ID de l'ensemble de données BigQuery.
TABLE_NAME: table vers laquelle vous exportez vos métadonnées.

Autres indicateurs:

--output-bigquery-force: écrase la table de destination si elle existe.

Organisations

gcloud asset export \
    --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=osconfig.googleapis.com/VulnerabilityReport \
    --content-type=resource \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --output-bigquery-force

Indiquez les valeurs suivantes :

ORGANIZATION_ID: ID de l'organisation dont les métadonnées sont exportées.
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.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ 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.
gcloud CLI

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))"
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer vos ensembles de données et tables BigQuery. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
DATASET_ID : ID de l'ensemble de données BigQuery.
TABLE_NAME: table vers laquelle vous exportez vos métadonnées.

Autres indicateurs:

--output-bigquery-force: écrase la table de destination si elle existe.

REST

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "assetTypes": ["osconfig.googleapis.com/VulnerabilityReport"],
          "contentType": "RESOURCE",
          "outputConfig": {
            "bigqueryDestination": {
              "dataset": "projects/PROJECT_ID/datasets/DATASET_ID",
              "table": "TABLE_NAME",
              "force": true
            }
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:exportAssets

Indiquez les valeurs suivantes :

BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer vos ensembles de données et tables BigQuery. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
PROJECT_ID: ID du projet dans lequel se trouve la table BigQuery.
DATASET_ID : ID de l'ensemble de données BigQuery.
TABLE_NAME: table vers laquelle vous exportez vos métadonnées.
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 dans la console Google Cloud.
  
  Accéder à Google Dashboard
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Sélectionnez votre organisation dans la zone Sélectionner à partir de, puis recherchez le nom de votre projet.
  
  Cliquez sur le nom du projet pour passer à celui-ci. Le numéro du projet est indiqué sur la fiche Informations sur le projet.
  
  gcloud CLI
  
  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)"
- folders/FOLDER_ID
  Trouver un ID de dossier Google Cloud
  Console
  
  Pour trouver un ID de dossier Google Cloud, procédez comme suit:
  
  Accédez à Google Cloud Console.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.
  
  Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
  
  gcloud CLI
  
  Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.
  
  Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- 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.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ 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.
  
  gcloud CLI
  
  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))"

Autres paramètres:

"force": true: remplace la table de destination, le cas échéant.

Tables existantes

Il n'est pas possible d'ajouter le résultat d'une exportation à une table existante. La table de destination doit être vide ou vous devez l'écraser. Pour l'écraser, utilisez l'option --output-bigquery-force avec gcloud CLI ou force avec l'API REST.

Si la table de sortie est utilisée lorsque vous essayez d'y écrire, une réponse 400 est renvoyée avec le message Request contains an invalid argument.

Exporter des données VM Manager vers Cloud Storage

Pour exporter les données d'inventaire VM Manager de toutes les instances de VM d'un projet, utilisez la commande gcloud CLI suivante ou l'API Cloud Asset Inventory.

gcloud

Projets

gcloud asset export \
    --project=PROJECT_ID \
    --billing-project=BILLING_PROJECT_ID \
    --content-type=os-inventory \
    --output-path="gs://BUCKET_NAME/FILENAME"

Indiquez les valeurs suivantes :

PROJECT_ID: ID du projet dont les métadonnées sont en cours d'exportation.
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose de l'autorisation d'écrire dans votre bucket Cloud Storage. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
BUCKET_NAME: nom du bucket Cloud Storage dans lequel écrire.
FILENAME: fichier de votre bucket Cloud Storage dans lequel écrire.

Dossiers

gcloud asset export \
    --folder=FOLDER_ID \
    --billing-project=BILLING_PROJECT_ID \
    --content-type=os-inventory \
    --output-path="gs://BUCKET_NAME/FILENAME"

Indiquez les valeurs suivantes :

FOLDER_ID: ID du dossier dont les métadonnées sont en cours d'exportation.
Trouver un ID de dossier Google Cloud
Console

Pour trouver un ID de dossier Google Cloud, procédez comme suit:

Accédez à Google Cloud Console.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.

Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
gcloud CLI

Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.

Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:

gcloud resource-manager folders list --folder=FOLDER_ID
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose de l'autorisation d'écrire dans votre bucket Cloud Storage. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
BUCKET_NAME: nom du bucket Cloud Storage dans lequel écrire.
FILENAME: fichier de votre bucket Cloud Storage dans lequel écrire.

Organisations

gcloud asset export \
    --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID \
    --content-type=os-inventory \
    --output-path="gs://BUCKET_NAME/FILENAME"

Indiquez les valeurs suivantes :

ORGANIZATION_ID: ID de l'organisation dont les métadonnées sont exportées.
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.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ 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.
gcloud CLI

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))"
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose de l'autorisation d'écrire dans votre bucket Cloud Storage. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
BUCKET_NAME: nom du bucket Cloud Storage dans lequel écrire.
FILENAME: fichier de votre bucket Cloud Storage dans lequel écrire.

REST

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "contentType": "OS_INVENTORY",
          "outputConfig": {
            "gcsDestination": {
              "uri": "gs://BUCKET_NAME/FILENAME"
            }
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:exportAssets

Indiquez les valeurs suivantes :

BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui est autorisé à écrire dans votre bucket Cloud Storage. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
BUCKET_NAME: nom du bucket Cloud Storage dans lequel écrire.
FILENAME: fichier de votre bucket Cloud Storage dans lequel écrire.
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 dans la console Google Cloud.
  
  Accéder à Google Dashboard
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Sélectionnez votre organisation dans la zone Sélectionner à partir de, puis recherchez le nom de votre projet.
  
  Cliquez sur le nom du projet pour passer à celui-ci. Le numéro du projet est indiqué sur la fiche Informations sur le projet.
  
  gcloud CLI
  
  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)"
- folders/FOLDER_ID
  Trouver un ID de dossier Google Cloud
  Console
  
  Pour trouver un ID de dossier Google Cloud, procédez comme suit:
  
  Accédez à Google Cloud Console.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.
  
  Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
  
  gcloud CLI
  
  Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.
  
  Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- 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.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ 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.
  
  gcloud CLI
  
  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))"

Pour exporter des rapports de faille de VM Manager d'un projet vers Cloud Storage, utilisez la commande gcloud CLI suivante ou l'API Cloud Asset Inventory.

gcloud

Projets

gcloud asset export \
    --project=PROJECT_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=osconfig.googleapis.com/VulnerabilityReport \
    --content-type=resource \
    --output-path="gs://BUCKET_NAME/FILENAME"

Indiquez les valeurs suivantes :

PROJECT_ID: ID du projet dont les métadonnées sont en cours d'exportation.
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose de l'autorisation d'écrire dans votre bucket Cloud Storage. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
BUCKET_NAME: nom du bucket Cloud Storage dans lequel écrire.
FILENAME: fichier de votre bucket Cloud Storage dans lequel écrire.

Dossiers

gcloud asset export \
    --folder=FOLDER_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=osconfig.googleapis.com/VulnerabilityReport \
    --content-type=resource \
    --output-path="gs://BUCKET_NAME/FILENAME"

Indiquez les valeurs suivantes :

FOLDER_ID: ID du dossier dont les métadonnées sont en cours d'exportation.
Trouver un ID de dossier Google Cloud
Console

Pour trouver un ID de dossier Google Cloud, procédez comme suit:

Accédez à Google Cloud Console.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.

Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
gcloud CLI

Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.

Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:

gcloud resource-manager folders list --folder=FOLDER_ID
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose de l'autorisation d'écrire dans votre bucket Cloud Storage. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
BUCKET_NAME: nom du bucket Cloud Storage dans lequel écrire.
FILENAME: fichier de votre bucket Cloud Storage dans lequel écrire.

Organisations

gcloud asset export \
    --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=osconfig.googleapis.com/VulnerabilityReport \
    --content-type=resource \
    --output-path="gs://BUCKET_NAME/FILENAME"

Indiquez les valeurs suivantes :

ORGANIZATION_ID: ID de l'organisation dont les métadonnées sont exportées.
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.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ 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.
gcloud CLI

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))"
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose de l'autorisation d'écrire dans votre bucket Cloud Storage. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
BUCKET_NAME: nom du bucket Cloud Storage dans lequel écrire.
FILENAME: fichier de votre bucket Cloud Storage dans lequel écrire.

REST

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "assetTypes": ["osconfig.googleapis.com/VulnerabilityReport"],
          "contentType": "RESOURCE",
          "outputConfig": {
            "gcsDestination": {
              "uri": "gs://BUCKET_NAME/FILENAME"
            }
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:exportAssets

Indiquez les valeurs suivantes :

BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui est autorisé à écrire dans votre bucket Cloud Storage. Cette étape n'est pas nécessaire si vous êtes déjà passé au projet de facturation avec gcloud config set project. En savoir plus sur les projets de facturation
BUCKET_NAME: nom du bucket Cloud Storage dans lequel écrire.
FILENAME: fichier de votre bucket Cloud Storage dans lequel écrire.
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 dans la console Google Cloud.
  
  Accéder à Google Dashboard
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Sélectionnez votre organisation dans la zone Sélectionner à partir de, puis recherchez le nom de votre projet.
  
  Cliquez sur le nom du projet pour passer à celui-ci. Le numéro du projet est indiqué sur la fiche Informations sur le projet.
  
  gcloud CLI
  
  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)"
- folders/FOLDER_ID
  Trouver un ID de dossier Google Cloud
  Console
  
  Pour trouver un ID de dossier Google Cloud, procédez comme suit:
  
  Accédez à Google Cloud Console.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.
  
  Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
  
  gcloud CLI
  
  Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.
  
  Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- 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.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ 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.
  
  gcloud CLI
  
  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))"

Fichiers existants

Si le fichier de sortie est utilisé lorsque vous essayez d'écrire dans un bucket de stockage, une réponse 400 est renvoyée avec le message Request contains an invalid argument.

Obtenir l'historique des données VM Manager

Pour obtenir l'historique de tous les éléments d'inventaire du système d'exploitation pour une instance de VM spécifiée dans un projet, un dossier ou une organisation, exécutez les commandes suivantes.

gcloud

Projets

gcloud asset get-history \
    --project=PROJECT_ID \
    --asset-names=//compute.googleapis.com/projects/PROJECT_ID/zones/ZONE/instances/VM_INSTANCE_NAME \
    --content-type=os-inventory \
    --start-time="START_TIME" \
    --end-time="END_TIME"

Indiquez les valeurs suivantes :

PROJECT_ID: ID du projet contenant l'instance de VM.
ZONE: zone dans laquelle se trouve votre instance de VM. Exemple : us-central1-a.
VM_INSTANCE_NAME: nom de votre instance de VM.
START_TIME : facultatif. Début de la période. La période maximale est de sept jours. La valeur doit correspondre à l'heure actuelle ou à une heure antérieure de 35 jours maximum. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.
END_TIME : facultatif. Le point d'arrivée de la période. La période maximale est de sept jours. La valeur doit correspondre à l'heure actuelle ou à une heure antérieure de 35 jours maximum. Si elle n'est pas fournie, l'heure de fin est considérée comme l'heure actuelle. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.

Pour obtenir l'historique des données de failles VM Manager pour une VM spécifique d'un projet, exécutez la commande suivante:

gcloud asset get-history \
    --project=PROJECT_ID \
    --asset-names=//osconfig.googleapis.com/projects/PROJECT_NUMBER/locations/ZONE/instances/VM_INSTANCE_ID/vulnerabilityReport \
    --content-type=resource \
    --start-time="START_TIME" \
    --end-time="END_TIME"

Dossiers

gcloud asset get-history \
    --folder=FOLDER_ID \
    --asset-names=//compute.googleapis.com/projects/PROJECT_ID/zones/ZONE/instances/VM_INSTANCE_NAME \
    --content-type=os-inventory \
    --start-time="START_TIME" \
    --end-time="END_TIME"

Indiquez les valeurs suivantes :

FOLDER_ID: ID du dossier où se trouve l'instance de VM.
Trouver un ID de dossier Google Cloud
Console

Pour trouver un ID de dossier Google Cloud, procédez comme suit:

Accédez à Google Cloud Console.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.

Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
gcloud CLI

Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.

Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:

gcloud resource-manager folders list --folder=FOLDER_ID
ZONE: zone dans laquelle se trouve votre instance de VM. Exemple : us-central1-a.
VM_INSTANCE_NAME: nom de votre instance de VM.
START_TIME : facultatif. Début de la période. La période maximale est de sept jours. La valeur doit correspondre à l'heure actuelle ou à une heure antérieure de 35 jours maximum. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.
END_TIME : facultatif. Le point d'arrivée de la période. La période maximale est de sept jours. La valeur doit correspondre à l'heure actuelle ou à une heure antérieure de 35 jours maximum. Si elle n'est pas fournie, l'heure de fin est considérée comme l'heure actuelle. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.

Pour obtenir l'historique des données de failles VM Manager pour une VM spécifique d'un projet, exécutez la commande suivante:

gcloud asset get-history \
    --folder=FOLDER_ID \
    --asset-names=//osconfig.googleapis.com/projects/PROJECT_NUMBER/locations/ZONE/instances/VM_INSTANCE_ID/vulnerabilityReport \
    --content-type=resource \
    --start-time="START_TIME" \
    --end-time="END_TIME"

Organisations

gcloud asset get-history \
    --organization=ORGANIZATION_ID \
    --asset-names=//compute.googleapis.com/projects/PROJECT_ID/zones/ZONE/instances/VM_INSTANCE_NAME \
    --content-type=os-inventory \
    --start-time="START_TIME" \
    --end-time="END_TIME"

Indiquez les valeurs suivantes :

ORGANIZATION_ID: ID de l'organisation où se trouve l'instance de VM.
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.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ 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.
gcloud CLI

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))"
ZONE: zone dans laquelle se trouve votre instance de VM. Exemple : us-central1-a.
VM_INSTANCE_NAME: nom de votre instance de VM.
START_TIME : facultatif. Début de la période. La période maximale est de sept jours. La valeur doit correspondre à l'heure actuelle ou à une heure antérieure de 35 jours maximum. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.
END_TIME : facultatif. Le point d'arrivée de la période. La période maximale est de sept jours. La valeur doit correspondre à l'heure actuelle ou à une heure antérieure de 35 jours maximum. Si elle n'est pas fournie, l'heure de fin est considérée comme l'heure actuelle. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.

Pour obtenir l'historique des données de failles VM Manager pour une VM spécifique d'un projet, exécutez la commande suivante:

gcloud asset get-history \
    --organization=ORGANIZATION_ID \
    --asset-names=//osconfig.googleapis.com/projects/PROJECT_NUMBER/locations/ZONE/instances/VM_INSTANCE_ID/vulnerabilityReport \
    --content-type=resource \
    --start-time="START_TIME" \
    --end-time="END_TIME"

REST

Pour obtenir l'historique de tous les éléments d'inventaire du système d'exploitation pour une instance de VM spécifiée dans un projet, exécutez la commande suivante:

curl -X POST \
     -H "X-HTTP-Method-Override: GET" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "assetNames": "//compute.googleapis.com/projects/PROJECT_ID/zones/ZONE/instances/VM_INSTANCE_NAME",
          "contentType": "OS_INVENTORY",
          "readTimeWindow": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:batchGetAssetsHistory

Remarque:Il s'agit d'une méthode GET. Cependant, le serveur n'accepte pas de corps pour les méthodes GET, et l'URL de la requête est également limitée. Pour éviter les erreurs, utilisez plutôt un POST et définissez un en-tête X-HTTP-Method-Override: GET.

Indiquez les valeurs suivantes :

PROJECT_ID: ID du projet contenant l'instance de VM.
ZONE: zone dans laquelle se trouve votre instance de VM. Exemple : us-central1-a.
VM_INSTANCE_NAME: nom de votre instance de VM.
START_TIME : facultatif. Début de la période. La période maximale est de sept jours. La valeur doit correspondre à l'heure actuelle ou à une heure antérieure de 35 jours maximum. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.
END_TIME : facultatif. Le point d'arrivée de la période. La période maximale est de sept jours. La valeur doit correspondre à l'heure actuelle ou à une heure antérieure de 35 jours maximum. Si elle n'est pas fournie, l'heure de fin est considérée comme l'heure actuelle. Pour plus d'informations sur les formats d'heure, consultez gcloud topic datetimes.
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 dans la console Google Cloud.
  
  Accéder à Google Dashboard
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Sélectionnez votre organisation dans la zone Sélectionner à partir de, puis recherchez le nom de votre projet.
  
  Cliquez sur le nom du projet pour passer à celui-ci. Le numéro du projet est indiqué sur la fiche Informations sur le projet.
  
  gcloud CLI
  
  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)"
- folders/FOLDER_ID
  Trouver un ID de dossier Google Cloud
  Console
  
  Pour trouver un ID de dossier Google Cloud, procédez comme suit:
  
  Accédez à Google Cloud Console.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.
  
  Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
  
  gcloud CLI
  
  Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.
  
  Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- 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.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ 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.
  
  gcloud CLI
  
  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))"

Pour obtenir l'historique des données de failles VM Manager pour une VM spécifique d'un projet, exécutez la commande suivante:

curl -X POST \
     -H "X-HTTP-Method-Override: GET" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "assetNames": "//osconfig.googleapis.com/projects/PROJECT_ID/locations/ZONE/instances/VM_INSTANCE_NAME/vulnerabilityReport",
          "contentType": "RESOURCE",
          "readTimeWindow": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:batchGetAssetsHistory

Surveiller les modifications des données VM Manager avec Pub/Sub

Après avoir créé un sujet Pub/Sub, exécutez les commandes suivantes pour surveiller les modifications apportées à VM Manager.

gcloud

Projets

Pour créer un flux permettant de surveiller des VM sur lesquelles l'OS Windows est installé, exécutez la commande suivante:

gcloud asset feeds create FEED_ID \
    --project=PROJECT_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=compute.googleapis.com/Instance \
    --content-type=os-inventory \
    --pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
    --condition-title="CONDITION_TITLE" \
    --condition-description="CONDITION_DESCRIPTION" \
    --condition-expression="temporal_asset.asset.os_inventory.os_info.short_name == \"windows\""

Indiquez les valeurs suivantes :

FEED_ID: identifiant unique du flux d'éléments.
PROJECT_ID: ID du projet dont les métadonnées sont envoyées au flux.
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer votre sujet Pub/Sub. En savoir plus sur les projets de facturation
TOPIC_ID: ID du sujet Pub/Sub sur lequel publier les notifications.
CONDITION_TITLE : facultatif. Titre de la condition à appliquer au flux.
CONDITION_DESCRIPTION : facultatif. Description de la condition à appliquer au flux.

Pour créer un flux permettant de surveiller les données sur les failles des VM dans un projet, exécutez la commande suivante:

gcloud asset feeds create FEED_ID \
    --project=PROJECT_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=osconfig.googleapis.com/VulnerabilityReport \
    --content-type=resource \
    --pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID"

Dossiers

Pour créer un flux permettant de surveiller des VM sur lesquelles l'OS Windows est installé, exécutez la commande suivante:

gcloud asset feeds create FEED_ID \
    --folder=FOLDER_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=compute.googleapis.com/Instance \
    --content-type=os-inventory \
    --pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
    --condition-title="CONDITION_TITLE" \
    --condition-description="CONDITION_DESCRIPTION" \
    --condition-expression="temporal_asset.asset.os_inventory.os_info.short_name == \"windows\""

Indiquez les valeurs suivantes :

FEED_ID: identifiant unique du flux d'éléments.
FOLDER_ID: ID du dossier dont les métadonnées sont envoyées au flux.
Trouver un ID de dossier Google Cloud
Console

Pour trouver un ID de dossier Google Cloud, procédez comme suit:

Accédez à Google Cloud Console.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.

Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
gcloud CLI

Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.

Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:

gcloud resource-manager folders list --folder=FOLDER_ID
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer votre sujet Pub/Sub. En savoir plus sur les projets de facturation
TOPIC_ID: ID du sujet Pub/Sub sur lequel publier les notifications.
CONDITION_TITLE : facultatif. Titre de la condition à appliquer au flux.
CONDITION_DESCRIPTION : facultatif. Description de la condition à appliquer au flux.

Pour créer un flux permettant de surveiller les données sur les failles des VM dans un projet, exécutez la commande suivante:

gcloud asset feeds create FEED_ID \
    --folder=FOLDER_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=osconfig.googleapis.com/VulnerabilityReport \
    --content-type=resource \
    --pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID"

Organisations

Pour créer un flux permettant de surveiller des VM sur lesquelles l'OS Windows est installé, exécutez la commande suivante:

gcloud asset feeds create FEED_ID \
    --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=compute.googleapis.com/Instance \
    --content-type=os-inventory \
    --pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
    --condition-title="CONDITION_TITLE" \
    --condition-description="CONDITION_DESCRIPTION" \
    --condition-expression="temporal_asset.asset.os_inventory.os_info.short_name == \"windows\""

Indiquez les valeurs suivantes :

FEED_ID: identifiant unique du flux d'éléments.
ORGANIZATION_ID: ID de l'organisation dont les métadonnées sont envoyées au flux.
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.

Accéder à la console Google Cloud

Cliquez sur le sélecteur dans la barre de menu.

Cliquez sur le champ 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.
gcloud CLI

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))"
BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer votre sujet Pub/Sub. En savoir plus sur les projets de facturation
TOPIC_ID: ID du sujet Pub/Sub sur lequel publier les notifications.
CONDITION_TITLE : facultatif. Titre de la condition à appliquer au flux.
CONDITION_DESCRIPTION : facultatif. Description de la condition à appliquer au flux.

Pour créer un flux permettant de surveiller les données sur les failles des VM dans un projet, exécutez la commande suivante:

gcloud asset feeds create FEED_ID \
    --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=osconfig.googleapis.com/VulnerabilityReport \
    --content-type=resource \
    --pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID"

REST

Pour créer un flux permettant de surveiller des VM sur lesquelles l'OS Windows est installé, exécutez la commande suivante:

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "feedId": "FEED_ID",
          "feed": {
            "assetTypes": ["compute.googleapis.com/Instance"],
            "contentType": "OS_INVENTORY",
            "feedOutputConfig": {
              "pubsubDestination": {
                "topic": "projects/PROJECT_ID/topics/TOPIC_ID"
              }
            },
            "condition": {
              "title": "CONDITION_TITLE",
              "description": "CONDITION_DESCRIPTION",
              "expression": "temporal_asset.asset.os_inventory.os_info.short_name == \"windows\""
            }
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE/feeds

Indiquez les valeurs suivantes :

BILLING_PROJECT_ID : facultatif. ID du projet dans lequel se trouve l'agent de service inventaire des éléments cloud par défaut et qui dispose des autorisations nécessaires pour gérer votre sujet Pub/Sub. En savoir plus sur les projets de facturation
FEED_ID: identifiant unique du flux d'éléments.
PROJECT_ID: ID du projet dans lequel se trouve le sujet Pub/Sub.
TOPIC_ID: ID du sujet Pub/Sub dans lequel publier les notifications.
CONDITION_TITLE : facultatif. Titre de la condition à appliquer au flux.
CONDITION_DESCRIPTION : facultatif. Description de la condition à appliquer au flux.
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 dans la console Google Cloud.
  
  Accéder à Google Dashboard
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Sélectionnez votre organisation dans la zone Sélectionner à partir de, puis recherchez le nom de votre projet.
  
  Cliquez sur le nom du projet pour passer à celui-ci. Le numéro du projet est indiqué sur la fiche Informations sur le projet.
  
  gcloud CLI
  
  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)"
- folders/FOLDER_ID
  Trouver un ID de dossier Google Cloud
  Console
  
  Pour trouver un ID de dossier Google Cloud, procédez comme suit:
  
  Accédez à Google Cloud Console.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ Sélectionner à partir de, puis sélectionnez votre organisation.
  
  Recherchez le nom de votre dossier. L'ID du dossier figure à côté du nom du dossier.
  
  gcloud CLI
  
  Vous pouvez récupérer un ID de dossier Google Cloud situé au niveau de l'organisation à l'aide de la commande suivante:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Où TOP_LEVEL_FOLDER_NAME peut être une correspondance de chaîne complète ou partielle. Supprimez l'option --format pour afficher plus d'informations sur les dossiers trouvés.
  
  Pour obtenir l'ID d'un dossier dans un autre dossier, répertoriez les sous-dossiers:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- 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.
  
  Accéder à la console Google Cloud
  
  Cliquez sur le sélecteur dans la barre de menu.
  
  Cliquez sur le champ 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.
  
  gcloud CLI
  
  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))"

Pour créer un flux afin de surveiller les données sur les failles de la VM, exécutez la commande suivante:

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "feedId": "FEED_ID",
          "feed": {
            "assetTypes": ["osconfig.googleapis.com/VulnerabilityReport"],
            "contentType": "RESOURCE",
            "feedOutputConfig": {
              "pubsubDestination": {
                "topic": "projects/PROJECT_ID/topics/TOPIC_ID"
              }
            }
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE/feeds

Pour en savoir plus, consultez Surveiller les modifications apportées aux éléments.

Afficher les données de VM Manager

Avant de commencer

gcloud CLI

REST

Activer l'inventaire d'OS

Définir des autorisations

Exporter des données VM Manager vers BigQuery

gcloud

Projets

Dossiers

Console

gcloud CLI

Organisations

Console

gcloud CLI

REST

Console

gcloud CLI

Console

gcloud CLI

Console

gcloud CLI

gcloud

Projets

Dossiers

Console

gcloud CLI

Organisations

Console

gcloud CLI

REST

Console

gcloud CLI

Console

gcloud CLI

Console

gcloud CLI

Tables existantes

Exporter des données VM Manager vers Cloud Storage

gcloud

Projets

Dossiers

Console

gcloud CLI

Organisations

Console

gcloud CLI

REST

Console

gcloud CLI

Console

gcloud CLI

Console

gcloud CLI

gcloud

Projets

Dossiers

Console

gcloud CLI

Organisations

Console

gcloud CLI

REST

Console

gcloud CLI

Console

gcloud CLI

Console

gcloud CLI

Fichiers existants

Obtenir l'historique des données VM Manager

gcloud

Projets

Dossiers

Console

gcloud CLI

Organisations

Console

gcloud CLI

REST