Obtaining the General Specifications Supported by a Training Job¶

Function¶

This API is used to obtain the public flavors supported by a training job.

URI¶

GET /v2/{project_id}/training-job-flavors

**Table 1** Path 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
flavor_type	No	String	This API is used to obtain training job flavors. If this parameter is not specified, all flavors will be obtained. Options: CPU GPU

Request Parameters¶

None

Response Parameters¶

Status code: 200

**Table 3** Response body parameters¶
Parameter	Type	Description
total_count	Integer	Total number of resource flavors of a training job.
flavors	Array of FlavorResponse objects	List of resource flavors of a training job.

**Table 4** FlavorResponse¶
Parameter	Type	Description
flavor_id	String	ID of the resource flavor.
flavor_name	String	Name of the resource flavor.
max_num	Integer	Maximum number of nodes in a resource flavor.
flavor_type	String	Resource flavor type. Options: CPU GPU
billing	billing object	Billing information of a resource flavor.
flavor_info	flavor_info object	Resource flavor details.
attributes	Map<String,String>	Other specification attributes.

**Table 5** billing¶
Parameter	Type	Description
code	String	Billing code.
unit_num	Integer	Number of billing units.

**Table 6** flavor_info¶
Parameter	Type	Description
max_num	Integer	Maximum number of nodes that can be selected. The value 1 indicates that the distributed mode is not supported.
cpu	cpu object	CPU specifications.
gpu	gpu object	GPU specifications.
npu	npu object	Ascend specifications
memory	memory object	Memory information.
disk	disk object	Disk information.

**Table 7** cpu¶
Parameter	Type	Description
arch	String	CPU architecture.
core_num	Integer	Number of cores.

**Table 8** gpu¶
Parameter	Type	Description
unit_num	Integer	Number of GPUs.
product_name	String	Product name.
memory	String	Memory.

**Table 9** npu¶
Parameter	Type	Description
unit_num	String	Number of NPUs.
product_name	String	Product name.
memory	String	Memory.

**Table 10** memory¶
Parameter	Type	Description
size	Integer	Memory size.
unit	String	Memory size

**Table 11** disk¶
Parameter	Type	Description
size	Integer	Disk size.
unit	String	Unit of the disk size.

Example Requests¶

The following shows how to query the public CPU resource flavors of training jobs.

GET https://endpoint/v2/{project_id}/training-job-flavors?flavor_type=CPU

Example Responses¶

Status code: 200

{
  "total_count" : 2,
  "flavors" : [ {
    "flavor_id" : "modelarts.vm.cpu.2u",
    "flavor_name" : "Computing CPU(2U) instance",
    "flavor_type" : "CPU",
    "billing" : {
      "code" : "modelarts.vm.cpu.2u",
      "unit_num" : 1
    },
    "flavor_info" : {
      "max_num" : 1,
      "cpu" : {
        "arch" : "x86",
        "core_num" : 2
      },
      "memory" : {
        "size" : 8,
        "unit" : "GB"
      },
      "disk" : {
        "size" : 50,
        "unit" : "GB"
      }
    }
  }, {
    "flavor_id" : "modelarts.vm.cpu.8u",
    "flavor_name" : "Computing CPU(8U) instance",
    "flavor_type" : "CPU",
    "billing" : {
      "code" : "modelarts.vm.cpu.8u",
      "unit_num" : 1
    },
    "flavor_info" : {
      "max_num" : 16,
      "cpu" : {
        "arch" : "x86",
        "core_num" : 8
      },
      "memory" : {
        "size" : 32,
        "unit" : "GB"
      },
      "disk" : {
        "size" : 50,
        "unit" : "GB"
      }
    }
  } ]
}

Status Codes¶

Status Code	Description
200	ok

Error Codes¶

See Error Codes.

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