KeyValueStoreClientAsync

Async sub-client for manipulating a single key-value store.

Index

Methods

• delete
• delete_record
• get
• get_record
• get_record_as_bytes
• list_keys
• set_record
• stream_record
• update

Methods

delete

• async delete(): None

• Delete the key-value store.

  https://docs.apify.com/api/v2#/reference/key-value-stores/store-object/delete-store

  ---

  Returns None

delete_record

• async delete_record(key): None

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

  https://docs.apify.com/api/v2#/reference/key-value-stores/record/delete-record

  ---

  Parameters

  • key: str

    The key of the record which to delete.

  Returns None

get

• async get(): dict | None

• Retrieve the key-value store.

  https://docs.apify.com/api/v2#/reference/key-value-stores/store-object/get-store

  ---

  Returns dict | None

get_record

• async get_record(key): dict | None

• Retrieve the given record from the key-value store.

  https://docs.apify.com/api/v2#/reference/key-value-stores/record/get-record

  ---

  Parameters

  • key: str

    Key of the record to retrieve.

  Returns dict | None

get_record_as_bytes

• async get_record_as_bytes(key): dict | None

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

  https://docs.apify.com/api/v2#/reference/key-value-stores/record/get-record

  ---

  Parameters

  • key: str

    Key of the record to retrieve.

  Returns dict | None

list_keys

• async list_keys(*, limit, exclusive_start_key, collection, prefix): dict

• List the keys in the key-value store.

  https://docs.apify.com/api/v2#/reference/key-value-stores/key-collection/get-list-of-keys

  ---

  Parameters

  • optionalkeyword-onlylimit: int | None = None

    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.

  • optionalkeyword-onlycollection: str | None = None

    The name of the collection in store schema to list keys from.

  • optionalkeyword-onlyprefix: str | None = None

    The prefix of the keys to be listed.

  Returns dict

set_record

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

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

  https://docs.apify.com/api/v2#/reference/key-value-stores/record/put-record

  ---

  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): AsyncIterator[dict | None]

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

  https://docs.apify.com/api/v2#/reference/key-value-stores/record/get-record

  ---

  Parameters

  • key: str

    Key of the record to retrieve.

  Returns AsyncIterator[dict | None]

update

• async update(*, name, general_access): dict

• Update the key-value store with specified fields.

  https://docs.apify.com/api/v2#/reference/key-value-stores/store-object/update-store

  ---

  Parameters

  • optionalkeyword-onlyname: str | None = None

    The new name for key-value store.

  • optionalkeyword-onlygeneral_access: StorageGeneralAccess | None = None

    Determines how others can access the key-value store.

  Returns dict