Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Image Management Service/ Referência de API/ As API do IMS/ Replicação da imagem/ Replicação de uma imagem em uma região
Atualizado em 2022-11-16 GMT+08:00
Ver PDF

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

Tabela 1 lista os parâmetros no URI.
Tabela 1 Descrição do parâmetro

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

    200

  • 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.
Tópico principal: Replicação da imagem