Interface PcaConnectorScepClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder()
method.
Connector for SCEP creates a connector between Amazon Web Services Private CA and your SCEP-enabled clients and devices. For more information, see Connector for SCEP in the Amazon Web Services Private CA User Guide.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionbuilder()Create a builder that can be used to configure and create aPcaConnectorScepClient.static PcaConnectorScepClientcreate()Create aPcaConnectorScepClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CreateChallengeResponsecreateChallenge(Consumer<CreateChallengeRequest.Builder> createChallengeRequest) For general-purpose connectors.default CreateChallengeResponsecreateChallenge(CreateChallengeRequest createChallengeRequest) For general-purpose connectors.default CreateConnectorResponsecreateConnector(Consumer<CreateConnectorRequest.Builder> createConnectorRequest) Creates a SCEP connector.default CreateConnectorResponsecreateConnector(CreateConnectorRequest createConnectorRequest) Creates a SCEP connector.default DeleteChallengeResponsedeleteChallenge(Consumer<DeleteChallengeRequest.Builder> deleteChallengeRequest) Deletes the specified Challenge.default DeleteChallengeResponsedeleteChallenge(DeleteChallengeRequest deleteChallengeRequest) Deletes the specified Challenge.default DeleteConnectorResponsedeleteConnector(Consumer<DeleteConnectorRequest.Builder> deleteConnectorRequest) Deletes the specified Connector.default DeleteConnectorResponsedeleteConnector(DeleteConnectorRequest deleteConnectorRequest) Deletes the specified Connector.default GetChallengeMetadataResponsegetChallengeMetadata(Consumer<GetChallengeMetadataRequest.Builder> getChallengeMetadataRequest) Retrieves the metadata for the specified Challenge.default GetChallengeMetadataResponsegetChallengeMetadata(GetChallengeMetadataRequest getChallengeMetadataRequest) Retrieves the metadata for the specified Challenge.default GetChallengePasswordResponsegetChallengePassword(Consumer<GetChallengePasswordRequest.Builder> getChallengePasswordRequest) Retrieves the challenge password for the specified Challenge.default GetChallengePasswordResponsegetChallengePassword(GetChallengePasswordRequest getChallengePasswordRequest) Retrieves the challenge password for the specified Challenge.default GetConnectorResponsegetConnector(Consumer<GetConnectorRequest.Builder> getConnectorRequest) Retrieves details about the specified Connector.default GetConnectorResponsegetConnector(GetConnectorRequest getConnectorRequest) Retrieves details about the specified Connector.default ListChallengeMetadataResponselistChallengeMetadata(Consumer<ListChallengeMetadataRequest.Builder> listChallengeMetadataRequest) Retrieves the challenge metadata for the specified ARN.default ListChallengeMetadataResponselistChallengeMetadata(ListChallengeMetadataRequest listChallengeMetadataRequest) Retrieves the challenge metadata for the specified ARN.default ListChallengeMetadataIterablelistChallengeMetadataPaginator(Consumer<ListChallengeMetadataRequest.Builder> listChallengeMetadataRequest) This is a variant oflistChallengeMetadata(software.amazon.awssdk.services.pcaconnectorscep.model.ListChallengeMetadataRequest)operation.default ListChallengeMetadataIterablelistChallengeMetadataPaginator(ListChallengeMetadataRequest listChallengeMetadataRequest) This is a variant oflistChallengeMetadata(software.amazon.awssdk.services.pcaconnectorscep.model.ListChallengeMetadataRequest)operation.default ListConnectorsResponselistConnectors(Consumer<ListConnectorsRequest.Builder> listConnectorsRequest) Lists the connectors belonging to your Amazon Web Services account.default ListConnectorsResponselistConnectors(ListConnectorsRequest listConnectorsRequest) Lists the connectors belonging to your Amazon Web Services account.default ListConnectorsIterablelistConnectorsPaginator(Consumer<ListConnectorsRequest.Builder> listConnectorsRequest) This is a variant oflistConnectors(software.amazon.awssdk.services.pcaconnectorscep.model.ListConnectorsRequest)operation.default ListConnectorsIterablelistConnectorsPaginator(ListConnectorsRequest listConnectorsRequest) This is a variant oflistConnectors(software.amazon.awssdk.services.pcaconnectorscep.model.ListConnectorsRequest)operation.default ListTagsForResourceResponselistTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Retrieves the tags associated with the specified resource.default ListTagsForResourceResponselistTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Retrieves the tags associated with the specified resource.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstatic ServiceMetadatadefault TagResourceResponsetagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds one or more tags to your resource.default TagResourceResponsetagResource(TagResourceRequest tagResourceRequest) Adds one or more tags to your resource.default UntagResourceResponseuntagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes one or more tags from your resource.default UntagResourceResponseuntagResource(UntagResourceRequest untagResourceRequest) Removes one or more tags from your resource.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
createChallenge
default CreateChallengeResponse createChallenge(CreateChallengeRequest createChallengeRequest) throws ResourceNotFoundException, BadRequestException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, ConflictException, ServiceQuotaExceededException, AwsServiceException, SdkClientException, PcaConnectorScepException For general-purpose connectors. Creates a challenge password for the specified connector. The SCEP protocol uses a challenge password to authenticate a request before issuing a certificate from a certificate authority (CA). Your SCEP clients include the challenge password as part of their certificate request to Connector for SCEP. To retrieve the connector Amazon Resource Names (ARNs) for the connectors in your account, call ListConnectors.
To create additional challenge passwords for the connector, call
CreateChallengeagain. We recommend frequently rotating your challenge passwords.- Parameters:
createChallengeRequest-- Returns:
- Result of the CreateChallenge operation returned by the service.
- See Also:
-
createChallenge
default CreateChallengeResponse createChallenge(Consumer<CreateChallengeRequest.Builder> createChallengeRequest) throws ResourceNotFoundException, BadRequestException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, ConflictException, ServiceQuotaExceededException, AwsServiceException, SdkClientException, PcaConnectorScepException For general-purpose connectors. Creates a challenge password for the specified connector. The SCEP protocol uses a challenge password to authenticate a request before issuing a certificate from a certificate authority (CA). Your SCEP clients include the challenge password as part of their certificate request to Connector for SCEP. To retrieve the connector Amazon Resource Names (ARNs) for the connectors in your account, call ListConnectors.
To create additional challenge passwords for the connector, call
CreateChallengeagain. We recommend frequently rotating your challenge passwords.
This is a convenience which creates an instance of the
CreateChallengeRequest.Builderavoiding the need to create one manually viaCreateChallengeRequest.builder()- Parameters:
createChallengeRequest- AConsumerthat will call methods onCreateChallengeRequest.Builderto create a request.- Returns:
- Result of the CreateChallenge operation returned by the service.
- See Also:
-
createConnector
default CreateConnectorResponse createConnector(CreateConnectorRequest createConnectorRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, ConflictException, ServiceQuotaExceededException, AwsServiceException, SdkClientException, PcaConnectorScepException Creates a SCEP connector. A SCEP connector links Amazon Web Services Private Certificate Authority to your SCEP-compatible devices and mobile device management (MDM) systems. Before you create a connector, you must complete a set of prerequisites, including creation of a private certificate authority (CA) to use with this connector. For more information, see Connector for SCEP prerequisites.
- Parameters:
createConnectorRequest-- Returns:
- Result of the CreateConnector operation returned by the service.
- See Also:
-
createConnector
default CreateConnectorResponse createConnector(Consumer<CreateConnectorRequest.Builder> createConnectorRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, ConflictException, ServiceQuotaExceededException, AwsServiceException, SdkClientException, PcaConnectorScepException Creates a SCEP connector. A SCEP connector links Amazon Web Services Private Certificate Authority to your SCEP-compatible devices and mobile device management (MDM) systems. Before you create a connector, you must complete a set of prerequisites, including creation of a private certificate authority (CA) to use with this connector. For more information, see Connector for SCEP prerequisites.
This is a convenience which creates an instance of the
CreateConnectorRequest.Builderavoiding the need to create one manually viaCreateConnectorRequest.builder()- Parameters:
createConnectorRequest- AConsumerthat will call methods onCreateConnectorRequest.Builderto create a request.- Returns:
- Result of the CreateConnector operation returned by the service.
- See Also:
-
deleteChallenge
default DeleteChallengeResponse deleteChallenge(DeleteChallengeRequest deleteChallengeRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, ConflictException, AwsServiceException, SdkClientException, PcaConnectorScepException Deletes the specified Challenge.
- Parameters:
deleteChallengeRequest-- Returns:
- Result of the DeleteChallenge operation returned by the service.
- See Also:
-
deleteChallenge
default DeleteChallengeResponse deleteChallenge(Consumer<DeleteChallengeRequest.Builder> deleteChallengeRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, ConflictException, AwsServiceException, SdkClientException, PcaConnectorScepException Deletes the specified Challenge.
This is a convenience which creates an instance of the
DeleteChallengeRequest.Builderavoiding the need to create one manually viaDeleteChallengeRequest.builder()- Parameters:
deleteChallengeRequest- AConsumerthat will call methods onDeleteChallengeRequest.Builderto create a request.- Returns:
- Result of the DeleteChallenge operation returned by the service.
- See Also:
-
deleteConnector
default DeleteConnectorResponse deleteConnector(DeleteConnectorRequest deleteConnectorRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, ConflictException, AwsServiceException, SdkClientException, PcaConnectorScepException Deletes the specified Connector. This operation also deletes any challenges associated with the connector.
- Parameters:
deleteConnectorRequest-- Returns:
- Result of the DeleteConnector operation returned by the service.
- See Also:
-
deleteConnector
default DeleteConnectorResponse deleteConnector(Consumer<DeleteConnectorRequest.Builder> deleteConnectorRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, ConflictException, AwsServiceException, SdkClientException, PcaConnectorScepException Deletes the specified Connector. This operation also deletes any challenges associated with the connector.
This is a convenience which creates an instance of the
DeleteConnectorRequest.Builderavoiding the need to create one manually viaDeleteConnectorRequest.builder()- Parameters:
deleteConnectorRequest- AConsumerthat will call methods onDeleteConnectorRequest.Builderto create a request.- Returns:
- Result of the DeleteConnector operation returned by the service.
- See Also:
-
getChallengeMetadata
default GetChallengeMetadataResponse getChallengeMetadata(GetChallengeMetadataRequest getChallengeMetadataRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves the metadata for the specified Challenge.
- Parameters:
getChallengeMetadataRequest-- Returns:
- Result of the GetChallengeMetadata operation returned by the service.
- See Also:
-
getChallengeMetadata
default GetChallengeMetadataResponse getChallengeMetadata(Consumer<GetChallengeMetadataRequest.Builder> getChallengeMetadataRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves the metadata for the specified Challenge.
This is a convenience which creates an instance of the
GetChallengeMetadataRequest.Builderavoiding the need to create one manually viaGetChallengeMetadataRequest.builder()- Parameters:
getChallengeMetadataRequest- AConsumerthat will call methods onGetChallengeMetadataRequest.Builderto create a request.- Returns:
- Result of the GetChallengeMetadata operation returned by the service.
- See Also:
-
getChallengePassword
default GetChallengePasswordResponse getChallengePassword(GetChallengePasswordRequest getChallengePasswordRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves the challenge password for the specified Challenge.
- Parameters:
getChallengePasswordRequest-- Returns:
- Result of the GetChallengePassword operation returned by the service.
- See Also:
-
getChallengePassword
default GetChallengePasswordResponse getChallengePassword(Consumer<GetChallengePasswordRequest.Builder> getChallengePasswordRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves the challenge password for the specified Challenge.
This is a convenience which creates an instance of the
GetChallengePasswordRequest.Builderavoiding the need to create one manually viaGetChallengePasswordRequest.builder()- Parameters:
getChallengePasswordRequest- AConsumerthat will call methods onGetChallengePasswordRequest.Builderto create a request.- Returns:
- Result of the GetChallengePassword operation returned by the service.
- See Also:
-
getConnector
default GetConnectorResponse getConnector(GetConnectorRequest getConnectorRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves details about the specified Connector. Calling this action returns important details about the connector, such as the public SCEP URL where your clients can request certificates.
- Parameters:
getConnectorRequest-- Returns:
- Result of the GetConnector operation returned by the service.
- See Also:
-
getConnector
default GetConnectorResponse getConnector(Consumer<GetConnectorRequest.Builder> getConnectorRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves details about the specified Connector. Calling this action returns important details about the connector, such as the public SCEP URL where your clients can request certificates.
This is a convenience which creates an instance of the
GetConnectorRequest.Builderavoiding the need to create one manually viaGetConnectorRequest.builder()- Parameters:
getConnectorRequest- AConsumerthat will call methods onGetConnectorRequest.Builderto create a request.- Returns:
- Result of the GetConnector operation returned by the service.
- See Also:
-
listChallengeMetadata
default ListChallengeMetadataResponse listChallengeMetadata(ListChallengeMetadataRequest listChallengeMetadataRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves the challenge metadata for the specified ARN.
- Parameters:
listChallengeMetadataRequest-- Returns:
- Result of the ListChallengeMetadata operation returned by the service.
- See Also:
-
listChallengeMetadata
default ListChallengeMetadataResponse listChallengeMetadata(Consumer<ListChallengeMetadataRequest.Builder> listChallengeMetadataRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves the challenge metadata for the specified ARN.
This is a convenience which creates an instance of the
ListChallengeMetadataRequest.Builderavoiding the need to create one manually viaListChallengeMetadataRequest.builder()- Parameters:
listChallengeMetadataRequest- AConsumerthat will call methods onListChallengeMetadataRequest.Builderto create a request.- Returns:
- Result of the ListChallengeMetadata operation returned by the service.
- See Also:
-
listChallengeMetadataPaginator
default ListChallengeMetadataIterable listChallengeMetadataPaginator(ListChallengeMetadataRequest listChallengeMetadataRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException This is a variant of
listChallengeMetadata(software.amazon.awssdk.services.pcaconnectorscep.model.ListChallengeMetadataRequest)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
2) Using For loopsoftware.amazon.awssdk.services.pcaconnectorscep.paginators.ListChallengeMetadataIterable responses = client.listChallengeMetadataPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.pcaconnectorscep.paginators.ListChallengeMetadataIterable responses = client .listChallengeMetadataPaginator(request); for (software.amazon.awssdk.services.pcaconnectorscep.model.ListChallengeMetadataResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.pcaconnectorscep.paginators.ListChallengeMetadataIterable responses = client.listChallengeMetadataPaginator(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
listChallengeMetadata(software.amazon.awssdk.services.pcaconnectorscep.model.ListChallengeMetadataRequest)operation.- Parameters:
listChallengeMetadataRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listChallengeMetadataPaginator
default ListChallengeMetadataIterable listChallengeMetadataPaginator(Consumer<ListChallengeMetadataRequest.Builder> listChallengeMetadataRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException This is a variant of
listChallengeMetadata(software.amazon.awssdk.services.pcaconnectorscep.model.ListChallengeMetadataRequest)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
2) Using For loopsoftware.amazon.awssdk.services.pcaconnectorscep.paginators.ListChallengeMetadataIterable responses = client.listChallengeMetadataPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.pcaconnectorscep.paginators.ListChallengeMetadataIterable responses = client .listChallengeMetadataPaginator(request); for (software.amazon.awssdk.services.pcaconnectorscep.model.ListChallengeMetadataResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.pcaconnectorscep.paginators.ListChallengeMetadataIterable responses = client.listChallengeMetadataPaginator(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
listChallengeMetadata(software.amazon.awssdk.services.pcaconnectorscep.model.ListChallengeMetadataRequest)operation.
This is a convenience which creates an instance of the
ListChallengeMetadataRequest.Builderavoiding the need to create one manually viaListChallengeMetadataRequest.builder()- Parameters:
listChallengeMetadataRequest- AConsumerthat will call methods onListChallengeMetadataRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listConnectors
default ListConnectorsResponse listConnectors(ListConnectorsRequest listConnectorsRequest) throws InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Lists the connectors belonging to your Amazon Web Services account.
- Parameters:
listConnectorsRequest-- Returns:
- Result of the ListConnectors operation returned by the service.
- See Also:
-
listConnectors
default ListConnectorsResponse listConnectors(Consumer<ListConnectorsRequest.Builder> listConnectorsRequest) throws InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Lists the connectors belonging to your Amazon Web Services account.
This is a convenience which creates an instance of the
ListConnectorsRequest.Builderavoiding the need to create one manually viaListConnectorsRequest.builder()- Parameters:
listConnectorsRequest- AConsumerthat will call methods onListConnectorsRequest.Builderto create a request.- Returns:
- Result of the ListConnectors operation returned by the service.
- See Also:
-
listConnectorsPaginator
default ListConnectorsIterable listConnectorsPaginator(ListConnectorsRequest listConnectorsRequest) throws InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException This is a variant of
listConnectors(software.amazon.awssdk.services.pcaconnectorscep.model.ListConnectorsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.pcaconnectorscep.paginators.ListConnectorsIterable responses = client.listConnectorsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.pcaconnectorscep.paginators.ListConnectorsIterable responses = client .listConnectorsPaginator(request); for (software.amazon.awssdk.services.pcaconnectorscep.model.ListConnectorsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.pcaconnectorscep.paginators.ListConnectorsIterable responses = client.listConnectorsPaginator(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
listConnectors(software.amazon.awssdk.services.pcaconnectorscep.model.ListConnectorsRequest)operation.- Parameters:
listConnectorsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listConnectorsPaginator
default ListConnectorsIterable listConnectorsPaginator(Consumer<ListConnectorsRequest.Builder> listConnectorsRequest) throws InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException This is a variant of
listConnectors(software.amazon.awssdk.services.pcaconnectorscep.model.ListConnectorsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.pcaconnectorscep.paginators.ListConnectorsIterable responses = client.listConnectorsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.pcaconnectorscep.paginators.ListConnectorsIterable responses = client .listConnectorsPaginator(request); for (software.amazon.awssdk.services.pcaconnectorscep.model.ListConnectorsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.pcaconnectorscep.paginators.ListConnectorsIterable responses = client.listConnectorsPaginator(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
listConnectors(software.amazon.awssdk.services.pcaconnectorscep.model.ListConnectorsRequest)operation.
This is a convenience which creates an instance of the
ListConnectorsRequest.Builderavoiding the need to create one manually viaListConnectorsRequest.builder()- Parameters:
listConnectorsRequest- AConsumerthat will call methods onListConnectorsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves the tags associated with the specified resource. Tags are key-value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.
- Parameters:
listTagsForResourceRequest-- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Retrieves the tags associated with the specified resource. Tags are key-value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request.- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Adds one or more tags to your resource.
- Parameters:
tagResourceRequest-- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Adds one or more tags to your resource.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request.- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Removes one or more tags from your resource.
- Parameters:
untagResourceRequest-- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws ResourceNotFoundException, InternalServerException, ValidationException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, PcaConnectorScepException Removes one or more tags from your resource.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request.- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
create
Create aPcaConnectorScepClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aPcaConnectorScepClient. -
serviceMetadata
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-