Gunakan DescribeEvents untuk kueri event ancaman pada disk-Elastic Compute Service-Alibaba Cloud - Elastic Compute Service

Mengkueri event ancaman untuk disk.

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:DescribeEvents

none

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah. Panggil DescribeRegions untuk mengkueri daftar wilayah yang mendukung Lensa EBS.	cn-hangzhou
EventName	string	No	Nama event. Nilai valid: NoSnapshot: Perlindungan data BurstIOTriggered: Burst IO CostOptimizationNeeded: Optimasi biaya DiskSpecNotMatchedWithInstance: Spesifikasi disk tidak cocok dengan tipe instans. DiskIONo4kAligned: Operasi baca/tulis tidak sejajar 4K. DiskIOHang: Terjadi event hang I/O pada disk. InstanceIOPSExceedInstanceMaxLimit: IOPS instans mencapai batas atas. InstanceBPSExceedInstanceMaxLimit: BPS instans mencapai batas atas. DiskIOPSExceedInstanceMaxLimit: IOPS disk mencapai batas atas instans. DiskBPSExceedInstanceMaxLimit: BPS disk mencapai batas atas instans. DiskIOPSExceedDiskMaxLimit: IOPS disk mencapai batas atas disk. DiskBPSExceedDiskMaxLimit: BPS disk mencapai batas atas disk.	DiskIOHang
ResourceId	string	No	ID Sumber daya.	d-bp67acfmxazb4p****
ResourceType	string	No	Tipe Sumber daya. Nilai valid: disk: disk.	disk
Status	string	No	Status event. Nilai valid: WillExecute: Tertunda Executing: Sedang berlangsung Executed: Diproses Ignore: Diabaikan Expired: Kedaluwarsa Deleted: Dihapus.	WillExecute
StartTime	string	No	Awal rentang pengatur waktu untuk dikueri. Tentukan pengatur waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Pengatur waktu harus dalam UTC.	2023-06-01T03:00:00Z
EndTime	string	No	Akhir rentang pengatur waktu untuk dikueri. Tentukan pengatur waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Pengatur waktu harus dalam UTC.	2023-06-01T04:00:00Z
MaxResults	integer	No	Jumlah maksimum entri yang dikembalikan pada setiap halaman. Jika Anda menetapkan parameter ini, Anda harus menggunakannya bersama parameter `NextToken` untuk melakukan kueri berhalaman. Nilai valid: 1 hingga 100. Nilai default: 10.	10
NextToken	string	No	Token kueri. Tetapkan ke nilai NextToken yang dikembalikan dari panggilan API sebelumnya.	AAAAAdDWBF2****
EventLevel	string	No	Level event. Nilai valid: INFO: Notifikasi WARN: Peringatan CRITICAL: Kritis.	WARN

Elemen respons

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	Id of the request	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalCount	integer	The total number of entries returned for the paged query.	1
NextToken	string	The token to use for the next query. If this parameter is empty, all results have been returned.	AAAAAdDWBF2****
ResourceEvents	array<object>	The list of events.
	object
EventType	string	The event type. Possible values: Notification SystemException Alert	Alert
EventName	string	The event name. Possible values: NoSnapshot: Data protection BurstIOTriggered: Burst IO CostOptimizationNeeded: Cost optimization DiskSpecNotMatchedWithInstance: The disk specifications do not match the instance type. DiskIONo4kAligned: Read/write operations are not 4K-aligned. DiskIOHang: An I/O hang event occurred on the disk. InstanceIOPSExceedInstanceMaxLimit: The IOPS of the instance reached the upper limit. InstanceBPSExceedInstanceMaxLimit: The BPS of the instance reached the upper limit. DiskIOPSExceedInstanceMaxLimit: The IOPS of the disk reached the upper limit of the instance. DiskBPSExceedInstanceMaxLimit: The BPS of the disk reached the upper limit of the instance. DiskIOPSExceedDiskMaxLimit: The IOPS of the disk reached the upper limit of the disk. DiskBPSExceedDiskMaxLimit: The BPS of the disk reached the upper limit of the disk.	DiskIOHang
ResourceId	string	The resource ID.	d-bp67acfmxazb4p****
ResourceType	string	The resource type.	disk
Status	string	The event status. Possible values: WillExecute: Pending Executing: In progress Executed: Processed Ignore: Ignored Expired: Expired Deleted: Deleted	WillExecute
StartTime	string	The start time of the event. This value is a UNIX timestamp in milliseconds.	1684204822000
Description	string	The event description.	可通过购买4296预配置IOPS以获得成本优化，根据您过往7天使用情况，预计成本可以下降16%。
RecommendAction	string	The recommended action after the event occurred. Possible values: ModifyDiskSpec: Upgrade or downgrade the disk. CreateSnapshot: Create a snapshot. ResizeDisk: Scale out the disk. AdjustProvision: Adjust the provisioned performance. ModifyInstanceSpec: Upgrade or downgrade the instance.	AdjustProvision
RecommendParams	string	The parameters for the recommended action.	4296
EventLevel	string	The event level. Possible values: INFO WARN CRITICAL	INFO
EndTime	string	The end time of the event. This value is a UNIX timestamp in milliseconds.	1679538083000
ExtraAttributes	string	The additional properties. Possible fields include the following: EcsInstanceId: The ID of the ECS instance to which the disk is attached. Adapter: The mount target of the disk.	{\"EcsInstanceId\":\"i-uf6dkn9qpcw6y94g7ag7\",\"Adapter\":\"hda\"}

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TotalCount": 1,
  "NextToken": "AAAAAdDWBF2****",
  "ResourceEvents": [
    {
      "EventType": "Alert",
      "EventName": "DiskIOHang",
      "ResourceId": "d-bp67acfmxazb4p****\n",
      "ResourceType": "disk",
      "Status": "WillExecute",
      "StartTime": "1684204822000",
      "Description": "可通过购买4296预配置IOPS以获得成本优化，根据您过往7天使用情况，预计成本可以下降16%。",
      "RecommendAction": "AdjustProvision",
      "RecommendParams": "4296",
      "EventLevel": "INFO",
      "EndTime": "1679538083000",
      "ExtraAttributes": "{\\\"EcsInstanceId\\\":\\\"i-uf6dkn9qpcw6y94g7ag7\\\",\\\"Adapter\\\":\\\"hda\\\"}"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message
400	App.NumberExceed	The number of apps exceeded.
400	DocumentConvertFailed.ExceedFileSizeLimit	The conversion has been failed, exceed file size limit.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.
400	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.
400	InvalidDiskSize.NotSupported	The specified parameter size is not valid.
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.EndTime	The specified parameter EndTime is earlier than StartTime.
400	InvalidParameter.Format	Specified parameter format is not valid.
400	InvalidParameter.TooManyDataQueried	Too many data queried.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	AliCroup2CloudUserCannotBuyNotInnerCommodity	There is no group cloud commodity label, and users within the group are not allowed to purchase.
403	Forbidden	User is not authorized to operate.
403	Forbidden.Action	User is not authorized to operate this action.
403	IncorrectDiskStatus.CreatingSnapshot	A previous snapshot creation is in process.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.