Parar um BMS (API OpenStack nativo)
Função
Essa API é usada para parar um único BMS. Para parar vários BMSs, você pode usar a API de Parar os BMSs.
Restrições
- O atributo do BMS OS-EXT-STS:vm_state (status do BMS) deve estar active ou com error.
- Atualmente, apenas parada forçada é suportada.
URI
POST /v2.1/{project_id}/servers/{server_id}/action
A Tabela 1 lista os parâmetros.
Parâmetro |
Obrigatório |
Descrição |
|---|---|---|
project_id |
Sim |
Especifica o 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 o ID de BMS. Você pode obter o ID do BMS no console do BMS ou usando a API do Consulta de BMSs (API OpenStack nativo). |
Solicitação
- Parâmetros de solicitação
Parâmetro
Obrigatório
Tipo
Descrição
os-stop
Sim
Object
Especifica a operação de parar o BMS. Para mais detalhes, consulte Tabela 2.
Tabela 2 Descrição da estrutura de dados do campo os-stop Parâmetro
Obrigatório
Tipo
Descrição
type
Não
String
Especifica o tipo de operação de interrupção do BMS.
- SOFT: parada normal do BMS
- HARD: parada forçada do BMS
NOTA:
Atualmente, esse parâmetro é inválido. Todas as operações de parada do BMS são de parada forçada.
- Exemplo de solicitação
1POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/action
1 2 3
{ "os-stop": {} }
Resposta
N/D
Valores retornados
Valores retornados |
Descrição |
|---|---|
204 |
O servidor processou a solicitação, mas não retornou nenhum conteúdo. |
Para obter detalhes sobre outros valores retornados, consulte Códigos de status.
Códigos de erro
Consulte Códigos de erro.
