:doc:`IAM <../../iam>` / Client / set_default_policy_version

**************************
set_default_policy_version
**************************



.. py:method:: IAM.Client.set_default_policy_version(**kwargs)

  

  Sets the specified version of the specified policy as the policy's default (operative) version.

   

  This operation affects all users, groups, and roles that the policy is attached to. To list the users, groups, and roles that the policy is attached to, use `ListEntitiesForPolicy <https://docs.aws.amazon.com/IAM/latest/APIReference/API_ListEntitiesForPolicy.html>`__.

   

  For information about managed policies, see `Managed policies and inline policies <https://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html>`__ in the *IAM User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/SetDefaultPolicyVersion>`_  


  **Request Syntax**
  ::

    response = client.set_default_policy_version(
        PolicyArn='string',
        VersionId='string'
    )
    
  :type PolicyArn: string
  :param PolicyArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the IAM policy whose default version you want to set.

     

    For more information about ARNs, see `Amazon Resource Names (ARNs) <https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html>`__ in the *Amazon Web Services General Reference*.

    

  
  :type VersionId: string
  :param VersionId: **[REQUIRED]** 

    The version of the policy to set as the default (operative) version.

     

    For more information about managed policy versions, see `Versioning for managed policies <https://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-versions.html>`__ in the *IAM User Guide*.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`IAM.Client.exceptions.NoSuchEntityException`

  
  *   :py:class:`IAM.Client.exceptions.InvalidInputException`

  
  *   :py:class:`IAM.Client.exceptions.LimitExceededException`

  
  *   :py:class:`IAM.Client.exceptions.ServiceFailureException`

  