/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.ram; import javax.annotation.Generated; import com.amazonaws.services.ram.model.*; /** * Interface for accessing RAM asynchronously. Each asynchronous method will return a Java Future object representing * the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive notification when * an asynchronous operation completes. *
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.ram.AbstractAWSRAMAsync} instead. *
**
* 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: *
** 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. *
* * @param acceptResourceShareInvitationRequest * @return A Java Future containing the result of the AcceptResourceShareInvitation operation returned by the * service. * @sample AWSRAMAsync.AcceptResourceShareInvitation * @see AWS API Documentation */ java.util.concurrent.Future* 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. *
* * @param acceptResourceShareInvitationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the AcceptResourceShareInvitation operation returned by the * service. * @sample AWSRAMAsyncHandler.AcceptResourceShareInvitation * @see AWS API Documentation */ java.util.concurrent.Future* 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. *
* * @param associateResourceShareRequest * @return A Java Future containing the result of the AssociateResourceShare operation returned by the service. * @sample AWSRAMAsync.AssociateResourceShare * @see AWS API * Documentation */ java.util.concurrent.Future* 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. *
* * @param associateResourceShareRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the AssociateResourceShare operation returned by the service. * @sample AWSRAMAsyncHandler.AssociateResourceShare * @see AWS API * Documentation */ java.util.concurrent.Future* 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. *
* * @param associateResourceSharePermissionRequest * @return A Java Future containing the result of the AssociateResourceSharePermission operation returned by the * service. * @sample AWSRAMAsync.AssociateResourceSharePermission * @see AWS API Documentation */ java.util.concurrent.Future* 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. *
* * @param associateResourceSharePermissionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the AssociateResourceSharePermission operation returned by the * service. * @sample AWSRAMAsyncHandler.AssociateResourceSharePermission * @see AWS API Documentation */ java.util.concurrent.Future* 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. *
* * @param createPermissionRequest * @return A Java Future containing the result of the CreatePermission operation returned by the service. * @sample AWSRAMAsync.CreatePermission * @see AWS API * Documentation */ java.util.concurrent.Future* 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. *
* * @param createPermissionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreatePermission operation returned by the service. * @sample AWSRAMAsyncHandler.CreatePermission * @see AWS API * Documentation */ java.util.concurrent.Future* 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. *
* * @param createPermissionVersionRequest * @return A Java Future containing the result of the CreatePermissionVersion operation returned by the service. * @sample AWSRAMAsync.CreatePermissionVersion * @see AWS * API Documentation */ java.util.concurrent.Future* 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. *
* * @param createPermissionVersionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreatePermissionVersion operation returned by the service. * @sample AWSRAMAsyncHandler.CreatePermissionVersion * @see AWS * API Documentation */ java.util.concurrent.Future* 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. *
** 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. *
** 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. *
* * @param deletePermissionRequest * @return A Java Future containing the result of the DeletePermission operation returned by the service. * @sample AWSRAMAsync.DeletePermission * @see AWS API * Documentation */ java.util.concurrent.Future* 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. *
* * @param deletePermissionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeletePermission operation returned by the service. * @sample AWSRAMAsyncHandler.DeletePermission * @see AWS API * Documentation */ java.util.concurrent.Future* 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. *
* * @param deletePermissionVersionRequest * @return A Java Future containing the result of the DeletePermissionVersion operation returned by the service. * @sample AWSRAMAsync.DeletePermissionVersion * @see AWS * API Documentation */ java.util.concurrent.Future* 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. *
* * @param deletePermissionVersionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeletePermissionVersion operation returned by the service. * @sample AWSRAMAsyncHandler.DeletePermissionVersion * @see AWS * API Documentation */ java.util.concurrent.Future* 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. *
** 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. *
** Removes the specified principals or resources from participating in the specified resource share. *
* * @param disassociateResourceShareRequest * @return A Java Future containing the result of the DisassociateResourceShare operation returned by the service. * @sample AWSRAMAsync.DisassociateResourceShare * @see AWS * API Documentation */ java.util.concurrent.Future* Removes the specified principals or resources from participating in the specified resource share. *
* * @param disassociateResourceShareRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisassociateResourceShare operation returned by the service. * @sample AWSRAMAsyncHandler.DisassociateResourceShare * @see AWS * API Documentation */ java.util.concurrent.Future* 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. *
* * @param disassociateResourceSharePermissionRequest * @return A Java Future containing the result of the DisassociateResourceSharePermission operation returned by the * service. * @sample AWSRAMAsync.DisassociateResourceSharePermission * @see AWS API Documentation */ java.util.concurrent.Future* 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. *
* * @param disassociateResourceSharePermissionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisassociateResourceSharePermission operation returned by the * service. * @sample AWSRAMAsyncHandler.DisassociateResourceSharePermission * @see AWS API Documentation */ java.util.concurrent.Future
* 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. *
* * * @param enableSharingWithAwsOrganizationRequest * @return A Java Future containing the result of the EnableSharingWithAwsOrganization operation returned by the * service. * @sample AWSRAMAsync.EnableSharingWithAwsOrganization * @see AWS API Documentation */ java.util.concurrent.Future
* 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. *
* * * @param enableSharingWithAwsOrganizationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the EnableSharingWithAwsOrganization operation returned by the * service. * @sample AWSRAMAsyncHandler.EnableSharingWithAwsOrganization * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves the contents of a managed permission in JSON format. *
* * @param getPermissionRequest * @return A Java Future containing the result of the GetPermission operation returned by the service. * @sample AWSRAMAsync.GetPermission * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the contents of a managed permission in JSON format. *
* * @param getPermissionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetPermission operation returned by the service. * @sample AWSRAMAsyncHandler.GetPermission * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the resource policies for the specified resources that you own and have shared. *
* * @param getResourcePoliciesRequest * @return A Java Future containing the result of the GetResourcePolicies operation returned by the service. * @sample AWSRAMAsync.GetResourcePolicies * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the resource policies for the specified resources that you own and have shared. *
* * @param getResourcePoliciesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetResourcePolicies operation returned by the service. * @sample AWSRAMAsyncHandler.GetResourcePolicies * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the lists of resources and principals that associated for resource shares that you own. *
* * @param getResourceShareAssociationsRequest * @return A Java Future containing the result of the GetResourceShareAssociations operation returned by the * service. * @sample AWSRAMAsync.GetResourceShareAssociations * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves the lists of resources and principals that associated for resource shares that you own. *
* * @param getResourceShareAssociationsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetResourceShareAssociations operation returned by the * service. * @sample AWSRAMAsyncHandler.GetResourceShareAssociations * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves details about invitations that you have received for resource shares. *
* * @param getResourceShareInvitationsRequest * @return A Java Future containing the result of the GetResourceShareInvitations operation returned by the service. * @sample AWSRAMAsync.GetResourceShareInvitations * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves details about invitations that you have received for resource shares. *
* * @param getResourceShareInvitationsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetResourceShareInvitations operation returned by the service. * @sample AWSRAMAsyncHandler.GetResourceShareInvitations * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves details about the resource shares that you own or that are shared with you. *
* * @param getResourceSharesRequest * @return A Java Future containing the result of the GetResourceShares operation returned by the service. * @sample AWSRAMAsync.GetResourceShares * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves details about the resource shares that you own or that are shared with you. *
* * @param getResourceSharesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetResourceShares operation returned by the service. * @sample AWSRAMAsyncHandler.GetResourceShares * @see AWS API * Documentation */ java.util.concurrent.Future
* 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.
*
* 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.
*
* 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. *
* * @param listPermissionAssociationsRequest * @return A Java Future containing the result of the ListPermissionAssociations operation returned by the service. * @sample AWSRAMAsync.ListPermissionAssociations * @see AWS * API Documentation */ java.util.concurrent.Future* 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. *
* * @param listPermissionAssociationsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListPermissionAssociations operation returned by the service. * @sample AWSRAMAsyncHandler.ListPermissionAssociations * @see AWS * API Documentation */ java.util.concurrent.Future* Lists the available versions of the specified RAM permission. *
* * @param listPermissionVersionsRequest * @return A Java Future containing the result of the ListPermissionVersions operation returned by the service. * @sample AWSRAMAsync.ListPermissionVersions * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the available versions of the specified RAM permission. *
* * @param listPermissionVersionsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListPermissionVersions operation returned by the service. * @sample AWSRAMAsyncHandler.ListPermissionVersions * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves a list of available RAM permissions that you can use for the supported resource types. *
* * @param listPermissionsRequest * @return A Java Future containing the result of the ListPermissions operation returned by the service. * @sample AWSRAMAsync.ListPermissions * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves a list of available RAM permissions that you can use for the supported resource types. *
* * @param listPermissionsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListPermissions operation returned by the service. * @sample AWSRAMAsyncHandler.ListPermissions * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the principals that you are sharing resources with or that are sharing resources with you. *
* * @param listPrincipalsRequest * @return A Java Future containing the result of the ListPrincipals operation returned by the service. * @sample AWSRAMAsync.ListPrincipals * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the principals that you are sharing resources with or that are sharing resources with you. *
* * @param listPrincipalsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListPrincipals operation returned by the service. * @sample AWSRAMAsyncHandler.ListPrincipals * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the current status of the asynchronous tasks performed by RAM when you perform the * ReplacePermissionAssociationsWork operation. *
* * @param listReplacePermissionAssociationsWorkRequest * @return A Java Future containing the result of the ListReplacePermissionAssociationsWork operation returned by * the service. * @sample AWSRAMAsync.ListReplacePermissionAssociationsWork * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves the current status of the asynchronous tasks performed by RAM when you perform the * ReplacePermissionAssociationsWork operation. *
* * @param listReplacePermissionAssociationsWorkRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListReplacePermissionAssociationsWork operation returned by * the service. * @sample AWSRAMAsyncHandler.ListReplacePermissionAssociationsWork * @see AWS API Documentation */ java.util.concurrent.Future* Lists the RAM permissions that are associated with a resource share. *
* * @param listResourceSharePermissionsRequest * @return A Java Future containing the result of the ListResourceSharePermissions operation returned by the * service. * @sample AWSRAMAsync.ListResourceSharePermissions * @see AWS API Documentation */ java.util.concurrent.Future* Lists the RAM permissions that are associated with a resource share. *
* * @param listResourceSharePermissionsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListResourceSharePermissions operation returned by the * service. * @sample AWSRAMAsyncHandler.ListResourceSharePermissions * @see AWS API Documentation */ java.util.concurrent.Future* Lists the resource types that can be shared by RAM. *
* * @param listResourceTypesRequest * @return A Java Future containing the result of the ListResourceTypes operation returned by the service. * @sample AWSRAMAsync.ListResourceTypes * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the resource types that can be shared by RAM. *
* * @param listResourceTypesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListResourceTypes operation returned by the service. * @sample AWSRAMAsyncHandler.ListResourceTypes * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the resources that you added to a resource share or the resources that are shared with you. *
* * @param listResourcesRequest * @return A Java Future containing the result of the ListResources operation returned by the service. * @sample AWSRAMAsync.ListResources * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the resources that you added to a resource share or the resources that are shared with you. *
* * @param listResourcesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListResources operation returned by the service. * @sample AWSRAMAsyncHandler.ListResources * @see AWS API * Documentation */ java.util.concurrent.Future
* 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.
*
* 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.
*
* 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.
*
* 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.
*
* Rejects an invitation to a resource share from another Amazon Web Services account. *
* * @param rejectResourceShareInvitationRequest * @return A Java Future containing the result of the RejectResourceShareInvitation operation returned by the * service. * @sample AWSRAMAsync.RejectResourceShareInvitation * @see AWS API Documentation */ java.util.concurrent.Future* Rejects an invitation to a resource share from another Amazon Web Services account. *
* * @param rejectResourceShareInvitationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RejectResourceShareInvitation operation returned by the * service. * @sample AWSRAMAsyncHandler.RejectResourceShareInvitation * @see AWS API Documentation */ java.util.concurrent.Future* 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. *
** 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. *
** 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. *
* * @param setDefaultPermissionVersionRequest * @return A Java Future containing the result of the SetDefaultPermissionVersion operation returned by the service. * @sample AWSRAMAsync.SetDefaultPermissionVersion * @see AWS API Documentation */ java.util.concurrent.Future* 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. *
* * @param setDefaultPermissionVersionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the SetDefaultPermissionVersion operation returned by the service. * @sample AWSRAMAsyncHandler.SetDefaultPermissionVersion * @see AWS API Documentation */ java.util.concurrent.Future* 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. *
* * @param tagResourceRequest * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AWSRAMAsync.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* 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. *
* * @param tagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AWSRAMAsyncHandler.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Removes the specified tag key and value pairs from the specified resource share or managed permission. *
* * @param untagResourceRequest * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AWSRAMAsync.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Removes the specified tag key and value pairs from the specified resource share or managed permission. *
* * @param untagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AWSRAMAsyncHandler.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Modifies some of the properties of the specified resource share. *
* * @param updateResourceShareRequest * @return A Java Future containing the result of the UpdateResourceShare operation returned by the service. * @sample AWSRAMAsync.UpdateResourceShare * @see AWS API * Documentation */ java.util.concurrent.Future* Modifies some of the properties of the specified resource share. *
* * @param updateResourceShareRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateResourceShare operation returned by the service. * @sample AWSRAMAsyncHandler.UpdateResourceShare * @see AWS API * Documentation */ java.util.concurrent.Future