建立金鑰值存放區

您可以同時建立索引鍵值存放區及其鍵值對。您還可以立即創建一個空的密鑰值存儲，然後稍後添加鍵值對。

注意

如果您從 Amazon S3 儲存貯體指定資料來源，則必須擁有該儲存貯體的s3:GetObject和s3:GetBucketLocation許可。如果您沒有這些權限，則 CloudFront 無法成功建立金鑰值存放區。

決定是否要在建立索引鍵值存放區時同時新增索引鍵值對。您可以使用 CloudFront 控制台、 CloudFrontAPI或 AWS SDKs來匯入鍵值配對。但是，您只能在最初建立索引鍵值存放區時匯入索引鍵值配對檔案。

若要建立鍵值配對的檔案，請參閱鍵值對的檔案格式。

Console

建立鍵值存放區的步驟

1. 登入 AWS Management Console 並在主 CloudFront 控台中開啟「功能」頁面，位於https://console.aws.amazon.com/cloudfront/v4/home#/functions。

2. 選擇索KeyValueStores引標籤，然後選擇 [建立] KeyValueStore。

3. 輸入鍵值存放區的名稱，以及選擇性的描述。

4. 完成 S3 URI：

   • 如果您有索引鍵值配對的檔案，請輸入存放該檔案的 Amazon S3 儲存貯體的路徑。

   • 如果您打算手動輸入鍵值對，請將此欄位保留空白。

5. 選擇 Create (建立)。鍵值存儲現在存在。

   此時會顯示新鍵值存放區的詳細資訊頁面。頁面上的資訊包括金鑰值存放區ARN的 ID 和。

   • ID 是字元的隨機字串，在您的 AWS 帳戶.

   • ARN有這樣的語法：

     AWS 帳戶:key-value-store/the key value stores ID

6. 請查看鍵值對區段。如果您匯入了檔案，本節會顯示一些鍵值配對。您可以執行下列作業：

   • 如果您匯入了檔案，也可以手動加入更多值。

   • 如果您沒有從 Amazon S3 儲存貯體匯入檔案，而且現在想要新增金鑰-值配對，則可以完成下一個步驟。

   • 您可以略過此步驟，稍後再新增索引鍵值配對。

7. 立即新增鍵值對：

   1. 選擇新增鍵值配對。

   2. 選擇新增配對，然後輸入名稱和值。重複此步驟以新增更多配對。

   3. 完成後，選擇 [儲存變更] 以儲存索引鍵值存放區中的所有鍵值組。在出現的對話方塊中，選擇「完成」。

8. 若要立即將索引鍵值存放區與函數相關聯，請完成「關聯函數」區段。如需詳細資訊，請參閱 建立函數 或 更新功能。

   您也可以稍後從此索引鍵值儲存庫詳細資訊頁面或從函數的詳細資訊頁面關聯函數。

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

建立鍵值存放區的步驟

1. 使用CloudFrontCreateKeyValueStore操作。該操作需要幾個參數：

   • 鍵值存儲name的 A。

   • 包含註解的 comment 參數。

   • 一種import-source參數，可讓您從存放在 Amazon S3 儲存貯體中的檔案匯入金鑰-值配對。僅當您第一次建立金鑰值存放區時，才能從檔案匯入。如需檔案結構的資訊，請參閱鍵值對的檔案格式。

操作回應包含下列資訊：

• 請求中傳遞的值，包括您指派的名稱。

• 建立時間等資料。

• 包含索引鍵值存放區名稱的 ETag (例如，ETVABCEXAMPLE) 的 (例如，arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1)。ARN

  您將使用、和名稱的某些組合 ETagARN，以程式設計方式處理索引鍵值存放區。

關鍵值存儲狀態

當您建立索引鍵值存放區時，資料倉庫可以具有下列狀態值。

Value	描述
佈建	已建立索引鍵值存放區，並 CloudFront 正在處理您指定的資料來源。
備妥	已建立索引鍵值存放區，並 CloudFront 成功處理您指定的資料來源。
匯入失敗	CloudFront 無法處理您指定的資料來源。如果您的檔案格式無效或超過大小限制，就會顯示此狀態。如需詳細資訊，請參閱鍵值對的檔案格式。