Habilitação de notificação para um grupo de AS
Função
Essa API é usada para habilitar a notificação para um grupo de AS. Cada vez que essa API é chamada, o grupo de AS adiciona um tópico e um cenário de notificação. Cada grupo de AS suporta até cinco tópicos. O tópico de notificação é pré-configurado e inscrito por você na SMN. Quando a rede ativa está em conformidade com o cenário de notificação que corresponde ao tópico de notificação, o grupo de AS envia uma notificação aos pontos de extremidade da assinatura.
URI
PUT /autoscaling-api/v1/{project_id}/scaling_notification/{scaling_group_id}
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
Especifica o ID do projeto. |
scaling_group_id |
Sim |
String |
Especifica o ID do grupo de AS. |
Mensagem de solicitação
- Parâmetros de solicitação
Tabela 2 Parâmetros de solicitação Parâmetro
Obrigatório
Tipo
Descrição
topic_urn
Sim
String
Especifica um tópico exclusivo na SMN.
topic_scene
Sim
Array of strings
Especifica um cenário de notificação, que pode ser um dos seguintes:
- SCALING_UP: indica que a capacidade está expandida.
- SCALING_UP_FAIL: indica que a expansão da capacidade falhou.
- SCALING_DOWN: indica que a capacidade é reduzida.
- SCALING_DOWN_FAIL: indica que a redução da capacidade falhou.
- SCALING_GROUP_ABNORMAL: indica que ocorreu uma exceção no grupo de AS.
- Exemplo de solicitação
Este exemplo mostra como ativar a notificação com topic_urn urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh para o grupo de AS com ID e5d27f5c-dd76-4a61-b4bc-a67c5686719a. Após a configuração, uma notificação será enviada quando a expansão de capacidade for bem-sucedida ou falhar, a redução de capacidade for bem-sucedida ou falhar ou ocorrer um erro no grupo de AS.
PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_notification/e5d27f5c-dd76-4a61-b4bc-a67c5686719a { "topic_urn": "urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh", "topic_scene": [ "SCALING_UP","SCALING_UP_FAIL","SCALING_DOWN","SCALING_DOWN_FAIL","SCALING_GROUP_ABNORMAL" ] }
Mensagem de resposta
- Parâmetros de resposta
Tabela 3 Parâmetros de resposta Parâmetro
Tipo
Descrição
topic_urn
String
Especifica um tópico exclusivo na SMN.
topic_scene
Array of strings
Especifica um cenário de notificação, que pode ser um dos seguintes:
- SCALING_UP: indica que a capacidade está expandida.
- SCALING_UP_FAIL: indica que a expansão da capacidade falhou.
- SCALING_DOWN: indica que a capacidade é reduzida.
- SCALING_DOWN_FAIL: indica que a redução da capacidade falhou.
- SCALING_GROUP_ABNORMAL: indica que ocorreu uma exceção no grupo de AS.
topic_name
String
Especifica o nome do tópico na SMN.
- Exemplo de resposta
{ "topic_urn": "urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh", "topic_scene": [ "SCALING_UP","SCALING_UP_FAIL","SCALING_DOWN","SCALING_DOWN_FAIL","SCALING_GROUP_ABNORMAL" ], "topic_name": "gsh" }
Valores retornados
- Normal
- Anormal
Valores retornados
Descrição
400 Bad Request
O servidor falhou ao processar a solicitação.
401 Unauthorized
Você deve digitar o nome de usuário e a senha para acessar a página solicitada.
403 Forbidden
Você está proibido de acessar a página solicitada.
404 Not Found
O servidor não conseguiu encontrar a página solicitada.
405 Method Not Allowed
Você não tem permissão para usar o método especificado na solicitação.
406 Not Acceptable
A resposta gerada pelo servidor não poderia ser aceita pelo cliente.
407 Proxy Authentication Required
Você deve usar o servidor proxy para autenticação para que a solicitação possa ser processada.
408 Request Timeout
A solicitação expirou o tempo limite.
409 Conflict
A solicitação não pôde ser processada devido a um conflito.
500 Internal Server Error
Falhou ao concluir a solicitação porque ocorre um erro de serviço interno.
501 Not Implemented
Falhou ao concluir a solicitação porque o servidor não suporta a função solicitada.
502 Bad Gateway
Falhou ao concluir a solicitação porque a solicitação é inválida.
503 Service Unavailable
Falhou ao concluir a solicitação porque o sistema não está disponível.
504 Gateway Timeout
Ocorreu um erro de tempo limite de gateway.
Códigos de erro
Consulte Códigos de erro.