CloudFrontKeyValueStore / Client / put_key

put_key#

CloudFrontKeyValueStore.Client.put_key(**kwargs)#

Creates a new key value pair or replaces the value of an existing key.

See also: AWS API Documentation

Request Syntax

response = client.put_key(
    Key='string',
    Value='string',
    KvsARN='string',
    IfMatch='string'
)
Parameters:
  • Key (string) –

    [REQUIRED]

    The key to put.

  • Value (string) –

    [REQUIRED]

    The value to put.

  • KvsARN (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the Key Value Store.

  • IfMatch (string) –

    [REQUIRED]

    The current version (ETag) of the Key Value Store that you are putting keys into, which you can get using DescribeKeyValueStore.

Return type:

dict

Returns:

Response Syntax

{
    'ItemCount': 123,
    'TotalSizeInBytes': 123,
    'ETag': 'string'
}

Response Structure

  • (dict) –

    Metadata information about a Key Value Store.

    • ItemCount (integer) –

      Number of key value pairs in the Key Value Store after the successful put.

    • TotalSizeInBytes (integer) –

      Total size of the Key Value Store after the successful put, in bytes.

    • ETag (string) –

      The current version identifier of the Key Value Store after the successful put.

Exceptions

  • CloudFrontKeyValueStore.Client.exceptions.ConflictException

  • CloudFrontKeyValueStore.Client.exceptions.ValidationException

  • CloudFrontKeyValueStore.Client.exceptions.InternalServerException

  • CloudFrontKeyValueStore.Client.exceptions.ServiceQuotaExceededException

  • CloudFrontKeyValueStore.Client.exceptions.ResourceNotFoundException

  • CloudFrontKeyValueStore.Client.exceptions.AccessDeniedException