Gestisci i tag

In questa sezione imparerai come collegare, scollegare ed elencare i tag nelle risorse Datastream, ad esempio flussi, profili di connessione o connessioni private. Per una panoramica dei tag su Datastream, consulta Controllo dell'accesso con i tag.

Informazioni sui tag

Un tag è una coppia chiave-valore che può essere collegata a una risorsa all'interno di Google Cloud. Puoi utilizzare i tag per consentire o negare in modo condizionale i criteri a seconda che una risorsa abbia un tag specifico. Ad esempio, puoi concedere in modo condizionale i ruoli IAM (Identity and Access Management) a seconda che una risorsa abbia un tag specifico. Per ulteriori informazioni sui tag, consulta la sezione Panoramica dei tag.

I tag vengono collegati alle risorse creando una risorsa di associazione di tag che collega il valore alla risorsa Google Cloud.

Per raggruppare flussi di dati, profili di connessione o connessioni private all'interno di Datastream a fini di automazione e fatturazione, utilizza le etichette. I tag e le etichette funzionano in modo indipendente l'uno dall'altro e puoi applicarli entrambi alle risorse.

Autorizzazioni obbligatorie

Le autorizzazioni necessarie dipendono dall'azione che devi eseguire.

Per ottenere queste autorizzazioni, chiedi all'amministratore di concedere il ruolo suggerito al livello appropriato della gerarchia delle risorse.

Visualizza tag

Per visualizzare le definizioni dei tag e i tag collegati alle risorse, devi disporre del ruolo Visualizzatore tag (roles/resourcemanager.tagViewer) o di un altro ruolo che includa le seguenti autorizzazioni:

Autorizzazioni obbligatorie

resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.tagValues.list
resourcemanager.tagValues.get
listTagBindings per il tipo di risorsa appropriato. Ad esempio, compute.instances.listTagBindings per visualizzare i tag associati alle istanze di Compute Engine.
listEffectiveTags

compute.instances.listEffectiveTags

Per visualizzare i tag a livello di organizzazione, devi disporre del ruolo Visualizzatore organizzazione (roles/resourcemanager.organizationViewer) nella risorsa organizzazione.

Amministrazione dei tag

Per creare, aggiornare ed eliminare le definizioni dei tag, devi disporre del ruolo Amministratore tag (roles/resourcemanager.tagAdmin) o di un altro ruolo che includa le seguenti autorizzazioni:

Autorizzazioni obbligatorie

resourcemanager.tagKeys.create
resourcemanager.tagKeys.update
resourcemanager.tagKeys.delete
resourcemanager.tagKeys.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.getIamPolicy
resourcemanager.tagKeys.setIamPolicy
resourcemanager.tagValues.create
resourcemanager.tagValues.update
resourcemanager.tagValues.delete
resourcemanager.tagValues.list
resourcemanager.tagValues.get
resourcemanager.tagValues.getIamPolicy
resourcemanager.tagValues.setIamPolicy

Per amministrare i tag a livello di organizzazione, devi disporre del ruolo Visualizzatore organizzazione (roles/resourcemanager.organizationViewer) nella risorsa organizzazione.

Gestisci i tag sulle risorse

Per aggiungere e rimuovere i tag collegati alle risorse, devi disporre del ruolo Utente tag (roles/resourcemanager.tagUser) o di un altro ruolo con autorizzazioni equivalenti, sia per il valore tag sia per le risorse a cui stai collegando il valore tag. Il ruolo Utente tag include le seguenti autorizzazioni:

Autorizzazioni obbligatorie

Autorizzazioni richieste per la risorsa a cui stai collegando il valore tag

Autorizzazione createTagBinding specifica della risorsa, ad esempio compute.instances.createTagBinding per le istanze di Compute Engine.
Autorizzazione deleteTagBinding specifica della risorsa, ad esempio compute.instances.deleteTagBinding per le istanze di Compute Engine.

Autorizzazioni richieste per il valore tag:

resourcemanager.tagValueBindings.create
resourcemanager.tagValueBindings.delete

Autorizzazioni che consentono di visualizzare i progetti e le definizioni dei tag:

resourcemanager.tagValues.get
resourcemanager.tagValues.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.projects.get

Per collegare tag alle risorse Datastream, devi disporre del ruolo Amministratore Datastream (roles/datastream.admin) o di un altro ruolo che includa le seguenti autorizzazioni:

Autorizzazioni obbligatorie

datastream.connectionProfiles.createTagBinding
datastream.connectionProfiles.deleteTagBinding
datastream.connectionProfiles.listTagBindings
datastream.connectionProfiles.listEffectiveTags
datastream.streams.createTagBinding
datastream.streams.deleteTagBinding
datastream.streams.listTagBindings
datastream.streams.listEffectiveTags
datastream.privateConnections.createTagBinding
datastream.privateConnections.deleteTagBinding
datastream.privateConnections.listTagBindings
datastream.privateConnections.listEffectiveTags

Creare chiavi e valori dei tag

Prima di poter collegare un tag, devi creare un tag e configurarne il valore. Per creare chiavi e valori tag per i tag, consulta gli articoli Creazione di un tag e Aggiunta di un valore tag.

Collegare un tag a uno stream, a un profilo di connessione o a una connessione privata

Dopo aver creato il tag, devi collegarlo a uno stream, a un profilo di connessione o a una connessione privata.

Console

Vai alla pagina Datastream nella console Google Cloud.

Vai a Datastream

Seleziona la pagina della risorsa a cui vuoi collegare un tag. Ad esempio, per associare un tag a un profilo di connessione, vai alla pagina Profili di connessione.
Fai clic su Tag.
Se la tua organizzazione non appare nel riquadro Tag, fai clic su Seleziona ambito. Seleziona la tua organizzazione e fai clic su **Apri**.
Fai clic su Aggiungi tag.
Seleziona dall'elenco la chiave del tag che vuoi allegare. Puoi filtrare l'elenco digitando parole chiave.
Seleziona dall'elenco il valore del tag che vuoi allegare. Puoi filtrare l'elenco digitando parole chiave.
Fai clic su Salva.
Nella finestra di dialogo Conferma, fai clic su Conferma per allegare il tag.

Una notifica conferma l'aggiornamento dei tag.

gcloud

Per associare un tag a un flusso, un profilo di connessione o una connessione privata, devi creare una risorsa di associazione di tag utilizzando il comando gcloud resource-manager tags bindings create:

      gcloud resource-manager tags bindings create \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID \
          --location=LOCATION

Sostituisci quanto segue:

TAGVALUE_NAME: l'ID permanente o il nome con spazio dei nomi del valore tag associato, ad esempio: tagValues/567890123456.
RESOURCE_ID è l'ID completo della risorsa, incluso il nome di dominio dell'API per identificare il tipo di risorsa (//datastream.googleapis.com/). Ad esempio, per collegare un tag a projects/PROJECT_NAME/streams/STREAM_NAME, l'ID completo è: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
LOCATION: la località della risorsa. Se colleghi un tag a una risorsa globale, come una cartella o un progetto, devi omettere questo flag. Se colleghi un tag a una risorsa di regione o zona, devi specificare la località, ad esempio: us-central1 (regione) o us-central1-a (zona).

Elenca i tag collegati a uno stream, a un profilo di connessione o a una connessione privata

Puoi visualizzare un elenco di associazioni di tag direttamente collegate o ereditate dal flusso, dal profilo di connessione o dalla connessione privata.

Console

Vai alla pagina Datastream nella console Google Cloud.

Vai a Datastream

Seleziona la pagina della risorsa in cui vuoi visualizzare i tag. Ad esempio, per visualizzare i tag per il profilo di connessione, vai alla pagina Profili di connessione.

I tag vengono visualizzati nella colonna Tag dello stream, del profilo di connessione o della connessione privata.

gcloud

Per ottenere un elenco delle associazioni di tag collegate a una risorsa, utilizza il comando gcloud resource-manager tags bindings list:

      gcloud resource-manager tags bindings list \
          --parent=RESOURCE_ID \
          --location=LOCATION

Sostituisci quanto segue:

RESOURCE_ID è l'ID completo della risorsa, incluso il nome di dominio dell'API per identificare il tipo di risorsa (//datastream.googleapis.com/). Ad esempio, per collegare un tag a projects/PROJECT_NAME/streams/STREAM_NAME, l'ID completo è: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
LOCATION: la località della risorsa. Se stai visualizzando un tag associato a una risorsa globale, come una cartella o un progetto, devi omettere questo flag. Se stai visualizzando un tag associato a una risorsa di regione o zona, devi specificare la località, ad esempio: us-central1 (regione) o us-central1-a (zona).

Dovresti ricevere una risposta simile alla seguente:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //datastream.googleapis.com/projects/project-abc/streams/stream-xyz<

Scollegare i tag da stream, profilo di connessione o connessione privata

Puoi scollegare i tag collegati direttamente a uno stream, a un profilo di connessione o a una connessione privata. I tag ereditati possono essere sostituiti collegando un tag con la stessa chiave e un valore diverso, ma non possono essere scollegati. Prima di poter eliminare un tag, devi scollegare la relativa chiave e i relativi valori da ogni risorsa a cui è collegato.

Console

Vai alla pagina Datastream nella console Google Cloud.

Vai a Datastream

Seleziona la pagina della risorsa a cui vuoi rimuovere un tag. Ad esempio, per rimuovere un tag da un profilo di connessione, vai alla pagina Profili di connessione.
Fai clic su Tag.
Nel riquadro Tag, accanto al tag che vuoi scollegare, fai clic su Elimina elemento.
Fai clic su Salva.
Nella finestra di dialogo Conferma, fai clic su Conferma per scollegare il tag.

Una notifica conferma l'aggiornamento dei tag.

gcloud

Per eliminare un'associazione di tag, utilizza il comando gcloud resource-manager tags bindings delete:

      gcloud resource-manager tags bindings delete \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID \
          --location=LOCATION

Sostituisci quanto segue:

TAGVALUE_NAME: l'ID permanente o il nome con spazio dei nomi del valore tag associato, ad esempio: tagValues/567890123456.
RESOURCE_ID è l'ID completo della risorsa, incluso il nome di dominio dell'API per identificare il tipo di risorsa (//datastream.googleapis.com/). Ad esempio, per collegare un tag a projects/PROJECT_NAME/streams/STREAM_NAME, l'ID completo è: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
LOCATION: la località della risorsa. Se colleghi un tag a una risorsa globale, come una cartella o un progetto, devi omettere questo flag. Se colleghi un tag a una risorsa di regione o zona, devi specificare la località, ad esempio: us-central1 (regione) o us-central1-a (zona).

Elimina chiavi e valori tag

Quando rimuovi una definizione di valore o una chiave del tag, assicurati che il tag sia scollegato dallo stream, dal profilo di connessione o dalla connessione privata. Prima di eliminare la definizione del tag, devi eliminare gli allegati di tag esistenti, chiamati associazioni di tag. Per eliminare le chiavi e i valori dei tag, consulta Eliminazione dei tag.

Condizioni e tag di Identity and Access Management

Puoi utilizzare i tag e le condizioni IAM per concedere in modo condizionale le associazioni di ruoli agli utenti nella gerarchia. La modifica o l'eliminazione del tag associato a una risorsa può comportare la rimozione dell'accesso utente alla risorsa se è stato applicato un criterio IAM con associazioni di ruoli condizionali. Per ulteriori informazioni, vedi Condizioni e tag di Identity and Access Management.

Passaggi successivi

Consulta gli altri servizi che supportano i tag.
Per scoprire come utilizzare i tag con IAM, consulta Tag e controllo dell'accesso.

Indietro

Utilizza le API Datastream

Avanti

Gestire le configurazioni di connettività privata utilizzando l'API