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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyImageAttribute	Operação a ser executada. Defina o valor como ModifyImageAttribute.
RegionId	String	Sim	cn-hangzhou	ID da região da imagem personalizada. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ImageId	String	Sim	m-bp18ygjuqnwhechc****	ID da imagem personalizada.
ImageName	String	Não	testImageName	Novo nome da imagem personalizada. O nome deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com acs: ou aliyun. Não pode conter http:// ou https://. Pode incluir letras, dígitos, pontos (.), dois-pontos (:), sublinhados (_) e hifens (-). Por padrão, este parâmetro está vazio e o nome original é mantido.
Status	String	Não	Deprecated	Novo estado da imagem personalizada. Valores válidos: Deprecated: coloca a imagem no estado Deprecated. Caso a imagem personalizada esteja compartilhada, cancele o compartilhamento antes de alterar o estado. Imagens no estado Deprecated não podem ser compartilhadas nem copiadas, mas permitem criar instâncias ou substituir discos do sistema. Available: coloca a imagem no estado Available. É possível restaurar uma imagem do estado Deprecated para o estado Available. Nota Para reverter uma imagem personalizada na família de imagens para uma versão anterior, coloque a imagem personalizada disponível mais recente no estado Deprecated. Famílias de imagens sem imagens personalizadas no estado Available não permitem criar instâncias. Tenha cautela se houver apenas uma única imagem personalizada no estado Available na família de imagens.
ImageFamily	String	Não	hangzhou-daily-update	Novo nome da família de imagens. O nome deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com acs: ou aliyun. Não pode conter http:// ou https://. Pode incluir letras, dígitos, pontos (.), dois-pontos (:), sublinhados (_) e hifens (-). Por padrão, este parâmetro está vazio.
BootMode	String	Não	BIOS	Novo modo de inicialização da imagem. Valores válidos: BIOS UEFI Nota Ao criar instâncias a partir de uma imagem após alterar o modo de inicialização, as novas instâncias usam o novo modo. Para garantir a inicialização conforme esperado, verifique se o modo especificado é compatível com a imagem. Se desconhecer os modos suportados, use o recurso de verificação de imagem para validar. Para obter mais informações, consulte Visão geral da verificação de imagem.
LicenseType	String	Não	BYOL	Tipo de licença usada para ativar o sistema operacional após importar a imagem de source. Defina o valor como BYOL. BYOL: usa a licença fornecida com o sistema operacional de source. Nesse caso, certifique-se de que sua chave de licença seja válida no Alibaba Cloud.
Description	String	Não	testDescription	Nova descrição da imagem personalizada. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://. Por padrão, este parâmetro está vazio e a descrição original é mantida.
Features.NvmeSupport	String	Não	supported	Define se há suporte ao protocolo Non-Volatile Memory Express (NVMe). Valores válidos: supported: a imagem oferece suporte a NVMe. Instâncias criadas a partir desta imagem são compatíveis com o protocolo NVMe. unsupported: a imagem não oferece suporte a NVMe. Instâncias criadas a partir desta imagem não são compatíveis com o protocolo NVMe.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=ModifyImageAttribute
&RegionId=cn-hangzhou
&ImageId=m-bp18ygjuqnwhechc****
&ImageName=testImageName
&Status=Deprecated
&ImageFamily=hangzhou-daily-update
&BootMode=BIOS
&Description=testDescription
&Features={"NvmeSupport":"supported"}
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyImageAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyImageAttributeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidImageName.Malformed	The specified Image name is wrongly formed.	Formato inválido de ImageName. O nome deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com acs: ou aliyun. Não pode conter http:// ou https://. Pode incluir letras, dígitos, pontos (.), dois-pontos (:), sublinhados (_) e hifens (-).
400	InvalidImageName.Duplicated	The specified Image name has already bean used.	O nome da imagem especificado já existe.
400	InvalidDescription.Malformed	The specified description is wrongly formed.	Formato inválido de Description. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
403	ImageStatus.NotAvailable	The specified image status is not available.	A imagem especificada não está no estado Available.
403	ImageStatus.NotDeprecated	The specified image status is not deprecated.	A imagem especificada não está no estado Deprecated.
403	OperationDeined.ImageUsingByInstance	The boot mode of the image cannot be modified because it has associated instances.	O modo de inicialização da imagem não pode ser modificado enquanto ela tiver instâncias associadas.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	A imagem especificada não foi encontrada nesta conta. Verifique se o ID da imagem está correto.

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