Gestisci i tag

In questa sezione, imparerai come allegare, scollegare ed elencare i tag Risorse Datastream, ad esempio flussi, profili di connessione o connessioni private. Per un una panoramica dei tag in Datastream, consulta Accesso usando i tag.

Informazioni sui tag

Un tag è una coppia chiave-valore collegabile a una risorsa all'interno in Google Cloud. Puoi utilizzare i tag per consentire o negare in modo condizionale i criteri in base se una risorsa ha un tag specifico. Ad esempio, puoi concedere in modo condizionale i ruoli di Identity and Access Management (IAM) a seconda che una risorsa abbia un tag specifico. Per saperne di più sui tag, consulta la Panoramica dei tag.

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

Per raggruppare stream, profili di connessione o connessioni private all'interno di Datastream per l'automazione e la fatturazione, usa etichette. Tag ed etichette funzionano in modo indipendente l'uno dall'altro e puoi applicare entrambi Google Cloud.

Autorizzazioni obbligatorie

Le autorizzazioni necessarie dipendono dall'azione da eseguire.

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

Visualizza tag

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

Autorizzazioni obbligatorie

  • resourcemanager.tagKeys.get
  • resourcemanager.tagKeys.list
  • resourcemanager.tagValues.list
  • resourcemanager.tagValues.get
  • listTagBindings per il tipo di risorsa appropriato. Per esempio, compute.instances.listTagBindings per visualizzare i tag collegate alle istanze Compute Engine.
  • listEffectiveTags
    • per il tipo di risorsa appropriato. Ad esempio, compute.instances.listEffectiveTags per la visualizzazione tutti i tag associati o ereditati dalle istanze Compute Engine.

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

Amministra i tag

Per creare, aggiornare ed eliminare le definizioni dei tag, devi disporre dei seguenti Ruolo di Amministratore tag (roles/resourcemanager.tagAdmin) o un altro ruolo che include 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 è necessario Ruolo Visualizzatore organizzazione (roles/resourcemanager.organizationViewer) in risorsa dell'organizzazione.

Gestisci i tag sulle risorse

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

Autorizzazioni obbligatorie

  • Autorizzazioni richieste per la risorsa a cui stai associando il valore del tag
    • Autorizzazione createTagBinding specifica della risorsa, ad esempio compute.instances.createTagBinding per Compute Engine di Compute Engine.
    • Autorizzazione deleteTagBinding specifica della risorsa, ad esempio compute.instances.deleteTagBinding per Compute Engine di Compute Engine.
  • Autorizzazioni richieste per il valore tag:
    • resourcemanager.tagValueBindings.create
    • resourcemanager.tagValueBindings.delete
  • Autorizzazioni che consentono di visualizzare progetti e definizioni di tag:
    • resourcemanager.tagValues.get
    • resourcemanager.tagValues.list
    • resourcemanager.tagKeys.get
    • resourcemanager.tagKeys.list
    • resourcemanager.projects.get

Per collegare tag alle risorse Datastream, è necessario il ruolo di Amministratore Datastream (roles/datastream.admin) o un altro ruolo che include 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 crearne uno e configurarne il valore. Per creare chiavi e valori dei tag, consulta Creare un tag e Aggiungere un valore del 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 un stream, a un profilo di connessione o a una connessione privata.

Console

  1. Vai alla pagina Datastream nella nella console Google Cloud.

    2. Vai a Datastream

  2. Seleziona la pagina della risorsa a cui vuoi associare un tag. Ad esempio, per associare un tag a un profilo di connessione, vai alla pagina Profili di connessione.
  3. Fai clic su Tag.
  4. Se la tua organizzazione non compare nel riquadro Tag, fai clic su Seleziona ambito. Seleziona la tua organizzazione e fai clic su Apri.
  5. Fai clic su Aggiungi tag.
  6. Seleziona dall'elenco la chiave relativa al tag che vuoi allegare. Puoi filtra l'elenco digitando parole chiave.
  7. Seleziona dall'elenco il valore del tag da associare. Puoi filtrare l'elenco digitando le parole chiave.
  8. Fai clic su Salva.
  9. Nella finestra di dialogo Conferma, fai clic su Conferma per allegare del tag.

    10. Una notifica conferma che i tag sono stati aggiornati.

gcloud

Per collegare un tag a uno stream, a un profilo di connessione o a una connessione privata, devi creare un di associazione di tag utilizzando 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 nome con spazio dei nomi del valore del 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 associare un tag projects/PROJECT_NAME/streams/STREAM_NAME, l'ID completo è: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
  • LOCATION: il valore località della risorsa. Se stai collegando un tag a un account globale come una cartella o un progetto, ometti questo flag. Se colleghi un tag a una risorsa regionale o di zona, devi specificare la località, ad esempio us-central1 (regione) o us-central1-a (zona).

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

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

Console

  1. Vai alla pagina Datastream nella nella console Google Cloud.

    2. Vai a Datastream

  2. 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 di lo stream, il profilo di connessione o la connessione privata.

gcloud

Per ottenere un elenco di associazioni di tag associate 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 associare un tag a projects/PROJECT_NAME/streams/STREAM_NAME, l'ID completo è //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
  • LOCATION: il valore località della risorsa. Se stai visualizzando un tag associato a una risorsa globale, ad esempio una cartella o un progetto, ometti questo flag. Se stai visualizzando un tag associato a un account di regione o di 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 uno stream, da un profilo di connessione o da una connessione privata

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

Console

  1. Vai alla pagina Datastream nella nella console Google Cloud.

    2. Vai a Datastream

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

    7. Una notifica conferma che i tag sono stati aggiornati.

gcloud

Per eliminare un'associazione di tag, utilizza la proprietà 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 nome con spazio dei nomi del valore del 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 associare un tag projects/PROJECT_NAME/streams/STREAM_NAME, l'ID completo è: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
  • LOCATION: il valore località della risorsa. Se colleghi un tag a una risorsa globale, come una cartella o un progetto, ometti questo flag. Se colleghi un tag a una risorsa regionale o di zona, devi specificare la località, ad esempio us-central1 (regione) o us-central1-a (zona).

Elimina chiavi e valori dei tag

Quando rimuovi la definizione di un valore o di una chiave tag, assicurati che il tag sia scollegato dal stream, profilo di connessione o connessione privata. Devi eliminare gli allegati dei tag esistenti, chiamati associazioni di tag, prima di eliminare la definizione del tag stessa. Per eliminare le chiavi dei tag e il tag consulta la sezione Eliminazione dei tag.

Condizioni e tag di Identity and Access Management

Puoi utilizzare tag e condizioni IAM per concedere associazioni di ruoli agli utenti della gerarchia. La modifica o l'eliminazione del tag associato a una risorsa può rimuovere l'accesso degli utenti a quella risorsa se è stato applicato un criterio IAM con associazioni di ruoli condizionali. Per Per saperne di più, consulta Condizioni e tag di Identity and Access Management.

Passaggi successivi