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à.
Mappa API le fasi su un nome di dominio personalizzato per HTTP APIs
Le API mappature vengono utilizzate per connettere le API fasi a un nome di dominio personalizzato. Dopo aver creato un nome di dominio e configurato DNS i record, utilizzi le API mappature per inviare traffico al tuo utente APIs tramite il tuo nome di dominio personalizzato.
Una API mappatura specifica unaAPI, una fase e, facoltativamente, un percorso da utilizzare per la mappatura. Ad esempio, è possibile mappare lo production
stadio di un albero. API https://api.example.com/orders
Puoi mappare HTTP tutti gli REST API stage sullo stesso nome di dominio personalizzato.
Prima di creare una API mappatura, è necessario disporre di unaAPI, di una fase e di un nome di dominio personalizzato. Per ulteriori informazioni sulla creazione di un nome di dominio personalizzato, consulta Configura un nome di dominio personalizzato regionale in API Gateway.
Richieste di routing API
È possibile configurare API mappature con più livelli, ad esempio e. orders/v1/items
orders/v2/items
Per le API mappature con più livelli, API Gateway indirizza le richieste alla API mappatura con il percorso di corrispondenza più lungo. APIGateway considera solo i percorsi configurati per le API mappature, e non i API percorsi, per selezionare quelli da richiamare. API Se nessun percorso corrisponde alla richiesta, API Gateway invia la richiesta a API quello che hai mappato sul percorso vuoto. (none)
Per i nomi di dominio personalizzati che utilizzano API mappature con più livelli, API Gateway indirizza le richieste alla API mappatura con il prefisso corrispondente più lungo.
Ad esempio, considera un nome https://api.example.com
di dominio personalizzato con le seguenti mappature: API
-
(none)
mappato su 1. API -
orders
mappato su 2API. -
orders/v1/items
mappato a 3. API -
orders/v2/items
mappato a 4. API -
orders/v2/items/categories
mappato a 5. API
Richiesta | Selezionato API | Spiegazione |
---|---|---|
|
|
La richiesta corrisponde esattamente a questa API mappatura. |
|
|
La richiesta corrisponde esattamente a questa API mappatura. |
|
|
La richiesta corrisponde esattamente a questa API mappatura. |
|
|
APIGateway sceglie la mappatura con il percorso corrispondente più lungo. |
|
|
APIGateway sceglie la mappatura con il percorso corrispondente più lungo. |
|
|
APIGateway utilizza la mappatura vuota come soluzione generale. |
|
|
APIGateway sceglie la mappatura con il prefisso corrispondente più lungo. Per un nome di dominio personalizzato configurato con mappature a livello singolo, ad esempio only |
Restrizioni
-
In una API mappatura, il nome di dominio personalizzato e quello mappato APIs devono trovarsi nello stesso account. AWS
-
APIle mappature devono contenere solo lettere, numeri e i seguenti caratteri:.
$-_.+!*'()/
-
La lunghezza massima del percorso in una API mappatura è di 300 caratteri.
-
Puoi avere 200 API mappature con più livelli per ogni nome di dominio.
-
È possibile eseguire il mapping HTTP APIs solo su un nome di dominio personalizzato regionale con la politica di sicurezza TLS 1.2.
-
Non è possibile eseguire il mapping WebSocket APIs allo stesso nome di dominio personalizzato di un HTTP API or RESTAPI.
Creare una API mappatura
Per creare una API mappatura, devi prima creare un nome di dominio e uno stage API personalizzati. Per informazioni sulla creazione di un nome di dominio personalizzato, consulta Configura un nome di dominio personalizzato regionale in API Gateway.
Per esempio i AWS Serverless Application Model modelli che creano tutte le risorse, vedi Sessions With SAM