DescribeDisksFullStatus - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri informasi status lengkap satu atau beberapa perangkat penyimpanan blok.

Deskripsi operasi

Informasi status lengkap perangkat penyimpanan blok mencakup status siklus hidup penyimpanan blok (Status), status kesehatan penyimpanan blok (HealthStatus), dan tipe event penyimpanan blok (EventType).
Karena waktu publikasi, waktu eksekusi terjadwal, dan waktu eksekusi aktual event terkait penyimpanan blok adalah sama, Anda dapat menentukan rentang waktu (EventTime.Start hingga EventTime.End) untuk mengkueri semua event historis yang terjadi selama periode tersebut. Anda dapat mengkueri event historis maksimal dari tujuh hari terakhir.

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

ecs:DescribeDisksFullStatus

list

Disk.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

Disk.

acs:ecs:{#regionId}:{#accountId}:disk/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah perangkat penyimpanan blok. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
Status	string	No	Status siklus hidup perangkat penyimpanan blok. Untuk informasi selengkapnya, lihat Status disk. Nilai valid: In_use: sedang digunakan. Available: akan dilampirkan. Attaching: sedang dilampirkan. Detaching: sedang dilepas. Creating: sedang dibuat. ReIniting: sedang diinisialisasi.	Available
HealthStatus	string	No	Status kesehatan perangkat penyimpanan blok. Nilai valid: Impaired: sementara tidak dapat dibaca dan ditulis. Warning: layanan menurun. Initializing: sedang diinisialisasi. InsufficientData: data tidak mencukupi. NotApplicable: tidak berlaku.	Warning
EventType	string	No	Tipe event perangkat penyimpanan blok. Nilai valid: Degraded: Performa penyimpanan blok menurun. SeverelyDegraded: Performa penyimpanan blok menurun secara signifikan. Stalled: Performa penyimpanan blok terpengaruh secara signifikan. ErrorDetected: Disk lokal rusak.	Stalled
EventTime.Start	string	No	Awal rentang waktu untuk mengkueri event. Tentukan waktu dalam standar ISO 8601 dengan format `yyyy-MM-ddTHH:mm:ssZ`. Waktu harus dalam UTC.	2018-05-06T02:43:10Z
EventTime.End	string	No	Akhir rentang waktu untuk mengkueri event. Tentukan waktu dalam standar ISO 8601 dengan format `yyyy-MM-ddTHH:mm:ssZ`. Waktu harus dalam UTC.	2018-05-08T02:48:52Z
PageNumber	integer	No	Nomor halaman hasil kueri. Nilai valid: bilangan bulat positif. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman. Nilai valid: 1 hingga 100. Nilai default: 10.	10
DiskId	array	No	ID penyimpanan blok. Nilai valid N: 1 hingga 100.	d-bp67acfmxazb4p****
	string	No	ID penyimpanan blok. Nilai valid N: 1 hingga 100.	d-bp67acfmxazb4p****
EventId	array	No	ID event. Nilai valid N: 1 hingga 100.	e-bp67acfmxazb4p****
	string	No	ID event. Nilai valid N: 1 hingga 100.	e-bp67acfmxazb4p****
ResourceGroupId	string	No	ID kelompok sumber daya tempat resource penyimpanan blok berada. Saat Anda menggunakan parameter ini untuk memfilter resource, jumlah resource tidak boleh melebihi 1.000.	rg-aek2kkmhmhs****
Tag	array<object>	No	Tag.
	object	No	Tag.
Key	string	No	Kunci tag yang dilampirkan pada sumber daya penyimpanan blok. N menunjukkan bahwa Anda dapat menetapkan satu atau beberapa kunci tag. Nilai N pada parameter ini sesuai dengan nilai N pada parameter `Tag.N.Value` untuk membentuk pasangan kunci-nilai. Nilai valid N: 1 hingga 20. Jika Anda menggunakan satu tag untuk memfilter sumber daya, jumlah sumber daya dengan tag tersebut tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter sumber daya, jumlah sumber daya yang dilampirkan pada semua tag yang ditentukan tidak boleh melebihi 1.000.	TestKey
Value	string	No	Nilai tag yang dilampirkan pada sumber daya penyimpanan blok. N menunjukkan bahwa Anda dapat menetapkan satu atau beberapa nilai tag. Nilai N pada parameter ini sesuai dengan nilai N pada parameter `Tag.N.Key` untuk membentuk pasangan kunci-nilai. Nilai valid N: 1 hingga 20.	TestValue

Elemen respons

Element	Type	Description	Example
	object
PageSize	integer	Jumlah entri per halaman.	10
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PageNumber	integer	Nomor halaman.	1
TotalCount	integer	Jumlah total entri status lengkap.	2
DiskFullStatusSet	object
DiskFullStatusType	array<object>	Array entri status lengkap penyimpanan blok.
	array<object>
DiskId	string	ID penyimpanan blok.	d-bp67acfmxazb4p****
InstanceId	string	ID instans.	i-bp67acfmxazb4p****
Device	string	Nama perangkat penyimpanan blok yang dilampirkan pada instans, misalnya /dev/xvdb. Parameter ini hanya memiliki nilai saat parameter `Status` diatur ke `In_use`. Nilainya kosong untuk status lainnya. Catatan Parameter ini akan didepresiasi. Untuk meningkatkan kompatibilitas kode, jangan gunakan parameter ini.	null
DiskEventSet	object
DiskEventType	array<object>	Array event penyimpanan blok.
	array<object>
EventId	string	ID event penyimpanan blok.	e-bp67acfmxazb4p****
EventEndTime	string	Waktu saat event berakhir. Waktu ditampilkan dalam UTC dengan format ISO 8601.	2018-05-06T02:48:52Z
EventTime	string	Waktu saat event terjadi. Waktu ditampilkan dalam UTC dengan format ISO 8601.	2018-05-08T02:43:10Z
ImpactLevel	string	Tingkat dampak.	100
EventType	object	Tipe event.
Name	string	Nama tipe event. Nilai valid: Degraded: Performa penyimpanan blok menurun. SeverelyDegraded: Performa penyimpanan blok menurun secara signifikan. Stalled: Performa penyimpanan blok terpengaruh secara signifikan. ErrorDetected: Disk lokal rusak.	Stalled
Code	integer	Kode tipe event.	7
Status	object	Status siklus hidup perangkat penyimpanan blok.
Name	string	Nama status siklus hidup penyimpanan blok.	Available
Code	integer	Kode status siklus hidup penyimpanan blok.	129
HealthStatus	object	Status kesehatan perangkat penyimpanan blok.
Name	string	Nama status kesehatan penyimpanan blok.	Impaired
Code	integer	Kode status kesehatan penyimpanan blok.	128

Contoh

Respons sukses

JSONformat

{
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "TotalCount": 2,
  "DiskFullStatusSet": {
    "DiskFullStatusType": [
      {
        "DiskId": "d-bp67acfmxazb4p****",
        "InstanceId": "i-bp67acfmxazb4p****",
        "Device": "null",
        "DiskEventSet": {
          "DiskEventType": [
            {
              "EventId": "e-bp67acfmxazb4p****",
              "EventEndTime": "2018-05-06T02:48:52Z",
              "EventTime": "2018-05-08T02:43:10Z",
              "ImpactLevel": "100",
              "EventType": {
                "Name": "Stalled",
                "Code": 7
              }
            }
          ]
        },
        "Status": {
          "Name": "Available",
          "Code": 129
        },
        "HealthStatus": {
          "Name": "Impaired",
          "Code": 128
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
403	InvalidParameter	%s
403	DiskIdLimitExceeded	%s	Jumlah nilai DiskId yang ditentukan tidak boleh melebihi 100.
403	EventIdLimitExceeded	%s
403	InvalidParameter.TimeEndBeforeStart	%s	Parameter yang ditentukan tidak valid. Periksa apakah waktu akhir lebih awal daripada waktu mulai.
403	OperationDenied.NotInWhiteList	%s	Operasi ini tidak valid. Tambahkan akun Anda ke daftar putih terlebih dahulu.
403	TooManyDiskEvent.DiskIdRequired	%s	Terlalu banyak permintaan dibuat untuk ID resource ini. Coba lagi nanti.
404	MissingParameter	%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.