organization#

State module for managing Amazon Organizations.

async idem_aws.states.aws.organizations.organization.present(hub, ctx, name: str, feature_set: str) → Dict[str, Any][source]#

Creates an AWS organization.

The account whose user is calling the operation automatically becomes the management account of the new organization. This operation must be called using credentials from the account that is to become the new organization’s management account. The principal must also have the relevant IAM permissions.

Parameters:

  • name (str) – The name of the organization.

  • feature_set (str) –

    Specifies the feature set supported by the new organization. Each feature set supports different levels of functionality.

    • CONSOLIDATED_BILLING: All member accounts have their bills consolidated to and paid by the management account.

    • ALL: In addition to all the features supported by the consolidated billing feature set, the management account can also apply any policy type to any member account in the organization.

Request Syntax:
[idem_test_aws_organizations_organization]:
  aws.organizations.organization.present:
  - name: 'string'
  - feature_set: 'string'
Returns:

Dict[str, Any]

Examples

idem_test_aws_organizations_organization:
  aws.organizations.organization.present:
    - name: 'idem_test_organization'
    - feature_set: 'ALL
async idem_aws.states.aws.organizations.organization.absent(hub, ctx, name: str) → Dict[str, Any][source]#

Deletes the organization.

You can delete an organization only by using credentials from the management account. The organization must be empty of member accounts.

Parameters:

name (str) – The name of the organization.

Request syntax:
[idem_test_aws_organizations_organization]:
  aws.organizations.organization.absent:
    - name: 'string'
Returns:

Dict[str, Any]

Examples

idem_test_aws_organizations_organization:
  aws.organizations.organization.absent:
    - name: 'idem_test_organization'
async idem_aws.states.aws.organizations.organization.describe(hub, ctx) → Dict[str, Dict[str, Any]][source]#

Describes AWS Organizations in a way that can be recreated/managed with the corresponding “present” function.

Returns:

Dict[str, Dict[str, Any]

Examples

$ idem describe aws.organizations.organization