Get deployment templates

edit

Retrieves all deployment templates.

Request

edit

GET /api/v1/deployments/templates

Query parameters

edit
Name Type Required Description

metadata

string

N

An optional key/value pair in the form of (key:value) that will act as a filter and exclude any templates that do not have a matching metadata item associated.

region

string

Y

Region of the deployment templates

show_hidden

boolean; default: false

N

If true, templates flagged as hidden will be returned.

show_instance_configurations

boolean; default: true

N

If true, will return details for each instance configuration referenced by the template.

show_max_zones

boolean; default: false

N

If true, will populate the max_zones field in the instance configurations. Only relevant if show_instance_configurations=true.

stack_version

string

N

If present, it will cause the returned deployment templates to be adapted to return only the elements allowed in that version.

Responses

edit
200

(array[DeploymentTemplateInfoV2])

The deployment templates were returned successfully.

400

(BasicFailedReply)

The requested region was not found. (code: templates.region_not_found)

Headers

x-cloud-error-codes (string; allowed values: [templates.region_not_found])
The error codes associated with the response
401

(BasicFailedReply)

The user is not authorized to access requested region. (code: templates.region_not_allowed)

Headers

x-cloud-error-codes (string; allowed values: [templates.region_not_allowed])
The error codes associated with the response

Request example

edit
curl -XGET https://{{hostname}}/api/v1/deployments/templates \
-H "Authorization: ApiKey $ECE_API_KEY"