建立鍵值存放區
您可以同時建立一個鍵值存放區及其鍵值對。您也可以建立一個空的鍵值存放區,並於稍後在其中新增鍵值對。
如果您從 Amazon S3 儲存貯體指定資料來源,就必須擁有該儲存貯體的 s3:GetObject 和 s3:GetBucketLocation 許可權限。如果您沒有這些許可權限,CloudFront 就無法成功建立您的鍵值存放區。
請決定是否要在建立鍵值存放區的同時新增鍵值對。您可以使用 CloudFront 主控台、CloudFront API 或 AWS SDK 匯入鍵值對。不過您只能在最初建立鍵值存放區時匯入鍵值對檔案。
若要建立鍵值對檔案,請參閱 鍵值對的檔案格式。
- Console
-
建立鍵值存放區
-
登入 AWS 管理主控台 並在位於 https://console.aws.amazon.com/cloudfront/v4/home#/functions 的 CloudFront 主控台中開啟 Functions (函數) 頁面。
-
選擇 KeyValueStores 索引標籤,然後選擇建立 KeyValueStore。
-
輸入鍵值存放區的名稱,以及選擇性的描述。
-
完成 S3 URI:
-
選擇建立。鍵值存放區現已建立。
此時會顯示新鍵值存放區的詳細資訊頁面。頁面上的資訊包括鍵值存放區的 ID 和 ARN。
-
請查看鍵值對區段。如果您匯入檔案,此區段會顯示一些鍵值對。您可以執行下列作業:
-
立即新增鍵值對:
-
選擇新增鍵值對。
-
選擇新增配對,然後輸入名稱和值。若要新增更多配對,請重複此步驟。
-
完成後,選擇儲存變更以儲存鍵值存放區中的所有鍵值對。在出現的對話方塊中選擇完成。
-
如果您要立即將鍵值存放區與函數相關聯,請完成關聯函數區段。如需詳細資訊,請參閱 建立函數 或 更新函數 。
您也可以稍後從此鍵值存放區詳細資訊頁面或從函數詳細資訊頁面與函數建立關聯。
- AWS CLI
-
建立鍵值存放區
-
您可執行下列命令來建立鍵值存放區,並從 Amazon S3 儲存貯體匯入鍵值對。
aws cloudfront create-key-value-store \
--name=keyvaluestore1 \
--comment="This is my key value store file" \
--import-source=SourceType=S3,SourceARN=arn:aws:s3:::amzn-s3-demo-bucket1/kvs-input.json
回應:
{
"ETag": "ETVABCEXAMPLE",
"Location": "https://cloudfront.amazonaws.com/2020-05-31/key-value-store/arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"KeyValueStore": {
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"Comment": "This is my key value store file",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "PROVISIONING",
"LastModifiedTime": "2024-08-06T22:19:10.813000+00:00"
}
}
- API
-
操作回應包含下列資訊:
鍵值存放區狀態
您建立鍵值存放區時,資料存放區可能有下列狀態值。
| 值 |
說明 |
|
佈建中
|
鍵值存放區已建立,CloudFront 正在處理您指定的資料來源。
|
|
備妥
|
鍵值存放區已建立,CloudFront 已成功處理您指定的資料來源。
|
|
匯入失敗
|
CloudFront 無法處理您指定的資料來源。如果您的檔案格式無效或超過大小限制,就會出現此狀態。如需更多詳細資訊,請參閱 鍵值對的檔案格式。
|