Risorse API Gateway a cui è possibile applicare tag - Amazon API Gateway
Eredità dei tag nell'API di Amazon API Gateway V1Limitazioni applicate ai tag e convenzioni di utilizzo

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à.

Risorse API Gateway a cui è possibile applicare tag

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

  • 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 tale RestApi per 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, tale tag è ereditato da qualsiasi risorsa BasePathMapping al di sotto di esso.

  • Se un tag è impostato su un UsagePlan, tale tag è ereditato da qualsiasi risorsa UsagePlanKey al di sotto di esso.

Nota

L'eredità dei tag viene applicata solo per il controllo degli accessi basato sugli attributi. Ad esempio, non puoi utilizzare tag ereditati per monitorare i costi in. AWS Cost Explorer Per utilizzare i tag per l'allocazione dei costi, ti consigliamo di creare tag sulle risorse secondarie, come la Stage risorsa.

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). Le risorse Amazon EC2 consentono qualsiasi carattere.

  • Per chiavi e valori di 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, costcenter o CostCenter e 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.