We recommend new projects start with resources from the AWS provider.
aws-native.organizations.Account
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
You can use AWS::Organizations::Account to manage accounts in organization.
Create Account Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Account(name: string, args: AccountArgs, opts?: CustomResourceOptions);
@overload
def Account(resource_name: str,
args: AccountArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Account(resource_name: str,
opts: Optional[ResourceOptions] = None,
email: Optional[str] = None,
account_name: Optional[str] = None,
parent_ids: Optional[Sequence[str]] = None,
role_name: Optional[str] = None,
tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
func NewAccount(ctx *Context, name string, args AccountArgs, opts ...ResourceOption) (*Account, error)
public Account(string name, AccountArgs args, CustomResourceOptions? opts = null)
public Account(String name, AccountArgs args)
public Account(String name, AccountArgs args, CustomResourceOptions options)
type: aws-native:organizations:Account
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args AccountArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args AccountArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args AccountArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AccountArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AccountArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Account Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Account resource accepts the following input properties:
- Email string
- The email address of the owner to assign to the new member account.
- Account
Name string - The friendly name of the member account.
- Parent
Ids List<string> - List of parent nodes for the member account. Currently only one parent at a time is supported. Default is root.
- Role
Name string - The name of an IAM role that AWS Organizations automatically preconfigures in the new member account. Default name is OrganizationAccountAccessRole if not specified.
- List<Pulumi.
Aws Native. Inputs. Tag> - A list of tags that you want to attach to the newly created account. For each tag in the list, you must specify both a tag key and a value.
- Email string
- The email address of the owner to assign to the new member account.
- Account
Name string - The friendly name of the member account.
- Parent
Ids []string - List of parent nodes for the member account. Currently only one parent at a time is supported. Default is root.
- Role
Name string - The name of an IAM role that AWS Organizations automatically preconfigures in the new member account. Default name is OrganizationAccountAccessRole if not specified.
- Tag
Args - A list of tags that you want to attach to the newly created account. For each tag in the list, you must specify both a tag key and a value.
- email String
- The email address of the owner to assign to the new member account.
- account
Name String - The friendly name of the member account.
- parent
Ids List<String> - List of parent nodes for the member account. Currently only one parent at a time is supported. Default is root.
- role
Name String - The name of an IAM role that AWS Organizations automatically preconfigures in the new member account. Default name is OrganizationAccountAccessRole if not specified.
- List<Tag>
- A list of tags that you want to attach to the newly created account. For each tag in the list, you must specify both a tag key and a value.
- email string
- The email address of the owner to assign to the new member account.
- account
Name string - The friendly name of the member account.
- parent
Ids string[] - List of parent nodes for the member account. Currently only one parent at a time is supported. Default is root.
- role
Name string - The name of an IAM role that AWS Organizations automatically preconfigures in the new member account. Default name is OrganizationAccountAccessRole if not specified.
- Tag[]
- A list of tags that you want to attach to the newly created account. For each tag in the list, you must specify both a tag key and a value.
- email str
- The email address of the owner to assign to the new member account.
- account_
name str - The friendly name of the member account.
- parent_
ids Sequence[str] - List of parent nodes for the member account. Currently only one parent at a time is supported. Default is root.
- role_
name str - The name of an IAM role that AWS Organizations automatically preconfigures in the new member account. Default name is OrganizationAccountAccessRole if not specified.
- Sequence[Tag
Args] - A list of tags that you want to attach to the newly created account. For each tag in the list, you must specify both a tag key and a value.
- email String
- The email address of the owner to assign to the new member account.
- account
Name String - The friendly name of the member account.
- parent
Ids List<String> - List of parent nodes for the member account. Currently only one parent at a time is supported. Default is root.
- role
Name String - The name of an IAM role that AWS Organizations automatically preconfigures in the new member account. Default name is OrganizationAccountAccessRole if not specified.
- List<Property Map>
- A list of tags that you want to attach to the newly created account. For each tag in the list, you must specify both a tag key and a value.
Outputs
All input properties are implicitly available as output properties. Additionally, the Account resource produces the following output properties:
- Account
Id string - If the account was created successfully, the unique identifier (ID) of the new account.
- Arn string
- The Amazon Resource Name (ARN) of the account.
- Id string
- The provider-assigned unique ID for this managed resource.
- Joined
Method Pulumi.Aws Native. Organizations. Account Joined Method - The method by which the account joined the organization.
- Joined
Timestamp string - The date the account became a part of the organization.
- Status
Pulumi.
Aws Native. Organizations. Account Status - The status of the account in the organization.
- Account
Id string - If the account was created successfully, the unique identifier (ID) of the new account.
- Arn string
- The Amazon Resource Name (ARN) of the account.
- Id string
- The provider-assigned unique ID for this managed resource.
- Joined
Method AccountJoined Method - The method by which the account joined the organization.
- Joined
Timestamp string - The date the account became a part of the organization.
- Status
Account
Status - The status of the account in the organization.
- account
Id String - If the account was created successfully, the unique identifier (ID) of the new account.
- arn String
- The Amazon Resource Name (ARN) of the account.
- id String
- The provider-assigned unique ID for this managed resource.
- joined
Method AccountJoined Method - The method by which the account joined the organization.
- joined
Timestamp String - The date the account became a part of the organization.
- status
Account
Status - The status of the account in the organization.
- account
Id string - If the account was created successfully, the unique identifier (ID) of the new account.
- arn string
- The Amazon Resource Name (ARN) of the account.
- id string
- The provider-assigned unique ID for this managed resource.
- joined
Method AccountJoined Method - The method by which the account joined the organization.
- joined
Timestamp string - The date the account became a part of the organization.
- status
Account
Status - The status of the account in the organization.
- account_
id str - If the account was created successfully, the unique identifier (ID) of the new account.
- arn str
- The Amazon Resource Name (ARN) of the account.
- id str
- The provider-assigned unique ID for this managed resource.
- joined_
method AccountJoined Method - The method by which the account joined the organization.
- joined_
timestamp str - The date the account became a part of the organization.
- status
Account
Status - The status of the account in the organization.
- account
Id String - If the account was created successfully, the unique identifier (ID) of the new account.
- arn String
- The Amazon Resource Name (ARN) of the account.
- id String
- The provider-assigned unique ID for this managed resource.
- joined
Method "INVITED" | "CREATED" - The method by which the account joined the organization.
- joined
Timestamp String - The date the account became a part of the organization.
- status "ACTIVE" | "SUSPENDED" | "PENDING_CLOSURE"
- The status of the account in the organization.
Supporting Types
AccountJoinedMethod, AccountJoinedMethodArgs
- Invited
- INVITED
- Created
- CREATED
- Account
Joined Method Invited - INVITED
- Account
Joined Method Created - CREATED
- Invited
- INVITED
- Created
- CREATED
- Invited
- INVITED
- Created
- CREATED
- INVITED
- INVITED
- CREATED
- CREATED
- "INVITED"
- INVITED
- "CREATED"
- CREATED
AccountStatus, AccountStatusArgs
- Active
- ACTIVE
- Suspended
- SUSPENDED
- Pending
Closure - PENDING_CLOSURE
- Account
Status Active - ACTIVE
- Account
Status Suspended - SUSPENDED
- Account
Status Pending Closure - PENDING_CLOSURE
- Active
- ACTIVE
- Suspended
- SUSPENDED
- Pending
Closure - PENDING_CLOSURE
- Active
- ACTIVE
- Suspended
- SUSPENDED
- Pending
Closure - PENDING_CLOSURE
- ACTIVE
- ACTIVE
- SUSPENDED
- SUSPENDED
- PENDING_CLOSURE
- PENDING_CLOSURE
- "ACTIVE"
- ACTIVE
- "SUSPENDED"
- SUSPENDED
- "PENDING_CLOSURE"
- PENDING_CLOSURE
Tag, TagArgs
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.