本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CloudFront SaaS Manager 屬性的協助程式方法
使用 CloudFront SaaS Manager 的下列協助程式函數,在您建立的函數中擷取多租戶分佈的值。若要在此頁面上使用範例,您必須先使用 JavaScript 執行期 2.0 建立 CloudFront 函數。如需更多詳細資訊,適用於 CloudFront Functions 的 JavaScript 執行期 2.0 功能。
連線群組
與分發租用戶相關聯的連線群組具有網域名稱。
若要取得此值,請使用事件物件context
子物件的 endpoint
欄位。
請求
const value = event.context.endpoint;
回應
回應是string
包含連線群組網域名稱的 ,例如 d111111abcdef8.cloudfront.net。只有當您的函數被叫用具有關聯連線群組的多租戶分佈時, endpoint
欄位才會出現。如需詳細資訊,請參閱內容物件。
分佈租用戶
CloudFront Functions 有一個模組,可讓您存取特定的分佈租用戶值。
若要使用此模組,請在函數程式碼的第一行中包含下列陳述式:
import cf from 'cloudfront';
您只能在 handler
函數中直接或透過任何巢狀呼叫函數使用下列範例。
distributionTenant.id
欄位
使用此欄位來取得分佈租用戶 ID 的值。
請求
const value = cf.distributionTenant.id;
回應
回應是包含分佈租用戶 ID string
的 ,例如 dt_1a2b3c4d5e6f7
。
錯誤處理
如果您的函數是針對標準分佈叫用,則指定 distributionTenant.id
欄位將傳回distributionTenant module is not available
類型錯誤。若要處理此使用案例,您可以將 try
和 catch
區塊新增至程式碼。
distributionTenant.parameters.get()
方法
使用此方法可傳回您指定之分佈租用戶參數名稱的值。
distributionTenant.parameters.get("key");
key
:您要為其擷取值的分佈租用戶參數名稱。
請求
const value = distributionTenant.parameters.get("key");
回應
回應是 string
,其中包含分佈租用戶參數的值。例如,如果您的金鑰名稱為 TenantPath
,則此參數的值可能是 tenant1
。
錯誤處理
您可能會收到下列錯誤:
-
如果您的函數是針對標準分佈叫用,則
distributionTenant.parameters.get()
方法會傳回distributionTenant module is not available
類型錯誤。 -
當您指定的分佈租用戶參數不存在時,會傳回
DistributionTenantParameterKeyNotFound
錯誤。
若要管理這些使用案例,您可以將 try
和 catch
區塊新增至程式碼。