Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1473359323.2 KB

Creates a resource configuration. A resource configuration defines a specific resource. You can associate a resource configuration with a service network or a VPC endpoint.

post/resourceconfigurations

Request body

namestring required

The name of the resource configuration. The name must be unique within the account. The valid characters are a-z, 0-9, and hyphens (-). You can't use a hyphen as the first or last character, or immediately after another hyphen.

type'GROUP' | 'CHILD' | 'SINGLE' | 'ARN' required
<p>The type of resource configuration. A resource configuration can be one of the following types:</p> <ul> <li> <p> <b>SINGLE</b> - A single resource.</p> </li> <li> <p> <b>GROUP</b> - A group of resources. You must create a group resource configuration before you create a child resource configuration.</p> </li> <li> <p> <b>CHILD</b> - A single resource that is part of a group resource configuration.</p> </li> <li> <p> <b>ARN</b> - An Amazon Web Services resource.</p> </li> </ul>
portRangesPortRange[]

(SINGLE, GROUP, CHILD) The TCP port ranges that a consumer can use to access a resource configuration (for example: 1-65535). You can separate port ranges using commas (for example: 1,2,22-30).

protocol'TCP'

(SINGLE, GROUP) The protocol accepted by the resource configuration.

resourceGatewayIdentifierstring

(SINGLE, GROUP, ARN) The ID or ARN of the resource gateway used to connect to the resource configuration. For a child resource configuration, this value is inherited from the parent resource configuration.

resourceConfigurationGroupIdentifierstring

(CHILD) The ID or ARN of the parent resource configuration of type <code>GROUP</code>. This is used to associate a child resource configuration with a group resource configuration.

allowAssociationToShareableServiceNetworkboolean

(SINGLE, GROUP, ARN) Specifies whether the resource configuration can be associated with a sharable service network. The default is false.

customDomainNamestring

A custom domain name for your resource configuration. Additionally, provide a DomainVerificationID to prove your ownership of a domain.

groupDomainstring

(GROUP) The group domain for a group resource configuration. Any domains that you create for the child resource are subdomains of the group domain. Child resources inherit the verification status of the domain.

domainVerificationIdentifierstring

The domain verification ID of your verified custom domain name. If you don't provide an ID, you must configure the DNS settings yourself.

clientTokenstring

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you retry a request that completed successfully using the same client token and parameters, the retry succeeds without performing any actions. If the parameters aren't identical, the retry fails.

tagsobject

The tags for the resource configuration.

Response

Success

idstring

The ID of the resource configuration.

namestring

The name of the resource configuration.

arnstring

The Amazon Resource Name (ARN) of the resource configuration.

resourceGatewayIdstring

The ID of the resource gateway associated with the resource configuration.

resourceConfigurationGroupIdstring

The ID of the parent resource configuration of type <code>GROUP</code>.

type'GROUP' | 'CHILD' | 'SINGLE' | 'ARN'
<p>The type of resource configuration. A resource configuration can be one of the following types:</p> <ul> <li> <p> <b>SINGLE</b> - A single resource.</p> </li> <li> <p> <b>GROUP</b> - A group of resources. You must create a group resource configuration before you create a child resource configuration.</p> </li> <li> <p> <b>CHILD</b> - A single resource that is part of a group resource configuration.</p> </li> <li> <p> <b>ARN</b> - An Amazon Web Services resource.</p> </li> </ul>
portRangesPortRange[]

The port range.

protocol'TCP'

The protocol.

status'ACTIVE' | 'CREATE_IN_PROGRESS' | 'UPDATE_IN_PROGRESS' | 'DELETE_IN_PROGRESS' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED'

The current status of the resource configuration.

allowAssociationToShareableServiceNetworkboolean

Specifies whether the resource configuration can be associated with a sharable service network.

createdAtstring date-time

The date and time that the resource configuration was created, in ISO-8601 format.

failureReasonstring

The reason that the request failed.

customDomainNamestring

The custom domain name for your resource configuration.

domainVerificationIdstring

The domain name verification ID.

groupDomainstring

(GROUP) The group domain for a group resource configuration. Any domains that you create for the child resource are subdomains of the group domain. Child resources inherit the verification status of the domain.

domainVerificationArnstring

The verification ID ARN