Replicação de uma imagem entre regiões
Função
Essa API é uma extensão e é usada para replicar uma imagem privada de uma região para outra região para criar os ECS do mesmo tipo. Isso permite migrar serviços entre regiões.
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 failed, a tarefa falhará.
Restrições
- A região de destino não pode ser igual à região de origem.
- Imagens encriptadas não oferecem suporte à replicação entre regiões.
- O tamanho de cada imagem a ser replicada nas regiões não pode ser maior que 128 GB.
- Um máximo de cinco imagens privadas podem ser replicadas de cada vez.
- Imagens privadas criadas usando arquivos ISO não oferecem suporte à replicação entre regiões.
URI
POST /v1/cloudimages/{image_id}/cross_region_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.
Região
Sim
Cadeia
Especifica o ID da região de destino.
Para obter detalhes sobre como obter IDs de região, consulte Lista de regiões.
project_name
Sim
Cadeia
Especifica o nome do projeto na região de destino.
agency_name
Sim
Cadeia
Especifica o nome da agência.
Para obter detalhes sobre como criar uma agência do IAM, consulte Como posso criar uma agência do IAM?
- Exemplo de solicitação
POST https://{Endpoint}/v1/cloudimages/465076de-dc36-4aec-80f5-ef9d8009428f/cross_region_copy
1 2 3 4 5 6 7
{ "name":"test-copy-1001-4", "description":"test", "region":"region-1", "project_name":"region-1", "agency_name":"ims_copy_image" }
Resposta
- Parâmetros de resposta
Parâmetro
Tipo
Descrição
trabalho_id
Cadeia
Especifica o ID de tarefa assíncrona.
- 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.