Class CreateResolverEndpointCommandProtected

Creates a Resolver endpoint. There are two types of Resolver endpoints, inbound and outbound:

• An inbound Resolver endpoint forwards DNS queries to the DNS service for a VPC from your network.

• An outbound Resolver endpoint forwards DNS queries from the DNS service for a VPC to your network.

Example

Use a bare-bones client and the command you need to make an API call.

import { Route53ResolverClient, CreateResolverEndpointCommand } from "@aws-sdk/client-route53resolver"; // ES Modules import
// const { Route53ResolverClient, CreateResolverEndpointCommand } = require("@aws-sdk/client-route53resolver"); // CommonJS import
const client = new Route53ResolverClient(config);
const input = { // CreateResolverEndpointRequest
  CreatorRequestId: "STRING_VALUE", // required
  Name: "STRING_VALUE",
  SecurityGroupIds: [ // SecurityGroupIds // required
    "STRING_VALUE",
  ],
  Direction: "INBOUND" || "OUTBOUND", // required
  IpAddresses: [ // IpAddressesRequest // required
    { // IpAddressRequest
      SubnetId: "STRING_VALUE", // required
      Ip: "STRING_VALUE",
      Ipv6: "STRING_VALUE",
    },
  ],
  Tags: [ // TagList
    { // Tag
      Key: "STRING_VALUE", // required
      Value: "STRING_VALUE", // required
    },
  ],
  ResolverEndpointType: "IPV6" || "IPV4" || "DUALSTACK",
};
const command = new CreateResolverEndpointCommand(input);
const response = await client.send(command);
// { // CreateResolverEndpointResponse
//   ResolverEndpoint: { // ResolverEndpoint
//     Id: "STRING_VALUE",
//     CreatorRequestId: "STRING_VALUE",
//     Arn: "STRING_VALUE",
//     Name: "STRING_VALUE",
//     SecurityGroupIds: [ // SecurityGroupIds
//       "STRING_VALUE",
//     ],
//     Direction: "INBOUND" || "OUTBOUND",
//     IpAddressCount: Number("int"),
//     HostVPCId: "STRING_VALUE",
//     Status: "CREATING" || "OPERATIONAL" || "UPDATING" || "AUTO_RECOVERING" || "ACTION_NEEDED" || "DELETING",
//     StatusMessage: "STRING_VALUE",
//     CreationTime: "STRING_VALUE",
//     ModificationTime: "STRING_VALUE",
//     ResolverEndpointType: "IPV6" || "IPV4" || "DUALSTACK",
//   },
// };

Param

CreateResolverEndpointCommandInput

Returns

CreateResolverEndpointCommandOutput

See

• CreateResolverEndpointCommandInput for command's input shape.
• CreateResolverEndpointCommandOutput for command's response shape.
• config for Route53ResolverClient's config shape.

Throws

InternalServiceErrorException (client fault)

We encountered an unknown error. Try again in a few minutes.

Throws

InvalidParameterException (client fault)

One or more parameters in this request are not valid.

Throws

InvalidRequestException (client fault)

The request is invalid.

Throws

LimitExceededException (client fault)

The request caused one or more limits to be exceeded.

Throws

ResourceExistsException (client fault)

The resource that you tried to create already exists.

Throws

ResourceNotFoundException (client fault)

The specified resource doesn't exist.

Throws

ThrottlingException (client fault)

The request was throttled. Try again in a few minutes.

Throws

Route53ResolverServiceException

Base exception class for all service exceptions from Route53Resolver service.