All Products
Search
Document Center

Hologres:ListWarehouses

Last Updated:Apr 15, 2024

Queries the list of virtual warehouse instances.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

GET /api/v1/instances/{instanceId}/listWarehouses

Request parameters

ParameterTypeRequiredDescriptionExample
instanceIdstringNo

The instance ID.

hgpostcn-cn-x0r382joi001

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

requestIdstring

The request ID.

819A7F0F-2951-540F-BD94-6A41ECF0281F
WarehouseListobject []

The list of virtual warehouse instances.

Idlong

The ID.

3
Cpulong

The number of CPU cores.

32
Memlong

The memory capacity.

128
Namestring

The name of the virtual warehouse instance.

MyWarehouse
Statusstring

The status.

Valid values:

  • kRunning

  • kSuspended

  • kInit

  • kFailed

  • kAllocating

kRunning
NodeCountlong

The number of compute nodes.

2

Examples

Sample success responses

JSONformat

{
  "requestId": "819A7F0F-2951-540F-BD94-6A41ECF0281F",
  "WarehouseList": [
    {
      "Id": 3,
      "Cpu": 32,
      "Mem": 128,
      "Name": "MyWarehouse",
      "Status": "kRunning",
      "NodeCount": 2
    }
  ]
}

Error codes

For a list of error codes, visit the Service error codes.