[ aws . marketplace-catalog ]
Returns the list of change sets owned by the account being used to make the call. You can filter this list by providing any combination of entityId
, ChangeSetName
, and status. If you provide more than one filter, the API operation applies a logical AND between the filters.
You can describe a change during the 60-day request history retention period for API calls.
See also: AWS API Documentation
See ‘aws help’ for descriptions of global parameters.
list-change-sets
--catalog <value>
[--filter-list <value>]
[--sort <value>]
[--max-results <value>]
[--next-token <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
--catalog
(string)
The catalog related to the request. Fixed value:
AWSMarketplace
--filter-list
(list)
An array of filter objects.
(structure)
A filter object, used to optionally filter results from calls to the
ListEntities
andListChangeSets
actions.Name -> (string)
For
ListEntities
, the supported value for this is anEntityId
.For
ListChangeSets
, the supported values are as follows:ValueList -> (list)
ListEntities
- This is a list of uniqueEntityId
s.
ListChangeSets
- The supported filter names and associatedValueList
s is as follows:
ChangeSetName
- The supportedValueList
is a list of non-uniqueChangeSetName
s. These are defined when you call theStartChangeSet
action.
Status
- The supportedValueList
is a list of statuses for all change set requests.
EntityId
- The supportedValueList
is a list of uniqueEntityId
s.
BeforeStartTime
- The supportedValueList
is a list of all change sets that started before the filter value.
AfterStartTime
- The supportedValueList
is a list of all change sets that started after the filter value.
BeforeEndTime
- The supportedValueList
is a list of all change sets that ended before the filter value.
AfterEndTime
- The supportedValueList
is a list of all change sets that ended after the filter value.(string)
Shorthand Syntax:
Name=string,ValueList=string,string ...
JSON Syntax:
[
{
"Name": "string",
"ValueList": ["string", ...]
}
...
]
--sort
(structure)
An object that contains two attributes,
SortBy
andSortOrder
.SortBy -> (string)
For
ListEntities
, supported attributes includeLastModifiedDate
(default),Visibility
,EntityId
, andName
.For
ListChangeSets
, supported attributes includeStartTime
andEndTime
.SortOrder -> (string)
The sorting order. Can be
ASCENDING
orDESCENDING
. The default value isDESCENDING
.
Shorthand Syntax:
SortBy=string,SortOrder=string
JSON Syntax:
{
"SortBy": "string",
"SortOrder": "ASCENDING"|"DESCENDING"
}
--max-results
(integer)
The maximum number of results returned by a single call. This value must be provided in the next call to retrieve the next set of results. By default, this value is 20.
--next-token
(string)
The token value retrieved from a previous call to access the next page of results.
--cli-input-json
| --cli-input-yaml
(string)
Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton
. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml
.
--generate-cli-skeleton
(string)
Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input
, prints a sample input JSON that can be used as an argument for --cli-input-json
. Similarly, if provided yaml-input
it will print a sample input YAML that can be used with --cli-input-yaml
. If provided with the value output
, it validates the command inputs and returns a sample output JSON for that command.
See ‘aws help’ for descriptions of global parameters.
ChangeSetSummaryList -> (list)
Array of
ChangeSetSummaryListItem
objects.(structure)
A summary of a change set returned in a list of change sets when the
ListChangeSets
action is called.ChangeSetId -> (string)
The unique identifier for a change set.
ChangeSetArn -> (string)
The ARN associated with the unique identifier for the change set referenced in this request.
ChangeSetName -> (string)
The non-unique name for the change set.
StartTime -> (string)
The time, in ISO 8601 format (2018-02-27T13:45:22Z), when the change set was started.
EndTime -> (string)
The time, in ISO 8601 format (2018-02-27T13:45:22Z), when the change set was finished.
Status -> (string)
The current status of the change set.
EntityIdList -> (list)
This object is a list of entity IDs (string) that are a part of a change set. The entity ID list is a maximum of 20 entities. It must contain at least one entity.
(string)
FailureCode -> (string)
Returned if the change set is in
FAILED
status. Can be eitherCLIENT_ERROR
, which means that there are issues with the request (see theErrorDetailList
ofDescribeChangeSet
), orSERVER_FAULT
, which means that there is a problem in the system, and you should retry your request.
NextToken -> (string)
The value of the next token, if it exists. Null if there are no more results.