CreateDynamicTagGroup - : Central de Documentação do Alibaba Cloud

Esta operação está disponível para Elastic Compute Service (ECS), ApsaraDB RDS e Server Load Balancer (SLB).

Este tópico apresenta um exemplo de criação de grupo de aplicativos para recursos cuja chave de tag é ecs_instance. Neste exemplo, o grupo de contatos de alerta do grupo de aplicativos é ECS_Group.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateDynamicTagGroup	Operação a ser executada. Defina o valor como CreateDynamicTagGroup.
TagKey	String	Sim	ecs_instance	Chaves de tag dos recursos de nuvem. Para mais informações sobre como obter chaves de tag, consulte DescribeTagKeyList.
ContactGroupList.N	String	Sim	ECS_Group	Grupos de contatos de alerta. Valores válidos de N: 1 a 100. As notificações de alerta do grupo de aplicativos são enviadas aos contatos pertencentes aos grupos especificados. Um grupo de contatos de alerta pode conter um ou mais contatos. Para criar contatos e grupos de contatos de alerta, consulte PutContact e PutContactGroup. Para obter grupos de contatos de alerta, consulte DescribeContactGroupList.
MatchExpress.N.TagValueMatchFunction	String	Não	contains	Método usado para corresponder aos valores de tag dos recursos de nuvem. Neste exemplo, defina o valor de N como 1. Valores válidos: contains: contém startWith: começa com um prefixo endWith: termina com um sufixo notContains: não contém equals: igual a all: corresponde a todos Nota Ao definir o parâmetro `MatchExpress.N.TagValueMatchFunction`, também defina o parâmetro `MatchExpress.N.TagValue`.
MatchExpress.N.TagValue	String	Não	instance	Valores de tag dos recursos de nuvem. Neste exemplo, defina o valor de N como 1. Nota Ao definir o parâmetro `MatchExpress.N.TagValueMatchFunction`, também defina o parâmetro `MatchExpress.N.TagValue`.
MatchExpress.N.TagName	String	Não	appname	Chaves das tags usadas para criar o grupo de aplicativos. Se uma chave especificada estiver associada a vários recursos, aqueles com o mesmo par chave-valor serão adicionados ao mesmo grupo.
TagRegionId	String	Não	cn-hangzhou	ID da região à qual as tags pertencem.
EnableSubscribeEvent	Boolean	Não	true	Define se o grupo de aplicativos assina automaticamente as notificações de eventos. Caso ocorram eventos com nível de severidade crítico ou de aviso nos recursos do grupo, o CloudMonitor envia notificações de alerta. Valores válidos: true: O grupo de aplicativos assina automaticamente as notificações de eventos. false (valor padrão): O grupo de aplicativos não assina automaticamente as notificações de eventos.
EnableInstallAgent	Boolean	Não	true	Define se o agente do CloudMonitor é instalado automaticamente no grupo de aplicativos. O CloudMonitor usa este parâmetro para determinar a instalação automática do agente nos hosts do grupo. Valores válidos: true: O agente do CloudMonitor é instalado automaticamente. false (valor padrão): O agente do CloudMonitor não é instalado automaticamente.
MatchExpressFilterRelation	String	Não	and	Relação entre as expressões condicionais para os valores de tag dos recursos de nuvem. Valores válidos: and (valor padrão) or
TemplateIdList.N	String	Não	70****	IDs dos modelos de alerta. Para mais informações sobre como consultar IDs de modelos de alerta, consulte DescribeMetricRuleTemplateList.

Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	200	Código de status HTTP. Nota O código de status 200 indica que a chamada foi bem-sucedida.
Message	String	The specified resource is not found.	Mensagem de erro.
RequestId	String	84AC6F0B-7945-466A-AA44-99BB5A561F86	ID da solicitação.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. Valores válidos: true: A chamada foi bem-sucedida. false: A chamada falhou.
Id	String	2534dc0a-e3e5-4ae1-a2fc-75ef166c****	ID da regra de correspondência de tags.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateDynamicTagGroup
&TagKey=ecs_instance
&ContactGroupList.1=ECS_Group
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDynamicTagGroupResponse>
	<RequestId>84AC6F0B-7945-466A-AA44-99BB5A561F86</RequestId>
	<Id>2534dc0a-e3e5-4ae1-a2fc-75ef166c****</Id>
	<Code>200</Code>
	<Success>true</Success>
</CreateDynamicTagGroupResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "84AC6F0B-7945-466A-AA44-99BB5A561F86",
  "Id" : "2534dc0a-e3e5-4ae1-a2fc-75ef166c****",
  "Code" : "200",
  "Success" : true
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	ResourceNotFound	The specified resource is not found.	Mensagem de erro retornada quando o recurso especificado não é encontrado.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.