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

Migra un disco hacia o desde un clúster de almacenamiento de bloques dedicado, o migra un disco entre diferentes clústeres de almacenamiento de bloques dedicados.

Descripción de la operación

Nota

La función de clúster de almacenamiento de bloques dedicado está disponible actualmente en las regiones China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Heyuan), Indonesia (Jakarta), Alemania (Frankfurt) y China South 1 Finance.

Antes de invocar esta operación, asegúrese de comprender completamente los métodos de facturación y los precios de los discos y los clústeres de almacenamiento de bloques dedicados, de que el clúster de almacenamiento de bloques dedicado no haya caducado y de que su cuenta no tenga pagos pendientes. Para obtener más información, consulte Facturación del almacenamiento de bloques dedicado y Facturación del almacenamiento de bloques.

Al invocar esta operación, tenga en cuenta los siguientes puntos:

El disco y el clúster de almacenamiento de bloques dedicado deben estar en la misma zona.
Solo se admiten discos de pago por uso. Los discos de suscripción deben cambiarse primero a discos de pago por uso. Para obtener más información, consulte Cambiar entre métodos de facturación de un disco.
Las especificaciones del disco deben coincidir con las especificaciones de disco admitidas por el clúster de destino durante la migración. Durante la migración entre diferentes clústeres de almacenamiento de bloques dedicados, puede cambiar las especificaciones del disco para que coincidan con las admitidas por el clúster de destino.
El disco debe estar en estado En uso (In_use) o activo (Available).
Si el disco está conectado a una instancia de ECS, la instancia debe estar en estado En ejecución (Running) o Detenida (Stopped), y la instancia de ECS no debe haber caducado.
Dado que el nivel de rendimiento de ESSD está limitado por su capacidad, si no puede actualizar el nivel de rendimiento, puede realizar una ampliación e intentarlo de nuevo. Para obtener más información, consulte ResizeDisk y ESSD.
Una sola cuenta puede ejecutar hasta cinco tareas de migración de discos simultáneamente en la misma región.
Durante el procedimiento de migración, no se permiten operaciones como cancelar la migración, crear instantáneas, actualizar o degradar, ampliar, conectar, desconectar y reinicializar el disco.

Nota

Después de la migración del disco, este se rige por los métodos de facturación, las especificaciones de disco y las capacidades del clúster de destino. Los cambios surten efecto inmediatamente después de invocar la operación, y Alibaba Cloud factura el disco en función del nuevo tipo de disco y el nuevo nivel de rendimiento del disco. Para obtener más información, consulte Facturación del almacenamiento de bloques dedicado y Facturación del almacenamiento de bloques.

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

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.	d-bp131n0q38u3a4zi****
DiskCategory	string	No	La categoría del disco de destino. Este parámetro solo es válido durante la migración entre diferentes clústeres de almacenamiento de bloques dedicados. Actualmente, solo se admite cloud_essd (ESSD). Valor predeterminado: vacío, lo que indica que no hay cambios de especificaciones para el disco.	cloud_essd
PerformanceLevel	string	No	El nuevo nivel de rendimiento de ESSD. Este parámetro solo es válido durante la migración entre diferentes clústeres de almacenamiento de bloques dedicados. Valores válidos: PL0: un solo disco puede ofrecer hasta 10,000 IOPS de lectura/escritura aleatoria. PL1: un solo disco puede ofrecer hasta 50,000 IOPS de lectura/escritura aleatoria. Valor predeterminado: vacío, lo que indica que el nivel de rendimiento no cambia.	PL1
StorageClusterId	string	No	El ID del clúster de almacenamiento de bloques dedicado. Antes de migrar un disco a un clúster de almacenamiento de bloques dedicado, debe comprar y crear el clúster, y asegurarse de que el disco y el clúster de destino estén en la misma zona. Al migrar a un clúster de almacenamiento de bloques dedicado, debe especificar `StorageClusterId`. Al migrar a un clúster de almacenamiento de bloques de nube pública, `StorageClusterId` debe estar vacío. Valor predeterminado: vacío, lo que indica que el disco se migra a un clúster de almacenamiento de bloques de nube pública.	dbsc-cn-c4d2uea****
DryRun	boolean	No	Especifica si solo se debe realizar una comprobación previa de la solicitud. Valores válidos: true: envía una solicitud de comprobación. Los elementos de comprobación incluyen si se especifican los parámetros requeridos, el formato de la solicitud, los límites del servicio y el inventario de ECS. Si la comprobación falla, se devuelve el error correspondiente. Si la comprobación se realiza correctamente, se devuelve el código de error DryRunOperation. false: envía una solicitud normal. Una vez que la comprobación se realiza correctamente, se devuelve un código de estado HTTP 2XX y el disco se migra directamente. Valor predeterminado: false.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
RequestId	string	El ID de la solicitud.	D69846D9-F17F-51C0-8AC6-B4B71777****
TaskId	string	El ID de la tarea de migración del disco.	t-bp67acfmxazb4p****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "D69846D9-F17F-51C0-8AC6-B4B71777****",
  "TaskId": "t-bp67acfmxazb4p****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidDiskSpec.Malformed	The specified parameter DiskCategory or PerformanceLevel is not supported.	El parámetro DiskCategory o PerformanceLevel especificado no se admite.
400	AccountInArrears	The account is in arrears.	Su cuenta tiene pagos vencidos.
400	InvalidStorageClusterId.DiskAlreadyInDestination	The specified disk is already in destination.	El disco especificado ya se encuentra en el destino.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	DiskCreatingSnapshot	The operation is denied due to a snapshot of the specified disk is not completed yet.
403	InvalidOperation.DiskTypeUnsupported	The type of the disk does not support this operation.	El tipo de disco no admite esta operación.
403	InvalidOperation.DiskCategoryUnsupported	The current category of the disk does not support this operation.
403	InvalidOperation.ChargeTypeUnsupported	The charge type of the disk does not support this operation.	El método de facturación del disco no admite esta operación.
403	InvalidPerformanceLevel.DiskSizeUnsupported	The specified parameter PerformanceLevel does not match the disk size.	El parámetro PerformanceLevel especificado no coincide con el tamaño del disco.
403	DiskLimitExceeded	The number of migrated disks at the same time exceeds the limit.	El número de discos que se migran al mismo tiempo supera el límite.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	La categoría de disco especificada no existe en la zona o el clúster especificados, o la zona especificada no coincide con el clúster.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Los discos con multi-attach habilitado no admiten esta operación.
403	InvalidDisk.DetachedSystemDisk	The specified resource is/has a detached system disk %s , not support current operation.	El disco especificado es un disco del sistema desconectado y no admite la operación actual.
403	InvalidOperation.NoPermission	You are not authorized to do this action.	No tiene autorización para realizar la operación actual. Envíe un ticket para obtener asistencia.
403	InvalidOperation.LimitQosUnsupported	The specified disk has performance limits on bps or iops. This operation is not supported.
403	InvalidOperation.AcrossRegionsOrZonesUnsupported	Migration across regions or available zones is not supported.	No se admite la migración entre regiones ni entre zonas.
403	InvalidOperation.AttachedShareDisk	Attached share disk does not support this operation.	Esta operación no se admite para discos compartidos conectados.
403	InvalidDiskCategory.NotSupported	The specified storage category is not supported. Please choose a category such as cloud_essd PL0 or PL1 and try again.
404	InvalidDiskId.NotFound	The specified disk does not exist.	El disco especificado no existe. Verifique si el ID del disco es correcto.
404	InvalidStorageClusterId.CategoryNotMatch	The current dedicated storage cluster cannot create this category of disk.
404	InvalidStorageClusterId.NotFound	The specified dedicated block storage cluster does not exist.	El clúster de almacenamiento en bloques dedicado especificado no existe.

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.