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 ciclo de vida/ Modificação de Informações de ECS

Atualizado em 2025-08-25 GMT+08:00

Ver PDF

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"
  }
}