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/ Elastic Cloud Server/ Referência de API/ As API da Nova do OpenStack/ Gerenciamento de status/ Criação de uma imagem usando um ECS

Atualizado em 2022-11-08 GMT+08:00

Criação de uma imagem usando um ECS

Função

Esta API é usada para criar uma imagem usando um ECS. Após a criação, você pode usar esta imagem para criar os ECS.

As imagens criadas usando um ECS são armazenadas em nós de armazenamento como instantâneos.

Essa API é uma API nativa do OpenStack que não se aplica às imagens na plataforma de nuvem pública.

Para criar uma imagem de disco do sistema ou uma imagem de disco de dados, use a API do IMS (POST /v2/cloudimages/action). Para obter detalhes, consulte "Criando uma imagem" em Referência de API do Image Management Service.
Para criar uma imagem ECS completa, use a API do IMS (POST /v1/cloudimages/wholeimages/action). Para obter detalhes, consulte "Criando uma imagem completa do ECS" em Referência de API do Image Management Service.

Restrições

Um ECS no estado de erro não pode ser usado para criar uma imagem.
Se uma imagem criada usando um ECS é usada para criar um novo ECS, o novo ECS deve estar localizada na mesma AZ que o ECS original.
Depois que uma imagem criada usando um ECS é excluída, os instantâneos associados não serão excluídos automaticamente (essa função é implementada pelo OpenStack nativo). Você deve excluir manualmente esses instantâneos.
A imagem criada usando um ECS não pode ser usada para criar discos de dados.
As imagens criadas usando a API descrita nesta seção (URI: POST /v2/{project_id}/servers/{server_id}/action or POST /v2.1/{project_id}/servers/{server_id}/action) não podem ser exportados para intervalos OBS. Se essas imagens precisarem ser exportadas, use a API do IMS (POST /v2/cloudimages/action). Para obter detalhes, consulte "Criando uma imagem" em Referência de API do Image Management Service.

URI

POST /v2.1/{project_id}/servers/{server_id}/action

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.
server_id	Sim	Especifica a ID de ECS.

Solicitação

Tabela 2 descreve os parâmetros de solicitação.

**Tabela 2** Parâmetros de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
createImage	Sim	Object	Especifica a imagem criada usando ECS. Para mais detalhes, consulte Tabela 3.

**Tabela 3** descrição do campo **createImage**
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	Especifica o nome da imagem com um comprimento maior que 0 bytes e menor que 243 bytes.
metadata	Não	Object	Especifica o atributo de imagem com um comprimento maior que 0 bytes e menor que 255 bytes.

Resposta

Parâmetro	Obrigatório	Tipo	Descrição
Location	Sim	String	Especifica a URL local da imagem, que é retornada no cabeçalho da solicitação. Este parâmetro não é suportado no microversion 2.44 e posterior.
image_id	Sim	String	Especifica o UUID da imagem. Este parâmetro é suportado no microversion 2.45 e posterior.

Parâmetro

Obrigatório

Tipo

Descrição

Location

Sim

String

Especifica a URL local da imagem, que é retornada no cabeçalho da solicitação.

Este parâmetro não é suportado no microversion 2.44 e posterior.

image_id

Sim

String

Especifica o UUID da imagem.

Este parâmetro é suportado no microversion 2.45 e posterior.

Exemplo de solicitação

POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/action

{
   "createImage" : {
        "name" : "new-image-name",
        "metadata": {
            "ImageType": "Gold",
            "ImageVersion": "2.0"
        }
    }
}