DescribeClusterResources - Container Service for Kubernetes

Saat Anda menggunakan Container Service for Kubernetes (ACK), Anda juga menggunakan Sumber daya dari layanan Alibaba Cloud terkait lainnya. Anda dapat memanggil operasi DescribeClusterResources untuk mengkueri Sumber daya terkait kluster tertentu, seperti Sumber daya VPC dan SLB. Untuk mengkueri Sumber daya kelompok node atau node, panggil operasi DescribeClusterNodePools atau DescribeClusterNodes.

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

cs:DescribeClusterResources

get

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

None

Sintaks permintaan

GET /clusters/{ClusterId}/resources HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
ClusterId	string	Yes	ID kluster. Untuk informasi tentang cara Tampilan ID kluster, lihat View cluster information. Anda juga dapat memanggil operasi API DescribeClustersV1 untuk Tampilan informasi semua kluster yang dibuat di bawah akun Alibaba Cloud Anda.	cb95aa626a47740afbf6aa099b65****

Parameter permintaan

Parameter	Type	Required	Description	Example
with_addon_resources	boolean	No	Apakah akan mengkueri Sumber daya yang dibuat oleh komponen kluster. true: Mengkueri Sumber daya. false: Tidak mengkueri Sumber daya.	false

Elemen respons

Element	Type	Description	Example
	array	Daftar objek Sumber daya.
	array<object>	资源详情。
cluster_id	string	集群 ID。	cb95aa626a47740afbf6aa099b65****
created	string	资源创建时间。	2023-08-15T14:34:42+08:00
instance_id	string	资源 ID。	ngw-wz9sphwk42sdtjixo****
resource_info	string	资源信息。关于资源的源信息，请参见 ListStackResources 。	{\"Id\":\"KubernetesWorkerRole\",\"Name\":\"KubernetesWorkerRole\",\"Type\":\"ALIYUN::RAM::Role\",\"Status\":\"CREATE_COMPLETE\",\"StatusReason\":\"state changed\",\"Updated\":\"2025-04-10T06:21:17\",\"PhysicalId\":\"KubernetesWorkerRole-7e611193-225f-40f6-bc3c-ea8633******\"}
resource_type	string	资源类型。	ALIYUN::VPC::NatGateway
state	string	资源状态。可选值： `CREATE_COMPLETE`：成功创建资源。 `CREATE_FAILED`：创建资源失败。 `CREATE_IN_PROGRESS`：创建资源中。 `DELETE_FAILED`：删除资源失败。 `DELETE_IN_PROGRESS`：删除资源中。 `ROLLBACK_COMPLETE`：成功回滚。 `ROLLBACK_FAILED`：回滚失败。 `ROLLBACK_IN_PROGRESS`：回滚中。	CREATE_COMPLETE
auto_create	integer	资源是否由 ACK 创建： 1：表示由 ACK 创建。 0：表示该资源为已有资源。	1
dependencies	array<object>	依赖资源列表。
	object	依赖资源详情。
cluster_id	string	依赖资源的集群 ID。	cc5ee03f63e43425cb6f71f1a1756****
resource_type	string	依赖资源类型。	ALIYUN::VPC::NatGateway
instance_id	string	依赖资源实例 ID。	ngw-wz9sphwk42sdtjixo****
associated_object	object	资源关联的 k8s 对象。
kind	string	k8s 对象类型。	Service
namespace	string	k8s 对象命名空间。	kube-system
name	string	k8s 对象名称。	nginx-ingress-lb
delete_behavior	object	删除集群时该资源的删除行为。
delete_by_default	boolean	删除集群时是否默认删除该资源。 true：默认删除该资源。 fasle：不删除该资源。	false
changeable	boolean	`delete_by_default`的默认行为是否可以更改。 true：可以更改。 false：不支持更改。	false
creator_type	string	该资源创建者的类型。可能的取值： user：由用户自行创建； system：由 ACK 管控系统创建； addon：由集群组件创建。	addon
extra_info	object	资源的其他信息。	{ "type": "SLS_Data" }

Contoh

Respons sukses

JSONformat

[
  {
    "cluster_id": "cb95aa626a47740afbf6aa099b65****",
    "created": "2023-08-15T14:34:42+08:00",
    "instance_id": "ngw-wz9sphwk42sdtjixo****",
    "resource_info": "{\\\"Id\\\":\\\"KubernetesWorkerRole\\\",\\\"Name\\\":\\\"KubernetesWorkerRole\\\",\\\"Type\\\":\\\"ALIYUN::RAM::Role\\\",\\\"Status\\\":\\\"CREATE_COMPLETE\\\",\\\"StatusReason\\\":\\\"state changed\\\",\\\"Updated\\\":\\\"2025-04-10T06:21:17\\\",\\\"PhysicalId\\\":\\\"KubernetesWorkerRole-7e611193-225f-40f6-bc3c-ea8633******\\\"}",
    "resource_type": "ALIYUN::VPC::NatGateway",
    "state": "CREATE_COMPLETE",
    "auto_create": 1,
    "dependencies": [
      {
        "cluster_id": "cc5ee03f63e43425cb6f71f1a1756****",
        "resource_type": "ALIYUN::VPC::NatGateway",
        "instance_id": "ngw-wz9sphwk42sdtjixo****"
      }
    ],
    "associated_object": {
      "kind": "Service",
      "namespace": "kube-system",
      "name": "nginx-ingress-lb"
    },
    "delete_behavior": {
      "delete_by_default": false,
      "changeable": false
    },
    "creator_type": "addon",
    "extra_info": {
      "type": "SLS_Data"
    }
  }
]

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.