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 um ECS

Função

Essa API é usada para modificar informações do ECS. Somente o nome, a descrição e o nome de host de um ECS podem ser modificados no momento.

Restrições

Depois que o nome de host de um ECS for alterado, você precisará reiniciar o ECS para que a configuração tenha efeito.

URI

PUT /v1/{project_id}/cloudservers/{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 valor do parâmetro consiste em 1 a 64 caracteres, incluindo letras, dígitos, sublinhados (_), hífens e pontos (.).

description

Não

String

Descreve o ECS.

O valor consiste de 0 a 85 caracteres e não pode conter colchetes (<>).

hostname

Não

String

Especifica o nome de host do ECS.

O nome consiste em 1-64 caracteres. Ele pode ser segmentado usando períodos de (.). Somente letras, dígitos e hífens (-) são permitidos em cada segmento. Um nome não pode conter (.) de pontos consecutivos ou (-) de hífens e não pode iniciar ou terminar com um (.) de ponto ou (-) de hífen. Além disso, as combinações de (.-) e (-.) não são permitidas.

Resposta

Tabela 4 descreve os parâmetros de resposta.

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

server

Object

Especifica o 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. Este campo é válido para o ECS início do uso de uma imagem.

user_id

String

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

name

String

Especifica o nome do ECS modificado.

progress

Integer

Reservado

links

Array of Object

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

id

String

Especifica o ID exclusivo 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 do 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 tags de 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.

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.

OS-EXT-SRV-ATTR:hostname

String

Especifica o nome de host do 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.

links

Array of objects

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

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

Fornece o link de atalho.

Exemplo de solicitação

PUT  https://{endpoint}/v1/{project_id}/cloudservers/{server_id}
{
    "server": {
        "name": "new-server-test"
    }
}

Exemplo de resposta

{
  "server": {
    "tenant_id": "66c860cb130b465fbafcdee43fb09c64",
    "image": "",
    "accessIPv4": "",
    "addresses": {
      "01d7aef8-442b-408e-b82f-13afff51e4e4": [
        {
          "addr": "192.168.26.22",
          "version": 4
        }
      ]
    },
    "metadata": {
      "virtual_env_type": "FusionCompute"
    },
    "description": "",
    "accessIPv6": "",
    "created": "2019-04-25T11:52:53Z",
    "hostId": "57d278e7c53d07cd34fad3ba4fdc9f3d779017d0879726d83b45a22a",
    "OS-EXT-SRV-ATTR:hostname": "new-test-hostname",
    "flavor": {
      "links": [
        {
          "rel": "bookmark",
          "href": "https://None/66c860cb130b465fbafcdee43fb09c64/flavors/s2.large.2"
        }
      ],
      "id": "s2.large.2"
    },
    "OS-DCF:diskConfig": "MANUAL",
    "user_id": "f88581d53be64716a985c66ca28c75f6",
    "name": "new-test-hostname",
    "progress": 0,
    "links": [
      {
        "rel": "self",
        "href": "https://None/v2/66c860cb130b465fbafcdee43fb09c64/servers/24930df0-db4c-4a8b-8914-d0bd558564b0"
      },
      {
        "rel": "bookmark",
        "href": "https://None/66c860cb130b465fbafcdee43fb09c64/servers/24930df0-db4c-4a8b-8914-d0bd558564b0"
      }
    ],
    "id": "24930df0-db4c-4a8b-8914-d0bd558564b0",
    "updated": "2019-04-28T08:15:36Z",
    "status": "ACTIVE"
  }
}

Valores retornados

Consulte Valores retornados para solicitações gerais.

Códigos de erro

Consulte Códigos de erro.