DescribeEvents - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Consulta eventos de riesgo de discos en la nube.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ebs:DescribeEvents

none

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región. Puede llamar a DescribeRegions para consultar la lista de regiones admitidas por EBS Lens.	cn-hangzhou
EventName	string	No	El nombre del evento. Valores válidos: NoSnapshot: protección de datos BurstIOTriggered: I/O en ráfaga CostOptimizationNeeded: optimización de costos DiskSpecNotMatchedWithInstance: discrepancia entre especificaciones de instancia y disco DiskIONo4kAligned: lectura/escritura no alineada a 4K DiskIOHang: ocurrió un bloqueo de E/S del disco InstanceIOPSExceedInstanceMaxLimit: las IOPS de la instancia alcanzaron el límite superior InstanceBPSExceedInstanceMaxLimit: los BPS de la instancia alcanzaron el límite superior DiskIOPSExceedInstanceMaxLimit: las IOPS del disco alcanzaron el límite superior de la instancia DiskBPSExceedInstanceMaxLimit: los BPS del disco alcanzaron el límite superior de la instancia DiskIOPSExceedDiskMaxLimit: las IOPS del disco alcanzaron el límite superior del disco DiskBPSExceedDiskMaxLimit: los BPS del disco alcanzaron el límite superior del disco	DiskIOHang
ResourceId	string	No	El ID del recurso.	d-bp67acfmxazb4p****
ResourceType	string	No	El tipo de recurso. Valores válidos: disk: disco en la nube	disk
Status	string	No	El estado del evento. Valores válidos: WillExecute: pendiente Executing: en proceso Executed: procesado Ignore: ignorado Expired: caducado Deleted: eliminado	WillExecute
StartTime	string	No	La hora de inicio del evento. Especifique la hora en formato ISO 8601 con el patrón yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC.	2023-06-01T03:00:00Z
EndTime	string	No	La hora de finalización del evento. Especifique la hora en formato ISO 8601 con el patrón yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC.	2023-06-01T04:00:00Z
MaxResults	integer	No	El número máximo de entradas por página para una consulta paginada. Si especifica este parámetro, los parámetros MaxResults y NextToken se utilizan conjuntamente para la consulta. Valores válidos: de 1 a 100. Valor predeterminado: 10.	10
NextToken	string	No	El token de paginación. Establezca este parámetro en el valor NextToken devuelto en la llamada a la API anterior.	AAAAAdDWBF2****
EventLevel	string	No	El nivel del evento. Valores válidos: INFO: Notificación. WARN: Advertencia. CRITICAL: Crítico.	WARN

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de respuesta.
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalCount	integer	El número total de entradas devueltas para la consulta paginada.	1
NextToken	string	El token para la siguiente consulta. Si NextToken está vacío, no existen más resultados.	AAAAAdDWBF2****
ResourceEvents	array<object>	La lista de eventos.
	object
EventType	string	El tipo de evento. Valores válidos: Notification SystemException Alert	Alert
EventName	string	El nombre del evento. Valores válidos: NoSnapshot: protección de datos BurstIOTriggered: I/O en ráfaga CostOptimizationNeeded: optimización de costos DiskSpecNotMatchedWithInstance: discrepancia entre especificaciones de instancia y disco DiskIONo4kAligned: lectura/escritura no alineada a 4K DiskIOHang: ocurrió un bloqueo de E/S del disco InstanceIOPSExceedInstanceMaxLimit: las IOPS de la instancia alcanzaron el límite superior InstanceBPSExceedInstanceMaxLimit: los BPS de la instancia alcanzaron el límite superior DiskIOPSExceedInstanceMaxLimit: las IOPS del disco alcanzaron el límite superior de la instancia DiskBPSExceedInstanceMaxLimit: los BPS del disco alcanzaron el límite superior de la instancia DiskIOPSExceedDiskMaxLimit: las IOPS del disco alcanzaron el límite superior del disco DiskBPSExceedDiskMaxLimit: los BPS del disco alcanzaron el límite superior del disco	DiskIOHang
ResourceId	string	El ID del recurso.	d-bp67acfmxazb4p****
ResourceType	string	El tipo de recurso.	disk
Status	string	El estado del evento. Valores válidos: WillExecute: pendiente Executing: en proceso Executed: procesado Ignore: ignorado Expired: caducado Deleted: eliminado	WillExecute
StartTime	string	La hora de inicio del evento. Este valor es una marca de tiempo en milisegundos.	1684204822000
Description	string	La descripción del evento.	Puede adquirir 4296 IOPS aprovisionadas para la optimización de costos. Según su uso durante los últimos 7 días, se estima que los costos disminuirán en un 16%
RecommendAction	string	La acción recomendada después de que ocurre el evento. Valores válidos: ModifyDiskSpec: cambiar especificaciones del disco CreateSnapshot: crear una instantánea ResizeDisk: ampliar la capacidad del disco AdjustProvision: ajustar el rendimiento aprovisionado ModifyInstanceSpec: cambiar especificaciones de la instancia	AdjustProvision
RecommendParams	string	Los parámetros para la acción recomendada después de que ocurre el evento.	4296
EventLevel	string	El nivel del evento. Valores válidos: INFO WARN CRITICAL	INFO
EndTime	string	La hora de finalización del evento. Este valor es una marca de tiempo en milisegundos.	1679538083000
ExtraAttributes	string	Las propiedades adicionales. Campos posibles: EcsInstanceId: el ID de la instancia de ECS a la que está conectado el disco en la nube. Adapter: el punto de montaje del disco en la nube.	{\"EcsInstanceId\":\"i-uf6dkn9qpcw6y94g7ag7\",\"Adapter\":\"hda\"}

Ejemplos

Respuesta exitosa

JSON Formato

{
  "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": "You can purchase 4296 provisioned IOPS for cost optimization. Based on your usage over the past 7 days, costs are estimated to decrease by 16%",
      "RecommendAction": "AdjustProvision",
      "RecommendParams": "4296",
      "EventLevel": "INFO",
      "EndTime": "1679538083000",
      "ExtraAttributes": "{\\\"EcsInstanceId\\\":\\\"i-uf6dkn9qpcw6y94g7ag7\\\",\\\"Adapter\\\":\\\"hda\\\"}"
    }
  ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	App.NumberExceed	The number of apps exceeded.
400	DocumentConvertFailed.ExceedFileSizeLimit	The conversion has been failed, exceed file size limit.	english description1
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.
400	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	The request and a previous request contains the same client token but different parameters.
400	InvalidDiskSize.NotSupported	The specified parameter size is not valid.
400	InvalidParameter	The parameter %s is invalid.	The specified parameter value 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.	english description
400	InvalidParameter.TooManyDataQueried	Too many data queried.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred.
403	AliCroup2CloudUserCannotBuyNotInnerCommodity	There is no group cloud commodity label, and users within the group are not allowed to purchase.	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.	You are not authorized to manage the resource. Check the account permissions or contact the Alibaba Cloud account.
403	Forbidden.Action	User is not authorized to operate this action.	You are not authorized to perform this operation. Check the account permissions or contact the Alibaba Cloud account.
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.	The specified resource does not exist.
504	RequestTimeout	The request is timeout, please try again later.	The request has timed out. Try again later.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.