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
<a name="apigateway-tagging-supported-resources"></a>

I tag possono essere impostati sulle seguenti risorse API HTTP o WebSocket API nell'API [Amazon API Gateway V2](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/):
+ `Api`
+ `DomainName`
+ `Stage`
+ `VpcLink`

Inoltre, i tag possono essere impostati sulle seguenti risorse di API REST nell'[API di Amazon API Gateway V1](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html):
+ `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](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html), le risorse figlio ereditano i tag impostati sulle risorse padre. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html):
  + `Authorizer`
  + `Deployment`
  + `Documentation`
  + `GatewayResponse`
  + `Integration`
  + `Method`
  + `Model`
  + `Resource`
  + `ResourcePolicy`
  + `Setting`
  + `Stage`
+ Se un tag è impostato su un `DomainName`, tale tag viene ereditato da qualsiasi risorsa `BasePathMapping`, `ApiMapping` e `RoutingRule` sottostante.
+ 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). Ad esempio, non puoi 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 [GetTags](https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-tags.html)richiedi una risorsa.

## Eredità dei tag nell'API di Amazon API Gateway V1
<a name="apigateway-tagging-inheritance"></a>

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
<a name="apigateway-tagging-restrictions"></a>

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.