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/ Imagem/ Criação de uma imagem de ECS inteiro
Atualizado em 2022-11-16 GMT+08:00
Ver PDF
Compartilhar

Criação de uma imagem de ECS inteiro

Função

Essa API é usada para criar uma imagem de ECS inteiro a partir de um backup do ECS, do Cloud Server Backup Service (CSBS) ou do Cloud Backup and Recovery (CBR). A API é assíncrona. Se for chamado com sucesso, o sistema de nuvem recebe a solicitação para criar uma imagem de ECS inteiro. No entanto, você precisa usar a API de consulta de trabalho assíncrono para consultar o status de criação da imagem. Para mais detalhes, veja Consulta dos trabalhos assíncronos.

Restrições (Criação de uma imagem de ECS inteiro usando um ECS)

  • Ao criar uma imagem de ECS inteiro a partir de um ECS, certifique-se de que o ECS tenha sido configurado corretamente ou a criação da imagem pode falhar.

    Para obter detalhes, consulte Qual configuração inicial precisa ser executada no ECS, BMS, ou arquivo de imagem antes de ser usado para criar uma imagem?

  • Um ECS do Windows usado para criar uma imagem de ECS inteiro não pode ter um volume estendido, ou os dados podem ser perdidos quando os ECSs são criados a partir dessa imagem.
  • Um ECS do Linux usado para criar uma imagem de ECS inteiro não pode ter um grupo de discos ou disco lógico que contenha vários discos físicos, ou os dados podem ser perdidos quando os s são criados a partir dessa imagem.
  • Um ECS usado para criar uma imagem de ECS inteiro não pode conter um disco de Serviço de Armazenamento Dedicado Distribuído (DSS).
  • Uma imagem de ECS inteiro não pode ser exportada, publicada no Marketplace ou replicada em uma região.
  • Ao criar uma imagem de ECS inteiro a partir de um ECS do Windows, é necessário alterar a política de SAN do ECS para OnlineAll. Caso contrário, os discos do EVS conectados aos ECS criados a partir da imagem podem ficar offline.

    O Windows tem três tipos de políticas de SAN: OnlineAll, OfflineShared, e OfflineInternal.

    Tabela 1 Políticas de SAN no Windows

    Type

    Descrição

    OnlineAll

    Todos os discos recém-detectados são colocados online automaticamente.

    OfflineShared

    Indica que todos os discos em barramentos compartilháveis, como iSCSI e FC, ficam offline por padrão, enquanto os discos em barramentos não compartilháveis são mantidos online.

    OfflineInternal

    Todos os discos recentemente detectados são deixados offline.
    1. Execute cmd.exe e execute o seguinte comando para consultar a atual política de SAN do ECS:

      diskpart

    2. Execute o seguinte comando para visualizar a política de SAN do ECS:
      san
      • Se a política de SAN for OnlineAll, execute o comando exit para sair de DiskPart.
      • Se a política de SAN não for OnlineAll, vá para 3.
    3. Execute o seguinte comando para alterar a política de SAN do ECS para OnlineAll:

      san policy=onlineall

Restrições (Criação de uma imagem de ECS inteiro usando um backup de CSBS)

  • Ao criar uma imagem de ECS inteiro a partir de um backup CSBS, verifique se o ECS de origem do backup CSBS foi configurado corretamente ou a criação da imagem pode falhar.

    Para obter detalhes, consulte Qual configuração inicial precisa ser executada no ECS, BMS, ou arquivo de imagem antes de ser usado para criar uma imagem?

  • Um backup CSBS usado para criar uma imagem de ECS inteiro não pode ter discos compartilhados.
  • Somente um backup CSBS disponível pode ser usado para criar uma imagem de ECS inteiro. Um backup CSBS pode ser usado para criar apenas uma imagem de ECS inteiro.
  • Uma imagem de ECS inteiro não pode ser exportada, publicada no Marketplace, ou replicada em uma região.

Constraints (Creating a Full-ECS Image Using a CBR Backup)

  • Ao criar uma imagem de ECS inteiro a partir de um backup do CBR, verifique se o ECS de origem do backup CBR foi configurado corretamente ou a criação da imagem pode falhar.

    Para obter detalhes, consulte Qual configuração inicial precisa ser executada no ECS, BMS, ou arquivo de imagem antes de ser usado para criar uma imagem?

  • Um backup do CBR pode ser usado para criar apenas uma imagem de ECS inteiro.
  • Uma imagem de ECS inteiro criada a partir de um backup CBR pode ser compartilhada com outros locatários. No entanto, se for um backup CBR compartilhado, a imagem de ECS inteiro criada a partir dele não poderá ser compartilhada.
  • Uma imagem de ECS inteiro não pode ser exportada, publicada no Marketplace ou replicada em uma região.

URI

POST /v1/cloudimages/wholeimages/action

Solicitação

  • Parâmetros para criar uma imagem de ECS inteiro usando um ECS

    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.

    Tags

    Não

    Matriz de strings

    Lista as tags de imagem. O valor é deixado em branco por padrão.

    Use tags ou image_tags.

    image_tags

    Não

    Matriz de objetos

    Lista as tags de imagem. O valor é deixado em branco por padrão.

    Use tags ou image_tags.

    id_da_instância

    Sim

    Cadeia

    Especifica o ID do ECS. Esse parâmetro é necessário quando um ECS é usado para criar uma imagem de ECS inteiro.

    Para obter o ID do ECS, execute as seguintes operações:

    1. Acesse o console de gerenciamento.
    2. Under Computing, click em Elastic Cloud Server.
    3. Na lista do ECS, clique no nome do ECS e exiba seu ID.

    id_do_projeto_da_empresa

    Não

    Cadeia

    Especifica 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

    max_ram

    Não

    número inteiro

    Especifica a memória máxima da imagem na unidade de MB. Este parâmetro não é configurado por padrão.

    min_ram

    Não

    número inteiro

    Especifica a memória mínima da imagem na unidade de MB. O valor padrão é 0.

    vault_id

    Não

    Cadeia

    Especifica o ID de vault ao qual um ECS deve ser adicionado ou foi adicionado.

    Para criar uma imagem de ECS inteiro a partir de um ECS, crie um backup a partir do ECS e, em seguida, use o backup para criar uma imagem de ECS inteiro. Se um backup CBR for criado, vault_id será obrigatório. Se um backup CSBS for criado, vault_id será opcional.

    É possível obter o ID do vault a partir do console do CBR ou Consulta da lista de vault.
  • Parâmetros no corpo da solicitação quando um Backup do CSBS ou backup do CBR é usado para criar uma imagem de ECS inteiro

    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.

    Tags

    Não

    Matriz de strings

    Lista as tags de imagem. O valor é deixado em branco por padrão.

    Use tags ou image_tags.

    image_tags

    Não

    Matriz de objetos

    Lista as tags de imagem. O valor é deixado em branco por padrão.

    Use tags ou image_tags.

    backup_id

    Sim

    Cadeia

    Especifica o ID de backup CSBS ou o ID de backup CBR.

    Para obter o ID de backup do CSBS, execute as seguintes operações:
    1. Acesse o console de gerenciamento.
    2. Em Storage, clique em Cloud Server Backup Service.
    3. Na lista de backup, expanda os detalhes do backup para obter seu ID.
    Para obter o ID de backup do CBR, execute as seguintes operações:
    1. Acesse o console de gerenciamento.
    2. Em Storage, clique em Cloud Backup and Recovery.
    3. Na página exibida Cloud Server Backup, clique na guia Backups e obtenha o ID de backup na lista de backup.

    id_do_projeto_da_empresa

    Não

    Cadeia

    Especifica 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

    max_ram

    Não

    número inteiro

    Especifica a memória máxima da imagem na unidade de MB. Este parâmetro não é configurado por padrão.

    min_ram

    Não

    número inteiro

    Especifica a memória mínima da imagem na unidade de MB. O valor padrão é 0, indicando que a memória não está restrita.

    whole_image_type

    Não

    Cadeia

    Especifica o método de criação de uma imagem de ECS inteiro.

    • Se um backup CBR for usado para criar uma imagem de ECS inteiro, esse parâmetro será obrigatório e o valor deverá ser CBR. Nesse caso, backup_id é o ID de backup do CBR.
    • Se um backup CSBS for usado para criar uma imagem de ECS inteiro, esse parâmetro poderá ser deixado em branco e o valor padrão CSBS será usado. Nesse caso, backup_id é o ID de backup do CSBS.
  • Exemplo de solicitações
    • Criação de uma imagem de ECS inteiro a partir de um ECS 
      POST https://{Endpoint}/v1/cloudimages/wholeimages/action

      Se o parâmetro tags forem usadas:

       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
      		 
      {
       "name": "instance_whole_image",
       "description": "creating an image from an ECS",
       "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a",
       "vault_id": "de9fcf45-11b2-432c-8562-5c5428574600",
       "tags": [
           "aaa.111",
           "bbb.333",
           "ccc.444"
       ]
}

      Se o parâmetro image_tags for usado:

      1
2
3
4
5
6
7
      		 
      {
       "name": "instance_whole_image",
       "description": "creating an image from an ECS",
       "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a",
       "vault_id": "de9fcf45-11b2-432c-8562-5c5428574600",
       "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]
}
    • Criação de uma imagem de ECS inteiro a partir de um backup Backup do CSBS ou CBR 
      POST https://{Endpoint}/v1/cloudimages/wholeimages/action

      Se o parâmetro tags forem usadas:

       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
      		 
      {
     "name": "backup_whole_image",
     "description": "Creating a full-ECS image from a CBR backup",
     "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3",
     "whole_image_type": "CBR",
     "tags": [
           "aaa.111",
           "bbb.333",
           "ccc.444"
      ]
}

      Se o parâmetro image_tags for usado:

      1
2
3
4
5
6
7
      		 
      {
     "name": "backup_whole_image",
     "description": "Creating a full-ECS image from a CBR backup",
     "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3",
     "whole_image_type": "CBR",
     "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]
}

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": "4010a32b5f909853015f90aaa24b0015"
}

Valores retornados

  • Normal

    200

  • Anormal

    Valor retornado

    Descrição

    400 Solicitação inválida

    Erro na solicitação. Para obter detalhes sobre o código de erro retornado, 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: Imagem