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à.
Distribuzione di un'API REST in API Gateway.
In API Gateway una distribuzione di API REST è rappresentata da una risorsa Distribuzione. È simile a un eseguibile di un'API rappresentato da una risorsa RestApi.
Per consentire al client di chiamare l'API, è necessario creare una distribuzione e associarvi una fase. Una fase è rappresentata da una risorsa Fase. Rappresenta una snapshot dell'API, inclusi metodi, integrazioni, modelli, modelli di mappatura e autorizzazioni Lambda (in precedenza note come autorizzazioni ad hoc). Quando si aggiorna l'API, è possibile ridistribuirla associando una nuova fase alla distribuzione esistente. La procedura di creazione di una fase è illustrata in Configurazione di una fase per un'API REST.
Argomenti
Creazione di una distribuzione mediante AWS CLI
Quando si crea una distribuzione, viene creata un'istanza della risorsa Distribuzione. Per creare un'implementazione è possibile utilizzare la console API Gateway, la AWS CLI, un SDK AWS o l'API REST di API Gateway.
Per usare la CLI per creare una distribuzione, usa il comando create-deployment:
aws apigateway create-deployment --rest-api-id <rest-api-id> --region <region>
L'API non è chiamabile fino a quando non si associa questa distribuzione a una fase. Con una fase esistente è possibile eseguire questa operazione aggiornando la proprietà deploymentId
della fase con l'ID di distribuzione appena creato (<deployment-id>
).
aws apigateway update-stage --region <region> \ --rest-api-id <rest-api-id> \ --stage-name <stage-name> \ --patch-operations op='replace',path='/deploymentId',value='<deployment-id>'
Quando distribuisci un'API per la prima volta, puoi combinare la creazione della fase e quella della distribuzione in modo che avvengano contemporaneamente:
aws apigateway create-deployment --region <region> \ --rest-api-id <rest-api-id> \ --stage-name <stage-name>
Questo è quello che accade nella console API Gateway quando si distribuisce un'API per la prima volta o quando si ridistribuisce l'API in una nuova fase.