KeyValueStoreClient

Sub-client for manipulating a single key-value store.

Hierarchy

• ResourceClient
  • KeyValueStoreClient

Index

Methods

• __init__
• delete
• delete_record
• get
• get_record
• list_keys
• set_record
• update

Methods

__init__

• __init__(args, kwargs): None

• Overrides ResourceClient.__init__

  Initialize the KeyValueStoreClient.

  ---

  Parameters

  • args: Any

  • kwargs: Any

  Returns None

delete

• 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

• 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

• get(): Optional[Dict]

• Retrieve the key-value store.

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

  ---

  Returns Optional[Dict]

  dict, optional: The retrieved key-value store, or None if it does not exist

get_record

• get_record(key, *, as_bytes, as_file): Optional[Dict]

• 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

  • optionalkeyword-onlyas_bytes: bool = False

    Whether to retrieve the record as unparsed bytes, default False

  • optionalkeyword-onlyas_file: bool = False

    Whether to retrieve the record as a file-like object, default False

  Returns Optional[Dict]

  dict, optional: The requested record, or None, if the record does not exist

list_keys

• list_keys(*, limit, exclusive_start_key): 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: Optional[int] = None

    Number of keys to be returned. Maximum value is 1000

  • optionalkeyword-onlyexclusive_start_key: Optional[str] = None

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

  Returns Dict

  dict: The list of keys in the key-value store matching the given arguments

set_record

• 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: Optional[str] = None

    The content type of the saved value

  Returns None

update

• update(*, name): 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: Optional[str] = None

    The new name for key-value store

  Returns Dict

  dict: The updated key-value store