All Products
Search
Document Center

Hologres:GetWarehouseDetail

Last Updated:Apr 15, 2024

Queries details of a virtual warehouse instance.

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}/getWarehouseDetail

Request parameters

ParameterTypeRequiredDescriptionExample
instanceIdstringNo

The instance ID.

hgprecn-cn-i7m2ucpyu005

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

D3AE84AB-0873-5FC7-A4C4-8CF869D2FA70
WarehouseDetailobject

The values returned.

ReservedCpustring

The reserved computing resources. The amount of computing resources in all running virtual warehouses in an instance cannot exceed the amount of reserved computing resources in the virtual warehouses.

64
RemainingCpustring

The remaining unallocated computing resources of the virtual warehouse instance.

32
WarehouseListobject []

The list of virtual warehouses.

Cpulong

The number of CPU cores.

32
Memlong

The memory capacity.

128
Idlong

The ID.

2
Statusstring

The status.

Valid values:

  • kRunning

  • kSuspended

  • kInit

  • kFailed

  • kAllocating

kRunning
NodeCountlong

The number of compute nodes.

2
Namestring

The name of the virtual warehouse instance.

MyWarehouse

Examples

Sample success responses

JSONformat

{
  "RequestId": "D3AE84AB-0873-5FC7-A4C4-8CF869D2FA70",
  "WarehouseDetail": {
    "ReservedCpu": "64",
    "RemainingCpu": "32",
    "WarehouseList": [
      {
        "Cpu": 32,
        "Mem": 128,
        "Id": 2,
        "Status": "kRunning",
        "NodeCount": 2,
        "Name": "MyWarehouse"
      }
    ]
  }
}

Error codes

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