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}
| 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 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.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| server | Object | Especifica o 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. 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:
|
| 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. |
| 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. |
| links | Array of objects | Especifica links de atalho para tipos de ECS. Para mais detalhes, consulte Tabela 8. |
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
Códigos de erro
Consulte Códigos de erro.
