HashiConf 2025 Don't miss the live stream of HashiConf Day 2 happening now View live stream
HashiCorp Cloud Platform
HashiCorp Cloud Platform

You are viewing documentation for version 2020-04-20. View latest version.

List

get

/clusters

List

https://api.cloud.hashicorp.com/vault/2020-04-20/organizations/{location.organization_id}/projects/{location.project_id}/clusters

Request

Path Parameters
location.organization_idstringRequired

organization_id is the id of the organization.

location.project_idstringRequired

project_id is the projects id.

Query Parameters
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
clustersobject[]

Cluster represents a single Vault cluster.

  • idstring

    id is ID of the Vault cluster.

  • 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
  • statestring

    State is the state of the Vault cluster. Note that this state represents the abstract Vault cluster itself, not necessarily whether Vault cluster is currently available or not.

    • UNSET: UNSET is a sentinel zero value so that an uninitialized value can be detected.
    • PENDING: PENDING is the state the cluster is in while it is waiting to be created.
    • CREATING: CREATING is the state the cluster is in while it is being provisioned for the first time.
    • RUNNING: RUNNING is the steady state while the cluster is running.
    • FAILED: FAILED is a failure state in which the cluster is unavailable and may required an operator restore action to recover.
    • UPDATING: UPDATING is the state the cluster is in while undergoing a version update.
    • RESTORING: RESTORING is the state the cluster is in while restoring from a snapshot.
    • DELETING: DELETING is the state the cluster is in while it is being de-provisioned.
    • DELETED: DELETED is the state the cluster is in when it has been de-provisioned. At this point, the cluster is eligible for garbage collection.
    • SEALING: SEALING is the state the cluster is in when it is about to get sealed.
    • SEALED: SEALED is the state the cluster is in while a cluster is sealed.
    • UNSEALING: UNSEALING is the state the cluster is in when it is about to get unsealed.
  • configobject
    • vault_configobject
      • namespacestring

        namespace is the name of the customer namespace.

      • initial_versionstring

        initial_version is the initial Vault version to use when creating the cluster. Once the cluster is created, this value is no longer used.

      • max_lease_ttlstring

        max_lease_ttl is the max lease ttl for this Vault cluster.

    • network_configobject
      • network_idstring

        network_id is the ID of the network the Vault cluster belongs to.

      • public_ips_disabledboolean

        public_ips_disabled indicates if public IP's are disabled.

      • cors_configobject
        • enabledboolean

          enabled is true if CORS is enabled for this cluster.

        • allowed_originsstring[]
        • allowed_headersstring[]
    • maintenance_configobject
    • snapshot_configobject
      • periodic_snapshots_disabledboolean
    • capacity_configobject
      • num_serversinteger

        num_servers is the number of nodes this Vault cluster should have.

    • vault_accessobject
      • urlstring
      • root_tokenstring
      • recovery_keystring
    • public_ips_disabledboolean
    • audit_configobject
      • audit_logs_disabledboolean
  • dns_namesobject

    DNSNames holds all of the cluster's DNS names.

    • privatestring

      private is the DNS name pointing to the cluster's private IP addresses.

    • publicstring

      public is the DNS name pointing to the cluster's public IP addresses.

  • created_atstring

    created_at is the timestamp of when the cluster was first created.

  • current_versionstring

    currently_deployed_version is the version of the currrent Vault deployment.

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
errorstring
codeinteger
messagestring
detailsobject[]

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

  • type_urlstring

    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.

  • valuestring

    Must be a valid serialized protocol buffer of the above specified type.