ฟังก์ชัน
ฟังก์ชัน | คำอธิบาย |
---|---|
config() | จัดเก็บและเรียกข้อมูลการกำหนดค่าโปรเจ็กต์ เช่น คีย์ API ของบุคคลที่สามหรือการตั้งค่าอื่นๆ คุณสามารถตั้งค่าการกำหนดค่าโดยใช้ Firebase CLI ตามที่อธิบายไว้ใน[การกำหนดค่าสภาพแวดล้อม](/docs/functions/config-env) |
optionsToEndpoint(options) | |
optionsToTrigger(ตัวเลือก) | |
ภูมิภาค(ภูมิภาค) | กำหนดค่าภูมิภาคที่มีการทำให้ฟังก์ชันใช้งานได้ |
runWith(runtimeOptions) | กำหนดค่าตัวเลือกรันไทม์สำหรับฟังก์ชัน |
ชั้นเรียน
ชั้น | คำอธิบาย |
---|---|
เปลี่ยน | อินเทอร์เฟซ Cloud Functions สำหรับเหตุการณ์ที่เปลี่ยนสถานะ เช่น Realtime Database หรือ Cloud Firestore onWrite และเหตุการณ์ onUpdate ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบที่ใช้สร้างออบเจ็กต์ Change ได้ที่ด้านล่าง |
FunctionBuilder |
อินเทอร์เฟซ
อินเทอร์เฟซ | คำอธิบาย |
---|---|
BlockFunction | ประเภทฟังก์ชันสำหรับทริกเกอร์การบล็อกการตรวจสอบสิทธิ์ |
CloudFunction | ประเภทฟังก์ชันสำหรับทริกเกอร์ทั้งหมดที่ไม่ใช่ HTTPS ซึ่งควรส่งออกจากไฟล์ JavaScript เพื่อกำหนด Cloud Functionประเภทนี้เป็นฟังก์ชัน JavaScript พิเศษที่ใช้ออบเจ็กต์ Event ที่มีเทมเพลตเป็นอาร์กิวเมนต์เดียว |
ตัวเลือกการทำให้ใช้งานได้ | ตัวเลือกการกำหนดค่าสำหรับฟังก์ชันที่ใช้ระหว่างการทำให้ฟังก์ชันใช้งานได้ |
เหตุการณ์ | รูปแบบสายสำหรับกิจกรรม |
EventContext | บริบทที่เกิดเหตุการณ์ขึ้น |
FailurePolicy | ตัวเลือกการกําหนดค่าสําหรับนโยบายความล้มเหลวเกี่ยวกับฟังก์ชันในเบื้องหลัง |
HttpsFunction | ประเภทฟังก์ชันสำหรับทริกเกอร์ HTTPS ซึ่งควรส่งออกจากไฟล์ JavaScript เพื่อกำหนด Cloud Function |
แหล่งข้อมูล | ทรัพยากรคือรูปแบบมาตรฐานสำหรับการกำหนดทรัพยากร (google.rpc.context.AttributeContext.Resource) ส่วนใน Cloud Functions จะเป็นทรัพยากรที่เรียกใช้ฟังก์ชัน เช่น ที่เก็บข้อมูลของพื้นที่เก็บข้อมูล |
เรียกใช้ได้ | การเรียกใช้ได้มีเมธอด run ซึ่งจะเรียกใช้ฟังก์ชันที่ผู้ใช้กำหนดโดยตรง ซึ่งมีประโยชน์สำหรับการทดสอบหน่วย |
RuntimeOptions | ตัวเลือกการกำหนดค่าสำหรับฟังก์ชันที่ใช้ได้ขณะรันไทม์ |
กำหนดการ | ตัวเลือกการกำหนดค่าสำหรับฟังก์ชันที่กำหนดเวลาไว้ |
ScheduleRetryConfig | ตัวเลือกการลองใช้เครื่องจัดตารางเวลาอีกครั้ง ใช้กับฟังก์ชันที่กำหนดเวลาไว้เท่านั้น |
เนมสเปซ
เนมสเปซ | คำอธิบาย |
---|---|
Analytics | |
การตรวจสอบสิทธิ์ | |
ฐานข้อมูล | |
Firestore | |
https | |
ล็อกเกอร์ | |
พารามิเตอร์ | |
PubSub | |
remoteConfig | |
พื้นที่เก็บข้อมูล | |
งาน | |
testLab |
ตัวแปร
ตัวแปร | คำอธิบาย |
---|---|
แอป | |
นโยบายไม่สำเร็จ | |
ตัวเลือกการตั้งค่า INGRESS | รายการตัวเลือกที่พร้อมใช้งานสำหรับ IngressSettings |
MAX_NUMBER_USER_LABELS | |
MAX_TIMEOUT_SECONDS | ค่าระยะหมดเวลาสูงสุดของ Cloud Functions |
MIN_TIMEOUT_SECONDS | ค่าระยะหมดเวลาขั้นต่ำของ Cloud Functions |
รีเซ็ตมูลค่า | ค่าการกำหนดค่าพิเศษเพื่อรีเซ็ตการกำหนดค่าเป็นค่าเริ่มต้นของแพลตฟอร์ม |
ภูมิภาคที่รองรับ | รายชื่อภูมิภาคทั้งหมดที่ Cloud Functions รองรับ |
MEMORY_OPTIONS ใช้งานได้ | รายการตัวเลือกหน่วยความจำที่ใช้ได้ซึ่ง Cloud Functions รองรับ |
VPC_EGRESS_SETTINGS_OPTIONS | รายการตัวเลือกที่ใช้ได้สำหรับ VpcConnectorEgressSettings |
config()
จัดเก็บและเรียกข้อมูลการกำหนดค่าโปรเจ็กต์ เช่น คีย์ API ของบุคคลที่สามหรือการตั้งค่าอื่นๆ คุณสามารถตั้งค่าการกำหนดค่าโดยใช้ Firebase CLI ตามที่อธิบายไว้ใน[การกำหนดค่าสภาพแวดล้อม](/docs/functions/config-env)
ลายเซ็น:
export declare function config(): Record<string, any>;
การคืนสินค้า:
บันทึก<สตริง, อะไรก็ได้>
optionsToEndpoint()
ลายเซ็น:
export declare function optionsToEndpoint(options: DeploymentOptions): ManifestEndpoint;
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ตัวเลือก | ตัวเลือกการทำให้ใช้งานได้ |
การคืนสินค้า:
ManifestEndpoint
optionsToTrigger()
ลายเซ็น:
export declare function optionsToTrigger(options: DeploymentOptions): any;
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ตัวเลือก | ตัวเลือกการทำให้ใช้งานได้ |
การคืนสินค้า:
ทั้งหมด
ภูมิภาค()
กำหนดค่าภูมิภาคที่มีการทำให้ฟังก์ชันใช้งานได้
ลายเซ็น:
export declare function region(...regions: Array<(typeof SUPPORTED_REGIONS)[number] | string | Expression<string> | ResetValue>): FunctionBuilder;
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ภูมิภาค | อาร์เรย์<(ประเภท SUPPORTED_REGIONS)[number] | สตริง | นิพจน์<string> | รีเซ็ตค่า> | สตริงภูมิภาคอย่างน้อย 1 รายการ |
การคืนสินค้า:
ตัวอย่างที่ 1
Functions.region('us-east1')
ตัวอย่างที่ 2
Functions.region('us-east1', 'us-central1')
RunWith()
กำหนดค่าตัวเลือกรันไทม์สำหรับฟังก์ชัน
ลายเซ็น:
export declare function runWith(runtimeOptions: RuntimeOptions): FunctionBuilder;
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ตัวเลือกรันไทม์ | RuntimeOptions | ออบเจ็กต์ที่มีช่องที่ไม่บังคับ: 1. memory : จำนวนหน่วยความจำที่จะจัดสรรให้กับฟังก์ชัน ค่าที่เป็นไปได้คือ "128MB", "256MB", "512MB", "1GB", "2GB", "4GB" และ "8GB" 2. timeoutSeconds : ระยะหมดเวลาสำหรับฟังก์ชันในหน่วยวินาที ค่าที่เป็นไปได้คือ 0 ถึง 540 3. failurePolicy : นโยบายความล้มเหลวของฟังก์ชัน ซึ่งบูลีน true เทียบเท่ากับการระบุออบเจ็กต์การลองอีกครั้งที่ว่างเปล่า 4. vpcConnector : รหัสของเครื่องมือเชื่อมต่อ VPC ในโปรเจ็กต์และภูมิภาคเดียวกัน 5. vpcConnectorEgressSettings : เมื่อตั้งค่า vpcConnector แล้ว ให้ควบคุมการรับส่งข้อมูลขาออกที่จะส่งผ่าน vpcConnector 6. serviceAccount : บัญชีบริการเฉพาะสำหรับฟังก์ชัน 7. ingressSettings : การตั้งค่าข้อมูลขาเข้าสำหรับฟังก์ชัน ซึ่งควบคุมว่าจะเรียกฟังก์ชัน HTTPS ได้จากที่ใดค่าต้องไม่เป็น Null |
การคืนสินค้า:
แอป
ลายเซ็น:
app: {
setEmulatedAdminApp: typeof setEmulatedAdminApp;
}
DEFAULT_FAILURE_POLICY
ลายเซ็น:
DEFAULT_FAILURE_POLICY: FailurePolicy
ตัวเลือกการตั้งค่า INGRESS
รายการตัวเลือกที่พร้อมใช้งานสำหรับ IngressSettings
ลายเซ็น:
INGRESS_SETTINGS_OPTIONS: readonly ["INGRESS_SETTINGS_UNSPECIFIED", "ALLOW_ALL", "ALLOW_INTERNAL_ONLY", "ALLOW_INTERNAL_AND_GCLB"]
MAX_NUMBER_USER_LABELS
ลายเซ็น:
MAX_NUMBER_USER_LABELS = 58
MAX_TIMEOUT_SECONDS
ค่าระยะหมดเวลาสูงสุดของ Cloud Functions
ลายเซ็น:
MAX_TIMEOUT_SECONDS = 540
MIN_TIMEOUT_SECONDS
ค่าระยะหมดเวลาขั้นต่ำของ Cloud Functions
ลายเซ็น:
MIN_TIMEOUT_SECONDS = 0
รีเซ็ต
ค่าการกำหนดค่าพิเศษเพื่อรีเซ็ตการกำหนดค่าเป็นค่าเริ่มต้นของแพลตฟอร์ม
ลายเซ็น:
RESET_VALUE: ResetValue
ภูมิภาคที่รองรับ
รายชื่อภูมิภาคทั้งหมดที่ Cloud Functions รองรับ
ลายเซ็น:
SUPPORTED_REGIONS: readonly ["us-central1", "us-east1", "us-east4", "us-west2", "us-west3", "us-west4", "europe-central2", "europe-west1", "europe-west2", "europe-west3", "europe-west6", "asia-east1", "asia-east2", "asia-northeast1", "asia-northeast2", "asia-northeast3", "asia-south1", "asia-southeast1", "asia-southeast2", "northamerica-northeast1", "southamerica-east1", "australia-southeast1"]
MEMORY_OPTIONS ได้
รายการตัวเลือกหน่วยความจำที่ใช้ได้ซึ่ง Cloud Functions รองรับ
ลายเซ็น:
VALID_MEMORY_OPTIONS: readonly ["128MB", "256MB", "512MB", "1GB", "2GB", "4GB", "8GB"]
ตัวเลือกการตั้งค่า VPC_EGRESS
รายการตัวเลือกที่ใช้ได้สำหรับ VpcConnectorEgressSettings
ลายเซ็น:
VPC_EGRESS_SETTINGS_OPTIONS: readonly ["VPC_CONNECTOR_EGRESS_SETTINGS_UNSPECIFIED", "PRIVATE_RANGES_ONLY", "ALL_TRAFFIC"]