@aws-cdk/cx-api

What is @aws-cdk/cx-api?

@aws-cdk/cx-api is a part of the AWS Cloud Development Kit (CDK) that provides a set of APIs for interacting with the Cloud Assembly, which is the output of the CDK synthesis process. It allows developers to programmatically access and manipulate the synthesized cloud infrastructure stacks, assets, and metadata.

What are @aws-cdk/cx-api's main functionalities?

Accessing Cloud Assembly

This feature allows you to load and interact with a Cloud Assembly, which is the output directory of a CDK app synthesis. The code sample demonstrates how to load a Cloud Assembly from a specified path and log the stacks it contains.

const cxapi = require('@aws-cdk/cx-api');
const assembly = new cxapi.CloudAssembly('/path/to/cloud-assembly');
console.log(assembly.stacks);

Reading Stack Metadata

This feature allows you to read metadata from a specific stack within the Cloud Assembly. The code sample shows how to get a stack by its name and log its metadata.

const cxapi = require('@aws-cdk/cx-api');
const assembly = new cxapi.CloudAssembly('/path/to/cloud-assembly');
const stack = assembly.getStackByName('MyStack');
console.log(stack.metadata);

Listing Assets

This feature allows you to list all the assets included in the Cloud Assembly. The code sample demonstrates how to log all the assets in the Cloud Assembly.

const cxapi = require('@aws-cdk/cx-api');
const assembly = new cxapi.CloudAssembly('/path/to/cloud-assembly');
console.log(assembly.assets);

Other packages similar to @aws-cdk/cx-api

aws-sdk

The AWS SDK for JavaScript provides a comprehensive set of APIs for interacting with AWS services. While it does not specifically focus on the Cloud Assembly or CDK synthesis output, it allows for a wide range of AWS service interactions, including managing infrastructure, which can complement the use of @aws-cdk/cx-api.

serverless

The Serverless Framework is a popular open-source framework for building and deploying serverless applications. It provides functionalities for defining and deploying cloud infrastructure, similar to the CDK, but focuses on serverless architectures. It does not provide direct access to a Cloud Assembly like @aws-cdk/cx-api.

terraform

Terraform by HashiCorp is an open-source infrastructure as code software tool that provides a consistent CLI workflow to manage hundreds of cloud services. It allows for the definition, preview, and deployment of cloud infrastructure. While it serves a similar purpose to the CDK, it does not have a direct equivalent to the Cloud Assembly or @aws-cdk/cx-api.

README

Cloud Executable protocol

---

This is a developer preview (public beta) module. Releases might lack important features and might have future breaking changes.

This API is still under active development and subject to non-backward compatible changes or removal in any future version. Use of the API is not recommended in production environments. Experimental APIs are not subject to the Semantic Versioning model.

---

This module is part of the AWS Cloud Development Kit project.

Changelog

1.9.0 (2019-09-19)

Bug Fixes

• apigateway: cross-stack lambda integration causes a cyclic reference (#4010) (17fc967), closes #3705 #3000
• apigateway: json schema additionalProperties should be boolean (#3997) (73a1de1)
• cloudfront: actually default 'compress' to true (#3359) (364fd56)
• core: stack.urlSuffix is no longer scoped (#4011) (82e08bc), closes #3970
• ec2: fix subnet selection on looked-up VPCs (#4090) (4a113e6), closes #3650
• ec2: improve errors around subnet selection (#4089) (2392108), closes #3859
• elbv2: allow multiple certificates on ALB listener (#4116) (d1f8e5c), closes #3757
• elbv2: fix cross-stack use of ALB (#4111) (7dfd6be)
• elbv2: unhealthyHostCount metric case fix (#4133) (899656c)
• events: remove custom resource for fargate event target (#3952) (920f12f), closes #3930
• events: remove policy statement from CF template when using AwsApi (#4037) (2e67c2d)
• route53: remove http:// from bucket target (#4070) (621441d)

Features

• codebuild: add support of Amazon Linux 2 image (#4052) (#4055) (f63bf6f)
• codepipeline: cross-environment (account+region) actions (#3694) (69bff3d), closes #52 #1584 #2517 #2569 #3275 #3138 #3388
• codepipeline: handle non-CFN cross-region actions (#3777) (b8b4c4d), closes #3387
• cognito: add PreTokenGeneration lambda trigger support (#3910) (e9f46da), closes #2497
• ecs: add additional log drivers (#3762) (f308f1d), closes #3761
• ecs: allow load balancing to any container and port of service (#4107) (c3b3c93)
• iam: support NotPrincipal in policy statements (#4077) (9945d9e)
• route53: Domain redirect pattern (#3946) (3ac4671), closes #3893
• s3-deployment: allow multiple Sources for single Deployment (#4105) (2ce4a87)
• update baseline requirement for node engine to 10.3.0 (#4135) (d5ab865)
• sns: add support for attribute key matching in message filtering (#3709) (dbf0134)
• upgrade CloudFormation resource specification to v6.1.0 (#4112) (3d693e6)
• toolkit: conditionally emit AWS::CDK::Metadata resource (#3692) (5901d6e), closes #3648

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• s3-deployment: Property source is now sources and is a Source array