EnableAWSOrganizationsAccess
Enable portfolio sharing feature through Amazon Organizations. This API will allow Amazon Service Catalog to receive updates on your organization in order to sync your shares with the current structure. This API can only be called by the management account in the organization.
When you call this API, Service Catalog calls organizations:EnableAWSServiceAccess on your behalf so that your shares stay in sync with any changes in your Amazon Organizations structure.
Note that a delegated administrator is not authorized to invoke EnableAWSOrganizationsAccess.
After this operation returns, Amazon Service Catalog counts the accounts in your organization before it finishes enabling access. Use GetAWSOrganizationsAccessStatus to check the result. The check usually completes within two hours.
-
UNDER_CHANGE- The check is in progress. Wait until the status changes fromUNDER_CHANGEtoENABLEDbefore you share portfolios with organization nodes. -
ENABLED- Amazon Organizations access is enabled. Your organization shares are kept in sync with your organization structure. -
DISABLED- Your organization has more than 15,000 accounts, so access was not enabled. To enable access, reduce the organization to 15,000 accounts or fewer and callEnableAWSOrganizationsAccessagain. Calling it again without reducing the organization repeats the check and returnsDISABLED.
The 15,000-account quota is checked only when you enable access. An organization that grows past 15,000 accounts after access is enabled keeps Amazon Organizations access, and its shares continue to sync. If you then disable access, you cannot enable it again until the organization has 15,000 accounts or fewer. For more information, see Amazon Service Catalog default service quotas in the Amazon Service Catalog Administrator Guide.
If you have previously disabled Organizations access for Service Catalog, and then enable access again, the portfolio access permissions might not sync with the latest changes to the organization structure. Specifically, accounts that you removed from the organization after disabling Service Catalog access, and before you enabled access again, can retain access to the previously shared portfolio. As a result, an account that has been removed from the organization might still be able to create or manage Amazon resources when it is no longer authorized to do so. Amazon is working to resolve this issue.
Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
Errors
- InvalidStateException
-
An attempt was made to modify a resource that is in a state that is not valid. Check your resources to ensure that they are in valid states before retrying the operation.
HTTP Status Code: 400
- OperationNotSupportedException
-
The operation is not supported.
HTTP Status Code: 400
- ResourceNotFoundException
-
The specified resource was not found.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: