獲取對鍵值存儲的引用 - Amazon CloudFront

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

獲取對鍵值存儲的引用

若要以程式設計方式使用索引鍵值儲存，您需要索引鍵值存放區的名稱ETag和名稱。

若要取得這兩個值，您可以使用 AWS Command Line Interface (AWS CLI) 或 CloudFront API.

AWS CLI
獲取鍵值存儲引用

  1. 若要傳回索引鍵值存放區的清單，請執行下列命令尋找您要變更的金鑰值存放區名稱。

    aws cloudfront list-key-value-stores

  2. 從回應中，尋找您想要的金鑰值存放區名稱。

    回應

    {
    "KeyValueStoreList": {
        "Items": [
            {
                "Name": "keyvaluestore3",
                "Id": "37435e19-c205-4271-9e5c-example3",
                "ARN": "arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example3",
                "Status": "READY",
                "LastModifiedTime": "2024-05-08T14:50:18.876000+00:00"
            },
            {
                "Name": "keyvaluestore2",
                "Id": "47970d59-6408-474d-b850-example2",
                "ARN": "arn:aws:cloudfront::123456789012:key-value-store/47970d59-6408-474d-b850-example2",
                "Status": "READY",
                "LastModifiedTime": "2024-05-30T21:06:22.113000+00:00"
            },
            {
                "Name": "keyvaluestore1",
                "Id": "8aa76c93-3198-462c-aaf6-example",
                "ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
                "Status": "READY",
                "LastModifiedTime": "2024-08-06T22:19:30.510000+00:00"
            }
        ]
    }
}

  3. 執行下列命令，以傳回指定ETag索引鍵值存放區的。

    aws cloudfront describe-key-value-store \
    --name=keyvaluestore1

    回應

    {
    "ETag": "E3UN6WX5RRO2AG",
    "KeyValueStore": {
        "Name": "keyvaluestore1",
        "Id": "8aa76c93-3198-462c-aaf6-example",
        "Comment": "This is an example KVS",
        "ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
        "Status": "READY",
        "LastModifiedTime": "2024-08-06T22:19:30.510000+00:00"
    }
}
API
獲取鍵值存儲引用

  1. 使用該CloudFront ListKeyValueStoresAPI操作返回鍵值存儲的列表。尋找您要變更的金鑰值存放區名稱。

  2. 使用CloudFront DescribeKeyValueStoreAPI作業並指定您從上一個步驟傳回的金鑰值存放區名稱。

回應包括UUID、索引鍵值存放區ARN的，以及索引鍵值存放區ETag的。

  • 一個ETag，如 E3UN6WX5RRO2AG

  • 這UUID是 128 位元，例如 8aa76c93-3198-462c-aaf6-example

  • 包ARN括 AWS 帳戶 數字、常數和key-value-store，如下列範例所示：UUID

    arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example

如需有關DescribeKeyValueStore作業的更多資訊，請參閱關於 CloudFront KeyValueStore。