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.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..282e90ef7a --- /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,68 @@ + +
+Lambda instance blueprint (click to expand) + +```json showLineNumbers +{ + "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..31848f3ea0 --- /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,38 @@ +
+Lambda instance mapping configuration (click to expand) + +```json showLineNumbers +{ + "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..ab97f518dd --- /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,44 @@ +
+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