v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1424136125.4 KB

Creates an Amazon Web Services Migration Hub Refactor Spaces service. The account owner of the service is always the environment owner, regardless of which account in the environment creates the service. Services have either a URL endpoint in a virtual private cloud (VPC), or a Lambda function endpoint.

If an Amazon Web Services resource is launched in a service VPC, and you want it to be accessible to all of an environment’s services with VPCs and routes, apply the RefactorSpacesSecurityGroup to the resource. Alternatively, to add more cross-account constraints, apply your own security group.

post/environments/{EnvironmentIdentifier}/applications/{ApplicationIdentifier}/services

Path parameters

ApplicationIdentifierstring required

The ID of the application which the service is created.

EnvironmentIdentifierstring required

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

Request body

ClientTokenstring

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

Descriptionstring

The description of the service.

EndpointType'LAMBDA' | 'URL' required

The type of endpoint to use for the service. The type can be a URL in a VPC or an Lambda function.

Namestring required

The name of the service.

Tagsobject

A collection of up to 50 unique tags

VpcIdstring

The ID of the VPC.

Response

Success

ApplicationIdstring

The ID of the application that the created service belongs to.

Arnstring

The Amazon Resource Name (ARN) of the service.

CreatedByAccountIdstring

The Amazon Web Services account ID of the service creator.

CreatedTimestring date-time

A timestamp that indicates when the service is created.

Descriptionstring

The description of the created service.

EndpointType'LAMBDA' | 'URL'

The endpoint type of the service.

EnvironmentIdstring

The unique identifier of the environment.

LastUpdatedTimestring date-time

A timestamp that indicates when the service was last updated.

Namestring

The name of the service.

OwnerAccountIdstring

The Amazon Web Services account ID of the service owner.

ServiceIdstring

The unique identifier of the service.

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

The current state of the service.

Tagsobject

The tags assigned to the created service. 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 VPC.