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

Observações de uso

Antes de exportar imagens, observe os seguintes itens:

Certifique-se de conhecer os pré-requisitos e as precauções. Para mais informações, consulte Exportar imagens.
O parâmetro Image Format está disponível apenas nas seguintes regiões: Índia (Mumbai) Em encerramento, Japão (Tóquio), Austrália (Sydney), Indonésia (Jacarta), Alemanha (Frankfurt), Emirados Árabes Unidos (Dubai), EUA (Virgínia), Reino Unido (Londres), Singapura, EUA (Vale do Silício) e Malásia (Kuala Lumpur). Por padrão, as imagens personalizadas são exportadas no formato RAW nas regiões onde o parâmetro Image Format não está disponível.

Use o Resource Access Management (RAM) para crie uma função do RAM para o Elastic Compute Service (ECS) e autorizar o ECS a gravar dados no OSS. Para concluir a autorização, execute as seguintes operações:

Crie uma função chamada AliyunECSImageExportDefaultRole e configure a seguinte política de confiança para ela.


         {
           "Statement": [
             {
               "Action": "sts:AssumeRole",
               "Effect": "Allow",
               "Principal": {
                 "Service": [
                   "ecs.aliyuncs.com"
                 ]
               }
             }
           ],
           "Version": "1"
         }

Anexe a política de sistema AliyunECSImageExportRolePolicy à função AliyunECSImageExportDefaultRole. Esta é a política padrão que concede ao ECS as permissões para exportar imagens. Para mais informações, acesse a página Cloud Resource Access Authorization. Também é possível criar uma política personalizada com o conteúdo abaixo e anexá-la à função:


         {
           "Version": "1",
           "Statement": [
             {
               "Action": [
                 "oss:GetObject",
                 "oss:PutObject",
                 "oss:DeleteObject",
                 "oss:GetBucketLocation",
                 "oss:GetBucketInfo",
                 "oss:AbortMultipartUpload",
                 "oss:ListMultipartUploads",
                 "oss:ListParts"
               ],
               "Resource": "*",
               "Effect": "Allow"
             }
           ]
         }

Após exportar as imagens, observe os seguintes itens:

A imagem personalizada fica armazenada no bucket do OSS especificado. Baixe a imagem personalizada conforme necessário. Para mais informações, consulte Baixar objetos.

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 o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ExportImage	Operação a ser executada. Defina o valor como ExportImage.
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-bp67acfmxazb4p****	ID da imagem personalizada.
OSSBucket	String	Sim	testexportImage	Bucket do OSS onde armazenar a imagem personalizada exportada.
OSSPrefix	String	Não	EcsExport	Prefixo do objeto sob o qual armazenar a imagem personalizada no bucket do OSS. Deve ter de 1 a 30 caracteres e pode conter dígitos e letras.
ImageFormat	String	Não	raw	Formato de exportação da imagem personalizada. Valores válidos: raw vhd qcow2 vmdk vdi Valor padrão: raw.
RoleName	String	Não	AliyunECSImageExportDefaultRole	Nome da função do RAM usada para exportar a imagem personalizada.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	C8B26B44-0189-443E-9816-D951F596****	ID da solicitação.
TaskId	String	tsk-bp67acfmxazb4p****	ID da tarefa de exportação de imagem.
RegionId	String	cn-hangzhou	ID da região.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ExportImage
&ImageId=m-bp67acfmxazb4p****
&OSSBucket=testexportImage
&RegionId=cn-hangzhou
&OSSPrefix=EcsExport
&ImageFormat=raw
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ExportImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F596****</RequestId>
    <ExportTaskId>tsk-bp67acfmxazb4p****</ExportTaskId>
    <RegionId>cn-hangzhou</RegionId>
</ExportImageResponse>

Formato JSON

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F596****",
  "ExportTaskId" : "tsk-bp67acfmxazb4p****",
  "RegionId" : "cn-hangzhou"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidImageName.Malformed	The specified Image name is wrongly formed.	Nome de imagem inválido. 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 conter letras, dígitos, pontos (.), dois-pontos (:), sublinhados (_) e hifens (-).
400	InvalidOSSPrefix.Malformed	The specified OSSPrefix format is wrongly formed.	Valor de OSSPrefix inválido.
400	InvalidRegionId.NotFound	The specified RegionId does not exist.	Valor de RegionId inválido.
400	InvalidRegion.NotSupport	The specified region does not support image import or export.	Esta operação não pode ser executada na região especificada.
400	IncorrectImageStatus	The specified Image is not available.	Estado da imagem inválido.
400	InvalidImageFormat.Malformed	The specified Image Format is wrongly formed.	Valor de ImageFormat inválido.
400	InvalidOSSBucket.NotFound	The specified OSS bucket does not exist in this region.	O bucket do OSS especificado não foi encontrado.
400	OperationDenied	The specified image contains the snapshot of the data disk,does not support this operation.	Imagens com snapshots de disco de dados não suportam esta operação.
400	InvalidImage.DiskAmountOrSize	%s	A imagem não pode ser exportada porque contém mais de quatro snapshots de disco de dados ou porque um deles excede 500 GiB.
400	ImageNotSupported	The specified Image contains encrypted snapshots, do not support export.	A imagem especificada contém snapshots criptografados e não pode ser exportada.
400	InvalidOSSBucket.NotMatched	The specified OSS bucket is incorrect, %s.	Bucket do OSS inválido. Para mais informações, consulte o valor retornado pelo placeholder %s na mensagem de erro.
403	ImageNotSupported	The specified image from the image market, do not support export image.	A imagem especificada é uma imagem do Alibaba Cloud Marketplace e não pode ser exportada.
403	ImageIsExporting	The specified Image is exporting.	A imagem especificada está sendo exportada.
403	ExportImageFailed	Exporting image is failed, Please contact the administrator.	Falha ao exportar a imagem. Entre em contato com o administrador do sistema.
403	UserNotInTheWhiteList	The user is not in the white list of exporting image.	Você não tem autorização para exportar imagens.
403	NoSetRoletoECSServiceAcount	ECS service account Have no right to access your OSS.please attach a role of access your oss to ECS service account.	O ECS não está autorizado a acessar o bucket ou objeto do OSS especificado.
403	ConcurrentQuotaExceed.ExportImage	%s	O número máximo de tarefas simultâneas em andamento foi excedido. Tente novamente mais tarde.
403	WeeklyQuotaExceed.ExportImage	%s	A cota semanal de imagens exportadas foi esgotada. Tente novamente quando a cota estiver disponível.
403	InvalidImageLicense.NotSupported	%s	A imagem especificada não pode ser exportada. Para mais informações, consulte o valor retornado de %s na mensagem de erro.
403	InvalidOSSBucket.EncryptUnsupported	Accessing objects from encrypted OSS bucket is not supported.	Não é possível ler objetos de buckets do OSS criptografados.
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.