storage.ObjectBuilder class

Google Cloud Storage 物件建構工具介面。

透過 functions.storage.object()存取。

簽名：

export declare class ObjectBuilder 

方法

方法	修飾符	說明
onArchive(handler)		只有在值區已啟用物件版本管理功能時，才會傳送事件處理常式。這個事件表示物件的使用中版本已變為封存版本，原因是物件遭到封存或是因為擁有相同名稱的物件上傳而遭到覆寫。
onDelete(處理常式)		每次發生 Google Cloud Storage 刪除作業時，都會觸發事件處理常式。在物件永久刪除時傳送。值區生命週期設定中覆寫或刪除的物件也包含在內。如果值區已啟用物件版本管理功能，則在封存物件時，系統不會傳送事件，即使透過 storage.objects.delete 方法進行封存也一樣。
onFinalize(handler)		每次發生 Google Cloud Storage 物件時，就會觸發事件處理常式。在值區中成功建立新物件 (或現有物件的新版本) 時傳送。複製或重寫現有的物件也包含在內。上傳失敗不會觸發這個事件。
onMetadataUpdate(處理常式)		每次現有物件的中繼資料變更時，觸發的事件處理常式。

storage.ObjectBuilder.onArchive()

只有在值區已啟用物件版本管理功能時，才會傳送事件處理常式。這個事件表示物件的使用中版本已變為封存版本，原因是物件遭到封存或是因為擁有相同名稱的物件上傳而遭到覆寫。

簽名：

onArchive(handler: (object: ObjectMetadata, context: EventContext) => PromiseLike<any> | any): CloudFunction<ObjectMetadata>;

參數

參數	類型	說明
handler	(物件：ObjectMetadata，情境：EventContext) =>承諾<任何>|任何	每次發生 Google Cloud Storage 封存時都會執行事件處理常式。

傳回：

CloudFunction<ObjectMetadata>

可匯出及部署的函式。

storage.ObjectBuilder.onDelete()

每次發生 Google Cloud Storage 刪除作業時觸發的事件處理常式。

當永久刪除物件時，會傳送這個事件。值區生命週期設定中覆寫或刪除的物件也包含在內。如果值區已啟用物件版本管理功能，則在封存物件時，系統不會傳送事件，即使透過 storage.objects.delete 方法進行封存也一樣。

簽名：

onDelete(handler: (object: ObjectMetadata, context: EventContext) => PromiseLike<any> | any): CloudFunction<ObjectMetadata>;

參數

參數	類型	說明
handler	(物件：ObjectMetadata，情境：EventContext) =>承諾<任何>|任何	每次發生 Google Cloud Storage 刪除作業時，都會執行事件處理常式。

傳回：

CloudFunction<ObjectMetadata>

可匯出及部署的函式。

storage.ObjectBuilder.onFinalize()

每次發生 Google Cloud Storage 物件時都會觸發的事件處理常式。

當在值區中成功建立新物件 (或現有物件的新版本) 時，會傳送這個事件。其中包含複製或重寫現有的物件。上傳失敗不會觸發這個事件。

簽名：

onFinalize(handler: (object: ObjectMetadata, context: EventContext) => PromiseLike<any> | any): CloudFunction<ObjectMetadata>;

參數

參數	類型	說明
handler	(物件：ObjectMetadata，情境：EventContext) =>承諾<任何>|任何	每次發生 Google Cloud Storage 物件時，都會執行這個事件處理常式。

傳回：

CloudFunction<ObjectMetadata>

可匯出及部署的函式。

storage.ObjectBuilder.onMetadataUpdate()

每次現有物件的中繼資料變更時，觸發的事件處理常式。

簽名：

onMetadataUpdate(handler: (object: ObjectMetadata, context: EventContext) => PromiseLike<any> | any): CloudFunction<ObjectMetadata>;

參數

參數	類型	說明
handler	(物件：ObjectMetadata，情境：EventContext) =>承諾<任何>|任何	每次發生 Google Cloud Storage 中繼資料更新時，都會執行事件處理常式。

傳回：

CloudFunction<ObjectMetadata>

可匯出及部署的函式。