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.
