Puoi recuperare fino a 35 giorni di cronologia di creazione, aggiornamento ed eliminazione delle risorse nei progetti o nelle organizzazioni Cloud de Confiance by S3NS . Gli asset che non sono stati modificati negli ultimi 35 giorni riportano il loro stato più recente.
Prima di iniziare
Abilita l'API Cloud Asset Inventory nel progetto da cui esegui i comandi Cloud Asset Inventory.
Assicurati che il tuo account disponga del ruolo corretto per chiamare l'API Cloud Asset Inventory. Per le singole autorizzazioni per ogni tipo di chiamata, vedi Autorizzazioni.
Limitazioni
Puoi recuperare la cronologia degli asset solo a livello di organizzazione e progetto. Le cartelle non sono supportate.
Recuperare le cronologie delle risorse
Console
Per ottenere la cronologia degli asset archiviati in Cloud de Confiance by S3NS, completa i seguenti passaggi.
-
Vai alla pagina Inventario asset nella console Cloud de Confiance .
- Passa al progetto, alla cartella o all'organizzazione in cui vuoi eseguire la ricerca.
- Fai clic sulla scheda Risorsa.
- Nel riquadro Filtra risultati, seleziona un tipo di risorsa o una località per filtrare i risultati.
- Fai clic su una risorsa nel riquadro dei risultati.
- Fai clic sulla scheda Cronologia delle modifiche.
- Seleziona un'ora di inizio e un'ora di fine per il report.
- Utilizza le caselle di riepilogo Seleziona un record da confrontare per visualizzare una differenza tra i record per le date selezionate.
Dopo aver eseguito una ricerca, le risorse corrispondenti alla query vengono elencate nella tabella Risultati. Fai doppio clic sulla query per modificarla oppure utilizza il riquadro Filtra risultati per limitare i risultati di ricerca in base a criteri specifici.
Per visualizzare la query come comando Google Cloud CLI, fai clic su Visualizza query.
Per esportare i risultati, fai clic su Scarica CSV.
gcloud
gcloud asset get-history \ --SCOPE \ --asset-names=ASSET_NAME_1,ASSET_NAME_2,... \ --content-type=CONTENT_TYPE \ --start-time="START_TIME" \ --end-time="END_TIME"
Fornisci i seguenti valori:
-
SCOPE: utilizza uno dei seguenti valori:-
project=PROJECT_ID, dovePROJECT_IDè l'ID del progetto che contiene l'asset che vuoi recuperare. -
organization=ORGANIZATION_ID, doveORGANIZATION_IDè l'ID dell'organizzazione che possiede l'asset che vuoi recuperare.Come trovare l'ID di un' Cloud de Confiance by S3NS organizzazione
ConsoleCloud de Confiance
Per trovare l'ID di un'organizzazione, completa i seguenti passaggi: Cloud de Confiance by S3NS
-
Vai alla console Cloud de Confiance .
- Fai clic sulla casella di elenco del selettore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella di elenco.
- Fai clic sulla scheda Tutti. L'ID organizzazione viene visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di un'organizzazione Cloud de Confiance by S3NS con il seguente comando:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
-
ASSET_NAME_#: un elenco separato da virgole di nomi completi delle risorse.CONTENT_TYPE: Il tipo di contenuti dei metadati che vuoi recuperare. Quando--content-typenon è specificato, vengono restituite solo informazioni di base, come i nomi degli asset, l'ultima volta che gli asset sono stati aggiornati e i progetti, le cartelle e le organizzazioni a cui appartengono.-
START_TIME: l'inizio dell'intervallo di tempo, nel formato data e ora dell'argomento gcloud. Il valore non deve essere precedente a 35 giorni. -
END_TIME: (Facoltativo) Il punto finale dell'intervallo di tempo, nel formato data e ora dell'argomento gcloud. Il valore non deve essere precedente a 35 giorni. Quando--end-timenon è specificato, viene impostato sull'ora corrente.
Per tutte le opzioni, consulta il riferimento gcloud CLI.
Esempio
Esegui il seguente comando per ottenere i metadati della cronologia resource dell'istanza Compute Engine my-instance nel progetto my-project tra il 30 gennaio 2024 e il 5 febbraio 2024. L'istanza ha le seguenti proprietà:
- Nome istanza:
my-instance - Progetto:
my-project - Località:
us-central1-a
gcloud asset get-history \ --project=my-project \ --asset-names=//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance \ --content-type=resource \ --start-time="2024-01-30" \ --end-time="2024-02-05"
Esempio di risposta
---
asset:
ancestors:
- projects/000000000000
- folders/000000000000
- organizations/000000000000
assetType: compute.googleapis.com/Instance
name: //compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance
resource:
data:
LATEST_ASSET_METADATA
discoveryDocumentUri: https://compute.s3nsapis.fr/$discovery/rest?version=v1
discoveryName: Instance
location: us-central1-a
parent: //cloudresourcemanager.googleapis.com/projects/000000000000
version: v1
updateTime: '2024-02-05T16:00:25.259186Z'
window:
endTime: '2024-02-05T16:00:25.259186Z'
startTime: '2024-02-03T16:00:28.854779Z'
---
asset:
ancestors:
- projects/000000000000
- folders/000000000000
- organizations/000000000000
assetType: compute.googleapis.com/Instance
name: //compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance
resource:
data:
EARLIEST_ASSET_METADATA
discoveryDocumentUri: https://compute.s3nsapis.fr/$discovery/rest?version=v1
discoveryName: Instance
location: us-central1-a
parent: //cloudresourcemanager.googleapis.com/projects/000000000000
version: v1
updateTime: '2024-02-03T16:00:28.854779Z'
window:
endTime: '2024-02-03T16:00:28.854779Z'
startTime: '2024-01-30T08:00:22.930462Z'
REST
Metodo HTTP e URL:
POST https://cloudasset.googleapis.com/v1/SCOPE_PATH:batchGetAssetsHistory
Corpo JSON della richiesta:
{ "assetNames": [ "ASSET_NAME_1", "ASSET_NAME_2", "..." ], "contentType": "CONTENT_TYPE", "readTimeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
Fornisci i seguenti valori:
-
SCOPE_PATH: utilizza uno dei seguenti valori:I valori consentiti sono:
-
projects/PROJECT_ID, dovePROJECT_IDè l'ID del progetto che contiene l'asset che vuoi recuperare. -
projects/PROJECT_NUMBER, dovePROJECT_NUMBERè il numero del progetto che contiene l'asset che vuoi recuperare.Come trovare un Cloud de Confiance by S3NS numero di progetto
ConsoleCloud de Confiance
Per trovare un numero di progetto, completa i seguenti passaggi: Cloud de Confiance by S3NS
-
Vai alla pagina Benvenuto nella console Cloud de Confiance .
- Fai clic sulla casella di elenco del selettore nella barra dei menu.
-
Seleziona la tua organizzazione dalla casella di elenco e poi cerca il nome del tuo progetto. Il nome, il numero e l'ID progetto sono visualizzati vicino all'intestazione Benvenuto.
Vengono visualizzate fino a 4000 risorse. Se non vedi il progetto che stai cercando, vai alla pagina Gestisci risorse e filtra l'elenco utilizzando il nome del progetto.
Interfaccia a riga di comando gcloud
Puoi recuperare un Cloud de Confiance by S3NS numero di progetto con il seguente comando:
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
-
organizations/ORGANIZATION_ID, doveORGANIZATION_IDè l'ID dell'organizzazione che possiede l'asset che vuoi recuperare.Come trovare l'ID di un' Cloud de Confiance by S3NS organizzazione
ConsoleCloud de Confiance
Per trovare l'ID di un'organizzazione, completa i seguenti passaggi: Cloud de Confiance by S3NS
-
Vai alla console Cloud de Confiance .
- Fai clic sulla casella di elenco del selettore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella di elenco.
- Fai clic sulla scheda Tutti. L'ID organizzazione viene visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di un'organizzazione Cloud de Confiance by S3NS con il seguente comando:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
-
ASSET_NAME_#: un array di nomi completi degli asset.CONTENT_TYPE: Il tipo di contenuti dei metadati che vuoi recuperare. QuandocontentTypenon è specificato, vengono restituite solo informazioni di base, come i nomi degli asset, l'ultima volta che gli asset sono stati aggiornati e i progetti, le cartelle e le organizzazioni a cui appartengono.-
START_TIME: L'inizio dell'intervallo di tempo, in formato RFC 3339. Il valore non deve essere precedente a 35 giorni. -
END_TIME: (Facoltativo) Il punto finale dell'intervallo di tempo, nel formato RFC 3339. Il valore non deve essere precedente a 35 giorni. QuandoendTimenon è specificato, viene impostato sull'ora corrente.
Consulta il riferimento REST per tutte le opzioni.
Esempi di comandi
Esegui uno dei seguenti comandi per ottenere la cronologia resource dell'istanza Compute Engine my-instance nel progetto my-project tra il 30 gennaio 2024 e il 5 febbraio 2024. L'istanza ha le seguenti proprietà:
- Nome istanza:
my-instance - Progetto:
my-project - Località:
us-central1-a
curl (Linux, macOS o Cloud Shell)
curl -X POST \ -H "X-HTTP-Method-Override: GET" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{ "assetNames": ["//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance"], "contentType": "RESOURCE", "readTimeWindow": { "startTime": "2024-01-30T00:00:00Z", "endTime": "2024-02-05T00:00:00Z" } }' \ https://cloudasset.googleapis.com/v1/projects/my-project:batchGetAssetsHistory
PowerShell (Windows)
$cred = gcloud auth print-access-token $headers = @{ "X-HTTP-Method-Override" = "GET"; "Authorization" = "Bearer $cred" } $body = @" { "assetNames": ["//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance"], "contentType": "RESOURCE", "readTimeWindow": { "startTime": "2024-01-30T00:00:00Z", "endTime": "2024-02-05T00:00:00Z" } } "@ Invoke-WebRequest ` -Method POST ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body $body ` -Uri "https://cloudasset.googleapis.com/v1/projects/my-project:batchGetAssetsHistory" | Select-Object -Expand Content
Esempio di risposta
{ "assets": [ { "window": { "startTime": "2024-02-03T16:00:28.854779Z", "endTime": "2024-02-05T16:00:25.259186Z" }, "asset": { "name": "//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance", "assetType": "compute.googleapis.com/Instance", "resource": { "version": "v1", "discoveryDocumentUri": "https://compute.s3nsapis.fr/$discovery/rest?version=v1", "discoveryName": "Instance", "parent": "//cloudresourcemanager.googleapis.com/projects/000000000000", "data": { LATEST_ASSET_METADATA }, "location": "us-central1-a" }, "ancestors": [ "projects/000000000000", "folders/000000000000", "organizations/000000000000" ], "updateTime": "2024-02-05T16:00:25.259186Z" } }, { "window": { "startTime": "2024-01-30T08:00:22.930462Z", "endTime": "2024-02-03T16:00:28.854779Z" }, "asset": { "name": "//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance", "assetType": "compute.googleapis.com/Instance", "resource": { "version": "v1", "discoveryDocumentUri": "https://compute.s3nsapis.fr/$discovery/rest?version=v1", "discoveryName": "Instance", "parent": "//cloudresourcemanager.googleapis.com/projects/000000000000", "data": { EARLIEST_ASSET_METADATA }, "location": "us-central1-a" }, "ancestors": [ "projects/000000000000", "folders/000000000000", "organizations/000000000000" ], "updateTime": "2024-02-03T16:00:28.854779Z" } } ] }
C#
Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.
Per eseguire l'autenticazione in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Vai
Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.
Per eseguire l'autenticazione in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.
Per eseguire l'autenticazione in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Node.js
Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.
Per eseguire l'autenticazione in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
PHP
Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.
Per eseguire l'autenticazione in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Python
Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.
Per eseguire l'autenticazione in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Ruby
Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.
Per eseguire l'autenticazione in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.