REST Resource: catalogs.products.versions

Resource: Version

The producer representation of a version, which is a child resource under a Product with asset data.

JSON representation
{
  "name": string,
  "description": string,
  "asset": {
    object
  },
  "originalAsset": {
    object
  },
  "createTime": string,
  "updateTime": string
}
Fields
name

string

Required. The resource name of the version, in the format `catalogs/{catalog_id}/products/{product_id}/versions/[a-z][-a-z0-9]*[a-z0-9]'.

A unique identifier for the version under a product, which can't be changed after the version is created. The final segment of the name must between 1 and 63 characters in length.

description

string

The user-supplied description of the version. Maximum of 256 characters.

asset

object (Struct format)

Output only. The asset which has been validated and is ready to be provisioned. See Version.original_asset for the schema.

originalAsset

object (Struct format)

The user-supplied asset payload. The maximum size of the payload is 2MB. The JSON schema of the payload is defined as:

type: object
properties:
  mainTemplate:
    type: string
    description: The file name of the main template and name prefix of
    schema file. The content of the main template should be set in the
    imports list. The schema file name is expected to be
    <mainTemplate>.schema in the imports list. required: true
  imports:
    type: array
    description: Import template and schema file contents. Required to have
    both <mainTemplate> and <mainTemplate>.schema files. required: true
    minItems: 2
    items:
      type: object
      properties:
        name:
          type: string
        content:
          type: string

createTime

string (Timestamp format)

Output only. The time when the version was created.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The time when the version was last updated.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

Methods

create

Creates a Version instance under a given Product.

delete

Hard deletes a Version.

get

Returns the requested Version resource.

list

Lists Version resources that the producer has access to, within the scope of the parent Product.

patch

Updates a specific Version resource.