---
title: "POST /StartChangeSet"
method: POST
path: "/StartChangeSet"
---

# POST /StartChangeSet

`POST /StartChangeSet`

Allows you to request changes for your entities. Within a single `ChangeSet`, you can't start the same change type against the same entity multiple times. Additionally, when a `ChangeSet` is running, all the entities targeted by the different changes are locked until the change set has completed (either succeeded, cancelled, or failed). If you try to start a change set containing a change against an entity that is already locked, you will receive a `ResourceInUseException` error.

For example, you can't start the `ChangeSet` described in the [example](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_StartChangeSet.html#API_StartChangeSet_Examples) later in this topic because it contains two changes to run the same change type (`AddRevisions`) against the same entity (`entity-id@1`).

For more information about working with change sets, see [Working with change sets](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets). For information on change types for single-AMI products, see [Working with single-AMI products](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/ami-products.html#working-with-single-AMI-products). Als, for more information on change types available for container-based products, see [Working with container products](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/container-products.html#working-with-container-products).

## Request body

- object
  - `Catalog` string, required — The catalog related to the request. Fixed value: <code>AWSMarketplace</code>
  - `ChangeSet` Change[], required — Array of <code>change</code> object.
    - `ChangeType` string, required — Change types are single string values that describe your intention for the change. Each change type is unique for each <code>EntityType</code> provided in the change's scope. For more information on change types available for single-AMI products, see <a href="https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/ami-products.html#working-with-single-AMI-products">Working with single-AMI products</a>. Also, for more information on change types available for container-based products, see <a href="https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/container-products.html#working-with-container-products">Working with container products</a>.
    - `Entity` object, required — The entity to be changed.
      - `Type` string, required — The type of entity.
      - `Identifier` string — The identifier for the entity.
    - `EntityTags` Tag[] — The tags associated with the change.
      - `Key` string, required — The key associated with the tag.
      - `Value` string, required — The value associated with the tag.
    - `Details` string, required — This object contains details specific to the change type of the requested change. For more information on change types available for single-AMI products, see <a href="https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/ami-products.html#working-with-single-AMI-products">Working with single-AMI products</a>. Also, for more information on change types available for container-based products, see <a href="https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/container-products.html#working-with-container-products">Working with container products</a>.
    - `ChangeName` string — Optional name for the change.
  - `ChangeSetName` string — Optional case sensitive string of up to 100 ASCII characters. The change set name can be used to filter the list of change sets.
  - `ClientRequestToken` string — A unique token to identify the request to ensure idempotency.
  - `ChangeSetTags` Tag[] — A list of objects specifying each key name and value for the <code>ChangeSetTags</code> property.
    - `Key` string, required — The key associated with the tag.
    - `Value` string, required — The value associated with the tag.

## Response `200`

Success

- StartChangeSetResponse
  - `ChangeSetId` string — Unique identifier generated for the request.
  - `ChangeSetArn` string — The ARN associated to the unique identifier generated for the request.

## Other responses

- `480` — InternalServiceException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — ResourceNotFoundException
- `484` — ResourceInUseException
- `485` — ThrottlingException
- `486` — ServiceQuotaExceededException

---

[API](https://skmtc.net/aws/apis/marketplace-catalog.md) · [All operations](https://skmtc.net/aws/apis/marketplace-catalog/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/marketplace-catalog/versions/a0c0fe36f775/schema)