{ "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
" }