amazonka-marketplace-catalog-2.0: Amazon Marketplace Catalog Service SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.MarketplaceCatalog.Lens

Description

 
Synopsis

Operations

CancelChangeSet

cancelChangeSet_catalog :: Lens' CancelChangeSet Text Source #

Required. The catalog related to the request. Fixed value: AWSMarketplace.

cancelChangeSet_changeSetId :: Lens' CancelChangeSet Text Source #

Required. The unique identifier of the StartChangeSet request that you want to cancel.

cancelChangeSetResponse_changeSetArn :: Lens' CancelChangeSetResponse (Maybe Text) Source #

The ARN associated with the change set referenced in this request.

cancelChangeSetResponse_changeSetId :: Lens' CancelChangeSetResponse (Maybe Text) Source #

The unique identifier for the change set referenced in this request.

cancelChangeSetResponse_httpStatus :: Lens' CancelChangeSetResponse Int Source #

The response's http status code.

DescribeChangeSet

describeChangeSet_catalog :: Lens' DescribeChangeSet Text Source #

Required. The catalog related to the request. Fixed value: AWSMarketplace

describeChangeSet_changeSetId :: Lens' DescribeChangeSet Text Source #

Required. The unique identifier for the StartChangeSet request that you want to describe the details for.

describeChangeSetResponse_changeSet :: Lens' DescribeChangeSetResponse (Maybe [ChangeSummary]) Source #

An array of ChangeSummary objects.

describeChangeSetResponse_changeSetArn :: Lens' DescribeChangeSetResponse (Maybe Text) Source #

The ARN associated with the unique identifier for the change set referenced in this request.

describeChangeSetResponse_changeSetId :: Lens' DescribeChangeSetResponse (Maybe Text) Source #

Required. The unique identifier for the change set referenced in this request.

describeChangeSetResponse_changeSetName :: Lens' DescribeChangeSetResponse (Maybe Text) Source #

The optional name provided in the StartChangeSet request. If you do not provide a name, one is set by default.

describeChangeSetResponse_endTime :: Lens' DescribeChangeSetResponse (Maybe Text) Source #

The date and time, in ISO 8601 format (2018-02-27T13:45:22Z), the request transitioned to a terminal state. The change cannot transition to a different state. Null if the request is not in a terminal state.

describeChangeSetResponse_failureCode :: Lens' DescribeChangeSetResponse (Maybe FailureCode) Source #

Returned if the change set is in FAILED status. Can be either CLIENT_ERROR, which means that there are issues with the request (see the ErrorDetailList), or SERVER_FAULT, which means that there is a problem in the system, and you should retry your request.

describeChangeSetResponse_failureDescription :: Lens' DescribeChangeSetResponse (Maybe Text) Source #

Returned if there is a failure on the change set, but that failure is not related to any of the changes in the request.

describeChangeSetResponse_startTime :: Lens' DescribeChangeSetResponse (Maybe Text) Source #

The date and time, in ISO 8601 format (2018-02-27T13:45:22Z), the request started.

describeChangeSetResponse_status :: Lens' DescribeChangeSetResponse (Maybe ChangeStatus) Source #

The status of the change request.

describeChangeSetResponse_httpStatus :: Lens' DescribeChangeSetResponse Int Source #

The response's http status code.

DescribeEntity

describeEntity_catalog :: Lens' DescribeEntity Text Source #

Required. The catalog related to the request. Fixed value: AWSMarketplace

describeEntity_entityId :: Lens' DescribeEntity Text Source #

Required. The unique ID of the entity to describe.

describeEntityResponse_details :: Lens' DescribeEntityResponse (Maybe Text) Source #

This stringified JSON object includes the details of the entity.

describeEntityResponse_entityArn :: Lens' DescribeEntityResponse (Maybe Text) Source #

The ARN associated to the unique identifier for the entity referenced in this request.

describeEntityResponse_entityIdentifier :: Lens' DescribeEntityResponse (Maybe Text) Source #

The identifier of the entity, in the format of EntityId@RevisionId.

describeEntityResponse_entityType :: Lens' DescribeEntityResponse (Maybe Text) Source #

The named type of the entity, in the format of EntityType@Version.

describeEntityResponse_lastModifiedDate :: Lens' DescribeEntityResponse (Maybe Text) Source #

The last modified date of the entity, in ISO 8601 format (2018-02-27T13:45:22Z).

describeEntityResponse_httpStatus :: Lens' DescribeEntityResponse Int Source #

The response's http status code.

ListChangeSets

listChangeSets_filterList :: Lens' ListChangeSets (Maybe (NonEmpty Filter)) Source #

An array of filter objects.

listChangeSets_maxResults :: Lens' ListChangeSets (Maybe Natural) Source #

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.

listChangeSets_nextToken :: Lens' ListChangeSets (Maybe Text) Source #

The token value retrieved from a previous call to access the next page of results.

listChangeSets_sort :: Lens' ListChangeSets (Maybe Sort) Source #

An object that contains two attributes, SortBy and SortOrder.

listChangeSets_catalog :: Lens' ListChangeSets Text Source #

The catalog related to the request. Fixed value: AWSMarketplace

listChangeSetsResponse_changeSetSummaryList :: Lens' ListChangeSetsResponse (Maybe [ChangeSetSummaryListItem]) Source #

Array of ChangeSetSummaryListItem objects.

listChangeSetsResponse_nextToken :: Lens' ListChangeSetsResponse (Maybe Text) Source #

The value of the next token, if it exists. Null if there are no more results.

listChangeSetsResponse_httpStatus :: Lens' ListChangeSetsResponse Int Source #

The response's http status code.

ListEntities

listEntities_filterList :: Lens' ListEntities (Maybe (NonEmpty Filter)) Source #

An array of filter objects. Each filter object contains two attributes, filterName and filterValues.

listEntities_maxResults :: Lens' ListEntities (Maybe Natural) Source #

Specifies the upper limit of the elements on a single page. If a value isn't provided, the default value is 20.

listEntities_nextToken :: Lens' ListEntities (Maybe Text) Source #

The value of the next token, if it exists. Null if there are no more results.

listEntities_sort :: Lens' ListEntities (Maybe Sort) Source #

An object that contains two attributes, SortBy and SortOrder.

listEntities_catalog :: Lens' ListEntities Text Source #

The catalog related to the request. Fixed value: AWSMarketplace

listEntities_entityType :: Lens' ListEntities Text Source #

The type of entities to retrieve.

listEntitiesResponse_entitySummaryList :: Lens' ListEntitiesResponse (Maybe [EntitySummary]) Source #

Array of EntitySummary object.

listEntitiesResponse_nextToken :: Lens' ListEntitiesResponse (Maybe Text) Source #

The value of the next token if it exists. Null if there is no more result.

listEntitiesResponse_httpStatus :: Lens' ListEntitiesResponse Int Source #

The response's http status code.

ListTagsForResource

listTagsForResource_resourceArn :: Lens' ListTagsForResource Text Source #

Required. The Amazon Resource Name (ARN) associated with the resource you want to list tags on.

listTagsForResourceResponse_resourceArn :: Lens' ListTagsForResourceResponse (Maybe Text) Source #

Required. The ARN associated with the resource you want to list tags on.

listTagsForResourceResponse_tags :: Lens' ListTagsForResourceResponse (Maybe (NonEmpty Tag)) Source #

Required. A list of objects specifying each key name and value. Number of objects allowed: 1-50.

listTagsForResourceResponse_httpStatus :: Lens' ListTagsForResourceResponse Int Source #

The response's http status code.

StartChangeSet

startChangeSet_changeSetName :: Lens' StartChangeSet (Maybe Text) Source #

Optional case sensitive string of up to 100 ASCII characters. The change set name can be used to filter the list of change sets.

startChangeSet_changeSetTags :: Lens' StartChangeSet (Maybe (NonEmpty Tag)) Source #

A list of objects specifying each key name and value for the ChangeSetTags property.

startChangeSet_clientRequestToken :: Lens' StartChangeSet (Maybe Text) Source #

A unique token to identify the request to ensure idempotency.

startChangeSet_catalog :: Lens' StartChangeSet Text Source #

The catalog related to the request. Fixed value: AWSMarketplace

startChangeSet_changeSet :: Lens' StartChangeSet (NonEmpty Change) Source #

Array of change object.

startChangeSetResponse_changeSetArn :: Lens' StartChangeSetResponse (Maybe Text) Source #

The ARN associated to the unique identifier generated for the request.

startChangeSetResponse_changeSetId :: Lens' StartChangeSetResponse (Maybe Text) Source #

Unique identifier generated for the request.

startChangeSetResponse_httpStatus :: Lens' StartChangeSetResponse Int Source #

The response's http status code.

TagResource

tagResource_resourceArn :: Lens' TagResource Text Source #

Required. The Amazon Resource Name (ARN) associated with the resource you want to tag.

tagResource_tags :: Lens' TagResource (NonEmpty Tag) Source #

Required. A list of objects specifying each key name and value. Number of objects allowed: 1-50.

tagResourceResponse_httpStatus :: Lens' TagResourceResponse Int Source #

The response's http status code.

UntagResource

untagResource_resourceArn :: Lens' UntagResource Text Source #

Required. The Amazon Resource Name (ARN) associated with the resource you want to remove the tag from.

untagResource_tagKeys :: Lens' UntagResource (NonEmpty Text) Source #

Required. A list of key names of tags to be removed. Number of strings allowed: 0-256.

untagResourceResponse_httpStatus :: Lens' UntagResourceResponse Int Source #

The response's http status code.

Types

Change

change_changeName :: Lens' Change (Maybe Text) Source #

Optional name for the change.

change_entityTags :: Lens' Change (Maybe (NonEmpty Tag)) Source #

The tags associated with the change.

change_changeType :: Lens' Change Text Source #

Change types are single string values that describe your intention for the change. Each change type is unique for each EntityType provided in the change's scope.

change_entity :: Lens' Change Entity Source #

The entity to be changed.

change_details :: Lens' Change Text Source #

This object contains details specific to the change type of the requested change.

ChangeSetSummaryListItem

changeSetSummaryListItem_changeSetArn :: Lens' ChangeSetSummaryListItem (Maybe Text) Source #

The ARN associated with the unique identifier for the change set referenced in this request.

changeSetSummaryListItem_changeSetId :: Lens' ChangeSetSummaryListItem (Maybe Text) Source #

The unique identifier for a change set.

changeSetSummaryListItem_changeSetName :: Lens' ChangeSetSummaryListItem (Maybe Text) Source #

The non-unique name for the change set.

changeSetSummaryListItem_endTime :: Lens' ChangeSetSummaryListItem (Maybe Text) Source #

The time, in ISO 8601 format (2018-02-27T13:45:22Z), when the change set was finished.

changeSetSummaryListItem_entityIdList :: Lens' ChangeSetSummaryListItem (Maybe [Text]) Source #

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.

changeSetSummaryListItem_failureCode :: Lens' ChangeSetSummaryListItem (Maybe FailureCode) Source #

Returned if the change set is in FAILED status. Can be either CLIENT_ERROR, which means that there are issues with the request (see the ErrorDetailList of DescribeChangeSet), or SERVER_FAULT, which means that there is a problem in the system, and you should retry your request.

changeSetSummaryListItem_startTime :: Lens' ChangeSetSummaryListItem (Maybe Text) Source #

The time, in ISO 8601 format (2018-02-27T13:45:22Z), when the change set was started.

changeSetSummaryListItem_status :: Lens' ChangeSetSummaryListItem (Maybe ChangeStatus) Source #

The current status of the change set.

ChangeSummary

changeSummary_changeName :: Lens' ChangeSummary (Maybe Text) Source #

Optional name for the change.

changeSummary_changeType :: Lens' ChangeSummary (Maybe Text) Source #

The type of the change.

changeSummary_details :: Lens' ChangeSummary (Maybe Text) Source #

This object contains details specific to the change type of the requested change.

changeSummary_entity :: Lens' ChangeSummary (Maybe Entity) Source #

The entity to be changed.

changeSummary_errorDetailList :: Lens' ChangeSummary (Maybe [ErrorDetail]) Source #

An array of ErrorDetail objects associated with the change.

Entity

entity_identifier :: Lens' Entity (Maybe Text) Source #

The identifier for the entity.

entity_type :: Lens' Entity Text Source #

The type of entity.

EntitySummary

entitySummary_entityArn :: Lens' EntitySummary (Maybe Text) Source #

The ARN associated with the unique identifier for the entity.

entitySummary_entityId :: Lens' EntitySummary (Maybe Text) Source #

The unique identifier for the entity.

entitySummary_entityType :: Lens' EntitySummary (Maybe Text) Source #

The type of the entity.

entitySummary_lastModifiedDate :: Lens' EntitySummary (Maybe Text) Source #

The last time the entity was published, using ISO 8601 format (2018-02-27T13:45:22Z).

entitySummary_name :: Lens' EntitySummary (Maybe Text) Source #

The name for the entity. This value is not unique. It is defined by the seller.

entitySummary_visibility :: Lens' EntitySummary (Maybe Text) Source #

The visibility status of the entity to buyers. This value can be Public (everyone can view the entity), Limited (the entity is visible to limited accounts only), or Restricted (the entity was published and then unpublished and only existing buyers can view it).

ErrorDetail

errorDetail_errorCode :: Lens' ErrorDetail (Maybe Text) Source #

The error code that identifies the type of error.

errorDetail_errorMessage :: Lens' ErrorDetail (Maybe Text) Source #

The message for the error.

Filter

filter_name :: Lens' Filter (Maybe Text) Source #

For ListEntities, the supported value for this is an EntityId.

For ListChangeSets, the supported values are as follows:

filter_valueList :: Lens' Filter (Maybe (NonEmpty Text)) Source #

ListEntities - This is a list of unique EntityIds.

ListChangeSets - The supported filter names and associated ValueLists is as follows:

  • ChangeSetName - The supported ValueList is a list of non-unique ChangeSetNames. These are defined when you call the StartChangeSet action.
  • Status - The supported ValueList is a list of statuses for all change set requests.
  • EntityId - The supported ValueList is a list of unique EntityIds.
  • BeforeStartTime - The supported ValueList is a list of all change sets that started before the filter value.
  • AfterStartTime - The supported ValueList is a list of all change sets that started after the filter value.
  • BeforeEndTime - The supported ValueList is a list of all change sets that ended before the filter value.
  • AfterEndTime - The supported ValueList is a list of all change sets that ended after the filter value.

Sort

sort_sortBy :: Lens' Sort (Maybe Text) Source #

For ListEntities, supported attributes include LastModifiedDate (default), Visibility, EntityId, and Name.

For ListChangeSets, supported attributes include StartTime and EndTime.

sort_sortOrder :: Lens' Sort (Maybe SortOrder) Source #

The sorting order. Can be ASCENDING or DESCENDING. The default value is DESCENDING.

Tag

tag_key :: Lens' Tag Text Source #

The key associated with the tag.

tag_value :: Lens' Tag Text Source #

The value associated with the tag.