Updated on 2024-06-13 GMT+08:00

Obtaining a Resource Pool

Function

This API is used to obtain details about a specified resource pool.

URI

GET /v2/{project_id}/pools/{pool_name}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

pool_name

Yes

String

Name of a resource pool.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

apiVersion

String

API version. Options:

  • v2

kind

String

Resource type. Options:

  • Pool: resource pool

metadata

PoolMetadata object

Metadata of a resource pool.

spec

PoolSpec object

Description of a resource pool.

status

PoolStatus object

Status of a resource pool.

Table 3 PoolMetadata

Parameter

Type

Description

name

String

Automatically generated resource pool name, which is equivalent to pool ID.

Minimum: 4

Maximum: 128

creationTimestamp

String

Timestamp, for example, 2021-11-01T03:49:41Z.

labels

PoolMetaLabels object

Resource pool labels.

annotations

PoolMetaAnnotations object

Resource pool annotations.

Table 4 PoolMetaLabels

Parameter

Type

Description

os.modelarts/workspace.id

String

Workspace ID.

Default: 0

os.modelarts/name

String

Specified resource pool name.

Minimum: 4

Maximum: 64

os.modelarts/resource.id

String

Resource ID, which is typically 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 of a resource pool, for example, admin-console, indicating that the resource pool is created by the administrator on the ModelArts console

os.modelarts.pool/biz

String

Business type of a resource pool. The value can be public or private.

os.modelarts/privileged

String

Whether a resource pool is a privileged pool. If this parameter is specified, the resource pool is a privileged one.

os.modelarts/sharing

String

Whether the resource pool can be shared. Options:

  • unshared: It cannot be shared.

  • shared: It can be shared.

Table 5 PoolMetaAnnotations

Parameter

Type

Description

os.modelarts/description

String

Description of a resource pool.

os.modelarts/billing.mode

String

Billing mode. Options:

  • 0: pay-per-use

  • 1: yearly/monthly

os.modelarts/period.num

String

Subscription period on a yearly/monthly basis, for example, 2.

os.modelarts/period.type

String

Yearly/monthly subscription. Options:

  • 2: month

  • 3: year

  • 4: hour

os.modelarts/auto.renew

String

Whether to automatically renew the subscription. Options:

  • 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, which is mandatory when creating a yearly/monthly resource pool or changing its billing mode.

os.modelarts/flavor.resource.ids

String

Resource ID corresponding to each specification, which is used for interaction with the operations platform

os.modelarts/tms.tags

String

Resource 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 6 PoolSpec

Parameter

Type

Description

type

object

Resource pool type.

  • Dedicate: physical resource pool, which uses a separate network and supports network connection, custom drivers, and custom job types.

  • Logical: logical resource pool, which can be used after the administrator's approval.

scope

Array of strings

Job type enabled, which cannot be specified for logical pools. Options:

  • Train: training jobs

  • Infer: inference jobs

resources

Array of PoolResourceFlavorCount objects

Resource specifications in a resource pool, including resource specifications and the number of resources for each specification.

network

PoolNetwork object

Network settings for a resource pool. This parameter is mandatory for physical resource pools and is unavailable for logical resource pools.

containerNetwork

PoolClusterContainerNetwork object

Kubernetes container network

kubernetesSvcIpRange

String

CIDR of the Kubernetes service network segment

masters

Array of PoolClusterMaster objects

Master node parameters in a resource pool. This parameter is optional for physical resource pools and is unavailable for logical resource pools.

driver

PoolDriver object

Resource pool driver.

userLogin

PoolUserLogin object

Node login information of a privilege pool

clusters

Array of PoolClusterInfo objects

Privilege pool cluster information

ipv6enable

Boolean

Whether to enable IPv6

controlMode

Integer

Restriction status of a resource pool. Options:

  • 0: The resource pool is not restricted.

  • 1: Changing to yearly/monthly billing is restricted.

  • 2: Modifying specifications is restricted.

  • 4: The service is restricted.

  • 8: The resource pool is frozen.

  • 16: The resource pool is frozen by the public security department (cannot be unsubscribed). In addition, multiple statuses are allowed. For example, a resource pool is in state 9, indicating that it is frozen and changing its billing mode to yearly/monthly is restricted.

Table 7 PoolResourceFlavorCount

Parameter

Type

Description

flavor

String

Resource specifications name, for example, modelarts.vm.gpu.t4u8

count

Integer

Minimum count for the specifications in a resource pool

maxCount

Integer

Elastic usage of the resource specifications. 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 PoolNodeAz objects

AZ where resource pool nodes are deployed.

Table 8 PoolNetwork

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.

Minimum: 4

Maximum: 128

vpcId

String

VPC ID, which must be specified when a privileged pool is created and is unavailable for a non-privileged pool

subnetId

String

Subnet ID, which must be specified when a privileged pool is created and is unavailable for a non-privileged pool

Table 9 PoolClusterContainerNetwork

Parameter

Type

Description

mode

String

Container network model

cidr

String

Container network segment. This parameter is available only when the container network model is overlay_l2 or vpc-router.

Table 10 PoolClusterMaster

Parameter

Type

Description

az

String

AZ where the master node is located

Table 11 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. Options:

  • 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 12 PoolUserLogin

Parameter

Type

Description

keyPairName

String

Key pair name

password

String

Password, which must be salted, encrypted, and encoded using Base64. The default username is root.

Table 13 PoolStatus

Parameter

Type

Description

phase

String

Resource pool status. Options:

  • Creating: The resource pool is being created.

  • Running: The resource pool is running.

  • Abnormal: The resource pool malfunctions.

  • Deleting: The resource pool is being deleted.

  • Error: An error occurred in the resource pool.

  • CreationFailed: Creating the resource pool failed.

  • ScalingFailed: Expanding the capacity of the resource pool failed.

  • Waiting: The resource pool 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

Left blank for logical pools, which do not need to be created.

scope

Array of scope objects

Service status of a resource pool.

driver

driver object

Resource pool driver.

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.

clusters

Array of PoolClusterInfo objects

Resource pool cluster information. This parameter is available only for privileged pools.

Table 14 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 unavailable resources.

deleting

PoolResourceFlavorCount object

Number of resources that are being deleted.

Table 15 PoolNodeAz

Parameter

Type

Description

az

String

AZ name.

count

Integer

Number of nodes for expanding the capacity of a specified AZ.

Minimum: 1

Maximum: 2000

Table 16 scope

Parameter

Type

Description

scopeType

String

Job type enabled, which cannot be specified for logical pools. Options:

  • Train: training jobs

  • Infer: inference jobs

state

String

Service status. Options:

  • Enabling: The service is being enabled.

  • Enabled: The service is enabled.

  • Disabling: The service is being disabled.

  • Disabled: The service is disabled.

Table 17 driver

Parameter

Type

Description

gpu

PoolDriverStatus object

GPU driver.

npu

PoolDriverStatus object

NPU driver.

Table 18 PoolDriverStatus

Parameter

Type

Description

version

String

Driver version

state

String

Driver status. Options:

  • Creating: The driver is being created.

  • Upgrading: The driver is being upgraded.

  • Running: The driver is running.

  • Abnormal: The driver malfunctions.

Table 19 PoolClusterInfo

Parameter

Type

Description

name

String

Cluster name

providerId

String

Cluster ID

Status code: 404

Table 20 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

Obtain details about a resource pool.

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

{ }

Example Responses

Status code: 200

OK

{
  "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" : "xxxxxx-7c",
          "count" : 2
        } ]
      } ]
    }
  }
}

Status code: 404

Not found.

{
  "error_code" : "ModelArts.50015001",
  "error_msg" : "pool not found"
}

Status Codes

Status Code

Description

200

OK

404

Not found.

Error Codes

See Error Codes.