toil 7.0.0__py3-none-any.whl → 8.1.0b1__py3-none-any.whl

toil/lib/aws/iam.py

@@ -3,83 +3,204 @@ import json
 import logging
 from collections import defaultdict
 from functools import lru_cache
-from typing import Dict, List, Optional, Union, cast
+from typing import TYPE_CHECKING, Any, Optional, Union
 
 import boto3
-from mypy_boto3_iam import IAMClient
-from mypy_boto3_iam.type_defs import (AttachedPolicyTypeDef,
-                                      PolicyDocumentDictTypeDef)
-from mypy_boto3_sts import STSClient
+from botocore.exceptions import ClientError
 
+from toil.lib.aws import AWSServerErrors, session
 from toil.lib.aws.session import client as get_client
+from toil.lib.misc import printq
+from toil.lib.retry import get_error_code, get_error_status, retry
+
+if TYPE_CHECKING:
+    from mypy_boto3_iam import IAMClient
+    from mypy_boto3_iam.type_defs import (
+        AttachedPolicyTypeDef,
+        PolicyDocumentDictTypeDef,
+    )
+    from mypy_boto3_sts import STSClient
 
 logger = logging.getLogger(__name__)
 
-#TODO Make this comprehensive
-CLUSTER_LAUNCHING_PERMISSIONS = ["iam:CreateRole",
-                                  "iam:CreateInstanceProfile",
-                                  "iam:TagInstanceProfile",
-                                  "iam:DeleteRole",
-                                  "iam:DeleteRoleProfile",
-                                  "iam:ListAttatchedRolePolicies",
-                                  "iam:ListPolicies",
-                                  "iam:ListRoleTags",
-                                  "iam:PassRole",
-                                  "iam:PutRolePolicy",
-                                  "iam:RemoveRoleFromInstanceProfile",
-                                  "iam:TagRole",
-                                  "ec2:AuthorizeSecurityGroupIngress",
-                                  "ec2:CancelSpotInstanceRequests",
-                                  "ec2:CreateSecurityGroup",
-                                  "ec2:CreateTags",
-                                  "ec2:DeleteSecurityGroup",
-                                  "ec2:DescribeAvailabilityZones",
-                                  "ec2:DescribeImages",
-                                  "ec2:DescribeInstances",
-                                  "ec2:DescribeInstanceStatus",
-                                  "ec2:DescribeKeyPairs",
-                                  "ec2:DescribeSecurityGroups",
-                                  "ec2:DescribeSpotInstanceRequests",
-                                  "ec2:DescribeSpotPriceHistory",
-                                  "ec2:DescribeVolumes",
-                                  "ec2:ModifyInstanceAttribute",
-                                  "ec2:RequestSpotInstances",
-                                  "ec2:RunInstances",
-                                  "ec2:StartInstances",
-                                  "ec2:StopInstances",
-                                  "ec2:TerminateInstances",
-                                  ]
-
-AllowedActionCollection = Dict[str, Dict[str, List[str]]]
+# TODO Make this comprehensive
+CLUSTER_LAUNCHING_PERMISSIONS = [
+    "iam:CreateRole",
+    "iam:CreateInstanceProfile",
+    "iam:TagInstanceProfile",
+    "iam:DeleteRole",
+    "iam:DeleteRoleProfile",
+    "iam:ListAttatchedRolePolicies",
+    "iam:ListPolicies",
+    "iam:ListRoleTags",
+    "iam:PassRole",
+    "iam:PutRolePolicy",
+    "iam:RemoveRoleFromInstanceProfile",
+    "iam:TagRole",
+    "ec2:AuthorizeSecurityGroupIngress",
+    "ec2:CancelSpotInstanceRequests",
+    "ec2:CreateSecurityGroup",
+    "ec2:CreateTags",
+    "ec2:DeleteSecurityGroup",
+    "ec2:DescribeAvailabilityZones",
+    "ec2:DescribeImages",
+    "ec2:DescribeInstances",
+    "ec2:DescribeInstanceStatus",
+    "ec2:DescribeKeyPairs",
+    "ec2:DescribeSecurityGroups",
+    "ec2:DescribeSpotInstanceRequests",
+    "ec2:DescribeSpotPriceHistory",
+    "ec2:DescribeVolumes",
+    "ec2:ModifyInstanceAttribute",
+    "ec2:RequestSpotInstances",
+    "ec2:RunInstances",
+    "ec2:StartInstances",
+    "ec2:StopInstances",
+    "ec2:TerminateInstances",
+]
+
+AllowedActionCollection = dict[str, dict[str, list[str]]]
+
+
+@retry(errors=[AWSServerErrors])
+def delete_iam_instance_profile(
+    instance_profile_name: str, region: Optional[str] = None, quiet: bool = True
+) -> None:
+    iam_resource = session.resource("iam", region_name=region)
+    instance_profile = iam_resource.InstanceProfile(instance_profile_name)
+    if instance_profile.roles is not None:
+        for role in instance_profile.roles:
+            printq(
+                f"Now dissociating role: {role.name} from instance profile {instance_profile_name}",
+                quiet,
+            )
+            instance_profile.remove_role(RoleName=role.name)
+    instance_profile.delete()
+    printq(f'Instance profile "{instance_profile_name}" successfully deleted.', quiet)
+
+
+@retry(errors=[AWSServerErrors])
+def delete_iam_role(
+    role_name: str, region: Optional[str] = None, quiet: bool = True
+) -> None:
+    """
+    Deletes an AWS IAM role. Any separate policies are detached from the role, and any inline policies are deleted.
+
+    :param role_name: The name of the AWS IAM role.
+    :param region: The AWS region that the role_name is in.
+    :param quiet: Whether or not to print/log information about the deletion to stdout.
+    """
+    # TODO: This function could benefit from less complex Boto3 type hints
+    iam_client = session.client("iam", region_name=region)
+    iam_resource = session.resource("iam", region_name=region)
+    role = iam_resource.Role(role_name)
+    # normal policies
+    for attached_policy in role.attached_policies.all():
+        printq(
+            f"Now dissociating policy: {attached_policy.policy_name} from role {role.name}",
+            quiet,
+        )
+        role.detach_policy(PolicyArn=attached_policy.arn)
+    # inline policies
+    for inline_policy in role.policies.all():
+        printq(
+            f"Deleting inline policy: {inline_policy.policy_name} from role {role.name}",
+            quiet,
+        )
+        iam_client.delete_role_policy(
+            RoleName=role.name, PolicyName=inline_policy.policy_name
+        )
+    iam_client.delete_role(RoleName=role_name)
+    printq(f"Role {role_name} successfully deleted.", quiet)
+
+
+# "PolicyDocumentDictTypeDef"
+def create_iam_role(
+    role_name: str,
+    assume_role_policy_document: str,
+    policies: dict[str, Any],
+    region: Optional[str] = None,
+) -> str:
+    """
+    Creates an AWS IAM role. Any separate policies are detached from the role, and any inline policies are deleted.
+
+    :param role_name: The name of the AWS IAM role.
+    :param region: The AWS region that the role_name is in.
+    :param assume_role_policy_document: Policies to create inline with the role.
+    :param policies: Global policies to attach to the role.
+    """
+    iam_client = session.client("iam", region_name=region)
+    try:
+        # Make the role
+        logger.debug("Creating IAM role %s...", role_name)
+        iam_client.create_role(
+            RoleName=role_name, AssumeRolePolicyDocument=assume_role_policy_document
+        )
+        logger.debug("Created new IAM role")
+    except ClientError as e:
+        if get_error_status(e) == 409 and get_error_code(e) == "EntityAlreadyExists":
+            logger.debug("IAM role already exists. Reusing.")
+        else:
+            raise
+
+    # Delete superfluous policies
+    policy_names = set(iam_client.list_role_policies(RoleName=role_name)["PolicyNames"])
+    for policy_name in policy_names.difference(set(list(policies.keys()))):
+        iam_client.delete_role_policy(RoleName=role_name, PolicyName=policy_name)
+
+    # Create expected policies
+    for policy_name, policy in policies.items():
+        current_policy = None
+        try:
+            current_policy = iam_client.get_role_policy(
+                RoleName=role_name, PolicyName=policy_name
+            )["PolicyDocument"]
+        except iam_client.exceptions.NoSuchEntityException:
+            pass
+        if current_policy != policy:
+            iam_client.put_role_policy(
+                RoleName=role_name,
+                PolicyName=policy_name,
+                PolicyDocument=json.dumps(policy),
+            )
+
+    # Now the role has the right policies so it is ready.
+    return role_name
+
 
 def init_action_collection() -> AllowedActionCollection:
-    '''
+    """
     Initialization of an action collection, an action collection contains allowed Actions and NotActions
     by resource, these are patterns containing wildcards, an Action explicitly allows a matched pattern,
     eg ec2:* will explicitly allow all ec2 permissions
 
     A NotAction will explicitly allow all actions that don't match a specific pattern
     eg iam:* allows all non iam actions
-    '''
-    return defaultdict(lambda: {'Action': [], 'NotAction': []})
+    """
+    return defaultdict(lambda: {"Action": [], "NotAction": []})
+
 
-def add_to_action_collection(a: AllowedActionCollection, b: AllowedActionCollection) -> AllowedActionCollection:
-    '''
+def add_to_action_collection(
+    a: AllowedActionCollection, b: AllowedActionCollection
+) -> AllowedActionCollection:
+    """
     Combines two action collections
-    '''
+    """
     to_return = init_action_collection()
     for key in a.keys():
-        to_return[key]['Action'] += a[key]['Action']
-        to_return[key]['NotAction'] += a[key]['NotAction']
+        to_return[key]["Action"] += a[key]["Action"]
+        to_return[key]["NotAction"] += a[key]["NotAction"]
 
     for key in b.keys():
-        to_return[key]['Action'] += b[key]['Action']
-        to_return[key]['NotAction'] += b[key]['NotAction']
+        to_return[key]["Action"] += b[key]["Action"]
+        to_return[key]["NotAction"] += b[key]["NotAction"]
 
     return to_return
 
 
-def policy_permissions_allow(given_permissions: AllowedActionCollection, required_permissions: List[str] = []) -> bool:
+def policy_permissions_allow(
+    given_permissions: AllowedActionCollection, required_permissions: list[str] = []
+) -> bool:
     """
     Check whether given set of actions are a subset of another given set of actions, returns true if they are
     otherwise false and prints a warning.
@@ -89,24 +210,31 @@ def policy_permissions_allow(given_permissions: AllowedActionCollection, require
     """
 
     # We only check actions explicitly allowed on all resources here,
-    #TODO: Add a resource parameter to check for actions allowed by resource
+    # TODO: Add a resource parameter to check for actions allowed by resource
     resource = "*"
 
     missing_perms = []
 
     for permission in required_permissions:
-        if not permission_matches_any(permission, given_permissions[resource]['Action']):
-            if given_permissions[resource]['NotAction'] == [] or permission_matches_any(permission, given_permissions[resource]["NotAction"]):
+        if not permission_matches_any(
+            permission, given_permissions[resource]["Action"]
+        ):
+            if given_permissions[resource]["NotAction"] == [] or permission_matches_any(
+                permission, given_permissions[resource]["NotAction"]
+            ):
                 missing_perms.append(permission)
 
     if missing_perms:
-        logger.warning('You appear to lack the folowing AWS permissions: %s', ', '.join(missing_perms))
+        logger.warning(
+            "You appear to lack the folowing AWS permissions: %s",
+            ", ".join(missing_perms),
+        )
         return False
 
     return True
 
 
-def permission_matches_any(perm: str, list_perms: List[str]) -> bool:
+def permission_matches_any(perm: str, list_perms: list[str]) -> bool:
     """
     Takes a permission and checks whether it's contained within a list of given permissions
     Returns True if it is otherwise False
@@ -120,13 +248,16 @@ def permission_matches_any(perm: str, list_perms: List[str]) -> bool:
             return True
     return False
 
-def get_actions_from_policy_document(policy_doc: PolicyDocumentDictTypeDef) -> AllowedActionCollection:
-    '''
+
+def get_actions_from_policy_document(
+    policy_doc: "PolicyDocumentDictTypeDef",
+) -> AllowedActionCollection:
+    """
     Given a policy document, go through each statement and create an AllowedActionCollection representing the
     permissions granted in the policy document.
 
     :param policy_doc: A policy document to examine
-    '''
+    """
     allowed_actions: AllowedActionCollection = init_action_collection()
     # Policy document structured like so https://boto3.amazonaws.com/v1/documentation/api/latest/guide/iam-example-policies.html#example
     logger.debug(policy_doc)
@@ -145,11 +276,15 @@ def get_actions_from_policy_document(policy_doc: PolicyDocumentDictTypeDef) -> A
                         if isinstance(statement[key], list):  # type: ignore[literal-required]
                             allowed_actions[resource][key] += statement[key]  # type: ignore[literal-required]
                         else:
-                            #Assumes that if it isn't a list it's probably a string
+                            # Assumes that if it isn't a list it's probably a string
                             allowed_actions[resource][key].append(statement[key])  # type: ignore[literal-required]
 
     return allowed_actions
-def allowed_actions_attached(iam: IAMClient, attached_policies: List[AttachedPolicyTypeDef]) -> AllowedActionCollection:
+
+
+def allowed_actions_attached(
+    iam: "IAMClient", attached_policies: list["AttachedPolicyTypeDef"]
+) -> AllowedActionCollection:
     """
     Go through all attached policy documents and create an AllowedActionCollection representing granted permissions.
 
@@ -159,16 +294,21 @@ def allowed_actions_attached(iam: IAMClient, attached_policies: List[AttachedPol
 
     allowed_actions: AllowedActionCollection = init_action_collection()
     for policy in attached_policies:
-        policy_desc = iam.get_policy(PolicyArn=policy['PolicyArn'])
-        policy_ver = iam.get_policy_version(PolicyArn=policy_desc['Policy']['Arn'], VersionId=policy_desc['Policy']['DefaultVersionId'])
-        policy_document = policy_ver['PolicyVersion']['Document']
-        #TODO whenever boto fixes the typing, stop ignoring this line in typecheck
-        allowed_actions = add_to_action_collection(allowed_actions, get_actions_from_policy_document(policy_document)) # type: ignore
+        policy_desc = iam.get_policy(PolicyArn=policy["PolicyArn"])
+        policy_ver = iam.get_policy_version(
+            PolicyArn=policy_desc["Policy"]["Arn"],
+            VersionId=policy_desc["Policy"]["DefaultVersionId"],
+        )
+        policy_document = policy_ver["PolicyVersion"]["Document"]
+        # TODO whenever boto fixes the typing, stop ignoring this line in typecheck
+        allowed_actions = add_to_action_collection(allowed_actions, get_actions_from_policy_document(policy_document))  # type: ignore
 
     return allowed_actions
 
 
-def allowed_actions_roles(iam: IAMClient, policy_names: List[str], role_name: str) -> AllowedActionCollection:
+def allowed_actions_roles(
+    iam: "IAMClient", policy_names: list[str], role_name: str
+) -> AllowedActionCollection:
     """
     Returns a dictionary containing a list of all aws actions allowed for a given role.
     This dictionary is keyed by resource and gives a list of policies allowed on that resource.
@@ -180,10 +320,7 @@ def allowed_actions_roles(iam: IAMClient, policy_names: List[str], role_name: st
     allowed_actions: AllowedActionCollection = init_action_collection()
 
     for policy_name in policy_names:
-        role_policy = iam.get_role_policy(
-            RoleName=role_name,
-            PolicyName=policy_name
-        )
+        role_policy = iam.get_role_policy(RoleName=role_name, PolicyName=policy_name)
         logger.debug("Checking role policy")
         # PolicyDocument is now a TypedDict, but an instance of TypedDict is not an instance of dict?
         if isinstance(role_policy["PolicyDocument"], str):
@@ -191,12 +328,16 @@ def allowed_actions_roles(iam: IAMClient, policy_names: List[str], role_name: st
         else:
             policy_document = role_policy["PolicyDocument"]
 
-        allowed_actions = add_to_action_collection(allowed_actions, get_actions_from_policy_document(policy_document))
+        allowed_actions = add_to_action_collection(
+            allowed_actions, get_actions_from_policy_document(policy_document)
+        )
 
     return allowed_actions
 
 
-def collect_policy_actions(policy_documents: List[Union[str, PolicyDocumentDictTypeDef]]) -> AllowedActionCollection:
+def collect_policy_actions(
+    policy_documents: list[Union[str, "PolicyDocumentDictTypeDef"]]
+) -> AllowedActionCollection:
     """
     Collect all of the actions allowed by the given policy documents into one AllowedActionCollection.
     """
@@ -207,11 +348,15 @@ def collect_policy_actions(policy_documents: List[Union[str, PolicyDocumentDictT
             policy_dict = json.loads(policy_str)
         else:
             policy_dict = policy_str
-        allowed_actions = add_to_action_collection(allowed_actions, get_actions_from_policy_document(policy_dict))
+        allowed_actions = add_to_action_collection(
+            allowed_actions, get_actions_from_policy_document(policy_dict)
+        )
     return allowed_actions
 
 
-def allowed_actions_user(iam: IAMClient, policy_names: List[str], user_name: str) -> AllowedActionCollection:
+def allowed_actions_user(
+    iam: "IAMClient", policy_names: list[str], user_name: str
+) -> AllowedActionCollection:
     """
     Gets all allowed actions for a user given by user_name, returns a dictionary, keyed by resource,
     with a list of permissions allowed for each given resource.
@@ -221,16 +366,17 @@ def allowed_actions_user(iam: IAMClient, policy_names: List[str], user_name: str
     :param user_name: Name of user to get associated policies
     """
     user_policies = [
-        iam.get_user_policy(
-            UserName=user_name,
-            PolicyName=policy_name
-        )["PolicyDocument"]
+        iam.get_user_policy(UserName=user_name, PolicyName=policy_name)[
+            "PolicyDocument"
+        ]
         for policy_name in policy_names
     ]
     return collect_policy_actions(user_policies)
 
 
-def allowed_actions_group(iam: IAMClient, policy_names: List[str], group_name: str) -> AllowedActionCollection:
+def allowed_actions_group(
+    iam: "IAMClient", policy_names: list[str], group_name: str
+) -> AllowedActionCollection:
     """
     Gets all allowed actions for a group given by group_name, returns a dictionary, keyed by resource,
     with a list of permissions allowed for each given resource.
@@ -240,10 +386,9 @@ def allowed_actions_group(iam: IAMClient, policy_names: List[str], group_name: s
     :param group_name: Name of group to get associated policies
     """
     group_policies = [
-        iam.get_group_policy(
-            GroupName=group_name,
-            PolicyName=policy_name
-        )["PolicyDocument"]
+        iam.get_group_policy(GroupName=group_name, PolicyName=policy_name)[
+            "PolicyDocument"
+        ]
         for policy_name in policy_names
     ]
     return collect_policy_actions(group_policies)
@@ -257,29 +402,51 @@ def get_policy_permissions(region: str) -> AllowedActionCollection:
     :param zone: AWS zone to connect to
     """
 
-    iam: IAMClient = get_client('iam', region)
-    sts: STSClient = get_client('sts', region)
-    #TODO Condider effect: deny at some point
-    allowed_actions: AllowedActionCollection = defaultdict(lambda: {'Action': [], 'NotAction': []})
+    iam: "IAMClient" = get_client("iam", region)
+    sts: "STSClient" = get_client("sts", region)
+    # TODO Condider effect: deny at some point
+    allowed_actions: AllowedActionCollection = defaultdict(
+        lambda: {"Action": [], "NotAction": []}
+    )
     try:
         # If successful then we assume we are operating as a user, and grab the associated permissions
         user = iam.get_user()
-        list_policies = iam.list_user_policies(UserName=user['User']['UserName'])
-        attached_policies = iam.list_attached_user_policies(UserName=user['User']['UserName'])
-        user_attached_policies = allowed_actions_attached(iam, attached_policies['AttachedPolicies'])
-        allowed_actions = add_to_action_collection(allowed_actions, user_attached_policies)
-        user_inline_policies = allowed_actions_user(iam, list_policies['PolicyNames'], user['User']['UserName'])
-        allowed_actions = add_to_action_collection(allowed_actions, user_inline_policies)
+        list_policies = iam.list_user_policies(UserName=user["User"]["UserName"])
+        attached_policies = iam.list_attached_user_policies(
+            UserName=user["User"]["UserName"]
+        )
+        user_attached_policies = allowed_actions_attached(
+            iam, attached_policies["AttachedPolicies"]
+        )
+        allowed_actions = add_to_action_collection(
+            allowed_actions, user_attached_policies
+        )
+        user_inline_policies = allowed_actions_user(
+            iam, list_policies["PolicyNames"], user["User"]["UserName"]
+        )
+        allowed_actions = add_to_action_collection(
+            allowed_actions, user_inline_policies
+        )
 
         # grab group policies associated with the user
-        groups = iam.list_groups_for_user(UserName=user['User']['UserName'])
+        groups = iam.list_groups_for_user(UserName=user["User"]["UserName"])
         for group in groups["Groups"]:
-            list_policies = iam.list_group_policies(GroupName=group['GroupName'])
-            attached_policies = iam.list_attached_group_policies(GroupName=group['GroupName'])
-            group_attached_policies = allowed_actions_attached(iam, attached_policies['AttachedPolicies'])
-            allowed_actions = add_to_action_collection(allowed_actions, group_attached_policies)
-            group_inline_policies = allowed_actions_group(iam, list_policies['PolicyNames'], group['GroupName'])
-            allowed_actions = add_to_action_collection(allowed_actions, group_inline_policies)
+            list_policies = iam.list_group_policies(GroupName=group["GroupName"])
+            attached_policies = iam.list_attached_group_policies(
+                GroupName=group["GroupName"]
+            )
+            group_attached_policies = allowed_actions_attached(
+                iam, attached_policies["AttachedPolicies"]
+            )
+            allowed_actions = add_to_action_collection(
+                allowed_actions, group_attached_policies
+            )
+            group_inline_policies = allowed_actions_group(
+                iam, list_policies["PolicyNames"], group["GroupName"]
+            )
+            allowed_actions = add_to_action_collection(
+                allowed_actions, group_inline_policies
+            )
 
     except:
         # If not successful, we check the role associated with an instance profile
@@ -291,19 +458,28 @@ def get_policy_permissions(region: str) -> AllowedActionCollection:
             role_name = role["Arn"].split("/")[1]
             list_policies = iam.list_role_policies(RoleName=role_name)
             attached_policies = iam.list_attached_role_policies(RoleName=role_name)
-            role_attached_policies = allowed_actions_attached(iam, attached_policies['AttachedPolicies'])
-            allowed_actions = add_to_action_collection(allowed_actions, role_attached_policies)
-            role_inline_policies = allowed_actions_roles(iam, list_policies['PolicyNames'], role_name)
-            allowed_actions = add_to_action_collection(allowed_actions, role_inline_policies)
+            role_attached_policies = allowed_actions_attached(
+                iam, attached_policies["AttachedPolicies"]
+            )
+            allowed_actions = add_to_action_collection(
+                allowed_actions, role_attached_policies
+            )
+            role_inline_policies = allowed_actions_roles(
+                iam, list_policies["PolicyNames"], role_name
+            )
+            allowed_actions = add_to_action_collection(
+                allowed_actions, role_inline_policies
+            )
 
         except:
             logger.exception("Exception when trying to get role policies")
     logger.debug("Allowed actions: %s", allowed_actions)
     return allowed_actions
 
-@lru_cache()
+
+@lru_cache
 def get_aws_account_num() -> Optional[str]:
     """
     Returns AWS account num
     """
-    return boto3.client('sts').get_caller_identity().get('Account')
+    return boto3.client("sts").get_caller_identity().get("Account")

toil/lib/aws/s3.py

@@ -0,0 +1,31 @@
+# Copyright (C) 2015-2024 Regents of the University of California
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import logging
+
+from mypy_boto3_s3.type_defs import ListMultipartUploadsOutputTypeDef
+
+from toil.lib.aws import AWSServerErrors, session
+from toil.lib.retry import retry
+
+logger = logging.getLogger(__name__)
+
+
+@retry(errors=[AWSServerErrors])
+def list_multipart_uploads(
+    bucket: str, region: str, prefix: str, max_uploads: int = 1
+) -> ListMultipartUploadsOutputTypeDef:
+    s3_client = session.client("s3", region_name=region)
+    return s3_client.list_multipart_uploads(
+        Bucket=bucket, MaxUploads=max_uploads, Prefix=prefix
+    )