HashiCorp Cloud Platform Packer Artifact Registry — PackerService

naftiko: 1.0.0-alpha2
info:
  label: HashiCorp Cloud Platform Packer Artifact Registry — PackerService
  description: "HashiCorp Cloud Platform Packer Artifact Registry — PackerService. 24 operations. Lead operation: GetIteration\
    \ allows the user to retrieve an iteration using one of the following identifiers:\n * iteration_id\n * incremental_version\n\
    \ * fingerprint. Self-contained Naftiko capability covering one Packer business surface."
  tags:
  - Packer
  - PackerService
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PACKER_API_KEY: PACKER_API_KEY
capability:
  consumes:
  - type: http
    namespace: packer-packerservice
    baseUri: ''
    description: HashiCorp Cloud Platform Packer Artifact Registry — PackerService business capability. Self-contained, no
      shared references.
    resources:
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/builds/{build_id}
      operations:
      - name: getbuild
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: build_id
          in: path
          type: string
          description: Unique identifier of the build that should be retrieved; this ID was
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
      - name: deletebuild
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: build_id
          in: path
          type: string
          description: Unique identifier of the build that should be deleted; this ID was
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
      - name: updatebuild
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: build_id
          in: path
          type: string
          description: Unique identifier of the build that should be updated; this ID was
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images
      operations:
      - name: listbuckets
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
        - name: pagination.page_size
          in: query
          type: integer
          description: The max number of results per page that should be returned. If the number
        - name: pagination.next_page_token
          in: query
          type: string
          description: Specifies a page token to use to retrieve the next page. Set this to the
        - name: pagination.previous_page_token
          in: query
          type: string
          description: Specifies a page token to use to retrieve the previous page. Set this to
        - name: sorting.order_by
          in: query
          type: array
          description: 'Specifies the list of per field ordering that should be used for sorting. '
      - name: createbucket
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}
      operations:
      - name: getbucket
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
        - name: bucket_id
          in: query
          type: string
          description: Unique identifier of the bucket; created and set by the HCP Packer
      - name: deletebucket
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
      - name: updatebucket
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/channels
      operations:
      - name: listchannels
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket you want to list channels for.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
      - name: createchannel
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket to associate the channel with.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/channels/{slug}
      operations:
      - name: getchannel
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket that the channel is associated with.
          required: true
        - name: slug
          in: path
          type: string
          description: Human-readable name for the channel.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
      - name: deletechannel
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket that the channel is associated with.
          required: true
        - name: slug
          in: path
          type: string
          description: Human-readable name for the channel.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
        - name: revocation_message
          in: query
          type: string
          description: Optional field to provide the reason for why this channel is being revoked.
      - name: updatechannel
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket that the channel is associated with.
          required: true
        - name: slug
          in: path
          type: string
          description: Human-readable name for the channel.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iteration
      operations:
      - name: getiteration
        method: GET
        description: 'GetIteration allows the user to retrieve an iteration using one of the following identifiers:'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
        - name: incremental_version
          in: query
          type: integer
          description: The human-readable version number assigned to this iteration.
        - name: iteration_id
          in: query
          type: string
          description: Unique identifier of the iteration. This was created and set by the
        - name: fingerprint
          in: query
          type: string
          description: Fingerprint of the iteration. The fingerprint is set by Packer when you
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iterations
      operations:
      - name: listiterations
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
        - name: include_incomplete
          in: query
          type: boolean
          description: If true, the request will return information about iterations that have
        - name: pagination.page_size
          in: query
          type: integer
          description: The max number of results per page that should be returned. If the number
        - name: pagination.next_page_token
          in: query
          type: string
          description: Specifies a page token to use to retrieve the next page. Set this to the
        - name: pagination.previous_page_token
          in: query
          type: string
          description: Specifies a page token to use to retrieve the previous page. Set this to
        - name: sorting.order_by
          in: query
          type: array
          description: 'Specifies the list of per field ordering that should be used for sorting. '
      - name: createiteration
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iterations/{incremental_version}/ancestors
      operations:
      - name: getancestorimages
        method: GET
        description: API Endpoints to ease UI implementation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket.
          required: true
        - name: incremental_version
          in: path
          type: integer
          description: The human-readable version number assigned to this iteration.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iterations/{incremental_version}/children
      operations:
      - name: getchildimages
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket.
          required: true
        - name: incremental_version
          in: path
          type: integer
          description: The human-readable version number assigned to this iteration.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iterations/{iteration_id}
      operations:
      - name: createbuild
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket.
          required: true
        - name: iteration_id
          in: path
          type: string
          description: Unique identifier of the iteration that this build should be associated
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/images/{bucket_slug}/iterations/{iteration_id}/builds
      operations:
      - name: listbuilds
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: bucket_slug
          in: path
          type: string
          description: Human-readable name for the bucket to list builds for.
          required: true
        - name: iteration_id
          in: path
          type: string
          description: Unique identifier of the iteration to list builds for; this was
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
        - name: pagination.page_size
          in: query
          type: integer
          description: The max number of results per page that should be returned. If the number
        - name: pagination.next_page_token
          in: query
          type: string
          description: Specifies a page token to use to retrieve the next page. Set this to the
        - name: pagination.previous_page_token
          in: query
          type: string
          description: Specifies a page token to use to retrieve the previous page. Set this to
        - name: sorting.order_by
          in: query
          type: array
          description: 'Specifies the list of per field ordering that should be used for sorting. '
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/iterations/{iteration_id}
      operations:
      - name: deleteiteration
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: iteration_id
          in: path
          type: string
          description: Unique identifier of the iteration. This was created and set by the
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
        - name: bucket_slug
          in: query
          type: string
          description: Human-readable name for the bucket.
      - name: updateiteration
        method: PATCH
        description: UpdateIteration is used to mark an iteration "complete", once all builds are complete.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: iteration_id
          in: path
          type: string
          description: Unique identifier of the iteration. This was created and set by the
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: packer-2021-04-30-organizations-location.organization_id-projects-location.proje
      path: /packer/2021-04-30/organizations/{location.organization_id}/projects/{location.project_id}/registry
      operations:
      - name: getregistry
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: location.region.provider
          in: query
          type: string
          description: provider is the named cloud provider ("aws", "gcp", "azure").
        - name: location.region.region
          in: query
          type: string
          description: region is the cloud region ("us-west1", "us-east1").
      - name: createregistry
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location.organization_id
          in: path
          type: string
          description: organization_id is the id of the organization.
          required: true
        - name: location.project_id
          in: path
          type: string
          description: project_id is the projects id.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.PACKER_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: packer-packerservice-rest
    port: 8080
    description: REST adapter for HashiCorp Cloud Platform Packer Artifact Registry — PackerService. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/packer/2021-04-30/organizations/{location-organization-id}/projects/{location-project-id}/builds/{build-id}
      name: packer-2021-04-30-organizations-location-organization-id-projects-location-proje
      description: REST surface for packer-2021-04-30-organizations-location.organization_id-projects-location.proje.
      operations:
      - method: GET
        name: getbuild
        description: getbuild
        call: packer-packerservice.getbuild
        with:
          location.organization_id: rest.location.organization_id
          location.project_id: rest.location.project_id
          build_id: rest.build_id
          location.region.provider: rest.location.region.provider
          location.region.region: rest.locat

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/packer/refs/heads/main/capabilities/packer-packerservice.yaml