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

Executa uma tarefa de criação de imagem usando um modelo de imagem.

Descrição da operação

Após a criação de um modelo de imagem, chame esta operação para executar uma tarefa de criação de imagem. O sistema cria, distribui e gera imagens compartilhadas com base nos parâmetros configurados nas definições do modelo de imagem.
Para o mesmo modelo de imagem, apenas uma tarefa de criação de imagem pode ser executada por vez. Você pode chamar CancelImagePipelineExecution várias vezes simultaneamente. O cancelamento de uma tarefa de criação de imagem não interfere em outras tarefas de criação de imagem.
Ao executar um modelo de criação de imagem, várias instâncias intermediárias são criadas para ajudar a criar as imagens. As instâncias intermediárias são instâncias ECS que usam o método de faturamento pay-as-you-go, e taxas de faturamento são incorridas. Para mais informações, consulte Pay-as-you-go.

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

update

*Pipeline de imagem.

acs:ecs:{#regionId}:{#accountId}:imagepipeline/{#imagepipelineId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
TemplateTag `deprecated`	array<object>	Não	Nota Este parâmetro foi descontinuado.
	object	Não
Key	string	Não	Nota Este parâmetro foi descontinuado.	null
Value	string	Não	Nota Este parâmetro foi descontinuado.	null
Tag	array<object>	Não	As tags.
	object	Não	O objeto de tag.
Key	string	Não	A chave da tag. 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 e não pode começar com `aliyun` ou `acs:`. A chave da tag não pode conter `http://` ou `https://`.	TestKey
Value	string	Não	O valor da tag. 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 e não pode começar com `acs:`. O valor da tag não pode conter `http://` ou `https://`.	TestValue
ImagePipelineId	string	Sim	O ID do modelo de imagem.	ip-2ze5tsl5bp6nf2b3****
ClientToken	string	Não	O token do 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. ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
ExecutionId	string	O ID da tarefa de criação.	exec-5fb8facb8ed7427c****
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "ExecutionId": "exec-5fb8facb8ed7427c****",
  "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	InvalidImage.OsTypeUnsupported	The specified base image does not support image building.	O sistema operacional da imagem base especificada não oferece suporte à criação de imagens.
400	InvalidParameter.BuildContent	%s.	O conteúdo do modelo de compilação é inválido.
400	InvalidParameter.TestContent	%s.	O conteúdo do modelo de teste é inválido.
400	InvalidImageComponent.NotSupported	%s.	O componente de imagem especificado não está disponível.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Existem chaves duplicadas nas tags. Certifique-se de que todas as chaves sejam únicas.
400	InvalidTagKey.Malformed	The specified Tag.N.Key is not valid. Tag keys cannot be empty or null, support up to 128 characters, cannot start with "aliyun" or "acs:", and cannot contain "http://" or "https://".	O parâmetro de chave de tag especificado é inválido.
400	InvalidTagValue.Malformed	The specified Tag.N.Value is not valid. Tag values support up to 128 characters, and cannot contain "http://" or "https://".	O parâmetro de valor da tag especificado é inválido.
400	InvalidDockerRepositoryCredential.DockerRegistryMalformed	The specified parameter DockerRepositoryCredential.DockerRegistry is invalid. The length should be between 1 to 512 characters.	O comprimento do registro Docker especificado deve estar entre 1 e 512 caracteres.
400	InvalidDockerRepositoryCredential.UserMalformed	The specified parameter DockerRepositoryCredential.User is invalid. The length should be between 1 to 128 characters.	O comprimento do nome de usuário especificado deve estar entre 1 e 128 caracteres.
400	InvalidImageName.Duplicated	The specified image name is already in use.	O nome da imagem já existe.
500	StartImagePipelineExecution.Failed	Start image pipeline execution failed.	Falha ao executar a tarefa do construtor de imagens.
403	InvalidImagePipeline.HasRunningExecution	%s
403	InvalidImagePipeline.OSSObjectNotAuthorized	The ImportImageOptions.DiskDeviceMappings.OSSObject of the specified ImagePipeline is not allowed to access.	Não é permitido acessar o ImportImageOptions.DiskDeviceMappings.OSSObject especificado no ImagePipeline.
403	InvalidImagePipeline.OSSObjectNeedRestore	The ImportImageOptions.DiskDeviceMappings.OSSObject of the specified ImagePipeline is an archived object and needs to be restored first.	O ImportImageOptions.DiskDeviceMappings.OSSObject especificado no ImagePipeline é um objeto arquivado e deve ser restaurado primeiro.
403	InvalidOperation.NoRightAccessOSS	ECS service is not authorized to access your OSS. Check your RAM roles and policies, and ensure that ecs.aliyuncs.com is authorized to assume AliyunECSImageImportDefaultRole.	O ECS não tem permissão para acessar seu OSS. Verifique sua função e política do RAM e certifique-se de que "ecs.aliyuncs.com" tenha recebido permissão para assumir a função "AliyunECSImageImportDefaultRole".
404	InvalidImagePipeline.NotFound	%s
404	InvalidInstanceType.NotFound	The specified instance type does not exist.	O parâmetro InstanceType especificado não existe.
404	InvalidVSwitchId.NotFound	The specified VSwitchId does not exist.	O ID do vSwitch especificado não existe.
404	InvalidRegionId.NotFound	%s	O RegionId especificado não existe. Verifique se o produto está disponível nesta região.
404	InvalidImage.NotFound	%s.	O ID da imagem de origem especificado não existe.
404	ImageComponent.NotFound	%s.	O ID do componente de imagem especificado não foi encontrado.
404	InvalidImagePipeline.BaseImageNotFound	The BaseImage of the specified ImagePipeline is not found.	A imagem base do modelo especificado não foi encontrada.
404	InvalidImagePipeline.OSSObjectNotFound	The ImportImageOptions.DiskDeviceMappings.OSSObject of the specified ImagePipeline is not found in this region.	O ImportImageOptions.DiskDeviceMappings.OSSObject especificado no ImagePipeline não foi encontrado na região atual.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.