From 33fdb92ad727d0f7626d2e37fd3e97109552e123 Mon Sep 17 00:00:00 2001 From: shariff-6 Date: Mon, 6 Oct 2025 11:58:46 +0300 Subject: [PATCH 1/4] Ads aws lambda function example --- .../cloud-providers/aws-v3/examples.md | 21 +++++++ .../_aws_lambda_function_blueprint.mdx | 63 +++++++++++++++++++ .../_aws_lambda_function_port_app_config.mdx | 33 ++++++++++ .../_aws_lambda_function_properties.mdx | 40 ++++++++++++ 4 files changed, 157 insertions(+) create mode 100644 docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx create mode 100644 docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx create mode 100644 docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_properties.mdx 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 index 676070c90f..786bec4a52 100644 --- 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 @@ -16,6 +16,9 @@ import Ec2InstanceProperties from './examples/ec2/instances/_ec2_instance_proper 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' +import AwsLambdaFunctionBlueprint from './examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx' +import AwsLambdaFunctionConfig from './examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx' +import AwsLambdaFunctionProperties from './examples/aws_lambda/function/_aws_lambda_function_properties.mdx' # Examples @@ -107,6 +110,24 @@ You can reference any of the following EC2 instance properties in your mapping c 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). +## AWS Lambda + +### Lambda Functions + +The following example demonstrates how to ingest your AWS Lambda functions to Port. + +You can use the following Port blueprint definitions and integration configuration: + + + + + +You can reference any of the following Lambda function properties in your mapping configuration: + + + +For more details about Lambda function properties, refer to the [AWS Lambda API documentation](https://docs.aws.amazon.com/lambda/latest/APIReference/API_GetFunction.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/aws_lambda/function/_aws_lambda_function_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx new file mode 100644 index 0000000000..92a86a7d9a --- /dev/null +++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx @@ -0,0 +1,63 @@ +```json +{ + "identifier": "aws_lambda_function", + "title": "AWS Lambda Function", + "icon": "AWS", + "schema": { + "properties": { + "function_name": { + "type": "string", + "title": "Function Name", + "description": "The name of the Lambda function" + }, + "function_arn": { + "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 that Lambda calls to begin execution" + }, + "memory_size": { + "type": "number", + "title": "Memory Size (MB)", + "description": "The amount of memory available to the function at runtime" + }, + "timeout": { + "type": "number", + "title": "Timeout (seconds)", + "description": "The amount of time that Lambda allows a function to run before stopping it" + }, + "state": { + "type": "string", + "title": "State", + "description": "The current state of the Lambda function" + }, + "last_modified": { + "type": "string", + "title": "Last Modified", + "description": "The date and time that the function was last updated" + }, + "description": { + "type": "string", + "title": "Description", + "description": "A description of the function" + }, + "role": { + "type": "string", + "title": "Execution Role", + "description": "The Amazon Resource Name (ARN) of the function's execution role" + } + }, + "required": ["function_name", "function_arn"] + } +} +``` + diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx new file mode 100644 index 0000000000..1d30ab4532 --- /dev/null +++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx @@ -0,0 +1,33 @@ +```json +{ + "resources": [ + { + "kind": "aws_lambda/function", + "port": { + "entity": { + "mappings": [ + { + "identifier": ".FunctionName", + "title": ".FunctionName", + "blueprint": "aws_lambda_function", + "properties": { + "function_name": ".FunctionName", + "function_arn": ".FunctionArn", + "runtime": ".Runtime", + "handler": ".Handler", + "memory_size": ".MemorySize", + "timeout": ".Timeout", + "state": ".State", + "last_modified": ".LastModified", + "description": ".Description", + "role": ".Role" + } + } + ] + } + } + } + ] +} +``` + diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_properties.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_properties.mdx new file mode 100644 index 0000000000..784a9b67c5 --- /dev/null +++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_properties.mdx @@ -0,0 +1,40 @@ +| Property | Type | Description | +|----------|------|-------------| +| `Architectures` | `list[str]` | The instruction set architecture that the function supports | +| `CodeSha256` | `str` | The SHA256 hash of the function's deployment package | +| `CodeSize` | `int` | The size of the function's deployment package, in bytes | +| `DeadLetterConfig` | `dict[str, Any]` | The dead letter queue configuration | +| `Description` | `str` | A description of the function | +| `Environment` | `dict[str, Any]` | The environment variables for the Lambda function | +| `EphemeralStorage` | `dict[str, Any]` | The size of the function's /tmp directory in MB | +| `FileSystemConfigs` | `list[dict[str, Any]]` | Connection settings for an Amazon EFS file system | +| `FunctionArn` | `str` | The function's Amazon Resource Name (ARN) | +| `FunctionName` | `str` | The name of the function | +| `Handler` | `str` | The function that Lambda calls to begin execution | +| `ImageConfigResponse` | `dict[str, Any]` | Configuration values that override the container image Dockerfile settings | +| `KmsKeyArn` | `str` | The KMS key that's used to encrypt the function's environment variables | +| `LastModified` | `str` | The date and time that the function was last updated | +| `LastUpdateStatus` | `str` | The status of the last update that was performed on the function | +| `LastUpdateStatusReason` | `str` | The reason for the last update that was performed on the function | +| `LastUpdateStatusReasonCode` | `str` | The reason code for the last update that was performed on the function | +| `Layers` | `list[dict[str, Any]]` | The function's layers | +| `LoggingConfig` | `dict[str, Any]` | The function's logging configuration | +| `MasterArn` | `str` | For Lambda@Edge functions, the ARN of the master function | +| `MemorySize` | `int` | The amount of memory available to the function at runtime | +| `PackageType` | `str` | The type of deployment package | +| `RevisionId` | `str` | The latest updated revision of the function or alias | +| `Role` | `str` | The function's execution role | +| `Runtime` | `str` | The runtime environment for the Lambda function | +| `RuntimeVersionConfig` | `dict[str, Any]` | The runtime version configuration | +| `SigningJobArn` | `str` | The ARN of the signing job | +| `SigningProfileVersionArn` | `str` | The ARN of the signing profile version | +| `SnapStart` | `dict[str, Any]` | Set `ApplyOn` to `PublishedVersions` to create a snapshot of the initialized execution environment when you publish a function version | +| `State` | `str` | The current state of the function | +| `StateReason` | `str` | The reason for the function's current state | +| `StateReasonCode` | `str` | The reason code for the function's current state | +| `Tags` | `list[dict[str, Any]]` | The function's tags | +| `Timeout` | `int` | The amount of time that Lambda allows a function to run before stopping it | +| `TracingConfig` | `dict[str, Any]` | The function's AWS X-Ray tracing configuration | +| `Version` | `str` | The version of the Lambda function | +| `VpcConfig` | `dict[str, Any]` | The function's networking configuration | + From 778789e3cfb06e1cdf1d09caee48dddc516d3ad3 Mon Sep 17 00:00:00 2001 From: Mohammed Shariff Date: Mon, 13 Oct 2025 12:12:46 +0300 Subject: [PATCH 2/4] Update docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx Co-authored-by: sivanel97 --- .../aws_lambda/function/_aws_lambda_function_blueprint.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx index 92a86a7d9a..7c1f84fa44 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx @@ -1,4 +1,8 @@ -```json + +
+Lambda instance blueprint (click to expand) + +```json showLineNumbers { "identifier": "aws_lambda_function", "title": "AWS Lambda Function", From b3cdc08db02848e7062919f8fed24ab79a92a6a7 Mon Sep 17 00:00:00 2001 From: Mohammed Shariff Date: Mon, 13 Oct 2025 12:13:11 +0300 Subject: [PATCH 3/4] Update docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx Co-authored-by: sivanel97 --- .../function/_aws_lambda_function_port_app_config.mdx | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx index 1d30ab4532..ad39b9eb97 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx @@ -1,4 +1,7 @@ -```json +
+Lambda instance mapping configuration (click to expand) + +```json showLineNumbers { "resources": [ { From 6f8a7f2959c3e2c42f9e0172140faab6aef7d677 Mon Sep 17 00:00:00 2001 From: shariff-6 Date: Mon, 13 Oct 2025 12:31:26 +0300 Subject: [PATCH 4/4] Add support for AWS Lambda Functions in documentation - Updated Overview.md to include Lambda Functions as a supported resource type. - Enhanced Lambda function properties documentation with a collapsible details section for better readability. --- .../cloud-providers/aws-v3/Overview.md | 1 + .../_aws_lambda_function_blueprint.mdx | 1 + .../_aws_lambda_function_port_app_config.mdx | 2 + .../_aws_lambda_function_properties.mdx | 82 ++++++++++--------- 4 files changed, 47 insertions(+), 39 deletions(-) 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 dcb05d823b..f209357a92 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 @@ -32,6 +32,7 @@ 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. +- `Lambda Functions`: Function details, runtime configuration, and execution metadata. :::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/aws_lambda/function/_aws_lambda_function_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx index 7c1f84fa44..282e90ef7a 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_blueprint.mdx @@ -65,3 +65,4 @@ } ``` +
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx index ad39b9eb97..31848f3ea0 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_port_app_config.mdx @@ -34,3 +34,5 @@ } ``` +
+ diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_properties.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_properties.mdx index 784a9b67c5..ab97f518dd 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_properties.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/examples/aws_lambda/function/_aws_lambda_function_properties.mdx @@ -1,40 +1,44 @@ -| Property | Type | Description | -|----------|------|-------------| -| `Architectures` | `list[str]` | The instruction set architecture that the function supports | -| `CodeSha256` | `str` | The SHA256 hash of the function's deployment package | -| `CodeSize` | `int` | The size of the function's deployment package, in bytes | -| `DeadLetterConfig` | `dict[str, Any]` | The dead letter queue configuration | -| `Description` | `str` | A description of the function | -| `Environment` | `dict[str, Any]` | The environment variables for the Lambda function | -| `EphemeralStorage` | `dict[str, Any]` | The size of the function's /tmp directory in MB | -| `FileSystemConfigs` | `list[dict[str, Any]]` | Connection settings for an Amazon EFS file system | -| `FunctionArn` | `str` | The function's Amazon Resource Name (ARN) | -| `FunctionName` | `str` | The name of the function | -| `Handler` | `str` | The function that Lambda calls to begin execution | -| `ImageConfigResponse` | `dict[str, Any]` | Configuration values that override the container image Dockerfile settings | -| `KmsKeyArn` | `str` | The KMS key that's used to encrypt the function's environment variables | -| `LastModified` | `str` | The date and time that the function was last updated | -| `LastUpdateStatus` | `str` | The status of the last update that was performed on the function | -| `LastUpdateStatusReason` | `str` | The reason for the last update that was performed on the function | -| `LastUpdateStatusReasonCode` | `str` | The reason code for the last update that was performed on the function | -| `Layers` | `list[dict[str, Any]]` | The function's layers | -| `LoggingConfig` | `dict[str, Any]` | The function's logging configuration | -| `MasterArn` | `str` | For Lambda@Edge functions, the ARN of the master function | -| `MemorySize` | `int` | The amount of memory available to the function at runtime | -| `PackageType` | `str` | The type of deployment package | -| `RevisionId` | `str` | The latest updated revision of the function or alias | -| `Role` | `str` | The function's execution role | -| `Runtime` | `str` | The runtime environment for the Lambda function | -| `RuntimeVersionConfig` | `dict[str, Any]` | The runtime version configuration | -| `SigningJobArn` | `str` | The ARN of the signing job | -| `SigningProfileVersionArn` | `str` | The ARN of the signing profile version | -| `SnapStart` | `dict[str, Any]` | Set `ApplyOn` to `PublishedVersions` to create a snapshot of the initialized execution environment when you publish a function version | -| `State` | `str` | The current state of the function | -| `StateReason` | `str` | The reason for the function's current state | -| `StateReasonCode` | `str` | The reason code for the function's current state | -| `Tags` | `list[dict[str, Any]]` | The function's tags | -| `Timeout` | `int` | The amount of time that Lambda allows a function to run before stopping it | -| `TracingConfig` | `dict[str, Any]` | The function's AWS X-Ray tracing configuration | -| `Version` | `str` | The version of the Lambda function | -| `VpcConfig` | `dict[str, Any]` | The function's networking configuration | +
+Lambda function properties (click to expand) +| Property | JQ Path | Type | Action Required | +|----------|---------|------|-----------------| +| Architectures | `.Properties.Architectures` | array | ListFunctionsAction (default) | +| Code SHA256 | `.Properties.CodeSha256` | string | ListFunctionsAction (default) | +| Code Size | `.Properties.CodeSize` | number | ListFunctionsAction (default) | +| Dead Letter Config | `.Properties.DeadLetterConfig` | object | ListFunctionsAction (default) | +| Description | `.Properties.Description` | string | ListFunctionsAction (default) | +| Environment | `.Properties.Environment` | object | ListFunctionsAction (default) | +| Ephemeral Storage | `.Properties.EphemeralStorage` | object | ListFunctionsAction (default) | +| File System Configs | `.Properties.FileSystemConfigs` | array | ListFunctionsAction (default) | +| Function ARN | `.Properties.FunctionArn` | string | ListFunctionsAction (default) | +| Function Name | `.Properties.FunctionName` | string | ListFunctionsAction (default) | +| Handler | `.Properties.Handler` | string | ListFunctionsAction (default) | +| Image Config Response | `.Properties.ImageConfigResponse` | object | ListFunctionsAction (default) | +| KMS Key ARN | `.Properties.KmsKeyArn` | string | ListFunctionsAction (default) | +| Last Modified | `.Properties.LastModified` | string | ListFunctionsAction (default) | +| Last Update Status | `.Properties.LastUpdateStatus` | string | ListFunctionsAction (default) | +| Last Update Status Reason | `.Properties.LastUpdateStatusReason` | string | ListFunctionsAction (default) | +| Last Update Status Reason Code | `.Properties.LastUpdateStatusReasonCode` | string | ListFunctionsAction (default) | +| Layers | `.Properties.Layers` | array | ListFunctionsAction (default) | +| Logging Config | `.Properties.LoggingConfig` | object | ListFunctionsAction (default) | +| Master ARN | `.Properties.MasterArn` | string | ListFunctionsAction (default) | +| Memory Size | `.Properties.MemorySize` | number | ListFunctionsAction (default) | +| Package Type | `.Properties.PackageType` | string | ListFunctionsAction (default) | +| Revision ID | `.Properties.RevisionId` | string | ListFunctionsAction (default) | +| Role | `.Properties.Role` | string | ListFunctionsAction (default) | +| Runtime | `.Properties.Runtime` | string | ListFunctionsAction (default) | +| Runtime Version Config | `.Properties.RuntimeVersionConfig` | object | ListFunctionsAction (default) | +| Signing Job ARN | `.Properties.SigningJobArn` | string | ListFunctionsAction (default) | +| Signing Profile Version ARN | `.Properties.SigningProfileVersionArn` | string | ListFunctionsAction (default) | +| Snap Start | `.Properties.SnapStart` | object | ListFunctionsAction (default) | +| State | `.Properties.State` | string | ListFunctionsAction (default) | +| State Reason | `.Properties.StateReason` | string | ListFunctionsAction (default) | +| State Reason Code | `.Properties.StateReasonCode` | string | ListFunctionsAction (default) | +| Tags | `.Properties.Tags` | array | ListTagsAction (optional) | +| Timeout | `.Properties.Timeout` | number | ListFunctionsAction (default) | +| Tracing Config | `.Properties.TracingConfig` | object | ListFunctionsAction (default) | +| Version | `.Properties.Version` | string | ListFunctionsAction (default) | +| VPC Config | `.Properties.VpcConfig` | object | ListFunctionsAction (default) | + +
\ No newline at end of file