{ "version":"2.0", "metadata":{ "apiVersion":"2022-07-26", "endpointPrefix":"cloudfront-keyvaluestore", "jsonVersion":"1.1", "protocol":"rest-json", "serviceFullName":"Amazon CloudFront KeyValueStore", "serviceId":"CloudFront KeyValueStore", "signatureVersion":"v4", "signingName":"cloudfront-keyvaluestore", "uid":"cloudfront-keyvaluestore-2022-07-26" }, "operations":{ "DeleteKey":{ "name":"DeleteKey", "http":{ "method":"DELETE", "requestUri":"/key-value-stores/{KvsARN}/keys/{Key}", "responseCode":200 }, "input":{"shape":"DeleteKeyRequest"}, "output":{"shape":"DeleteKeyResponse"}, "errors":[ {"shape":"ConflictException"}, {"shape":"ValidationException"}, {"shape":"InternalServerException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Deletes the key value pair specified by the key.

", "idempotent":true }, "DescribeKeyValueStore":{ "name":"DescribeKeyValueStore", "http":{ "method":"GET", "requestUri":"/key-value-stores/{KvsARN}", "responseCode":200 }, "input":{"shape":"DescribeKeyValueStoreRequest"}, "output":{"shape":"DescribeKeyValueStoreResponse"}, "errors":[ {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Returns metadata information about Key Value Store.

" }, "GetKey":{ "name":"GetKey", "http":{ "method":"GET", "requestUri":"/key-value-stores/{KvsARN}/keys/{Key}", "responseCode":200 }, "input":{"shape":"GetKeyRequest"}, "output":{"shape":"GetKeyResponse"}, "errors":[ {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Returns a key value pair.

" }, "ListKeys":{ "name":"ListKeys", "http":{ "method":"GET", "requestUri":"/key-value-stores/{KvsARN}/keys", "responseCode":200 }, "input":{"shape":"ListKeysRequest"}, "output":{"shape":"ListKeysResponse"}, "errors":[ {"shape":"ConflictException"}, {"shape":"ValidationException"}, {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Returns a list of key value pairs.

" }, "PutKey":{ "name":"PutKey", "http":{ "method":"PUT", "requestUri":"/key-value-stores/{KvsARN}/keys/{Key}", "responseCode":200 }, "input":{"shape":"PutKeyRequest"}, "output":{"shape":"PutKeyResponse"}, "errors":[ {"shape":"ConflictException"}, {"shape":"ValidationException"}, {"shape":"InternalServerException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"} ], "documentation":"

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

", "idempotent":true }, "UpdateKeys":{ "name":"UpdateKeys", "http":{ "method":"POST", "requestUri":"/key-value-stores/{KvsARN}/keys", "responseCode":200 }, "input":{"shape":"UpdateKeysRequest"}, "output":{"shape":"UpdateKeysResponse"}, "errors":[ {"shape":"ConflictException"}, {"shape":"ValidationException"}, {"shape":"InternalServerException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Puts or Deletes multiple key value pairs in a single, all-or-nothing operation.

", "idempotent":true } }, "shapes":{ "AccessDeniedException":{ "type":"structure", "members":{ "Message":{"shape":"String"} }, "documentation":"

Access denied.

", "error":{ "httpStatusCode":403, "senderFault":true }, "exception":true }, "ConflictException":{ "type":"structure", "members":{ "Message":{"shape":"String"} }, "documentation":"

Resource is not in expected state.

", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true }, "DeleteKeyRequest":{ "type":"structure", "required":[ "KvsARN", "Key", "IfMatch" ], "members":{ "KvsARN":{ "shape":"KvsARN", "documentation":"

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

", "contextParam":{"name":"KvsARN"}, "location":"uri", "locationName":"KvsARN" }, "Key":{ "shape":"Key", "documentation":"

The key to delete.

", "location":"uri", "locationName":"Key" }, "IfMatch":{ "shape":"Etag", "documentation":"

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

", "location":"header", "locationName":"If-Match" } } }, "DeleteKeyRequestListItem":{ "type":"structure", "required":["Key"], "members":{ "Key":{ "shape":"Key", "documentation":"

The key of the key value pair to be deleted.

" } }, "documentation":"

List item for keys to delete.

" }, "DeleteKeyRequestsList":{ "type":"list", "member":{"shape":"DeleteKeyRequestListItem"} }, "DeleteKeyResponse":{ "type":"structure", "required":[ "ItemCount", "TotalSizeInBytes", "ETag" ], "members":{ "ItemCount":{ "shape":"Integer", "documentation":"

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

" }, "TotalSizeInBytes":{ "shape":"Long", "documentation":"

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

" }, "ETag":{ "shape":"Etag", "documentation":"

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

", "location":"header", "locationName":"ETag" } }, "documentation":"

Metadata information about a Key Value Store.

" }, "DescribeKeyValueStoreRequest":{ "type":"structure", "required":["KvsARN"], "members":{ "KvsARN":{ "shape":"KvsARN", "documentation":"

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

", "contextParam":{"name":"KvsARN"}, "location":"uri", "locationName":"KvsARN" } } }, "DescribeKeyValueStoreResponse":{ "type":"structure", "required":[ "ItemCount", "TotalSizeInBytes", "KvsARN", "Created", "ETag" ], "members":{ "ItemCount":{ "shape":"Integer", "documentation":"

Number of key value pairs in the Key Value Store.

" }, "TotalSizeInBytes":{ "shape":"Long", "documentation":"

Total size of the Key Value Store in bytes.

" }, "KvsARN":{ "shape":"KvsARN", "documentation":"

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

" }, "Created":{ "shape":"Timestamp", "documentation":"

Date and time when the Key Value Store was created.

" }, "ETag":{ "shape":"Etag", "documentation":"

The version identifier for the current version of the Key Value Store.

", "location":"header", "locationName":"ETag" }, "LastModified":{ "shape":"Timestamp", "documentation":"

Date and time when the key value pairs in the Key Value Store was last modified.

" }, "Status":{ "shape":"String", "documentation":"

The current status of the Key Value Store.

" }, "FailureReason":{ "shape":"String", "documentation":"

The reason for Key Value Store creation failure.

" } }, "documentation":"

Metadata information about a Key Value Store.

" }, "Etag":{"type":"string"}, "GetKeyRequest":{ "type":"structure", "required":[ "KvsARN", "Key" ], "members":{ "KvsARN":{ "shape":"KvsARN", "documentation":"

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

", "contextParam":{"name":"KvsARN"}, "location":"uri", "locationName":"KvsARN" }, "Key":{ "shape":"Key", "documentation":"

The key to get.

", "location":"uri", "locationName":"Key" } } }, "GetKeyResponse":{ "type":"structure", "required":[ "Key", "Value", "ItemCount", "TotalSizeInBytes" ], "members":{ "Key":{ "shape":"Key", "documentation":"

The key of the key value pair.

" }, "Value":{ "shape":"Value", "documentation":"

The value of the key value pair.

" }, "ItemCount":{ "shape":"Integer", "documentation":"

Number of key value pairs in the Key Value Store.

" }, "TotalSizeInBytes":{ "shape":"Long", "documentation":"

Total size of the Key Value Store in bytes.

" } }, "documentation":"

A key value pair.

" }, "Integer":{ "type":"integer", "box":true }, "InternalServerException":{ "type":"structure", "members":{ "Message":{"shape":"String"} }, "documentation":"

Internal server error.

", "error":{"httpStatusCode":500}, "exception":true, "fault":true }, "Key":{ "type":"string", "max":1024, "min":1 }, "KvsARN":{ "type":"string", "max":2048, "min":1 }, "ListKeysRequest":{ "type":"structure", "required":["KvsARN"], "members":{ "KvsARN":{ "shape":"KvsARN", "documentation":"

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

", "contextParam":{"name":"KvsARN"}, "location":"uri", "locationName":"KvsARN" }, "NextToken":{ "shape":"String", "documentation":"

If nextToken is returned in the response, there are more results available. Make the next call using the returned token to retrieve the next page.

", "location":"querystring", "locationName":"NextToken" }, "MaxResults":{ "shape":"ListKeysRequestMaxResultsInteger", "documentation":"

Maximum number of results that are returned per call. The default is 10 and maximum allowed page is 50.

", "location":"querystring", "locationName":"MaxResults" } } }, "ListKeysRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":50, "min":1 }, "ListKeysResponse":{ "type":"structure", "members":{ "NextToken":{ "shape":"String", "documentation":"

If nextToken is returned in the response, there are more results available. Make the next call using the returned token to retrieve the next page.

" }, "Items":{ "shape":"ListKeysResponseList", "documentation":"

Key value pairs

" } } }, "ListKeysResponseList":{ "type":"list", "member":{"shape":"ListKeysResponseListItem"} }, "ListKeysResponseListItem":{ "type":"structure", "required":[ "Key", "Value" ], "members":{ "Key":{ "shape":"Key", "documentation":"

The key of the key value pair.

" }, "Value":{ "shape":"Value", "documentation":"

The value of the key value pair.

" } }, "documentation":"

A key value pair.

" }, "Long":{ "type":"long", "box":true }, "PutKeyRequest":{ "type":"structure", "required":[ "Key", "Value", "KvsARN", "IfMatch" ], "members":{ "Key":{ "shape":"Key", "documentation":"

The key to put.

", "location":"uri", "locationName":"Key" }, "Value":{ "shape":"Value", "documentation":"

The value to put.

" }, "KvsARN":{ "shape":"KvsARN", "documentation":"

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

", "contextParam":{"name":"KvsARN"}, "location":"uri", "locationName":"KvsARN" }, "IfMatch":{ "shape":"Etag", "documentation":"

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

", "location":"header", "locationName":"If-Match" } }, "documentation":"

A key value pair.

" }, "PutKeyRequestListItem":{ "type":"structure", "required":[ "Key", "Value" ], "members":{ "Key":{ "shape":"Key", "documentation":"

The key of the key value pair list item to put.

" }, "Value":{ "shape":"Value", "documentation":"

The value for the key value pair to put.

" } }, "documentation":"

List item for key value pair to put.

" }, "PutKeyRequestsList":{ "type":"list", "member":{"shape":"PutKeyRequestListItem"} }, "PutKeyResponse":{ "type":"structure", "required":[ "ItemCount", "TotalSizeInBytes", "ETag" ], "members":{ "ItemCount":{ "shape":"Integer", "documentation":"

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

" }, "TotalSizeInBytes":{ "shape":"Long", "documentation":"

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

" }, "ETag":{ "shape":"Etag", "documentation":"

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

", "location":"header", "locationName":"ETag" } }, "documentation":"

Metadata information about a Key Value Store.

" }, "ResourceNotFoundException":{ "type":"structure", "members":{ "Message":{"shape":"String"} }, "documentation":"

Resource was not found.

", "error":{ "httpStatusCode":404, "senderFault":true }, "exception":true }, "ServiceQuotaExceededException":{ "type":"structure", "members":{ "Message":{"shape":"String"} }, "documentation":"

Limit exceeded.

", "error":{ "httpStatusCode":402, "senderFault":true }, "exception":true }, "String":{"type":"string"}, "Timestamp":{"type":"timestamp"}, "UpdateKeysRequest":{ "type":"structure", "required":[ "KvsARN", "IfMatch" ], "members":{ "KvsARN":{ "shape":"KvsARN", "documentation":"

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

", "contextParam":{"name":"KvsARN"}, "location":"uri", "locationName":"KvsARN" }, "IfMatch":{ "shape":"Etag", "documentation":"

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

", "location":"header", "locationName":"If-Match" }, "Puts":{ "shape":"PutKeyRequestsList", "documentation":"

List of key value pairs to put.

" }, "Deletes":{ "shape":"DeleteKeyRequestsList", "documentation":"

List of keys to delete.

" } } }, "UpdateKeysResponse":{ "type":"structure", "required":[ "ItemCount", "TotalSizeInBytes", "ETag" ], "members":{ "ItemCount":{ "shape":"Integer", "documentation":"

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

" }, "TotalSizeInBytes":{ "shape":"Long", "documentation":"

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

" }, "ETag":{ "shape":"Etag", "documentation":"

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

", "location":"header", "locationName":"ETag" } }, "documentation":"

Metadata information about a Key Value Store.

" }, "ValidationException":{ "type":"structure", "members":{ "Message":{"shape":"String"} }, "documentation":"

Validation failed.

", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true }, "Value":{ "type":"string", "sensitive":true } }, "documentation":"

Amazon CloudFront KeyValueStore Service to View and Update Data in a KVS Resource

" }