Modificação dos ECS em um lote
Função
Esta API é usada para modificar os ECS em um lote.
Somente os nomes de ECS podem ser alterados em um lote e o número máximo é 1000 por vez.
URI
PUT /v1/{project_id}/cloudservers/server-name
Tabela 1 lista os parâmetros de URI.
|
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. |
Solicitação
Tabela 2 descreve os parâmetros de solicitação.
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|---|---|---|---|
|
name |
String |
Sim |
Especifica o nome alterado dos ECS. As regras são as seguintes: Consiste em um máximo de 64 caracteres, incluindo letras maiúsculas, letras minúsculas, dígitos, (-) hífens, sublinhados (_), e pontos (.). Depois de alterar nomes de ECS em um lote, o sistema não adiciona automaticamente um sufixo digital aos nomes alterados. Por exemplo, existem os três ECS, test_0001, test_0002, e test_0003. Depois que seus nomes são alterados para se develop em um lote, seus nomes alterados são todos develop. |
|
dry_run |
Boolean |
Não |
Especifica se deve verificar a solicitação e alterar os nomes do ECS. true: indica que apenas a solicitação de alteração de nome é enviada e os nomes dos ECS não serão alterados. Os itens de verificação incluem parâmetros obrigatórios, formato de solicitação e restrições de serviço. Se a verificação falhar, o sistema retornará um erro. Se o resultado da verificação for o esperado, o sistema responderá corretamente. Consulte Respostas (Operação em lote). false: indica que a solicitação de alteração de nome é enviada e os nomes de ECS serão alterados se o resultado da verificação for o esperado. O valor padrão é false. |
|
servers |
Array of objects |
Sim |
Especifica os IDs dos ECS de destino. Para obter detalhes, consulte Tabela 3. |
Resposta
Consulte Respostas (Operação em lote).
Exemplo de solicitação
PUT https://{endpoint}/v1/{project_id}/cloudservers/server-name
{
"name": "new-server-name",
"dry_run": false,
"servers": [
{
"id":"260a0917-f7df-4b25-93ac-950da6c6b5d6"
},
{
"id":"f6d8df1a-e257-48e2-b617-1dd92ced8c20"
}
]
}
Exemplo de resposta
Consulte Respostas (Operação em lote).
Valores retornados
Códigos de erro
Consulte Códigos de erro.
