Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1424136125.4 KB

Creates an Amazon Web Services Migration Hub Refactor Spaces application. The account that owns the environment also owns the applications created inside the environment, regardless of the account that creates the application. Refactor Spaces provisions an Amazon API Gateway, API Gateway VPC link, and Network Load Balancer for the application proxy inside your account.

In environments created with a CreateEnvironment:NetworkFabricType of NONE you need to configure VPC to VPC connectivity between your service VPC and the application proxy VPC to route traffic through the application proxy to a service with a private URL endpoint. For more information, see Create an application in the Refactor Spaces User Guide.

post/environments/{EnvironmentIdentifier}/applications

Path parameters

EnvironmentIdentifierstring required

The unique identifier of the environment.

Request body

ClientTokenstring

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Namestring required

The name to use for the application.

ProxyType'API_GATEWAY' required

The proxy type of the proxy created within the application.

Tagsobject

A collection of up to 50 unique tags

VpcIdstring required

The ID of the virtual private cloud (VPC).

Response

Success

ApplicationIdstring

The unique identifier of the application.

Arnstring

The Amazon Resource Name (ARN) of the application. The format for this ARN is <code>arn:aws:refactor-spaces:<i>region</i>:<i>account-id</i>:<i>resource-type/resource-id</i> </code>. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html"> Amazon Resource Names (ARNs)</a> in the <i>Amazon Web Services General Reference</i>.

CreatedByAccountIdstring

The Amazon Web Services account ID of application creator.

CreatedTimestring date-time

A timestamp that indicates when the application is created.

EnvironmentIdstring

The ID of the environment in which the application is created.

LastUpdatedTimestring date-time

A timestamp that indicates when the application was last updated.

Namestring

The name of the application.

OwnerAccountIdstring

The Amazon Web Services account ID of the application owner (which is always the same as the environment owner account ID).

ProxyType'API_GATEWAY'

The proxy type of the proxy created within the application.

State'CREATING' | 'ACTIVE' | 'DELETING' | 'FAILED' | 'UPDATING'

The current state of the application.

Tagsobject

The tags assigned to the application. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key-value pair.

VpcIdstring

The ID of the Amazon VPC.