Sign in

Creates a key-value snapshot.

Creates a key-value snapshot.

put/snapshots/{name}

Path parameters

namestring required

The name of the key-value snapshot to create.

Query parameters

api-versionstring required

The API version to use for this operation.

Headers

Sync-Tokenstring

Used to guarantee real-time consistency between requests.

Request body

namestring required

The name of the snapshot.

status'provisioning' | 'ready' | 'archived' | 'failed'

Snapshot status.

composition_type'key' | 'key_label'

Composition types.

createdstring date-time

The time that the snapshot was created.

expiresstring date-time

The time that the snapshot will expire.

retention_periodinteger

The amount of time, in seconds, that a snapshot will remain in the archived state before expiring. This property is only writable during the creation of a snapshot. If not specified, the default lifetime of key-value revisions will be used.

sizeinteger

The size in bytes of the snapshot.

items_countinteger

The amount of key-values in the snapshot.

tagsobject

The tags of the snapshot.

descriptionstring

The description of the snapshot.

etagstring

A value representing the current state of the snapshot.

Response

The request has succeeded and a new resource has been created as a result.

namestring required

The name of the snapshot.

status'provisioning' | 'ready' | 'archived' | 'failed'

Snapshot status.

composition_type'key' | 'key_label'

Composition types.

createdstring date-time

The time that the snapshot was created.

expiresstring date-time

The time that the snapshot will expire.

retention_periodinteger

The amount of time, in seconds, that a snapshot will remain in the archived state before expiring. This property is only writable during the creation of a snapshot. If not specified, the default lifetime of key-value revisions will be used.

sizeinteger

The size in bytes of the snapshot.

items_countinteger

The amount of key-values in the snapshot.

tagsobject

The tags of the snapshot.

descriptionstring

The description of the snapshot.

etagstring

A value representing the current state of the snapshot.

Changes

Changed in 2 of the 4 revisions of this API.11