ModifyDiskAttribute - - Centro de documentación de Alibaba Cloud

Modifica los atributos de los dispositivos de block storage, incluidos sus nombres, descripciones y si se liberan junto con las instancias asociadas.

Notas de uso

Al llamar a esta operación para modificar los atributos de un disco, si establece DeleteWithInstance en false y la instancia a la que está conectado el disco se encuentra bloqueada por motivos de seguridad, la configuración de DeleteWithInstance del disco se ignora y este se libera junto con la instancia. Si al consultar la información de una instancia se muestra "LockReason" : "security" en la respuesta, significa que la instancia está bloqueada por razones de seguridad.
Utilice el parámetro DiskIds.N para especificar varios dispositivos de block storage y modificar sus atributos simultáneamente, incluidos los nombres, las descripciones y si se liberan junto con las instancias asociadas.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ModifyDiskAttribute	La operación que desea ejecutar. Establezca el valor en ModifyDiskAttribute.
DiskId	String	No	d-bp1famypsnar20bv****	El ID del disco. Nota `DiskId` y `DiskIds.N` son mutuamente excluyentes. Especifique uno de los parámetros según sus necesidades empresariales.
DiskName	String	No	MyDiskName	El nombre del disco. Debe tener entre 2 y 128 caracteres de longitud. Tiene que comenzar con una letra y no puede empezar con `http://` ni `https://`. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).
Description	String	No	TestDescription	La descripción del disco. Debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`.
DeleteWithInstance	Boolean	No	false	Especifica si se libera el disco junto con la instancia asociada. Este parámetro está vacío de forma predeterminada, lo que indica que el valor actual permanece sin cambios. Se devuelve un error si establece `DeleteWithInstance` en `false` en alguno de los siguientes casos: El disco es un disco local. El disco es un disco básico y no es extraíble. Un disco no es extraíble si su atributo Portable está establecido en false.
DeleteAutoSnapshot	Boolean	No	false	Especifica si se eliminan las instantáneas automáticas del disco cuando este se libera. Este parámetro está vacío de forma predeterminada, lo que indica que el valor actual permanece sin cambios.
EnableAutoSnapshot	Boolean	No	true	Especifica si se habilita la función de política de instantáneas automáticas para el disco en la nube. Valores válidos: true false Este parámetro está vacío de forma predeterminada, lo que indica que el valor actual permanece sin cambios. Nota De forma predeterminada, la función de política de instantáneas automáticas está habilitada para los discos en la nube. Solo necesita asociar una política de instantáneas automáticas con un disco en la nube antes de poder utilizarla.
RegionId	String	Sí	cn-hangzhou	El ID de región del disco. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
DiskIds.N	String	No	d-bp1famypsnar20bv****	El ID del disco N. Valores válidos de N: 0 a 100. Nota `DiskId` y `DiskIds.N` son mutuamente excluyentes. Especifique uno de los parámetros según sus necesidades empresariales.
BurstingEnabled	Boolean	No	false	Especifica si se habilita la función de ráfaga de rendimiento. Valores válidos: true false

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=ModifyDiskAttribute
&RegionId=cn-hangzhou
&DiskId=d-bp1famypsnar20bv****
&DiskName=MyDiskName
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<ModifyDiskAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyDiskAttributeResponse>

Formato JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidDiskName.Malformed	The specified disk name is wrongly formed.	Formato de DiskName no válido. El nombre debe tener entre 2 y 128 caracteres de longitud y puede contener letras, dígitos, puntos (.), guiones bajos (_) y guiones (-). Debe comenzar con una letra y no puede empezar con http:// ni https://.
400	NoAttributeToModify	No attribute to be modified in this request.	No se modificó ningún atributo del dispositivo de block storage.
400	IncompleteParamter	Some fields can not be null in this request.	Faltan algunos parámetros obligatorios.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.	Valor de RegionId no válido.
400	BurstingEnabledForDiskCategoryUnsupported	The specified disk category does not support bursting enabled.	La categoría del disco no admite la función de ráfaga de rendimiento.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.	Los discos con la función de conexión múltiple habilitada no admiten la función de ráfaga de rendimiento.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.	No se puede modificar la función de ráfaga de rendimiento para un disco cuya configuración se está cambiando.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	Se alcanzó el número máximo de instantáneas. Para almacenar nuevas instantáneas, elimine las que ya no necesite.
403	DiskNotPortable	The specified disk is not a portable disk.	El disco especificado no es extraíble.
403	IncorrectDiskStatus	The operation is not supported in this status.	Esta operación no se puede realizar en el disco debido a su estado actual. Asegúrese de que el disco esté disponible y de que no tenga pagos pendientes.
403	UserNotInTheWhiteList	The user is not in disk white list.	No tiene autorización para gestionar el disco. Inténtelo nuevamente después de obtener la autorización correspondiente.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	Los discos con la función de conexión múltiple habilitada no admiten el atributo DeleteWithInstance.
404	InvalidDiskId.NotFound	The specified disk does not exist.	No se encontró el disco. Compruebe si el ID del disco es válido.
404	InvalidDescription.Malformed	The specified description is wrongly formed.	Formato de Description no válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// ni https://.
404	InvalidInstanceId.NotFound	Specified attached instance does not exist.	No se encontró la instancia especificada. Compruebe si el ID de la instancia es correcto.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.