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

Importa um arquivo de imagem local para o Elastic Compute Service (ECS) como uma imagem personalizada que aparece na região especificada. Você pode então usar a imagem importada para criar instâncias ECS (RunInstances) ou substituir o disco do sistema de uma instância (ReplaceSystemDisk).

Descrição da operação

Descrição da operação.

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:ImportImage

update

*Image.

acs:ecs:{#regionId}:{#accountId}:image/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da imagem personalizada de origem. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou.
ImageName	string	Não	O nome da imagem. O nome deve ter de 2 a 128 caracteres de comprimento. Deve começar com uma letra ou um caractere chinês e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`. Pode conter dígitos, pontos (.), dois-pontos (:), sublinhados (_) ou hifens (-).	ImageTestName.
Description	string	Não	A descrição da imagem. A descrição deve ter de 2 a 256 caracteres de comprimento e não pode começar com `http://` ou `https://`.	TestDescription.
Architecture	string	Não	A arquitetura do sistema. Valores válidos:	x86_64
OSType	string	Não	O tipo de sistema operacional. Valores válidos:	linux.
Platform	string	Não	A distribuição do sistema operacional. Valores válidos:	Aliyun.
BootMode	string	Não	O modo de inicialização da imagem. Valores válidos:	BIOS.
RoleName	string	Não	O nome da função do RAM usada para importar a imagem.	AliyunECSImageImportDefaultRole.
LicenseType	string	Não	O tipo de licença. Este parâmetro especifica o modo de autorização quando instâncias são criadas chamando RunInstances com esta imagem. Este valor entra em vigor apenas para imagens do Windows Server. Valores válidos:	BYOL.
ResourceGroupId	string	Não	O ID do grupo de recursos corporativos ao qual a imagem importada pertence.	rg-bp67acfmxazb4p****
DiskDeviceMapping	array<object>	Não	A lista de informações da imagem personalizada a ser criada.
	object	Não	A lista de informações da imagem personalizada a ser criada.
DiskImSize	integer	Não	O tamanho da imagem personalizada. Unidade: GiB.	80
Device	string	Não	O nome do dispositivo de DiskDeviceMapping.N.Device na imagem personalizada.	null.
OSSBucket	string	Não	O bucket do OSS onde o arquivo de imagem está armazenado.	ecsimageos.
Format	string	Não	O formato da imagem. Valores válidos:	QCOW2
OSSObject	string	Não	O nome (chave) do arquivo de imagem armazenado no bucket do OSS após o upload da imagem para o OSS.	CentOS_5.4_32.raw.
DiskImageSize	integer	Não	O tamanho do espaço da imagem personalizada após a importação da imagem.	80
Tag	array<object>	Não	A lista de tags da imagem.
	object	Não	A lista de tags da imagem.
Key	string	Não	A chave da tag da imagem. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres de comprimento e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	TestKey.
Value	string	Não	O valor da tag da imagem. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres de comprimento e não pode começar com `acs:`. Não pode conter `http://` ou `https://`.	TestValue.
DetectionStrategy	string	Não	A estratégia de detecção de imagem. Se este parâmetro não for especificado, a detecção não será acionada. Apenas o modo de detecção Standard é suportado.	Standard.
StorageLocationArn	string	Não	O Alibaba Cloud Resource Name (ARN) do CloudBox, que identifica exclusivamente o local de armazenamento em nuvem.	arn:acs:cloudbox:cn-hangzhou:123456:cloudbox/cb-xx***123
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run. Valores válidos:	false.
Features	object	Não	As propriedades relacionadas aos recursos da imagem.
NvmeSupport	string	Não	Especifica se a imagem suporta NVMe.	supported.
ImdsSupport	string	Não	O modo de acesso a metadados da imagem. Valores válidos:	v2
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. O valor ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
ImageId	string	O ID da imagem.	m-bp67acfmxazb4p****
TaskId	string	O ID da tarefa de importação de imagem.	t-bp67acfmxazb4p****
RegionId	string	O ID da região.	cn-hangzhou.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ImageId": "m-bp67acfmxazb4p****",
  "TaskId": "t-bp67acfmxazb4p****",
  "RegionId": "cn-hangzhou."
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	UnsupportedSuffix.OSSObject	The specified OSS object suffix is not supported.	O sufixo de objeto OSS especificado não é suportado.
400	MissingParameter	An input parameter "RegionId" that is mandatory for processing the request is not supplied.
400	InvalidImageName.Malformed	The specified Image name is wrongly formed.	O nome da imagem deve ter entre 2 e 128 caracteres. Deve começar com uma letra ou um caractere chinês e pode conter dígitos, dois-pontos (:), sublinhados (_) ou hifens (-).
400	InvalidOSSObject.Malformed	The specified OSS object is wrongly formed.	O objeto do OSS especificado é inválido.
400	InvalidOSSBucket.Malformed	The specified OSS bucket is wrongly formed.
400	InvalidOSSObject.Size	The specified OSS object size is zero.	O OSSObject especificado está vazio.
400	InvalidDescription.Malformed	The specified Image description is wrongly formed.	O parâmetro description especificado é inválido.
400	InvalidArchitecture.Malformed	The specified Architecture is wrongly formed.	O parâmetro Architecture especificado é inválido. Verifique se o formato deste parâmetro está correto.
400	InvalidPlatform.Malformed	The specified Platform is wrongly formed.	A plataforma especificada é inválida.
400	InvalidOSType.Malformed	The specified OSType is wrongly formed.	O formato é inválido.
400	InvalidImageName.Duplicated	The destination image is exist.
400	InvalidImageSize	%s	O tamanho da imagem não atende aos requisitos.
400	InvalidDataDiskSize	The specified DiskDeviceMapping.N.DiskImSize should be in the specified range.	O DiskDeviceMapping.N.DiskImSize especificado está fora do intervalo válido.
400	InvalidImageFormat.Malformed	The specified Image Format is wrongly formed.	O formato de imagem especificado é inválido.
400	InvalidRegionId.NotFound	The specified RegionId does not exist.
400	InvalidRegion.NotSupport	The specified region does not support image import or export.	A região não suporta Bring Your Own Key (BYOK).
400	InvalidOSSBucket.NotFound	The specified OSS bucket does not exist in this region.	O bucket especificado não existe.
400	InvalidOSSObject.NotFound	The specified OSS object does not exist in this region.
400	InvalidOSSObject.NeedRestore	The specified OSS object is a archive object, need restore first.
400	InvalidOSSBucket.NotMatched	The specified OSS bucket is incorrect, %s.	O bucket OSS especificado é inválido. Para mais informações, consulte a mensagem de erro real retornada.
400	InvalidLicenseType.NotSupported	The specified LicenseType is not supported.
400	InvalidLicenseType.BYOLOnly	Only BYOL LicenseType is supported for the current platform provided.
400	InvalidOSSBucket.FlowLimit	%s
400	InvalidImageFormat.RegionNotSupported	The specified image format is not supported in current region.
400	InvalidBootMode.Malformed	The specified parameter "BootMode" is malformed.
400	InvalidParameter.DetectionStrategy	The specified parameter DetectionStrategy is invalid.
400	InvalidBootMode.NotSupport	The specified parameter BootMode is not supported for current image architecture.	A arquitetura atual da imagem não suporta a definição deste modo de inicialização.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	Esta solicitação é uma solicitação DryRun (execução simulada). Este código de erro indica que a solicitação passou na validação.
400	InvalidClientToken.Malformed	The specified parameter clientToken is not valid.	O parâmetro ClientToken especificado não atende aos requisitos de formato. O parâmetro deve conter apenas caracteres ASCII e não deve exceder 64 caracteres de comprimento.
400	InvalidParameter.FeaturesImdsSupport	The specified parameter Features.ImdsSupport is not supported.	O parâmetro Features.ImdsSupport especificado não é suportado.
400	Account.Arrearage	Your account has an outstanding payment.	Sua conta possui pagamentos pendentes.
403	ImageIsImporting	The specified Image is importing.
403	QuotaExceed.Image	The Image Quota exceeds.
403	ImportImageFailed	Importing image is failed, Please contact the administrator.	Falha ao importar a imagem. Entre em contato com o administrador do sistema para solução de problemas.
403	UserNotInTheWhiteList	The user is not in the white list of importing image.
403	NoSetRoletoECSServiceAcount	ECS service account Have no right to access your OSS.please attach a role of access your oss to ECS service account.
403	InvalidParameter.Malformed	The specified parameter "DiskDeviceMapping.n.Device " is not valid.
403	MissingParameter.DiskDeviceMapping	The specified parameter DiskDeviceMapping is not supplied.	O parâmetro DiskDeviceMapping não pode estar vazio.
403	InvalidOSS.NotAuthorized	The specified OSS bucket or object is not allowed to access.	Você não tem permissão para acessar o bucket e o objeto OSS especificados.
403	InvalidBlockSize.NotSupport	%s	O tamanho da partição do arquivo de imagem não é suportado.
403	InvalidImageFormat.Malformed	%s
403	ImageCheckUnsupported.WindowsImage	Image check is unsupported for windows image.
403	InvalidVHDImage.IncorrectSize	The specified size of the VHD image does not meet the 'header.MaxTableEntries * header.BlockSize' specification.	O tamanho da imagem VHD especificado não está em conformidade com a especificação 'header.MaxTableEntries * header.BlockSize'.
403	InvalidOSSBucket.EncryptUnsupported	Accessing objects from encrypted OSS bucket is not supported.	A leitura de objetos de um bucket OSS criptografado não é suportada.
403	InvalidArchitecture.PlatformUnsupported	The OS platform you selected does not support the specified architecture.	A plataforma do sistema operacional selecionada não suporta o tipo de arquitetura especificado.
403	InvalidAccountStatus.OSSDisabled	OSS is disabled due to invalid account status.	O OSS está desativado porque o status da conta é inválido.
403	InvalidStorageLocation.NotFound	The specified cloud box storage location %s could not be found.	O local de armazenamento do CloudBox especificado não foi encontrado.
403	InvalidOperation.CloudBoxImageImportRoleRequired	The role for cloud box image import is not set to the ECS service.	A função para importar imagens do CloudBox não foi atribuída ao serviço ECS.
403	InvalidOperation.CloudBoxImageImportUnsupported	Importing cloud box images is not supported.	A importação de imagens do CloudBox não é suportada.
403	TagKey.Duplication	The TagKey has duplication with others, case-insensitive.	O parâmetro Tag.N.Key especificado contém valores duplicados. Os valores deste parâmetro não diferenciam maiúsculas de minúsculas. Verifique se foram especificados valores de parâmetro duplicados.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	O grupo de recursos correspondente não pode ser encontrado.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.