KeyValueStoreClient

Subclient for manipulating a single key-value store.

Hierarchy

• BaseKeyValueStoreClient
  • KeyValueStoreClient

Index

Methods

• __init__
• delete
• delete_persisted_record
• delete_record
• get
• get_public_url
• get_record
• get_record_as_bytes
• list_keys
• persist_record
• set_record
• stream_record
• update
• update_timestamps

Properties

• resource_directory
• resource_info

Methods

__init__

• __init__(*, memory_storage_client, id, name, created_at, accessed_at, modified_at): None

• Parameters

  • keyword-onlymemory_storage_client: MemoryStorageClient

  • optionalkeyword-onlyid: str | None = None

  • optionalkeyword-onlyname: str | None = None

  • optionalkeyword-onlycreated_at: datetime | None = None

  • optionalkeyword-onlyaccessed_at: datetime | None = None

  • optionalkeyword-onlymodified_at: datetime | None = None

  Returns None

delete

• async delete(): None

• Overrides BaseKeyValueStoreClient.delete

  Permanently delete the key-value store managed by this client.

  ---

  Returns None

delete_persisted_record

• async delete_persisted_record(record): None

• Delete the specified record from the key-value store.

  ---

  Parameters

  • record: KeyValueStoreRecord

  Returns None

delete_record

• async delete_record(key): None

• Overrides BaseKeyValueStoreClient.delete_record

  Delete the specified record from the key-value store.

  ---

  Parameters

  • key: str

    The key of the record which to delete.

  Returns None

get

• async get(): KeyValueStoreMetadata | None

• Overrides BaseKeyValueStoreClient.get

  Get metadata about the key-value store being managed by this client.

  ---

  Returns KeyValueStoreMetadata | None

get_public_url

• async get_public_url(key): str

• Overrides BaseKeyValueStoreClient.get_public_url

  Get the public URL for the given key.

  ---

  Parameters

  • key: str

    Key of the record for which URL is required.

  Returns str

get_record

• async get_record(key): KeyValueStoreRecord | None

• Overrides BaseKeyValueStoreClient.get_record

  Retrieve the given record from the key-value store.

  ---

  Parameters

  • key: str

    Key of the record to retrieve.

  Returns KeyValueStoreRecord | None

get_record_as_bytes

• async get_record_as_bytes(key): KeyValueStoreRecord[bytes] | None

• Overrides BaseKeyValueStoreClient.get_record_as_bytes

  Retrieve the given record from the key-value store, without parsing it.

  ---

  Parameters

  • key: str

    Key of the record to retrieve.

  Returns KeyValueStoreRecord[bytes] | None

list_keys

• async list_keys(*, limit, exclusive_start_key): KeyValueStoreListKeysPage

• Overrides BaseKeyValueStoreClient.list_keys

  List the keys in the key-value store.

  ---

  Parameters

  • optionalkeyword-onlylimit: int = 1000

    Number of keys to be returned. Maximum value is 1000.

  • optionalkeyword-onlyexclusive_start_key: str | None = None

    All keys up to this one (including) are skipped from the result.

  Returns KeyValueStoreListKeysPage

persist_record

• async persist_record(record): None

• Persist the specified record to the key-value store.

  ---

  Parameters

  • record: KeyValueStoreRecord

  Returns None

set_record

• async set_record(key, value, content_type): None

• Overrides BaseKeyValueStoreClient.set_record

  Set a value to the given record in the key-value store.

  ---

  Parameters

  • key: str

    The key of the record to save the value to.

  • value: Any

    The value to save into the record.

  • optionalcontent_type: str | None = None

    The content type of the saved value.

  Returns None

stream_record

• async stream_record(key): AbstractAsyncContextManager[KeyValueStoreRecord[Response] | None]

• Overrides BaseKeyValueStoreClient.stream_record

  Retrieve the given record from the key-value store, as a stream.

  ---

  Parameters

  • key: str

    Key of the record to retrieve.

  Returns AbstractAsyncContextManager[KeyValueStoreRecord[Response] | None]

update

• async update(*, name): KeyValueStoreMetadata

• Overrides BaseKeyValueStoreClient.update

  Update the key-value store metadata.

  ---

  Parameters

  • optionalkeyword-onlyname: str | None = None

    New new name for the key-value store.

  Returns KeyValueStoreMetadata

update_timestamps

• async update_timestamps(*, has_been_modified): None

• Update the timestamps of the key-value store.

  ---

  Parameters

  • keyword-onlyhas_been_modified: bool

  Returns None

Properties

resource_directory

resource_directory: str

Get the resource directory for the client.

resource_info

resource_info: KeyValueStoreMetadata

Get the resource info for the key-value store client.