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

Modifica o nome, a descrição, o comportamento de liberação, a política de exclusão de snapshot automático, a política de snapshot automático, as configurações de burst de desempenho e outros atributos de um ou mais dispositivos de armazenamento em bloco.

Descrição da operação

Você pode chamar o parâmetro DiskId para modificar o nome, a descrição, o comportamento de liberação e outros atributos de um único dispositivo de armazenamento em bloco, ou chamar o parâmetro DiskIds.N para modificar os atributos de vários dispositivos de armazenamento em bloco por vez.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:ModifyDiskAttribute

update

*Disk

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DiskId	string	Não	O ID do disco cujos atributos você deseja modificar. Nota Os parâmetros DiskId e DiskIds.N não podem ser especificados ao mesmo tempo. Especifique um deles conforme necessário.	d-bp1famypsnar20bv****
DiskName	string	Não	O nome do disco. O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos e caracteres categorizados como letras no Unicode, incluindo caracteres chineses. O nome pode conter dois-pontos (:), sublinhados (_), pontos (.) e hifens (-).	MyDiskName
Description	string	Não	A descrição do disco. A descrição deve ter de 2 a 256 caracteres e não pode começar com `http://` ou `https://`.	TestDescription
DeleteWithInstance	boolean	Não	Especifica se o disco deve ser liberado junto com a instância. Valor padrão: null, o que indica que o valor atual não é alterado. Um erro será retornado se você definir DeleteWithInstance como `false` em qualquer um dos seguintes casos: A categoria do disco é disco local (ephemeral). A categoria do disco é disco básico (cloud) e o disco não é desanexável (Portable=false). Aviso Se você definir DeleteWithInstance como false e a instância ECS à qual o disco está anexado estiver bloqueada por segurança com "LockReason" : "security" em OperationLocks, o atributo DeleteWithInstance será ignorado e o disco será liberado junto com a instância. .	false
DeleteAutoSnapshot	boolean	Não	Especifica se os snapshots automáticos do disco devem ser excluídos quando o disco for excluído. Valores válidos: true: Ativado. false: Desativado. Valor padrão: null, o que indica que o valor atual não é alterado.	false
EnableAutoSnapshot	boolean	Não	Especifica se a política de snapshot automático deve ser ativada para o disco. Valores válidos: true: Ativado. false: Desativado. Valor padrão: null, o que indica que o valor atual não é alterado. Nota Este parâmetro foi descontinuado. A política de snapshot automático é ativada por padrão para os discos após a sua criação. Você só precisa associar uma política de snapshot automático ao disco.	true
RegionId	string	Não	O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
DiskIds	array	Não	Os IDs dos discos cujos atributos você deseja modificar. Valores válidos de N: 0 a 100. Nota Os parâmetros DiskId e DiskIds.N não podem ser especificados ao mesmo tempo. Especifique um deles conforme necessário.	d-bp1famypsnar20bv****
	string	Não	O ID de um disco cujos atributos você deseja modificar. Valores válidos de N: 0 a 100. Nota Os parâmetros DiskId e DiskIds.N não podem ser especificados ao mesmo tempo. Especifique um deles conforme necessário.	d-bp1famypsnar20bv****
BurstingEnabled	boolean	Não	Especifica se o recurso de burst de desempenho deve ser ativado para discos que suportam este recurso. Valores válidos: true: Ativado. false: Desativado. Nota Um erro será retornado se você especificar este parâmetro para um disco que não suporta o recurso de burst de desempenho.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDiskName.Malformed	The specified disk name is wrongly formed.	The disk name is invalid. The name must be 2 to 128 characters in length and start with a letter. It can contain letters, digits, periods (.), underscores (_), and hyphens (-) and cannot start with http:// or https.
400	NoAttributeToModify	No attribute to be modified in this request.
400	IncompleteParamter	Some fields can not be null in this request.	Some required parameters are not specified.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	MissingParameter.DiskIdOrDiskIds	Specified parameter DiskId or DiskIds is missing.
400	ParameterConflict.DiskIdAndDiskIds	Specified parameter DiskId and DiskIds conflict, only one can be chosen.
400	BurstingEnabledForDiskCategoryUnsupported	The specified disk category does not support bursting enabled.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.
400	InvalidBurstingEnabled.DiskSizeTooSmall	The disk size must be greater than 3 GiB to enable burst.	The disk size must be greater than 3 GiB to enable burst.
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.	The disk is in a state that does not support the current operation. Make sure that the disk is available and that your account has no overdue payments.
403	UserNotInTheWhiteList	The user is not in disk white list.	You are not authorized to manage the disk. Try again when you are authorized.
403	DeleteWithInstance.Conflict	The specified image is from the image market, you cannot set DeleteWithInstance attribute to false.
404	InvalidDiskId.NotFound	The specified disk does not exist.	The specified disk does not exist. Check whether the disk ID is correct.
404	InvalidDescription.Malformed	The specified description is wrongly formed.
404	InvalidInstanceId.NotFound	Specified attached instance does not exist.	The specified instance does not exist. Check whether the instance ID is correct.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.