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

Amplía la capacidad de un disco, incluidos los discos del sistema y los discos de datos.

Descripción de la operación

Nota

Antes de ampliar un disco, consulte el formato de partición del disco. Si el disco utiliza el formato de partición MBR, no puede ampliarlo a más de 2 TiB. De lo contrario, podría producirse una pérdida de datos. Para ampliar un disco con particiones MBR, cree y conecte un nuevo disco de datos que utilice el formato de tabla de particiones GUID (GPT) y, a continuación, copie los datos existentes en el nuevo disco de datos. Para obtener más información, consulte Ampliar un disco.

Los tipos de disco admitidos incluyen discos básicos (cloud), discos ultra (cloud_efficiency), SSD estándar (cloud_ssd), SSD empresariales (cloud_essd), discos ESSD AutoPL (cloud_auto), discos efímeros elásticos - Estándar (elastic_ephemeral_disk_standard), discos efímeros elásticos - Premium (elastic_ephemeral_disk_premium) y ESSD regionales (cloud_regional_disk_auto).
No se pueden ampliar los discos para los que se están creando instantáneas. Espere a que finalice la creación de la instantánea antes de ampliar el disco.
Esta operación no amplía las particiones ni los sistemas de archivos. Después de ampliar la capacidad del disco, debe asignar manualmente las particiones y los sistemas de archivos. Para obtener más información, consulte Ampliar particiones y sistemas de archivos (Linux) y Ampliar particiones y sistemas de archivos (Windows).
Los discos con la función de conexión múltiple habilitada admiten la ampliación tanto en línea como sin conexión. Asegúrese de que las instancias a las que está conectado el disco cumplan con los siguientes requisitos:
- Para la ampliación en línea, el estado de la instancia debe ser En ejecución (Running).
- Para la ampliación sin conexión, el estado de la instancia debe ser En ejecución (Running) o Detenida (Stopped).
Asegúrese de que el disco cumpla con los siguientes requisitos:
- El disco se encuentra en estado En uso (In Use) o Disponible (Available).
- (Altamente recomendado) Se ha creado una instantánea del disco para realizar una copia de seguridad de los datos. Para obtener más información, consulte Crear una instantánea.
- Si el disco de datos se ha adquirido recientemente, inicialice el disco antes de ampliarlo. Para obtener más información, consulte Descripción general de la inicialización.

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

ecs:ResizeDisk

update

*Disk.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DiskId	string	Sí	El ID del disco. Puede llamar a DescribeDisks para consultar los ID de los discos.	d-bp67acfmxazb4p****
Type	string	No	El método utilizado para ampliar el disco. Valores válidos: offline (valor predeterminado): ampliación sin conexión. Después de la ampliación, debe reiniciar la instancia en la consola siguiendo las instrucciones en Reiniciar una instancia o llamando a la operación RebootInstance para que los cambios surtan efecto. online: ampliación en línea. La ampliación surte efecto sin reiniciar la instancia. Los tipos de disco admitidos incluyen discos ultra, SSD estándar, SSD empresariales y discos efímeros elásticos.	offline
NewSize	integer	Sí	La nueva capacidad a la que desea ampliar el disco. Unidad: GiB. Valores válidos: Disco del sistema: Disco básico: 20 a 500. SSD empresarial: PL0: 1 a 2048. PL1: 20 a 2048. PL2: 461 a 2048. PL3: 1261 a 2048. Disco ESSD AutoPL: 1 a 2048. Otros tipos de disco: 20 a 2048. Disco de datos: Disco ultra (cloud_efficiency): 20 a 32,768. SSD estándar (cloud_ssd): 20 a 32,768. SSD empresarial (cloud_essd): Los valores válidos dependen del valor de `PerformanceLevel`. Puede llamar a DescribeDisks para consultar la información del disco y verificar el parámetro `PerformanceLevel` en la respuesta. PL0: 1 a 65,536. PL1: 20 a 65,536. PL2: 461 a 65,536. PL3: 1261 a 65,536. Disco básico (cloud): 5 a 2,000. Disco ESSD AutoPL (cloud_auto): 1 a 65,536. Disco efímero elástico - Estándar (elastic_ephemeral_disk_standard): 64 a 8,192. Disco efímero elástico - Premium (elastic_ephemeral_disk_premium): 64 a 8,192. Nota La nueva capacidad del disco especificada debe ser mayor que la capacidad original del disco. De lo contrario, se devuelve un error.	1900
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero asegúrese de que el token sea único entre las diferentes solicitudes. El valor de ClientToken solo puede contener caracteres ASCII y no puede superar los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	123e4567-e89b-12d3-a456-426655440000

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
OrderId	string	El ID del pedido. Nota Solo se devuelve un ID de pedido cuando se amplía un disco de suscripción.	20413515388****
RequestId	string	El ID de la solicitud.	F3CD6886-D8D0-4FEE-B93E-1B732396****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "OrderId": "20413515388****",
  "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B732396****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidDataDiskSize.ValueNotSupported	The specified DataDisk.n.Size is beyond the permitted range; or the capacity of the snapshot exceeds the size limit of the specified disk category.
400	InvalidParameter.Conflict	%s	Los parámetros entran en conflicto entre sí.
400	IncompleteParamter	Some fields can not be null in this request.	Falta un parámetro obligatorio en la solicitud.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	InvalidParam.Type	The specified type is not supported.	El parámetro Type especificado no es válido.
400	LastOrderProcessing	The previous order is still processing. Please try again later.	El pedido se está procesando. Inténtelo de nuevo más tarde.
400	InvalidStatus.Upgrading	The instance which the disk attachs is upgrading; please try again later.
400	InvalidSystemDiskSize.ImageNotSupportResize	The image of the instance does not support resize.
400	InvalidDisk.DetachedSystemDisk	The specified disk is a detached system disk. This operation is not supported.
400	OperationDenied.NotEnoughCapacity	The capacity of the current dedicated block storage cluster is not enough to expand.
400	IncorrectDiskStatus.ReplicationStatusNotFound	Disk replication status not found.
400	IncorrectDiskStatus.InReplication	Disk already in replication.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	La capacidad utilizada del tipo de disco especificado excede el límite de cuota de la zona activa. Vaya al Centro de cuotas para consultar y solicitar un aumento de la cuota de capacidad de disco.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account or set the parameter AutoPay to true.
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.	Esta cuenta no tiene permiso para realizar un reembolso. La cuenta principal debe otorgar los permisos relacionados con reembolsos.
400	InvalidOperation.InstanceRenewWithDowngradeInPlan	The operation is denied due to the specified instance has renew with downgrade record in plan.	Existe una orden de renovación y reducción sin procesar. Esta operación no está permitida antes de que la orden entre en vigor.
400	InvalidSystemDiskSize.ValueNotSupported	The specified system disk size is invalid.	El parámetro SystemDisk.Size especificado no es válido.
400	OperationDenied.UnfinishedOrder	The current instance has an unfinished refund order. This operation is denied.
400	AccountForbidden.CreateOrder	Order cannot be created due to abnormal account.	La cuenta actual no tiene permiso para crear órdenes.
400	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
500	InternalError	The request processing has failed due to some unknown error.
403	InvalidDataDiskSize.ValueNotSupported	The specified DataDisk.n.Size is beyond the permitted range; or the capacity of the snapshot exceeds the size limit of the specified disk category.
403	OperationDenied	The type of the disk does not support the operation.	La instantánea especificada no permite la creación de volúmenes de datos.
403	InvalidDiskSize.TooSmall	Specified new disk size is less than the original disk size.
403	InvalidDiskSize.TooLarge	Specified new disk size is beyond the permitted range.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	DiskError	Incorrect disk status.
403	DiskInArrears	The specified operation is denied because the disk has overdue payments. Please settle the outstanding balance.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	DiskCreatingSnapshot	The operation is denied due to a snapshot of the specified disk is not completed yet.
403	InvalidDiskSize	Specified new disk size is less than or equal the original disk size.	El nuevo tamaño de disco especificado debe ser mayor que el tamaño original del disco.
403	Operation.Conflict	The operation may conflict with others. Please retry later.
403	InstanceLockedForSecurity	The instance is locked due to security.	La instancia a la que está conectado el disco está bloqueada por motivos de seguridad.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	UserNotInTheWhiteList	The user is not in disk white list.	El usuario no se encuentra en la lista blanca de Shared Block Storage. Envíe un ticket para solicitar el acceso a la lista blanca.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.	La categoría de disco especificada no es compatible con el tipo de instancia.
403	InvalidRegion.NotSupport	The specified region does not support resize online.	La región especificada no es compatible.
403	InvalidInstanceStatus.NotRunning	The status of instance to which the disk attachs must be running when resizing online.	El estado actual de la instancia no permite realizar esta operación. Realice esta operación cuando el estado de la instancia sea Running.
403	InvalidOperation.InstanceTypeNotSupportOnlineResize	The instance type of the specified instance does not support resize online.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403	InstanceSpecModification.NotEffective	The instance which the disk attachs has been reserved for making a spec modification and not taken effective in the current contract period.
403	InvalidDiskSize.NotSupportResizeOnline	The current size of the resource does not support resize online.
403	SecurityRisk.3DVerification	We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.	Se ha detectado un riesgo de seguridad en su tarjeta de crédito o débito predeterminada. Verifique su identidad mediante el enlace incluido en el correo electrónico.
403	QuotaExceeded.PostpaidDataDiskCapacity	The quota of postpaid data disk capacity exceeds.	La capacidad utilizada de los discos de datos de pago por uso excede la cuota.
403	InvalidOperation.MultiAttachDiskNotSupportResizeOnline	Multi attach disk does not support resize online.	Los discos con la conexión múltiple habilitada no admiten el cambio de tamaño en línea.
403	InvalidDataDiskCategory.ValueNotSupported	The specified Category of Data Disk is not valid.	El parámetro DataDisk.n.Category especificado no es válido.
403	InvalidDiskSize.NotSupportMultiAttachDisk	The specified disk size exceeds the maximum limit 65536 for enabling multi-attach.	Los discos mayores de 64 TB no admiten la habilitación de conexión múltiple.
404	InvalidDiskId.NotFound	The specified disk does not exist.	El disco especificado no existe. Verifique si el ID del disco es correcto.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	La instancia especificada no existe. Verifique si el ID de la instancia es correcto.

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.