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à.
# Modifica di un tipo di endpoint API pubblico o privato in API Gateway
La modifica di un tipo di endpoint API richiede l'aggiornamento della configurazione dell'API. Puoi modificare un tipo di API esistente utilizzando la console API Gateway AWS CLI, o un AWS SDK per API Gateway. Il tipo di endpoint non potrà essere modificato fino a quando non viene completata la modifica corrente ma, durante tale periodo, l’API sarà disponibile.
Sono supportate le seguenti modifiche ai tipi di endpoint:
+ Da ottimizzato per l'edge a regionale o privato
+ Da regionale a ottimizzato per l'edge o privato
+ Da privato a regionale
Non è possibile modificare un'API privata in un'API ottimizzata per i confini.
Se si intende modificare un'API pubblica da ottimizzata per l'edge a regionale o viceversa, è importante notare che un'API ottimizzata per l'edge può avere comportamenti diversi rispetto a un'API regionale. Ad esempio, un'API ottimizzata per i confini rimuove l'intestazione `Content-MD5`. Qualsiasi valore MD5 hash passato al backend può essere espresso in un parametro della stringa di richiesta o in una proprietà body. Tuttavia, l'API regionale passa questa intestazione, ma può rimappare il nome di intestazione a un altro nome. La comprensione delle differenze può aiutare a scegliere come aggiornare un'API ottimizzata per l'edge in una regionale o un'API regionale in una ottimizzata per l'edge.
**Topics**
+ [Uso della console API Gateway per modificare un tipo di endpoint API](#migrate-api-using-console)
+ [Utilizza il per modificare il tipo AWS CLI di endpoint dell'API](#migrate-api-using-aws-cli)
## Uso della console API Gateway per modificare un tipo di endpoint API
Per modificare il tipo di endpoint API della tua API, esegui uno dei seguenti insiemi di passaggi:
**Conversione di un endpoint pubblico da regionale o ottimizzato per l'edge e viceversa**
1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)
1. Scegliere una REST API.
1. Scegli **Impostazioni API**.
1. Nella sezione **Dettagli API**, scegli **Modifica**.
1. In **Tipo di endpoint API**, seleziona **Ottimizzato per l'edge** o **Regionale**.
1. Scegli **Save changes** (Salva modifiche).
1. Ridistribuisci la tua API in modo che le modifiche diventino effettive.
**Per convertire un endpoint privato in un endpoint regionale**
1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)
1. Scegliere una REST API.
1. Modifica la politica delle risorse per la tua API per rimuovere qualsiasi menzione VPCs o endpoint VPC in modo che le chiamate API dall'esterno del tuo VPC e dall'interno del tuo VPC abbiano esito positivo.
1. Scegli **Impostazioni API**.
1. Nella sezione **Dettagli API**, scegli **Modifica**.
1. In **Tipo di endpoint**, scegli**Regionale**.
1. Scegli **Save changes** (Salva modifiche).
1. Rimuovi la policy delle risorse dall'API.
1. Ridistribuisci la tua API in modo che le modifiche diventino effettive.
Poiché stai migrando il tipo di endpoint da privato a regionale, API Gateway cambia il tipo di indirizzo IP in. IPv4 Per ulteriori informazioni, consulta [Tipi di indirizzo IP per REST API in Gateway API](api-gateway-ip-address-type.md).
**Per convertire un endpoint regionale in un endpoint privato**
1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)
1. Scegliere una REST API.
1. Crea una policy delle risorse che fornisca l'accesso al VPC o all'endpoint VPC. Per ulteriori informazioni, consulta [Passaggio 3: impostare una policy delle risorse per un'API privata.](apigateway-private-api-create.md#apigateway-private-api-set-up-resource-policy).
1. Scegli **Impostazioni API**.
1. Nella sezione **Dettagli API**, scegli **Modifica**.
1. Per **Tipo di endpoint API** scegli **Privato**.
1. (Facoltativo) Per l'**endpoint VPC IDs**, seleziona l'endpoint VPC IDs che desideri associare alla tua API privata.
1. Scegli **Save changes** (Salva modifiche).
1. Ridistribuisci la tua API in modo che le modifiche diventino effettive.
Dal momento che si sta migrando il tipo di endpoint da regionale a privato, Gateway API modifica il tipo di indirizzo IP in dualstack. Per ulteriori informazioni, consulta [Tipi di indirizzo IP per REST API in Gateway API](api-gateway-ip-address-type.md).
## Utilizza il per modificare il tipo AWS CLI di endpoint dell'API
Il [update-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)comando seguente aggiorna un'API ottimizzata per l'edge in un'API regionale:
```
aws apigateway update-rest-api \
--rest-api-id a1b2c3 \
--patch-operations op=replace,path=/endpointConfiguration/types/EDGE,value=REGIONAL
```
La risposta di esito positivo ha il codice di stato `200 OK` e un payload simile al seguente:
```
{
"createdDate": "2017-10-16T04:09:31Z",
"description": "Your first API with Amazon API Gateway. This is a sample API that integrates via HTTP with our demo Pet Store endpoints",
"endpointConfiguration": {
"types": "REGIONAL"
},
"id": "a1b2c3",
"name": "PetStore imported as edge-optimized"
}
```
Il [update-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)comando seguente aggiorna un'API regionale a un'API ottimizzata per l'edge:
```
aws apigateway update-rest-api \
--rest-api-id a1b2c3 \
--patch-operations op=replace,path=/endpointConfiguration/types/REGIONAL,value=EDGE
```
Poiché [put-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/put-rest-api.html)serve per aggiornare le definizioni delle API, non è applicabile all'aggiornamento di un tipo di endpoint API.