ModifyDiskAttribute - : Central de Documentação do Alibaba Cloud

Observações de uso

Ao chamar esta operação para modificar os atributos de um disco, se você definir DeleteWithInstance como false e a instância à qual o disco está anexado estiver bloqueada por motivos de segurança, as configurações de DeleteWithInstance do disco serão ignoradas e o disco será liberado junto com a instância. Se "LockReason" : "security" for exibido na resposta ao consultar as informações de uma instância, isso indica que a instância está bloqueada por motivos de segurança.
Use o parâmetro DiskIds.N para especificar vários dispositivos de armazenamento em bloco e modificar seus atributos simultaneamente, incluindo nome, descrição e a opção de liberar os dispositivos juntamente com suas instâncias associadas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyDiskAttribute	A operação a ser executada. Defina o valor como ModifyDiskAttribute.
DiskId	String	No	d-bp1famypsnar20bv****	O ID do disco. Nota `DiskId` e `DiskIds.N` são mutuamente exclusivos. Especifique um dos parâmetros conforme suas necessidades de negócios.
DiskName	String	No	MyDiskName	O nome do disco. Deve ter entre 2 e 128 caracteres, começar com uma letra e não pode iniciar com `http://` ou `https://`. Pode conter letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-).
Description	String	No	TestDescription	A descrição do disco. Deve ter entre 2 e 256 caracteres e não pode começar com `http://` ou `https://`.
DeleteWithInstance	Boolean	No	false	Define se o disco deve ser liberado junto com a instância associada. Este parâmetro é vazio por padrão, o que indica que o valor atual permanece inalterado. Um erro será retornado se você definir `DeleteWithInstance` como `false` nos seguintes casos: O disco é local. O disco é básico e não removível. Se o atributo Portable de um disco estiver definido como false, o disco não é removível.
DeleteAutoSnapshot	Boolean	No	false	Indica se os snapshots automáticos do disco devem ser excluídos quando o disco for liberado. Este parâmetro é vazio por padrão, o que indica que o valor atual permanece inalterado.
EnableAutoSnapshot	Boolean	No	true	Especifica se o recurso de política de snapshot automático deve ser ativado para o disco em nuvem. Valores válidos: true false Este parâmetro é vazio por padrão, o que indica que o valor atual permanece inalterado. Nota Por padrão, o recurso de política de snapshot automático já está ativado para discos em nuvem. Basta associar uma política de snapshot automático a um disco em nuvem para começar a usá-la.
RegionId	String	Yes	cn-hangzhou	O ID da região do disco. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
DiskIds.N	String	No	d-bp1famypsnar20bv****	O ID do disco N. Valores válidos de N: 0 a 100. Nota `DiskId` e `DiskIds.N` são mutuamente exclusivos. Especifique um dos parâmetros conforme suas necessidades de negócios.
BurstingEnabled	Boolean	No	false	Define se o recurso de aumento temporário de desempenho (burst) deve ser ativado. Valores válidos: true false

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

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 erro

HTTP status code	Error code	Error message	Description
400	InvalidDiskName.Malformed	The specified disk name is wrongly formed.	Formato de DiskName inválido. O nome deve ter entre 2 e 128 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). O nome deve começar com uma letra e não pode iniciar com http:// ou https://.
400	NoAttributeToModify	No attribute to be modified in this request.	Nenhum atributo do dispositivo de armazenamento em bloco foi modificado.
400	IncompleteParamter	Some fields can not be null in this request.	Alguns parâmetros obrigatórios não foram especificados.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.	Valor de RegionId inválido.
400	BurstingEnabledForDiskCategoryUnsupported	The specified disk category does not support bursting enabled.	A categoria do disco não suporta o recurso de aumento temporário de desempenho.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.	Discos com o recurso de montagem múltipla ativado não suportam o aumento temporário de desempenho.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.	Não é possível modificar o recurso de aumento temporário de desempenho para um disco cujas configurações estão sendo alteradas.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	O número máximo de snapshots foi atingido. Para armazenar novos snapshots, exclua aqueles que não são mais necessários.
403	DiskNotPortable	The specified disk is not a portable disk.	O disco especificado não é removível.
403	IncorrectDiskStatus	The operation is not supported in this status.	Esta operação não pode ser executada no disco no estado atual. Verifique se o disco está disponível e se não há pagamentos pendentes.
403	UserNotInTheWhiteList	The user is not in disk white list.	Você não tem autorização para gerenciar o disco. Tente novamente após obter a autorização necessária.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	Discos com o recurso de montagem múltipla ativado não suportam o atributo DeleteWithInstance.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Disco não encontrado. Verifique se o ID do disco é válido.
404	InvalidDescription.Malformed	The specified description is wrongly formed.	Formato de Description inválido. A descrição deve ter entre 2 e 256 caracteres e não pode começar com http:// ou https://.
404	InvalidInstanceId.NotFound	Specified attached instance does not exist.	A instância especificada não foi encontrada. Verifique se o ID da instância está correto.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.