Obtaining Resource Pools¶

Function¶

This API is used to obtain resource pools.

Debugging¶

You can debug this API in which supports automatic authentication. API Explorer automatically generates sample SDK code and provides the debug function.

URI¶

GET /v2/{project_id}/pools

**Table 1** URI parameters¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID and Name.

**Table 2** Query parameters¶
Parameter	Mandatory	Type	Description
workspaceId	No	String	Workspace ID. The default value is 0.
labelSelector	No	String	Label filtering.
status	No	String	Resource pool status. The options are as follows: created: The resource pool is successfully created. failed: The resource pool failed to be created. The failure record is retained for three days. creating: The resource pool is being created. If this parameter is left blank, valid resource pools are returned, including those being created and those created.
parent	No	String	Name of the parent resource pool. It is used to query the sub-pools of a specified resource pool.

Request Parameters¶

None

Response Parameters¶

Status code: 200

**Table 3** Response body parameters¶
Parameter	Type	Description
apiVersion	String	API version. The options are as follows: v2
kind	String	Resource type. The options are as follows: PoolList: resource pool list
metadata	metadata object	Metadata of the resource pool list.
items	Array of Pool objects	Resource pool list.

**Table 4** metadata¶
Parameter	Type	Description
continue	String	Next query position in pagination query
remainingItemCount	Integer	Remaining resources

**Table 5** Pool¶
Parameter	Type	Description
apiVersion	String	API version. The options are as follows: v2
kind	String	Resource type. The options are as follows: Pool: resource pool
metadata	PoolMetadata object	Resource pool metadata.
spec	PoolSpec object	Expected resource pool specifications.
status	PoolStatus object	Resource pool status.

**Table 6** PoolMetadata¶
Parameter	Type	Description
name	String	Automatically generated resource pool name, which is equivalent to the pool ID
creationTimestamp	String	Timestamp, for example, 2021-11-01T03:49:41Z
labels	PoolMetaLabels object	Resource pool labels
annotations	PoolMetaAnnotations object	Resource pool annotations

**Table 7** PoolMetaLabels¶
Parameter	Type	Description
os.modelarts/workspace.id	String	Workspace ID.
os.modelarts/name	String	Specified resource pool name.
os.modelarts/resource.id	String	ID of the primary resource in the resource pool, which is usually provided for CBC.
os.modelarts/tenant.domain.id	String	ID of the tenant corresponding to the resource pool, which records the tenant account where the resource pool is created.
os.modelarts/create-from	String	Source where a resource pool is created.
os.modelarts.pool/biz	String	Business type of a resource pool. The value can be public or private.
os.modelarts/sharing	String	Whether the resource pool can be shared. The options are as follows: unshared: It cannot be shared. shared: It can be shared.

**Table 8** PoolMetaAnnotations¶
Parameter	Type	Description
os.modelarts/description	String	Description of a resource pool.
os.modelarts/billing.mode	String	Billing mode. The options are as follows: 0: pay-per-use billing mode
os.modelarts/period.num	String	Subscription period, for example, 2.
os.modelarts/period.type	String	Subscription type. The options are as follows: 2: monthly 3: yearly 4: hourly
os.modelarts/auto.renew	String	Whether to enable auto-renewal. The options are as follows: 0: auto-renewal disabled (default value) 1: auto-renewal enabled
os.modelarts/promotion.info	String	Discount selected in CBC.
os.modelarts/service.console.url	String	URL of the page displayed after the subscription order is paid.
os.modelarts/order.id	String	Order ID.
os.modelarts/flavor.resource.ids	String	Resource ID corresponding to each flavor, which is used for interaction with CBC.
os.modelarts/tms.tags	String	TMS tags specified by the user during creation.
os.modelarts/scheduler.extension	String	Priority that can be set for the jobs delivered by other users to the shared resource pool.
os.modelarts.pool/subpools.count	String	Number of logical sub-pools in a resource pool.

**Table 9** PoolSpec¶
Parameter	Type	Description
type	String	Resource pool type. The options are as follows: Dedicate: physical resource pool, which uses a separate network and supports network connection, custom drivers, and custom job types. Logical: logical resource pool, which features faster creation. Only training jobs are supported currently. After a logical pool is created, contact the administrator for approval.
scope	Array of strings	Job type supported by a resource pool. Select at least one type. All options are supported by physical resource pools. Logical resource pools support only training jobs. The options are as follows: Train: training job Infer: inference job
resources	Array of resources objects	Resource flavor list in a resource pool, including resource flavors and the number of resources for each flavor.
network	network object	Network settings for a resource pool. This parameter is mandatory for physical resource pools and is unavailable for logical resource pools.
masters	Array of masters objects	Master node parameters in a resource pool. This parameter is optional for physical resource pools and is unavailable for logical resource pools.
jobFlavors	Array of strings	Names of the job flavors supported by a resource pool.
driver	PoolDriver object	Resource pool driver information.
controlMode	Integer	Restriction status of a resource pool. The options are as follows: 0: It is not restricted. 2: Modifying specifications is restricted. 4: The service is restricted. 8: It is frozen. 16. A resource pool can have several statuses.

**Table 10** resources¶
Parameter	Type	Description
flavor	String	Resource flavor, for example, modelarts.vm.gpu.t4u8
count	Integer	Number of resources of the specified flavor
azs	Array of PoolNodeAz objects	AZ list

**Table 11** PoolNodeAz¶
Parameter	Type	Description
az	String	AZ name
count	Integer	Number of nodes for expanding the capacity of a specified AZ

**Table 12** network¶
Parameter	Type	Description
name	String	Network name. When you create a network with a specified name, the system will automatically create subnets for you. By default, the first subnet will be used.

**Table 13** masters¶
Parameter	Type	Description
az	String	AZ where the master node is located

**Table 14** PoolDriver¶
Parameter	Type	Description
gpuVersion	String	GPU driver version. This parameter is available when GPUs are used in a physical resource pool. For example, the GPU driver version is 440.33.
npuVersion	String	NPU driver version. This parameter is available when Ascend chips are used in a physical resource pool. For example, the Ascend driver version is C78.
updateStrategy	String	Driver upgrade policy. The options are as follows: force: forcible upgrade. The node drivers are upgraded immediately, which may affect jobs running on the node. idle: secure upgrade. The drivers are upgraded when no job is running on the node.

**Table 15** PoolStatus¶
Parameter	Type	Description
phase	String	Status of a resource pool. The options are as follows: Creating: It is being created. Running: It is running. Abnormal: It malfunctions. Deleting: It is being deleted. Error: An error occurred in the resource pool. CreationFailed: It fails to be created. ScalingFailed: It fails to be scaled out. Waiting: It is awaiting creation, which is typically caused by an unpaid order or unapproved request.
message	String	Message indicating that the resource pool is in the current state.
resources	resources object	Resources in different states in a resource pool.
scope	Array of scope objects	Service status in the resource pool.
driver	driver object	Resource pool driver information.
parent	String	Name of the parent node of a resource pool. This parameter is left blank for physical pools.
root	String	Name of the root node in a resource pool. For a physical pool, the value is its name.

**Table 16** resources¶
Parameter	Type	Description
creating	PoolResourceFlavorCount object	Number of resources that are being created
available	PoolResourceFlavorCount object	Number of available resources
abnormal	PoolResourceFlavorCount object	Number of abnormal resources
deleting	PoolResourceFlavorCount object	Number of resources that are being deleted

**Table 17** PoolResourceFlavorCount¶
Parameter	Type	Description
flavor	String	Resource flavor name, for example, modelarts.vm.gpu.t4u8.
count	Integer	Minimum count for the flavors in a resource pool.
maxCount	Integer	Elastic usage of the resource flavor. This parameter value is the same the count value in a physical pool. It is greater than or equal to the count value in a logical pool.
azs	Array of azs objects	Number of AZs where resources are located.

**Table 18** azs¶
Parameter	Type	Description
az	String	AZ name
count	Integer	Number of AZ resources

**Table 19** scope¶
Parameter	Type	Description
scopeType	String	Service type. The options are as follows: Train: training job Infer: inference job
state	String	Service status. The options are as follows: Enabling: It is being started. Enabled: It is enabled. Disabling: It is being disabled. Disabled: It is disabled.

**Table 20** driver¶
Parameter	Type	Description
gpu	PoolDriverStatus object	GPU driver information
npu	PoolDriverStatus object	NPU driver information

**Table 21** PoolDriverStatus¶
Parameter	Type	Description
version	String	Current driver version.
state	String	Current driver status. The options are as follows: Creating: It is being created. Upgrading: It is being upgraded. Running: It is running. Abnormal: It is abnormal.

Example Requests¶

Obtain resource pools.

GET https://{endpoint}/v2/{project_id}/pools

{ }

Example Responses¶

Status code: 200

OK.

{
  "kind" : "PoolList",
  "apiVersion" : "v2",
  "items" : [ {
    "kind" : "Pool",
    "apiVersion" : "v2",
    "metadata" : {
      "name" : "auto-pool-os-86c13962597848eeb29c5861153a391f",
      "creationTimestamp" : "2022-09-16T03:10:40Z",
      "labels" : {
        "os.modelarts/name" : "auto-pool-os",
        "os.modelarts/workspace.id" : "0",
        "os.modelarts/resource.id" : "maos-auto-pool-os-72w8d"
      },
      "annotations" : {
        "os.modelarts/description" : "",
        "os.modelarts/billing.mode" : "0",
        "os.modelarts/external-access" : "elb"
      }
    },
    "spec" : {
      "type" : "Dedicate",
      "scope" : [ "Train", "Infer" ],
      "resources" : [ {
        "flavor" : "modelarts.vm.cpu.4ud",
        "count" : 2
      } ],
      "network" : {
        "name" : "network-maos-86c13962597848eeb29c5861153a391f"
      }
    },
    "status" : {
      "phase" : "Running",
      "root" : "auto-pool-os-86c13962597848eeb29c5861153a391f",
      "scope" : [ {
        "scopeType" : "Train",
        "state" : "Enabled"
      }, {
        "scopeType" : "Infer",
        "state" : "Enabled"
      } ],
      "resources" : {
        "available" : [ {
          "flavor" : "modelarts.vm.cpu.4ud",
          "count" : 2,
          "azs" : [ {
            "az" : "xxxxx-7c",
            "count" : 2
          } ]
        } ]
      }
    }
  } ]
}

Status Codes¶

Status Code	Description
200	OK.

Error Codes¶

For details, see Error Codes.

last updated: 2024-11-14 08:44 UTC - commit: 3b80612feba1452e3d3adbec6770d8e1b5070820