AWS Organizations

AWS::Organizations::Account

The following example demonstrates how to ingest your AWS Organizations accounts to Port.

Organizations Account Supported Actions

The table below summarizes the available actions for ingesting AWS Organizations Account resources in Port:

Action	Description	Type	Required AWS Permission
ListAccountsAction	Discover organization accounts and retrieve account metadata. Reference	Default	organizations:ListAccounts
ListTagsForResourceAction	Retrieve tags for the specified account. Reference	Optional	organizations:ListTagsForResource
ListParentsAction	Retrieve parent information for the specified account. Reference	Optional	organizations:ListParents

Optional properties note

Properties of optional actions will not appear in the response unless you explicitly include the action that provides them in your configuration.

You can use the following Port blueprint definitions and integration configuration:

Organizations Account blueprint (Click to expand)

{
  "identifier": "awsOrganizationAccount",
  "description": "This blueprint represents an AWS Organizations Account in our software catalog",
  "title": "Organizations Account",
  "icon": "AWS",
  "schema": {
    "properties": {
      "arn": {
        "type": "string",
        "title": "ARN"
      },
      "email": {
        "type": "string",
        "title": "Email"
      },
      "status": {
        "type": "string",
        "title": "Status"
      },
      "joinedTimestamp": {
        "type": "string",
        "title": "Joined Timestamp"
      },
      "joinedMethod": {
        "type": "string",
        "title": "Joined Method"
      }
    },
    "required": []
  },
  "mirrorProperties": {},
  "calculationProperties": {},
  "aggregationProperties": {},
  "relations": {}
}

Organizations Account mapping configuration (Click to expand)

resources:
  - kind: AWS::Organizations::Account
    selector:
      query: 'true'
    port:
      entity:
        mappings:
          identifier: .Properties.Id
          title: .Properties.AccountName
          blueprint: '"awsOrganizationAccount"'
          properties:
            arn: .Properties.Arn
            email: .Properties.Email
            status: .Properties.Status
            joinedTimestamp: .Properties.JoinedTimestamp
            joinedMethod: .Properties.JoinedMethod

For more details about Organizations accounts, refer to the AWS Organizations API documentation.