更新时间:2023-11-27 GMT+08:00

获取指定集群信息(废弃)

功能介绍

该API用于查询指定集群的信息,包括名称、描述以及绑定的计算资源数。

当前接口已废弃,不推荐使用。

URI

  • URI格式:

    GET /v2.0/{project_id}/clusters/{cluster_name}

  • 参数说明
    表1 URI参数

    名称

    是否必选

    说明

    project_id

    项目编号,用于资源隔离。获取方式请参考获取项目ID

    cluster_name

    集群名称。

请求消息

无请求参数。

响应消息

  • 返回码

    成功返回200。

  • 响应参数
    响应参数如表2所示。
    表2 响应参数说明

    参数

    是否必选

    参数类型

    说明

    create_time

    Long

    创建集群的时间。是单位为“毫秒”的时间戳。

    description

    String

    集群的描述信息。

    cu_count

    Integer

    与集群绑定的计算单元个数。

    owner

    String

    创建集群的用户。

    cluster_name

    String

    集群名称。

    status

    String

    具体集群状态信息可参见表3

    resource_mode

    Integer

    集群类型。

    • 0:共享集群
    • 1:专属集群
    表3 集群状态说明

    名称

    说明

    CREATING

    集群正在创建中,当前不可用。

    AVAILABLE

    集群可用。

    SUSPENDED

    由于长时间未使用,集群当前处于挂起状态,可通过创建批处理作业接口,重新激活集群。

    RECOVERING

    集群处于挂起恢复状态,当状态变为AVAILABLE时可再次使用。

示例

  • 请求样例:
    None
  • 成功响应样例:
    { 
        "create_time": 1508143955000, 
        "cu_count": 16, 
        "description": "test", 
        "owner": "tenant1", 
        "cluster_name": "cluster1",
        "status": "AVAILABLE",
        "resource_mode": 0
     }

    调用接口出错后,将不会返回上述结果,而是返回错误码和错误信息,详细介绍请参见错误码