ModifyRCDiskAttribute - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Modifica os atributos de um dispositivo de armazenamento em bloco, como seu nome, descrição, se o disco é liberado com sua instância e se o recurso de bursting deve ser ativado.

Descrição da operação

Chame esta operação para modificar os atributos de um dispositivo de armazenamento em bloco, como seu nome, descrição e se ele é liberado com sua instância.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Chame a operação DescribeRegions para visualizar a lista mais recente de regiões.	cn-hangzhou
DiskId	string	Sim	O ID do disco a ser modificado.	rcd-wz9c8isqly8637zw****
DiskName	string	Não	O nome do disco. O nome deve ter de 2 a 128 caracteres e pode conter letras da categoria Letter do Unicode (incluindo caracteres em inglês e chinês), dígitos, dois-pontos (:), sublinhados (_), pontos (.) e hifens (-).	testDisk
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://.	test
DeleteWithInstance	boolean	Não	Especifica se o disco deve ser liberado quando sua instância associada for liberada. Se você não especificar este parâmetro, a configuração atual será mantida. Este parâmetro não é suportado para discos em nuvem que têm o recurso multi-attach ativado. Ocorre um erro se você definir DeleteWithInstance como false nos seguintes casos: O disco é um disco efêmero (ephemeral). O disco é um disco em nuvem (cloud) que não é destacável (Portable=false). Aviso: Se você definir DeleteWithInstance como false, a configuração será ignorada sob certas condições. Quando a instância ECS anexada tiver um bloqueio de segurança (indicado por "LockReason" : "security" em OperationLocks), o disco será liberado com a instância, independentemente do valor de DeleteWithInstance.	false
BurstingEnabled	boolean	Não	Especifica se o recurso de bursting deve ser ativado para discos que o suportam. Valores válidos: true: Ativa o recurso. false: Desativa o recurso. Nota: Ocorre um erro se você especificar este parâmetro para um disco que não suporta bursting.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Corpo da resposta.
RequestId	string	O ID da solicitação.	1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	O RegionId especificado é inválido.
400	InvalidDiskName.Malformed	The specified disk name is wrongly formed.	O formato do nome do disco é inválido. O nome deve ter de 2 a 128 caracteres de comprimento, começar com uma letra ou caractere chinês e pode conter dígitos, pontos (.), sublinhados (_) ou hifens (-). O nome não pode começar com http:// ou https://.
400	NoAttributeToModify	No attribute to be modified in this request.	Nenhum atributo foi modificado.
400	IncompleteParamter	Some fields can not be null in this request.	Um parâmetro está ausente na solicitação.
400	MissingParameter.DiskIdOrDiskIds	Specified parameter DiskId or DiskIds is missing.	O parâmetro DiskId ou DiskIds está ausente.
400	BurstingEnabledForDiskCategoryUnsupported	The specified disk category does not support bursting enabled.	O tipo de disco em nuvem especificado não oferece suporte ao recurso de I/O burst.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.	Os discos em nuvem multi-attach não oferecem suporte ao recurso de I/O burst.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.	Você não pode modificar o recurso de burst para um disco em nuvem que está sendo reconfigurado.
400	InvalidBurstingEnabled.DiskSizeTooSmall	The disk size must be greater than 3 GiB to enable burst.	O burst de desempenho de E/S só pode ser ativado quando o tamanho do disco em nuvem for superior a 3 GiB.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	A cota de snapshots foi excedida. Para armazenar novos snapshots, exclua os snapshots antigos existentes sem afetar suas cargas de trabalho.
403	DiskNotPortable	The specified disk is not a portable disk.	O disco em nuvem especificado não pode ser desanexado. Discos em nuvem com Portable definido como false não podem ser desanexados.
403	IncorrectDiskStatus	The operation is not supported in this status.	O disco em nuvem atual não suporta esta operação. Certifique-se de que o disco em nuvem esteja em estado normal e de que você não tenha pagamentos em atraso.
403	UserNotInTheWhiteList	The user is not in disk white list.	Sua conta não está na lista de permissões de discos em nuvem. Adicione sua conta à lista de permissões e tente novamente.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	A imagem especificada é do Alibaba Cloud Marketplace e não suporta a desativação da liberação com a instância.
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 wrongly formed.	O formato de descrição do recurso especificado é inválido. A descrição deve ter de 2 a 256 caracteres de comprimento 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 existe. Verifique se o ID da instância é válido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.