@Generated(value="software.amazon.awssdk:codegen") @ThreadSafe public interface MarketplaceCatalogClient extends AwsClient
builder() method.
Catalog API actions allow you to manage your entities through list, describe, and update capabilities. An entity can be a product or an offer on AWS Marketplace.
You can automate your entity update process by integrating the AWS Marketplace Catalog API with your AWS Marketplace product build or deployment pipelines. You can also create your own applications on top of the Catalog API to manage your products on AWS Marketplace.
| Modifier and Type | Field and Description |
|---|---|
static String |
SERVICE_METADATA_ID
Value for looking up the service's metadata from the
ServiceMetadataProvider. |
static String |
SERVICE_NAME |
| Modifier and Type | Method and Description |
|---|---|
static MarketplaceCatalogClientBuilder |
builder()
Create a builder that can be used to configure and create a
MarketplaceCatalogClient. |
default CancelChangeSetResponse |
cancelChangeSet(CancelChangeSetRequest cancelChangeSetRequest)
Used to cancel an open change request.
|
default CancelChangeSetResponse |
cancelChangeSet(Consumer<CancelChangeSetRequest.Builder> cancelChangeSetRequest)
Used to cancel an open change request.
|
static MarketplaceCatalogClient |
create()
Create a
MarketplaceCatalogClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider. |
default DeleteResourcePolicyResponse |
deleteResourcePolicy(Consumer<DeleteResourcePolicyRequest.Builder> deleteResourcePolicyRequest)
Deletes a resource-based policy on an Entity that is identified by its resource ARN.
|
default DeleteResourcePolicyResponse |
deleteResourcePolicy(DeleteResourcePolicyRequest deleteResourcePolicyRequest)
Deletes a resource-based policy on an Entity that is identified by its resource ARN.
|
default DescribeChangeSetResponse |
describeChangeSet(Consumer<DescribeChangeSetRequest.Builder> describeChangeSetRequest)
Provides information about a given change set.
|
default DescribeChangeSetResponse |
describeChangeSet(DescribeChangeSetRequest describeChangeSetRequest)
Provides information about a given change set.
|
default DescribeEntityResponse |
describeEntity(Consumer<DescribeEntityRequest.Builder> describeEntityRequest)
Returns the metadata and content of the entity.
|
default DescribeEntityResponse |
describeEntity(DescribeEntityRequest describeEntityRequest)
Returns the metadata and content of the entity.
|
default GetResourcePolicyResponse |
getResourcePolicy(Consumer<GetResourcePolicyRequest.Builder> getResourcePolicyRequest)
Gets a resource-based policy of an Entity that is identified by its resource ARN.
|
default GetResourcePolicyResponse |
getResourcePolicy(GetResourcePolicyRequest getResourcePolicyRequest)
Gets a resource-based policy of an Entity that is identified by its resource ARN.
|
default ListChangeSetsResponse |
listChangeSets(Consumer<ListChangeSetsRequest.Builder> listChangeSetsRequest)
Returns the list of change sets owned by the account being used to make the call.
|
default ListChangeSetsResponse |
listChangeSets(ListChangeSetsRequest listChangeSetsRequest)
Returns the list of change sets owned by the account being used to make the call.
|
default ListChangeSetsIterable |
listChangeSetsPaginator(Consumer<ListChangeSetsRequest.Builder> listChangeSetsRequest)
Returns the list of change sets owned by the account being used to make the call.
|
default ListChangeSetsIterable |
listChangeSetsPaginator(ListChangeSetsRequest listChangeSetsRequest)
Returns the list of change sets owned by the account being used to make the call.
|
default ListEntitiesResponse |
listEntities(Consumer<ListEntitiesRequest.Builder> listEntitiesRequest)
Provides the list of entities of a given type.
|
default ListEntitiesResponse |
listEntities(ListEntitiesRequest listEntitiesRequest)
Provides the list of entities of a given type.
|
default ListEntitiesIterable |
listEntitiesPaginator(Consumer<ListEntitiesRequest.Builder> listEntitiesRequest)
Provides the list of entities of a given type.
|
default ListEntitiesIterable |
listEntitiesPaginator(ListEntitiesRequest listEntitiesRequest)
Provides the list of entities of a given type.
|
default ListTagsForResourceResponse |
listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)
Lists all tags that have been added to a resource (either an entity or change set).
|
default ListTagsForResourceResponse |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists all tags that have been added to a resource (either an entity or change set).
|
default PutResourcePolicyResponse |
putResourcePolicy(Consumer<PutResourcePolicyRequest.Builder> putResourcePolicyRequest)
Attaches a resource-based policy to an Entity.
|
default PutResourcePolicyResponse |
putResourcePolicy(PutResourcePolicyRequest putResourcePolicyRequest)
Attaches a resource-based policy to an Entity.
|
default MarketplaceCatalogServiceClientConfiguration |
serviceClientConfiguration() |
static ServiceMetadata |
serviceMetadata() |
default StartChangeSetResponse |
startChangeSet(Consumer<StartChangeSetRequest.Builder> startChangeSetRequest)
Allows you to request changes for your entities.
|
default StartChangeSetResponse |
startChangeSet(StartChangeSetRequest startChangeSetRequest)
Allows you to request changes for your entities.
|
default TagResourceResponse |
tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)
Tags a resource (either an entity or change set).
|
default TagResourceResponse |
tagResource(TagResourceRequest tagResourceRequest)
Tags a resource (either an entity or change set).
|
default UntagResourceResponse |
untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)
Removes a tag or list of tags from a resource (either an entity or change set).
|
default UntagResourceResponse |
untagResource(UntagResourceRequest untagResourceRequest)
Removes a tag or list of tags from a resource (either an entity or change set).
|
serviceNameclosestatic final String SERVICE_NAME
static final String SERVICE_METADATA_ID
ServiceMetadataProvider.default CancelChangeSetResponse cancelChangeSet(CancelChangeSetRequest cancelChangeSetRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ResourceInUseException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Used to cancel an open change request. Must be sent before the status of the request changes to
APPLYING, the final stage of completing your change request. You can describe a change during the
60-day request history retention period for API calls.
cancelChangeSetRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ResourceInUseException - The resource is currently in use.ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault CancelChangeSetResponse cancelChangeSet(Consumer<CancelChangeSetRequest.Builder> cancelChangeSetRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ResourceInUseException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Used to cancel an open change request. Must be sent before the status of the request changes to
APPLYING, the final stage of completing your change request. You can describe a change during the
60-day request history retention period for API calls.
This is a convenience which creates an instance of the CancelChangeSetRequest.Builder avoiding the need
to create one manually via CancelChangeSetRequest.builder()
cancelChangeSetRequest - A Consumer that will call methods on CancelChangeSetRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ResourceInUseException - The resource is currently in use.ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DeleteResourcePolicyResponse deleteResourcePolicy(DeleteResourcePolicyRequest deleteResourcePolicyRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Deletes a resource-based policy on an Entity that is identified by its resource ARN.
deleteResourcePolicyRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DeleteResourcePolicyResponse deleteResourcePolicy(Consumer<DeleteResourcePolicyRequest.Builder> deleteResourcePolicyRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Deletes a resource-based policy on an Entity that is identified by its resource ARN.
This is a convenience which creates an instance of the DeleteResourcePolicyRequest.Builder avoiding the
need to create one manually via DeleteResourcePolicyRequest.builder()
deleteResourcePolicyRequest - A Consumer that will call methods on DeleteResourcePolicyRequest.Builder to create a
request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeChangeSetResponse describeChangeSet(DescribeChangeSetRequest describeChangeSetRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Provides information about a given change set.
describeChangeSetRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeChangeSetResponse describeChangeSet(Consumer<DescribeChangeSetRequest.Builder> describeChangeSetRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Provides information about a given change set.
This is a convenience which creates an instance of the DescribeChangeSetRequest.Builder avoiding the need
to create one manually via DescribeChangeSetRequest.builder()
describeChangeSetRequest - A Consumer that will call methods on DescribeChangeSetRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEntityResponse describeEntity(DescribeEntityRequest describeEntityRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotSupportedException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Returns the metadata and content of the entity.
describeEntityRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotSupportedException - Currently, the specified resource is not supported.ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEntityResponse describeEntity(Consumer<DescribeEntityRequest.Builder> describeEntityRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotSupportedException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Returns the metadata and content of the entity.
This is a convenience which creates an instance of the DescribeEntityRequest.Builder avoiding the need to
create one manually via DescribeEntityRequest.builder()
describeEntityRequest - A Consumer that will call methods on DescribeEntityRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotSupportedException - Currently, the specified resource is not supported.ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetResourcePolicyResponse getResourcePolicy(GetResourcePolicyRequest getResourcePolicyRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Gets a resource-based policy of an Entity that is identified by its resource ARN.
getResourcePolicyRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetResourcePolicyResponse getResourcePolicy(Consumer<GetResourcePolicyRequest.Builder> getResourcePolicyRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Gets a resource-based policy of an Entity that is identified by its resource ARN.
This is a convenience which creates an instance of the GetResourcePolicyRequest.Builder avoiding the need
to create one manually via GetResourcePolicyRequest.builder()
getResourcePolicyRequest - A Consumer that will call methods on GetResourcePolicyRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListChangeSetsResponse listChangeSets(ListChangeSetsRequest listChangeSetsRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
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.
listChangeSetsRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListChangeSetsResponse listChangeSets(Consumer<ListChangeSetsRequest.Builder> listChangeSetsRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
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.
This is a convenience which creates an instance of the ListChangeSetsRequest.Builder avoiding the need to
create one manually via ListChangeSetsRequest.builder()
listChangeSetsRequest - A Consumer that will call methods on ListChangeSetsRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListChangeSetsIterable listChangeSetsPaginator(ListChangeSetsRequest listChangeSetsRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
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.
This is a variant of
listChangeSets(software.amazon.awssdk.services.marketplacecatalog.model.ListChangeSetsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.marketplacecatalog.paginators.ListChangeSetsIterable responses = client.listChangeSetsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.marketplacecatalog.paginators.ListChangeSetsIterable responses = client
.listChangeSetsPaginator(request);
for (software.amazon.awssdk.services.marketplacecatalog.model.ListChangeSetsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.marketplacecatalog.paginators.ListChangeSetsIterable responses = client.listChangeSetsPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listChangeSets(software.amazon.awssdk.services.marketplacecatalog.model.ListChangeSetsRequest)
operation.
listChangeSetsRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListChangeSetsIterable listChangeSetsPaginator(Consumer<ListChangeSetsRequest.Builder> listChangeSetsRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
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.
This is a variant of
listChangeSets(software.amazon.awssdk.services.marketplacecatalog.model.ListChangeSetsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.marketplacecatalog.paginators.ListChangeSetsIterable responses = client.listChangeSetsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.marketplacecatalog.paginators.ListChangeSetsIterable responses = client
.listChangeSetsPaginator(request);
for (software.amazon.awssdk.services.marketplacecatalog.model.ListChangeSetsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.marketplacecatalog.paginators.ListChangeSetsIterable responses = client.listChangeSetsPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listChangeSets(software.amazon.awssdk.services.marketplacecatalog.model.ListChangeSetsRequest)
operation.
This is a convenience which creates an instance of the ListChangeSetsRequest.Builder avoiding the need to
create one manually via ListChangeSetsRequest.builder()
listChangeSetsRequest - A Consumer that will call methods on ListChangeSetsRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListEntitiesResponse listEntities(ListEntitiesRequest listEntitiesRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Provides the list of entities of a given type.
listEntitiesRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListEntitiesResponse listEntities(Consumer<ListEntitiesRequest.Builder> listEntitiesRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Provides the list of entities of a given type.
This is a convenience which creates an instance of the ListEntitiesRequest.Builder avoiding the need to
create one manually via ListEntitiesRequest.builder()
listEntitiesRequest - A Consumer that will call methods on ListEntitiesRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListEntitiesIterable listEntitiesPaginator(ListEntitiesRequest listEntitiesRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Provides the list of entities of a given type.
This is a variant of
listEntities(software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest) operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.marketplacecatalog.paginators.ListEntitiesIterable responses = client.listEntitiesPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.marketplacecatalog.paginators.ListEntitiesIterable responses = client
.listEntitiesPaginator(request);
for (software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.marketplacecatalog.paginators.ListEntitiesIterable responses = client.listEntitiesPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listEntities(software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest)
operation.
listEntitiesRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListEntitiesIterable listEntitiesPaginator(Consumer<ListEntitiesRequest.Builder> listEntitiesRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Provides the list of entities of a given type.
This is a variant of
listEntities(software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest) operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.marketplacecatalog.paginators.ListEntitiesIterable responses = client.listEntitiesPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.marketplacecatalog.paginators.ListEntitiesIterable responses = client
.listEntitiesPaginator(request);
for (software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.marketplacecatalog.paginators.ListEntitiesIterable responses = client.listEntitiesPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listEntities(software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest)
operation.
This is a convenience which creates an instance of the ListEntitiesRequest.Builder avoiding the need to
create one manually via ListEntitiesRequest.builder()
listEntitiesRequest - A Consumer that will call methods on ListEntitiesRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws ResourceNotFoundException, InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Lists all tags that have been added to a resource (either an entity or change set).
listTagsForResourceRequest - ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws ResourceNotFoundException, InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Lists all tags that have been added to a resource (either an entity or change set).
This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder avoiding the
need to create one manually via ListTagsForResourceRequest.builder()
listTagsForResourceRequest - A Consumer that will call methods on ListTagsForResourceRequest.Builder to create a
request.ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault PutResourcePolicyResponse putResourcePolicy(PutResourcePolicyRequest putResourcePolicyRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Attaches a resource-based policy to an Entity. Examples of an entity include: AmiProduct and
ContainerProduct.
putResourcePolicyRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault PutResourcePolicyResponse putResourcePolicy(Consumer<PutResourcePolicyRequest.Builder> putResourcePolicyRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Attaches a resource-based policy to an Entity. Examples of an entity include: AmiProduct and
ContainerProduct.
This is a convenience which creates an instance of the PutResourcePolicyRequest.Builder avoiding the need
to create one manually via PutResourcePolicyRequest.builder()
putResourcePolicyRequest - A Consumer that will call methods on PutResourcePolicyRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault StartChangeSetResponse startChangeSet(StartChangeSetRequest startChangeSetRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ResourceInUseException, ThrottlingException, ServiceQuotaExceededException, AwsServiceException, SdkClientException, MarketplaceCatalogException
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 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. For information on change types for single-AMI products, see Working with single-AMI products. Als, for more information on change types available for container-based products, see Working with container products.
startChangeSetRequest - InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ResourceInUseException - The resource is currently in use.ThrottlingException - Too many requests.
HTTP status code: 429
ServiceQuotaExceededException - The maximum number of open requests per account has been exceeded.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault StartChangeSetResponse startChangeSet(Consumer<StartChangeSetRequest.Builder> startChangeSetRequest) throws InternalServiceException, AccessDeniedException, ValidationException, ResourceNotFoundException, ResourceInUseException, ThrottlingException, ServiceQuotaExceededException, AwsServiceException, SdkClientException, MarketplaceCatalogException
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 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. For information on change types for single-AMI products, see Working with single-AMI products. Als, for more information on change types available for container-based products, see Working with container products.
This is a convenience which creates an instance of the StartChangeSetRequest.Builder avoiding the need to
create one manually via StartChangeSetRequest.builder()
startChangeSetRequest - A Consumer that will call methods on StartChangeSetRequest.Builder to create a request.InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
ResourceInUseException - The resource is currently in use.ThrottlingException - Too many requests.
HTTP status code: 429
ServiceQuotaExceededException - The maximum number of open requests per account has been exceeded.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ResourceNotFoundException, InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Tags a resource (either an entity or change set).
tagResourceRequest - ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws ResourceNotFoundException, InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Tags a resource (either an entity or change set).
This is a convenience which creates an instance of the TagResourceRequest.Builder avoiding the need to
create one manually via TagResourceRequest.builder()
tagResourceRequest - A Consumer that will call methods on TagResourceRequest.Builder to create a request.ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ResourceNotFoundException, InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Removes a tag or list of tags from a resource (either an entity or change set).
untagResourceRequest - ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws ResourceNotFoundException, InternalServiceException, AccessDeniedException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException, MarketplaceCatalogException
Removes a tag or list of tags from a resource (either an entity or change set).
This is a convenience which creates an instance of the UntagResourceRequest.Builder avoiding the need to
create one manually via UntagResourceRequest.builder()
untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request.ResourceNotFoundException - The specified resource wasn't found.
HTTP status code: 404
InternalServiceException - There was an internal service exception.
HTTP status code: 500
AccessDeniedException - Access is denied.
HTTP status code: 403
ValidationException - An error occurred during validation.
HTTP status code: 422
ThrottlingException - Too many requests.
HTTP status code: 429
SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.MarketplaceCatalogException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptionstatic MarketplaceCatalogClient create()
MarketplaceCatalogClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider.static MarketplaceCatalogClientBuilder builder()
MarketplaceCatalogClient.static ServiceMetadata serviceMetadata()
default MarketplaceCatalogServiceClientConfiguration serviceClientConfiguration()
serviceClientConfiguration in interface AwsClientserviceClientConfiguration in interface SdkClientCopyright © 2023. All rights reserved.