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> FunctionGraph> Referência de API> As API> Gatilhos de função> Criação de um gatilho

Atualizado em 2022-11-08 GMT+08:00

Ver PDF

Criação de um gatilho

Função

Essa API é usada para criar um gatilho.

Os tipos de gatilho incluem timer, APIG, CTS, DDS, DMS, DIS, LTS, OBS, SMN e Kafka.
Por padrão, os gatilhos DDS e Kafka estão no estado DESATIVADO e outros gatilhos estão no estado ACTIVE.
Apenas os gatilhos timer, DDS, DMS, Kafka e LTS podem ser desativados.

URI

POST /v2/{project_id}/fgs/triggers/{function_urn}

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto.
function_urn	Sim	String	o URN da função. Para obter detalhes, consulte as descrições do modelo de função.

Parâmetros de solicitação

**Tabela 2** Parâmetros de cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é um token.

**Tabela 3** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
trigger_type_code	Sim	String	Tipo de gatilho. TIMER APIG CTS: Habilite o CTS primeiro. DDS: Configure uma VPC para a função primeiro. DMS: Configure uma agência de DMS primeiro. DIS: Configure uma agência DIS primeiro. LTS: Configure uma agência LTS primeiro. OBS KAFKA Valores de enumeração: TIMER APIG CTS DDS DMS DIS LTS OBS SMN KAFKA RABBITMQ DEDICATEDGATEWAY OPENSOURCEKAFKA APIC GAUSSMONGO EVENTGRID
trigger_status	Não	String	Status do gatilho. Opções: ACTIVE e DISABLED. Valores de enumeração: ACTIVE DISABLED
event_type_code	Não	String	Código da mensagem.
event_data	Sim	Map<String,String>	Estrutura do evento.

Parâmetros de resposta

Código de estado: 201

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
trigger_id	String	Identificação de gatilho.
trigger_type_code	String	Tipo de gatilho. TIMER APIG CTS DDS DMS DIS LTS OBS SMN KAFKA Valores de enumeração: TIMER APIG CTS DDS DMS DIS LTS OBS SMN KAFKA RABBITMQ DEDICATEDGATEWAY OPENSOURCEKAFKA APIC GAUSSMONGO EVENTGRID
trigger_status	String	Status do gatilho. ACTIVE: O gatilho está ativado. Desativado: O gatilho está desativado. Valores de enumeração: ACTIVE DISABLED
event_data	Object	Evento de origem de gatilho.
last_updated_time	String	Hora da última atualização.
created_time	String	Hora em que o gatilho foi criado.

Código de estado: 400

**Tabela 5** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro.
error_msg	String	Mensagem de erro.

Código de estado: 401

**Tabela 6** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro.
error_msg	String	Mensagem de erro.

Código de estado: 403

**Tabela 7** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro.
error_msg	String	Mensagem de erro.

Código de estado: 404

**Tabela 8** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro.
error_msg	String	Mensagem de erro.

Código de estado: 500

**Tabela 9** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro.
error_msg	String	Mensagem de erro.

Exemplos de solicitações

Criação de um gatilho OBS.

POST https://{Endpoint}/v2/{project_id}/fgs/triggers/{function_urn}

{
  "trigger_type_code" : "OBS",
  "trigger_status" : "ACTIVE",
  "event_data" : {
    "bucket" : "input-picture2",
    "events" : [ "s3:ObjectCreated:*" ],
    "name" : "obs-event-1ec7"
  }
}

Crie um gatilho APIG.

POST https://{Endpoint}/v2/{project_id}/fgs/triggers/{function_urn}

{
  "trigger_type_code" : "APIG",
  "trigger_status" : "ACTIVE",
  "event_data" : {
    "func_info" : {
      "timeout" : 5000
    },
    "name" : "API_test_gxz_v1_billing",
    "env_id" : "DEFAULT_ENVIRONMENT_RELEASE_ID",
    "env_name" : "RELEASE",
    "protocol" : "HTTPS",
    "auth" : "NONE",
    "group_id" : "318b09eb214a41488c667ecd51667e3x",
    "sl_domain" : "318b09eb214a41488c667ecd51667e3x.apig.cn-north-7.huaweicloudapis.com",
    "match_mode" : "SWA",
    "req_method" : "ANY",
    "backend_type" : "FUNCTION",
    "type" : 1,
    "path" : "/test_gxz_v1_billing"
  }
}

Crie um gatilho Kafka.

POST https://{Endpoint}/v2/{project_id}/fgs/triggers/{function_urn}

{
  "trigger_type_code" : "KAFKA",
  "trigger_status" : "DISABLED",
  "event_data" : {
    "instance_id" : "86ad3efc-c019-460e-91e7-317b1a89f95x",
    "topic_ids" : [ "PUSH_TOKEN_RECORD" ],
    "batch_size" : 100
  }
}

Exemplo de respostas

Código de estado: 201

Criado

{
  "trigger_id" : "9a14fae1-78cf-4185-ac7a-429eb6dc41fb",
  "trigger_type_code" : "TIMER",
  "trigger_status" : "ACTIVE",
  "event_data" : {
    "name" : "Timer-cpg3",
    "schedule" : "3m",
    "schedule_type" : "Rate"
  },
  "last_updated_time" : "2019-10-29T17:15:53+08:00",
  "created_time" : "2019-10-29T17:15:53+08:00"
}