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
Compartilhar

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"
}

Códigos de status

Código de status

Descrição

201

Criado

400

Solicitação inválida.

401

Não autorizado.

403

Proibido.

404

Não encontrado.

500

Erro de servidor interno.

Códigos de erro

Consulte Códigos de erro.

Tópico principal:Gatilhos de função