:doc:`S3Control <../../s3control>` / Client / associate_access_grants_identity_center

***************************************
associate_access_grants_identity_center
***************************************



.. py:method:: S3Control.Client.associate_access_grants_identity_center(**kwargs)

  

  Associate your S3 Access Grants instance with an Amazon Web Services IAM Identity Center instance. Use this action if you want to create access grants for users or groups from your corporate identity directory. First, you must add your corporate identity directory to Amazon Web Services IAM Identity Center. Then, you can associate this IAM Identity Center instance with your S3 Access Grants instance.

    Permissions  

  You must have the ``s3:AssociateAccessGrantsIdentityCenter`` permission to use this operation.

    Additional Permissions  

  You must also have the following permissions: ``sso:CreateApplication``, ``sso:PutApplicationGrant``, and ``sso:PutApplicationAuthenticationMethod``.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/AssociateAccessGrantsIdentityCenter>`_  


  **Request Syntax**
  ::

    response = client.associate_access_grants_identity_center(
        AccountId='string',
        IdentityCenterArn='string'
    )
    
  :type AccountId: string
  :param AccountId: **[REQUIRED]** 

    The Amazon Web Services account ID of the S3 Access Grants instance.

    

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

    The Amazon Resource Name (ARN) of the Amazon Web Services IAM Identity Center instance that you are associating with your S3 Access Grants instance. An IAM Identity Center instance is your corporate identity directory that you added to the IAM Identity Center. You can use the `ListInstances <https://docs.aws.amazon.com/singlesignon/latest/APIReference/API_ListInstances.html>`__ API operation to retrieve a list of your Identity Center instances and their ARNs.

    

  
  
  :returns: None