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 automática de snapshots, a política automática de snapshots, 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 usar 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 usar o parâmetro DiskIds.N para modificar os atributos de vários dispositivos de armazenamento em bloco em lote.

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

*Disco.

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 letra 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 quando a instância associada for liberada. Valor padrão: null, que indica que o valor atual permanece inalterado. Um erro será retornado se você definir `DeleteWithInstance` como `false` nos seguintes casos: A categoria do disco é disco local (efêmero). A categoria do disco é disco básico (nuvem) 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, a configuração DeleteWithInstance será ignorada 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, que indica que o valor atual permanece inalterado.	false
EnableAutoSnapshot	boolean	Não	Especifica se a política automática de snapshots deve ser ativada para o disco. Valores válidos: true: Ativado. false: Desativado. Valor padrão: null, que indica que o valor atual permanece inalterado. Nota [Deprecated] Este parâmetro foi descontinuado. O recurso de política automática de snapshots é ativado por padrão para discos após sua criação. Você só precisa associar uma política automática de snapshots 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 do 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 burst. Valores válidos: true: Ativado. false: Desativado. Nota Um erro será retornado se você especificar qualquer valor para um disco que não suporte o recurso de burst.	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 malformed.
400	NoAttributeToModify	No attribute to be modified in this request.
400	IncompleteParamter	Some fields can not be null in this request.	Um parâmetro obrigatório está ausente na solicitação.
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.	O tipo de disco especificado não suporta o recurso de aumento temporário de desempenho.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.	Discos com anexação múltipla não suportam o recurso de aumento temporário de desempenho.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.	Discos que estão passando por alterações de especificação não permitem a modificação do recurso de burst.
400	InvalidBurstingEnabled.DiskSizeTooSmall	The disk size must be greater than 3 GiB to enable burst.	A capacidade do disco é muito pequena para ativar o aumento temporário de desempenho.
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.	O disco atual não suporta esta operação. Certifique-se de que o disco esteja em uso normal e que não haja pagamentos em atraso.
403	UserNotInTheWhiteList	The user is not in disk white list.	O usuário não está na lista de permissões do Shared Block Storage. Abra um ticket para solicitar a inclusão na lista de permissões.
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.	O disco especificado não existe. Verifique se o ID do disco está correto.
404	InvalidDescription.Malformed	The specified description is malformed.
404	InvalidInstanceId.NotFound	Specified attached instance does not exist.	A instância especificada não existe. Verifique se o ID da instância está correto.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.