awswrangler.s3.wait_objects_not_exist

awswrangler.s3.wait_objects_not_exist(paths: List[str], delay: Optional[Union[int, float]] = None, max_attempts: Optional[int] = None, use_threads: bool = True, boto3_session: Optional[boto3.session.Session] = None) → None

Wait Amazon S3 objects not exist.

Polls S3.Client.head_object() every 5 seconds (default) until a successful state is reached. An error is returned after 20 (default) failed checks. https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3.html#S3.Waiter.ObjectNotExists

Note

In case of use_threads=True the number of threads that will be spawned will be get from os.cpu_count().

Parameters
  • paths (List[str]) – List of S3 objects paths (e.g. [s3://bucket/key0, s3://bucket/key1]).

  • delay (Union[int,float], optional) – The amount of time in seconds to wait between attempts. Default: 5

  • max_attempts (int, optional) – The maximum number of attempts to be made. Default: 20

  • use_threads (bool) – True to enable concurrent requests, False to disable multiple threads. If enabled os.cpu_count() will be used as the max number of threads.

  • boto3_session (boto3.Session(), optional) – Boto3 Session. The default boto3 session will be used if boto3_session receive None.

Returns

None.

Return type

None

Examples

>>> import awswrangler as wr
>>> wr.s3.wait_objects_not_exist(['s3://bucket/key0', 's3://bucket/key1'])  # wait both objects not exist