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}
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
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
server |
Sim |
Object |
Especifica a estrutura de dados do ECS. Para mais detalhes, consulte Tabela 3. |
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.
Parâmetro |
Tipo |
Descrição |
---|---|---|
server |
Object |
Especifica as informações do ECS. Para mais detalhes, consulte Tabela 5. |
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:
|
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. |
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.
|
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. |
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" } }