In questa pagina viene spiegato come creare e gestire feed in un progetto.
Panoramica
Per ricevere notifiche in tempo reale sulle modifiche alle risorse e ai criteri, puoi: Creare e iscriversi a un feed. Quando configuri il feed, puoi specificare di voler monitorare le modifiche tipi di risorse supportati, criteri IAM, criteri di accesso e criteri dell'organizzazione in organizzazione, cartella, progetto. Inoltre, puoi aggiungere condizioni al feed in modo da ricevere notifiche solo per determinati tipi di modifiche apportate a una risorsa. Dopo aver configurato il feed, riceverai immediatamente notifiche ogni volta che gli asset specificati vengono modificati e inviati tramite Pub/Sub (formattato come TemporalAsset). Le notifiche in tempo reale si connettono ai carichi di lavoro esistenti. Con questo puoi unire azioni come la creazione di una Cloud Function per annullare una modifica delle risorse dopo che è stata rilevata.
Prima di iniziare
Prima di iniziare, completa i seguenti passaggi.
Abilita l'API Cloud Asset Inventory nel progetto in cui eseguirai i comandi API.
Configura le autorizzazioni necessarie per chiama l'API Cloud Asset Inventory utilizzando gcloud CLI o l'API.
Completa i seguenti passaggi per configurare il tuo ambiente.
Interfaccia a riga di comando gcloud
Per configurare l'ambiente in modo da utilizzare gcloud CLI per chiamare API Cloud Asset Inventory, installa Google Cloud CLI sul tuo un cliente locale.
REST
Per configurare l'ambiente in modo da chiamare l'API Cloud Asset Inventory con
curl
, completa i seguenti passaggi.Verifica di avere accesso al comando
curl
.Assicurati di concedere uno dei seguenti ruoli nel progetto, nella cartella dell'organizzazione.
Ruolo Visualizzatore Cloud Asset (
roles/cloudasset.viewer
)Ruolo di base del proprietario (
roles/owner
)
Concedi all'account utente o di servizio le autorizzazioni per chiamare l'API in tempo reale feed. Per ogni operazione sono necessarie le seguenti autorizzazioni:
Autorizzazione Descrizione cloudasset.feeds.create
cloudasset.assets.exportResource
Crea feed cloudasset.feeds.update
cloudasset.assets.exportResource
Aggiorna feed cloudasset.feeds.delete
Elimina feed cloudasset.feeds.get
Ricevi feed cloudasset.feeds.list
Elencare tutti i feed Il ruolo di Proprietario asset cloud (
roles/cloudasset.owner
) concede tutte autorizzazioni relative all'API Cloud Asset, incluse le autorizzazioni elencate in la tabella precedente. Per ulteriori informazioni su ruoli e autorizzazioni, vedi Comprensione dei ruoli e Configurazione delle autorizzazioni.Se esporti metadati da un progetto a un altro, assicurati che esporta i dati del progetto l'account di servizio Cloud Asset Inventory predefinito esiste e ha le autorizzazioni corrette.
Crea un argomento Pub/Sub se non hai un argomento Pub/Sub esistente.
Limitazioni
La creazione, l'aggiornamento o l'eliminazione di un feed può richiedere fino a 10 minuti hanno effetto.
Il progetto consumer in cui viene creato il feed deve avere più durata rispetto al feed perché L'account di servizio utilizzato per pubblicare nell'argomento Pub/Sub di destinazione si trova nel progetto consumer. Se il progetto consumer viene eliminato, Cloud Asset Inventory non può pubblicare nella destinazione. Il feed non funziona più e vengono eliminati non appena l'eliminazione del progetto è definitiva.
Creazione dei feed
Puoi creare fino a 200 feed per un genitore. Questo limite si applica solo ai feed segue direttamente l'elemento principale e non conteggia i feed dei relativi elementi secondari. Ad esempio, se un'organizzazione include 10 progetti, ogni progetto può avere fino a 200 feed e l'organizzazione può averne fino a 200.
Per creare un feed per progetti, cartelle o organizzazioni, imposta uno dei
le seguenti richieste. Cloud Asset Inventory imposta una notifica su qualsiasi asset
corrisponde ad almeno uno dei parametri ASSET
del feed
AND corrisponde anche all'espressione della condizione, se specificata.
gcloud
Progetti
gcloud asset feeds create FEED_ID \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic=projects/PROJECT_ID/topics/TOPIC_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--asset-types=ASSET_TYPE_1,ASSET_TYPE_2,... \
--content-type=CONTENT_TYPE \
--condition-title="CONDITION_TITLE" \
--condition-description="CONDITION_DESCRIPTION" \
--condition-expression="CONDITION_EXPRESSION"
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.PROJECT_ID
: l'ID del progetto di cui i metadati vengono inviati al feed.BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.ASSET_NAME
: facoltativo. Un elenco separato da virgole di nome e cognome della risorsa per cui vuoi ricevere notifiche di modifica.Almeno un
ASSET_NAME
o Il campoASSET_TYPE
è obbligatorio.ASSET_TYPE
: facoltativo. Un elenco separato da virgole di tipi di asset per cui vuoi ricevere notifiche di modifica. Le espressioni regolari compatibili con RE2 sono supportati. Se l'espressione regolare non corrisponde a nessuna espressione tipo di risorsa, viene restituito un erroreINVALID_ARGUMENT
.Almeno un
ASSET_NAME
o Il campoASSET_TYPE
è obbligatorio.CONTENT_TYPE
: facoltativo. La risorsa tipo di contenuti per cui vuoi ricevere notifiche sulle modifiche.CONDITION_TITLE
: facoltativo. Il titolo del condizione da applicare al feed.CONDITION_DESCRIPTION
: facoltativo. La descrizione della condizione da applicare al feed.CONDITION_EXPRESSION
: facoltativo. La condizione da applicare al feed.
Cartelle
gcloud asset feeds create FEED_ID \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic=projects/PROJECT_ID/topics/TOPIC_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--asset-types=ASSET_TYPE_1,ASSET_TYPE_2,... \
--content-type=CONTENT_TYPE \
--condition-title="CONDITION_TITLE" \
--condition-description="CONDITION_DESCRIPTION" \
--condition-expression="CONDITION_EXPRESSION"
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.FOLDER_ID
: l'ID della cartella di cui i metadati vengono inviati al feed.Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.PROJECT_ID
: l'ID del progetto in cui Si trova l'argomento Pub/Sub.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.ASSET_NAME
: facoltativo. Un elenco separato da virgole di nome e cognome della risorsa per cui vuoi ricevere notifiche di modifica.Almeno un
ASSET_NAME
o Il campoASSET_TYPE
è obbligatorio.ASSET_TYPE
: facoltativo. Un elenco separato da virgole di tipi di asset per cui vuoi ricevere notifiche di modifica. Le espressioni regolari sono supportati. Se l'espressione regolare non corrisponde a nessuna espressione tipo di risorsa, viene restituito un erroreINVALID_ARGUMENT
.Almeno un
ASSET_NAME
o Il campoASSET_TYPE
è obbligatorio.CONTENT_TYPE
: facoltativo. La risorsa tipo di contenuti per cui vuoi ricevere notifiche sulle modifiche.CONDITION_TITLE
: facoltativo. Il titolo del condizione da applicare al feed.CONDITION_DESCRIPTION
: facoltativo. La descrizione della condizione da applicare al feed.CONDITION_EXPRESSION
: facoltativo. La condizione da applicare al feed.
Organizzazioni
gcloud asset feeds create FEED_ID \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic=projects/PROJECT_ID/topics/TOPIC_ID \
--asset-names=ASSET_NAME_1,ASSET_NAME_2,... \
--asset-types=ASSET_TYPE_1,ASSET_TYPE_2,... \
--content-type=CONTENT_TYPE \
--condition-title="CONDITION_TITLE" \
--condition-description="CONDITION_DESCRIPTION" \
--condition-expression="CONDITION_EXPRESSION"
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.ORGANIZATION_ID
: l'ID del progetto di cui i metadati vengono inviati al feed.Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.PROJECT_ID
: l'ID del progetto in cui Si trova l'argomento Pub/Sub.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.ASSET_NAME
: facoltativo. Un elenco separato da virgole di nome e cognome della risorsa per cui vuoi ricevere notifiche di modifica.Almeno un
ASSET_NAME
o Il campoASSET_TYPE
è obbligatorio.ASSET_TYPE
: facoltativo. Un elenco separato da virgole di tipi di asset per cui vuoi ricevere notifiche di modifica. Le espressioni regolari sono supportati. Se l'espressione regolare non corrisponde a nessuna espressione tipo di risorsa, viene restituito un erroreINVALID_ARGUMENT
.Almeno un
ASSET_NAME
o Il campoASSET_TYPE
è obbligatorio.CONTENT_TYPE
: facoltativo. La risorsa tipo di contenuti per cui vuoi ricevere notifiche sulle modifiche.CONDITION_TITLE
: facoltativo. Il titolo del condizione da applicare al feed.CONDITION_DESCRIPTION
: facoltativo. La descrizione della condizione da applicare al feed.CONDITION_EXPRESSION
: facoltativo. La condizione da applicare al feed.
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 '{
"feedId": "FEED_ID",
"feed": {
"assetNames": [
"ASSET_NAME_1",
"ASSET_NAME_2",
"..."
],
"assetTypes": [
"ASSET_TYPE_1",
"ASSET_TYPE_2",
"..."
],
"contentType": "CONTENT_TYPE",
"feedOutputConfig": {
"pubsubDestination": {
"topic": "projects/PROJECT_ID/topics/TOPIC_ID"
}
},
"condition": {
"title": "CONDITION_TITLE",
"description": "CONDITION_DESCRIPTION",
"expression": "CONDITION_EXPRESSION"
}
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE/feeds
Fornisci i seguenti valori:
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.FEED_ID
: un identificatore univoco del feed di asset.ASSET_NAME
: facoltativo. Un elenco separato da virgole di nomi completi degli asset per i quali vuoi ricevere notifiche sulle modifiche.Almeno un
ASSET_NAME
o Il campoASSET_TYPE
è obbligatorio.ASSET_TYPE
: facoltativo. Un elenco separato da virgole di tipi di asset per per cui vuoi ricevere notifiche delle modifiche. Espressioni regolari sono supportati. Se l'espressione regolare non corrisponde a nessuna espressione tipo di risorsa, viene restituito un erroreINVALID_ARGUMENT
.Almeno un
ASSET_NAME
o Il campoASSET_TYPE
è obbligatorio.CONTENT_TYPE
: facoltativo. Il tipo di contenuti della risorsa. per cui vuoi ricevere notifiche di modifica.PROJECT_ID
: l'ID del progetto in cui Si trova l'argomento Pub/Sub.TOPIC_ID
: l'ID dell'argomento Pub/Sub in pubblica notifiche.CONDITION_TITLE
: facoltativo. Il titolo del condizione da applicare al feed.CONDITION_DESCRIPTION
: facoltativo. La descrizione della condizione da applicare al feed.CONDITION_EXPRESSION
: facoltativo. La condizione da applicare al feed.SCOPE
: un ambito può essere un progetto, una cartella o dell'organizzazione.I valori consentiti sono:
projects/PROJECT_ID
projects/PROJECT_NUMBER
Come trovare il numero di un progetto Google Cloud
Console
Per trovare il numero di un progetto Google Cloud, completa i seguenti passaggi:
-
Vai alla pagina Dashboard nella console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca i tuoi del progetto.
- Fai clic sul nome del progetto per passare a quel progetto. Il numero del progetto viene mostrato nel Scheda Informazioni sul progetto.
Interfaccia a riga di comando gcloud
Puoi recuperare un numero di progetto Google Cloud con il seguente comando:
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID
Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID
Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
Dopo aver creato un feed, iscriviti agli aggiornamenti dell'argomento Pub/Sub che
specificato nel feed. L'invio di un nuovo feed può richiedere fino a 10 minuti
notifiche. Viene inviata una notifica per ogni modifica apportata a una risorsa corrispondente
assetNames
o assetTypes
e soddisfa condition
nel feed.
Il primo messaggio pubblicato nell'argomento Pub/Sub è un messaggio di benvenuto
messaggio in formato stringa e tutti i messaggi seguenti sono nel
di TemporalAsset.
Ecco un messaggio di esempio per il tipo di contenuti RESOURCE
.
{
"asset": {
"ancestors": [
"projects/[PROJECT_ID]",
"folders/[FOLDER_ID]",
"organizations/[ORGANIZATION_ID]"
],
"assetType": "[ASSET_TYPE]",
"name": "[ASSET_NAME]",
"resource": {
"data": {
...detailed resource metadata...
},
"discoveryDocumentUri": "[DISCOVERY_URI]",
"discoveryName": "[DISCOVERY_NAME]",
"location": "[LOCATION]",
"parent": "[PARENT_ASSET_NAME]",
"version": "[VERSION]"
},
"updateTime": "[UPDATE_TIME]"
},
"priorAsset": {
...prior asset information...
},
"priorAssetState": "[PRIOR_ASSET_STATE]",
"window": {
"startTime": "[UPDATE_TIME]"
}
}
Per saperne di più su Pub/Sub o su come configurare le sottoscrizioni, consulta le documentazione di Pub/Sub.
Creazione di un feed per le modifiche al bucket Cloud Storage o alla tabella BigQuery
I comandi seguenti creano notifiche
TOPIC_ID
argomento Pub/Sub quando i contenuti cambiano
nel bucket Cloud Storage BUCKET_NAME
o in qualsiasi
Tabelle BigQuery:
gcloud
Progetti
gcloud asset feeds create FEED_ID \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
--asset-names=//storage.googleapis.com/BUCKET_NAME \
--asset-types=bigquery.googleapis.com/Table \
--content-type=resource
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.PROJECT_ID
: l'ID del progetto di cui i metadati vengono inviati al feed.BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.BUCKET_NAME
: il cloud storage il nome del bucket da monitorare.
Cartelle
gcloud asset feeds create FEED_ID \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
--asset-names=//storage.googleapis.com/BUCKET_NAME \
--asset-types=bigquery.googleapis.com/Table \
--content-type=resource
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.FOLDER_ID
: l'ID della cartella di cui i metadati vengono inviati al feed.Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.BUCKET_NAME
: il cloud storage il nome del bucket da monitorare.
Organizzazioni
gcloud asset feeds create FEED_ID \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
--asset-names=//storage.googleapis.com/BUCKET_NAME \
--asset-types=bigquery.googleapis.com/Table \
--content-type=resource
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.ORGANIZATION_ID
: l'ID dell'organizzazione i cui metadati vengono inviati al feed.Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.BUCKET_NAME
: il cloud storage il nome del bucket da monitorare.
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 '{
"feedId": "FEED_ID",
"feed": {
"assetNames": ["storage.googleapis.com/BUCKET_NAME"],
"assetTypes": ["bigquery.googleapis.com/Table"],
"contentType": "RESOURCE",
"feedOutputConfig": {
"pubsubDestination": {
"topic": "projects/PROJECT_ID/topics/TOPIC_ID"
}
}
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE/feeds
Fornisci i seguenti valori:
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.FEED_ID
: un identificatore univoco del feed di asset.BUCKET_NAME
: il cloud storage il nome del bucket da monitorare.PROJECT_ID
: l'ID del progetto di cui i metadati vengono inviati al feed.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.SCOPE
: un ambito può essere un progetto, una cartella o dell'organizzazione.I valori consentiti sono:
projects/PROJECT_ID
projects/PROJECT_NUMBER
Come trovare il numero di un progetto Google Cloud
Console
Per trovare il numero di un progetto Google Cloud, completa i seguenti passaggi:
-
Vai alla pagina Dashboard nella console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca i tuoi del progetto.
- Fai clic sul nome del progetto per passare a quel progetto. Il numero del progetto viene mostrato nel Scheda Informazioni sul progetto.
Interfaccia a riga di comando gcloud
Puoi recuperare un numero di progetto Google Cloud con il seguente comando:
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID
Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID
Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
Le notifiche vengono inviate solo quando i metadati della risorsa o del criterio della risorsa cambia per sé. Nell'esempio precedente, la modifica di qualsiasi risorsa in I bucket Cloud Storage o le tabelle BigQuery non attivano notifica.
Creare un feed per le modifiche ai tipi di asset
Le seguenti richieste creano notifiche dal
TOPIC_ID
argomento Pub/Sub quando i contenuti cambiano
nelle risorse il cui tipo di asset inizia con compute.googleapis.com
.
gcloud
Progetti
gcloud asset feeds create FEED_ID \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
--content-type=resource \
--asset-types=compute.googleapis.com.*
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.PROJECT_ID
: l'ID del progetto di cui i metadati vengono inviati al feed.BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.
Cartelle
gcloud asset feeds create FEED_ID \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
--content-type=resource \
--asset-types=compute.googleapis.com.*
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.FOLDER_ID
: l'ID della cartella di cui i metadati vengono inviati al feed.Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.
Organizzazioni
gcloud asset feeds create FEED_ID \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
--content-type=resource \
--asset-types=compute.googleapis.com.*
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.ORGANIZATION_ID
: l'ID dell'organizzazione i cui metadati vengono inviati al feed.Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.
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 '{
"feedId": "FEED_ID",
"feed": {
"assetTypes": ["compute.googleapis.com.*"],
"contentType": "RESOURCE",
"feedOutputConfig": {
"pubsubDestination": {
"topic": "projects/PROJECT_ID/topics/TOPIC_ID"
}
}
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE/feeds
Fornisci i seguenti valori:
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.FEED_ID
: un identificatore univoco del feed di asset.PROJECT_ID
: l'ID del progetto di cui i metadati vengono inviati al feed.TOPIC_ID
: l'ID dell'argomento Pub/Sub per pubblicare le notifiche.SCOPE
: un ambito può essere un progetto, una cartella o dell'organizzazione.I valori consentiti sono:
projects/PROJECT_ID
projects/PROJECT_NUMBER
Come trovare il numero di un progetto Google Cloud
Console
Per trovare il numero di un progetto Google Cloud, completa i seguenti passaggi:
-
Vai alla pagina Dashboard nella console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca i tuoi del progetto.
- Fai clic sul nome del progetto per passare a quel progetto. Il numero del progetto viene mostrato nel Scheda Informazioni sul progetto.
Interfaccia a riga di comando gcloud
Puoi recuperare un numero di progetto Google Cloud con il seguente comando:
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID
Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID
Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
Recupero dei feed in corso...
Per ottenere un feed specifico, effettua una delle seguenti richieste.
gcloud
Progetti
gcloud asset feeds describe FEED_ID \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.PROJECT_ID
: l'ID del progetto di cui sia pubblicata nel feed.BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.
Cartelle
gcloud asset feeds describe FEED_ID \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.FOLDER_ID
: l'ID della cartella di cui sia pubblicata nel feed.Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.
Organizzazioni
gcloud asset feeds describe FEED_ID \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID
Fornisci i seguenti valori:
FEED_ID
: un identificatore univoco del feed di asset.ORGANIZATION_ID
: l'ID dell'organizzazione i cui metadati sono pubblicati nel feed.Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.
REST
curl -X GET \
-H "X-Goog-User-Project: BILLING_PROJECT_ID" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://cloudasset.googleapis.com/v1/SCOPE/feeds/FEED_ID
Fornisci i seguenti valori:
BILLING_PROJECT_ID
: facoltativo. L'ID progetto che l'agente di servizio Cloud Asset Inventory predefinito è in che dispone delle autorizzazioni per e gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.SCOPE
: un ambito può essere un progetto, una cartella o dell'organizzazione. Gli ID progetto non sono supportati.I valori consentiti sono:
projects/PROJECT_NUMBER
Come trovare il numero di un progetto Google Cloud
Console
Per trovare il numero di un progetto Google Cloud, completa i seguenti passaggi:
-
Vai alla pagina Dashboard nella console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca i tuoi del progetto.
- Fai clic sul nome del progetto per passare a quel progetto. Il numero del progetto viene mostrato nel Scheda Informazioni sul progetto.
Interfaccia a riga di comando gcloud
Puoi recuperare un numero di progetto Google Cloud con il seguente comando:
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID
Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID
Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
FEED_ID
: un identificatore univoco del feed di asset.
Il feed viene restituito nel seguente formato, dove
FULL_NAME_FEED_ID
è l'identificatore del feed, insieme al suo
risorsa padre:
{
"name": "FULL_NAME_FEED_ID",
"assetTypes": ["ASSET_TYPES"],
"assetNames": ["ASSET_NAMES"],
"contentType": "CONTENT_TYPES",
"feedOutputConfig": {
"pubsubDestination": {
"topic": "projects/PROJECT_ID/topics/TOPIC_ID"
}
},
"condition": {
"title": "CONDITION_TITLE",
"description": "CONDITION_DESCRIPTION",
"expression": "CONDITION_EXPRESSION"
}
}
Feed di schede
Per elencare tutti i feed per un progetto, una cartella o un'organizzazione, imposta uno dei le seguenti richieste.
gcloud
Progetti
gcloud asset feeds list \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID
Fornisci i seguenti valori:
PROJECT_ID
: l'ID del progetto di cui sia pubblicata nel feed.BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.
Cartelle
gcloud asset feeds list \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID
Fornisci i seguenti valori:
FOLDER_ID
: l'ID della cartella di cui sia pubblicata nel feed.Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.
Organizzazioni
gcloud asset feeds list \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID
Fornisci i seguenti valori:
ORGANIZATION_ID
: l'ID dell'organizzazione i cui metadati sono pubblicati nel feed.Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.
REST
curl -X GET \
-H "X-Goog-User-Project: BILLING_PROJECT_ID" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://cloudasset.googleapis.com/v1/SCOPE/feeds
Fornisci i seguenti valori:
BILLING_PROJECT_ID
: facoltativo. L'ID progetto che l'agente di servizio Cloud Asset Inventory predefinito è in che dispone delle autorizzazioni per e gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.SCOPE
: un ambito può essere un progetto, una cartella o dell'organizzazione.I valori consentiti sono:
projects/PROJECT_ID
projects/PROJECT_NUMBER
Come trovare il numero di un progetto Google Cloud
Console
Per trovare il numero di un progetto Google Cloud, completa i seguenti passaggi:
-
Vai alla pagina Dashboard nella console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca i tuoi del progetto.
- Fai clic sul nome del progetto per passare a quel progetto. Il numero del progetto viene mostrato nel Scheda Informazioni sul progetto.
Interfaccia a riga di comando gcloud
Puoi recuperare un numero di progetto Google Cloud con il seguente comando:
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID
Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID
Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
Aggiornamento dei feed
Per aggiornare gli attributi di un feed, devi specificare il percorso degli attributi in
update_mask
e il valore di quell'attributo. La seguente richiesta
aggiorna i valori assetNames
e topic
di un feed in un progetto.
gcloud
Progetti
gcloud asset feeds update FEED_ID \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
--add-asset-names=ASSET_NAME_1,ASSET_NAME_2,...
Fornisci i seguenti valori:
PROJECT_ID
: l'ID del progetto di cui sia pubblicata nel feed.BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.TOPIC_ID
: l'ID dell'argomento Pub/Sub in cui vengono pubblicate le notifiche.ASSET_NAME
: facoltativo. Un elenco separato da virgole di nomi completi degli asset per per cui vuoi ricevere notifiche delle modifiche.
Cartelle
gcloud asset feeds update FEED_ID \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
--add-asset-names=ASSET_NAME_1,ASSET_NAME_2,...
Fornisci i seguenti valori:
FOLDER_ID
: l'ID della cartella di cui sia pubblicata nel feed.Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.PROJECT_ID
: l'ID del progetto in cui Si trova l'argomento Pub/Sub.TOPIC_ID
: l'ID dell'argomento Pub/Sub in cui vengono pubblicate le notifiche.ASSET_NAME
: facoltativo. Un elenco separato da virgole di nomi completi degli asset per per cui vuoi ricevere notifiche delle modifiche.
Organizzazioni
gcloud asset feeds update FEED_ID \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID \
--pubsub-topic="projects/PROJECT_ID/topics/TOPIC_ID" \
--add-asset-names=ASSET_NAME_1,ASSET_NAME_2,...
Fornisci i seguenti valori:
ORGANIZATION_ID
: l'ID dell'organizzazione i cui metadati sono pubblicati nel feed.Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.PROJECT_ID
: l'ID del progetto in cui Si trova l'argomento Pub/Sub.TOPIC_ID
: l'ID dell'argomento Pub/Sub in cui vengono pubblicate le notifiche.ASSET_NAME
: facoltativo. Un elenco separato da virgole di nomi completi degli asset per per cui vuoi ricevere notifiche delle modifiche.
REST
curl -X PATCH \
-H "X-Goog-User-Project: BILLING_PROJECT_ID" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"feed": {
"assetNames": [
"ASSET_NAME_1",
"ASSET_NAME_2",
"..."
],
"feedOutputConfig": {
"pubsubDestination": {
"topic": "projects/PROJECT_ID/topics/TOPIC_ID"
}
}
},
"update_mask": {
"paths": ["asset_names", "feed_output_config.pubsub_destination.topic"]
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE/feeds/FEED_ID
Fornisci i seguenti valori:
BILLING_PROJECT_ID
: facoltativo. L'ID progetto che l'agente di servizio Cloud Asset Inventory predefinito è in che dispone delle autorizzazioni per e gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.ASSET_NAME
: facoltativo. Un elenco separato da virgole di nomi completi degli asset per i quali vuoi ricevere notifiche sulle modifiche.PROJECT_ID
: l'ID del progetto in cui Si trova l'argomento Pub/Sub.TOPIC_ID
: l'ID dell'argomento Pub/Sub in cui vengono pubblicate le notifiche.SCOPE
: un ambito può essere un progetto, una cartella o dell'organizzazione. Gli ID progetto non sono supportati.I valori consentiti sono:
projects/PROJECT_NUMBER
Come trovare il numero di un progetto Google Cloud
Console
Per trovare il numero di un progetto Google Cloud, completa i seguenti passaggi:
-
Vai alla pagina Dashboard nella console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca i tuoi del progetto.
- Fai clic sul nome del progetto per passare a quel progetto. Il numero del progetto viene mostrato nel Scheda Informazioni sul progetto.
Interfaccia a riga di comando gcloud
Puoi recuperare un numero di progetto Google Cloud con il seguente comando:
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID
Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID
Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
Eliminazione dei feed
Se non vuoi più ricevere notifiche relative alle modifiche alle risorse, utilizza quanto segue per eliminare un feed su un progetto.
gcloud
Progetti
gcloud asset feeds delete FEED_ID \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID
Fornisci i seguenti valori:
PROJECT_ID
: l'ID del progetto di cui sia pubblicata nel feed.BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.
Cartelle
gcloud asset feeds delete FEED_ID \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID
Fornisci i seguenti valori:
FOLDER_ID
: l'ID della cartella di cui sia pubblicata nel feed.BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.
Organizzazioni
gcloud asset feeds delete FEED_ID \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID
Fornisci i seguenti valori:
ORGANIZATION_ID
: l'ID dell'organizzazione i cui metadati sono pubblicati nel feed.BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.
REST
curl -X DELETE \
-H "X-Goog-User-Project: BILLING_PROJECT_ID" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://cloudasset.googleapis.com/v1/SCOPE/feeds/FEED_ID
Fornisci i seguenti valori:
BILLING_PROJECT_ID
: facoltativo. L'ID del progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire l'argomento Pub/Sub. Scopri di più sui progetti di fatturazione.SCOPE
: un ambito può essere un progetto, una cartella o dell'organizzazione. Gli ID progetto non sono supportati.I valori consentiti sono:
projects/PROJECT_NUMBER
Come trovare il numero di un progetto Google Cloud
Console
Per trovare il numero di un progetto Google Cloud, completa i seguenti passaggi:
-
Vai alla pagina Dashboard nella console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca i tuoi del progetto.
- Fai clic sul nome del progetto per passare a quel progetto. Il numero del progetto viene mostrato nel Scheda Informazioni sul progetto.
Interfaccia a riga di comando gcloud
Puoi recuperare un numero di progetto Google Cloud con il seguente comando:
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID
Come trovare l'ID di una cartella Google Cloud
Console
Per trovare un ID cartella di Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud
Puoi recuperare l'ID di una cartella di Google Cloud che si trova a livello di organizzazione con il seguente comando:
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)"
Dove TOP_LEVEL_FOLDER_NAME può essere una stringa di corrispondenza completa o parziale. Rimuovi il
--format
per visualizzare ulteriori informazioni sulle cartelle trovate.Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID
Come trovare l'ID organizzazione Google Cloud
Console
Per trovare un ID organizzazione Google Cloud, completa i seguenti passaggi:
-
Vai alla console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Fai clic sulla casella Seleziona da e seleziona la tua organizzazione.
- Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud
Puoi recuperare un ID organizzazione Google Cloud con il comando seguente:
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
Risoluzione dei problemi
Questa sezione mostra come risolvere i problemi più comuni.
Mancata creazione o aggiornamento dei feed
Se la creazione o l'aggiornamento di un feed non riesce, la causa potrebbe essere un problema con autorizzazioni aggiuntive. Ogni richiesta di creazione o aggiornamento di un feed comprende tre parti: progetto consumer utilizzato per chiamare l'API, l'elemento padre di destinazione da monitorare sull'argomento Pub/Sub di destinazione per ricevere la notifica.
Per creare o aggiornare un feed, sono necessarie le seguenti autorizzazioni:
Il chiamante o l'account di servizio deve disporre delle autorizzazioni per gli asset nel padre di destinazione (che può essere un progetto, una cartella o un'organizzazione).
L'account di servizio degli asset (
service-PROJECT_NUMBER@gcp-sa-cloudasset.iam.gserviceaccount.com
) nel progetto consumer abilitato per l'API Cloud Asset deve averepubsub.topics.publish
sull'argomento Pub/Sub di destinazione.
Un messaggio di errore contenente does not have permission
potrebbe indicare che
l'account utente o di servizio non dispone delle autorizzazioni per gli asset. Scopri di più
sulle autorizzazioni richieste.
Viene visualizzato un messaggio di errore contenente
Fail to use TOPIC_ID as feed output destination
potrebbe
indicare che si è verificato un problema durante la pubblicazione del messaggio nell'argomento
specificato nella destinazione di output del feed. Per risolvere il problema:
Se utilizzi Google Cloud CLI, assicurati di utilizzare il progetto corretto:
gcloud config list project
Assicurati di aver specificato il nome corretto dell'argomento.
Assicurati che l'account di servizio (
service-PROJECT_NUMBER@gcp-sa-cloudasset.iam.gserviceaccount.com
) dispone dell'autorizzazionepubsub.topics.publish
per l'argomento, dovePROJECT_NUMBER
è il numero del progetto Progetto abilitato per Cloud Asset Inventory da cui prevedi di creare il feed.Come trovare il numero di un progetto Google Cloud
Console
Per trovare il numero di un progetto Google Cloud, completa i seguenti passaggi:
-
Vai alla pagina Dashboard nella console Google Cloud.
- Fai clic sulla casella del commutatore nella barra dei menu.
- Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca i tuoi del progetto.
- Fai clic sul nome del progetto per passare a quel progetto. Il numero del progetto viene mostrato nel Scheda Informazioni sul progetto.
Interfaccia a riga di comando gcloud
Puoi recuperare un numero di progetto Google Cloud con il seguente comando:
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
Mancata ricezione degli aggiornamenti delle risorse o dei criteri IAM
Se non ricevi notifiche per le risorse o i criteri IAM aggiornamenti, la verifica dei seguenti dettagli di configurazione può aiutare a risolvere problema:
Assicurati che i metadati delle tue risorse siano stati modificati. Il feed in tempo reale invia aggiornamenti solo quando i metadati dei tipi di risorse supportati è cambiato; per operazioni come il caricamento di un nuovo file Il bucket Cloud Storage non attiva una modifica dei metadati.
Assicurati che gli asset soddisfino uno dei criteri specificati nel feed ovvero nomi e tipi di asset.
Controlla i log per verificare se si verificano errori durante la pubblicazione degli aggiornamenti nel tuo per ogni argomento.
Utilizzo di Cloud Logging
Questa sezione descrive come configurare e visualizzare Logging per Feed in tempo reale di Cloud Asset Inventory.
Quando i feed in tempo reale non inviano le risorse o gli aggiornamenti dei criteri IAM mediante Pub/Sub, Cloud Asset Inventory registra lo stato di errore e tramite Logging. Il logging è abilitato da predefinito e appartiene a Google Cloud Observability. Informazioni su Prezzi di Google Cloud Observability.
Visualizzazione dei log dei feed in tempo reale
Per visualizzare i log, vai a Esplora log.
Il log del feed in tempo reale è indicizzato da un argomento Pub/Sub. Per visualizzare tutto log:
Fai clic sulla casella combinata Risorsa, accanto a Cerca in tutti i campi. .
Cerca
Cloud Pub/Sub Topic
, quindi fai clic su Argomento Cloud Pub/Sub un tipo di risorsa.Fai clic sull'ID argomento che vuoi visualizzare.
Fai clic su Applica.
La codifica UTF-8 viene applicata ai campi dei log. Caratteri non UTF-8 vengono sostituiti da punti interrogativi.
Informazioni registrate
Le voci di log dei feed in tempo reale contengono i seguenti tipi di informazioni:
Informazioni generali mostrate nella maggior parte dei log di Google Cloud, come gravità, l'ID progetto, il numero di progetto o il timestamp.
Campi del log del feed in tempo reale in
jsonPayload
, che contiene il nome della risorsa e il feed configurazione di output, stato di errore durante la pubblicazione della risorsa o di IAM aggiornamenti delle norme.
La tabella seguente mostra i tipi di informazioni contenuti in ciascun campo.
Campo | Tipo e descrizione |
---|---|
name |
Nome completo del feed. Il formato è uno dei seguenti:
|
asset_name |
Nome completo della risorsa per ricevere aggiornamenti. Ad esempio:
Consulta Nomi delle risorse . per ulteriori informazioni. |
feed_output_config |
La configurazione dell'output del feed che definisce la posizione degli aggiornamenti degli asset in cui è stato pubblicato. |
condition |
Condizione del feed che determina se un aggiornamento degli asset deve essere pubblicato. |
error_status |
Stato in caso di errore di pubblicazione degli aggiornamenti delle risorse in un feed. |