Usare l'etichettatura

Questa sezione descrive come aggiungere tag di metadati chiave-valore alle applicazioni del servizio gestito per Apache Flink. Questi tag possono essere utilizzati per i seguenti scopi:

• Determinazione della fatturazione per singole applicazioni del servizio gestito per Apache Flink. Per ulteriori informazioni, consulta Utilizzo dei tag per l'allocazione dei costi nella Guida per l'utente di Billing and Cost Management.

• Controllo dell'accesso alle risorse dell’applicazione in base ai tag. Per ulteriori informazioni, consulta Controllo degli accessi tramite tag nella AWS Identity and Access Management Guida per l'utente.

• Ambiti definiti dall'utente. È possibile definire le funzionalità delle applicazioni in base alla presenza di tag utente.

Tieni in considerazione i seguenti concetti chiave durante il tagging:

• Il numero massimo di tag delle applicazioni include i tag di sistema. Il numero massimo di tag delle applicazioni definiti dall'utente è 50.

• Se un'azione include un elenco di tag con valori Key duplicati, il servizio genera InvalidArgumentException.

Aggiungere tag quando viene creata un'applicazione

I tag vengono aggiunti durante la creazione di un'applicazione utilizzando il tags parametro dell'CreateApplicationazione.

La richiesta di esempio seguente mostra il nodo Tags per una richiesta CreateApplication:

"Tags": [ 
    { 
        "Key": "Key1",
        "Value": "Value1"
    },
    { 
        "Key": "Key2",
        "Value": "Value2"
    }
]

Aggiungere o u tag per un'applicazione esistente

Si aggiungono tag a un'applicazione utilizzando l'TagResourceazione. Non è possibile aggiungere tag a un'applicazione utilizzando l'UpdateApplicationazione.

Per aggiornare un tag esistente, aggiungere un tag con la stessa chiave del tag esistente.

La seguente richiesta di esempio per l’operazione TagResource aggiunge nuovi tag o aggiorna i tag esistenti:

{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "NewTagKey",
         "Value": "NewTagValue"
      },
      { 
         "Key": "ExistingKeyOfTagToUpdate",
         "Value": "NewValueForExistingTag"
      }
   ]
}

Elencare i tag per un'applicazione

Per elencare i tag esistenti, si utilizza l'ListTagsForResourceazione.

L'esempio seguente di richiesta per l'ListTagsForResourceazione elenca i tag per un'applicazione:

{
   "ResourceARN": "arn:aws:kinesisanalyticsus-west-2:012345678901:application/MyApplication"
}

Rimuovere i tag da un'applicazione

Per rimuovere i tag da un'applicazione, si utilizza l'UntagResourceazione.

La seguente richiesta di esempio per l'operazione UntagResource rimuove i tag per un'applicazione:

{
   "ResourceARN": "arn:aws:kinesisanalyticsus-west-2:012345678901:application/MyApplication",
   "TagKeys": [ "KeyOfFirstTagToRemove", "KeyOfSecondTagToRemove" ]
}