CreateKeyValueStore - Amazon CloudFront

CreateKeyValueStore

Specifies the key value store resource to add to your account. In your account, the key value store names must be unique. You can also import key value store data in JSON format from an S3 bucket by providing a valid ImportSource that you own.

Request Syntax

POST /2020-05-31/key-value-store/ HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <CreateKeyValueStoreRequest xmlns="http://cloudfront.amazonaws.com/doc/2020-05-31/"> <Comment>string</Comment> <ImportSource> <SourceARN>string</SourceARN> <SourceType>string</SourceType> </ImportSource> <Name>string</Name> </CreateKeyValueStoreRequest>

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in XML format.

CreateKeyValueStoreRequest

Root level tag for the CreateKeyValueStoreRequest parameters.

Required: Yes

Comment

The comment of the key value store.

Type: String

Length Constraints: Maximum length of 128.

Required: No

ImportSource

The S3 bucket that provides the source for the import. The source must be in a valid JSON format.

Type: ImportSource object

Required: No

Name

The name of the key value store. The minimum length is 1 character and the maximum length is 64 characters.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: ^[a-zA-Z0-9-_]{1,64}$

Required: Yes

Response Syntax

HTTP/1.1 201 <?xml version="1.0" encoding="UTF-8"?> <KeyValueStore> <ARN>string</ARN> <Comment>string</Comment> <Id>string</Id> <LastModifiedTime>timestamp</LastModifiedTime> <Name>string</Name> <Status>string</Status> </KeyValueStore>

Response Elements

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in XML format by the service.

KeyValueStore

Root level tag for the KeyValueStore parameters.

Required: Yes

ARN

The Amazon Resource Name (ARN) of the key value store.

Type: String

Comment

A comment for the key value store.

Type: String

Id

The unique Id for the key value store.

Type: String

LastModifiedTime

The last-modified time of the key value store.

Type: Timestamp

Name

The name of the key value store.

Type: String

Status

The status of the key value store.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDenied

Access denied.

HTTP Status Code: 403

EntityAlreadyExists

The key value store entity already exists. You must provide a unique key value store entity.

HTTP Status Code: 409

EntityLimitExceeded

The key value store entity limit has been exceeded.

HTTP Status Code: 400

EntitySizeLimitExceeded

The key value store entity size limit was exceeded.

HTTP Status Code: 413

InvalidArgument

An argument is invalid.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: