Obter uma referência a um armazenamento de chave-valor - Amazon CloudFront

Obter uma referência a um armazenamento de chave-valor

Para trabalhar com os armazenamentos de chave-valor de forma programática, é necessário ter a ETag e o nome do armazenamento de chave-valor.

Para ter os dois valores, é possível usar a AWS Command Line Interface (AWS CLI) ou a API do CloudFront.

AWS CLI
Como obter uma referência do armazenamento de chave-valor

  1. Para exibir uma lista de armazenamentos de chave-valor, execute o comando para encontrar o nome do armazenamento de chave-valor que deseja alterar.

    aws cloudfront list-key-value-stores

  2. Na resposta, encontre o nome do armazenamento de chave-valor desejado.

    Resposta

    {
    "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. Execute o comando a seguir para exibir a ETag do armazenamento de chave-valor especificado.

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

    Resposta

    {
    "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
Como obter uma referência do armazenamento de chave-valor

  1. Use a operação de API CloudFront ListKeyValueStores para retornar uma lista de armazenamentos de valores-chave. Encontre o nome do armazenamento de chave-valor que deseja alterar.

  2. Use a operação de API CloudFront DescribeKeyValueStore e especifique o nome do armazenamento de chave-valor que você retornou da etapa anterior.

A resposta inclui um UUID, o ARN do armazenamento de chave-valor e a ETag do armazenamento de chave-valor.

  • Uma ETag, como E3UN6WX5RRO2AG.

  • O UUID tem 128 bits, como 8aa76c93-3198-462c-aaf6-example.

  • O ARN inclui o número da Conta da AWS, o key-value-store constante e o UUID, como o seguinte exemplo:

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

Consulte mais informações sobre a operação DescribeKeyValueStore em Sobre o KeyValueStore do CloudFront.