Siapkan API dengan integrasi pribadi menggunakan OpenAPI

Anda dapat menyiapkan API dengan integrasi pribadi dengan mengimpor file OpenAPI API. Pengaturannya mirip dengan definisi OpenAPI API dengan integrasi HTTP, dengan pengecualian berikut:

• Anda harus secara eksplisit mengatur connectionType ke. VPC_LINK

• Anda harus secara eksplisit mengatur connectionId ke ID dari VpcLink atau ke variabel tahap yang merujuk ID dari sebuah. VpcLink

• uriParameter dalam integrasi pribadi menunjuk ke titik akhir HTTP/HTTPS di VPC, tetapi digunakan sebagai gantinya untuk mengatur header permintaan integrasi. Host

• uriParameter dalam integrasi pribadi dengan titik akhir HTTPS di VPC digunakan untuk memverifikasi nama domain yang dinyatakan terhadap yang ada di sertifikat yang diinstal pada titik akhir VPC.

Anda dapat menggunakan variabel tahap untuk mereferensikan VpcLink ID. Atau Anda dapat menetapkan nilai ID langsung keconnectionId.

File OpenAPI berformat JSON berikut menunjukkan contoh API dengan tautan VPC seperti yang direferensikan oleh variabel tahap (): ${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"
    }
  }
}