submit - CloudFormation Command Line Interface

submit

Description

Registers the resource provider with CloudFormation, in the specified region. Registering a resource provider makes it available for use in CloudFormation operations. Registering includes:

  • Validating the resource schema.

  • Packaging up the resource project files and uploading them to CloudFormation.

    This includes the source code for your resource handlers. These resource handlers run within the CloudFormation account.

  • Determining which handlers have been specified for the resource, and running the appropriate contract tests.

  • Uploading the resource handlers as functions that CloudFormation calls at the appropriate times in a resource's lifecycle.

  • Returning a registration token that you can use with the DescribeTypeRegistration action to track the status of the registration request.

Note

As part of registering a resource provider type, CloudFormation must be able to access the S3 bucket which contains the schema handler package for that resource provider. For more information, see IAM Permissions for Registering a Resource Provider in the AWS CloudFormation User Guide.

Synopsis

cfn submit [--dry-run] [--endpoint-url <value>] [--region <value>] [--role-arn <value>] [--no-role] [--set-default]

Options

--dry-run

Validate the schema and package up the project files, but do not register the resource provider with CloudFormation.

--endpoint-url <value>

The CloudFormation endpoint to use.

--region <value>

The AWS region in which to register the resource provider. If no region is specified, the resource provider is registered in the default region.

--role-arn <value>

A specific IAM role to use when invoking handler operations.

If you do not specify an IAM role, the CloudFormation CLI attempts to create or update an execution role based on the execution role template derived from the resource type's schema, and then passes this execution role to CloudFormation. For more information, see Accessing AWS APIs from a Resource Type.

You cannot specify both --role-arn and --no-role arguments.

--no-role

Prevent the CloudFormation CLI from passing an execution role to CloudFormation.

If your resource type calls AWS APIs in any of its handlers, you must either specify a role arn, or have the CloudFormation CLI create or update an execution role and pass that execution role to CloudFormation. For more information, see Accessing AWS APIs from a Resource Type.

You cannot specify both --role-arn and --no-role arguments.

--set-default

Upon successful registration of the type version, sets the current type version as the default version.

Output

Resource provider registration is an asynchronous operation. You can use the supplied registration token to track the progress of your provider registration request using the DescribeTypeRegistration action of the CloudFormation API.