CLcloudzero
costformation

POST /v2/costformation/definition/versions

Create a new CloudZero CostFormation Definition version. Ten (10) MB is the general payload size limitation and it cannot be raised. For more information, see the Sample Python CostFormation Script.

Request

Query parameters

validate_onlystring

If passed, the endpoint will only validate the CloudZero CostFormation definition, and NOT save or publish.

namespacestring

If using namespaced multi-file CloudZero CostFormation, specify the namespace to interact with.

Headers

cloudzero-idempotency-keystring

If passed, any subsequent operation with the same value for this header will return the exact same result. This is true for all responses, i.e. successes and errors.

cloudzero-test-keystring

If passed, the operation executes in the namespace specified by this key. Resource mutations in the namespace last for 1 hour.

Request body multipart/form-data

Response

Successful Operation

OR
object required

Empty response if validate_only=true

Example response

{
  "version": {
    "version": "3",
    "last_updated_by": "api-key-id-abc123",
    "uri": "https://example-presigned-url.s3.amazonaws.com/versions/3/definition.cfdl?X-Amz-Signature=abcdef123456"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.