Replicação de uma imagem em uma região
Função
Esta API é uma extensão e é usada para copiar uma imagem existente para outra imagem. Ao replicar uma imagem, você pode alterar os atributos da imagem para atender aos requisitos de diferentes cenários.
Esta API é assíncrona. Se job_id for retornado, a tarefa será entregue com êxito. Você precisa consultar o status da tarefa assíncrona. Se o status for success, a tarefa será executada com êxito. Se o status for failed, a tarefa falhará. Para obter detalhes sobre como consultar o status de uma tarefa assíncrona, consulte Consulta dos trabalhos assíncronos.
Restrições
- As imagens de ECS completo não podem ser replicadas na mesma região.
- Imagens privadas criadas usando arquivos ISO não oferecem suporte à replicação na região.
URI
POST /v1/cloudimages/{image_id}/copy
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
id_imagem |
Sim |
Cadeia |
Especifica o ID da imagem. Para obter detalhes de como conseguir o ID de domínio, clique em Consulta de imagens. |
Solicitação
- Parâmetros de solicitação
Parâmetro
Obrigatório
Tipo
Descrição
Nome
Sim
Cadeia
Especifica o nome de imagem. Para uma descrição detalhada, consulte Atributos da imagem.
Descrição
Não
Cadeia
Fornece informações suplementares sobre a imagem. Para uma descrição detalhada, consulte Atributos da imagem. O valor contém um máximo de 1024 caracteres e consiste apenas em letras e dígitos. Não são permitidos retornos de carro e colchetes angulares (< >). Este parâmetro é deixado em branco por padrão.
cmk_id
Não
Cadeia
Especifica a chave de encriptação. Este parâmetro é deixado em branco por padrão.
id_do_projeto_da_empresa
Não
Cadeia
Indica o projeto empresarial ao qual a imagem pertence.
- Se o valor for 0 ou deixado em branco, a imagem pertence ao projeto empresarial padrão.
- Se o valor for um UUID, a imagem pertence ao projeto empresarial correspondente ao UUID.
Para obter mais informações sobre projetos corporativos e como obter os ID de projeto corporativo, consulte Centro Empresarial
- Exemplo de solicitação
POST https://{Endpoint}/v1/cloudimages/465076de-dc36-4aec-80f5-ef9d8009428f/copy
1 2 3 4 5
{ "name": "ims_encrypted_copy3", "description": "test copy", "cmk_id": "bd66288c-9081-460a-8227-4cbd0c814cb4" }
Resposta
- Parâmetros de resposta
Parâmetro
Tipo
Descrição
trabalho_id
Cadeia
Especifica o ID do trabalho assíncrono.
Para mais detalhes, consulte Consulta dos trabalhos assíncronos.
- Exemplo de resposta
CÓDIGO DE STATUS 200
1 2 3
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
Valor retornado
- Normal
- Anormal
Valor retornado
Descrição
400 Solicitação inválida
Erro na solicitação. Para mais detalhes, consulte Códigos de erro.
401 Não autorizado
Autenticação falhou.
403 Proibido
Você não tem os direitos para realizar a operação.
404 Não encontrado
O recurso solicitado não foi encontrado.
500 Erro de servidor interno
Erro do serviço interno.
503 Serviço indisponível
Serviço não está disponível.