Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
I tag possono essere impostati sulle seguenti risorse API HTTP o WebSocket API nell'API Amazon API Gateway V2:
-
Api -
DomainName -
Stage -
VpcLink
Inoltre, i tag possono essere impostati sulle seguenti risorse di API REST nell'API di Amazon API Gateway V1:
-
ApiKey -
ClientCertificate -
DomainName -
DomainNameAccessAssociation -
RestApi -
Stage -
UsagePlan -
VpcLink
I tag non possono essere impostati direttamente su altre risorse. Tuttavia, nell'API di Amazon API Gateway V1, le risorse figlio ereditano i tag impostati sulle risorse padre. Per esempio:
-
Se un tag è impostato su una risorsa
RestApi, questo tag è ereditato dalle seguenti risorse figlio di taleRestApiper il Controllo degli accessi basato sugli attributi:-
Authorizer -
Deployment -
Documentation -
GatewayResponse -
Integration -
Method -
Model -
Resource -
ResourcePolicy -
Setting -
Stage
-
-
Se un tag è impostato su un
DomainName, quel tag viene ereditato da tutteApiMappingle risorse cheBasePathMappinglo contengono. -
Se un tag è impostato su un
UsagePlan, tale tag è ereditato da qualsiasi risorsaUsagePlanKeyal di sotto di esso.
Nota
L'eredità dei tag viene applicata solo per il controllo degli accessi basato sugli attributi. Ad esempio, non è possibile utilizzare tag ereditati per monitorare i costi in. AWS Cost Explorer Per utilizzare i tag per l'allocazione dei costi, si consiglia di creare i tag sulle risorse figlio, ad esempio la risorsa Stage.
API Gateway non restituisce tag ereditati quando GetTagsrichiedi una risorsa.
Eredità dei tag nell'API di Amazon API Gateway V1
In precedenza, era solo possibile impostare tag su fasi. Ora che è possibile impostarli anche su altre risorse, uno Stage può ricevere un tag in due modi:
-
Il tag può essere impostato direttamente sullo
Stage. -
La fase può ereditare il tag dalla sua padr
RestApi.
Se una fase riceve un tag in entrambi i modi, il tag che è stato impostato direttamente sulla fase ha la precedenza. Ad esempio, supponiamo che una fase erediti i seguenti tag dalla sua API REST padre:
{ 'foo': 'bar', 'x':'y' }
Supponiamo anche che disponga dei seguenti tag impostati direttamente su di essa:
{ 'foo': 'bar2', 'hello': 'world' }
Il risultato netto è che la fase dispone dei seguenti tag, con i seguenti valori:
{ 'foo': 'bar2', 'hello': 'world' 'x':'y' }
Limitazioni applicate ai tag e convenzioni di utilizzo
Le seguenti limitazioni e convenzioni di utilizzo si applicano all'utilizzo dei tag con risorse API Gateway:
-
Ogni risorsa può avere un massimo di 50 tag.
-
Per ciascuna risorsa, ogni chiave del tag deve essere univoca e ogni chiave del tag può avere un solo valore.
-
La lunghezza massima delle chiavi di tag è 128 caratteri Unicode in UTF-8.
-
Il valore massimo dei tag è 256 caratteri Unicode in UTF-8.
-
I caratteri consentiti per chiavi e valori sono lettere, numeri, spazi rappresentabili in formato UTF-8, oltre ai seguenti caratteri: . : + = @ _ / - (trattino). EC2 Le risorse di Amazon consentono qualsiasi carattere.
-
Per le chiavi e i valori dei tag viene fatta la distinzione tra maiuscole e minuscole. Come best practice, è consigliabile definire una strategia per l'uso delle lettere maiuscole e minuscole nei tag e implementarla costantemente in tutti i tipi di risorse. Ad esempio, puoi decidere se utilizzare
Costcenter,costcenteroCostCentere utilizzare la stessa convenzione per tutti i tag. Non utilizzare tag simili con lettere maiuscole o minuscole incoerenti. -
Il prefisso
aws:non può essere utilizzato con i tag; è riservato per l'uso in AWS . Non è possibile modificare né eliminare le chiavi o i valori di tag con tale prefisso. I tag con questo prefisso non vengono conteggiati per il limite del numero di tag per risorsa.
