SyncResource - AWS Service Catalog

SyncResource

Syncs the resource with what is currently recorded in App registry. Specifically, the resource’s App registry system tags are synced with its associated application. The resource's App registry system tags are removed if it is not associated with the application. The caller must have permissions to read and update the resource.

Request Syntax

POST /sync/resourceType/resource HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

resource

An entity you can work with and specify with a name or ID. Examples include an Amazon EC2 instance, an AWS CloudFormation stack, or an Amazon S3 bucket.

Length Constraints: Minimum length of 1. Maximum length of 256.

Pattern: \S+

Required: Yes

resourceType

The type of resource of which the application will be associated.

Valid Values: CFN_STACK

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "actionTaken": "string", "applicationArn": "string", "resourceArn": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

actionTaken

The results of the output if an application is associated with an ARN value, which could be syncStarted or None.

Type: String

Valid Values: START_SYNC | NO_ACTION

applicationArn

The Amazon resource name (ARN) that specifies the application.

Type: String

Pattern: arn:aws[-a-z]*:servicecatalog:[a-z]{2}(-gov)?-[a-z]+-\d:\d{12}:/applications/[a-z0-9]+

resourceArn

The Amazon resource name (ARN) that specifies the resource.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

Errors

ConflictException

There was a conflict when processing the request (for example, a resource with the given name already exists within the account).

HTTP Status Code: 409

InternalServerException

The service is experiencing internal problems.

HTTP Status Code: 500

ResourceNotFoundException

The specified resource does not exist.

HTTP Status Code: 404

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: