---
title: "POST /responder-gateway"
method: POST
path: "/responder-gateway"
---

# POST /responder-gateway

`POST /responder-gateway`

Creates a responder gateway.

A domain name or managed endpoint is required.

## Request body

- object
  - `vpcId` string, required — The unique identifier of the Virtual Private Cloud (VPC).
  - `subnetIds` SubnetId[], required — The unique identifiers of the subnets.
  - `securityGroupIds` SecurityGroupId[], required — The unique identifiers of the security groups.
  - `domainName` string — The domain name for the responder gateway.
  - `port` integer, required — The networking port to use.
  - `protocol` 'HTTP' | 'HTTPS', required — The networking protocol to use.
  - `listenerConfig` object — Listener configuration for the protocols (HTTP, HTTPS, or both) accepted by the gateway.
    - `protocols` Protocol[] — The protocol for connections from clients to the gateway
  - `trustStoreConfiguration` object — Describes the configuration of a trust store.
    - `certificateAuthorityCertificates` Base64EncodedCertificateChain[] — The certificate authority certificate.
  - `managedEndpointConfiguration` object — Describes the configuration of a managed endpoint.
    - `autoScalingGroups` object — Describes the configuration of an auto scaling group.
      - `autoScalingGroupNames` AutoScalingGroupName[], required — The names of the auto scaling group.
      - `roleArn` string, required — The role ARN of the auto scaling group.
      - `healthCheckConfig` object — The health check configuration for the Auto Scaling group managed endpoint.
        - `port` integer, required — The port to use for health check probes. Valid range is 80 to 65535.
        - `path` string, required — The destination path for the health check request. Must start with <code>/</code>.
        - `protocol` 'HTTP' | 'HTTPS' — The protocol to use for health check probes.
        - `timeoutMs` integer — The timeout for each health check probe, in milliseconds. Valid range is 100 to 5000.
        - `intervalSeconds` integer — The interval between health check probes, in seconds. Valid range is 5 to 60.
        - `statusCodeMatcher` string — The expected HTTP status code or status code pattern from healthy instances. Supports a single code (for example, <code>200</code>), a range (for example, <code>200-299</code>), or a comma-separated list (for example, <code>200,204</code>).
        - `healthyThresholdCount` integer — The number of consecutive successful health checks required before an instance is considered healthy. Valid range is 2 to 10.
        - `unhealthyThresholdCount` integer — The number of consecutive failed health checks required before an instance is considered unhealthy. Valid range is 2 to 10.
    - `eksEndpoints` object — Describes the configuration of an Amazon Elastic Kubernetes Service endpoint.
      - `endpointsResourceName` string, required — The name of the endpoint resource.
      - `endpointsResourceNamespace` string, required — The namespace of the endpoint resource.
      - `clusterApiServerEndpointUri` string, required — The URI of the cluster API server endpoint.
      - `clusterApiServerCaCertificateChain` string, password, required — The CA certificate chain of the cluster API server.
      - `clusterName` string, required — The name of the cluster.
      - `roleArn` string, required — The role ARN for the cluster.
  - `clientToken` string, required — The unique client token.
  - `description` string — An optional description for the responder gateway.
  - `tags` object — A map of the key-value pairs of the tag or tags to assign to the resource.
  - `gatewayType` 'EXTERNAL' | 'INTERNAL' — The type of gateway.

## Response `200`

Success

- CreateResponderGatewayResponse
  - `gatewayId` string, required — The unique identifier of the gateway.
  - `status` 'PENDING_CREATION' | 'ACTIVE' | 'PENDING_DELETION' | 'DELETED' | 'ERROR' | 'PENDING_UPDATE' | 'ISOLATED' | 'PENDING_ISOLATION' | 'PENDING_RESTORATION', required — The status of the request.
  - `listenerConfig` object — The listener configuration for the responder gateway.
    - `protocols` Protocol[], required — The protocol for connections from clients to the gateway
  - `externalInboundEndpoint` string — The external inbound endpoint for the responder gateway.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — AccessDeniedException
- `484` — InternalServerException
- `485` — ValidationException

---

[API](https://skmtc.net/aws/apis/rtbfabric.md) · [All operations](https://skmtc.net/aws/apis/rtbfabric/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/rtbfabric/versions/9fa17cecba3a/schema)