• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
HashiCorp Cloud Platform
  • Tutorials
  • Documentation
  • Try Cloud(opens in new tab)
  • Sign up
HashiCorp Cloud Platform Home

API

Skip to main content
  • Packer Service

  • Resources

  • Tutorial Library
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  1. Developer
  2. HashiCorp Cloud Platform
  3. Packer Service

HashiCorp Cloud Platform Packer Artifact Registry

Packer Service


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/builds/{build_id}

Gets a build with its list of images.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

build_id string RequiredRequired

ULID of the build that should be retrieved.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/builds/{build_id}

Deletes a build in the provided iteration.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

build_id string RequiredRequired

ULID of the build that should be deleted.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

Successful Response

No content.

Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/builds/{build_id}

Updates an image build. This may be most often used for modifying the status of a currently running build.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

build_id string RequiredRequired

ULID of the build that should be updated.

Body Parameters



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


image_id string

ID or URL of the remote cloud image as given by a build.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

labels object

A key:value map for custom, user-settable metadata about your build.

source_image_id string

The ID or URL of the remote cloud source image. Used for tracking image dependencies for build pipelines.

source_iteration_id string

The ID of the parent iteration associated with the source_image_id. When the source iteration ID is set, the source image ID should also be set.

source_channel_id string

The ID of the channel that it was used to fetch the source_iteration_id. When the source channel ID is set, the source iteration ID should also be set.

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images

Lists every existing bucket in the HCP Packer registry and their last completed iteration.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

pagination.page_size integer

The max number of results per page that should be returned. If the number of available results is larger than page_size, a next_page_token is returned which can be used to get the next page of results in subsequent requests. A value of zero will cause page_size to be defaulted.

pagination.next_page_token string

Specifies a page token to use to retrieve the next page. Set this to the next_page_token returned by previous list requests to get the next page of results. If set, previous_page_token must not be set.

pagination.previous_page_token string

Specifies a page token to use to retrieve the previous page. Set this to the previous_page_token returned by previous list requests to get the previous page of results. If set, next_page_token must not be set.

sorting.order_by string[]

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the bucket.

slug string

Human-readable name for the bucket.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image. Used for tracking image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build used as the source for this build. Used for tracking dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when self revoked or 'inherited' when inherited from a revoked ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

latest_version integer

The human-readable version of the most recent completed iteration in this bucket.

created_at string

When the bucket was created.

updated_at string

When the bucket was last updated.

platforms string[]
description string

A short description of what this bucket's images are for.

labels object

A key:value map for custom, user-settable metadata about your bucket.

iteration_count string

The total number of iterations in this bucket.


href string

The URL to retrieve the list of ancestry relationships between this image bucket and its direct source images (parents).

status string

The overall status for all parent iterations. If at least one parent is out of date, HCP Packer reports the overall status as 'OUT_OF_DATE'.


href string

The URL to retrieve the list of ancestry relationships between this image bucket and its direct children.

status string

The overall ancestry status for all child iterations. If at least one child is out of date, HCP Packer reports the overall status as 'OUT_OF_DATE'.


next_page_token string

This token allows you to get the next page of results for list requests. If the number of results is larger than page_size, use the next_page_token as a value for the query parameter next_page_token in the next request. The value will become empty when there are no more pages.

previous_page_token string

This token allows you to get the previous page of results for list requests. If the number of results is larger than page_size, use the previous_page_token as a value for the query parameter previous_page_token in the next request. The value will become empty when there are no more pages.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images

Creates an image bucket in the HCP Packer registry.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

Body Parameters

bucket_slug string

Human-readable name for the bucket.

description string

A short description of what this bucket's images are for.

labels object

A key:value map for custom, user-settable metadata about your bucket.



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the bucket.

slug string

Human-readable name for the bucket.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image. Used for tracking image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build used as the source for this build. Used for tracking dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when self revoked or 'inherited' when inherited from a revoked ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

latest_version integer

The human-readable version of the most recent completed iteration in this bucket.

created_at string

When the bucket was created.

updated_at string

When the bucket was last updated.

platforms string[]
description string

A short description of what this bucket's images are for.

labels object

A key:value map for custom, user-settable metadata about your bucket.

iteration_count string

The total number of iterations in this bucket.


href string

The URL to retrieve the list of ancestry relationships between this image bucket and its direct source images (parents).

status string

The overall status for all parent iterations. If at least one parent is out of date, HCP Packer reports the overall status as 'OUT_OF_DATE'.


href string

The URL to retrieve the list of ancestry relationships between this image bucket and its direct children.

status string

The overall ancestry status for all child iterations. If at least one child is out of date, HCP Packer reports the overall status as 'OUT_OF_DATE'.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}

Gets a bucket with its latest completed iteration.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

bucket_id string

ULID of the bucket.

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the bucket.

slug string

Human-readable name for the bucket.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image. Used for tracking image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build used as the source for this build. Used for tracking dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when self revoked or 'inherited' when inherited from a revoked ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

latest_version integer

The human-readable version of the most recent completed iteration in this bucket.

created_at string

When the bucket was created.

updated_at string

When the bucket was last updated.

platforms string[]
description string

A short description of what this bucket's images are for.

labels object

A key:value map for custom, user-settable metadata about your bucket.

iteration_count string

The total number of iterations in this bucket.


href string

The URL to retrieve the list of ancestry relationships between this image bucket and its direct source images (parents).

status string

The overall status for all parent iterations. If at least one parent is out of date, HCP Packer reports the overall status as 'OUT_OF_DATE'.


href string

The URL to retrieve the list of ancestry relationships between this image bucket and its direct children.

status string

The overall ancestry status for all child iterations. If at least one child is out of date, HCP Packer reports the overall status as 'OUT_OF_DATE'.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}

Deletes a bucket and all its information, such as iterations and builds.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

Successful Response

No content.

Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}

Updates a bucket's information.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket.

Body Parameters



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

platforms string[]
description string

A short description of what this bucket's images are for.

labels object

A key:value map for custom, user-settable metadata about your bucket.

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the bucket.

slug string

Human-readable name for the bucket.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image. Used for tracking image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build used as the source for this build. Used for tracking dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when self revoked or 'inherited' when inherited from a revoked ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

latest_version integer

The human-readable version of the most recent completed iteration in this bucket.

created_at string

When the bucket was created.

updated_at string

When the bucket was last updated.

platforms string[]
description string

A short description of what this bucket's images are for.

labels object

A key:value map for custom, user-settable metadata about your bucket.

iteration_count string

The total number of iterations in this bucket.


href string

The URL to retrieve the list of ancestry relationships between this image bucket and its direct source images (parents).

status string

The overall status for all parent iterations. If at least one parent is out of date, HCP Packer reports the overall status as 'OUT_OF_DATE'.


href string

The URL to retrieve the list of ancestry relationships between this image bucket and its direct children.

status string

The overall ancestry status for all child iterations. If at least one child is out of date, HCP Packer reports the overall status as 'OUT_OF_DATE'.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/ancestry

Lists the ancestry relationships for an image bucket. This includes direct source images (parents) and downstream images built directly from the image bucket (children).

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket you want to list ancestry for.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

type string

The type of ancestry relations to list. Type 'parents' lists all the direct source images for this image bucket. Type 'children' lists all of the child images built directly from this image bucket. If not specified, defaults to listing both parent and child relationships for the image bucket.

channel string

An image channel in the image bucket associated with the request. This property filters the results to children whose parent iteration was assigned to this channel when the children were built. If not specified, the endpoint returns all children built from any iteration in this image bucket.

pagination.page_size integer

The max number of results per page that should be returned. If the number of available results is larger than page_size, a next_page_token is returned which can be used to get the next page of results in subsequent requests. A value of zero will cause page_size to be defaulted.

pagination.next_page_token string

Specifies a page token to use to retrieve the next page. Set this to the next_page_token returned by previous list requests to get the next page of results. If set, previous_page_token must not be set.

pagination.previous_page_token string

Specifies a page token to use to retrieve the previous page. Set this to the previous_page_token returned by previous list requests to get the previous page of results. If set, next_page_token must not be set.

incremental_version integer

The human-readable version number of an iteration that HCP Packer uses to list that iteration's parents. All parents are the parent images Packer used to build this iteration. If not specified, the endpoint returns the parents of the image bucket's latest iteration.

iteration_id string

ULID of the iteration that HCP Packer uses to list that iteration's parents. All parents are the parent images Packer used to build this iteration. If not specified, the endpoint returns the parents of the image bucket's latest iteration.

fingerprint string

Fingerprint of an iteration that HCP Packer uses to list that iteration's parents. All parents are the parent images Packer used to build this iteration. If not specified, the endpoint returns the parents of the image bucket's latest iteration.

Successful Response


status string

The status of the relationship between the parent and child buckets.


bucket_slug string

The parent bucket slug.

iteration_id string

The parent iteration ULID.

iteration_incremental_version integer

The parent iteration incremental version.

iteration_fingerprint string

The parent iteration fingerprint.

channel string

The image channel associated with this relationship.


id string

The currently assigned iteration's ULID.

incremental_version integer

The currently assigned iteration's incremental version.

fingerprint string

The currently assigned iteration's build fingerprint.


bucket_slug string

The child image bucket's slug.

iteration_id string

The child iteration's ULID.

iteration_incremental_version integer

The child iteration's incremental version.

iteration_fingerprint string

The child iteration's build fingerprint.

total_count integer

The total number of ancestral relationships returned for the specified image bucket. These can be parent or child images.


next_page_token string

This token allows you to get the next page of results for list requests. If the number of results is larger than page_size, use the next_page_token as a value for the query parameter next_page_token in the next request. The value will become empty when there are no more pages.

previous_page_token string

This token allows you to get the previous page of results for list requests. If the number of results is larger than page_size, use the previous_page_token as a value for the query parameter previous_page_token in the next request. The value will become empty when there are no more pages.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/channels

Lists all channels of a given bucket.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket you want to list channels for.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the channel.

slug string

Human-readable name for the channel.

bucket_slug string

Human-readable name for the bucket this channel is associated with.

author_id string

The user who last updated the channel.

created_at string

When the channel was created.



id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.

author_id string

The user who pointed the channel to the iteration.

created_at string

When the channel pointer was created.

updated_at string

When the channel was last updated.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.

managed boolean

If the channel is managed by HCP Packer (such as the latest channel).


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/channels

Creates a channel either empty or assigned to an iteration.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket to associate the channel with.

Body Parameters

slug string

Human-readable name for the channel.

incremental_version integer

The human-readable version number assigned to this iteration.

iteration_id string

ULID of the iteration.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the channel.

slug string

Human-readable name for the channel.

bucket_slug string

Human-readable name for the bucket this channel is associated with.

author_id string

The user who last updated the channel.

created_at string

When the channel was created.



id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.

author_id string

The user who pointed the channel to the iteration.

created_at string

When the channel pointer was created.

updated_at string

When the channel was last updated.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.

managed boolean

If the channel is managed by HCP Packer (such as the latest channel).


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/channels/{slug}

Gets a channel with the iteration that it is currently assigned if any.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket that the channel is associated with.

slug string RequiredRequired

Human-readable name for the channel.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the channel.

slug string

Human-readable name for the channel.

bucket_slug string

Human-readable name for the bucket this channel is associated with.

author_id string

The user who last updated the channel.

created_at string

When the channel was created.



id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.

author_id string

The user who pointed the channel to the iteration.

created_at string

When the channel pointer was created.

updated_at string

When the channel was last updated.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.

managed boolean

If the channel is managed by HCP Packer (such as the latest channel).


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/channels/{slug}

Deletes a channel.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket that the channel is associated with.

slug string RequiredRequired

Human-readable name for the channel.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

Successful Response

No content.

Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/channels/{slug}

Updates a channel to clear or point to a new iteration.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket that the channel is associated with.

slug string RequiredRequired

Human-readable name for the channel.

Body Parameters

incremental_version integer

The human-readable version number assigned to this iteration.

iteration_id string

ULID of the iteration. This was created and set by the HCP Packer registry when the iteration was created.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the channel.

slug string

Human-readable name for the channel.

bucket_slug string

Human-readable name for the bucket this channel is associated with.

author_id string

The user who last updated the channel.

created_at string

When the channel was created.



id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.

author_id string

The user who pointed the channel to the iteration.

created_at string

When the channel pointer was created.

updated_at string

When the channel was last updated.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.

managed boolean

If the channel is managed by HCP Packer (such as the latest channel).


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iteration

Allows the user to get an iteration using one of the following identifiers:

  • iteration_id
  • incremental_version
  • fingerprint These are supplied as a query parameter (e.g. images/{bucket_slug}/iteration?fingerprint={fingerprint}).

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

incremental_version integer

The human-readable version number assigned to this iteration.

iteration_id string

ULID of the iteration.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iterations

Lists every existing iteration of a bucket.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

pagination.page_size integer

The max number of results per page that should be returned. If the number of available results is larger than page_size, a next_page_token is returned which can be used to get the next page of results in subsequent requests. A value of zero will cause page_size to be defaulted.

pagination.next_page_token string

Specifies a page token to use to retrieve the next page. Set this to the next_page_token returned by previous list requests to get the next page of results. If set, previous_page_token must not be set.

pagination.previous_page_token string

Specifies a page token to use to retrieve the previous page. Set this to the previous_page_token returned by previous list requests to get the previous page of results. If set, next_page_token must not be set.

sorting.order_by string[]

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

Who created the iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was most recently updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.

build_statuses object

Maps the build component type to its status enum, for displaying build status in the iterations view.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when self revoked or 'inherited' when inherited from a revoked ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.


next_page_token string

This token allows you to get the next page of results for list requests. If the number of results is larger than page_size, use the next_page_token as a value for the query parameter next_page_token in the next request. The value will become empty when there are no more pages.

previous_page_token string

This token allows you to get the previous page of results for list requests. If the number of results is larger than page_size, use the previous_page_token as a value for the query parameter previous_page_token in the next request. The value will become empty when there are no more pages.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iterations

Creates an empty iteration to be written to. This API is called at the beginning of a new Packer build and does not create individual builds for the iteration.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket.

Body Parameters



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iterations/{iteration_id}

Creates an image build in the provided image iteration. It is called once for each "build source" in a Packer build run. The request will error if the build for a given cloud provider already exists.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket.

iteration_id string RequiredRequired

ULID of the iteration that this build should be associated with.

Body Parameters



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm"

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


image_id string

ID or URL of the remote cloud image as given by a build.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

source_image_id string

The ID or URL of the remote cloud source image. Used for tracking image dependencies for build pipelines.

source_iteration_id string

The ID of the parent iteration associated with the source_image_id. When the source iteration ID is set, the source image ID should also be set.

source_channel_id string

The ID of the channel that it was used to fetch the source_iteration_id. When the source channel ID is set, the source iteration ID should also be set.

labels object

A key:value map for custom, user-settable metadata about your build.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iterations/{iteration_id}/builds

Lists every existing build and its images for an iteration.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

bucket_slug string RequiredRequired

Human-readable name for the bucket to list builds for.

iteration_id string RequiredRequired

ULID of the iteration to list builds for.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

pagination.page_size integer

The max number of results per page that should be returned. If the number of available results is larger than page_size, a next_page_token is returned which can be used to get the next page of results in subsequent requests. A value of zero will cause page_size to be defaulted.

pagination.next_page_token string

Specifies a page token to use to retrieve the next page. Set this to the next_page_token returned by previous list requests to get the next page of results. If set, previous_page_token must not be set.

pagination.previous_page_token string

Specifies a page token to use to retrieve the previous page. Set this to the previous_page_token returned by previous list requests to get the previous page of results. If set, next_page_token must not be set.

sorting.order_by string[]

Successful Response


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


next_page_token string

This token allows you to get the next page of results for list requests. If the number of results is larger than page_size, use the next_page_token as a value for the query parameter next_page_token in the next request. The value will become empty when there are no more pages.

previous_page_token string

This token allows you to get the previous page of results for list requests. If the number of results is larger than page_size, use the previous_page_token as a value for the query parameter previous_page_token in the next request. The value will become empty when there are no more pages.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/iterations/{iteration_id}

Deletes an iteration and all its information, such as its builds.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

iteration_id string RequiredRequired

ULID of the iteration. This was created and set by the HCP Packer registry when the iteration was created.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

bucket_slug string

Human-readable name for the bucket.

Successful Response

No content.

Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/iterations/{iteration_id}

This API can be used to revoke, restore, or complete an iteration. Revoking can be done at any time to complete or incomplete iterations, immediately or in the future depending on the passing timestamp. When an iteration is revoked, all its descendants will automatically get revoked unless 'skip_descendants_revocation' is set. Descendants will get revoked asynchronously to the request. Revoked iterations cannot be updated unless restored. To make build-specific updates for builds within the iteration, use the Update Build endpoint.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

iteration_id string RequiredRequired

ULID of the iteration.

Body Parameters



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

bucket_slug string

Human-readable name for the bucket.

complete boolean

Set to "true" when all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, this iteration is considered ready to use, and can have channels assigned to it.

revocation_message string

Optional field to provide the reason for why this iteration is being revoked.

revoke_at string

revoke_at accepts strings in the RFC 3339 format to represent the revocation timestamp. To instantly revoke the iteration, provide the current timestamp. The revoke_at timestamp will always be recorded in UTC (Coordinated Universal Time). This option is equivalent to the 'revoke_in' option and therefore only one of them should be set when updating the iteration.

revoke_in string

revoke_in accepts a signed sequence of decimal numbers with a unit suffix to represent the duration to the revocation date, such as '30d' or '2h45m'. Valid time units are 's', 'm', 'h', and 'd' as for seconds, minutes, hours, and days. To instantly revoke the iteration, provide the duration of zero seconds ("0s"). The revoke_in duration will be used to calculate the iteration revocation timestamp, which will be recorded as UTC (Coordinated Universal Time). This option is equivalent to the 'revoke_at' option and therefore only one of them should be set when updating the iteration.

restore boolean

When set to true, will make a previously revoked iteration valid again.

skip_descendants_revocation boolean

When set to true, the iteration's descendants won't inherit its revocation status.

Successful Response


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the iteration.

bucket_slug string

Human-readable name for the bucket that this iteration is associated with.

iteration_ancestor_id string

The unique identifier of the iteration that was used as a source for this iteration, if this iteration was built on a base layer. Deprecated: refer to build specific source_build_ulid.

incremental_version integer

The human-readable version number assigned to this iteration. This field will only be set if the iteration is "complete".

complete boolean

If true, all builds associated with this iteration have successfully completed and uploaded metadata to the registry. When "complete" is true, This iteration is considered ready to use, and can have channels assigned to it.

author_id string

The name of the person who created this iteration.

created_at string

When the iteration was created.

updated_at string

When the iteration was last updated.

fingerprint string

Fingerprint of the iteration. The fingerprint is set by Packer when you call packer build. It will most often correspond to a git commit sha, but can be manually overridden by setting the environment variable HCP_PACKER_BUILD_FINGERPRINT.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) of the build.

iteration_id string

Unique identifier of the iteration associated with this build; this was created and set by the HCP Packer registry when the iteration was created.

component_type string

Internal Packer name for the builder or post-processor component used to build this. For example, "amazon-ebs" or "azure-arm".

packer_run_uuid string

The UUID specific to this call to Packer build. If you use the manifest post-processor, this UUID will match the UUID present there.


id string

Universally Unique Lexicographically Sortable Identifier (ULID) for the image.

image_id string

ID or URL of the remote cloud image as given by a build. For example, ami-12345.

region string

Cloud-specific region as provided by packer build. For example, "ap-east-1".

created_at string

Timestamp at which this image was created.

cloud_provider string

The cloud provider that this build produced artifacts for. For example, AWS, GCP, or Azure.

status string

Status of the build. The status can be RUNNING, DONE, CANCELLED, FAILED, or UNSET.

created_at string

When the build was created.

updated_at string

When the build was most recently updated.

source_image_id string

The ID or URL of the remote cloud source image that HCP Packer uses to track image dependencies for build pipelines.

labels object

A key:value map for custom, user-settable metadata about your build.

source_build_ulid string

Unique identifier of the HCP Packer registry build that Packer uses as the source for this build. HCP Packer uses this to track dependencies for build pipelines.

revoke_at string

Timestamp from when the iteration is revoked an no longer trusted to be secure.

revocation_message string

A short explanation of why this iteration was revoked.

revocation_author string

Who revoked this iteration. For human authors (e.g. HCP Portal) this will be an email address. For machine authors using service principals, this is the customer-chosen name for this service principal.

revocation_type string

Revocation type is 'manual' when the iteration is revoked directly or 'inherited' when the iteration inherits a revocation from an upstream ancestor.


href string

The URL to get the revoked ancestor.

bucket_slug string

The revoked ancestor bucket slug.

iteration_incremental_version integer

The revoked ancestor iteration incremental version.

iteration_id string

The revoked ancestor iteration ULID.

iteration_fingerprint string

The revoked ancestor iteration fingerprint.

has_descendants boolean

If true, this iteration has children iterations. Knowing if an iteration has descendants can help taking decisions such as persist revocation to all its descendants or not.

template_type string
  • TEMPLATE_TYPE_UNSET: TEMPLATE_TYPE_UNSET is a sentinel zero value so that an uninitialized value can be detected.
  • HCL2: HCL2 configuration template; either pkr.hcl or pkr.json
  • JSON: Legacy JSON configuration template

The type of Packer configuration template used to build this iteration.


id string

id is the unique ID for this operation used in other RPC calls. This ID is only guaranteed to be unique within the region that the operation is running in.

state string

state is the current state of the operation. This is a simple tri-state: PENDING means the operation is created but not yet started, RUNNING means the operation is currently running (though it may be very long-running), and DONE means the operation is complete whether successfully or not.


code integer

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

message string

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.


@type string

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).

In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

  • If no scheme is provided, https is assumed.
  • An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
  • Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.

Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.


@type string

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).

In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

  • If no scheme is provided, https is assumed.
  • An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
  • Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.

Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


type string

type is the unique type of the resource. Each service publishes a unique set of types. The type value is recommended to be formatted in "." such as "hashicorp.hvn". This is to prevent conflicts in the future, but any string value will work.

id string

id is the identifier for this resource.

uuid string

uuid is the unique UUID for this resource.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

description string

description is a human-friendly description for this link. This is used primarily for informational purposes such as error messages.

created_at string

CreatedAt is the timestamp of when the operation was first created.

updated_at string

UpdatedAt is the timestamp of when the operation was last updated.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/registry

Gets a HCP Packer registry.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

Successful Response


id string

ULID of the registry.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


feature_tier string

The feature tier for the registry.

activated boolean

A registry is activated when the system correctly starts billing for it.


at string

The time the registry was deactivated of billing.

reason string

Reason of why the registry was deactivated.


api_id string

Unique per registry API id for running HCP Packer run tasks.

hmac_key string

Encrypted HMAC key used by Terraform Cloud to sign the requests to the HCP Packer run task API.

created_at string

When the registry was created.

updated_at string

When the registry was last updated.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/registry

Creates a HCP Packer registry and starts billing for it.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

Body Parameters



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

feature_tier string

Feature tier of the Registry.

Successful Response


id string

ULID of the registry.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


feature_tier string

The feature tier for the registry.

activated boolean

A registry is activated when the system correctly starts billing for it.


at string

The time the registry was deactivated of billing.

reason string

Reason of why the registry was deactivated.


api_id string

Unique per registry API id for running HCP Packer run tasks.

hmac_key string

Encrypted HMAC key used by Terraform Cloud to sign the requests to the HCP Packer run task API.

created_at string

When the registry was created.

updated_at string

When the registry was last updated.


id string

id is the unique ID for this operation used in other RPC calls. This ID is only guaranteed to be unique within the region that the operation is running in.

state string

state is the current state of the operation. This is a simple tri-state: PENDING means the operation is created but not yet started, RUNNING means the operation is currently running (though it may be very long-running), and DONE means the operation is complete whether successfully or not.


code integer

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

message string

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.


@type string

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).

In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

  • If no scheme is provided, https is assumed.
  • An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
  • Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.

Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.


@type string

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).

In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

  • If no scheme is provided, https is assumed.
  • An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
  • Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.

Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


type string

type is the unique type of the resource. Each service publishes a unique set of types. The type value is recommended to be formatted in "." such as "hashicorp.hvn". This is to prevent conflicts in the future, but any string value will work.

id string

id is the identifier for this resource.

uuid string

uuid is the unique UUID for this resource.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

description string

description is a human-friendly description for this link. This is used primarily for informational purposes such as error messages.

created_at string

CreatedAt is the timestamp of when the operation was first created.

updated_at string

UpdatedAt is the timestamp of when the operation was last updated.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/registry

Deactivates an active HCP packer registry. Deactivating a registry will stop any additional billing for the resource. Setting the hard_delete param to true will delete the registry and any associated resources from the database.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

hard_delete boolean

When set to true, the registry will be deleted from database and recovery will no longer be possible.

Successful Response


id string

ULID of the registry.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


feature_tier string

The feature tier for the registry.

activated boolean

A registry is activated when the system correctly starts billing for it.


at string

The time the registry was deactivated of billing.

reason string

Reason of why the registry was deactivated.


api_id string

Unique per registry API id for running HCP Packer run tasks.

hmac_key string

Encrypted HMAC key used by Terraform Cloud to sign the requests to the HCP Packer run task API.

created_at string

When the registry was created.

updated_at string

When the registry was last updated.


id string

id is the unique ID for this operation used in other RPC calls. This ID is only guaranteed to be unique within the region that the operation is running in.

state string

state is the current state of the operation. This is a simple tri-state: PENDING means the operation is created but not yet started, RUNNING means the operation is currently running (though it may be very long-running), and DONE means the operation is complete whether successfully or not.


code integer

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

message string

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.


@type string

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).

In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

  • If no scheme is provided, https is assumed.
  • An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
  • Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.

Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.


@type string

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).

In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

  • If no scheme is provided, https is assumed.
  • An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
  • Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.

Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


type string

type is the unique type of the resource. Each service publishes a unique set of types. The type value is recommended to be formatted in "." such as "hashicorp.hvn". This is to prevent conflicts in the future, but any string value will work.

id string

id is the identifier for this resource.

uuid string

uuid is the unique UUID for this resource.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

description string

description is a human-friendly description for this link. This is used primarily for informational purposes such as error messages.

created_at string

CreatedAt is the timestamp of when the operation was first created.

updated_at string

UpdatedAt is the timestamp of when the operation was last updated.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/registry

Updates the feature tier of an HCP Packer registry.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

Body Parameters



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

feature_tier string

Feature tier of the Registry.

activate boolean

Activates a deactivated registry. A registry can only be activated if the organization billing account is valid (e.g. valid credits or payment method).

Successful Response


id string

ULID of the registry.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


feature_tier string

The feature tier for the registry.

activated boolean

A registry is activated when the system correctly starts billing for it.


at string

The time the registry was deactivated of billing.

reason string

Reason of why the registry was deactivated.


api_id string

Unique per registry API id for running HCP Packer run tasks.

hmac_key string

Encrypted HMAC key used by Terraform Cloud to sign the requests to the HCP Packer run task API.

created_at string

When the registry was created.

updated_at string

When the registry was last updated.


id string

id is the unique ID for this operation used in other RPC calls. This ID is only guaranteed to be unique within the region that the operation is running in.

state string

state is the current state of the operation. This is a simple tri-state: PENDING means the operation is created but not yet started, RUNNING means the operation is currently running (though it may be very long-running), and DONE means the operation is complete whether successfully or not.


code integer

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

message string

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.


@type string

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).

In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

  • If no scheme is provided, https is assumed.
  • An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
  • Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.

Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.


@type string

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).

In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

  • If no scheme is provided, https is assumed.
  • An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
  • Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.

Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")


type string

type is the unique type of the resource. Each service publishes a unique set of types. The type value is recommended to be formatted in "." such as "hashicorp.hvn". This is to prevent conflicts in the future, but any string value will work.

id string

id is the identifier for this resource.

uuid string

uuid is the unique UUID for this resource.


organization_id string

organization_id is the id of the organization.

project_id string

project_id is the projects id.


provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

description string

description is a human-friendly description for this link. This is used primarily for informational purposes such as error messages.

created_at string

CreatedAt is the timestamp of when the operation was first created.

updated_at string

UpdatedAt is the timestamp of when the operation was last updated.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/runtasks/hmac

Regenerates the HMAC key used to sign requests from Terraform Cloud to HCP Packer run tasks.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

Body Parameters



provider string

provider is the named cloud provider ("aws", "gcp", "azure")

region string

region is the cloud region ("us-west1", "us-east1")

Successful Response

hmac_key string

New HMAC key used by Terraform Cloud to sign the requests to the HCP Packer run task API.


Note: Operation paths have been truncated for clarity. The full path to this operation is:
/packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/runtasks/{task_type}

Gets the HCP Packer registry API URL and HMAC key to integrate with Terraform Cloud as a Run Task.

Path Parameters

location.organization_id string RequiredRequired

organization_id is the id of the organization.

location.project_id string RequiredRequired

project_id is the projects id.

task_type string RequiredRequired

The HCP Packer Terraform Cloud run task type. Currently, the only existing type is validation.

Query Parameters

location.region.provider string

provider is the named cloud provider ("aws", "gcp", "azure")

location.region.region string

region is the cloud region ("us-west1", "us-east1")

Successful Response

api_url string

URL of the API used by Terraform Cloud to run HCP Packer Run Tasks.

hmac_key string

HMAC key used by Terraform Cloud to sign the requests to the HCP Packer run task API.

Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)