Package software.amazon.awssdk.services.ram

Interface RamAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient
@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface RamAsyncClient extends AwsClient
Service client for accessing RAM asynchronously. This can be created using the static builder() method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API call.

This is the Resource Access Manager API Reference. This documentation provides descriptions and syntax for each of the actions and data types in RAM. RAM is a service that helps you securely share your Amazon Web Services resources to other Amazon Web Services accounts. If you use Organizations to manage your accounts, then you can share your resources with your entire organization or to organizational units (OUs). For supported resource types, you can also share resources with individual Identity and Access Management (IAM) roles and users.

To learn more about RAM, see the following resources:

  • Field Details

  • Method Details

    • acceptResourceShareInvitation

      default CompletableFuture<AcceptResourceShareInvitationResponse> acceptResourceShareInvitation(AcceptResourceShareInvitationRequest acceptResourceShareInvitationRequest)

      Accepts an invitation to a resource share from another Amazon Web Services account. After you accept the invitation, the resources included in the resource share are available to interact with in the relevant Amazon Web Services Management Consoles and tools.

      Parameters:
      acceptResourceShareInvitationRequest -
      Returns:
      A Java Future containing the result of the AcceptResourceShareInvitation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • ResourceShareInvitationAlreadyAcceptedException The operation failed because the specified invitation was already accepted.
      • ResourceShareInvitationAlreadyRejectedException The operation failed because the specified invitation was already rejected.
      • ResourceShareInvitationExpiredException The operation failed because the specified invitation is past its expiration date and time.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • acceptResourceShareInvitation

      default CompletableFuture<AcceptResourceShareInvitationResponse> acceptResourceShareInvitation(Consumer<AcceptResourceShareInvitationRequest.Builder> acceptResourceShareInvitationRequest)

      Accepts an invitation to a resource share from another Amazon Web Services account. After you accept the invitation, the resources included in the resource share are available to interact with in the relevant Amazon Web Services Management Consoles and tools.


      This is a convenience which creates an instance of the AcceptResourceShareInvitationRequest.Builder avoiding the need to create one manually via AcceptResourceShareInvitationRequest.builder()

      Parameters:
      acceptResourceShareInvitationRequest - A Consumer that will call methods on AcceptResourceShareInvitationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the AcceptResourceShareInvitation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • ResourceShareInvitationAlreadyAcceptedException The operation failed because the specified invitation was already accepted.
      • ResourceShareInvitationAlreadyRejectedException The operation failed because the specified invitation was already rejected.
      • ResourceShareInvitationExpiredException The operation failed because the specified invitation is past its expiration date and time.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • associateResourceShare

      default CompletableFuture<AssociateResourceShareResponse> associateResourceShare(AssociateResourceShareRequest associateResourceShareRequest)

      Adds the specified list of principals and list of resources to a resource share. Principals that already have access to this resource share immediately receive access to the added resources. Newly added principals immediately receive access to the resources shared in this resource share.

      Parameters:
      associateResourceShareRequest -
      Returns:
      A Java Future containing the result of the AssociateResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • ResourceShareLimitExceededException The operation failed because it would exceed the limit for resource shares for your account. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • ThrottlingException The operation failed because it exceeded the rate at which you are allowed to perform this operation. Please try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • associateResourceShare

      default CompletableFuture<AssociateResourceShareResponse> associateResourceShare(Consumer<AssociateResourceShareRequest.Builder> associateResourceShareRequest)

      Adds the specified list of principals and list of resources to a resource share. Principals that already have access to this resource share immediately receive access to the added resources. Newly added principals immediately receive access to the resources shared in this resource share.


      This is a convenience which creates an instance of the AssociateResourceShareRequest.Builder avoiding the need to create one manually via AssociateResourceShareRequest.builder()

      Parameters:
      associateResourceShareRequest - A Consumer that will call methods on AssociateResourceShareRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the AssociateResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • ResourceShareLimitExceededException The operation failed because it would exceed the limit for resource shares for your account. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • ThrottlingException The operation failed because it exceeded the rate at which you are allowed to perform this operation. Please try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • associateResourceSharePermission

      default CompletableFuture<AssociateResourceSharePermissionResponse> associateResourceSharePermission(AssociateResourceSharePermissionRequest associateResourceSharePermissionRequest)

      Adds or replaces the RAM permission for a resource type included in a resource share. You can have exactly one permission associated with each resource type in the resource share. You can add a new RAM permission only if there are currently no resources of that resource type currently in the resource share.

      Parameters:
      associateResourceSharePermissionRequest -
      Returns:
      A Java Future containing the result of the AssociateResourceSharePermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • associateResourceSharePermission

      default CompletableFuture<AssociateResourceSharePermissionResponse> associateResourceSharePermission(Consumer<AssociateResourceSharePermissionRequest.Builder> associateResourceSharePermissionRequest)

      Adds or replaces the RAM permission for a resource type included in a resource share. You can have exactly one permission associated with each resource type in the resource share. You can add a new RAM permission only if there are currently no resources of that resource type currently in the resource share.


      This is a convenience which creates an instance of the AssociateResourceSharePermissionRequest.Builder avoiding the need to create one manually via AssociateResourceSharePermissionRequest.builder()

      Parameters:
      associateResourceSharePermissionRequest - A Consumer that will call methods on AssociateResourceSharePermissionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the AssociateResourceSharePermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createPermission

      default CompletableFuture<CreatePermissionResponse> createPermission(CreatePermissionRequest createPermissionRequest)

      Creates a customer managed permission for a specified resource type that you can attach to resource shares. It is created in the Amazon Web Services Region in which you call the operation.

      Parameters:
      createPermissionRequest -
      Returns:
      A Java Future containing the result of the CreatePermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidPolicyException The operation failed because a policy you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • PermissionAlreadyExistsException The operation failed because a permission with the specified name already exists in the requested Amazon Web Services Region. Choose a different name.
      • MalformedPolicyTemplateException The operation failed because the policy template that you provided isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • PermissionLimitExceededException The operation failed because it would exceed the maximum number of permissions you can create in each Amazon Web Services Region. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createPermission

      default CompletableFuture<CreatePermissionResponse> createPermission(Consumer<CreatePermissionRequest.Builder> createPermissionRequest)

      Creates a customer managed permission for a specified resource type that you can attach to resource shares. It is created in the Amazon Web Services Region in which you call the operation.


      This is a convenience which creates an instance of the CreatePermissionRequest.Builder avoiding the need to create one manually via CreatePermissionRequest.builder()

      Parameters:
      createPermissionRequest - A Consumer that will call methods on CreatePermissionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreatePermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidPolicyException The operation failed because a policy you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • PermissionAlreadyExistsException The operation failed because a permission with the specified name already exists in the requested Amazon Web Services Region. Choose a different name.
      • MalformedPolicyTemplateException The operation failed because the policy template that you provided isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • PermissionLimitExceededException The operation failed because it would exceed the maximum number of permissions you can create in each Amazon Web Services Region. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createPermissionVersion

      default CompletableFuture<CreatePermissionVersionResponse> createPermissionVersion(CreatePermissionVersionRequest createPermissionVersionRequest)

      Creates a new version of the specified customer managed permission. The new version is automatically set as the default version of the customer managed permission. New resource shares automatically use the default permission. Existing resource shares continue to use their original permission versions, but you can use ReplacePermissionAssociations to update them.

      If the specified customer managed permission already has the maximum of 5 versions, then you must delete one of the existing versions before you can create a new one.

      Parameters:
      createPermissionVersionRequest -
      Returns:
      A Java Future containing the result of the CreatePermissionVersion operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidPolicyException The operation failed because a policy you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedPolicyTemplateException The operation failed because the policy template that you provided isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • PermissionVersionsLimitExceededException The operation failed because it would exceed the limit for the number of versions you can have for a permission. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createPermissionVersion

      default CompletableFuture<CreatePermissionVersionResponse> createPermissionVersion(Consumer<CreatePermissionVersionRequest.Builder> createPermissionVersionRequest)

      Creates a new version of the specified customer managed permission. The new version is automatically set as the default version of the customer managed permission. New resource shares automatically use the default permission. Existing resource shares continue to use their original permission versions, but you can use ReplacePermissionAssociations to update them.

      If the specified customer managed permission already has the maximum of 5 versions, then you must delete one of the existing versions before you can create a new one.


      This is a convenience which creates an instance of the CreatePermissionVersionRequest.Builder avoiding the need to create one manually via CreatePermissionVersionRequest.builder()

      Parameters:
      createPermissionVersionRequest - A Consumer that will call methods on CreatePermissionVersionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreatePermissionVersion operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidPolicyException The operation failed because a policy you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedPolicyTemplateException The operation failed because the policy template that you provided isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • PermissionVersionsLimitExceededException The operation failed because it would exceed the limit for the number of versions you can have for a permission. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createResourceShare

      default CompletableFuture<CreateResourceShareResponse> createResourceShare(CreateResourceShareRequest createResourceShareRequest)

      Creates a resource share. You can provide a list of the Amazon Resource Names (ARNs) for the resources that you want to share, a list of principals you want to share the resources with, and the permissions to grant those principals.

      Sharing a resource makes it available for use by principals outside of the Amazon Web Services account that created the resource. Sharing doesn't change any permissions or quotas that apply to the resource in the account that created it.

      Parameters:
      createResourceShareRequest -
      Returns:
      A Java Future containing the result of the CreateResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ResourceShareLimitExceededException The operation failed because it would exceed the limit for resource shares for your account. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • TagPolicyViolationException The operation failed because the specified tag key is a reserved word and can't be used.
      • TagLimitExceededException The operation failed because it would exceed the limit for tags for your Amazon Web Services account.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createResourceShare

      default CompletableFuture<CreateResourceShareResponse> createResourceShare(Consumer<CreateResourceShareRequest.Builder> createResourceShareRequest)

      Creates a resource share. You can provide a list of the Amazon Resource Names (ARNs) for the resources that you want to share, a list of principals you want to share the resources with, and the permissions to grant those principals.

      Sharing a resource makes it available for use by principals outside of the Amazon Web Services account that created the resource. Sharing doesn't change any permissions or quotas that apply to the resource in the account that created it.


      This is a convenience which creates an instance of the CreateResourceShareRequest.Builder avoiding the need to create one manually via CreateResourceShareRequest.builder()

      Parameters:
      createResourceShareRequest - A Consumer that will call methods on CreateResourceShareRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ResourceShareLimitExceededException The operation failed because it would exceed the limit for resource shares for your account. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • TagPolicyViolationException The operation failed because the specified tag key is a reserved word and can't be used.
      • TagLimitExceededException The operation failed because it would exceed the limit for tags for your Amazon Web Services account.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deletePermission

      default CompletableFuture<DeletePermissionResponse> deletePermission(DeletePermissionRequest deletePermissionRequest)

      Deletes the specified customer managed permission in the Amazon Web Services Region in which you call this operation. You can delete a customer managed permission only if it isn't attached to any resource share. The operation deletes all versions associated with the customer managed permission.

      Parameters:
      deletePermissionRequest -
      Returns:
      A Java Future containing the result of the DeletePermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deletePermission

      default CompletableFuture<DeletePermissionResponse> deletePermission(Consumer<DeletePermissionRequest.Builder> deletePermissionRequest)

      Deletes the specified customer managed permission in the Amazon Web Services Region in which you call this operation. You can delete a customer managed permission only if it isn't attached to any resource share. The operation deletes all versions associated with the customer managed permission.


      This is a convenience which creates an instance of the DeletePermissionRequest.Builder avoiding the need to create one manually via DeletePermissionRequest.builder()

      Parameters:
      deletePermissionRequest - A Consumer that will call methods on DeletePermissionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeletePermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deletePermissionVersion

      default CompletableFuture<DeletePermissionVersionResponse> deletePermissionVersion(DeletePermissionVersionRequest deletePermissionVersionRequest)

      Deletes one version of a customer managed permission. The version you specify must not be attached to any resource share and must not be the default version for the permission.

      If a customer managed permission has the maximum of 5 versions, then you must delete at least one version before you can create another.

      Parameters:
      deletePermissionVersionRequest -
      Returns:
      A Java Future containing the result of the DeletePermissionVersion operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deletePermissionVersion

      default CompletableFuture<DeletePermissionVersionResponse> deletePermissionVersion(Consumer<DeletePermissionVersionRequest.Builder> deletePermissionVersionRequest)

      Deletes one version of a customer managed permission. The version you specify must not be attached to any resource share and must not be the default version for the permission.

      If a customer managed permission has the maximum of 5 versions, then you must delete at least one version before you can create another.


      This is a convenience which creates an instance of the DeletePermissionVersionRequest.Builder avoiding the need to create one manually via DeletePermissionVersionRequest.builder()

      Parameters:
      deletePermissionVersionRequest - A Consumer that will call methods on DeletePermissionVersionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeletePermissionVersion operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteResourceShare

      default CompletableFuture<DeleteResourceShareResponse> deleteResourceShare(DeleteResourceShareRequest deleteResourceShareRequest)

      Deletes the specified resource share.

      This doesn't delete any of the resources that were associated with the resource share; it only stops the sharing of those resources through this resource share.

      Parameters:
      deleteResourceShareRequest -
      Returns:
      A Java Future containing the result of the DeleteResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteResourceShare

      default CompletableFuture<DeleteResourceShareResponse> deleteResourceShare(Consumer<DeleteResourceShareRequest.Builder> deleteResourceShareRequest)

      Deletes the specified resource share.

      This doesn't delete any of the resources that were associated with the resource share; it only stops the sharing of those resources through this resource share.


      This is a convenience which creates an instance of the DeleteResourceShareRequest.Builder avoiding the need to create one manually via DeleteResourceShareRequest.builder()

      Parameters:
      deleteResourceShareRequest - A Consumer that will call methods on DeleteResourceShareRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateResourceShare

      default CompletableFuture<DisassociateResourceShareResponse> disassociateResourceShare(DisassociateResourceShareRequest disassociateResourceShareRequest)

      Removes the specified principals or resources from participating in the specified resource share.

      Parameters:
      disassociateResourceShareRequest -
      Returns:
      A Java Future containing the result of the DisassociateResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • ResourceShareLimitExceededException The operation failed because it would exceed the limit for resource shares for your account. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateResourceShare

      default CompletableFuture<DisassociateResourceShareResponse> disassociateResourceShare(Consumer<DisassociateResourceShareRequest.Builder> disassociateResourceShareRequest)

      Removes the specified principals or resources from participating in the specified resource share.


      This is a convenience which creates an instance of the DisassociateResourceShareRequest.Builder avoiding the need to create one manually via DisassociateResourceShareRequest.builder()

      Parameters:
      disassociateResourceShareRequest - A Consumer that will call methods on DisassociateResourceShareRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DisassociateResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • ResourceShareLimitExceededException The operation failed because it would exceed the limit for resource shares for your account. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateResourceSharePermission

      default CompletableFuture<DisassociateResourceSharePermissionResponse> disassociateResourceSharePermission(DisassociateResourceSharePermissionRequest disassociateResourceSharePermissionRequest)

      Removes a managed permission from a resource share. Permission changes take effect immediately. You can remove a managed permission from a resource share only if there are currently no resources of the relevant resource type currently attached to the resource share.

      Parameters:
      disassociateResourceSharePermissionRequest -
      Returns:
      A Java Future containing the result of the DisassociateResourceSharePermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateResourceSharePermission

      default CompletableFuture<DisassociateResourceSharePermissionResponse> disassociateResourceSharePermission(Consumer<DisassociateResourceSharePermissionRequest.Builder> disassociateResourceSharePermissionRequest)

      Removes a managed permission from a resource share. Permission changes take effect immediately. You can remove a managed permission from a resource share only if there are currently no resources of the relevant resource type currently attached to the resource share.


      This is a convenience which creates an instance of the DisassociateResourceSharePermissionRequest.Builder avoiding the need to create one manually via DisassociateResourceSharePermissionRequest.builder()

      Parameters:
      disassociateResourceSharePermissionRequest - A Consumer that will call methods on DisassociateResourceSharePermissionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DisassociateResourceSharePermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • enableSharingWithAwsOrganization

      default CompletableFuture<EnableSharingWithAwsOrganizationResponse> enableSharingWithAwsOrganization(EnableSharingWithAwsOrganizationRequest enableSharingWithAwsOrganizationRequest)

      Enables resource sharing within your organization in Organizations. This operation creates a service-linked role called AWSServiceRoleForResourceAccessManager that has the IAM managed policy named AWSResourceAccessManagerServiceRolePolicy attached. This role permits RAM to retrieve information about the organization and its structure. This lets you share resources with all of the accounts in the calling account's organization by specifying the organization ID, or all of the accounts in an organizational unit (OU) by specifying the OU ID. Until you enable sharing within the organization, you can specify only individual Amazon Web Services accounts, or for supported resource types, IAM roles and users.

      You must call this operation from an IAM role or user in the organization's management account.

      Parameters:
      enableSharingWithAwsOrganizationRequest -
      Returns:
      A Java Future containing the result of the EnableSharingWithAwsOrganization operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • enableSharingWithAwsOrganization

      default CompletableFuture<EnableSharingWithAwsOrganizationResponse> enableSharingWithAwsOrganization(Consumer<EnableSharingWithAwsOrganizationRequest.Builder> enableSharingWithAwsOrganizationRequest)

      Enables resource sharing within your organization in Organizations. This operation creates a service-linked role called AWSServiceRoleForResourceAccessManager that has the IAM managed policy named AWSResourceAccessManagerServiceRolePolicy attached. This role permits RAM to retrieve information about the organization and its structure. This lets you share resources with all of the accounts in the calling account's organization by specifying the organization ID, or all of the accounts in an organizational unit (OU) by specifying the OU ID. Until you enable sharing within the organization, you can specify only individual Amazon Web Services accounts, or for supported resource types, IAM roles and users.

      You must call this operation from an IAM role or user in the organization's management account.


      This is a convenience which creates an instance of the EnableSharingWithAwsOrganizationRequest.Builder avoiding the need to create one manually via EnableSharingWithAwsOrganizationRequest.builder()

      Parameters:
      enableSharingWithAwsOrganizationRequest - A Consumer that will call methods on EnableSharingWithAwsOrganizationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the EnableSharingWithAwsOrganization operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • enableSharingWithAwsOrganization

      default CompletableFuture<EnableSharingWithAwsOrganizationResponse> enableSharingWithAwsOrganization()

      Enables resource sharing within your organization in Organizations. This operation creates a service-linked role called AWSServiceRoleForResourceAccessManager that has the IAM managed policy named AWSResourceAccessManagerServiceRolePolicy attached. This role permits RAM to retrieve information about the organization and its structure. This lets you share resources with all of the accounts in the calling account's organization by specifying the organization ID, or all of the accounts in an organizational unit (OU) by specifying the OU ID. Until you enable sharing within the organization, you can specify only individual Amazon Web Services accounts, or for supported resource types, IAM roles and users.

      You must call this operation from an IAM role or user in the organization's management account.

      Returns:
      A Java Future containing the result of the EnableSharingWithAwsOrganization operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getPermission

      default CompletableFuture<GetPermissionResponse> getPermission(GetPermissionRequest getPermissionRequest)

      Retrieves the contents of a managed permission in JSON format.

      Parameters:
      getPermissionRequest -
      Returns:
      A Java Future containing the result of the GetPermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getPermission

      default CompletableFuture<GetPermissionResponse> getPermission(Consumer<GetPermissionRequest.Builder> getPermissionRequest)

      Retrieves the contents of a managed permission in JSON format.


      This is a convenience which creates an instance of the GetPermissionRequest.Builder avoiding the need to create one manually via GetPermissionRequest.builder()

      Parameters:
      getPermissionRequest - A Consumer that will call methods on GetPermissionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetPermission operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourcePolicies

      default CompletableFuture<GetResourcePoliciesResponse> getResourcePolicies(GetResourcePoliciesRequest getResourcePoliciesRequest)

      Retrieves the resource policies for the specified resources that you own and have shared.

      Parameters:
      getResourcePoliciesRequest -
      Returns:
      A Java Future containing the result of the GetResourcePolicies operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ResourceArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) was not found.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourcePolicies

      default CompletableFuture<GetResourcePoliciesResponse> getResourcePolicies(Consumer<GetResourcePoliciesRequest.Builder> getResourcePoliciesRequest)

      Retrieves the resource policies for the specified resources that you own and have shared.


      This is a convenience which creates an instance of the GetResourcePoliciesRequest.Builder avoiding the need to create one manually via GetResourcePoliciesRequest.builder()

      Parameters:
      getResourcePoliciesRequest - A Consumer that will call methods on GetResourcePoliciesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetResourcePolicies operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ResourceArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) was not found.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourcePoliciesPaginator

      default GetResourcePoliciesPublisher getResourcePoliciesPaginator(GetResourcePoliciesRequest getResourcePoliciesRequest)

      This is a variant of getResourcePolicies(software.amazon.awssdk.services.ram.model.GetResourcePoliciesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.GetResourcePoliciesPublisher publisher = client.getResourcePoliciesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.GetResourcePoliciesPublisher publisher = client.getResourcePoliciesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.GetResourcePoliciesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.GetResourcePoliciesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getResourcePolicies(software.amazon.awssdk.services.ram.model.GetResourcePoliciesRequest) operation.

      Parameters:
      getResourcePoliciesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ResourceArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) was not found.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourcePoliciesPaginator

      default GetResourcePoliciesPublisher getResourcePoliciesPaginator(Consumer<GetResourcePoliciesRequest.Builder> getResourcePoliciesRequest)

      This is a variant of getResourcePolicies(software.amazon.awssdk.services.ram.model.GetResourcePoliciesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.GetResourcePoliciesPublisher publisher = client.getResourcePoliciesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.GetResourcePoliciesPublisher publisher = client.getResourcePoliciesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.GetResourcePoliciesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.GetResourcePoliciesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getResourcePolicies(software.amazon.awssdk.services.ram.model.GetResourcePoliciesRequest) operation.


      This is a convenience which creates an instance of the GetResourcePoliciesRequest.Builder avoiding the need to create one manually via GetResourcePoliciesRequest.builder()

      Parameters:
      getResourcePoliciesRequest - A Consumer that will call methods on GetResourcePoliciesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ResourceArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) was not found.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareAssociations

      default CompletableFuture<GetResourceShareAssociationsResponse> getResourceShareAssociations(GetResourceShareAssociationsRequest getResourceShareAssociationsRequest)

      Retrieves the lists of resources and principals that associated for resource shares that you own.

      Parameters:
      getResourceShareAssociationsRequest -
      Returns:
      A Java Future containing the result of the GetResourceShareAssociations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareAssociations

      default CompletableFuture<GetResourceShareAssociationsResponse> getResourceShareAssociations(Consumer<GetResourceShareAssociationsRequest.Builder> getResourceShareAssociationsRequest)

      Retrieves the lists of resources and principals that associated for resource shares that you own.


      This is a convenience which creates an instance of the GetResourceShareAssociationsRequest.Builder avoiding the need to create one manually via GetResourceShareAssociationsRequest.builder()

      Parameters:
      getResourceShareAssociationsRequest - A Consumer that will call methods on GetResourceShareAssociationsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetResourceShareAssociations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareAssociationsPaginator

      default GetResourceShareAssociationsPublisher getResourceShareAssociationsPaginator(GetResourceShareAssociationsRequest getResourceShareAssociationsRequest)

      This is a variant of getResourceShareAssociations(software.amazon.awssdk.services.ram.model.GetResourceShareAssociationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareAssociationsPublisher publisher = client.getResourceShareAssociationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareAssociationsPublisher publisher = client.getResourceShareAssociationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.GetResourceShareAssociationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.GetResourceShareAssociationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getResourceShareAssociations(software.amazon.awssdk.services.ram.model.GetResourceShareAssociationsRequest) operation.

      Parameters:
      getResourceShareAssociationsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareAssociationsPaginator

      default GetResourceShareAssociationsPublisher getResourceShareAssociationsPaginator(Consumer<GetResourceShareAssociationsRequest.Builder> getResourceShareAssociationsRequest)

      This is a variant of getResourceShareAssociations(software.amazon.awssdk.services.ram.model.GetResourceShareAssociationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareAssociationsPublisher publisher = client.getResourceShareAssociationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareAssociationsPublisher publisher = client.getResourceShareAssociationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.GetResourceShareAssociationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.GetResourceShareAssociationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getResourceShareAssociations(software.amazon.awssdk.services.ram.model.GetResourceShareAssociationsRequest) operation.


      This is a convenience which creates an instance of the GetResourceShareAssociationsRequest.Builder avoiding the need to create one manually via GetResourceShareAssociationsRequest.builder()

      Parameters:
      getResourceShareAssociationsRequest - A Consumer that will call methods on GetResourceShareAssociationsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareInvitations

      default CompletableFuture<GetResourceShareInvitationsResponse> getResourceShareInvitations(GetResourceShareInvitationsRequest getResourceShareInvitationsRequest)

      Retrieves details about invitations that you have received for resource shares.

      Parameters:
      getResourceShareInvitationsRequest -
      Returns:
      A Java Future containing the result of the GetResourceShareInvitations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • InvalidMaxResultsException The operation failed because the specified value for MaxResults isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareInvitations

      default CompletableFuture<GetResourceShareInvitationsResponse> getResourceShareInvitations(Consumer<GetResourceShareInvitationsRequest.Builder> getResourceShareInvitationsRequest)

      Retrieves details about invitations that you have received for resource shares.


      This is a convenience which creates an instance of the GetResourceShareInvitationsRequest.Builder avoiding the need to create one manually via GetResourceShareInvitationsRequest.builder()

      Parameters:
      getResourceShareInvitationsRequest - A Consumer that will call methods on GetResourceShareInvitationsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetResourceShareInvitations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • InvalidMaxResultsException The operation failed because the specified value for MaxResults isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareInvitations

      default CompletableFuture<GetResourceShareInvitationsResponse> getResourceShareInvitations()

      Retrieves details about invitations that you have received for resource shares.

      Returns:
      A Java Future containing the result of the GetResourceShareInvitations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • InvalidMaxResultsException The operation failed because the specified value for MaxResults isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareInvitationsPaginator

      default GetResourceShareInvitationsPublisher getResourceShareInvitationsPaginator()

      This is a variant of getResourceShareInvitations(software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareInvitationsPublisher publisher = client.getResourceShareInvitationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareInvitationsPublisher publisher = client.getResourceShareInvitationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getResourceShareInvitations(software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsRequest) operation.

      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • InvalidMaxResultsException The operation failed because the specified value for MaxResults isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareInvitationsPaginator

      default GetResourceShareInvitationsPublisher getResourceShareInvitationsPaginator(GetResourceShareInvitationsRequest getResourceShareInvitationsRequest)

      This is a variant of getResourceShareInvitations(software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareInvitationsPublisher publisher = client.getResourceShareInvitationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareInvitationsPublisher publisher = client.getResourceShareInvitationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getResourceShareInvitations(software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsRequest) operation.

      Parameters:
      getResourceShareInvitationsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • InvalidMaxResultsException The operation failed because the specified value for MaxResults isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShareInvitationsPaginator

      default GetResourceShareInvitationsPublisher getResourceShareInvitationsPaginator(Consumer<GetResourceShareInvitationsRequest.Builder> getResourceShareInvitationsRequest)

      This is a variant of getResourceShareInvitations(software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareInvitationsPublisher publisher = client.getResourceShareInvitationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceShareInvitationsPublisher publisher = client.getResourceShareInvitationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getResourceShareInvitations(software.amazon.awssdk.services.ram.model.GetResourceShareInvitationsRequest) operation.


      This is a convenience which creates an instance of the GetResourceShareInvitationsRequest.Builder avoiding the need to create one manually via GetResourceShareInvitationsRequest.builder()

      Parameters:
      getResourceShareInvitationsRequest - A Consumer that will call methods on GetResourceShareInvitationsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • InvalidMaxResultsException The operation failed because the specified value for MaxResults isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShares

      default CompletableFuture<GetResourceSharesResponse> getResourceShares(GetResourceSharesRequest getResourceSharesRequest)

      Retrieves details about the resource shares that you own or that are shared with you.

      Parameters:
      getResourceSharesRequest -
      Returns:
      A Java Future containing the result of the GetResourceShares operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceShares

      default CompletableFuture<GetResourceSharesResponse> getResourceShares(Consumer<GetResourceSharesRequest.Builder> getResourceSharesRequest)

      Retrieves details about the resource shares that you own or that are shared with you.


      This is a convenience which creates an instance of the GetResourceSharesRequest.Builder avoiding the need to create one manually via GetResourceSharesRequest.builder()

      Parameters:
      getResourceSharesRequest - A Consumer that will call methods on GetResourceSharesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetResourceShares operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceSharesPaginator

      default GetResourceSharesPublisher getResourceSharesPaginator(GetResourceSharesRequest getResourceSharesRequest)

      This is a variant of getResourceShares(software.amazon.awssdk.services.ram.model.GetResourceSharesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceSharesPublisher publisher = client.getResourceSharesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceSharesPublisher publisher = client.getResourceSharesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.GetResourceSharesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.GetResourceSharesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getResourceShares(software.amazon.awssdk.services.ram.model.GetResourceSharesRequest) operation.

      Parameters:
      getResourceSharesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourceSharesPaginator

      default GetResourceSharesPublisher getResourceSharesPaginator(Consumer<GetResourceSharesRequest.Builder> getResourceSharesRequest)

      This is a variant of getResourceShares(software.amazon.awssdk.services.ram.model.GetResourceSharesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceSharesPublisher publisher = client.getResourceSharesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.GetResourceSharesPublisher publisher = client.getResourceSharesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.GetResourceSharesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.GetResourceSharesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getResourceShares(software.amazon.awssdk.services.ram.model.GetResourceSharesRequest) operation.


      This is a convenience which creates an instance of the GetResourceSharesRequest.Builder avoiding the need to create one manually via GetResourceSharesRequest.builder()

      Parameters:
      getResourceSharesRequest - A Consumer that will call methods on GetResourceSharesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPendingInvitationResources

      default CompletableFuture<ListPendingInvitationResourcesResponse> listPendingInvitationResources(ListPendingInvitationResourcesRequest listPendingInvitationResourcesRequest)

      Lists the resources in a resource share that is shared with you but for which the invitation is still PENDING. That means that you haven't accepted or rejected the invitation and the invitation hasn't expired.

      Parameters:
      listPendingInvitationResourcesRequest -
      Returns:
      A Java Future containing the result of the ListPendingInvitationResources operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • ResourceShareInvitationAlreadyRejectedException The operation failed because the specified invitation was already rejected.
      • ResourceShareInvitationExpiredException The operation failed because the specified invitation is past its expiration date and time.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPendingInvitationResources

      default CompletableFuture<ListPendingInvitationResourcesResponse> listPendingInvitationResources(Consumer<ListPendingInvitationResourcesRequest.Builder> listPendingInvitationResourcesRequest)

      Lists the resources in a resource share that is shared with you but for which the invitation is still PENDING. That means that you haven't accepted or rejected the invitation and the invitation hasn't expired.


      This is a convenience which creates an instance of the ListPendingInvitationResourcesRequest.Builder avoiding the need to create one manually via ListPendingInvitationResourcesRequest.builder()

      Parameters:
      listPendingInvitationResourcesRequest - A Consumer that will call methods on ListPendingInvitationResourcesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListPendingInvitationResources operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • ResourceShareInvitationAlreadyRejectedException The operation failed because the specified invitation was already rejected.
      • ResourceShareInvitationExpiredException The operation failed because the specified invitation is past its expiration date and time.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPendingInvitationResourcesPaginator

      default ListPendingInvitationResourcesPublisher listPendingInvitationResourcesPaginator(ListPendingInvitationResourcesRequest listPendingInvitationResourcesRequest)

      This is a variant of listPendingInvitationResources(software.amazon.awssdk.services.ram.model.ListPendingInvitationResourcesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPendingInvitationResourcesPublisher publisher = client.listPendingInvitationResourcesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPendingInvitationResourcesPublisher publisher = client.listPendingInvitationResourcesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPendingInvitationResourcesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPendingInvitationResourcesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPendingInvitationResources(software.amazon.awssdk.services.ram.model.ListPendingInvitationResourcesRequest) operation.

      Parameters:
      listPendingInvitationResourcesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • ResourceShareInvitationAlreadyRejectedException The operation failed because the specified invitation was already rejected.
      • ResourceShareInvitationExpiredException The operation failed because the specified invitation is past its expiration date and time.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPendingInvitationResourcesPaginator

      default ListPendingInvitationResourcesPublisher listPendingInvitationResourcesPaginator(Consumer<ListPendingInvitationResourcesRequest.Builder> listPendingInvitationResourcesRequest)

      This is a variant of listPendingInvitationResources(software.amazon.awssdk.services.ram.model.ListPendingInvitationResourcesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPendingInvitationResourcesPublisher publisher = client.listPendingInvitationResourcesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPendingInvitationResourcesPublisher publisher = client.listPendingInvitationResourcesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPendingInvitationResourcesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPendingInvitationResourcesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPendingInvitationResources(software.amazon.awssdk.services.ram.model.ListPendingInvitationResourcesRequest) operation.


      This is a convenience which creates an instance of the ListPendingInvitationResourcesRequest.Builder avoiding the need to create one manually via ListPendingInvitationResourcesRequest.builder()

      Parameters:
      listPendingInvitationResourcesRequest - A Consumer that will call methods on ListPendingInvitationResourcesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • ResourceShareInvitationAlreadyRejectedException The operation failed because the specified invitation was already rejected.
      • ResourceShareInvitationExpiredException The operation failed because the specified invitation is past its expiration date and time.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionAssociations

      default CompletableFuture<ListPermissionAssociationsResponse> listPermissionAssociations(ListPermissionAssociationsRequest listPermissionAssociationsRequest)

      Lists information about the managed permission and its associations to any resource shares that use this managed permission. This lets you see which resource shares use which versions of the specified managed permission.

      Parameters:
      listPermissionAssociationsRequest -
      Returns:
      A Java Future containing the result of the ListPermissionAssociations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionAssociations

      default CompletableFuture<ListPermissionAssociationsResponse> listPermissionAssociations(Consumer<ListPermissionAssociationsRequest.Builder> listPermissionAssociationsRequest)

      Lists information about the managed permission and its associations to any resource shares that use this managed permission. This lets you see which resource shares use which versions of the specified managed permission.


      This is a convenience which creates an instance of the ListPermissionAssociationsRequest.Builder avoiding the need to create one manually via ListPermissionAssociationsRequest.builder()

      Parameters:
      listPermissionAssociationsRequest - A Consumer that will call methods on ListPermissionAssociationsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListPermissionAssociations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionAssociationsPaginator

      default ListPermissionAssociationsPublisher listPermissionAssociationsPaginator(ListPermissionAssociationsRequest listPermissionAssociationsRequest)

      This is a variant of listPermissionAssociations(software.amazon.awssdk.services.ram.model.ListPermissionAssociationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionAssociationsPublisher publisher = client.listPermissionAssociationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionAssociationsPublisher publisher = client.listPermissionAssociationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPermissionAssociationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPermissionAssociationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPermissionAssociations(software.amazon.awssdk.services.ram.model.ListPermissionAssociationsRequest) operation.

      Parameters:
      listPermissionAssociationsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionAssociationsPaginator

      default ListPermissionAssociationsPublisher listPermissionAssociationsPaginator(Consumer<ListPermissionAssociationsRequest.Builder> listPermissionAssociationsRequest)

      This is a variant of listPermissionAssociations(software.amazon.awssdk.services.ram.model.ListPermissionAssociationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionAssociationsPublisher publisher = client.listPermissionAssociationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionAssociationsPublisher publisher = client.listPermissionAssociationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPermissionAssociationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPermissionAssociationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPermissionAssociations(software.amazon.awssdk.services.ram.model.ListPermissionAssociationsRequest) operation.


      This is a convenience which creates an instance of the ListPermissionAssociationsRequest.Builder avoiding the need to create one manually via ListPermissionAssociationsRequest.builder()

      Parameters:
      listPermissionAssociationsRequest - A Consumer that will call methods on ListPermissionAssociationsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionVersions

      default CompletableFuture<ListPermissionVersionsResponse> listPermissionVersions(ListPermissionVersionsRequest listPermissionVersionsRequest)

      Lists the available versions of the specified RAM permission.

      Parameters:
      listPermissionVersionsRequest -
      Returns:
      A Java Future containing the result of the ListPermissionVersions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionVersions

      default CompletableFuture<ListPermissionVersionsResponse> listPermissionVersions(Consumer<ListPermissionVersionsRequest.Builder> listPermissionVersionsRequest)

      Lists the available versions of the specified RAM permission.


      This is a convenience which creates an instance of the ListPermissionVersionsRequest.Builder avoiding the need to create one manually via ListPermissionVersionsRequest.builder()

      Parameters:
      listPermissionVersionsRequest - A Consumer that will call methods on ListPermissionVersionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListPermissionVersions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionVersionsPaginator

      default ListPermissionVersionsPublisher listPermissionVersionsPaginator(ListPermissionVersionsRequest listPermissionVersionsRequest)

      This is a variant of listPermissionVersions(software.amazon.awssdk.services.ram.model.ListPermissionVersionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionVersionsPublisher publisher = client.listPermissionVersionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionVersionsPublisher publisher = client.listPermissionVersionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPermissionVersionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPermissionVersionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPermissionVersions(software.amazon.awssdk.services.ram.model.ListPermissionVersionsRequest) operation.

      Parameters:
      listPermissionVersionsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionVersionsPaginator

      default ListPermissionVersionsPublisher listPermissionVersionsPaginator(Consumer<ListPermissionVersionsRequest.Builder> listPermissionVersionsRequest)

      This is a variant of listPermissionVersions(software.amazon.awssdk.services.ram.model.ListPermissionVersionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionVersionsPublisher publisher = client.listPermissionVersionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionVersionsPublisher publisher = client.listPermissionVersionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPermissionVersionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPermissionVersionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPermissionVersions(software.amazon.awssdk.services.ram.model.ListPermissionVersionsRequest) operation.


      This is a convenience which creates an instance of the ListPermissionVersionsRequest.Builder avoiding the need to create one manually via ListPermissionVersionsRequest.builder()

      Parameters:
      listPermissionVersionsRequest - A Consumer that will call methods on ListPermissionVersionsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissions

      default CompletableFuture<ListPermissionsResponse> listPermissions(ListPermissionsRequest listPermissionsRequest)

      Retrieves a list of available RAM permissions that you can use for the supported resource types.

      Parameters:
      listPermissionsRequest -
      Returns:
      A Java Future containing the result of the ListPermissions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissions

      default CompletableFuture<ListPermissionsResponse> listPermissions(Consumer<ListPermissionsRequest.Builder> listPermissionsRequest)

      Retrieves a list of available RAM permissions that you can use for the supported resource types.


      This is a convenience which creates an instance of the ListPermissionsRequest.Builder avoiding the need to create one manually via ListPermissionsRequest.builder()

      Parameters:
      listPermissionsRequest - A Consumer that will call methods on ListPermissionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListPermissions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionsPaginator

      default ListPermissionsPublisher listPermissionsPaginator(ListPermissionsRequest listPermissionsRequest)

      This is a variant of listPermissions(software.amazon.awssdk.services.ram.model.ListPermissionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionsPublisher publisher = client.listPermissionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionsPublisher publisher = client.listPermissionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPermissionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPermissionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPermissions(software.amazon.awssdk.services.ram.model.ListPermissionsRequest) operation.

      Parameters:
      listPermissionsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionsPaginator

      default ListPermissionsPublisher listPermissionsPaginator(Consumer<ListPermissionsRequest.Builder> listPermissionsRequest)

      This is a variant of listPermissions(software.amazon.awssdk.services.ram.model.ListPermissionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionsPublisher publisher = client.listPermissionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPermissionsPublisher publisher = client.listPermissionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPermissionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPermissionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPermissions(software.amazon.awssdk.services.ram.model.ListPermissionsRequest) operation.


      This is a convenience which creates an instance of the ListPermissionsRequest.Builder avoiding the need to create one manually via ListPermissionsRequest.builder()

      Parameters:
      listPermissionsRequest - A Consumer that will call methods on ListPermissionsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPrincipals

      default CompletableFuture<ListPrincipalsResponse> listPrincipals(ListPrincipalsRequest listPrincipalsRequest)

      Lists the principals that you are sharing resources with or that are sharing resources with you.

      Parameters:
      listPrincipalsRequest -
      Returns:
      A Java Future containing the result of the ListPrincipals operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPrincipals

      default CompletableFuture<ListPrincipalsResponse> listPrincipals(Consumer<ListPrincipalsRequest.Builder> listPrincipalsRequest)

      Lists the principals that you are sharing resources with or that are sharing resources with you.


      This is a convenience which creates an instance of the ListPrincipalsRequest.Builder avoiding the need to create one manually via ListPrincipalsRequest.builder()

      Parameters:
      listPrincipalsRequest - A Consumer that will call methods on ListPrincipalsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListPrincipals operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPrincipalsPaginator

      default ListPrincipalsPublisher listPrincipalsPaginator(ListPrincipalsRequest listPrincipalsRequest)

      This is a variant of listPrincipals(software.amazon.awssdk.services.ram.model.ListPrincipalsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPrincipalsPublisher publisher = client.listPrincipalsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPrincipalsPublisher publisher = client.listPrincipalsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPrincipalsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPrincipalsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPrincipals(software.amazon.awssdk.services.ram.model.ListPrincipalsRequest) operation.

      Parameters:
      listPrincipalsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPrincipalsPaginator

      default ListPrincipalsPublisher listPrincipalsPaginator(Consumer<ListPrincipalsRequest.Builder> listPrincipalsRequest)

      This is a variant of listPrincipals(software.amazon.awssdk.services.ram.model.ListPrincipalsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListPrincipalsPublisher publisher = client.listPrincipalsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListPrincipalsPublisher publisher = client.listPrincipalsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListPrincipalsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListPrincipalsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPrincipals(software.amazon.awssdk.services.ram.model.ListPrincipalsRequest) operation.


      This is a convenience which creates an instance of the ListPrincipalsRequest.Builder avoiding the need to create one manually via ListPrincipalsRequest.builder()

      Parameters:
      listPrincipalsRequest - A Consumer that will call methods on ListPrincipalsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listReplacePermissionAssociationsWork

      default CompletableFuture<ListReplacePermissionAssociationsWorkResponse> listReplacePermissionAssociationsWork(ListReplacePermissionAssociationsWorkRequest listReplacePermissionAssociationsWorkRequest)

      Retrieves the current status of the asynchronous tasks performed by RAM when you perform the ReplacePermissionAssociationsWork operation.

      Parameters:
      listReplacePermissionAssociationsWorkRequest -
      Returns:
      A Java Future containing the result of the ListReplacePermissionAssociationsWork operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listReplacePermissionAssociationsWork

      default CompletableFuture<ListReplacePermissionAssociationsWorkResponse> listReplacePermissionAssociationsWork(Consumer<ListReplacePermissionAssociationsWorkRequest.Builder> listReplacePermissionAssociationsWorkRequest)

      Retrieves the current status of the asynchronous tasks performed by RAM when you perform the ReplacePermissionAssociationsWork operation.


      This is a convenience which creates an instance of the ListReplacePermissionAssociationsWorkRequest.Builder avoiding the need to create one manually via ListReplacePermissionAssociationsWorkRequest.builder()

      Parameters:
      listReplacePermissionAssociationsWorkRequest - A Consumer that will call methods on ListReplacePermissionAssociationsWorkRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListReplacePermissionAssociationsWork operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listReplacePermissionAssociationsWorkPaginator

      default ListReplacePermissionAssociationsWorkPublisher listReplacePermissionAssociationsWorkPaginator(ListReplacePermissionAssociationsWorkRequest listReplacePermissionAssociationsWorkRequest)

      This is a variant of listReplacePermissionAssociationsWork(software.amazon.awssdk.services.ram.model.ListReplacePermissionAssociationsWorkRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListReplacePermissionAssociationsWorkPublisher publisher = client.listReplacePermissionAssociationsWorkPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListReplacePermissionAssociationsWorkPublisher publisher = client.listReplacePermissionAssociationsWorkPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListReplacePermissionAssociationsWorkResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListReplacePermissionAssociationsWorkResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listReplacePermissionAssociationsWork(software.amazon.awssdk.services.ram.model.ListReplacePermissionAssociationsWorkRequest) operation.

      Parameters:
      listReplacePermissionAssociationsWorkRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listReplacePermissionAssociationsWorkPaginator

      default ListReplacePermissionAssociationsWorkPublisher listReplacePermissionAssociationsWorkPaginator(Consumer<ListReplacePermissionAssociationsWorkRequest.Builder> listReplacePermissionAssociationsWorkRequest)

      This is a variant of listReplacePermissionAssociationsWork(software.amazon.awssdk.services.ram.model.ListReplacePermissionAssociationsWorkRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListReplacePermissionAssociationsWorkPublisher publisher = client.listReplacePermissionAssociationsWorkPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListReplacePermissionAssociationsWorkPublisher publisher = client.listReplacePermissionAssociationsWorkPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListReplacePermissionAssociationsWorkResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListReplacePermissionAssociationsWorkResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listReplacePermissionAssociationsWork(software.amazon.awssdk.services.ram.model.ListReplacePermissionAssociationsWorkRequest) operation.


      This is a convenience which creates an instance of the ListReplacePermissionAssociationsWorkRequest.Builder avoiding the need to create one manually via ListReplacePermissionAssociationsWorkRequest.builder()

      Parameters:
      listReplacePermissionAssociationsWorkRequest - A Consumer that will call methods on ListReplacePermissionAssociationsWorkRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourceSharePermissions

      default CompletableFuture<ListResourceSharePermissionsResponse> listResourceSharePermissions(ListResourceSharePermissionsRequest listResourceSharePermissionsRequest)

      Lists the RAM permissions that are associated with a resource share.

      Parameters:
      listResourceSharePermissionsRequest -
      Returns:
      A Java Future containing the result of the ListResourceSharePermissions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourceSharePermissions

      default CompletableFuture<ListResourceSharePermissionsResponse> listResourceSharePermissions(Consumer<ListResourceSharePermissionsRequest.Builder> listResourceSharePermissionsRequest)

      Lists the RAM permissions that are associated with a resource share.


      This is a convenience which creates an instance of the ListResourceSharePermissionsRequest.Builder avoiding the need to create one manually via ListResourceSharePermissionsRequest.builder()

      Parameters:
      listResourceSharePermissionsRequest - A Consumer that will call methods on ListResourceSharePermissionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListResourceSharePermissions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourceSharePermissionsPaginator

      default ListResourceSharePermissionsPublisher listResourceSharePermissionsPaginator(ListResourceSharePermissionsRequest listResourceSharePermissionsRequest)

      This is a variant of listResourceSharePermissions(software.amazon.awssdk.services.ram.model.ListResourceSharePermissionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListResourceSharePermissionsPublisher publisher = client.listResourceSharePermissionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListResourceSharePermissionsPublisher publisher = client.listResourceSharePermissionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListResourceSharePermissionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListResourceSharePermissionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listResourceSharePermissions(software.amazon.awssdk.services.ram.model.ListResourceSharePermissionsRequest) operation.

      Parameters:
      listResourceSharePermissionsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourceSharePermissionsPaginator

      default ListResourceSharePermissionsPublisher listResourceSharePermissionsPaginator(Consumer<ListResourceSharePermissionsRequest.Builder> listResourceSharePermissionsRequest)

      This is a variant of listResourceSharePermissions(software.amazon.awssdk.services.ram.model.ListResourceSharePermissionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListResourceSharePermissionsPublisher publisher = client.listResourceSharePermissionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListResourceSharePermissionsPublisher publisher = client.listResourceSharePermissionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListResourceSharePermissionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListResourceSharePermissionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listResourceSharePermissions(software.amazon.awssdk.services.ram.model.ListResourceSharePermissionsRequest) operation.


      This is a convenience which creates an instance of the ListResourceSharePermissionsRequest.Builder avoiding the need to create one manually via ListResourceSharePermissionsRequest.builder()

      Parameters:
      listResourceSharePermissionsRequest - A Consumer that will call methods on ListResourceSharePermissionsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourceTypes

      default CompletableFuture<ListResourceTypesResponse> listResourceTypes(ListResourceTypesRequest listResourceTypesRequest)

      Lists the resource types that can be shared by RAM.

      Parameters:
      listResourceTypesRequest -
      Returns:
      A Java Future containing the result of the ListResourceTypes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourceTypes

      default CompletableFuture<ListResourceTypesResponse> listResourceTypes(Consumer<ListResourceTypesRequest.Builder> listResourceTypesRequest)

      Lists the resource types that can be shared by RAM.


      This is a convenience which creates an instance of the ListResourceTypesRequest.Builder avoiding the need to create one manually via ListResourceTypesRequest.builder()

      Parameters:
      listResourceTypesRequest - A Consumer that will call methods on ListResourceTypesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListResourceTypes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourceTypesPaginator

      default ListResourceTypesPublisher listResourceTypesPaginator(ListResourceTypesRequest listResourceTypesRequest)

      This is a variant of listResourceTypes(software.amazon.awssdk.services.ram.model.ListResourceTypesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListResourceTypesPublisher publisher = client.listResourceTypesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListResourceTypesPublisher publisher = client.listResourceTypesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListResourceTypesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListResourceTypesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listResourceTypes(software.amazon.awssdk.services.ram.model.ListResourceTypesRequest) operation.

      Parameters:
      listResourceTypesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourceTypesPaginator

      default ListResourceTypesPublisher listResourceTypesPaginator(Consumer<ListResourceTypesRequest.Builder> listResourceTypesRequest)

      This is a variant of listResourceTypes(software.amazon.awssdk.services.ram.model.ListResourceTypesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListResourceTypesPublisher publisher = client.listResourceTypesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListResourceTypesPublisher publisher = client.listResourceTypesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListResourceTypesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListResourceTypesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listResourceTypes(software.amazon.awssdk.services.ram.model.ListResourceTypesRequest) operation.


      This is a convenience which creates an instance of the ListResourceTypesRequest.Builder avoiding the need to create one manually via ListResourceTypesRequest.builder()

      Parameters:
      listResourceTypesRequest - A Consumer that will call methods on ListResourceTypesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResources

      default CompletableFuture<ListResourcesResponse> listResources(ListResourcesRequest listResourcesRequest)

      Lists the resources that you added to a resource share or the resources that are shared with you.

      Parameters:
      listResourcesRequest -
      Returns:
      A Java Future containing the result of the ListResources operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidResourceTypeException The operation failed because the specified resource type isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResources

      default CompletableFuture<ListResourcesResponse> listResources(Consumer<ListResourcesRequest.Builder> listResourcesRequest)

      Lists the resources that you added to a resource share or the resources that are shared with you.


      This is a convenience which creates an instance of the ListResourcesRequest.Builder avoiding the need to create one manually via ListResourcesRequest.builder()

      Parameters:
      listResourcesRequest - A Consumer that will call methods on ListResourcesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListResources operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidResourceTypeException The operation failed because the specified resource type isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourcesPaginator

      default ListResourcesPublisher listResourcesPaginator(ListResourcesRequest listResourcesRequest)

      This is a variant of listResources(software.amazon.awssdk.services.ram.model.ListResourcesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListResourcesPublisher publisher = client.listResourcesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListResourcesPublisher publisher = client.listResourcesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListResourcesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListResourcesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listResources(software.amazon.awssdk.services.ram.model.ListResourcesRequest) operation.

      Parameters:
      listResourcesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidResourceTypeException The operation failed because the specified resource type isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listResourcesPaginator

      default ListResourcesPublisher listResourcesPaginator(Consumer<ListResourcesRequest.Builder> listResourcesRequest)

      This is a variant of listResources(software.amazon.awssdk.services.ram.model.ListResourcesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.ram.paginators.ListResourcesPublisher publisher = client.listResourcesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.ram.paginators.ListResourcesPublisher publisher = client.listResourcesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.ram.model.ListResourcesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.ram.model.ListResourcesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listResources(software.amazon.awssdk.services.ram.model.ListResourcesRequest) operation.


      This is a convenience which creates an instance of the ListResourcesRequest.Builder avoiding the need to create one manually via ListResourcesRequest.builder()

      Parameters:
      listResourcesRequest - A Consumer that will call methods on ListResourcesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidResourceTypeException The operation failed because the specified resource type isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidNextTokenException The operation failed because the specified value for NextToken isn't valid. You must specify a value you received in the NextToken response of a previous call to this operation.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • promotePermissionCreatedFromPolicy

      default CompletableFuture<PromotePermissionCreatedFromPolicyResponse> promotePermissionCreatedFromPolicy(PromotePermissionCreatedFromPolicyRequest promotePermissionCreatedFromPolicyRequest)

      When you attach a resource-based policy to a resource, RAM automatically creates a resource share of featureSet=CREATED_FROM_POLICY with a managed permission that has the same IAM permissions as the original resource-based policy. However, this type of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by using RAM.

      This operation creates a separate, fully manageable customer managed permission that has the same IAM permissions as the original resource-based policy. You can associate this customer managed permission to any resource shares.

      Before you use PromoteResourceShareCreatedFromPolicy, you should first run this operation to ensure that you have an appropriate customer managed permission that can be associated with the promoted resource share.

      • The original CREATED_FROM_POLICY policy isn't deleted, and resource shares using that original policy aren't automatically updated.

      • You can't modify a CREATED_FROM_POLICY resource share so you can't associate the new customer managed permission by using ReplacePermsissionAssociations. However, if you use PromoteResourceShareCreatedFromPolicy, that operation automatically associates the fully manageable customer managed permission to the newly promoted STANDARD resource share.

      • After you promote a resource share, if the original CREATED_FROM_POLICY managed permission has no other associations to A resource share, then RAM automatically deletes it.

      Parameters:
      promotePermissionCreatedFromPolicyRequest -
      Returns:
      A Java Future containing the result of the PromotePermissionCreatedFromPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • promotePermissionCreatedFromPolicy

      default CompletableFuture<PromotePermissionCreatedFromPolicyResponse> promotePermissionCreatedFromPolicy(Consumer<PromotePermissionCreatedFromPolicyRequest.Builder> promotePermissionCreatedFromPolicyRequest)

      When you attach a resource-based policy to a resource, RAM automatically creates a resource share of featureSet=CREATED_FROM_POLICY with a managed permission that has the same IAM permissions as the original resource-based policy. However, this type of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by using RAM.

      This operation creates a separate, fully manageable customer managed permission that has the same IAM permissions as the original resource-based policy. You can associate this customer managed permission to any resource shares.

      Before you use PromoteResourceShareCreatedFromPolicy, you should first run this operation to ensure that you have an appropriate customer managed permission that can be associated with the promoted resource share.

      • The original CREATED_FROM_POLICY policy isn't deleted, and resource shares using that original policy aren't automatically updated.

      • You can't modify a CREATED_FROM_POLICY resource share so you can't associate the new customer managed permission by using ReplacePermsissionAssociations. However, if you use PromoteResourceShareCreatedFromPolicy, that operation automatically associates the fully manageable customer managed permission to the newly promoted STANDARD resource share.

      • After you promote a resource share, if the original CREATED_FROM_POLICY managed permission has no other associations to A resource share, then RAM automatically deletes it.


      This is a convenience which creates an instance of the PromotePermissionCreatedFromPolicyRequest.Builder avoiding the need to create one manually via PromotePermissionCreatedFromPolicyRequest.builder()

      Parameters:
      promotePermissionCreatedFromPolicyRequest - A Consumer that will call methods on PromotePermissionCreatedFromPolicyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PromotePermissionCreatedFromPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • promoteResourceShareCreatedFromPolicy

      default CompletableFuture<PromoteResourceShareCreatedFromPolicyResponse> promoteResourceShareCreatedFromPolicy(PromoteResourceShareCreatedFromPolicyRequest promoteResourceShareCreatedFromPolicyRequest)

      When you attach a resource-based policy to a resource, RAM automatically creates a resource share of featureSet=CREATED_FROM_POLICY with a managed permission that has the same IAM permissions as the original resource-based policy. However, this type of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by using RAM.

      This operation promotes the resource share to a STANDARD resource share that is fully manageable in RAM. When you promote a resource share, you can then manage the resource share in RAM and it becomes visible to all of the principals you shared it with.

      Before you perform this operation, you should first run PromotePermissionCreatedFromPolicyto ensure that you have an appropriate customer managed permission that can be associated with this resource share after its is promoted. If this operation can't find a managed permission that exactly matches the existing CREATED_FROM_POLICY permission, then this operation fails.

      Parameters:
      promoteResourceShareCreatedFromPolicyRequest -
      Returns:
      A Java Future containing the result of the PromoteResourceShareCreatedFromPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • ResourceShareLimitExceededException The operation failed because it would exceed the limit for resource shares for your account. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • UnmatchedPolicyPermissionException There isn't an existing managed permission defined in RAM that has the same IAM permissions as the resource-based policy attached to the resource. You should first run PromotePermissionCreatedFromPolicy to create that managed permission.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • promoteResourceShareCreatedFromPolicy

      default CompletableFuture<PromoteResourceShareCreatedFromPolicyResponse> promoteResourceShareCreatedFromPolicy(Consumer<PromoteResourceShareCreatedFromPolicyRequest.Builder> promoteResourceShareCreatedFromPolicyRequest)

      When you attach a resource-based policy to a resource, RAM automatically creates a resource share of featureSet=CREATED_FROM_POLICY with a managed permission that has the same IAM permissions as the original resource-based policy. However, this type of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by using RAM.

      This operation promotes the resource share to a STANDARD resource share that is fully manageable in RAM. When you promote a resource share, you can then manage the resource share in RAM and it becomes visible to all of the principals you shared it with.

      Before you perform this operation, you should first run PromotePermissionCreatedFromPolicyto ensure that you have an appropriate customer managed permission that can be associated with this resource share after its is promoted. If this operation can't find a managed permission that exactly matches the existing CREATED_FROM_POLICY permission, then this operation fails.


      This is a convenience which creates an instance of the PromoteResourceShareCreatedFromPolicyRequest.Builder avoiding the need to create one manually via PromoteResourceShareCreatedFromPolicyRequest.builder()

      Parameters:
      promoteResourceShareCreatedFromPolicyRequest - A Consumer that will call methods on PromoteResourceShareCreatedFromPolicyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PromoteResourceShareCreatedFromPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • ResourceShareLimitExceededException The operation failed because it would exceed the limit for resource shares for your account. To view the limits for your Amazon Web Services account, see the RAM page in the Service Quotas console.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidStateTransitionException The operation failed because the requested operation isn't valid for the resource share in its current state.
      • UnmatchedPolicyPermissionException There isn't an existing managed permission defined in RAM that has the same IAM permissions as the resource-based policy attached to the resource. You should first run PromotePermissionCreatedFromPolicy to create that managed permission.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • rejectResourceShareInvitation

      default CompletableFuture<RejectResourceShareInvitationResponse> rejectResourceShareInvitation(RejectResourceShareInvitationRequest rejectResourceShareInvitationRequest)

      Rejects an invitation to a resource share from another Amazon Web Services account.

      Parameters:
      rejectResourceShareInvitationRequest -
      Returns:
      A Java Future containing the result of the RejectResourceShareInvitation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • ResourceShareInvitationAlreadyAcceptedException The operation failed because the specified invitation was already accepted.
      • ResourceShareInvitationAlreadyRejectedException The operation failed because the specified invitation was already rejected.
      • ResourceShareInvitationExpiredException The operation failed because the specified invitation is past its expiration date and time.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • rejectResourceShareInvitation

      default CompletableFuture<RejectResourceShareInvitationResponse> rejectResourceShareInvitation(Consumer<RejectResourceShareInvitationRequest.Builder> rejectResourceShareInvitationRequest)

      Rejects an invitation to a resource share from another Amazon Web Services account.


      This is a convenience which creates an instance of the RejectResourceShareInvitationRequest.Builder avoiding the need to create one manually via RejectResourceShareInvitationRequest.builder()

      Parameters:
      rejectResourceShareInvitationRequest - A Consumer that will call methods on RejectResourceShareInvitationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the RejectResourceShareInvitation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ResourceShareInvitationArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) for an invitation was not found.
      • ResourceShareInvitationAlreadyAcceptedException The operation failed because the specified invitation was already accepted.
      • ResourceShareInvitationAlreadyRejectedException The operation failed because the specified invitation was already rejected.
      • ResourceShareInvitationExpiredException The operation failed because the specified invitation is past its expiration date and time.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • replacePermissionAssociations

      default CompletableFuture<ReplacePermissionAssociationsResponse> replacePermissionAssociations(ReplacePermissionAssociationsRequest replacePermissionAssociationsRequest)

      Updates all resource shares that use a managed permission to a different managed permission. This operation always applies the default version of the target managed permission. You can optionally specify that the update applies to only resource shares that currently use a specified version. This enables you to update to the latest version, without changing the which managed permission is used.

      You can use this operation to update all of your resource shares to use the current default version of the permission by specifying the same value for the fromPermissionArn and toPermissionArn parameters.

      You can use the optional fromPermissionVersion parameter to update only those resources that use a specified version of the managed permission to the new managed permission.

      To successfully perform this operation, you must have permission to update the resource-based policy on all affected resource types.

      Parameters:
      replacePermissionAssociationsRequest -
      Returns:
      A Java Future containing the result of the ReplacePermissionAssociations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • replacePermissionAssociations

      default CompletableFuture<ReplacePermissionAssociationsResponse> replacePermissionAssociations(Consumer<ReplacePermissionAssociationsRequest.Builder> replacePermissionAssociationsRequest)

      Updates all resource shares that use a managed permission to a different managed permission. This operation always applies the default version of the target managed permission. You can optionally specify that the update applies to only resource shares that currently use a specified version. This enables you to update to the latest version, without changing the which managed permission is used.

      You can use this operation to update all of your resource shares to use the current default version of the permission by specifying the same value for the fromPermissionArn and toPermissionArn parameters.

      You can use the optional fromPermissionVersion parameter to update only those resources that use a specified version of the managed permission to the new managed permission.

      To successfully perform this operation, you must have permission to update the resource-based policy on all affected resource types.


      This is a convenience which creates an instance of the ReplacePermissionAssociationsRequest.Builder avoiding the need to create one manually via ReplacePermissionAssociationsRequest.builder()

      Parameters:
      replacePermissionAssociationsRequest - A Consumer that will call methods on ReplacePermissionAssociationsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ReplacePermissionAssociations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • setDefaultPermissionVersion

      default CompletableFuture<SetDefaultPermissionVersionResponse> setDefaultPermissionVersion(SetDefaultPermissionVersionRequest setDefaultPermissionVersionRequest)

      Designates the specified version number as the default version for the specified customer managed permission. New resource shares automatically use this new default permission. Existing resource shares continue to use their original permission version, but you can use ReplacePermissionAssociations to update them.

      Parameters:
      setDefaultPermissionVersionRequest -
      Returns:
      A Java Future containing the result of the SetDefaultPermissionVersion operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • setDefaultPermissionVersion

      default CompletableFuture<SetDefaultPermissionVersionResponse> setDefaultPermissionVersion(Consumer<SetDefaultPermissionVersionRequest.Builder> setDefaultPermissionVersionRequest)

      Designates the specified version number as the default version for the specified customer managed permission. New resource shares automatically use this new default permission. Existing resource shares continue to use their original permission version, but you can use ReplacePermissionAssociations to update them.


      This is a convenience which creates an instance of the SetDefaultPermissionVersionRequest.Builder avoiding the need to create one manually via SetDefaultPermissionVersionRequest.builder()

      Parameters:
      setDefaultPermissionVersionRequest - A Consumer that will call methods on SetDefaultPermissionVersionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the SetDefaultPermissionVersion operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest)

      Adds the specified tag keys and values to a resource share or managed permission. If you choose a resource share, the tags are attached to only the resource share, not to the resources that are in the resource share.

      The tags on a managed permission are the same for all versions of the managed permission.

      Parameters:
      tagResourceRequest -
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • TagLimitExceededException The operation failed because it would exceed the limit for tags for your Amazon Web Services account.
      • ResourceArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) was not found.
      • TagPolicyViolationException The operation failed because the specified tag key is a reserved word and can't be used.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)

      Adds the specified tag keys and values to a resource share or managed permission. If you choose a resource share, the tags are attached to only the resource share, not to the resources that are in the resource share.

      The tags on a managed permission are the same for all versions of the managed permission.


      This is a convenience which creates an instance of the TagResourceRequest.Builder avoiding the need to create one manually via TagResourceRequest.builder()

      Parameters:
      tagResourceRequest - A Consumer that will call methods on TagResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • TagLimitExceededException The operation failed because it would exceed the limit for tags for your Amazon Web Services account.
      • ResourceArnNotFoundException The operation failed because the specified Amazon Resource Name (ARN) was not found.
      • TagPolicyViolationException The operation failed because the specified tag key is a reserved word and can't be used.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest)

      Removes the specified tag key and value pairs from the specified resource share or managed permission.

      Parameters:
      untagResourceRequest -
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)

      Removes the specified tag key and value pairs from the specified resource share or managed permission.


      This is a convenience which creates an instance of the UntagResourceRequest.Builder avoiding the need to create one manually via UntagResourceRequest.builder()

      Parameters:
      untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateResourceShare

      default CompletableFuture<UpdateResourceShareResponse> updateResourceShare(UpdateResourceShareRequest updateResourceShareRequest)

      Modifies some of the properties of the specified resource share.

      Parameters:
      updateResourceShareRequest -
      Returns:
      A Java Future containing the result of the UpdateResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateResourceShare

      default CompletableFuture<UpdateResourceShareResponse> updateResourceShare(Consumer<UpdateResourceShareRequest.Builder> updateResourceShareRequest)

      Modifies some of the properties of the specified resource share.


      This is a convenience which creates an instance of the UpdateResourceShareRequest.Builder avoiding the need to create one manually via UpdateResourceShareRequest.builder()

      Parameters:
      updateResourceShareRequest - A Consumer that will call methods on UpdateResourceShareRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateResourceShare operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • IdempotentParameterMismatchException The operation failed because the client token input parameter matched one that was used with a previous call to the operation, but at least one of the other input parameters is different from the previous call.
      • MissingRequiredParameterException The operation failed because a required input parameter is missing.
      • UnknownResourceException The operation failed because a specified resource couldn't be found.
      • MalformedArnException The operation failed because the specified Amazon Resource Name (ARN) has a format that isn't valid.
      • InvalidClientTokenException The operation failed because the specified client token isn't valid.
      • InvalidParameterException The operation failed because a parameter you specified isn't valid.
      • OperationNotPermittedException The operation failed because the requested operation isn't permitted.
      • ServerInternalException The operation failed because the service could not respond to the request due to an internal problem. Try again later.
      • ServiceUnavailableException The operation failed because the service isn't available. Try again later.
      • 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.
      • RamException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • serviceClientConfiguration

      default RamServiceClientConfiguration serviceClientConfiguration()
      Description copied from interface: SdkClient
      The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
      Specified by:
      serviceClientConfiguration in interface AwsClient
      Specified by:
      serviceClientConfiguration in interface SdkClient
      Returns:
      SdkServiceClientConfiguration

    • create

      static RamAsyncClient create()
      Create a RamAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

    • builder

      static RamAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a RamAsyncClient.