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 (recomendado)/ Gerenciamento de ciclo de vida/ Modificação de um ECS

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

Ver PDF

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