Configura API con integrazioni private utilizzando Open API - Amazon API Gateway

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à.

Configura API con integrazioni private utilizzando Open API

Puoi configurarne una API con l'integrazione privata importando API il API file Open. Le impostazioni sono simili alle API definizioni Open di an API con HTTP integrazioni, con le seguenti eccezioni:

  • Devi impostare esplicitamente connectionType su VPC_LINK.

  • Devi impostare esplicitamente connectionId sull'ID di un oggetto VpcLink o su una variabile di fase che fa riferimento all'ID di un oggetto VpcLink.

  • Il uri parametro nell'integrazione privata punta a un HTTPS endpointHTTP/inVPC, ma viene invece utilizzato per configurare l'intestazione della richiesta di integrazione. Host

  • Il uri parametro nell'integrazione privata con un HTTPS endpoint in VPC viene utilizzato per verificare il nome di dominio indicato rispetto a quello del certificato installato sull'endpoint. VPC

Per fare riferimento all'ID di VpcLink, è possibile usare una variabile di fase. In alternativa, è possibile assegnare il valore ID direttamente a connectionId.

Il API file Open in JSON formato seguente mostra un esempio di un API con un VPC collegamento a cui fa riferimento una variabile di fase (): ${stageVariables.vpcLinkId}

OpenAPI 2.0
{
  "swagger": "2.0",
  "info": {
    "version": "2017-11-17T04:40:23Z",
    "title": "MyApiWithVpcLink"
  },
  "host": "p3wocvip9a.execute-api.us-west-2.amazonaws.com",
  "basePath": "/test",
  "schemes": [
    "https"
  ],
  "paths": {
    "/": {
      "get": {
        "produces": [
          "application/json"
        ],
        "responses": {
          "200": {
            "description": "200 response",
            "schema": {
              "$ref": "#/definitions/Empty"
            }
          }
        },
        "x-amazon-apigateway-integration": {
          "responses": {
            "default": {
              "statusCode": "200"
            }
          },
          "uri": "http://my-vpclink-test-nlb-1234567890abcdef.us-east-2.amazonaws.com",
          "passthroughBehavior": "when_no_match",
          "connectionType": "VPC_LINK",
          "connectionId": "${stageVariables.vpcLinkId}",
          "httpMethod": "GET",
          "type": "http_proxy"
        }
      }
    }
  },
  "definitions": {
    "Empty": {
      "type": "object",
      "title": "Empty Schema"
    }
  }
}