Alteração de um SO de ECS (usando uma imagem sem o Cloud-Init instalado)
Função
Essa API é usada para alterar o sistema operacional de um ECS.
Depois que essa API é chamada, o sistema desinstala o disco do sistema, usa a nova imagem para criar um disco do sistema e a anexa ao ECS. Desta forma, o sistema operacional é alterado.
Esta API suporta as imagens sem Cloud-Init ou Cloudbase-Init instalado. Caso contrário, use a API descrita em Alteração de um SO de ECS (usando uma imagem com o Cloud-Init instalado).
Restrições
- Somente um ECS com um disco do sistema suporta a alteração do sistema operacional.
- Você não tem permissão para realizar outras operações ao alterar o sistema operacional. Caso contrário, a alteração do sistema operacional falhará.
URI
POST /v1/{project_id}/cloudservers/{server_id}/changeos
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 |
|---|---|---|---|
os-change | Sim | Object | Altera o sistema operacional de um ECS. Para mais detalhes, consulte Tabela 3. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
adminpass | Não | String | Especifica a senha inicial do administrador do ECS. O nome de usuário do administrador do Windows é Administrator e o nome de usuário do administrador do Linux é root. Requisitos de complexidade de senha:
NOTA:
|
keyname | Não | String | Especifica o nome da chave. As chaves podem ser criadas usando a API de criação de chaves (Criação e importação de um par de chaves SSH) ou obtidas usando a API de consulta de chaves SSH (Consulta de pares de chaves SSH). |
userid | Não | String | Especifica o ID do usuário. Quando o parâmetro keyname está sendo especificado, o valor deste parâmetro é usado preferencialmente. Se esse parâmetro for deixado em branco, o ID do usuário no token será usado por padrão. |
imageid | Sim | String | Especifica a ID da nova imagem no formato UUID. Você pode obter o ID da imagem no console ou seguindo as instruções fornecidas em "Consulta de imagens" na Referência de API do Image Management Service. |
mode | Não | String | Especifica se o ECS suporta a alteração do sistema operacional quando o ECS estiver em execução. Se o valor do parâmetro for withStopServer, o ECS suporte ao OS mudará quando o ECS estiver em execução. Nesse caso, o sistema pára automaticamente o ECS antes de alterar seu sistema operacional. |
Resposta
Para mais detalhes, consulte Respostas (Tarefa).
Exemplo de solicitação
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/changeos {
"os-change": {
"keyname": "KeyPair-350b",
"userid": "7e25b1da389f4697a79df3a0e5bd494e",
"imageid": "e215580f-73ad-429d-b6f2-5433947433b0"
}
} Exemplo de resposta
Consulte Respostas (Tarefa).
Valores retornados
Códigos de erro
Consulte Códigos de erro.

