功能介绍

创建触发器。

• 可以创建的触发器类型包括TIMER、APIG、 CTS 、DDS、DMS、DIS、 LTS 、OBS、 SMN 、KAFKA。

• DDS和KAFKA触发器创建时默认为DISABLED状态，其他触发器默认为ACTIVE状态。

• TIMER、DDS、DMS、KAFKA、LTS触发器支持禁用，其他触发器不支持。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

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

请求参数

响应参数

状态码： 201

状态码： 400

状态码： 401

状态码： 403

状态码： 404

状态码： 500

请求示例

• 创建名为obs-event-1ec7的obs触发器，触发事件为input-picture2桶中有新文件上传。

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

• 创建名为API_test_gxz_v1_billing的apig触发器，创建无认证方式的临时域名，超时时间为5000s。

  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.{region}.huaweicloudapis.com",
      "match_mode" : "SWA",
      "req_method" : "ANY",
      "backend_type" : "FUNCTION",
      "type" : 1,
      "path" : "/test_gxz_v1_billing"
    }
  }

• 创建86ad3efcxx实例的kafka触发器，从PUSH_TOKEN_RECORD消费组中拉取消息触发函数执行。

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

• 创建timer触发器，每3分钟触发一次函数执行。

  POST https://{Endpoint}/v2/{project_id}/fgs/triggers/{function_urn}
  
  {
    "trigger_type_code" : "TIMER",
    "trigger_status" : "ACTIVE",
    "event_data" : {
      "name" : "Timer-l8v2",
      "schedule" : "3m",
      "schedule_type" : "Rate"
    }
  }

• 创建指定lts触发器(需配置访问LTS服务权限的委托)。

  POST https://{Endpoint}/v2/{project_id}/fgs/triggers/{function_urn}
  
  {
    "trigger_type_code" : "LTS",
    "trigger_status" : "ACTIVE",
    "event_data" : {
      "log_group_id" : "ccd3fa30-7c86-4590-8a9d-XXX",
      "log_group_name" : "function_flow_lts_group_XXX",
      "log_topic_id" : "5b4944dd-9603-481d-9b91-XXX",
      "log_topic_name" : "79eebdc0-3a0d-4231-b88e-XXX"
    }
  }

• 创建指定smn触发器。

  POST https://{Endpoint}/v2/{project_id}/fgs/triggers/{function_urn}
  
  {
    "trigger_type_code" : "SMN",
    "trigger_status" : "ACTIVE",
    "event_data" : {
      "topic_urn" : "urn:smn:{region}:{project_id}:Failed_times"
    }
  }

响应示例

状态码： 201

Created

{
  "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" : "2022-11-09 16:37:24",
  "created_time" : "2022-11-09 16:37:24"
}

状态码

错误码

请参见错误码。