Gunakan DescribeLensMonitorDisks API untuk kueri informasi disk-Elastic Compute Service-Alibaba Cloud - Elastic Compute Service

Mengkueri informasi tentang satu atau beberapa disk Elastic Block Storage (EBS) Anda.

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

ebs:DescribeLensMonitorDisks

list

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah yang mendukung Lensa EBS.	cn-hangzhou
DiskIds	array	No	Daftar ID disk.	['d-1', 'd-2']
	string	No	The disk ID.	d-cd40hxfu0v*****
DiskCategory	string	No	Kategori disk. Nilai valid: cloud: disk dasar. cloud_efficiency: disk ultra. cloud_ssd: SSD standar. cloud_essd: SSD Enhanced (ESSD). cloud_auto: disk ESSD AutoPL. cloud_essd_entry: disk ESSD Entry.	cloud_auto
LensTags	array	No	Daftar tag event. Parameter ini digunakan untuk memfilter disk yang mengalami jenis event tertentu dalam 24 jam terakhir. Nilai valid: NoSnapshot: perlindungan data BurstIOTriggered: burst I/O CostOptimizationNeeded: optimasi biaya DiskSpecNotMatchedWithInstance: Spesifikasi disk tidak cocok dengan tipe instans. DiskIONo4kAligned: baca/tulis tidak sejajar 4K DiskIOHang: Terjadi I/O hang pada disk. InstanceIOPSExceedInstanceMaxLimit: IOPS instans telah mencapai batas atasnya. InstanceBPSExceedInstanceMaxLimit: BPS instans telah mencapai batas atasnya. DiskIOPSExceedInstanceMaxLimit: IOPS disk telah mencapai batas atas instans. DiskBPSExceedInstanceMaxLimit: BPS disk telah mencapai batas atas instans. DiskIOPSExceedDiskMaxLimit: IOPS disk telah mencapai batas atasnya. DiskBPSExceedDiskMaxLimit: BPS disk telah mencapai batas atasnya.
	string	No	The event tag of the disk.	NoSnapshot
NextToken	string	No	Token yang digunakan untuk memulai kueri berikutnya. Atur parameter ini ke nilai NextToken yang dikembalikan dari pemanggilan operasi ini sebelumnya.	caeba0bbb2be03f84eb48b699f0a****
MaxResults	integer	No	Jumlah entri per halaman. Nilai maksimum: 100. Nilai default: Jika Anda mengatur parameter ini ke nilai lebih besar dari 100, nilai defaultnya adalah 100.	10
DiskIdPattern	string	No	Ekspresi reguler untuk memfilter ID disk dalam kueri fuzzy.	d-cd40hxfu0v*

Elemen respons

Element	Type	Description	Example
	object	DescribeLensMonitorDisksResponse
DiskInfos	array<object>	The list of disk information.
	array<object>	The disk information.
DiskId	string	The disk ID.	d-cd401****
DiskName	string	The disk name.	disk-28c6b****
DiskType	string	The type of the disk. Valid values: system: system disk. data: data disk.	system
DiskStatus	string	The status of the disk. Valid values: Available: in use. Deleted: deleted.	Available
RegionId	string	The region ID.	cn-hangzhou
DiskCategory	string	The category of the disk. Valid values: cloud: basic disk. cloud_efficiency: ultra disk. cloud_ssd: standard SSD. cloud_essd: ESSD. cloud_auto: ESSD AutoPL disk. cloud_essd_entry: ESSD Entry disk.	cloud_essd
PerformanceLevel	string	The performance level of the ESSD. Valid values: PL0: A maximum of 10,000 random read/write IOPS per disk. PL1: A maximum of 50,000 random read/write IOPS per disk. PL2: A maximum of 100,000 random read/write IOPS per disk. PL3: A maximum of 1,000,000 random read/write IOPS per disk.	PL0
Tags	array<object>	The collection of tags for the disk.
	object	The tag of the disk.
TagValue	string	The tag value.	user
TagKey	string	The tag key.	tag1
ZoneId	string	The ID of the zone to which the disk belongs.	cn-hangzhou-j
Size	integer	The size of the disk, in GiB.	64
Iops	integer	The maximum number of input/output operations per second (IOPS).	4000
Bps	integer	The maximum throughput. Unit: MB/s.	300
ProvisionedIops	integer	The provisioned read/write IOPS of the ESSD AutoPL disk. Valid values: 0 to min{50000, 1000 * capacity - baseline performance}. Baseline performance = min{1,800 + 50 * capacity, 50,000}. This parameter is returned only when `DiskCategory` is set to `cloud_auto`. For more information, see ESSD AutoPL disks.	4000
BurstingEnabled	boolean	Indicates whether the performance burst feature is enabled. Valid values: true: Yes. false: No. This parameter is returned only when `DiskCategory` is set to `cloud_auto`. For more information, see ESSD AutoPL disks.	true
LensTags	array	A collection of event tags for the disk. The event tags indicate the events that occurred on the disk in the last 24 hours. The data may have a delay of up to 1 hour.
	string	The event tag of the disk.	["NoSnapshot", "DiskIOHang"]
SharingEnabled	string	Indicates whether the disk is a shared disk.	true
NextToken	string	The token to use to retrieve the next page of results. This value is not returned when there are no more results to return.	caeba0bbb2be03f84eb48b699f0a****
TotalCount	integer	The total number of entries.	6
RequestId	string	The ID of the request. This ID is returned for every request, regardless of the result.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Contoh

Respons sukses

JSONformat

{
  "DiskInfos": [
    {
      "DiskId": "d-cd401****",
      "DiskName": "disk-28c6b****",
      "DiskType": "system",
      "DiskStatus": "Available",
      "RegionId": "cn-hangzhou",
      "DiskCategory": "cloud_essd",
      "PerformanceLevel": "PL0",
      "Tags": [
        {
          "TagValue": "user",
          "TagKey": "tag1"
        }
      ],
      "ZoneId": "cn-hangzhou-j",
      "Size": 64,
      "Iops": 4000,
      "Bps": 300,
      "ProvisionedIops": 4000,
      "BurstingEnabled": true,
      "LensTags": [
        "[\"NoSnapshot\", \"DiskIOHang\"]"
      ],
      "SharingEnabled": "true"
    }
  ],
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "TotalCount": 6,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidParameter	The parameter %s is invalid.
400	InvalidParameter.Conflict	The specified parameter %s and %s are not blank at the same time.
400	InvalidParameter.Format	Specified parameter format is not valid.
400	MissingParameter	The input parameter %s that is mandatory for processing this request is not supplied.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	Forbidden	User is not authorized to operate.
403	Forbidden.Action	User is not authorized to operate this action.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	LastTokenProcessing	The last token request is processing.
403	NoPermission.SLR	The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS.
403	OperationDenied	The operation is not allowed.
404	InvalidApi.NotFound	Specified api is not found, please check your url and method.
404	NoSuchResource	The specified resource does not exist.
504	RequestTimeout	The request is timeout, please try again later.
429	BLOCK.LimitedRequest	Request was denied due to user flow control.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.