Obtaining Details About a Notebook Resource Pool

Function

This API is used to obtain details about a notebook resource pool. This API is used when you need to query details about a specified cluster when creating a notebook instance job. Before using this API, ensure that the cluster has been managed and you have the required permission. After this API is called, the system returns the instance ID, name, flavor, instance status, and URL for accessing the cluster. If the cluster does not exist, is not managed, or you do not have the access permission, the API will return an error message.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

GET /v1/{project_id}/authoring/clusters/{cluster_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID. For details, see Obtaining a Project ID and Name. Constraints: The value can contain 1 to 64 characters. Letters, digits, and hyphens (-) are allowed. Range: N/A Default Value: N/A
cluster_id	Yes	String	Definition: ID of the managed cluster. Constraints: N/A Range: N/A Default Value: N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
logic_cluster_id	String	Definition: Logical resource pool ID. Range: N/A
status	String	Definition: Resource pool status. Range: PENDING INITIALIZING INITIALIZE_FAILED ACTIVE DELETING DELETED DELETE_FAILED MIGRATING
pool_id	String	Definition: Resource pool ID. Range: N/A
type	String	Definition: Resource pool type. Range: MANAGED: public pool DEDICATED: dedicated pool
resource_categories	String	Definition: Resource type. Range: GPU CPU ASCEND
workspace_id	String	Definition: Workspace ID. For details about how to obtain the value, see Obtaining Workspaces. If no workspace is created, the default value is 0. If a workspace is created and used, use the actual value. Range: N/A
create_at	String	Definition: UTC time when the instance is created, accurate to millisecond. Range: N/A
update_at	String	Definition: Time (UTC) when the instance was last updated, accurate to millisecond. Range: N/A
project_id	String	Definition: User project ID. For details, see Obtaining a Project ID and Name. Constraints: N/A Range: N/A Default Value: N/A
domain_id	String	Definition: Account ID. Range: N/A
flavors	Array of Flavor objects	Definition: Resource pool flavors.

**Table 3** Flavor
Parameter	Type	Description
arch	String	Definition: Hardware architecture type. Range: x86_64: x86 architecture aarch64: Arm architecture
billing	BillingInfo object	Definition: CDR information.
category	String	Definition: Processor type. Range: CPU GPU ASCEND
description	String	Definition: Flavor description. Range: N/A
evs_max_size	String	Definition: Maximum size (GB) of EVS storage that can be created. Range: N/A
evs_sku_code	String	Definition: SKU code of EVS storage. Range: N/A
feature	String	Definition: Flavor type. Range: DEFAULT: CodeLab NOTEBOOK: notebook
free	Boolean	Definition: Indicates whether a free flavor is used. Range: Boolean true: free flavor. false: non-free flavor.
grow_support_type	String	Definition: Site type. Range: COMMON: supported on both the Chinese mainland and International sites NATIONAL: supported only on the Chinese mainland site INTERNATIONAL: supported only on the International site NONE: supported on neither the Chinese mainland nor International sites
id	String	Definition: Flavor ID. Range: N/A
memory	String	Definition: Memory size. Range: N/A
name	String	Definition: Flavor name. Range: N/A
sold_out	Boolean	Definition: Indicates whether the flavor is sold out. Range: Boolean true: The flavor is sold out. false: The flavor is not sold out.
storages	Array of strings	Definition: Storage type supported by the flavor. Range: EVS OBS: Object Storage Service OBSFS: parallel file system EFS: SFS Turbo
vcpus	Integer	Definition: Number of CPU cores. Range: N/A
gpu	GPUsInfo object	Definition: GPU specifications when the processor type is GPU.
ascend	AscendInfo object	Definition: Ascend specifications when the processor type is ASCEND.

**Table 4** BillingInfo
Parameter	Type	Description
code	String	Definition: Billing code. Range: N/A
unit_num	Integer	Definition: Billing unit. Range: N/A

**Table 5** GPUsInfo
Parameter	Type	Description
type	String	Definition: GPU type. Range: N/A
gpu	Double	Definition: Number of GPUs. Range: N/A
gpu_memory	String	Definition: GPU memory. Range: N/A

**Table 6** AscendInfo
Parameter	Type	Description
npu	Integer	Definition: Number of NPUs. Range: N/A
npu_memory	String	Definition: NPU memory. Range: N/A
type	String	Definition: NPU type. Range: N/A