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.
Atualizado em 2022-11-08 GMT+08:00

Modificação de Informações de ECS

Função

Essa API é usada para modificar as informações do ECS. Apenas o nome e a descrição de um podem ser modificados.

URI

PUT /v2.1/{project_id}/servers/{server_id}

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

server

Sim

Object

Especifica a estrutura de dados do ECS. Para mais detalhes, consulte Tabela 3.

Tabela 3 descrição do campo server

Parâmetro

Obrigatório

Tipo

Descrição

name

Não

String

Especifica o nome do ECS modificado.

O comprimento é maior que 0 e menor que 256

description

Não

String

Descreve o ECS. O valor contém um máximo de 255 bytes.

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

Resposta

Tabela 4 descreve os parâmetros de resposta.

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

server

Object

Especifica as informações do ECS. Para mais detalhes, consulte Tabela 5.

Tabela 5 descrição do campo server

Parâmetro

Tipo

Descrição

tenant_id

String

Especifica o inquilino ou ID do projeto.

image

String

Especifica o ID da imagem.

accessIPv4

String

Reservado

addresses

Object

Especifica as informações de rede atribuídas do ECS.

A estrutura é Map<String, Object>.

Para mais detalhes, consulte Tabela 6.

metadata

Object

Especifica os metadados do ECS.

accessIPv6

String

Reservado

created

String

Especifica a hora em que o ECS foi criado. Essas horas estão no formato "2019-05-22T03:19:19Z".

hostId

String

Especifica a ID do host do ECS.

flavor

Object

Especifica a variante de ECS. Para mais detalhes, consulte Tabela 7.

OS-DCF:diskConfig

String

Especifica o modo de configuração do disco. Este é um atributo estendido. Esse campo é válido para o ECS iniciado usando uma imagem.

user_id

String

Especifica a ID do usuário ao qual um ECS pertence.

name

String

Especifica o nome modificado do ECS.

progress

Integer

Reservado

links

Array of Object

Especifica links de atalho do ECS. Para mais detalhes, consulte Tabela 8.

id

String

Especifica a ID exclusiva de um ECS.

updated

String

Especifica a hora em que o ECS foi atualizado pela última vez.

Essas horas estão no formato "2019-05-22T03:19:19Z".

locked

Boolean

Especifica o status de bloqueio do ECS, que é True quando o ECS está bloqueado e False quando o ECS está desbloqueado.

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

description

String

Descreve o ECS.

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

tags

Array of strings

Especifica as marcas ECS.

Este parâmetro é suportado no microversion 2.26 e posterior. Se a microversão não for usada para consulta, a resposta não conterá o campo tags.

As funções de tag foram atualizadas na nuvem pública. Após a atualização, os valores de tag retornados pelo sistema estão em conformidade com as seguintes regras:
  • A chave e o valor de uma tag são conectados usando um sinal de igual (=), por exemplo, key=value.
  • Se o valor estiver vazio, somente a chave é retornada.
  • A chave e o valor de uma tag são conectados usando um sinal de igual (=), por exemplo, key=value.
  • Se o valor estiver vazio, apenas a chave é retornada.

status

String

Especifica o status do ECS.

Opções:

ACTIVE, BUILD, ERROR, HARD_REBOOT, MIGRATING, REBOOT, RESIZE, REVERT_RESIZE, SHELVED, SHELVED_OFFLOADED, SHUTOFF, UNKNOWN, e VERIFY_RESIZE

Para mais detalhes, consulte Estados de ECS.

Tabela 6 Estrutura de dados da rede que um ECS acessa

Parâmetro

Tipo

Descrição

addr

String

Especifica o endereço IP.

version

Integer

Especifica o tipo de um endereço IP. O valor deste parâmetro pode ser 4 ou 6.

  • 4: O tipo do endereço IP é IPv4.
  • 6: O tipo do endereço IP é IPv6.
Tabela 7 descrição do campo de flavor

Parâmetro

Tipo

Descrição

id

String

Especifica a ID de ECS.

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

links

Array of objects

Especifica links de atalho para tipos de ECS. Para mais detalhes, consulte Tabela 8.

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

vcpus

Integer

Especifica o número das vCPU na variante de ECS.

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

ram

Integer

Especifica o tamanho da memória (MB) na variante de ECS.

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

disk

Integer

Especifica o tamanho do disco do sistema na variante de ECS. O valor 0 indica que o tamanho do disco não é limitado.

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

ephemeral

Integer

Reservado

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

swap

Integer

Reservado

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

original_name

String

Especifica o nome do variante de ECS.

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

extra_specs

Object

Indica um campo de sabor estendido. Para obter detalhes, consulte Descrição do Campo os_extra_specs (flavor).

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

Tabela 8 descrição do campo links

Parâmetro

Tipo

Descrição

rel

String

Especifica o nome do marcador do link de atalho.

href

String

Especifica o link de atalho.

Exemplo de solicitação

PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}
{
    "server": {
        "name": "new-server-test"
    }
}

Exemplo de resposta

{
  "server": {
    "tenant_id": "7910a6e50b80402ba028c8d96c1b31fe",
    "image": "",
    "accessIPv4": "",
    "addresses": {
      "03be5c1e-e05d-4905-a105-c3bd9b730bdc": [
        {
          "addr": "192.168.0.72",
          "version": 4
        }
      ]
    },
    "metadata": {},
    "accessIPv6": "",
    "created": "2018-05-17T03:15:48Z",
    "hostId": "7dc82f6b1d406200fc63e395cf4829cbffcb49de0e9c75c5773f201f",
    "flavor": {
      "links": [
        {
          "rel": "bookmark",
          "href": "https://None/7910a6e50b80402ba028c8d96c1b31fe/flavors/c3.1U1G"
        }
      ],
      "id": "c3.1U1G"
    },
    "OS-DCF:diskConfig": "MANUAL",
    "user_id": "d698a78532ca430f8daec1858f2b500e",
    "name": "new-server-test",
    "progress": 0,
    "links": [
      {
        "rel": "self",
        "href": "https://None/v2/7910a6e50b80402ba028c8d96c1b31fe/servers/1a19ef4f-be0a-4526-bf2f-14b4464d536a"
      },
      {
        "rel": "bookmark",
        "href": "https://None/7910a6e50b80402ba028c8d96c1b31fe/servers/1a19ef4f-be0a-4526-bf2f-14b4464d536a"
      }
    ],
    "id": "1a19ef4f-be0a-4526-bf2f-14b4464d536a",
    "updated": "2018-05-21T00:36:27Z",
    "status": "ACTIVE"
  }
}

Valores retornados

Consulte Valores retornados para solicitações gerais.