All Products
Search

This Product

    AnalyticDB:DescribeDBResourceGroup

    Document Center

    AnalyticDB:DescribeDBResourceGroup

    Last Updated:Jun 11, 2026

    Meminta informasi grup sumber daya suatu klaster.

    Deskripsi operasi

    Untuk endpoint layanan, lihat Endpoint Layanan.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    adb:DescribeDBResourceGroup

    list

    *DBClusterLakeVersion

    acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DBClusterId

    string

    Yes

    ID klaster Data Lakehouse Edition.

    amv-bp11q28kvl688****
    GroupName

    string

    No

    Nama grup sumber daya.

    Catatan

    Jika Anda menghilangkan parameter ini, operasi akan mengembalikan semua grup sumber daya di klaster yang ditentukan.

    test_group
    GroupType

    string

    No

    Tipe grup sumber daya. Nilai yang valid:

    • Interactive

    • Job

    Catatan

    Lihat Ikhtisar grup sumber daya untuk informasi lebih lanjut tentang grup sumber daya Data Lakehouse Edition.

    Job
    RegionId

    string

    No

    ID region.

    Catatan

    Anda dapat memanggil DescribeRegions untuk memperoleh daftar region terbaru.

    cn-hangzhou

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema respons.

    RequestId

    string

    ID permintaan.

    A94B6C02-7BD4-5D67-9776-3AC8317E8DD3
    GroupsInfo

    array<object>

    Daftar grup sumber daya.

    array<object>

    Daftar grup sumber daya.

    GroupType

    string

    Tipe grup sumber daya. Nilai yang valid:

    • Interactive

    • Job

    Catatan

    Untuk informasi lebih lanjut tentang grup sumber daya di Data Lakehouse Edition, lihat Ikhtisar grup sumber daya (Data Lakehouse Edition).

    Job
    GroupName

    string

    Nama grup sumber daya.

    test1
    MinComputeResource

    string

    Jumlah minimum sumber daya komputasi yang dicadangkan, dalam ACU.

    0ACU
    MaxComputeResource

    string

    Jumlah maksimum sumber daya komputasi yang dicadangkan, dalam ACU.

    512ACU
    ClusterSizeResource

    string

    Parameter cadangan.

    Reserved parameter
    MinClusterCount

    integer

    Parameter cadangan.

    Reserved parameter
    MaxClusterCount

    integer

    Parameter cadangan.

    Reserved parameter
    RunningClusterCount

    integer

    Parameter cadangan.

    Reserved parameter
    ClusterMode

    string

    Parameter cadangan.

    Reserved parameter
    ElasticMinComputeResource

    string

    Jumlah minimum sumber daya komputasi elastis, dalam ACU.

    16ACU
    EnableSpot

    string

    Menunjukkan apakah fitur spot instance diaktifkan untuk grup sumber daya. Jika Anda mengaktifkan fitur ini, harga unit sumber daya akan berkurang, tetapi sumber daya dapat ditarik kembali kapan saja. Nilai yang valid:

    • True: Fitur spot instance diaktifkan.

    • False: Fitur spot instance dinonaktifkan.

    Parameter ini hanya dapat diatur ke True untuk grup sumber daya Job.

    True
    GroupUsers

    string

    Pengguna RAM yang terikat ke grup sumber daya.

    testb,testc
    CreateTime

    string

    Waktu pembuatan grup sumber daya. Waktu dalam UTC dan diformat sebagai yyyy-MM-ddTHH:mm:ssZ.

    2022-08-29T03:34:30Z
    UpdateTime

    string

    Waktu pembaruan terakhir grup sumber daya. Waktu dalam UTC dan diformat sebagai yyyy-MM-ddTHH:mm:ssZ.

    2022-08-31T03:34:30Z
    Status

    string

    Status grup sumber daya. Nilai yang valid:

    • creating: Grup sumber daya sedang dibuat.

    • ok: Grup sumber daya aktif.

    • pendingdelete: Grup sumber daya menunggu penghapusan.

    ok
    Rules

    array<object>

    Daftar aturan pengiriman pekerjaan.

    object

    Detail aturan pengiriman pekerjaan.

    GroupName

    string

    The name of the resource group.

    user_default
    QueryTime

    string

    The query running time threshold, in milliseconds (ms).

    180000
    TargetGroupName

    string

    The name of the target resource group.

    job
    Engine

    string

    Tipe mesin.

    AnalyticDB
    Message

    string

    Pesan tentang status aturan pengiriman pekerjaan.

    SUCCESS
    AutoStopInterval

    string

    Durasi setelah grup sumber daya dihentikan secara otomatis. Tentukan durasi dalam menit, diakhiri dengan m. Nilai yang valid: 0m atau nilai dari 5m hingga 10080m. Nilai 0m menonaktifkan penghentian otomatis.

    0m
    SpecName

    string

    Nama spesifikasi.

    ADB.MLLarge.2
    TargetResourceGroupName

    string

    Nama grup sumber daya tujuan.

    test
    MinGpuQuantity

    integer

    Jumlah minimum GPU.

    1
    MaxGpuQuantity

    integer

    Jumlah maksimum GPU.

    2
    RayConfig

    object

    Konfigurasi Ray.

    EnableUserEni

    boolean

    Indicates whether ENIs are enabled.

    HeadSpecType

    string

    The resource type of the head node.

    cpu
    HeadSpec

    string

    The specifications of the head node.

    ADB.MLLarge.2
    HeadAllocateUnit

    string

    The allocation unit of the head node.

    1
    HeadDiskCapacity

    string

    The disk size of the head node.

    100Gi
    Category

    string

    The type of the Ray cluster. Valid values:

    • BASIC: A basic cluster without high availability.

    • HIGH_AVAILABILITY: a high-availability cluster.

    BASIC
    WorkerGroups

    array<object>

    A list of Ray worker groups.

    object

    A Ray worker group.

    GroupName

    string

    The name of the Ray worker group.

    g01
    AllocateUnit

    string

    The allocation unit.

    1
    MaxWorkerQuantity

    integer

    The maximum number of workers.

    1
    MinWorkerQuantity

    integer

    The minimum number of workers.

    1
    WorkerDiskCapacity

    string

    The disk size of each worker.

    100G
    WorkerSpecName

    string

    The resource specifications of the worker.

    large
    WorkerSpecType

    string

    The resource type of the Ray worker.

    CPU
    RayClusterAddress

    string

    The address of the Ray cluster.

    http://ray-cluster-address.example.com
    RayDashboardAddress

    string

    The address of the Ray Dashboard.

    http://ray-dashboard-address.example.com
    RayGrafanaAddress

    string

    The address of Ray Grafana.

    http://ray-grafana-address.example.com
    AppConfig

    object

    The Ray application configuration.

    AppName

    string

    The name of the Ray application.

    app01
    AppType

    string

    The type of the Ray application.

    IsaacLab
    ImageSelector

    object

    The image configuration.

    Image

    string

    The image.

    lab2.10.0-ray2.43.0
    InferenceEngine

    string

    The inference engine.

    vLLM
    LlmModel

    string

    The LLM model.

    Deepseek-R1
    StorageMounts

    array<object>

    A list of mounted storage.

    object

    A mounted storage configuration.

    StorageId

    integer

    The storage ID.

    1
    MountPath

    string

    The mount path.

    /mnt/data01
    UserDefinedRequirements

    string

    GpuElasticPlan

    object

    Rencana elastis GPU.

    Enabled

    boolean

    Indicates whether the plan is enabled.

    false
    Rules

    array<object>

    A list of rules.

    object

    A rule.

    StartCronExpression

    string

    The start time of the scaling activity, specified as a Cron expression.

    0 0 2 * * ?
    EndCronExpression

    string

    The end time of the scaling activity, specified as a Cron expression. The time interval between the start time and end time must be at least one hour.

    0 0 3 * * ?
    ScalePolicy

    string

    Kebijakan penskalaan grup sumber daya. Nilai yang valid:

    • AutoScaling: Mengaktifkan kebijakan penskalaan otomatis.

    • Disable: Menonaktifkan kebijakan penskalaan otomatis.

    • MultiCluster: Mengaktifkan kebijakan penskalaan multi-klaster.

    AutoScaling
    Classification

    string

    Klasifikasi grup sumber daya. Nilai yang valid:

    • SQL

    • SparkSQL

    • MultiCluster

    • AI

    SQL
    EngineParams

    object

    Parameter mesin.

    any

    Parameter mesin.

    {\"spark.adb.version\":\"3.5\"}
    AtmConfig

    object

    InsertNodeSpec

    string

    8ACU
    InsertNodeNum

    string

    1
    SelectNodeSpec

    string

    8ACU
    SelectNodeNum

    string

    1
    SelectNodeCacheSize

    string

    10
    StorageNodeSpec

    string

    8ACU
    StorageNodeNum

    string

    2
    StorageNodeDiskSize

    string

    100
    StorageNodeDiskType

    string

    essd_pl1
    AuthNodeSpec

    string

    8ACU
    AuthNodeNum

    string

    2

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "A94B6C02-7BD4-5D67-9776-3AC8317E8DD3",
  "GroupsInfo": [
    {
      "GroupType": "Job",
      "GroupName": "test1",
      "MinComputeResource": "0ACU",
      "MaxComputeResource": "512ACU",
      "ClusterSizeResource": "Reserved parameter",
      "MinClusterCount": 0,
      "MaxClusterCount": 0,
      "RunningClusterCount": 0,
      "ClusterMode": "Reserved parameter",
      "ElasticMinComputeResource": "16ACU",
      "EnableSpot": "True",
      "GroupUsers": "testb,testc",
      "CreateTime": "2022-08-29T03:34:30Z",
      "UpdateTime": "2022-08-31T03:34:30Z",
      "Status": "ok",
      "Rules": [
        {
          "GroupName": "user_default",
          "QueryTime": "180000",
          "TargetGroupName": "job"
        }
      ],
      "Engine": "AnalyticDB",
      "Message": "SUCCESS",
      "AutoStopInterval": "0m",
      "SpecName": "ADB.MLLarge.2",
      "TargetResourceGroupName": "test",
      "MinGpuQuantity": 1,
      "MaxGpuQuantity": 2,
      "RayConfig": {
        "EnableUserEni": false,
        "HeadSpecType": "cpu",
        "HeadSpec": "ADB.MLLarge.2",
        "HeadAllocateUnit": "1",
        "HeadDiskCapacity": "100Gi",
        "Category": "BASIC",
        "WorkerGroups": [
          {
            "GroupName": "g01",
            "AllocateUnit": "1",
            "MaxWorkerQuantity": 1,
            "MinWorkerQuantity": 1,
            "WorkerDiskCapacity": "100G",
            "WorkerSpecName": "large",
            "WorkerSpecType": "CPU"
          }
        ],
        "RayClusterAddress": "http://ray-cluster-address.example.com",
        "RayDashboardAddress": "http://ray-dashboard-address.example.com",
        "RayGrafanaAddress": "http://ray-grafana-address.example.com",
        "AppConfig": {
          "AppName": "app01",
          "AppType": "IsaacLab",
          "ImageSelector": {
            "Image": "lab2.10.0-ray2.43.0",
            "InferenceEngine": "vLLM",
            "LlmModel": "Deepseek-R1"
          }
        },
        "StorageMounts": [
          {
            "StorageId": 1,
            "MountPath": "/mnt/data01"
          }
        ],
        "UserDefinedRequirements": ""
      },
      "GpuElasticPlan": {
        "Enabled": false,
        "Rules": [
          {
            "StartCronExpression": "0 0 2 * * ?",
            "EndCronExpression": "0 0 3 * * ?"
          }
        ]
      },
      "ScalePolicy": "AutoScaling",
      "Classification": "SQL",
      "EngineParams": {
        "key": "{\\\"spark.adb.version\\\":\\\"3.5\\\"}"
      },
      "AtmConfig": {
        "InsertNodeSpec": "8ACU",
        "InsertNodeNum": "1",
        "SelectNodeSpec": "8ACU",
        "SelectNodeNum": "1",
        "SelectNodeCacheSize": "10",
        "StorageNodeSpec": "8ACU",
        "StorageNodeNum": "2",
        "StorageNodeDiskSize": "100",
        "StorageNodeDiskType": "essd_pl1",
        "AuthNodeSpec": "8ACU",
        "AuthNodeNum": "2"
      }
    }
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidPoolName.Malformed The specified parameter PoolName is not valid.
    400 InvalidPoolUser.Malformed The specified parameter PoolUser is not valid.
    400 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records.
    400 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid.
    400 InvalidPoolType.Malformed The specified parameter PoolType is not valid.
    400 InvalidMinComputeResource.Malformed The specified parameter MinComputeResource is not valid.
    400 InvalidMaxComputeResource.Malformed The specified parameter MaxComputeResource is not valid.
    408 AcsServerTimeOut The request has failed due to Adb Cloud Service time out.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.