Add AWS Organization

Author: shariff-6

docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples.md

@@ -13,6 +13,9 @@ import EcsClusterProperties from './examples/ecs/clusters/_ecs_cluster_propertie
 import Ec2InstanceBlueprint from './examples/ec2/instances/_ec2_instance_blueprint.mdx'
 import Ec2InstanceConfig from './examples/ec2/instances/_ec2_instance_port_app_config.mdx'
 import Ec2InstanceProperties from './examples/ec2/instances/_ec2_instance_properties.mdx'
+import OrganizationsAccountBlueprint from './examples/organizations/accounts/_organizations_accounts_blueprint.mdx'
+import OrganizationsAccountConfig from './examples/organizations/accounts/_organizations_accounts_port_app_config.mdx'
+import OrganizationsAccountProperties from './examples/organizations/accounts/_organizations_accounts_properties.mdx'
 
 # Examples
 
@@ -32,6 +35,24 @@ You can use the following Port blueprint definitions and integration configurati
 
 <AccountInfoConfig/>
 
+## AWS Organizations
+
+### Organizations Accounts
+
+The following example demonstrates how to ingest your AWS Organizations Accounts to Port.
+
+You can use the following Port blueprint definitions and integration configuration:
+
+<OrganizationsAccountBlueprint/>
+
+<OrganizationsAccountConfig/>
+
+You can reference any of the following Organizations Account properties in your mapping configuration:
+
+<OrganizationsAccountProperties/>
+
+For more details about Organizations Account properties, refer to the [AWS Organizations API documentation](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html).
+
 ## Amazon S3
 
 ### S3 buckets

docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_blueprint.mdx

@@ -0,0 +1,42 @@
+<details>
+<summary><b>Organizations Account blueprint (Click to expand)</b></summary>
+
+```json showLineNumbers
+{
+  "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": {}
+}
+```
+
+</details>

docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_port_app_config.mdx

@@ -0,0 +1,23 @@
+<details>
+<summary><b>Organizations Account mapping configuration (Click to expand)</b></summary>
+
+```yaml showLineNumbers
+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
+```
+
+</details>

docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_properties.mdx

@@ -0,0 +1,16 @@
+<details>
+<summary><b>Organizations Account properties (Click to expand)</b></summary>
+
+| Property | JQ Path | Type | Action Required |
+|----------|---------|------|-----------------|
+| Id | .Properties.Id | string | ListAccountsAction (default) |
+| AccountName | .Properties.AccountName | string | ListAccountsAction (default) |
+| Arn | .Properties.Arn | string | ListAccountsAction (default) |
+| Email | .Properties.Email | string | ListAccountsAction (default) |
+| Status | .Properties.Status | string | ListAccountsAction (default) |
+| JoinedTimestamp | .Properties.JoinedTimestamp | string | ListAccountsAction (default) |
+| JoinedMethod | .Properties.JoinedMethod | string | ListAccountsAction (default) |
+| Tags | .Properties.Tags | array | ListTagsForResourceAction (optional) |
+| Parents | .Properties.Parents | array | ListParentsAction (optional) |
+
+</details>