ModifyDiskSpec - - Centro de documentación de Alibaba Cloud

Cambia la categoría de un disco o modifique el nivel de rendimiento de una unidad SSD mejorada (ESSD).

Notas de uso

Tome en cuenta a continuación los siguientes puntos:

Para modificar el nivel de rendimiento de una ESSD, considere lo siguiente:
- En una ESSD de suscripción, solo es posible aumentar el nivel de rendimiento.
- En una ESSD pay-as-you-go, puede aumentar o reducir el nivel de rendimiento. Sin embargo, no se permite reducirlo a PL0.
- La ESSD debe encontrarse en el estado In Use (In_Use) o Unattached (Available).
- Si la ESSD está conectada a una instancia de Elastic Compute Service (ECS), dicha instancia debe estar en estado Running (Running) o Stopped (Stopped). La instancia no puede estar en estado Expired ni detenida por falta de pago.
- Si no logra aumentar el nivel de rendimiento debido al límite de capacidad, cambie el tamaño de la ESSD mediante la operación ResizeDisk y vuelva a intentarlo. Para más información, consulte ESSDs.
Para conocer los límites aplicables al cambio de categoría de un disco, consulte la sección "Límites" en Change the category of a disk.

La nueva categoría o el nuevo nivel de rendimiento del disco entra en vigor inmediatamente después de ejecutar la operación. Alibaba Cloud calcula la facturación con base en la nueva categoría y el nuevo nivel de rendimiento.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda ejecutar esta operación en OpenAPI Explorer. Esta herramienta genera de forma dinámica el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ModifyDiskSpec	Operación que desea ejecutar. Establezca el valor en ModifyDiskSpec.
DiskId	String	Sí	d-bp131n0q38u3a4zi****	ID del disco.
PerformanceLevel	String	No	PL2	Nuevo nivel de rendimiento de la ESSD. Valores válidos: PL0: una sola ESSD entrega hasta 10000 IOPS de lectura y escritura aleatorias. PL1: una sola ESSD entrega hasta 50000 IOPS de lectura y escritura aleatorias. PL2: una sola ESSD entrega hasta 100000 IOPS de lectura y escritura aleatorias. PL3: una sola ESSD entrega hasta 1000000 IOPS de lectura y escritura aleatorias. Valor predeterminado: PL1.
DiskCategory	String	No	cloud_essd	Nueva categoría del disco. Valores válidos: cloud_essd: ESSD cloud_auto: disco ESSD AutoPL cloud_ssd: SSD estándar cloud_efficiency: ultra disk Este parámetro está vacío de forma predeterminada, lo cual indica que no se cambia la categoría del disco. Nota Los valores anteriores se listan en orden descendente según el rendimiento del disco. Los discos de suscripción no admiten reducción de categoría.
DryRun	Boolean	No	false	Indica si se ejecuta únicamente una prueba sin procesar la solicitud real. Valores válidos: true: ejecuta solo una prueba. El sistema comprueba posibles problemas en la solicitud, como valores de parámetros faltantes, sintaxis incorrecta, límites del servicio o recursos insuficientes de Elastic Compute Service (ECS). Si la prueba falla, se devuelve un mensaje de error. Si la prueba se supera correctamente, se devuelve el código de error `DryRunOperation`. false: ejecuta la prueba y procesa la solicitud real. Si la prueba se supera correctamente, se devuelve un código de estado HTTP 2xx y se ejecuta la operación. Valor predeterminado: false.
ProvisionedIops	Long	No	50000	IOPS de lectura y escritura aprovisionadas del disco ESSD AutoPL. Valores válidos: de 0 a min{50,000, 1,000 × Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}. Nota Este parámetro solo está disponible cuando DiskCategory se establece en cloud_auto. Para más información, consulte ESSD AutoPL disks y Modify the performance configurations of an ESSD AutoPL disk.
PerformanceControlOptions.IOPS	Integer	No	2000	Nuevas IOPS del disco. Solo es posible modificar las IOPS de los discos ubicados en clústeres de block storage dedicados. Valores válidos: de 900 hasta el máximo de IOPS por disco (con incrementos de 100). Para más información, consulte Block storage performance.
PerformanceControlOptions.Throughput	Integer	No	200	Nuevo rendimiento (throughput) del disco. Solo es posible modificar el throughput de los discos ubicados en clústeres de block storage dedicados. Unidad: MB/s. Valores válidos: de 60 hasta el throughput máximo por disco. Para más información, consulte Block storage performance.
PerformanceControlOptions.Recover	String	No	All	Indica si se restablecen las IOPS y el throughput del disco. Este parámetro solo es válido cuando el disco se encuentra en un clúster de block storage dedicado. Cuando se especifica este parámetro, PerformanceControlOptions.IOPS y PerformanceControlOptions.Throughput no surten efecto. Establezca el valor en All para indicar que las IOPS y el throughput del disco se restablecen a sus valores iniciales.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la solicitud.
TaskId	String	t-bp67acfmxazb4p****	ID de la tarea de cambio de categoría del disco. Nota Si solo modifica el nivel de rendimiento de una ESSD, este parámetro no se devuelve.
OrderId	String	20413515388****	ID del pedido. Nota Este parámetro se devuelve únicamente cuando se modifica la categoría de un disco de suscripción o el nivel de rendimiento de una ESSD de suscripción.

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=ModifyDiskSpec
&ResourceOwnerId=123
&DiskId=d-bp131n0q38u3a4zi****
&PerformanceLevel=PL2
&DiskCategory=cloud_essd
&DryRun=false
&ProvisionedIops=50000
&<Common request parameters>

Respuestas correctas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDiskSpecResponse>
    <TaskId>t-bp67acfmxazb4p****</TaskId>
    <RequestId>5B38289D-88AB-42BD-B021-12FC6942F099</RequestId>
    <OrderId>20413515388****</TaskId>
</ModifyDiskSpecResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TaskId" : "t-bp67acfmxazb4p****",
  "RequestId" : "5B38289D-88AB-42BD-B021-12FC6942F099",
  "OrderId" : "20413515388****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidPerformanceLevel.Malformed	The specified parameter PerformanceLevel is not valid.	El valor de PerformanceLevel no es válido.
400	ProvisionedIopsForDiskCategoryUnsupported	The specified disk category does not support provisioned iops.	La categoría del disco no admite IOPS aprovisionadas.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	La capacidad de los discos de la categoría especificada supera el límite de cuota de la zona. Acceda a Quota Center para consultar y aumentar la cuota.
400	MalformedParameter.PerformanceControlOptions	Parameter invalid, %s.	El valor del parámetro no es válido.
400	InvalidPerformanceControlOptions.ModifyOperationUnsupported	The specified performance control options are conflicts with disk category or performance level or ProvisionIOPS.	Los parámetros con prefijo PerformanceControlOptions entran en conflicto con la categoría, el nivel de rendimiento o las IOPS aprovisionadas del disco.
400	InvalidOperation.InstanceRenewWithDowngradeInPlan	The operation is denied due to the specified instance has renew with downgrade record in plan.	Los pedidos de renovación y reducción de configuración aún no surten efecto. No es posible ejecutar esta operación antes de que dichos pedidos entren en vigor.
403	DiskInArrears	The specified operation is denied as your disk owing fee.	Existe un pago pendiente para el disco especificado.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	La instancia caducó o tiene pagos pendientes. Renueve la instancia o complete el pago y vuelva a intentarlo.
403	IncorrectDiskStatus	The current disk status does not support this operation.	No es posible ejecutar esta operación en el disco con su estado actual. Compruebe que el disco esté available y que no tenga pagos pendientes asociados.
403	DiskCreatingSnapshot	The operation is denied due to a snapshot of the specified disk is not completed yet.	Se está creando una instantánea para el disco especificado.
403	OperationDenied	The type of the disk does not support the operation.	La categoría del disco especificado no admite esta operación.
403	OperationDenied.PerformanceLevelNotMatch	The specified PerformanceLevel and disk size do not match.	El nivel de rendimiento especificado no corresponde al tamaño del disco.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	El tipo de instancia indicado en InstanceType no admite la categoría de disco de la instancia. Pruebe con otro tipo de instancia. Para conocer las categorías de disco compatibles con cada tipo de instancia, consulte la documentación de familias de instancias.
403	ModifyingDiskCategoryLimitExceed	The amount of modifying disk category exceeds the limit.	Se superó el número máximo de discos cuya configuración se está modificando en la región.
403	DiskInCoolingPeriod	There is a cooling period after the disk is successfully modified.	El disco se encuentra en un periodo de restricción tras un cambio de configuración. Durante este lapso no es posible modificarla nuevamente.
403	NoChangeInDiskCategoryAndPerformanceLevel	There is no change between the parameters transmitted and the current.	La categoría y el nivel de rendimiento especificados son iguales a los actuales del disco.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	Los recursos solicitados no están disponibles en la zona especificada. Pruebe con otro tipo de instancia o con otra zona. Llame a la operación DescribeZones para consultar los recursos disponibles.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	El disco con la función de montaje múltiple habilitada no admite esta operación.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.	La categoría de disco especificada no admite la operación.
403	InvalidPerformanceParameter.DiskNotInDedicatedStorageCluster	The specified disk not in dedicated storage cluster, can not modify performance control options.	Los discos fuera de clústeres de block storage dedicados no admiten parámetros con prefijo PerformanceControlOptions.
403	InvalidStatus.DiskUnderPerformanceControl	The specified disk is under performance control, any modifications to the category or performance level of the specified disk are unsupported..	No es posible modificar la categoría ni el nivel de rendimiento del disco cuando se especifican parámetros con prefijo PerformanceControlOptions.
403	InvalidStatus.DiskNotReady	This specified disk is not ready, status needs to be either In_use or Available.	El disco especificado debe encontrarse en estado In_use o Available.
404	InvalidDiskId.NotFound	The specified disk does not exist.	No se encontró el disco especificado. Compruebe que el ID del disco sea válido.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	No se encontró la instancia. Compruebe que el ID de la instancia sea correcto.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno. Vuelva a intentarlo más tarde.

Para consultar la lista de códigos de error, consulte Códigos de error del servicio.