Sign in

v1

latestOpenAPI 3.1.0BSD-32026-07-2471176175.5 KB
costformation

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.

post/v2/costformation/definition/versions

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.

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"
  }
}