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à.
# Note importanti Amazon API Gateway
La sezione seguente descrive in dettaglio le note che possono riguardare l'utilizzo di Gateway API.
**Topics**
+ [Note importanti su Amazon API Gateway per HTTP APIs](#api-gateway-known-issues-http-apis)
+ [Note importanti su Amazon API Gateway per HTTP e WebSocket APIs](#api-gateway-known-issues-http-and-websocket-apis)
+ [Note importanti su Amazon API Gateway per REST e WebSocket APIs](#api-gateway-known-issues-rest-and-websocket-apis)
+ [Note importanti su Amazon API Gateway per WebSocket APIs](#api-gateway-known-issues-websocket-apis)
+ [Note importanti su Amazon API Gateway per REST APIs](#api-gateway-known-issues-rest-apis)
## Note importanti su Amazon API Gateway per HTTP APIs
+ HTTP APIs tradurrà le `X-Forwarded-*` intestazioni in entrata in un'`Forwarded`intestazione standard e aggiungerà l'IP di uscita, l'host e il protocollo.
+ Gateway API aggiunge l’intestazione Content-type alla richiesta se non è presente alcun payload e Content-Length è pari a 0.
## Note importanti su Amazon API Gateway per HTTP e WebSocket APIs
+ La versione 4A di Signature non è ufficialmente supportata da Amazon API Gateway per HTTP e WebSocket APIs.
## Note importanti su Amazon API Gateway per REST e WebSocket APIs
+ API Gateway non supporta la condivisione di un nome di dominio personalizzato tra REST e WebSocket APIs.
+ I nomi di fasi possono contenere solo caratteri alfanumerici, trattini e caratteri di sottolineatura. La lunghezza massima è 128 caratteri.
+ I percorsi di `/ping` e `/sping` sono riservati al controllo dello stato del servizio. Se questi percorsi vengono utilizzati per le risorse API al livello di root con domini personalizzati, non sarà possibile ottenere il risultato previsto.
+ Attualmente API Gateway limita gli eventi di log a 1024 byte. Gli eventi di registro di dimensioni superiori a 1024 byte, come i corpi di richiesta e risposta, verranno troncati da API Gateway prima dell'invio ai log. CloudWatch
+ CloudWatch Attualmente Metrics limita i nomi e i valori delle dimensioni a 255 caratteri XML validi. Per ulteriori informazioni, consulta la [Guida per l'utente di CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension). I valori di dimensione sono una funzione di nomi definiti dall'utente, tra cui nome dell'API, nome dell'etichetta (fase) e nome della risorsa. Quando scegli questi nomi, fai attenzione a non superare i limiti CloudWatch delle metriche.
+ La dimensione massima di un modello di mappatura è 300 KB.
## Note importanti su Amazon API Gateway per WebSocket APIs
+ API Gateway supporta payload dei messaggi fino a 128 KB con dimensione del frame massima di 32 KB. Se un messaggio supera i 32 KB, occorre suddividerlo in più frame, ciascuno di 32 KB o più piccolo. Se si riceve un messaggio di dimensioni maggiori, la connessione viene chiusa con codice 1009.
## Note importanti su Amazon API Gateway per REST APIs
+ Il carattere barra verticale di testo semplice (`|`) e il carattere parentesi graffa (`{` o `}`) non sono supportati per le stringhe di query dell'URL della richiesta e devono presentare la codifica URL.
+ Il punto e virgola (`;`) non è supportato per qualsiasi URL di richiesta della stringa di query e i risultati dei dati del frazionamento.
+ REST APIs decodifica i parametri di richiesta con codifica URL prima di passarli alle integrazioni di backend. Per i parametri di richiesta UTF-8, REST APIs decodifica i parametri e poi li passa come unicode alle integrazioni di backend. APIs L'URL REST codifica il carattere percentuale () prima di passarlo alle integrazioni di backend. `%`
+ Se effettui il test di un'API tramite la console API Gateway, potresti ricevere la risposta "unknown endpoint errors" (errori endpoint sconosciuti) se un certificato autofirmato viene inviato al back-end, se il certificato intermedio manca nella catena dei certificati o se viene rilevata dal back-end qualsiasi altra eccezione relativa a un certificato non riconoscibile.
+ È consigliabile eliminare un'entità API [https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html) o [https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html) con un'integrazione privata, dopo aver rimosso eventuali riferimenti hardcoded di un [https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html](https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html). In caso contrario, l'integrazione verrà sospesa e riceverai un errore che ti informerà che il collegamento VPC è ancora in uso anche in seguito all'eliminazione dell'entità `Resource` o `Method`. Questo comportamento non si applica quando l'integrazione privata fa riferimento a `VpcLink` tramite una variabile di fase.
+ I back-end seguenti potrebbero non supportare l'autenticazione client SSL in un modo che sia compatibile con API Gateway:
+ [NGINX](https://nginx.org/en/)
+ [Heroku](https://www.heroku.com/)
+ API Gateway supporta in gran parte la [specifica OpenAPI 2.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md) e la [specifica OpenAPI 3.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.1.md), con le seguenti eccezioni:
+ I segmenti di percorso possono contenere solo caratteri alfanumerici, trattini, punti, virgole, due punti e parentesi graffe. I parametri di percorso devono essere segmenti di percorso separati. Ad esempio, "risorsa/\$1nome\$1parametro\$1percorso\$1" è valido, mentre "risorsa\$1nome\$1parametro\$1percorso\$1" no.
+ I nomi di modelli possono contenere solo caratteri alfanumerici.
+ Per i parametri di input, sono supportati solo i seguenti attributi: `name`, `in`, `required`, `type`, `description`. Altri attributi vengono ignorati.
+ Il tipo `securitySchemes`, se utilizzato, deve essere `apiKey`. [Tuttavia, l'autenticazione OAuth 2 e HTTP Basic sono supportate tramite [autorizzatori Lambda](apigateway-use-lambda-authorizer.md); la configurazione OpenAPI viene ottenuta tramite le estensioni del fornitore.](api-gateway-swagger-extensions-authorizer.md)
+ Il `deprecated` campo non è supportato e viene eliminato nella cartella Exported. APIs
+ I modelli di API Gateway sono definiti tramite la [bozza 4 dello schema JSON](https://datatracker.ietf.org/doc/html/draft-zyp-json-schema-04), anziché lo schema JSON utilizzato da OpenAPI.
+ Il parametro `discriminator` non è supportato in nessun oggetto dello schema.
+ Il tag `example` non è supportato.
+ Il campo `nullable` non è supportato.
+ `exclusiveMinimum` non è supportato da API Gateway.
+ I tag `maxItems` e `minItems` non sono inclusi nella [convalida della richiesta semplice](api-gateway-method-request-validation.md). Come soluzione alternativa, aggiorna il modello in seguito all'importazione e prima di procedere con la convalida.
+ Per OpenAPI 3.0, non è possibile specificare una parola chiave `oneOf`, `anyOf` o `allOf` che utilizza `$ref` per una definizione all’interno dello stesso schema. È possibile immettere direttamente lo schema o definire una risorsa separata del modello Gateway API. Per ulteriori informazioni, consulta [Creazione di modelli più complessi](models-mappings-models.md#api-gateway-request-validation-model-more-complex).
+ `oneOf` non è supportato per OpenAPI 2.0 o la generazione di SDK.
+ Il campo `readOnly` non è supportato.
+ `$ref` non può essere utilizzato per fare riferimento ad altri file.
+ Le definizioni di risposta del modulo `"500": {"$ref": "#/responses/UnexpectedError"}` non sono supportate nella root del documento di OpenAPI. Come soluzione alternativa, sostituisci i riferimenti con lo schema inline.
+ I numeri del tipo `Int32` o `Int64` non sono supportati. Di seguito viene riportato un esempio:
```
"elementId": {
"description": "Working Element Id",
"format": "int32",
"type": "number"
}
```
+ Il tipo di formato con numeri decimali (`"format": "decimal"`) non è supportato nelle definizioni dello schema.
+ Nelle risposte del metodo, la definizione dello schema deve essere di tipo oggetto e non di tipo di base. Ad esempio, `"schema": { "type": "string"}` non è supportato. Tuttavia, puoi trovare una soluzione alternativa al problema utilizzando il tipo di oggetto seguente:
```
"schema": {
"$ref": "#/definitions/StringResponse"
}
"definitions": {
"StringResponse": {
"type": "string"
}
}
```
+ API Gateway non utilizza la sicurezza a livello di radice definita nella specifica di OpenAPI. Pertanto, la sicurezza deve essere definita a livello di operazione per essere applicata in modo appropriato.
+ La parola chiave `default` non è supportata.
+ In API Gateway vengono applicate le seguenti restrizioni e limitazioni per la gestione dei metodi con l'integrazione Lambda o HTTP.
+ I nomi delle intestazioni e i parametri di query vengono elaborati tenendo presente la distinzione tra lettere maiuscole e minuscole.
+ La tabella seguente elenca le intestazioni che potrebbero venire interrotte, rimappate o modificate quando vengono inviate all'endpoint dell'integrazione o reinviate dall'endpoint dell'integrazione: In questa tabella:
+ `Remapped` significa che il nome dell'intestazione è cambiato da `` a `X-Amzn-Remapped-`.
`Remapped Overwritten` significa che il nome dell'intestazione è cambiato da `` a `X-Amzn-Remapped-` e il valore viene sovrascritto.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/apigateway/latest/developerguide/api-gateway-known-issues.html)
\$1 L'intestazione `Authorization` viene eliminata se contiene una firma [Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) o viene usata un’autorizzazione `AWS_IAM`.
+ L'SDK Android di un'API generata da API Gateway utilizza la classe `java.net.HttpURLConnection`. Questa classe genererà un'eccezione non gestita, sui dispositivi con Android 4.4 e versioni precedenti, per la risposta 401 derivante dalla rimappatura dell'intestazione `WWW-Authenticate` su `X-Amzn-Remapped-WWW-Authenticate`.
+ A differenza di Java, Android e iOS SDKs di un'API generati da API Gateway, l' JavaScript SDK di un'API generata da API Gateway non supporta tentativi per errori di livello 500.
+ La chiamata di test di un metodo utilizza il tipo di contenuto predefinito di `application/json` e ignora le specifiche di altri tipi di contenuto.
+ Quando invii richieste a un'API passando l'intestazione `X-HTTP-Method-Override`, API Gateway sostituisce il metodo. Per passare l'intestazione al back-end, è necessario aggiungere l'intestazione all'integrazione richiesta.
+ Quando una richiesta contiene più tipi di supporto nell'intestazione `Accept`, API Gateway mantiene la conformità solo al primo tipo di supporto `Accept`. Nella situazione in cui non puoi controllare l'ordine dei tipi di supporto `Accept` e il tipo di supporto del tuo contenuto binario non è il primo dell'elenco, puoi aggiungere il primo tipo di supporto `Accept` nell'elenco `binaryMediaTypes` della tua API e API Gateway restituirà il tuo contenuto come binario. Ad esempio, per inviare un file JPEG utilizzando un elemento `![]()
` in un browser, il browser potrebbe inviare `Accept:image/webp,image/*,*/*;q=0.8` in una richiesta. Aggiungendo `image/webp` all'elenco `binaryMediaTypes`, l'endpoint riceverà il file JPEG come binario.
+ La personalizzazione della risposta del gateway predefinito per `413 REQUEST_TOO_LARGE` non è attualmente supportata.
+ API Gateway include un'intestazione `Content-Type` per tutte le risposte di integrazione. Per impostazione predefinita, il tipo di contenuto è `application/json`.