Cria uma notificação de evento para um grupo de dimensionamento enviar mensagens ao CloudMonitor, a tópicos do MNS ou a filas do MNS quando ocorrem eventos de dimensionamento ou alterações de recursos.
Cria uma notificação de evento que envia mensagens ao CloudMonitor, a tópicos do MNS ou a filas do MNS sempre que houver eventos de dimensionamento ou mudanças em recursos. Para alterar uma notificação existente, chame ModifyNotificationConfiguration. Não é possível modificar o método de notificação após a criação.
Observações de uso
O Auto Scaling envia notificações ao CloudMonitor ou ao MNS quando os eventos de dimensionamento ou as alterações de recursos especificados ocorrem em um grupo de dimensionamento.
Cada notificação de evento em um grupo de dimensionamento deve utilizar um destinatário exclusivo (instância do CloudMonitor, tópico do MNS ou fila do MNS).
Depuração
Chame esta operação no OpenAPI Explorer para gerar automaticamente exemplos de código SDK.
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Sim |
CreateNotificationConfiguration |
Defina como CreateNotificationConfiguration. |
|
ScalingGroupId |
String |
Sim |
asg-bp1igpak5ft1flyp**** |
ID do grupo de dimensionamento. |
|
NotificationArn |
String |
Sim |
acs:mns:cn-beijing:161456884340**:queue/modifyLifecycleHo** |
ARN (Alibaba Cloud Resource Name) do destinatário da notificação. Formatos compatíveis:
Variáveis:
|
|
NotificationType.N |
String |
Não |
AUTOSCALING:SCALE_OUT_SUCCESS |
Tipos de notificação para eventos de dimensionamento e alterações de recursos. N varia de 1 a 8. Especifique vários valores em uma lista repetida. Chame DescribeNotificationTypes para consultar os valores válidos. |
|
RegionId |
String |
Não |
cn-beijing |
ID da região do grupo de dimensionamento. |
|
TimeZone |
String |
Não |
UTC+8 |
Fuso horário da notificação, especificado como um deslocamento UTC. Exemplos: UTC+8, UTC-7. |
|
MessageEncoding |
String |
Não |
PlainText |
Formato de codificação do conteúdo da notificação. Valores válidos:
Valor padrão: Base64. Nota
Aplica-se apenas a notificações do MNS. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
ID da solicitação. |
Exemplos
Exemplo de solicitação
http(s)://ess.aliyuncs.com/?Action=CreateNotificationConfiguration
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&NotificationArn=acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo****
&NotificationType=["AUTOSCALING:SCALE_OUT_SUCCESS"]
&RegionId=cn-beijing
&<Common request parameters>
Exemplo de resposta
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateNotificationConfigurationResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateNotificationConfigurationResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
Códigos de erro
Todos os códigos de erro estão listados na Central de Erros.
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
InvalidNotificationArn |
The specified parameter notificationArn is invalid. |
O NotificationArn especificado é inválido. |
|
400 |
InvalidNotificationTypes |
The specified notification type is invalid. |
O NotificationType.N especificado é inválido. |
|
400 |
NotificationConfigurationExist |
The specified notification configuration already exist for the scalingGroup. |
A notificação de evento especificada já existe no grupo de dimensionamento. |
|
400 |
NotificationConfigurationQuotaExceed.ForScalingGroup |
NotificationConfiguration num exceed for the specified scalingGroup. |
O número de notificações configuradas para o grupo de dimensionamento excede a cota. |
|
400 |
QueueNotExist |
The specified queue queuename does not exist. |
A fila do MNS especificada não existe. |
|
400 |
TopicNotExist |
The specified topic topicname does not exist. |
O tópico do MNS especificado não existe. |
|
400 |
UnsupportedNotificationType.CurrentRegion |
The NotificationType is not supported in the special region which scaling group belongs to. |
Este método de notificação não é compatível com a região atual. |
|
400 |
InvalidParameter.TimeZone |
The specified parameter TimeZone is not valid. |
O parâmetro TimeZone especificado é inválido. |
|
404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
O grupo de dimensionamento especificado não existe. |