HashiDays One conference. Three cities. Find a city near you
HashiCorp Cloud Platform

HCP Vagrant Box Registry

Loading…
Status
(opens in new tab)
stable

API for managing Vagrant boxes.

Operations

​List​Registries

get

​/​vagrant​/​registries

​List​Registries


https://api.cloud.hashicorp.com/vagrant/2022-09-30/registries

Request

Query Parameters
location.organization_idstring

organization_id is the id of the organization.

location.project_idstring

project_id is the projects id.

location.region.providerstring

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

location.region.regionstring

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

pagination.page_sizeinteger

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_tokenstring

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_tokenstring

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.

Response

200 - OK
registriesobject[]
  • namestring

    The name of the Registry. This is a user-settable, globally-unique name, and forms the first segment of a box, ie: the "hashicorp" in "hashicorp/vagrant". No two registries can have the same name, regardless of the location (org/project) they are in.

  • locationobject

    Location represents a target for an operation in HCP.

    • organization_idstring

      organization_id is the id of the organization.

    • project_idstring

      project_id is the projects id.

    • regionobject

      Region identifies a Cloud data-plane region.

      • providerstring
      • regionstring
  • activatedboolean

    Whether or not the Registry is currently activated.

  • created_atstring

    The date the record was created.

  • updated_atstring

    The date that the record was last updated.

  • descriptionstring

    The description of the registry, if it exists.

  • description_htmlstring
  • gravatar_urlstring
  • boxesobject[]
    • namestring

      The name segment of the Box. As an example, this field would represent the "vagrant" in "hashicorp/vagrant". Should be unique within the Registry. This field should only be set when creating the box.

    • descriptionstring

      A long-form description of the box.

    • short_descriptionstring

      A short-form description of the box. Limited to 100 characters.

    • is_privateboolean

      Whether or not the Box is private.

    • created_atstring

      The date the record was created.

    • updated_atstring

      The date that the record was last updated.

    • summaryobject
      • versions_countstring

        Total number of versions available on this box.

      • provider_namesstring[]
      • latest_released_atstring
    • downloadsstring

      The number of times this box has been downloaded.

    • statestring

      BoxState is an enumeration of possible Box states.

    • description_htmlstring

      The HTML rendered description.

    • versionsobject[]
      • namestring

        The version string, ie: v0.0.1 or v2006010201, etc. Must be unique within the Box.

      • statestring

        State is an enumeration of possible Version states.

      • created_atstring

        The date the record was created.

      • updated_atstring

        The date that the record was last updated.

      • descriptionstring

        A long-form description of the version.

      • description_htmlstring

        The HTML rendered description.

      • summaryobject
        • providers_countstring
        • provider_namesstring[]
      • providersobject[]

        Provider describes a Provider with its list of architectures and box data.

        • namestring

          The name of the Provider, should be unique within the version.

        • architecturesobject[]
          • architecture_typestring

            The architecture type that is supported.

          • defaultboolean
          • box_dataobject

            BoxData is the data around the box to be downloaded, including the download URL, checksum information, and size if available.

            • download_urlstring

              The download URL for this box data.

            • checksumstring

              The checksum for the box data.

            • checksum_typestring

              ChecksumType describe supported checksum types.

            • sizestring

              The size of the box file, if available.

            • created_atstring

              The date the record was created.

            • updated_atstring

              The date that the record was last updated.

          • created_atstring

            The date the record was created.

          • updated_atstring

            The date that the record was last updated.

        • created_atstring

          The date the record was created.

        • updated_atstring

          The date that the record was last updated.

        • summaryobject
          • architectures_countstring
          • architecture_typesstring[]
paginationobject

PaginationResponse is the response holding the page tokens for a paginated list response.

  • next_page_tokenstring

    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_tokenstring

    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.

Default Error Response
codeinteger

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

messagestring

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.

detailsobject[]

An arbitrary serialized message. Visit the protobufAny documentation for more information.

  • @typestring

    A URL that describes the type of the serialized message.

​Create​Registry

post

​/​vagrant​/​registries

​Create​Registry


https://api.cloud.hashicorp.com/vagrant/2022-09-30/registries

Request

Body Parameters
namestring

The name of the Registry. This is a user-settable, globally-unique name, and forms the first segment of a box, ie: the "hashicorp" in "hashicorp/vagrant". No two registries can have the same name, regardless of the location (org/project) they are in.

locationobject

Location represents a target for an operation in HCP.

  • organization_idstring

    organization_id is the id of the organization.

  • project_idstring

    project_id is the projects id.

  • regionobject

    Region identifies a Cloud data-plane region.

    • providerstring
    • regionstring
descriptionstring

The description of the registry, if it exists.

Response

200 - OK
registryobject
  • namestring

    The name of the Registry. This is a user-settable, globally-unique name, and forms the first segment of a box, ie: the "hashicorp" in "hashicorp/vagrant". No two registries can have the same name, regardless of the location (org/project) they are in.

  • locationobject

    Location represents a target for an operation in HCP.

    • organization_idstring

      organization_id is the id of the organization.

    • project_idstring

      project_id is the projects id.

    • regionobject

      Region identifies a Cloud data-plane region.

      • providerstring
      • regionstring
  • activatedboolean

    Whether or not the Registry is currently activated.

  • created_atstring

    The date the record was created.

  • updated_atstring

    The date that the record was last updated.

  • descriptionstring

    The description of the registry, if it exists.

  • description_htmlstring
  • gravatar_urlstring
  • boxesobject[]
    • namestring

      The name segment of the Box. As an example, this field would represent the "vagrant" in "hashicorp/vagrant". Should be unique within the Registry. This field should only be set when creating the box.

    • descriptionstring

      A long-form description of the box.

    • short_descriptionstring

      A short-form description of the box. Limited to 100 characters.

    • is_privateboolean

      Whether or not the Box is private.

    • created_atstring

      The date the record was created.

    • updated_atstring

      The date that the record was last updated.

    • summaryobject
      • versions_countstring

        Total number of versions available on this box.

      • provider_namesstring[]
      • latest_released_atstring
    • downloadsstring

      The number of times this box has been downloaded.

    • statestring

      BoxState is an enumeration of possible Box states.

    • description_htmlstring

      The HTML rendered description.

    • versionsobject[]
      • namestring

        The version string, ie: v0.0.1 or v2006010201, etc. Must be unique within the Box.

      • statestring

        State is an enumeration of possible Version states.

      • created_atstring

        The date the record was created.

      • updated_atstring

        The date that the record was last updated.

      • descriptionstring

        A long-form description of the version.

      • description_htmlstring

        The HTML rendered description.

      • summaryobject
        • providers_countstring
        • provider_namesstring[]
      • providersobject[]

        Provider describes a Provider with its list of architectures and box data.

        • namestring

          The name of the Provider, should be unique within the version.

        • architecturesobject[]
          • architecture_typestring

            The architecture type that is supported.

          • defaultboolean
          • box_dataobject

            BoxData is the data around the box to be downloaded, including the download URL, checksum information, and size if available.

            • download_urlstring

              The download URL for this box data.

            • checksumstring

              The checksum for the box data.

            • checksum_typestring

              ChecksumType describe supported checksum types.

            • sizestring

              The size of the box file, if available.

            • created_atstring

              The date the record was created.

            • updated_atstring

              The date that the record was last updated.

          • created_atstring

            The date the record was created.

          • updated_atstring

            The date that the record was last updated.

        • created_atstring

          The date the record was created.

        • updated_atstring

          The date that the record was last updated.

        • summaryobject
          • architectures_countstring
          • architecture_typesstring[]
operationobject

Operation represents a single operation.

  • idstring

    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.

  • statestring

    State is one of the states that an Operation can be in.

    The states are purposely coarse grained to make it easy to understand the operation state machine: pending => running => done. Or pending => queued => running => done. No other state transitions are possible. Success/failure can be determined based on the result oneof.

  • errorobject

    The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details.

    You can find out more about this error model and how to work with it in the API Design Guide.

    • codeinteger

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

    • messagestring

      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.

    • detailsobject[]

      An arbitrary serialized message. Visit the protobufAny documentation for more information.

      • @typestring

        A URL that describes the type of the serialized message.

  • responseobject

    An arbitrary serialized message. Visit the protobufAny documentation for more information.

    • @typestring

      A URL that describes the type of the serialized message.

  • locationobject

    Location represents a target for an operation in HCP.

    • organization_idstring

      organization_id is the id of the organization.

    • project_idstring

      project_id is the projects id.

    • regionobject

      Region identifies a Cloud data-plane region.

      • providerstring
      • regionstring
  • linkobject

    Link is used to uniquely reference any resource within HashiCorp Cloud. This can be conceptually considered a "foreign key".

    • typestring

      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.

    • idstring

      id is the identifier for this resource.

    • uuidstring

      uuid is the unique UUID for this resource.

    • locationobject

      Location represents a target for an operation in HCP.

      • organization_idstring

        organization_id is the id of the organization.

      • project_idstring

        project_id is the projects id.

      • regionobject

        Region identifies a Cloud data-plane region.

        • providerstring
        • regionstring
    • descriptionstring

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

  • created_atstring

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

  • updated_atstring

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

Default Error Response
codeinteger

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

messagestring

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.

detailsobject[]

An arbitrary serialized message. Visit the protobufAny documentation for more information.

  • @typestring

    A URL that describes the type of the serialized message.

​Read​Registry

get

​/​vagrant​/​registry​/​{registry}

​Read​Registry


https://api.cloud.hashicorp.com/vagrant/2022-09-30/registry/{registry}

Request

Path Parameters
registrystringRequired

The name of the Registry to look up.

Query Parameters
expandedboolean

Expand the registry child elements.

Response

200 - OK
registryobject
  • namestring

    The name of the Registry. This is a user-settable, globally-unique name, and forms the first segment of a box, ie: the "hashicorp" in "hashicorp/vagrant". No two registries can have the same name, regardless of the location (org/project) they are in.

  • locationobject

    Location represents a target for an operation in HCP.

    • organization_idstring

      organization_id is the id of the organization.

    • project_idstring

      project_id is the projects id.

    • regionobject

      Region identifies a Cloud data-plane region.

      • providerstring
      • regionstring
  • activatedboolean

    Whether or not the Registry is currently activated.

  • created_atstring

    The date the record was created.

  • updated_atstring

    The date that the record was last updated.

  • descriptionstring

    The description of the registry, if it exists.

  • description_htmlstring
  • gravatar_urlstring
  • boxesobject[]
    • namestring

      The name segment of the Box. As an example, this field would represent the "vagrant" in "hashicorp/vagrant". Should be unique within the Registry. This field should only be set when creating the box.

    • descriptionstring

      A long-form description of the box.

    • short_descriptionstring

      A short-form description of the box. Limited to 100 characters.

    • is_privateboolean

      Whether or not the Box is private.

    • created_atstring

      The date the record was created.

    • updated_atstring

      The date that the record was last updated.

    • summaryobject
      • versions_countstring

        Total number of versions available on this box.

      • provider_namesstring[]
      • latest_released_atstring
    • downloadsstring

      The number of times this box has been downloaded.

    • statestring

      BoxState is an enumeration of possible Box states.

    • description_htmlstring

      The HTML rendered description.

    • versionsobject[]
      • namestring

        The version string, ie: v0.0.1 or v2006010201, etc. Must be unique within the Box.

      • statestring

        State is an enumeration of possible Version states.

      • created_atstring

        The date the record was created.

      • updated_atstring

        The date that the record was last updated.

      • descriptionstring

        A long-form description of the version.

      • description_htmlstring

        The HTML rendered description.

      • summaryobject
        • providers_countstring
        • provider_namesstring[]
      • providersobject[]

        Provider describes a Provider with its list of architectures and box data.

        • namestring

          The name of the Provider, should be unique within the version.

        • architecturesobject[]
          • architecture_typestring

            The architecture type that is supported.

          • defaultboolean
          • box_dataobject

            BoxData is the data around the box to be downloaded, including the download URL, checksum information, and size if available.

            • download_urlstring

              The download URL for this box data.

            • checksumstring

              The checksum for the box data.

            • checksum_typestring

              ChecksumType describe supported checksum types.

            • sizestring

              The size of the box file, if available.

            • created_atstring

              The date the record was created.

            • updated_atstring

              The date that the record was last updated.

          • created_atstring

            The date the record was created.

          • updated_atstring

            The date that the record was last updated.

        • created_atstring

          The date the record was created.

        • updated_atstring

          The date that the record was last updated.

        • summaryobject
          • architectures_countstring
          • architecture_typesstring[]
Default Error Response
codeinteger

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

messagestring

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.

detailsobject[]

An arbitrary serialized message. Visit the protobufAny documentation for more information.

  • @typestring

    A URL that describes the type of the serialized message.

​Delete​Registry

delete

​/​vagrant​/​registry​/​{registry}

​Delete​Registry


https://api.cloud.hashicorp.com/vagrant/2022-09-30/registry/{registry}

Request

Path Parameters
registrystringRequired

The name of the Registry to delete.

Response

200 - OK
operationobject

Operation represents a single operation.

  • idstring

    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.

  • statestring

    State is one of the states that an Operation can be in.

    The states are purposely coarse grained to make it easy to understand the operation state machine: pending => running => done. Or pending => queued => running => done. No other state transitions are possible. Success/failure can be determined based on the result oneof.

  • errorobject

    The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details.

    You can find out more about this error model and how to work with it in the API Design Guide.

    • codeinteger

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

    • messagestring

      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.

    • detailsobject[]

      An arbitrary serialized message. Visit the protobufAny documentation for more information.

      • @typestring

        A URL that describes the type of the serialized message.

  • responseobject

    An arbitrary serialized message. Visit the protobufAny documentation for more information.

    • @typestring

      A URL that describes the type of the serialized message.

  • locationobject

    Location represents a target for an operation in HCP.

    • organization_idstring

      organization_id is the id of the organization.

    • project_idstring

      project_id is the projects id.

    • regionobject

      Region identifies a Cloud data-plane region.

      • providerstring
      • regionstring
  • linkobject

    Link is used to uniquely reference any resource within HashiCorp Cloud. This can be conceptually considered a "foreign key".

    • typestring

      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.

    • idstring

      id is the identifier for this resource.

    • uuidstring

      uuid is the unique UUID for this resource.

    • locationobject

      Location represents a target for an operation in HCP.

      • organization_idstring

        organization_id is the id of the organization.

      • project_idstring

        project_id is the projects id.

      • regionobject

        Region identifies a Cloud data-plane region.

        • providerstring
        • regionstring
    • descriptionstring

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

  • created_atstring

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

  • updated_atstring

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

Default Error Response
codeinteger

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

messagestring

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.

detailsobject[]

An arbitrary serialized message. Visit the protobufAny documentation for more information.

  • @typestring

    A URL that describes the type of the serialized message.

​Update​Registry

put

​/​vagrant​/​registry​/​{registry}

​Update​Registry


https://api.cloud.hashicorp.com/vagrant/2022-09-30/registry/{registry}

Request

Path Parameters
registrystringRequired

The name of the Registry to update.

Body Parameters
namestring

The name of the Registry. This is a user-settable, globally-unique name, and forms the first segment of a box, ie: the "hashicorp" in "hashicorp/vagrant". No two registries can have the same name, regardless of the location (org/project) they are in.

locationobject

Location represents a target for an operation in HCP.

  • organization_idstring

    organization_id is the id of the organization.

  • project_idstring

    project_id is the projects id.

  • regionobject

    Region identifies a Cloud data-plane region.

    • providerstring
    • regionstring
descriptionstring

The description of the registry, if it exists.

Response

200 - OK
registryobject
  • namestring

    The name of the Registry. This is a user-settable, globally-unique name, and forms the first segment of a box, ie: the "hashicorp" in "hashicorp/vagrant". No two registries can have the same name, regardless of the location (org/project) they are in.

  • locationobject

    Location represents a target for an operation in HCP.

    • organization_idstring

      organization_id is the id of the organization.

    • project_idstring

      project_id is the projects id.

    • regionobject

      Region identifies a Cloud data-plane region.

      • providerstring
      • regionstring
  • activatedboolean

    Whether or not the Registry is currently activated.

  • created_atstring

    The date the record was created.

  • updated_atstring

    The date that the record was last updated.

  • descriptionstring

    The description of the registry, if it exists.

  • description_htmlstring
  • gravatar_urlstring
  • boxesobject[]
    • namestring

      The name segment of the Box. As an example, this field would represent the "vagrant" in "hashicorp/vagrant". Should be unique within the Registry. This field should only be set when creating the box.

    • descriptionstring

      A long-form description of the box.

    • short_descriptionstring

      A short-form description of the box. Limited to 100 characters.

    • is_privateboolean

      Whether or not the Box is private.

    • created_atstring

      The date the record was created.

    • updated_atstring

      The date that the record was last updated.

    • summaryobject
      • versions_countstring

        Total number of versions available on this box.

      • provider_namesstring[]
      • latest_released_atstring
    • downloadsstring

      The number of times this box has been downloaded.

    • statestring

      BoxState is an enumeration of possible Box states.

    • description_htmlstring

      The HTML rendered description.

    • versionsobject[]
      • namestring

        The version string, ie: v0.0.1 or v2006010201, etc. Must be unique within the Box.

      • statestring

        State is an enumeration of possible Version states.

      • created_atstring

        The date the record was created.

      • updated_atstring

        The date that the record was last updated.

      • descriptionstring

        A long-form description of the version.

      • description_htmlstring

        The HTML rendered description.

      • summaryobject
        • providers_countstring
        • provider_namesstring[]
      • providersobject[]

        Provider describes a Provider with its list of architectures and box data.

        • namestring

          The name of the Provider, should be unique within the version.

        • architecturesobject[]
          • architecture_typestring

            The architecture type that is supported.

          • defaultboolean
          • box_dataobject

            BoxData is the data around the box to be downloaded, including the download URL, checksum information, and size if available.

            • download_urlstring

              The download URL for this box data.

            • checksumstring

              The checksum for the box data.

            • checksum_typestring

              ChecksumType describe supported checksum types.

            • sizestring

              The size of the box file, if available.

            • created_atstring

              The date the record was created.

            • updated_atstring

              The date that the record was last updated.

          • created_atstring

            The date the record was created.

          • updated_atstring

            The date that the record was last updated.

        • created_atstring

          The date the record was created.

        • updated_atstring

          The date that the record was last updated.

        • summaryobject
          • architectures_countstring
          • architecture_typesstring[]
Default Error Response
codeinteger

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

messagestring

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.

detailsobject[]

An arbitrary serialized message. Visit the protobufAny documentation for more information.

  • @typestring

    A URL that describes the type of the serialized message.

​Activate​Registry

put

​/​vagrant​/​registry​/​{registry}​/​activate

​Activate​Registry


https://api.cloud.hashicorp.com/vagrant/2022-09-30/registry/{registry}/activate

Request

Path Parameters
registrystringRequired

The name of the Registry to activate.

Response

Default Error Response
codeinteger

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

messagestring

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.

detailsobject[]

An arbitrary serialized message. Visit the protobufAny documentation for more information.

  • @typestring

    A URL that describes the type of the serialized message.

​Read​Box

get

​/​vagrant​/​registry​/​{registry}​/​box​/​{box}

​Read​Box


https://api.cloud.hashicorp.com/vagrant/2022-09-30/registry/{registry}/box/{box}

Request

Path Parameters
registrystringRequired

The Registry segment of the Box. As an example, this field would represent the "hashicorp" in "hashicorp/vagrant".

boxstringRequired

The name segment of the Box to look up. As an example, this field would represent the "vagrant" in "hashicorp/vagrant".

Query Parameters
expandedboolean

Expand the box child elements.

Response

200 - OK
boxobject
  • namestring

    The name segment of the Box. As an example, this field would represent the "vagrant" in "hashicorp/vagrant". Should be unique within the Registry. This field should only be set when creating the box.

  • descriptionstring

    A long-form description of the box.

  • short_descriptionstring

    A short-form description of the box. Limited to 100 characters.

  • is_privateboolean

    Whether or not the Box is private.

  • created_atstring

    The date the record was created.

  • updated_atstring

    The date that the record was last updated.

  • summaryobject
    • versions_countstring

      Total number of versions available on this box.

    • provider_namesstring[]
    • latest_released_atstring
  • downloadsstring

    The number of times this box has been downloaded.

  • statestring

    BoxState is an enumeration of possible Box states.

  • description_htmlstring

    The HTML rendered description.

  • versionsobject[]
    • namestring

      The version string, ie: v0.0.1 or v2006010201, etc. Must be unique within the Box.

    • statestring

      State is an enumeration of possible Version states.

    • created_atstring

      The date the record was created.

    • updated_atstring

      The date that the record was last updated.

    • descriptionstring

      A long-form description of the version.

    • description_htmlstring

      The HTML rendered description.

    • summaryobject
      • providers_countstring
      • provider_namesstring[]
    • providersobject[]

      Provider describes a Provider with its list of architectures and box data.

      • namestring

        The name of the Provider, should be unique within the version.

      • architecturesobject[]
        • architecture_typestring

          The architecture type that is supported.

        • defaultboolean
        • box_dataobject

          BoxData is the data around the box to be downloaded, including the download URL, checksum information, and size if available.

          • download_urlstring

            The download URL for this box data.

          • checksumstring

            The checksum for the box data.

          • checksum_typestring

            ChecksumType describe supported checksum types.

          • sizestring

            The size of the box file, if available.

          • created_atstring

            The date the record was created.

          • updated_atstring

            The date that the record was last updated.

        • created_atstring

          The date the record was created.

        • updated_atstring

          The date that the record was last updated.

      • created_atstring

        The date the record was created.

      • updated_atstring

        The date that the record was last updated.

      • summaryobject
        • architectures_countstring
        • architecture_typesstring[]
Default Error Response
codeinteger

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

messagestring

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.

detailsobject[]

An arbitrary serialized message. Visit the protobufAny documentation for more information.

  • @typestring

    A URL that describes the type of the serialized message.

​Delete​Box

delete

​/​vagrant​/​registry​/​{registry}​/​box​/​{box}

​Delete​Box


https://api.cloud.hashicorp.com/vagrant/2022-09-30/registry/{registry}/box/{box}

Request

Path Parameters
registrystringRequired

The Registry segment of the Box. As an example, this field would represent the "hashicorp" in "hashicorp/vagrant".

boxstringRequired

The name segment of the Box to delete. As an example, this field would represent the "vagrant" in "hashicorp/vagrant".

Response

200 - OK
operationobject

Operation represents a single operation.

  • idstring

    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.

  • statestring

    State is one of the states that an Operation can be in.

    The states are purposely coarse grained to make it easy to understand the operation state machine: pending => running => done. Or pending => queued => running => done. No other state transitions are possible. Success/failure can be determined based on the result oneof.

  • errorobject

    The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details.

    You can find out more about this error model and how to work with it in the API Design Guide.

    • codeinteger

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

    • messagestring

      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.

    • detailsobject[]

      An arbitrary serialized message. Visit the protobufAny documentation for more information.

      • @typestring

        A URL that describes the type of the serialized message.

  • responseobject

    An arbitrary serialized message. Visit the protobufAny documentation for more information.

    • @typestring

      A URL that describes the type of the serialized message.

  • locationobject

    Location represents a target for an operation in HCP.

    • organization_idstring

      organization_id is the id of the organization.

    • project_idstring

      project_id is the projects id.

    • regionobject

      Region identifies a Cloud data-plane region.

      • providerstring
      • regionstring
  • linkobject

    Link is used to uniquely reference any resource within HashiCorp Cloud. This can be conceptually considered a "foreign key".

    • typestring

      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.

    • idstring

      id is the identifier for this resource.

    • uuidstring

      uuid is the unique UUID for this resource.