diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/Overview.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/Overview.md
index 5378510b7d..051ae49bd3 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/Overview.md
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/Overview.md
@@ -22,16 +22,6 @@ Easily fill your software catalog with data directly from your AWS Organization,
- Use relations to create complete, easily digestible views of your AWS infrastructure inside Port.
- Enjoy a fully managed experience with no infrastructure to maintain or updates to apply.
-## Supported resources
-
-The integration currently supports the following AWS resource types:
-- `S3 Buckets`: Complete bucket information including properties, tags, and metadata.
-- `ECS Clusters`: Cluster details, services, and task definitions.
-- `EC2 Instances`: Instance information, security groups, and networking details.
-
-:::info More Resource Types Coming Soon
-We're actively working on adding support for additional AWS resource types to provide comprehensive coverage of your AWS infrastructure.
-:::
## Key advantages
@@ -52,6 +42,9 @@ For detailed information about the IAM role architecture and security model, see
Port integrations use a [YAML mapping block](/build-your-software-catalog/customize-integrations/configure-mapping#configuration-structure) to ingest data from the third-party api into Port.
The mapping makes use of the [JQ JSON processor](https://stedolan.github.io/jq/manual/) to select, modify, concatenate, transform and perform other operations on existing fields and values from the integration API.
+:::info Property naming conventions
+The AWS Hosted by Port integration returns all resource properties in **PascalCase** (for example: `Arn`, `BucketName`, `CreationDate`). When writing mappings and JQ expressions, reference properties using PascalCasing as shown in the examples below.
+:::
### Default mapping configuration
@@ -137,6 +130,6 @@ resources:
-## Advanced
+## Resource and property reference
-Refer to the [Advanced configuration](./advanced.md) page for advanced use cases and examples.
\ No newline at end of file
+Refer to the [resource and property reference](./resource-and-property-reference/resource-and-property-reference.md) page for details on available AWS resources, their properties, and mapping examples.
\ No newline at end of file
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/advanced.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/advanced.md
deleted file mode 100644
index 4e0552d3f7..0000000000
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/advanced.md
+++ /dev/null
@@ -1,84 +0,0 @@
----
-sidebar_position: 5
----
-
-# Advanced
-
-The AWS v3 integration supports additional configuration options to access optional properties from AWS resources.
-
-## Optional actions configuration
-
-Some AWS resource properties require additional API calls to retrieve. You can use the `includeActions` parameter to access these optional properties.
-
-### Configuration
-
-You can add `includeActions` to your resource configuration under the `selector` section:
-
-```yaml showLineNumbers
-resources:
- - kind: AWS::EC2::Instance
- selector:
- query: 'true'
- includeActions:
- # Optional: Include up to 3 additional actions for more properties
- - GetInstanceStatusAction
- port:
- entity:
- mappings:
- # ... your mappings
-```
-
-:::caution Action limit
-You can include a **maximum of 3 optional actions per resource kind** (excluding default actions). To use more than 3 actions, you can configure multiple resource kinds in your integration.
-:::
-
-### Finding available actions
-
-Each AWS resource has its own set of available actions. To find which actions are available for a specific resource, you can:
-
-1. Check the resource's properties table in the [Examples](./examples.md) page
-2. Look at the "Action Required" column to see which properties need optional actions
-3. Use the action names shown in that column in your `includeActions` list
-
-## Property availability
-
-AWS resource properties fall into two categories:
-
-- **Default properties**: Always available, no additional configuration needed
-- **Optional properties**: Require specific actions via `includeActions`
-
-Each resource example includes a properties reference table with an "Action Required" column showing which properties need optional actions.
-
-## Configuration examples
-
-### Multiple actions example
-
-```yaml showLineNumbers
-resources:
- - kind: AWS::S3::Bucket
- selector:
- query: 'true'
- includeActions:
- - GetBucketEncryptionAction
- - GetBucketPublicAccessBlockAction
- port:
- entity:
- mappings:
- identifier: .Properties.Arn
- title: .Properties.BucketName
- blueprint: '"s3Bucket"'
- properties:
- # Default properties (always available)
- arn: .Properties.Arn
- region: .Properties.LocationConstraint
- creationDate: .Properties.CreationDate
- tags: .Properties.Tags
- # Optional properties (require includeActions)
- bucketEncryption: .Properties.BucketEncryption
- publicAccessBlock: .Properties.PublicAccessBlockConfiguration
- relations:
- account: .__ExtraContext.AccountId
-```
-
-
-
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples.md
deleted file mode 100644
index 676070c90f..0000000000
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples.md
+++ /dev/null
@@ -1,112 +0,0 @@
----
-sidebar_position: 4
----
-
-import AccountInfoBlueprint from './examples/account_info/_account_info_blueprint.mdx'
-import AccountInfoConfig from './examples/account_info/_account_info_port_app_config.mdx'
-import S3BucketBlueprint from './examples/s3/buckets/_s3_bucket_blueprint.mdx'
-import S3PortAppConfig from './examples/s3/buckets/_s3_bucket_port_app_config.mdx'
-import S3BucketProperties from './examples/s3/buckets/_s3_bucket_properties.mdx'
-import EcsClusterBlueprint from './examples/ecs/clusters/_ecs_cluster_blueprint.mdx'
-import EcsClusterConfig from './examples/ecs/clusters/_ecs_cluster_port_app_config.mdx'
-import EcsClusterProperties from './examples/ecs/clusters/_ecs_cluster_properties.mdx'
-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
-
-This page contains practical examples for mapping AWS resources to Port using AWS Hosted by Port.
-
-These examples demonstrate how to create blueprints and configure mappings to ingest your AWS infrastructure into your Port software catalog.
-
-## AWS Account
-
-### AccountInfo
-
-The following example demonstrates how to ingest your AWS Account information to Port.
-
-You can use the following Port blueprint definitions and integration configuration:
-
-
-
-
-
-## 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:
-
-
-
-
-
-You can reference any of the following Organizations Account properties in your mapping configuration:
-
-
-
-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
-
-The following example demonstrates how to ingest your AWS S3 buckets to Port.
-
-You can use the following Port blueprint definitions and integration configuration:
-
-
-
-
-
-You can reference any of the following S3 bucket properties in your mapping configuration:
-
-
-
-For more details about S3 bucket properties, refer to the [AWS S3 API documentation](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html).
-
-## Amazon ECS
-
-### ECS clusters
-
-The following example demonstrates how to ingest your AWS ECS clusters to Port.
-
-You can use the following Port blueprint definitions and integration configuration:
-
-
-
-
-
-You can reference any of the following ECS cluster properties in your mapping configuration:
-
-
-
-For more details about ECS cluster properties, refer to the [AWS ECS API documentation](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeClusters.html).
-
-## Amazon EC2
-
-### EC2 instances
-
-The following example demonstrates how to ingest your AWS EC2 instances to Port.
-
-You can use the following Port blueprint definitions and integration configuration:
-
-
-
-
-
-You can reference any of the following EC2 instance properties in your mapping configuration:
-
-
-
-For more details about EC2 instance properties, refer to the [AWS EC2 API documentation](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html).
-
-:::info More resource types coming soon
-We're actively working on adding support for additional AWS resource types to provide comprehensive coverage of your AWS infrastructure.
-:::
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/.cursor/rules/aws_v3_examples.mdc b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/.cursor/rules/aws_v3_examples.mdc
deleted file mode 100644
index b84390b1e9..0000000000
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/.cursor/rules/aws_v3_examples.mdc
+++ /dev/null
@@ -1,282 +0,0 @@
----
-alwaysApply: true
----
-# AWS v3 Documentation Generation Rules
-
-You are an expert documentation agent for Port's AWS v3 integration examples. Follow these rules exactly when generating AWS resource documentation.
-
-## Quick Start Process
-
-1. **Access Ocean Repository Files** (MANDATORY):
- - Model file: `curl -s "https://raw.githubusercontent.com/port-labs/ocean/refs/heads/main/integrations/aws-v3/aws/core/exporters/{service}/{resource}/models.py"`
- - Actions file: `curl -s "https://raw.githubusercontent.com/port-labs/ocean/refs/heads/main/integrations/aws-v3/aws/core/exporters/{service}/{resource}/actions.py"`
-
-2. **Extract Information**:
- - Properties from `{Resource}Properties` class
- - Default vs optional actions from `ActionMap` class
-
-3. **Generate 3 Files**:
- - `_{service}_{resource}_blueprint.mdx` (3-5 basic properties)
- - `_{service}_{resource}_port_app_config.mdx` (mapping configuration)
- - `_{service}_{resource}_properties.mdx` (complete properties table)
-
-4. **Update examples.md** following service-based organization
-
-## Required Information Checklist
-
-```
-□ AWS CloudFormation Resource Kind (e.g., AWS::ECS::Cluster)
-□ Ocean model file path (e.g., ocean/integrations/aws-v3/aws/core/exporters/ecs/cluster/models.py)
-□ Ocean actions file path (e.g., ocean/integrations/aws-v3/aws/core/exporters/ecs/cluster/actions.py)
-□ Resource description (one sentence)
-□ Identifier property (ARN/ID/Name)
-□ Title property (human-readable name)
-□ 3-5 basic properties for blueprint
-□ Complete properties list from Ocean model
-□ Default actions list from ActionMap
-□ Optional actions list from ActionMap
-□ AWS API documentation URL
-```
-
-**Response for missing info:** "Required information missing: [list items]. Provide all details to generate documentation."
-
-## Ocean Repository Integration
-
-**Critical Requirements:**
-- **MANDATORY**: Use `run_terminal_cmd` with curl for direct file access
-- **Extract ALL properties** from the `{Resource}Properties` class
-- **Extract default and optional actions** from the `ActionMap` class
-- **Use exact property names** and types from the model
-- **Map JQ paths** using the `alias` field from Pydantic model
-- **Include ALL available properties** in the complete properties reference table
-
-**URL Pattern:**
-```
-curl -s "https://raw.githubusercontent.com/port-labs/ocean/refs/heads/main/integrations/aws-v3/aws/core/exporters/{service}/{resource}/models.py"
-curl -s "https://raw.githubusercontent.com/port-labs/ocean/refs/heads/main/integrations/aws-v3/aws/core/exporters/{service}/{resource}/actions.py"
-```
-
-## Action Requirements
-
-**Action Types:**
-- **Default actions**: Always included automatically (no limit)
-- **Optional actions**: Must be explicitly requested via `includeActions` (maximum 3 per resource kind)
-
-**Action Mapping Rules:**
-- **{ActionName} (default)**: Property available without additional action
-- **{ActionName} (optional)**: Property requires this specific action to be included
-
-**Action Selection Strategy:**
-- Choose based on property importance
-- Focus on properties users commonly need
-- Respect the 3-action limit per resource kind
-
-## Property Mapping & Selection
-
-**Type Mapping:**
-- `str` → `"string"`, `int` → `"number"`, `bool` → `"boolean"`
-- `List[str]` → `{"type": "array", "items": {"type": "string"}}`
-- `List[Dict[str, Any]]` → `{"type": "array", "items": {"type": "object"}}`
-- `Optional[Dict[str, Any]]` → `"object"`
-- **Tags**: Always use array format with Key/Value objects
-- **Optional fields**: Treat as required type (remove Optional wrapper)
-
-**Basic Properties Selection (exactly 3-5):**
-1. **arn** (if available) - Always include unique identifier
-2. **Primary identifier** (name/id) - Always include human-readable identifier
-3. **tags** (if available) - Always include for AWS resources
-4. **status/state** (if available) - Key operational property
-5. **One additional operational property** - Choose from capacity/configuration, region, or runtime metrics
-
-**Mapping Rules:**
-- **Blueprint properties**: Use camelCase from the model field names
-- **JQ paths**: Use the `alias` field from Pydantic Field definitions
-
-## File Structure & Naming
-
-**Generate exactly this structure:**
-```
-examples/{service-name}/{resource-type}/
-├── _{service-name}_{resource_type}_blueprint.mdx
-├── _{service-name}_{resource_type}_port_app_config.mdx
-└── _{service-name}_{resource_type}_properties.mdx
-```
-
-**Naming Rules:**
-- Service directory: `{service-name}` (lowercase, e.g., `ecs`, `s3`, `lambda`)
-- Resource directory: `{resource-type}` (lowercase, e.g., `clusters`, `buckets`, `functions`)
-- Blueprint identifier: `camelCase` (e.g., `ecsCluster`, `s3Bucket`)
-
-**Service Name Mapping Examples:**
-- `AWS::ECS::Cluster` → `ecs/clusters/`
-- `AWS::S3::Bucket` → `s3/buckets/`
-- `AWS::Lambda::Function` → `lambda/functions/`
-- `AWS::EC2::Instance` → `ec2/instances/`
-- `AWS::RDS::DBInstance` → `rds/instances/`
-
-## Generation Templates
-
-### Blueprint Template
-```mdx
-
-{RESOURCE_NAME} blueprint (Click to expand)
-
-```json showLineNumbers
-{
- "identifier": "{CAMEL_CASE_IDENTIFIER}",
- "description": "This blueprint represents an AWS {RESOURCE_NAME} in our software catalog",
- "title": "{RESOURCE_NAME}",
- "icon": "AWS",
- "schema": {
- "properties": {
- // EXACTLY 3-5 PROPERTIES ONLY - USE PROVIDED BASIC PROPERTIES
- // FORMAT: "propertyName": {"type": "string", "title": "Property Name"}
- },
- "required": []
- },
- "mirrorProperties": {},
- "calculationProperties": {},
- "aggregationProperties": {},
- "relations": {
- "account": {
- "title": "Account",
- "target": "awsAccount",
- "required": true,
- "many": false
- }
- }
-}
-```
-
-
-```
-
-### Config Template
-```mdx
-
-{RESOURCE_NAME} mapping configuration (Click to expand)
-
-```yaml showLineNumbers
-resources:
- - kind: {AWS_CLOUDFORMATION_KIND}
- selector:
- query: 'true'
- includeActions:
- # Optional: Include up to 3 additional actions for more properties
- # Choose based on which properties you need most
- # - {ActionName1}
- # - {ActionName2}
- # - {ActionName3}
- port:
- entity:
- mappings:
- identifier: .Properties.{IDENTIFIER_PROPERTY}
- title: .Properties.{TITLE_PROPERTY}
- blueprint: '"{CAMEL_CASE_IDENTIFIER}"'
- properties:
- // MAP SAME 3-5 PROPERTIES AS BLUEPRINT
- // FORMAT: propertyName: .Properties.PropertyName
- relations:
- account: .__ExtraContext.AccountId
-```
-
-
-```
-
-### Properties Template
-```mdx
-
-{RESOURCE_NAME} properties (Click to expand)
-
-| Property | JQ Path | Type | Action Required |
-|----------|---------|------|-----------------|
-{COMPLETE_PROPERTIES_TABLE}
-
-
-```
-
-### examples.md Section Template
-```markdown
-import {PASCAL_CASE_NAME}Blueprint from './{service-name}/{resource-type}/_{service-name}_{resource_type}_blueprint.mdx';
-import {PASCAL_CASE_NAME}Config from './{service-name}/{resource-type}/_{service-name}_{resource_type}_port_app_config.mdx';
-import {PASCAL_CASE_NAME}Properties from './{service-name}/{resource-type}/_{service-name}_{resource_type}_properties.mdx';
-
-## Amazon {SERVICE_NAME}
-
-### {RESOURCE_NAME}s
-
-The following example demonstrates how to ingest your AWS {RESOURCE_NAME}s to Port.
-
-You can use the following Port blueprint definitions and integration configuration:
-
-<{PASCAL_CASE_NAME}Blueprint/>
-
-<{PASCAL_CASE_NAME}Config/>
-
-You can reference any of the following {RESOURCE_NAME} properties in your mapping configuration:
-
-<{PASCAL_CASE_NAME}Properties/>
-
-For more details about {RESOURCE_NAME} properties, refer to the [AWS {SERVICE} API documentation]({AWS_API_URL}).
-```
-
-## Service-Based Organization Rules
-
-**Organization Logic:**
-1. **If the service already exists** (e.g., Amazon ECS), add the new resource under the existing service section
-2. **If the service doesn't exist** (e.g., Amazon Lambda), create a new service section
-
-**Placement Rules:**
-- **New service**: Add after the last existing service section
-- **New resource in existing service**: Add after the last resource in that service
-
-## Quality Validation
-
-**Verify before output:**
-```
-□ Ocean model and actions files read via curl
-□ Property count matches Ocean model exactly
-□ File names match naming convention
-□ Blueprint has 3-5 properties only
-□ Config maps same properties as blueprint
-□ Account relation present in both files
-□ Complete properties table includes everything
-□ All placeholder values replaced
-□ No syntax errors
-□ AWS API link valid
-□ Service-based organization followed in examples.md
-```
-
-## Agent Output Format
-
-**Required Output Structure:**
-1. **Ocean Repository Evidence** (show curl access):
- - Property count from Ocean model: X properties
- - Sample properties from model: [list 3-5 actual property names]
- - Default actions from ActionMap: [list default actions]
- - Optional actions from ActionMap: [list optional actions]
- - Model file URL: [Raw GitHub URL accessed via curl]
- - Actions file URL: [Raw GitHub URL accessed via curl]
-
-2. **Complete File Contents** (provide full content for each file)
-
-3. **examples.md Addition** (import statements + new section)
-
-4. **Validation Status:** `✅ All requirements verified including Ocean model and actions reading`
-
-## Error Handling
-
-**Missing information:** Stop. List missing items. Do not generate partial content.
-
-**Invalid property count:** Use exactly 3-5 basic properties. No exceptions.
-
-**Template modifications:** Templates cannot be modified. Work within constraints.
-
-## Success Criteria
-
-Generated documentation is successful when:
-- All files can be copied directly into project
-- Naming conventions followed exactly
-- Property selection meets rules
-- Quality validation passes 100%
-- Service-based organization maintained in examples.md
\ No newline at end of file
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/_category_.json
deleted file mode 100644
index 62e826eef5..0000000000
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
- "label": "Examples",
- "position": 3
-}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ec2/instances/_ec2_instance_properties.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ec2/instances/_ec2_instance_properties.mdx
deleted file mode 100644
index 084f9dd01c..0000000000
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ec2/instances/_ec2_instance_properties.mdx
+++ /dev/null
@@ -1,60 +0,0 @@
-
-EC2 instance properties (Click to expand)
-
-| Property | JQ Path | Type | Action Required |
-|----------|---------|------|-----------------|
-| Instance ARN | `.Properties.InstanceArn` | string | DescribeInstancesAction (default) |
-| Instance ID | `.Properties.InstanceId` | string | DescribeInstancesAction (default) |
-| Instance Type | `.Properties.InstanceType` | string | DescribeInstancesAction (default) |
-| Availability Zone | `.Properties.AvailabilityZone` | string | DescribeInstancesAction (default) |
-| Tags | `.Properties.Tags` | array | DescribeInstancesAction (default) |
-| AMI Launch Index | `.Properties.AmiLaunchIndex` | number | DescribeInstancesAction (default) |
-| Architecture | `.Properties.Architecture` | string | DescribeInstancesAction (default) |
-| Block Device Mappings | `.Properties.BlockDeviceMappings` | array | DescribeInstancesAction (default) |
-| Boot Mode | `.Properties.BootMode` | string | DescribeInstancesAction (default) |
-| Capacity Reservation Specification | `.Properties.CapacityReservationSpecification` | object | DescribeInstancesAction (default) |
-| Client Token | `.Properties.ClientToken` | string | DescribeInstancesAction (default) |
-| CPU Options | `.Properties.CpuOptions` | object | DescribeInstancesAction (default) |
-| Current Instance Boot Mode | `.Properties.CurrentInstanceBootMode` | string | DescribeInstancesAction (default) |
-| EBS Optimized | `.Properties.EbsOptimized` | boolean | DescribeInstancesAction (default) |
-| Enclave Options | `.Properties.EnclaveOptions` | object | DescribeInstancesAction (default) |
-| ENA Support | `.Properties.EnaSupport` | boolean | DescribeInstancesAction (default) |
-| Events | `.Properties.Events` | array | DescribeInstancesAction (default) |
-| Hibernation Options | `.Properties.HibernationOptions` | object | DescribeInstancesAction (default) |
-| Hypervisor | `.Properties.Hypervisor` | string | DescribeInstancesAction (default) |
-| Image ID | `.Properties.ImageId` | string | DescribeInstancesAction (default) |
-| Instance Status | `.Properties.InstanceStatus` | object | GetInstanceStatusAction (optional) |
-| Instance State | `.Properties.InstanceState` | object | DescribeInstancesAction (default) |
-| Key Name | `.Properties.KeyName` | string | DescribeInstancesAction (default) |
-| Launch Time | `.Properties.LaunchTime` | datetime | DescribeInstancesAction (default) |
-| Maintenance Options | `.Properties.MaintenanceOptions` | object | DescribeInstancesAction (default) |
-| Metadata Options | `.Properties.MetadataOptions` | object | DescribeInstancesAction (default) |
-| Monitoring | `.Properties.Monitoring` | object | DescribeInstancesAction (default) |
-| Network Interfaces | `.Properties.NetworkInterfaces` | array | DescribeInstancesAction (default) |
-| Network Performance Options | `.Properties.NetworkPerformanceOptions` | object | DescribeInstancesAction (default) |
-| Operator | `.Properties.Operator` | object | DescribeInstancesAction (default) |
-| Placement | `.Properties.Placement` | object | DescribeInstancesAction (default) |
-| Platform | `.Properties.Platform` | string | DescribeInstancesAction (default) |
-| Platform Details | `.Properties.PlatformDetails` | string | DescribeInstancesAction (default) |
-| Private DNS Name | `.Properties.PrivateDnsName` | string | DescribeInstancesAction (default) |
-| Private DNS Name Options | `.Properties.PrivateDnsNameOptions` | object | DescribeInstancesAction (default) |
-| Private IP Address | `.Properties.PrivateIpAddress` | string | DescribeInstancesAction (default) |
-| Product Codes | `.Properties.ProductCodes` | array | DescribeInstancesAction (default) |
-| Public DNS Name | `.Properties.PublicDnsName` | string | DescribeInstancesAction (default) |
-| Public IP Address | `.Properties.PublicIpAddress` | string | DescribeInstancesAction (default) |
-| Reason | `.Properties.Reason` | string | DescribeInstancesAction (default) |
-| Root Device Name | `.Properties.RootDeviceName` | string | DescribeInstancesAction (default) |
-| Root Device Type | `.Properties.RootDeviceType` | string | DescribeInstancesAction (default) |
-| Security Groups | `.Properties.SecurityGroups` | array | DescribeInstancesAction (default) |
-| Source Dest Check | `.Properties.SourceDestCheck` | boolean | DescribeInstancesAction (default) |
-| State | `.Properties.State` | object | DescribeInstancesAction (default) |
-| State Reason | `.Properties.StateReason` | object | DescribeInstancesAction (default) |
-| State Transition Reason | `.Properties.StateTransitionReason` | string | DescribeInstancesAction (default) |
-| Subnet ID | `.Properties.SubnetId` | string | DescribeInstancesAction (default) |
-| System Status | `.Properties.SystemStatus` | object | DescribeInstancesAction (default) |
-| Usage Operation | `.Properties.UsageOperation` | string | DescribeInstancesAction (default) |
-| Usage Operation Update Time | `.Properties.UsageOperationUpdateTime` | datetime | DescribeInstancesAction (default) |
-| Virtualization Type | `.Properties.VirtualizationType` | string | DescribeInstancesAction (default) |
-| VPC ID | `.Properties.VpcId` | string | DescribeInstancesAction (default) |
-
-
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ecs/clusters/_ecs_cluster_properties.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ecs/clusters/_ecs_cluster_properties.mdx
deleted file mode 100644
index b0579b4614..0000000000
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ecs/clusters/_ecs_cluster_properties.mdx
+++ /dev/null
@@ -1,23 +0,0 @@
-
-ECS cluster properties (Click to expand)
-
-| Property | JQ Path | Type | Action Required |
-|----------|---------|------|-----------------|
-| Cluster Name | `.Properties.ClusterName` | string | DescribeClustersAction (default) |
-| Cluster ARN | `.Properties.ClusterArn` | string | DescribeClustersAction (default) |
-| Status | `.Properties.Status` | string | DescribeClustersAction (default) |
-| Capacity Providers | `.Properties.CapacityProviders` | array | DescribeClustersAction (default) |
-| Tags | `.Properties.Tags` | array | DescribeClustersAction (default) |
-| Cluster Settings | `.Properties.ClusterSettings` | array | DescribeClustersAction (default) |
-| Configuration | `.Properties.Configuration` | object | DescribeClustersAction (default) |
-| Default Capacity Provider Strategy | `.Properties.DefaultCapacityProviderStrategy` | array | DescribeClustersAction (default) |
-| Service Connect Defaults | `.Properties.ServiceConnectDefaults` | object | DescribeClustersAction (default) |
-| Attachments | `.Properties.Attachments` | array | DescribeClustersAction (default) |
-| Attachments Status | `.Properties.AttachmentsStatus` | string | DescribeClustersAction (default) |
-| Statistics | `.Properties.Statistics` | array | DescribeClustersAction (default) |
-| Active Services Count | `.Properties.ActiveServicesCount` | number | DescribeClustersAction (default) |
-| Pending Tasks Count | `.Properties.PendingTasksCount` | number | DescribeClustersAction (default) |
-| Running Tasks Count | `.Properties.RunningTasksCount` | number | DescribeClustersAction (default) |
-| Registered Container Instances Count | `.Properties.RegisteredContainerInstancesCount` | number | DescribeClustersAction (default) |
-
-
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_properties.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_properties.mdx
deleted file mode 100644
index eb27e954da..0000000000
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_properties.mdx
+++ /dev/null
@@ -1,16 +0,0 @@
-
-Organizations Account properties (Click to expand)
-
-| 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) |
-
-
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/s3/buckets/_s3_bucket_properties.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/s3/buckets/_s3_bucket_properties.mdx
deleted file mode 100644
index f9b010afb4..0000000000
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/s3/buckets/_s3_bucket_properties.mdx
+++ /dev/null
@@ -1,15 +0,0 @@
-
-S3 bucket properties (Click to expand)
-
-| Property | JQ Path | Type | Action Required |
-|----------|---------|------|-----------------|
-| Bucket Name | `.Properties.BucketName` | string | ListBucketsAction (default) |
-| ARN | `.Properties.Arn` | string | ListBucketsAction (default) |
-| Creation Date | `.Properties.CreationDate` | datetime | ListBucketsAction (default) |
-| Region | `.Properties.LocationConstraint` | string | GetBucketLocationAction (default) |
-| Tags | `.Properties.Tags` | array | GetBucketTaggingAction (default) |
-| Bucket Encryption | `.Properties.BucketEncryption` | object | GetBucketEncryptionAction (optional) |
-| Public Access Block Configuration | `.Properties.PublicAccessBlockConfiguration` | object | GetBucketPublicAccessBlockAction (optional) |
-| Ownership Controls | `.Properties.OwnershipControls` | object | GetBucketOwnershipControlsAction (optional) |
-
-
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/installations.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/installations.md
index 6676d4fce4..5adc2f785e 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/installations.md
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/installations.md
@@ -162,6 +162,10 @@ You must run the multi-account installation from your AWS Organizations **manage
+:::info Region policy
+Configure which AWS regions are queried using `regionPolicy`. See [Querying resources from specific regions](./resource-and-property-reference/resource-and-property-reference.md#querying-resources-from-specific-regions).
+:::
+
## Troubleshooting
Common Installation Issue - CloudFormation Stack Creation Failures.
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/_category_.json
new file mode 100644
index 0000000000..ccefe2de6d
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Resource and Property Reference",
+ "position": 4
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/_category_.json
new file mode 100644
index 0000000000..cba4bb5a53
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Amazon Elastic Compute Cloud (EC2)",
+ "position": 3
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/amazon-elastic-compute-cloud.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/amazon-elastic-compute-cloud.md
new file mode 100644
index 0000000000..1587a701a1
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/amazon-elastic-compute-cloud.md
@@ -0,0 +1,32 @@
+# Amazon Elastic Compute Cloud (EC2)
+
+import Ec2InstanceBlueprint from './aws-ec2-instance/_ec2_instance_blueprint.mdx'
+import Ec2InstanceConfig from './aws-ec2-instance/_ec2_instance_port_app_config.mdx'
+
+
+
+## AWS::EC2::Instance
+
+The following example demonstrates how to ingest your AWS EC2 instances to Port.
+
+#### EC2 Instance supported actions
+
+The table below summarizes the available actions for ingesting Amazon EC2 Instance resources in Port:
+
+| Action | Description | Type | Required AWS Permission |
+|-----------------------------|------------------------------------------------------------|----------|--------------------------------|
+| [DescribeInstancesAction](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html) | Discover EC2 instances and retrieve detailed configuration data. | Default | `ec2:DescribeInstances` |
+| [GetInstanceStatusAction](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceStatus.html) | Retrieve instance status information. | Optional | `ec2:DescribeInstanceStatus` |
+
+:::info 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:
+
+
+
+
+
+For more details about EC2 instance properties, refer to the [AWS EC2 API documentation](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Welcome.html).
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ec2/instances/_ec2_instance_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/aws-ec2-instance/_ec2_instance_blueprint.mdx
similarity index 94%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ec2/instances/_ec2_instance_blueprint.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/aws-ec2-instance/_ec2_instance_blueprint.mdx
index 8e4c9cd6c1..3b8a3523df 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ec2/instances/_ec2_instance_blueprint.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/aws-ec2-instance/_ec2_instance_blueprint.mdx
@@ -1,5 +1,5 @@
-EC2 instance blueprint (Click to expand)
+EC2 Instance blueprint (click to expand)
```json showLineNumbers
{
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ec2/instances/_ec2_instance_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/aws-ec2-instance/_ec2_instance_port_app_config.mdx
similarity index 92%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ec2/instances/_ec2_instance_port_app_config.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/aws-ec2-instance/_ec2_instance_port_app_config.mdx
index 4036395f07..aa0b17acfc 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ec2/instances/_ec2_instance_port_app_config.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud/aws-ec2-instance/_ec2_instance_port_app_config.mdx
@@ -1,5 +1,5 @@
-EC2 instance mapping configuration (Click to expand)
+EC2 Instance mapping configuration (click to expand)
```yaml showLineNumbers
resources:
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/_category_.json
new file mode 100644
index 0000000000..23e85810d2
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Amazon Elastic Container Service (ECS)",
+ "position": 4
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/amazon-elastic-container-service.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/amazon-elastic-container-service.md
new file mode 100644
index 0000000000..ef6c3ec9ac
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/amazon-elastic-container-service.md
@@ -0,0 +1,59 @@
+# Amazon Elastic Container Service (ECS)
+
+import EcsClusterBlueprint from './aws-ecs-cluster/_ecs_cluster_blueprint.mdx'
+import EcsClusterConfig from './aws-ecs-cluster/_ecs_cluster_port_app_config.mdx'
+import EcsServiceBlueprint from './aws-ecs-service/_ecs_service_blueprint.mdx'
+import EcsServiceConfig from './aws-ecs-service/_ecs_service_port_app_config.mdx'
+
+
+
+## AWS::ECS::Cluster
+
+The following example demonstrates how to ingest your AWS ECS clusters to Port.
+
+#### ECS Cluster supported actions
+
+The table below summarizes the available actions for ingesting Amazon ECS Cluster resources in Port:
+
+| Action | Description | Type | Required AWS Permission |
+|--------------------------|--------------------------------------------------------------------|---------|------------------------------------|
+| [DescribeClustersAction](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeClusters.html) | Discover ECS clusters and retrieve detailed configuration data. | Default | `ecs:ListClusters`, `ecs:DescribeClusters` |
+
+:::info All properties available by default
+ECS clusters expose their key properties via the default DescribeClusters action.
+:::
+
+
+You can use the following Port blueprint definitions and integration configuration:
+
+
+
+
+
+
+
+## AWS::ECS::Service
+
+The following example demonstrates how to ingest your AWS ECS services to Port.
+
+#### ECS Service supported actions
+
+The table below summarizes the available actions for ingesting Amazon ECS Service resources in Port:
+
+| Action | Description | Type | Required AWS Permission |
+|-----------------------------|---------------------------------------------------------------------------------------------------------|----------|--------------------------------------|
+| [DescribeServicesAction](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeServices.html) | Discover ECS services within your clusters and retrieve detailed configuration data. | Default | `ecs:ListServices`, `ecs:DescribeServices` |
+
+:::info 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:
+
+
+
+
+
+
+
+For more details about ECS cluster properties, refer to the [AWS ECS API documentation](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/Welcome.html).
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ecs/clusters/_ecs_cluster_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-cluster/_ecs_cluster_blueprint.mdx
similarity index 96%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ecs/clusters/_ecs_cluster_blueprint.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-cluster/_ecs_cluster_blueprint.mdx
index d66a75cb76..ace07523fc 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ecs/clusters/_ecs_cluster_blueprint.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-cluster/_ecs_cluster_blueprint.mdx
@@ -1,5 +1,5 @@
-ECS cluster blueprint (Click to expand)
+ECS Cluster blueprint (click to expand)
```json showLineNumbers
{
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ecs/clusters/_ecs_cluster_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-cluster/_ecs_cluster_port_app_config.mdx
similarity index 93%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ecs/clusters/_ecs_cluster_port_app_config.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-cluster/_ecs_cluster_port_app_config.mdx
index da31fa4c87..16ce13789c 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/ecs/clusters/_ecs_cluster_port_app_config.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-cluster/_ecs_cluster_port_app_config.mdx
@@ -1,5 +1,5 @@
-ECS cluster mapping configuration (Click to expand)
+ECS Cluster mapping configuration (click to expand)
```yaml showLineNumbers
resources:
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-service/_ecs_service_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-service/_ecs_service_blueprint.mdx
new file mode 100644
index 0000000000..c28bde9c08
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-service/_ecs_service_blueprint.mdx
@@ -0,0 +1,76 @@
+
+ECS Service blueprint (click to expand)
+
+```json showLineNumbers
+{
+ "identifier": "ecsService",
+ "title": "ECS Service",
+ "icon": "AWS",
+ "schema": {
+ "properties": {
+ "serviceName": {
+ "type": "string",
+ "title": "Service Name",
+ "description": "The name of the ECS service"
+ },
+ "serviceArn": {
+ "type": "string",
+ "title": "ARN",
+ "description": "The Amazon Resource Name (ARN) of the service"
+ },
+ "clusterArn": {
+ "type": "string",
+ "title": "Cluster ARN",
+ "description": "The ARN of the cluster that hosts the service"
+ },
+ "taskDefinition": {
+ "type": "string",
+ "title": "Task Definition",
+ "description": "The ARN of the task definition associated with the service"
+ },
+ "desiredCount": {
+ "type": "number",
+ "title": "Desired Count",
+ "description": "The desired number of tasks for the service"
+ },
+ "runningCount": {
+ "type": "number",
+ "title": "Running Count",
+ "description": "The number of tasks that are currently running"
+ },
+ "launchType": {
+ "type": "string",
+ "title": "Launch Type",
+ "description": "The launch type of the service",
+ "enum": ["EC2", "FARGATE", "EXTERNAL"]
+ },
+ "status": {
+ "type": "string",
+ "title": "Status",
+ "description": "The current status of the service",
+ "enum": ["ACTIVE", "DRAINING", "INACTIVE"]
+ }
+ },
+ "required": []
+ },
+ "mirrorProperties": {},
+ "calculationProperties": {},
+ "aggregationProperties": {},
+ "relations": {
+ "account": {
+ "title": "Account",
+ "target": "awsAccount",
+ "required": false,
+ "many": false
+ },
+ "cluster": {
+ "title": "Cluster",
+ "target": "ecsCluster",
+ "required": false,
+ "many": false
+ }
+ }
+}
+```
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-service/_ecs_service_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-service/_ecs_service_port_app_config.mdx
new file mode 100644
index 0000000000..0b29c9a69b
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service/aws-ecs-service/_ecs_service_port_app_config.mdx
@@ -0,0 +1,29 @@
+
+ECS Service mapping configuration (click to expand)
+
+```yaml showLineNumbers
+resources:
+ - kind: AWS::ECS::Service
+ selector:
+ query: 'true'
+ port:
+ entity:
+ mappings:
+ identifier: .Properties.ServiceArn
+ title: .Properties.ServiceName
+ blueprint: '"ecsService"'
+ properties:
+ serviceName: .Properties.ServiceName
+ serviceArn: .Properties.ServiceArn
+ clusterArn: .Properties.ClusterArn
+ taskDefinition: .Properties.TaskDefinition
+ desiredCount: .Properties.DesiredCount
+ runningCount: .Properties.RunningCount
+ launchType: .Properties.LaunchType
+ status: .Properties.Status
+ relations:
+ account: .__ExtraContext.AccountId
+ cluster: .Properties.ClusterArn
+```
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/_category_.json
new file mode 100644
index 0000000000..b086f2e6ee
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Amazon Elastic Kubernetes Service (EKS)",
+ "position": 5
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/amazon-elastic-kubernetes-service.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/amazon-elastic-kubernetes-service.md
new file mode 100644
index 0000000000..11b5006192
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/amazon-elastic-kubernetes-service.md
@@ -0,0 +1,30 @@
+# Amazon Elastic Kubernetes Service (EKS)
+
+import EksClusterBlueprint from './aws-eks-cluster/_eks_cluster_blueprint.mdx'
+import EksClusterConfig from './aws-eks-cluster/_eks_cluster_port_app_config.mdx'
+
+
+
+## AWS::EKS::Cluster
+
+The following example demonstrates how to ingest your AWS EKS clusters to Port.
+
+#### EKS Cluster supported actions
+
+The table below summarizes the available actions for ingesting Amazon EKS Cluster resources in Port:
+
+| Action | Description | Type | Required AWS Permission |
+|---------------------------|--------------------------------------------------------------------------------------------------------------|---------|-------------------------|
+| [DescribeClusterAction](https://docs.aws.amazon.com/eks/latest/APIReference/API_DescribeCluster.html) | Retrieve detailed configuration data for each cluster. | Default | `eks:DescribeCluster` `eks:ListClusters` |
+
+::::info All properties available by default
+EKS clusters expose their key properties via the default DescribeCluster action.
+::::
+
+You can use the following Port blueprint definitions and integration configuration:
+
+
+
+
+
+For more details about EKS cluster properties, refer to the [AWS EKS API documentation](https://docs.aws.amazon.com/eks/latest/APIReference/Welcome.html).
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/aws-eks-cluster/_eks_cluster_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/aws-eks-cluster/_eks_cluster_blueprint.mdx
new file mode 100644
index 0000000000..378b61a67a
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/aws-eks-cluster/_eks_cluster_blueprint.mdx
@@ -0,0 +1,66 @@
+
+EKS Cluster blueprint (click to expand)
+
+```json showLineNumbers
+{
+ "identifier": "eksCluster",
+ "title": "EKS Cluster",
+ "icon": "AWS",
+ "schema": {
+ "properties": {
+ "arn": {
+ "type": "string",
+ "title": "ARN",
+ "description": "The Amazon Resource Name (ARN) of the EKS cluster"
+ },
+ "name": {
+ "type": "string",
+ "title": "Name",
+ "description": "The name of the EKS cluster"
+ },
+ "version": {
+ "type": "string",
+ "title": "Kubernetes Version",
+ "description": "The Kubernetes version of the EKS cluster"
+ },
+ "status": {
+ "type": "string",
+ "title": "Status",
+ "description": "The status of the EKS cluster"
+ },
+ "endpoint": {
+ "type": "string",
+ "title": "Endpoint",
+ "description": "The endpoint URL for the EKS cluster"
+ },
+ "roleArn": {
+ "type": "string",
+ "title": "Role ARN",
+ "description": "The IAM role ARN associated with the EKS cluster"
+ },
+ "tags": {
+ "type": "object",
+ "title": "Tags",
+ "description": "Tags associated with the EKS cluster",
+ "additionalProperties": {
+ "type": "string"
+ }
+ }
+ },
+ "required": []
+ },
+ "mirrorProperties": {},
+ "calculationProperties": {},
+ "aggregationProperties": {},
+ "relations": {
+ "account": {
+ "title": "Account",
+ "target": "awsAccount",
+ "required": false,
+ "many": false
+ }
+ }
+}
+```
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/aws-eks-cluster/_eks_cluster_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/aws-eks-cluster/_eks_cluster_port_app_config.mdx
new file mode 100644
index 0000000000..d7b930d8ea
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service/aws-eks-cluster/_eks_cluster_port_app_config.mdx
@@ -0,0 +1,27 @@
+
+EKS Cluster mapping configuration (click to expand)
+
+```yaml showLineNumbers
+resources:
+ - kind: AWS::EKS::Cluster
+ selector:
+ query: 'true'
+ port:
+ entity:
+ mappings:
+ identifier: .Properties.Arn
+ title: .Properties.Name
+ blueprint: '"eksCluster"'
+ properties:
+ arn: .Properties.Arn
+ name: .Properties.Name
+ version: .Properties.Version
+ status: .Properties.Status
+ endpoint: .Properties.Endpoint
+ roleArn: .Properties.RoleArn
+ tags: .Properties.Tags
+ relations:
+ account: .__ExtraContext.AccountId
+```
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/_category_.json
new file mode 100644
index 0000000000..4502de18be
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Amazon Relational Database Service (RDS)",
+ "position": 6
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/amazon-relational-database-service.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/amazon-relational-database-service.md
new file mode 100644
index 0000000000..4f73cf4b61
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/amazon-relational-database-service.md
@@ -0,0 +1,31 @@
+# Amazon Relational Database Service (RDS)
+
+import RdsDbInstanceBlueprint from './aws-rds-db-instance/_rds_db_instance_blueprint.mdx'
+import RdsDbInstanceConfig from './aws-rds-db-instance/_rds_db_instance_port_app_config.mdx'
+
+
+
+## AWS::RDS::DBInstance
+
+The following example demonstrates how to ingest your AWS RDS DB instances to Port.
+
+#### RDS DB Instance supported actions
+
+The table below summarizes the available actions for ingesting Amazon RDS DB Instance resources in Port:
+
+| Action | Description | Type | Required AWS Permission |
+|---------------------------------|---------------------------------------------------------------------------------------------------------------------|----------|-------------------------|
+| [DescribeDBInstancesAction](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) | Discover DB instances and retrieve configuration details. | Default | `rds:DescribeDBInstances` |
+| [ListTagsForResourceAction](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ListTagsForResource.html) | Retrieve tags for each DB instance. | Optional | `rds:ListTagsForResource` |
+
+::::info 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:
+
+
+
+
+
+For more details about RDS DB instance properties, refer to the [AWS RDS API documentation](https://docs.aws.amazon.com/rds/latest/APIReference/Welcome.html).
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/aws-rds-db-instance/_rds_db_instance_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/aws-rds-db-instance/_rds_db_instance_blueprint.mdx
new file mode 100644
index 0000000000..e7b0e737cc
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/aws-rds-db-instance/_rds_db_instance_blueprint.mdx
@@ -0,0 +1,84 @@
+
+RDS DB Instance blueprint (click to expand)
+
+```json showLineNumbers
+{
+ "identifier": "rdsDbInstance",
+ "title": "RDS DB Instance",
+ "icon": "AWS",
+ "schema": {
+ "properties": {
+ "dbInstanceIdentifier": {
+ "type": "string",
+ "title": "DB Instance Identifier",
+ "description": "The unique identifier of the RDS DB instance"
+ },
+ "dbInstanceArn": {
+ "type": "string",
+ "title": "ARN",
+ "description": "The Amazon Resource Name (ARN) of the DB instance"
+ },
+ "engine": {
+ "type": "string",
+ "title": "Engine",
+ "description": "The database engine type (e.g., mysql, postgres, oracle-ee)"
+ },
+ "dbInstanceClass": {
+ "type": "string",
+ "title": "Instance Class",
+ "description": "The compute and memory capacity of the DB instance (e.g., db.t3.micro, db.m4.xlarge)"
+ },
+ "dbInstanceStatus": {
+ "type": "string",
+ "title": "Status",
+ "description": "The current status of the DB instance",
+ "enum": [
+ "available",
+ "backing-up",
+ "creating",
+ "deleting",
+ "failed",
+ "incompatible-credentials",
+ "incompatible-network",
+ "incompatible-option-group",
+ "incompatible-parameters",
+ "incompatible-restore",
+ "maintenance",
+ "modifying",
+ "rebooting",
+ "renaming",
+ "resetting-master-credentials",
+ "restore-error",
+ "storage-full",
+ "storage-optimization",
+ "upgrading"
+ ]
+ },
+ "multiAZ": {
+ "type": "boolean",
+ "title": "Multi-AZ",
+ "description": "Whether the DB instance is deployed in multiple Availability Zones"
+ },
+ "storageEncrypted": {
+ "type": "boolean",
+ "title": "Storage Encrypted",
+ "description": "Whether the DB instance storage is encrypted"
+ }
+ },
+ "required": []
+ },
+ "mirrorProperties": {},
+ "calculationProperties": {},
+ "aggregationProperties": {},
+ "relations": {
+ "account": {
+ "title": "Account",
+ "target": "awsAccount",
+ "required": false,
+ "many": false
+ }
+ }
+}
+```
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/aws-rds-db-instance/_rds_db_instance_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/aws-rds-db-instance/_rds_db_instance_port_app_config.mdx
new file mode 100644
index 0000000000..7c44ff353e
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service/aws-rds-db-instance/_rds_db_instance_port_app_config.mdx
@@ -0,0 +1,27 @@
+
+RDS DB Instance mapping configuration (click to expand)
+
+```yaml showLineNumbers
+resources:
+ - kind: AWS::RDS::DBInstance
+ selector:
+ query: 'true'
+ port:
+ entity:
+ mappings:
+ identifier: .Properties.DBInstanceArn
+ title: .Properties.DBInstanceIdentifier
+ blueprint: '"rdsDbInstance"'
+ properties:
+ dbInstanceIdentifier: .Properties.DBInstanceIdentifier
+ dbInstanceArn: .Properties.DBInstanceArn
+ engine: .Properties.Engine
+ dbInstanceClass: .Properties.DBInstanceClass
+ dbInstanceStatus: .Properties.DBInstanceStatus
+ multiAZ: .Properties.MultiAZ
+ storageEncrypted: .Properties.StorageEncrypted
+ relations:
+ account: .__ExtraContext.AccountId
+```
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/_category_.json
new file mode 100644
index 0000000000..8337352ce5
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Amazon Simple Queue Service (SQS)",
+ "position": 2
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/amazon-simple-queue-service.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/amazon-simple-queue-service.md
new file mode 100644
index 0000000000..5251a9f74e
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/amazon-simple-queue-service.md
@@ -0,0 +1,36 @@
+# Amazon Simple Queue Service (SQS)
+
+import SqsQueueBlueprint from './aws-sqs-queue/_sqs_queue_blueprint.mdx'
+import SqsQueueConfig from './aws-sqs-queue/_sqs_queue_port_app_config.mdx'
+
+
+
+
+## AWS::SQS::Queue
+
+The following example demonstrates how to ingest your AWS SQS queues to Port.
+
+#### SQS Queue supported actions
+
+The table below summarizes the available actions for ingesting Amazon SQS Queue resources in Port:
+
+| Action | Description | Type | Required AWS Permission |
+|-----------------------------|------------------------------------------------------------------------------------------|----------|-------------------------|
+| [ListQueuesAction](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ListQueues.html) | Discover all SQS queues across your AWS account. | Default | `sqs:ListQueues` |
+| [GetQueueAttributesAction](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_GetQueueAttributes.html) | Retrieve detailed configuration and operational data for each queue. | Default | `sqs:GetQueueAttributes`|
+| [ListQueueTagsAction](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ListQueueTags.html) | Bring in custom tags assigned to your queues for advanced catalog filtering and grouping. | Optional | `sqs:ListQueueTags` |
+
+:::info 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:
+
+
+
+
+
+For more details about SQS queue properties, refer to the [AWS SQS API documentation](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_GetQueueAttributes.html).
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/aws-sqs-queue/_sqs_queue_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/aws-sqs-queue/_sqs_queue_blueprint.mdx
new file mode 100644
index 0000000000..c07dad80d5
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/aws-sqs-queue/_sqs_queue_blueprint.mdx
@@ -0,0 +1,65 @@
+
+SQS Queue blueprint (click to expand)
+
+```json showLineNumbers
+{
+ "identifier": "sqsQueue",
+ "title": "SQS Queue",
+ "icon": "AWS",
+ "schema": {
+ "properties": {
+ "arn": {
+ "type": "string",
+ "title": "ARN",
+ "description": "The Amazon Resource Name (ARN) of the SQS queue"
+ },
+ "region": {
+ "type": "string",
+ "title": "Region",
+ "description": "The AWS region where the SQS queue is located"
+ },
+ "queueUrl": {
+ "type": "string",
+ "title": "Queue URL",
+ "description": "The URL of the SQS queue"
+ },
+ "approximateNumberOfMessages": {
+ "type": "number",
+ "title": "Approx Number of Messages",
+ "description": "The approximate number of messages available for retrieval from the queue"
+ },
+ "visibilityTimeout": {
+ "type": "number",
+ "title": "Visibility Timeout (seconds)",
+ "description": "The visibility timeout for the queue in seconds"
+ },
+ "messageRetentionPeriod": {
+ "type": "number",
+ "title": "Message Retention Period",
+ "description": "The length of time, in seconds, for which Amazon SQS retains a message"
+ },
+ "sqsManagedSseEnabled": {
+ "type": "boolean",
+ "title": "SQS Managed SSE Enabled",
+ "description": "Whether SQS managed server-side encryption is enabled"
+ }
+ },
+ "required": []
+ },
+ "mirrorProperties": {},
+ "calculationProperties": {},
+ "aggregationProperties": {},
+ "relations": {
+ "account": {
+ "title": "Account",
+ "target": "awsAccount",
+ "required": false,
+ "many": false
+ }
+ }
+}
+```
+
+
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/aws-sqs-queue/_sqs_queue_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/aws-sqs-queue/_sqs_queue_port_app_config.mdx
new file mode 100644
index 0000000000..96c9ef6074
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service/aws-sqs-queue/_sqs_queue_port_app_config.mdx
@@ -0,0 +1,28 @@
+
+SQS Queue mapping configuration (click to expand)
+
+```yaml showLineNumbers
+- kind: AWS::SQS::Queue
+ selector:
+ query: 'true'
+ port:
+ entity:
+ mappings:
+ identifier: .Properties.QueueArn
+ title: .Properties.QueueUrl | split("/") | .[-1]
+ blueprint: '"sqsQueue"'
+ properties:
+ arn: .Properties.QueueArn
+ region: .__ExtraContext.Region
+ queueUrl: .Properties.QueueUrl
+ approximateNumberOfMessages: .Properties.ApproximateNumberOfMessages
+ visibilityTimeout: .Properties.VisibilityTimeout
+ messageRetentionPeriod: .Properties.MessageRetentionPeriod
+ sqsManagedSseEnabled: .Properties.SqsManagedSseEnabled
+ relations:
+ account: .__ExtraContext.AccountId
+```
+
+
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/_category_.json
new file mode 100644
index 0000000000..bbe8f3f380
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Amazon Simple Storage Service (S3)",
+ "position": 2
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/amazon-simple-storage-service.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/amazon-simple-storage-service.md
new file mode 100644
index 0000000000..7863d23fe2
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/amazon-simple-storage-service.md
@@ -0,0 +1,36 @@
+# Amazon Simple Storage Service (S3)
+
+import S3BucketBlueprint from './aws-s3-bucket/_s3_bucket_blueprint.mdx'
+import S3BucketConfig from './aws-s3-bucket/_s3_bucket_port_app_config.mdx'
+
+
+
+## AWS::S3::Bucket
+
+The following example demonstrates how to ingest your AWS S3 buckets to Port.
+
+#### S3 Bucket supported actions
+
+The table below summarizes the available actions for ingesting Amazon S3 Bucket resources in Port:
+
+| Action | Description | Type | Required AWS Permission |
+|--------------------------------------|----------------------------------------------------------------|----------|---------------------------------------------------------|
+| [ListBucketsAction](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html) | Discover all S3 buckets across your AWS account. | Default | `s3:ListAllMyBuckets` |
+| [GetBucketTaggingAction](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html) | Bring in bucket tags for catalog filtering and grouping. | Default | `s3:GetBucketTagging` |
+| [GetBucketLocationAction](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLocation.html) | Retrieve the bucket's region. | Optional | `s3:GetBucketLocation` |
+| [GetBucketEncryptionAction](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html) | Retrieve server-side encryption configuration for the bucket. | Optional | `s3:GetBucketEncryption` |
+| [GetBucketPublicAccessBlockAction](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html) | Retrieve public access block configuration. | Optional | `s3:GetBucketPublicAccessBlock` |
+| [GetBucketOwnershipControlsAction](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketOwnershipControls.html) | Retrieve bucket ownership controls. | Optional | `s3:GetBucketOwnershipControls` |
+
+:::info 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:
+
+
+
+
+
+For more details about S3 bucket properties, refer to the [AWS S3 API documentation](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html).
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/s3/buckets/_s3_bucket_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/aws-s3-bucket/_s3_bucket_blueprint.mdx
similarity index 87%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/s3/buckets/_s3_bucket_blueprint.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/aws-s3-bucket/_s3_bucket_blueprint.mdx
index e2a735398d..e8b0ffa499 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/s3/buckets/_s3_bucket_blueprint.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/aws-s3-bucket/_s3_bucket_blueprint.mdx
@@ -1,5 +1,5 @@
-S3 bucket blueprint (Click to expand)
+S3 Bucket blueprint (click to expand)
```json showLineNumbers
{
@@ -13,10 +13,6 @@
"type": "string",
"title": "ARN"
},
- "region": {
- "type": "string",
- "title": "Region"
- },
"creationDate": {
"type": "string",
"format": "date-time",
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/s3/buckets/_s3_bucket_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/aws-s3-bucket/_s3_bucket_port_app_config.mdx
similarity index 55%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/s3/buckets/_s3_bucket_port_app_config.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/aws-s3-bucket/_s3_bucket_port_app_config.mdx
index 274675ca9d..230e291076 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/s3/buckets/_s3_bucket_port_app_config.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service/aws-s3-bucket/_s3_bucket_port_app_config.mdx
@@ -1,17 +1,11 @@
-S3 bucket mapping configuration (Click to expand)
+S3 Bucket mapping configuration (click to expand)
```yaml showLineNumbers
resources:
- kind: AWS::S3::Bucket
selector:
query: 'true'
- includeActions:
- # Optional: Include up to 3 additional actions for more properties
- # Choose based on which properties you need most
- # - GetBucketEncryptionAction
- # - GetBucketPublicAccessBlockAction
- # - GetBucketOwnershipControlsAction
port:
entity:
mappings:
@@ -20,7 +14,6 @@ resources:
blueprint: '"s3Bucket"'
properties:
arn: .Properties.Arn
- region: .Properties.LocationConstraint
creationDate: .Properties.CreationDate
tags: .Properties.Tags
relations:
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/_category_.json
new file mode 100644
index 0000000000..f03555f738
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "AWS Account",
+ "position": 8
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/account_info/_account_info_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/aws-account-info/_aws_account_blueprint.mdx
similarity index 61%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/account_info/_account_info_blueprint.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/aws-account-info/_aws_account_blueprint.mdx
index 1dc06bf3a0..af685c8ad7 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/account_info/_account_info_blueprint.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/aws-account-info/_aws_account_blueprint.mdx
@@ -1,11 +1,10 @@
-AccountInfo blueprint (Click to expand)
+AWS Account blueprint (click to expand)
```json showLineNumbers
{
"identifier": "awsAccount",
- "description": "This blueprint represents an AWS Account in our software catalog",
- "title": "Account",
+ "title": "AWS Account",
"icon": "AWS",
"schema": {
"properties": {},
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/account_info/_account_info_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/aws-account-info/_aws_account_port_app_config.mdx
similarity index 68%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/account_info/_account_info_port_app_config.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/aws-account-info/_aws_account_port_app_config.mdx
index 5e4d499975..ba878e223e 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/account_info/_account_info_port_app_config.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/aws-account-info/_aws_account_port_app_config.mdx
@@ -1,9 +1,9 @@
-AccountInfo mapping configuration (Click to expand)
+AWS Account info mapping configuration (click to expand)
```yaml showLineNumbers
resources:
- - kind: AccountInfo
+ - kind: AWS::Account::Info
selector:
query: 'true'
port:
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/aws-account.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/aws-account.md
new file mode 100644
index 0000000000..179ffef4a1
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account/aws-account.md
@@ -0,0 +1,20 @@
+# AWS Account
+
+import AwsAccountBlueprint from './aws-account-info/_aws_account_blueprint.mdx'
+import AwsAccountConfig from './aws-account-info/_aws_account_port_app_config.mdx'
+
+
+
+## AWS::Account::Info
+
+The following example demonstrates how to ingest AWS account information using a custom resource designed for account resync without AWS Organizations permissions.
+
+:::info Custom Resource for Account Resync
+Use `AWS::Account::Info` to resync AWS account data when you do not have organization-level permissions. If you do have AWS Organizations permissions and want to retrieve richer data (e.g., org account metadata, parents, and tags), see the AWS Organizations documentation under [AWS Organizations](../aws-organizations/aws-organizations.md).
+:::
+
+You can use the following Port blueprint definitions and integration configuration:
+
+
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/_category_.json
new file mode 100644
index 0000000000..5df876cbc8
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "AWS Lambda",
+ "position": 7
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/aws-lambda-function/_lambda_function_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/aws-lambda-function/_lambda_function_blueprint.mdx
new file mode 100644
index 0000000000..507cb90574
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/aws-lambda-function/_lambda_function_blueprint.mdx
@@ -0,0 +1,68 @@
+
+Lambda Function blueprint (click to expand)
+
+```json showLineNumbers
+{
+ "identifier": "lambdaFunction",
+ "title": "Lambda Function",
+ "icon": "AWS",
+ "schema": {
+ "properties": {
+ "FunctionName": {
+ "type": "string",
+ "title": "Function Name",
+ "description": "The name of the Lambda function"
+ },
+ "FunctionArn": {
+ "type": "string",
+ "title": "Function ARN",
+ "description": "The Amazon Resource Name (ARN) of the Lambda function"
+ },
+ "Runtime": {
+ "type": "string",
+ "title": "Runtime",
+ "description": "The runtime environment for the Lambda function"
+ },
+ "Handler": {
+ "type": "string",
+ "title": "Handler",
+ "description": "The function entry point"
+ },
+ "MemorySize": {
+ "type": "number",
+ "title": "Memory Size",
+ "description": "The amount of memory available to the function in MB"
+ },
+ "Timeout": {
+ "type": "number",
+ "title": "Timeout",
+ "description": "The function execution time limit in seconds"
+ },
+ "State": {
+ "type": "string",
+ "title": "State",
+ "description": "The current state of the function"
+ },
+ "LastModified": {
+ "type": "string",
+ "title": "Last Modified",
+ "description": "The date and time the function was last modified"
+ }
+ },
+ "required": []
+ },
+ "mirrorProperties": {},
+ "calculationProperties": {},
+ "aggregationProperties": {},
+ "relations": {
+ "account": {
+ "title": "Account",
+ "target": "awsAccount",
+ "required": false,
+ "many": false
+ }
+ }
+}
+```
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/aws-lambda-function/_lambda_function_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/aws-lambda-function/_lambda_function_port_app_config.mdx
new file mode 100644
index 0000000000..850a07df14
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/aws-lambda-function/_lambda_function_port_app_config.mdx
@@ -0,0 +1,28 @@
+
+Lambda Function mapping configuration (click to expand)
+
+```yaml showLineNumbers
+resources:
+ - kind: AWS::Lambda::Function
+ selector:
+ query: 'true'
+ port:
+ entity:
+ mappings:
+ identifier: .Properties.FunctionArn
+ title: .Properties.FunctionName
+ blueprint: '"lambdaFunction"'
+ properties:
+ FunctionName: .Properties.FunctionName
+ FunctionArn: .Properties.FunctionArn
+ Runtime: .Properties.Runtime
+ Handler: .Properties.Handler
+ MemorySize: .Properties.MemorySize
+ Timeout: .Properties.Timeout
+ State: .Properties.State
+ LastModified: .Properties.LastModified
+ relations:
+ account: .__ExtraContext.AccountId
+```
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/aws-lambda.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/aws-lambda.md
new file mode 100644
index 0000000000..0163d6245f
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda/aws-lambda.md
@@ -0,0 +1,31 @@
+# AWS Lambda
+
+import LambdaFunctionBlueprint from './aws-lambda-function/_lambda_function_blueprint.mdx'
+import LambdaFunctionConfig from './aws-lambda-function/_lambda_function_port_app_config.mdx'
+
+
+
+## AWS::Lambda::Function
+
+The following example demonstrates how to ingest your AWS Lambda functions to Port.
+
+#### Lambda Function supported actions
+
+The table below summarizes the available actions for ingesting AWS Lambda Function resources in Port:
+
+| Action | Description | Type | Required AWS Permission |
+|---------------------------|-----------------------------------------------------------------------------------------------------------|----------|-------------------------|
+| [ListFunctionsAction](https://docs.aws.amazon.com/lambda/latest/api/API_ListFunctions.html) | Discover all Lambda functions across your AWS account. | Default | `lambda:ListFunctions` |
+| [ListTagsAction](https://docs.aws.amazon.com/lambda/latest/api/API_ListTags.html) | Retrieve tags for each function. | Optional | `lambda:ListTags` |
+
+::::info 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:
+
+
+
+
+
+For more details about Lambda function properties, refer to the [AWS Lambda API documentation](https://docs.aws.amazon.com/lambda/latest/APIReference/Welcome.html).
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/_category_.json
new file mode 100644
index 0000000000..f6d3d7df82
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "AWS Organizations",
+ "position": 5
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/aws-organizations-account/_organizations_accounts_blueprint.mdx
similarity index 92%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_blueprint.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/aws-organizations-account/_organizations_accounts_blueprint.mdx
index a0d7a6a671..ddd5e7e80e 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_blueprint.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/aws-organizations-account/_organizations_accounts_blueprint.mdx
@@ -1,5 +1,5 @@
-Organizations Account blueprint (Click to expand)
+Organizations Account blueprint (click to expand)
```json showLineNumbers
{
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/aws-organizations-account/_organizations_accounts_port_app_config.mdx
similarity index 89%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_port_app_config.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/aws-organizations-account/_organizations_accounts_port_app_config.mdx
index af47e5ed3e..68f051c567 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/organizations/accounts/_organizations_accounts_port_app_config.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/aws-organizations-account/_organizations_accounts_port_app_config.mdx
@@ -1,5 +1,5 @@
-Organizations Account mapping configuration (Click to expand)
+Organizations Account mapping configuration (click to expand)
```yaml showLineNumbers
resources:
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/aws-organizations.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/aws-organizations.md
new file mode 100644
index 0000000000..d0e0e856a4
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations/aws-organizations.md
@@ -0,0 +1,32 @@
+# AWS Organizations
+
+import OrganizationsAccountBlueprint from './aws-organizations-account/_organizations_accounts_blueprint.mdx'
+import OrganizationsAccountConfig from './aws-organizations-account/_organizations_accounts_port_app_config.mdx'
+
+
+
+## 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](https://docs.aws.amazon.com/organizations/latest/APIReference/API_ListAccounts.html) | Discover organization accounts and retrieve account metadata. | Default | `organizations:ListAccounts` |
+| [ListTagsForResourceAction](https://docs.aws.amazon.com/organizations/latest/APIReference/API_ListTagsForResource.html) | Retrieve tags for the specified account. | Optional | `organizations:ListTagsForResource`|
+| [ListParentsAction](https://docs.aws.amazon.com/organizations/latest/APIReference/API_ListParents.html) | Retrieve parent information for the specified account. | Optional | `organizations:ListParents` |
+
+:::info 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:
+
+
+
+
+
+For more details about Organizations accounts, refer to the [AWS Organizations API documentation](https://docs.aws.amazon.com/organizations/latest/APIReference/Welcome.html).
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/resource-and-property-reference.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/resource-and-property-reference.md
new file mode 100644
index 0000000000..b572ce3bf3
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/resource-and-property-reference.md
@@ -0,0 +1,123 @@
+# AWS resource and property reference
+
+Welcome to the reference guide for AWS resource, actions and properties, as supported by AWS CloudFormation and used in Port integrations.
+
+## Supported resource types
+
+Explore detailed documentation for each AWS resource and action available for integration. For each resource type, you will find information about supported actions, required permissions, and usage best practices.
+
+Resource type identifiers follow a standardized format, allowing you to easily recognize and reference each AWS entity:
+
+```
+service-provider::service-name::data-type-name
+```
+
+For example, an EC2 instance is identified as:
+
+```
+AWS::EC2::Instance
+```
+
+Refer to the sidebar or the list below to navigate to individual resource reference pages where you will find actionable integration details, sample configurations, and official AWS documentation links.
+
+- [Amazon Simple Queue Service](./amazon-simple-queue-service/amazon-simple-queue-service.md)
+- [Amazon Simple Storage Service](./amazon-simple-storage-service/amazon-simple-storage-service.md)
+- [Amazon Elastic Compute Cloud](./amazon-elastic-compute-cloud/amazon-elastic-compute-cloud.md)
+- [Amazon Elastic Container Service](./amazon-elastic-container-service/amazon-elastic-container-service.md)
+- [Amazon Elastic Kubernetes Service](./amazon-elastic-kubernetes-service/amazon-elastic-kubernetes-service.md)
+- [Amazon Relational Database Service](./amazon-relational-database-service/amazon-relational-database-service.md)
+- [AWS Lambda](./aws-lambda/aws-lambda.md)
+- [AWS Account](./aws-account/aws-account.md)
+- [AWS Organizations](./aws-organizations/aws-organizations.md)
+
+:::info More Resource Types Coming Soon
+We're continuously expanding support for additional AWS resource types to ensure comprehensive coverage of your AWS infrastructure.
+
+If you need support for a specific AWS resource or action that isn’t yet available, please consider opening a feature request or reach out to us through chat, Slack, or our [Support Portal](http://support.port.io/).
+
+Your feedback helps us prioritize what to build next.
+:::
+
+## Actions
+
+**Actions** define the set of API operations performed to discover and fetch resources within your AWS environment. These actions are mapped directly to AWS API calls—for example, `DescribeInstances` for EC2 or `ListBuckets` for S3—which determine the resource data that Port can ingest and keep up to date.
+
+:::caution Ensure required AWS permissions are granted
+Each action requires specific AWS IAM permissions. Your integration’s AWS credentials must have these permissions; otherwise, the action will not succeed and its data will not be available in Port.
+:::
+
+### How Actions Map to AWS Operations
+
+Each Port-supported resource type comes with a set of actions that align with AWS's official API operations. For instance:
+
+- For **Amazon S3 Buckets**, the `ListBucketsAction` leverages the [ListBuckets API](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html), and additional actions like `GetBucketTaggingAction` or `GetBucketEncryptionAction` invoke their respective AWS endpoints.
+- For **EC2 Instances**, `DescribeInstancesAction` maps to the [DescribeInstances API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html) and brings in detailed instance configuration.
+
+These mappings ensure that only the properties available from the selected AWS actions are ingested into your Port catalog.
+
+### Enabling and Customizing Actions
+
+With Port, you have full control over which AWS resource properties are discovered and ingested into your catalog by specifying the actions to use for each resource type. Actions define what data you collect and the AWS permissions required.
+
+- **Default Actions**: These are enabled automatically, ensuring basic discovery such as listing all S3 buckets or EC2 instances without additional configuration.
+- **Optional Actions**: Enable these to collect more detailed properties for your AWS resources. You must explicitly add optional actions in your integration configuration for Port to use them.
+
+To collect additional properties from AWS resources, add the optional actions you need to the `includeActions` field of your configuration. For example, to include status details from EC2 instances by enabling the `DescribeInstanceStatusAction`, add the following:
+
+```yaml showLineNumbers
+- kind: AWS::EC2::Instance
+ selector:
+ query: 'true'
+ includeActions:
+ - DescribeInstanceStatusAction
+
+In this configuration, Port will enrich your catalog by fetching all properties provided by the [DescribeInstanceStatus API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceStatus.html) for every EC2 instance.
+
+:::caution Action limit
+You can include a **maximum of 3 optional actions per resource kind** (excluding default actions). To use more than 3 actions, you can configure multiple resource kinds in your integration.
+:::
+
+
+### Querying resources from specific regions
+
+The `regionPolicy` selector lets you control which AWS regions are queried by the integration. Use it to include or exclude regions per resource.
+
+- allow: List of regions explicitly permitted for querying
+- deny: List of regions explicitly excluded from querying
+
+#### How `regionPolicy` works
+
+1. If both lists are empty: all regions are allowed.
+2. If the region is in `deny`: it is excluded unless explicitly allowed.
+3. If the region is in `allow`: it is included for querying.
+4. If a region appears in both lists: it is excluded.
+5. If only `deny` is specified: only regions in the `deny` list are excluded.
+6. If only `allow` is specified: only regions in the `allow` list are included.
+
+#### Example configuration
+
+```yaml showLineNumbers
+resources:
+ - kind: AWS::Lambda::Function
+ selector:
+ query: 'true'
+ regionPolicy:
+ allow: ["us-east-1", "eu-west-1"]
+ deny: ["us-west-2"]
+ port:
+ entity:
+ mappings:
+ identifier: .Properties.Arn
+ title: .Properties.FunctionName
+ blueprint: '"lambda"'
+ properties:
+ region: .__Region
+ description: .Properties.Description
+ arn: .Properties.Arn
+ relations:
+ account: .__ExtraContext.AccountId
+```
+
+In this example, resources in `us-east-1` and `eu-west-1` are allowed, while `us-west-2` is denied.
+
+Refer to the individual resource documentation pages for a table of actions, their AWS mapping, and necessary IAM permissions.