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

Modifica el nombre, la descripción, el comportamiento de liberación, la política de eliminación automática de instantáneas, la política de instantáneas automáticas, la configuración de ráfaga de rendimiento y otros atributos de uno o más dispositivos de almacenamiento en bloque.

Descripción de la operación

Puede utilizar el parámetro DiskId para modificar el nombre, la descripción, el comportamiento de liberación y otros atributos de un solo dispositivo de almacenamiento en bloque, o utilizar el parámetro DiskIds.N para modificar los atributos de varios dispositivos de almacenamiento en bloque en lote.

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

update

*Disk.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DiskId	string	No	El ID del disco cuyos atributos desea modificar. Nota Los parámetros DiskId y DiskIds.N no se pueden especificar al mismo tiempo. Especifique uno de ellos según sea necesario.	d-bp1famypsnar20bv****
DiskName	string	No	El nombre del disco. El nombre debe tener entre 2 y 128 caracteres de longitud y puede contener letras, dígitos y caracteres clasificados como letra en Unicode, incluidos los caracteres chinos. El nombre puede contener dos puntos (:), guiones bajos (_), puntos (.) y guiones (-).	MyDiskName
Description	string	No	La descripción del disco. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` o `https://`.	TestDescription
DeleteWithInstance	boolean	No	Especifica si se debe liberar el disco cuando se libera la instancia asociada. Valor predeterminado: null, lo que indica que el valor actual permanece sin cambios. Se devuelve un error si establece `DeleteWithInstance` en `false` en los siguientes casos: La categoría del disco es disco local (efímero). La categoría del disco es disco básico (nube) y el disco no es desmontable (Portable=false). Aviso Si establece DeleteWithInstance en false y la instancia de ECS a la que está conectado el disco está bloqueada por seguridad con "LockReason" : "security" en OperationLocks, la configuración de DeleteWithInstance se ignora y el disco se libera junto con la instancia.	false
DeleteAutoSnapshot	boolean	No	Especifica si se deben eliminar las instantáneas automáticas del disco cuando se elimina el disco. Valores válidos: true: Habilitado. false: Deshabilitado. Valor predeterminado: null, lo que indica que el valor actual permanece sin cambios.	false
EnableAutoSnapshot	boolean	No	Especifica si se debe habilitar la política de instantáneas automáticas para el disco. Valores válidos: true: Habilitado. false: Deshabilitado. Valor predeterminado: null, lo que indica que el valor actual permanece sin cambios. Nota [Obsoleto] Este parámetro está obsoleto. La función de política de instantáneas automáticas está habilitada de forma predeterminada para los discos después de su creación. Solo necesita asociar una política de instantáneas automáticas con el disco.	true
RegionId	string	No	El ID de la región. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
DiskIds	array	No	Los ID de los discos cuyos atributos desea modificar. Valores válidos de N: 0 a 100. Nota Los parámetros DiskId y DiskIds.N no se pueden especificar al mismo tiempo. Especifique uno de ellos según sea necesario.	d-bp1famypsnar20bv****
	string	No	El ID del disco cuyos atributos desea modificar. Valores válidos de N: 0 a 100. Nota Los parámetros DiskId y DiskIds.N no se pueden especificar al mismo tiempo. Especifique uno de ellos según sea necesario.	d-bp1famypsnar20bv****
BurstingEnabled	boolean	No	Especifica si se debe habilitar la función de ráfaga de rendimiento para los discos que admiten ráfaga. Valores válidos: true: Habilitado. false: Deshabilitado. Nota Se devuelve un error si especifica cualquier valor para un disco que no admite la función de ráfaga.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

{
  "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 malformed.
400	NoAttributeToModify	No attribute to be modified in this request.
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	MissingParameter.DiskIdOrDiskIds	Specified parameter DiskId or DiskIds is missing.
400	ParameterConflict.DiskIdAndDiskIds	The parameters DiskId and DiskIds are mutually exclusive. Please specify only one.
400	BurstingEnabledForDiskCategoryUnsupported	The specified disk category does not support bursting enabled.	El tipo de disco especificado no admite la función de ráfaga de rendimiento.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.	Los discos de conexión múltiple no admiten la función de ráfaga de rendimiento.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.	Los discos que están experimentando cambios de especificación no permiten modificar la función de ráfaga.
400	InvalidBurstingEnabled.DiskSizeTooSmall	The disk size must be greater than 3 GiB to enable burst.	La capacidad del disco es demasiado pequeña para habilitar el aumento de rendimiento.
400	InvalidParameter.DeleteWithInstance	The specified disk is an elastic ephemeral disk. Set "DeleteWithInstance" to true and try again.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.
403	DiskNotPortable	The specified disk is not a portable disk.
403	IncorrectDiskStatus	The operation is not supported in this status.	El disco actual no admite esta operación. Asegúrese de que el disco esté en uso normal y de que no haya pagos vencidos.
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	DeleteWithInstance.Conflict	The specified image is from the image market. You cannot set the DeleteWithInstance attribute to false.
404	InvalidDiskId.NotFound	The specified disk does not exist.	El disco especificado no existe. Verifique si el ID del disco es correcto.
404	InvalidDescription.Malformed	The specified description is malformed.
404	InvalidInstanceId.NotFound	Specified attached instance 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.