Skip to main content

organizations_access

Creates, updates, deletes, gets or lists an organizations_access resource.

Overview

Nameorganizations_access
TypeResource
Idaws.cloudformation.organizations_access

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
line_itemsarray

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_organizations_accessselectregionCallAsRetrieves information about the account's OrganizationAccess status. This API can be called either by the management account or the delegated administrator by using the CallAs parameter. This API can also be called without the CallAs parameter by the management account.
activate_organizations_accessexecregionActivate trusted access with Organizations. With trusted access between StackSets and Organizations activated, the management account has permissions to create and manage StackSets for your organization.
deactivate_organizations_accessexecregionDeactivates trusted access with Organizations. If trusted access is deactivated, the management account does not have permissions to create and manage service-managed StackSets for your organization.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
CallAsstring[Service-managed permissions] Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. By default, SELF is specified. If you are signed in to the management account, specify SELF. If you are signed in to a delegated administrator account, specify DELEGATED_ADMIN. Your Amazon Web Services account must be registered as a delegated administrator in the management account. For more information, see Register a delegated administrator in the CloudFormation User Guide.

SELECT examples

Retrieves information about the account's OrganizationAccess status. This API can be called either by the management account or the delegated administrator by using the CallAs parameter. This API can also be called without the CallAs parameter by the management account.

SELECT
line_items
FROM aws.cloudformation.organizations_access
WHERE region = '{{ region }}' -- required
AND CallAs = '{{ CallAs }}'
;

Lifecycle Methods

Activate trusted access with Organizations. With trusted access between StackSets and Organizations activated, the management account has permissions to create and manage StackSets for your organization.

EXEC aws.cloudformation.organizations_access.activate_organizations_access
@region='{{ region }}' --required
;