Referensi tipe resource ALIYUN::FC::Trigger - Resource Orchestration Service

ALIYUN::FC::Trigger digunakan untuk memicu pemanggilan fungsi.

Dalam model komputasi berbasis peristiwa, sumber peristiwa menghasilkan peristiwa, fungsi memproses peristiwa tersebut, dan pemicu digunakan untuk mengelola berbagai sumber peristiwa secara terpusat. Di sisi sumber peristiwa, ketika peristiwa yang sesuai dengan aturan yang ditentukan oleh pemicu terjadi, sumber peristiwa akan memanggil fungsi yang relevan.

Sintaksis

{
  "Type": "ALIYUN::FC::Trigger",
  "Properties": {
    "TriggerConfig": Map,
    "InvocationRole": String,
    "FunctionName": String,
    "ServiceName": String,
    "TriggerName": String,
    "TriggerType": String,
    "Qualifier": String,
    "SourceArn": String
  }
}

Properti

Properti	Tipe	Wajib	Dapat Diedit	Deskripsi	Kendala
ServiceName	String	Ya	Tidak	Nama layanan tempat fungsi berada.	Nama harus memiliki panjang 1 hingga 128 karakter.
FunctionName	String	Ya	Tidak	Nama fungsi yang ingin Anda buat pemicunya.	Tidak ada.
TriggerName	String	Ya	Tidak	Nama pemicu.	Nama harus memiliki panjang 1 hingga 128 karakter, dan dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Nama harus dimulai dengan huruf atau garis bawah (_).
TriggerType	String	Ya	Tidak	Jenis pemicu.	Nilai valid: oss: Pemicu Object Storage Service (OSS) log: Pemicu Log Service tablestore: Pemicu Tablestore timer: Pemicu waktu mns_topic: Pemicu topik Message Service (MNS) cdn_events: Pemicu peristiwa Alibaba Cloud CDN (CDN) http: Pemicu HTTP Catatan Anda hanya dapat membuat pemicu HTTP saat membuat fungsi. Saat pemicu HTTP dikonfigurasi untuk suatu fungsi, Anda tidak dapat membuat jenis pemicu lainnya untuk fungsi tersebut.
TriggerConfig	Map	Ya	Ya	Konfigurasi pemicu.	Konfigurasi bervariasi berdasarkan jenis pemicu.
InvocationRole	String	Tidak	Ya	Peran pemicu yang digunakan untuk memberikan izin kepada sumber peristiwa untuk memanggil fungsi atas nama Anda. Contoh: `acs:ram::164696547407****:role/fc-test`.	Properti ini opsional saat TriggerType diatur ke timer atau http. Properti ini wajib saat TriggerType diatur ke nilai selain timer dan http. Berikut adalah daftar entitas tepercaya dan kebijakan untuk otorisasi peran untuk berbagai jenis pemicu: oss Entitas tepercaya: oss.aliyuncs.com Tindakan dalam kebijakan: fc:InvokeFunction log Entitas tepercaya: log.aliyuncs.com Tindakan dalam kebijakan: log:PostLogStoreLogs tablestore Entitas tepercaya: 1604337383174**** Tindakan dalam kebijakan: fc:InvokeFunction, ots:BatchGet, ots:Describe, ots:Get, dan ots:List mns_topic Entitas tepercaya: mns.aliyuncs.com Tindakan dalam kebijakan: dm:BatchSendMail, dm:SingleSendMail, dan dm:Query cdn_events Entitas tepercaya: cdn.aliyuncs.com Tindakan dalam kebijakan: fc:InvokeFunction
SourceArn	String	Tidak	Tidak	Alibaba Cloud Resource Name (ARN) dari sumber peristiwa.	Properti ini opsional saat TriggerType diatur ke timer atau http. Properti ini wajib saat TriggerType diatur ke nilai selain timer dan http. Berikut adalah daftar format dan contoh ARN sumber peristiwa untuk berbagai jenis pemicu: oss Format: `acs:oss:<RegionId>:<TenantId>:<OssBucketName>` Contoh: `acs:oss:cn-hangzhou:164696547407**:test-trigger-bucket` log Format: `acs:log:<RegionId>:<TenantId>:project/<Value of Project in LogConfig>` Contoh: `acs:log:cn-hangzhou:164696547407:project/logtrigger` tablestore Format: `acs:ots:<RegionId>:<TenantId>:instance/<OtsInstance>/table/<OtsTable>` Contoh: `acs:ots:cn-hangzhou:164696547407:instance/otstrigger/table/tb` mns_topic Format: `acs:mns:<RegionId>:<TenantId>:/topics/<MnsTopic>` Contoh: `acs:mns:cn-hangzhou:164696547407*:/topics/triggertopic` cdn_events Format: `acs:cdn::<TenantId>` Contoh: `acs:cdn::164696547407*` Catatan** Ganti `TenantId` dengan ID akun Alibaba Cloud Anda.
Qualifier	String	Tidak	Ya	Versi pemicu.	Nilai default: LATEST.

Sintaksis oss-TriggerConfig

"TriggerConfig": {
  "BucketName": String,
  "Events": List,
  "Filter": Map
}

Properti oss-TriggerConfig

Properti	Tipe	Wajib	Dapat Diedit	Deskripsi	Kendala
BucketName	String	Ya	Tidak	Nama bucket.	Anda harus memilih bucket OSS sebagai sumber peristiwa. Bucket dalam wilayah yang sama ditampilkan dalam daftar drop-down Bucket.
Events	String	Ya	Ya	Peristiwa pemicu, yang mewakili operasi yang dilakukan pada sumber daya Alibaba Cloud.	Contoh: `oss:ObjectCreated:*`.
Filter	Map	Tidak	Ya	Aturan pemicu, yang digunakan untuk menghindari pemicuan siklik.	Nilai Prefix dan Suffix harus berupa string kustom. Contoh: `"Filter": { "Key": { "Prefix": "prefix", "Suffix": "suffix" } }`

Sintaksis log-TriggerConfig

"TriggerConfig": {
  "SourceConfig": Map,
  "LogConfig": Map,
  "JobConfig": Map,
  "FunctionParameter": Map,
  "Enable": Boolean
}

Properti log-TriggerConfig

Properti	Tipe	Wajib	Dapat Diedit	Deskripsi	Kendala
SourceConfig	Map	Ya	Tidak	Konfigurasi Logstore.	Contoh: `{"LogStore": "<SLS_LogStore>"}`.
LogConfig	Map	Ya	Ya	Konfigurasi proyek Log Service dan Logstore untuk pemicu.	Project: proyek Log Service. Properti ini wajib tetapi tidak dapat diedit. LogStore: Logstore untuk pemicu. Properti ini opsional dan dapat diedit. Logstore tidak boleh sama dengan nilai LogStore dalam properti SourceConfig. Contoh: `{"Project": "<SLS_Project>", "LogStore": "SLS_LogStore"}`.
JobConfig	Map	Ya	Ya	Konfigurasi pemicu, yang menentukan jumlah maksimum percobaan ulang dan interval pemicu.	MaxRetryTime: interval pemicu. Unit: detik. TriggerInterval: jumlah maksimum percobaan ulang. Nilai valid: 0 hingga 100. Contoh: `{"MaxRetryTime": 3, "TriggerInterval": 60}`.
FunctionParameter	Map	Ya	Ya	Konfigurasi fungsi yang digunakan untuk melewatkan parameter ke fungsi.	Jika Anda tidak ingin melewatkan parameter, atur nilainya menjadi kurung kurawal ({ }).
Enable	Boolean	Ya	Ya	Menentukan apakah akan mengaktifkan pemicu.	Nilai valid: true false

Sintaksis timer-TriggerConfig

"TriggerConfig": {
  "Payload": String,
  "CronExpression": String,
  "Enabled": Boolean
}

Properti timer-TriggerConfig

Properti	Tipe	Wajib	Dapat Diedit	Deskripsi	Kendala
Payload	String	Tidak	Ya	Pesan pemicu.	Tidak ada.
CronExpression	String	Ya	Ya	Ekspresi CRON yang digunakan untuk menentukan waktu pemicu.	Ekspresi CRON menggunakan Waktu Universal Terkoordinasi (UTC).
Enabled	Boolean	Ya	Ya	Menentukan apakah akan mengaktifkan pemicu.	Nilai valid: true false

Sintaksis tablestore-TriggerConfig

"TriggerConfig",: {
  "InstanceName": String,
  "TableName": String
}

Properti tablestore-TriggerConfig

Properti	Tipe	Wajib	Dapat Diedit	Deskripsi	Kendala
InstanceName	String	Ya	Tidak	Nama instance Tablestore.	Tidak ada.
TableName	String	Ya	Tidak	Nama tabel data.	Tidak ada.

Sintaksis mns_topic-TriggerConfig

"TriggerConfig": {
  "NotifyStrategy": String,
  "NotifyContentFormat": String,
  "FilterTag": String
}

Properti mns_topic-TriggerConfig

Properti	Tipe	Wajib	Dapat Diedit	Deskripsi	Kendala
NotifyStrategy	String	Ya	Tidak	Kebijakan ulang.	Nilai valid: BACKOFF_RETRY EXPONENTIAL_DECAY_RETRY Untuk informasi lebih lanjut, lihat NotifyStrategy.
NotifyContentFormat	String	Ya	Tidak	Format peristiwa.	Nilai valid: STREAM JSON
FilterTag	String	Tidak	Tidak	Tag filter.	Tidak ada.

Sintaksis cdn-TriggerConfig

"TriggerConfig": {
  "EventName": String,
  "EventVersion": String,
  "Notes": String,
  "Filter": List
}

Properti cdn-TriggerConfig

Properti	Tipe	Wajib	Dapat Diedit	Deskripsi	Kendala
EventName	String	Ya	Tidak	Peristiwa pemicu.	Nilai valid: CachedObjectsBlocked CachedObjectsPushed CachedObjectsRefreshed LogFileCreated CdnDomainStarted CdnDomainStopped CdnDomainAdded CdnDomainDeleted
EventVersion	String	Ya	Tidak	Versi peristiwa pemicu.	Tidak ada.
Notes	String	Ya	Ya	Catatan.	Tidak ada.
Filter	List	Ya	Ya	Filter.	Kunci setiap filter adalah `Domain`. Anda harus menentukan setidaknya satu filter. Contoh: `[{"Domain": "example.com"}, {"Domain": "example.org"}, ...]`.

Sintaksis http-TriggerConfig

Catatan

Anda hanya dapat membuat pemicu HTTP saat membuat fungsi. Saat pemicu HTTP dikonfigurasi untuk suatu fungsi, Anda tidak dapat membuat jenis pemicu lainnya untuk fungsi tersebut.

"TriggerConfig": {
  "AuthType": String,
  "Methods": List
}

Properti http-TriggerConfig

Properti

Tipe

Wajib

Dapat Diedit

Deskripsi

Kendala

AuthType

String

Tidak

Metode autentikasi.

Nilai valid:

anonymous
function

Methods

List

Tidak

Metode permintaan.

Nilai valid:

GET
POST
PUT
DELETE
HEAD
PATCH

Contoh: ["GET"] dan ["POST", "PUT"].

Nilai Kembali

Fn::GetAtt

TriggerId: ID unik yang dihasilkan sistem untuk setiap pemicu.
ServiceName: nama layanan tempat fungsi berada.
FunctionName: nama fungsi.
TriggerName: nama pemicu.
UrlInternet: alamat domain publik.
UrlIntranet: alamat domain privat.

Contoh

YAML format

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ServiceName:
    Type: String
  FunctionName:
    Type: String
  CdnDomain:
    Type: Json
  SourceConfigLogStore:
    Type: String
  LogConfig:
    Type: Json
    Description: 'contohnya: {"Project": "testviper", "LogStore": "vipertest"}'
  MnsTopic:
    Type: String
  OssBucketName:
    Type: String
  OtsInstance:
    Type: String
  OtsTable:
    Type: String
  OtsInvocationRoleArn:
    Type: String
Resources:
  Service:
    Type: 'ALIYUN::FC::Service'
    Properties:
      ServiceName:
        Ref: ServiceName
  Function:
    DependsOn: Service
    Type: 'ALIYUN::FC::Function'
    Properties:
      ServiceName:
        Ref: ServiceName
      Code:
        SourceCode: "def handler(event, context):\n\treturn 'Hello World!'"
      Handler: index.handler
      Runtime: python3
      FunctionName:
        Ref: FunctionName
  Role:
    Type: 'ALIYUN::RAM::Role'
    Properties:
      AssumeRolePolicyDocument:
        Version: 1
        Statement:
          - Action: 'sts:AssumeRole'
            Effect: Allow
            Principal:
              Service:
                - cdn.aliyuncs.com
                - fc.aliyuncs.com
                - mns.aliyuncs.com
                - log.aliyuncs.com
                - oss.aliyuncs.com
      Policies:
        - PolicyName: FcTrigger
          PolicyDocument:
            Version: '1'
            Statement:
              - Effect: Allow
                Action:
                  - 'fc:InvokeFunction'
                  - 'log:PostLogStoreLogs'
                  - 'dm:*'
                  - 'dm:BatchSendMail'
                  - 'dm:SingleSendMail'
                  - 'dm:Query*'
                Resource:
                  - '*'
      RoleName: Trigger
  CdnTrigger:
    DependsOn: Function
    Type: 'ALIYUN::FC::Trigger'
    Properties:
      ServiceName:
        Ref: ServiceName
      FunctionName:
        Ref: FunctionName
      TriggerName: cdn
      TriggerType: cdn_events
      SourceArn:
        'Fn::Sub': 'acs:cdn:*:${ALIYUN::TenantId}'
      InvocationRole:
        'Fn::GetAtt':
          - Role
          - Arn
      TriggerConfig:
        EventName: CachedObjectsBlocked
        EventVersion: 1.0.0
        Notes: test
        Filter:
          Domain:
            Ref: CdnDomain
  LogTrigger:
    DependsOn: Function
    Type: 'ALIYUN::FC::Trigger'
    Properties:
      ServiceName:
        Ref: ServiceName
      FunctionName:
        Ref: FunctionName
      TriggerName: log
      TriggerType: log
      SourceArn:
        'Fn::Join':
          - ''
          - - 'Fn::Sub': 'acs:log:${ALIYUN::Region}:${ALIYUN::TenantId}:project/'
            - 'Fn::Select':
                - Project
                - Ref: LogConfig
      InvocationRole:
        'Fn::GetAtt':
          - Role
          - Arn
      TriggerConfig:
        SourceConfig:
          LogStore:
            Ref: SourceConfigLogStore
        LogConfig:
          Ref: LogConfig
        JobConfig:
          MaxRetryTime: 3
          TriggerInterval: 60
        FunctionParameter: {}
        Enable: false
  MnsTrigger:
    DependsOn: Function
    Type: 'ALIYUN::FC::Trigger'
    Properties:
      ServiceName:
        Ref: ServiceName
      FunctionName:
        Ref: FunctionName
      TriggerName: mns
      TriggerType: mns_topic
      SourceArn:
        'Fn::Sub': 'acs:mns:${ALIYUN::Region}:${ALIYUN::TenantId}:/topics/${MnsTopic}'
      InvocationRole:
        'Fn::GetAtt':
          - Role
          - Arn
      TriggerConfig:
        NotifyStrategy: BACKOFF_RETRY
        NotifyContentFormat: STREAM
        FilterTag: test
  OssTrigger:
    DependsOn: Function
    Type: 'ALIYUN::FC::Trigger'
    Properties:
      ServiceName:
        Ref: ServiceName
      FunctionName:
        Ref: FunctionName
      TriggerName: oss
      TriggerType: oss
      SourceArn:
        'Fn::Sub': 'acs:oss:${ALIYUN::Region}:${ALIYUN::TenantId}:${OssBucketName}'
      InvocationRole:
        'Fn::GetAtt':
          - Role
          - Arn
      TriggerConfig:
        BucketName:
          Ref: OssBucketName
        Events:
          - 'oss:ObjectCreated:*'
        Filter:
          Key:
            Prefix: b
            Suffix: a
  OtsTrigger:
    DependsOn: Function
    Type: 'ALIYUN::FC::Trigger'
    Properties:
      ServiceName:
        Ref: ServiceName
      FunctionName:
        Ref: FunctionName
      TriggerName: ots
      TriggerType: tablestore
      SourceArn:
        'Fn::Sub': >-
          acs:ots:${ALIYUN::Region}:${ALIYUN::TenantId}:instance/${OtsInstance}/table/${OtsTable}
      InvocationRole:
        Ref: OtsInvocationRoleArn
      TriggerConfig:
        InstanceName:
          Ref: OtsInstance
        TableName:
          Ref: OtsTable
  TimerTrigger:
    DependsOn: Function
    Type: 'ALIYUN::FC::Trigger'
    Properties:
      ServiceName:
        Ref: ServiceName
      FunctionName:
        Ref: FunctionName
      TriggerName: timer
      TriggerType: timer
      TriggerConfig:
        CronExpression: 0 0/5 * * * *
        Enabled: true

JSON format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ServiceName": {
      "Type": "String"
    },
    "FunctionName": {
      "Type": "String"
    },
    "CdnDomain": {
      "Type": "Json"
    },
    "SourceConfigLogStore": {
      "Type": "String"
    },
    "LogConfig": {
      "Type": "Json",
      "Description": "contohnya: {\"Project\": \"testviper\", \"LogStore\": \"vipertest\"}"
    },
    "MnsTopic": {
      "Type": "String"
    },
    "OssBucketName": {
      "Type": "String"
    },
    "OtsInstance": {
      "Type": "String"
    },
    "OtsTable": {
      "Type": "String"
    },
    "OtsInvocationRoleArn": {
      "Type": "String"
    }
  },
  "Resources": {
    "Service": {
      "Type": "ALIYUN::FC::Service",
      "Properties": {
        "ServiceName": {
          "Ref": "ServiceName"
        }
      }
    },
    "Function": {
      "DependsOn": "Service",
      "Type": "ALIYUN::FC::Function",
      "Properties": {
        "ServiceName": {
          "Ref": "ServiceName"
        },
        "Code": {
          "SourceCode": "def handler(event, context):\n\treturn 'Hello World!'"
        },
        "Handler": "index.handler",
        "Runtime": "python3",
        "FunctionName": {
          "Ref": "FunctionName"
        }
      }
    },
    "Role": {
      "Type": "ALIYUN::RAM::Role",
      "Properties": {
        "AssumeRolePolicyDocument": {
          "Version": 1,
          "Statement": [
            {
              "Action": "sts:AssumeRole",
              "Effect": "Allow",
              "Principal": {
                "Service": [
                  "cdn.aliyuncs.com",
                  "fc.aliyuncs.com",
                  "mns.aliyuncs.com",
                  "log.aliyuncs.com",
                  "oss.aliyuncs.com"
                ]
              }
            }
          ]
        },
        "Policies": [
          {
            "PolicyName": "FcTrigger",
            "PolicyDocument": {
              "Version": "1",
              "Statement": [
                {
                  "Effect": "Allow",
                  "Action": [
                    "fc:InvokeFunction",
                    "log:PostLogStoreLogs",
                    "dm:*",
                    "dm:BatchSendMail",
                    "dm:SingleSendMail",
                    "dm:Query*"
                  ],
                  "Resource": [
                    "*"
                  ]
                }
              ]
            }
          }
        ],
        "RoleName": "Trigger"
      }
    },
    "CdnTrigger": {
      "DependsOn": "Function",
      "Type": "ALIYUN::FC::Trigger",
      "Properties": {
        "ServiceName": {
          "Ref": "ServiceName"
        },
        "FunctionName": {
          "Ref": "FunctionName"
        },
        "TriggerName": "cdn",
        "TriggerType": "cdn_events",
        "SourceArn": {
          "Fn::Sub": "acs:cdn:*:${ALIYUN::TenantId}"
        },
        "InvocationRole": {
          "Fn::GetAtt": [
            "Role",
            "Arn"
          ]
        },
        "TriggerConfig": {
          "EventName": "CachedObjectsBlocked",
          "EventVersion": "1.0.0",
          "Notes": "test",
          "Filter": {
            "Domain": {
              "Ref": "CdnDomain"
            }
          }
        }
      }
    },
    "LogTrigger": {
      "DependsOn": "Function",
      "Type": "ALIYUN::FC::Trigger",
      "Properties": {
        "ServiceName": {
          "Ref": "ServiceName"
        },
        "FunctionName": {
          "Ref": "FunctionName"
        },
        "TriggerName": "log",
        "TriggerType": "log",
        "SourceArn": {
          "Fn::Join": [
            "",
            [
              {
                "Fn::Sub": "acs:log:${ALIYUN::Region}:${ALIYUN::TenantId}:project/"
              },
              {
                "Fn::Select": [
                  "Project",
                  {
                    "Ref": "LogConfig"
                  }
                ]
              }
            ]
          ]
        },
        "InvocationRole": {
          "Fn::GetAtt": [
            "Role",
            "Arn"
          ]
        },
        "TriggerConfig": {
          "SourceConfig": {
            "LogStore": {
              "Ref": "SourceConfigLogStore"
            }
          },
          "LogConfig": {
            "Ref": "LogConfig"
          },
          "JobConfig": {
            "MaxRetryTime": 3,
            "TriggerInterval": 60
          },
          "FunctionParameter": {},
          "Enable": false
        }
      }
    },
    "MnsTrigger": {
      "DependsOn": "Function",
      "Type": "ALIYUN::FC::Trigger",
      "Properties": {
        "ServiceName": {
          "Ref": "ServiceName"
        },
        "FunctionName": {
          "Ref": "FunctionName"
        },
        "TriggerName": "mns",
        "TriggerType": "mns_topic",
        "SourceArn": {
          "Fn::Sub": "acs:mns:${ALIYUN::Region}:${ALIYUN::TenantId}:/topics/${MnsTopic}"
        },
        "InvocationRole": {
          "Fn::GetAtt": [
            "Role",
            "Arn"
          ]
        },
        "TriggerConfig": {
          "NotifyStrategy": "BACKOFF_RETRY",
          "NotifyContentFormat": "STREAM",
          "FilterTag": "test"
        }
      }
    },
    "OssTrigger": {
      "DependsOn": "Function",
      "Type": "ALIYUN::FC::Trigger",
      "Properties": {
        "ServiceName": {
          "Ref": "ServiceName"
        },
        "FunctionName": {
          "Ref": "FunctionName"
        },
        "TriggerName": "oss",
        "TriggerType": "oss",
        "SourceArn": {
          "Fn::Sub": "acs:oss:${ALIYUN::Region}:${ALIYUN::TenantId}:${OssBucketName}"
        },
        "InvocationRole": {
          "Fn::GetAtt": [
            "Role",
            "Arn"
          ]
        },
        "TriggerConfig": {
          "BucketName": {
            "Ref": "OssBucketName"
          },
          "Events": [
            "oss:ObjectCreated:*"
          ],
          "Filter": {
            "Key": {
              "Prefix": "b",
              "Suffix": "a"
            }
          }
        }
      }
    },
    "OtsTrigger": {
      "DependsOn": "Function",
      "Type": "ALIYUN::FC::Trigger",
      "Properties": {
        "ServiceName": {
          "Ref": "ServiceName"
        },
        "FunctionName": {
          "Ref": "FunctionName"
        },
        "TriggerName": "ots",
        "TriggerType": "tablestore",
        "SourceArn": {
          "Fn::Sub": "acs:ots:${ALIYUN::Region}:${ALIYUN::TenantId}:instance/${OtsInstance}/table/${OtsTable}"
        },
        "InvocationRole": {
          "Ref": "OtsInvocationRoleArn"
        },
        "TriggerConfig": {
          "InstanceName": {
            "Ref": "OtsInstance"
          },
          "TableName": {
            "Ref": "OtsTable"
          }
        }
      }
    },
    "TimerTrigger": {
      "DependsOn": "Function",
      "Type": "ALIYUN::FC::Trigger",
      "Properties": {
        "ServiceName": {
          "Ref": "ServiceName"
        },
        "FunctionName": {
          "Ref": "FunctionName"
        },
        "TriggerName": "timer",
        "TriggerType": "timer",
        "TriggerConfig": {
          "CronExpression": "0 0/5 * * * *",
          "Enabled": true
        }
      }
    }
  }
}