Get details of a specific OS configuration template

View as Markdown

Admin clients may view all OS templates; all other clients can only view templates belonging to their own organization.

Required scope: air:image_read (roles: air_image_publisher, air_image_uploader, air_org_admin, air_user)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequiredformat: "uuid"
A UUID string identifying this os template.

Response

idstringRead-onlyformat: "uuid"
createddatetimeRead-only
modifieddatetimeRead-only
os_typestring<=128 characters
OS family identifier.
os_template_versionstring<=255 characters
Template version string.
rendermap from strings to objects

Dict mapping canonical absolute POSIX paths to render entries. Keys must start with / and contain no .. or . segments, redundant separators, or trailing separator. Each value has a required content (template body) plus optional owner, group, and mode (default root/root/0644).

orgstringRead-onlyformat: "uuid"
The org that owns this OS template. Taken from the creator.
creatorstring or nullRead-only
The username of the user who created the OS template.
generatemap from strings to enumsOptional
Dict mapping variable names to generation strategies.
varslist of stringsOptional
Variable names the render templates reference. Must exactly match the variables used across the render bodies.

Errors

403
Forbidden Error
404
Not Found Error
500
Internal Server Error