Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Elastic Cloud Server/ Referência de API/ As API (recomendado)/ Gerenciamento de status/ Alteração de um SO de ECS (usando uma imagem sem o Cloud-Init instalado)
Atualizado em 2022-11-08 GMT+08:00

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

Tabela 1 descreve os parâmetros no URI.
Tabela 1 Descrição do parâmetro

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

Tabela 2 descreve os parâmetros de solicitação.
Tabela 2 Parâmetros de 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.

Tabela 3 descrição do campo os-change

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:

  • 8 a 26 caracteres
  • A senha deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, minúsculas, dígitos e caracteres especiais (!@$%^-_=+[{}]:,./?~#*).
NOTA:
  • Você só pode fazer login em um ECS Windows usando um nome de usuário e uma senha, e a senha não pode conter o nome de usuário, o nome de usuário inverso ou mais de dois caracteres na mesma sequência em que aparecem no nome de usuário.
  • Ou adminpass ou keyname estão vazios.
  • Ou adminpass ou keyname está definido.

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

Consulte Valores retornados para solicitações gerais.

Códigos de erro

Consulte Códigos de erro.