Files

Wuwan, Qi 4ee10e3166 ModelArts API 24.9.0 20250414

Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Wuwan, Qi <wuwanqi1@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-committed-by: Wuwan, Qi <wuwanqi1@noreply.gitea.eco.tsi-dev.otc-service.com>

2025-05-09 10:22:58 +00:00

33 KiB

Raw Permalink Blame History

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	BillingInfo object	Billing information of a resource flavor.
flavor_info	FlavorInfoResponse object	Resource flavor details.
attributes	Map<String,String>	Other specification attributes.

**Table 5** BillingInfo
Parameter	Type	Description
code	String	Billing code.
unit_num	Integer	Billing unit.

**Table 6** FlavorInfoResponse
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.
memory	Memory object	Memory information.
disk	DiskResponse 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	Number of memory units.

**Table 11** DiskResponse
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.

Parent topic: Training Management

33 KiB Raw Permalink Blame History