v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1424136125.4 KB

Creates an Amazon Web Services Migration Hub Refactor Spaces environment. The caller owns the environment resource, and all Refactor Spaces applications, services, and routes created within the environment. They are referred to as the environment owner. The environment owner has cross-account visibility and control of Refactor Spaces resources that are added to the environment by other accounts that the environment is shared with.

When creating an environment with a CreateEnvironment:NetworkFabricType of TRANSIT_GATEWAY, Refactor Spaces provisions a transit gateway to enable services in VPCs to communicate directly across accounts. If CreateEnvironment:NetworkFabricType is NONE, Refactor Spaces does not create a transit gateway and you must use your network infrastructure to route traffic to services with private URL endpoints.

post/environments

Request body

ClientTokenstring

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

Descriptionstring

The description of the environment.

Namestring required

The name of the environment.

NetworkFabricType'TRANSIT_GATEWAY' | 'NONE' required

The network fabric type of the environment.

Tagsobject

A collection of up to 50 unique tags

Response

Success

Arnstring

The Amazon Resource Name (ARN) of the environment.

CreatedTimestring date-time

A timestamp that indicates when the environment is created.

Descriptionstring

A description of the environment.

EnvironmentIdstring

The unique identifier of the environment.

LastUpdatedTimestring date-time

A timestamp that indicates when the environment was last updated.

Namestring

The name of the environment.

NetworkFabricType'TRANSIT_GATEWAY' | 'NONE'

The network fabric type of the environment.

OwnerAccountIdstring

The Amazon Web Services account ID of environment owner.

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

The current state of the environment.

Tagsobject

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