Updating a Resource Pool¶

Function¶

This API is used to update a specified resource pool.

URI¶

PATCH /v2/{project_id}/pools/{pool_name}

**Table 1** Path Parameters¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.
pool_name	Yes	String	Automatically generated resource pool name.

Request Parameters¶

**Table 2** Request header parameters¶
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Application/merge-patch + JSON.

**Table 3** Request body parameters¶
Parameter	Mandatory	Type	Description
metadata	No	PoolMetadataUpdate object	Metadata of a resource pool.
spec	No	PoolSpecUpdate object	Description of a resource pool.

**Table 4** PoolMetadataUpdate¶
Parameter	Mandatory	Type	Description
labels	No	PoolLabelsUpdate object	Resource pool labels
annotations	No	PoolAnnotationsUpdate object	Resource pool annotations.

**Table 5** PoolLabelsUpdate¶
Parameter	Mandatory	Type	Description
os.modelarts/workspace.id	No	String	Target workspace ID. The workspace ID cannot be changed at the same time as other resource pool modification operations (such as scaling).
os.modelarts/sharing	No	String	Whether the resource pool can be shared. The options are as follows: unshared: It cannot be shared. shared: It can be shared.

**Table 6** PoolAnnotationsUpdate¶
Parameter	Mandatory	Type	Description
os.modelarts/description	No	String	Description of a resource pool, specifying the application scenarios of the resource pool. The following special characters are not allowed: `!<>=&"'.`
os.modelarts/scheduler.extension	No	String	Priority that can be set for the jobs delivered by other users to the shared resource pool

**Table 7** PoolSpecUpdate¶
Parameter	Mandatory	Type	Description
scope	No	Array of strings	Job type enabled, which cannot be specified for logical pools. Options: Train: training jobs Infer: inference jobs [- Notebook: notebook jobs](tags: hc) Enumeration values: Train Infer Notebook
resources	No	Array of PoolResourceFlavorCount objects	Data model for the number of resources of the specified specifications
driver	No	PoolDriver object	Resource pool driver, which cannot be specified for logical pools.

**Table 8** PoolResourceFlavorCount¶
Parameter	Mandatory	Type	Description
flavor	Yes	String	Resource specifications name, for example, modelarts.vm.gpu.t4u8
count	Yes	Integer	Minimum count for the specifications in a resource pool
maxCount	Yes	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.
extendParams	No	Map<String,String>	Custom configuration, for example, setting dockerSize to "extendParams": {"dockerBaseSize": "100" }
azs	No	Array of PoolNodeAz objects	AZ where resource pool nodes are deployed.

**Table 9** PoolNodeAz¶
Parameter	Mandatory	Type	Description
az	Yes	String	AZ name.
count	Yes	Integer	Number of nodes for expanding the capacity of a specified AZ. Minimum: 1 Maximum: 2000

**Table 10** PoolDriver¶
Parameter	Mandatory	Type	Description
gpuVersion	No	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	No	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	No	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.

Response Parameters¶

Status code: 200

**Table 11** 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 12** 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 13** 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 14** 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
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/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 15** 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. After a logical pool is created, contact the administrator for approval.
scope	Array of strings	Job type enabled, which cannot be specified for logical pools. Options: Train: training jobs Infer: inference jobs [- Notebook: notebook jobs](tags: hc) Enumeration values: Train Infer Notebook
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. 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.

**Table 16** 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.
extendParams	Map<String,String>	Custom configuration, for example, setting dockerSize to "extendParams": {"dockerBaseSize": "100" }
azs	Array of PoolNodeAz objects	AZ where resource pool nodes are deployed.

**Table 17** 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 18** PoolClusterContainerNetwork¶
Parameter	Type	Description
mode	String	Container network model Enumeration values: overlay_l2 vpc-router eni
cidr	String	Container network segment. This parameter is available only when the container network model is overlay_l2 or vpc-router.

**Table 19** PoolClusterMaster¶
Parameter	Type	Description
az	String	AZ where the master node is located

**Table 20** 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 21** 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 22** 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 23** 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 24** 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 25** scope¶
Parameter	Type	Description
scopeType	String	Job type enabled, which cannot be specified for logical pools. Options: Train: training jobs Infer: inference jobs [- Notebook: notebook jobs](tags: hc) Enumeration values: Train Infer Notebook
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 26** driver¶
Parameter	Type	Description
gpu	PoolDriverStatus object	GPU driver.
npu	PoolDriverStatus object	NPU driver.

**Table 27** 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 28** PoolClusterInfo¶
Parameter	Type	Description
name	String	Cluster name
providerId	String	Cluster ID

Status code: 400

**Table 29** Response body parameters¶
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 404

**Table 30** Response body parameters¶
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Requests¶

Expand the capacity of a resource pool.

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

{
  "spec" : {
    "resources" : [ {
      "flavor" : "modelarts.vm.cpu.4ud",
      "count" : 3
    } ]
  }
}

Example Responses¶

Status code: 200

{
  "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/resource.id" : "maos-auto-pool-os-72w8d"
    },
    "annotations" : {
      "os.modelarts/description" : "",
      "os.modelarts/billing.mode" : "0"
    }
  },
  "spec" : {
    "type" : "Dedicate",
    "scope" : [ "Train", "Infer" ],
    "resources" : [ {
      "flavor" : "modelarts.vm.cpu.4ud",
      "count" : 3
    } ],
    "network" : {
      "name" : "network-maos-86c13962597848eeb29c5861153a391f"
    }
  },
  "status" : {
    "phase" : "Running",
    "root" : "auto-pool-os-86c13962597848eeb29c5861153a391f",
    "scope" : [ {
      "scopeType" : "Train",
      "state" : "Enabled"
    }, {
      "scopeType" : "Infer",
      "state" : "Enabled"
    } ],
    "resources" : {
      "creating" : [ {
        "flavor" : "modelarts.vm.cpu.4ud",
        "count" : 1,
        "azs" : [ {
          "az" : "xxxxxx-7c",
          "count" : 1
        } ]
      } ],
      "available" : [ {
        "flavor" : "modelarts.vm.cpu.4ud",
        "count" : 2,
        "azs" : [ {
          "az" : "xxxxxx-7c",
          "count" : 2
        } ]
      } ]
    }
  }
}

Status code: 400

Bad request

{
  "error_code" : "ModelArts.50004000",
  "error_msg" : "Bad request"
}

Status code: 404

Not found.

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

Status Codes¶

Status Code	Description
200	OK
400	Bad request
404	Not found.

Error Codes¶

See Error Codes.

last updated: 2024-12-11 13:55 UTC - commit: afb4a7dfa15e256dc933e946d9e874db041cb35c