:doc:`MultipartyApproval <../../mpa>` / Client / create_identity_source

**********************
create_identity_source
**********************



.. py:method:: MultipartyApproval.Client.create_identity_source(**kwargs)

  

  Creates a new identity source. For more information, see `Identity Source <https://docs.aws.amazon.com/mpa/latest/userguide/mpa-concepts.html>`__ in the *Multi-party approval User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/mpa-2022-07-26/CreateIdentitySource>`_  


  **Request Syntax**
  ::

    response = client.create_identity_source(
        IdentitySourceParameters={
            'IamIdentityCenter': {
                'InstanceArn': 'string',
                'Region': 'string'
            }
        },
        ClientToken='string',
        Tags={
            'string': 'string'
        }
    )
    
  :type IdentitySourceParameters: dict
  :param IdentitySourceParameters: **[REQUIRED]** 

    A ``IdentitySourceParameters`` object. Contains details for the resource that provides identities to the identity source. For example, an IAM Identity Center instance.

    

  
    - **IamIdentityCenter** *(dict) --* 

      IAM Identity Center credentials.

      

    
      - **InstanceArn** *(string) --* **[REQUIRED]** 

        Amazon Resource Name (ARN) for the IAM Identity Center instance.

        

      
      - **Region** *(string) --* **[REQUIRED]** 

        Amazon Web Services Region where the IAM Identity Center instance is located.

        

      
    
  
  :type ClientToken: string
  :param ClientToken: 

    Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services populates this field.

     

    .. note::

      

      **What is idempotency?**

       

      When you make a mutating API request, the request typically returns a result before the operation's asynchronous workflows have completed. Operations might also time out or encounter other server issues before they complete, even though the request has already returned a result. This could make it difficult to determine whether the request succeeded or not, and could lead to multiple retries to ensure that the operation completes successfully. However, if the original request and the subsequent retries are successful, the operation is completed multiple times. This means that you might create more resources than you intended.

       

      *Idempotency* ensures that an API request completes no more than one time. With an idempotent request, if the original request completes successfully, any subsequent retries complete successfully without performing any further actions.

      

    This field is autopopulated if not provided.

  
  :type Tags: dict
  :param Tags: 

    Tag you want to attach to the identity source.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'IdentitySourceType': 'IAM_IDENTITY_CENTER',
          'IdentitySourceArn': 'string',
          'CreationTime': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **IdentitySourceType** *(string) --* 

        The type of resource that provided identities to the identity source. For example, an IAM Identity Center instance.

        
      

      - **IdentitySourceArn** *(string) --* 

        Amazon Resource Name (ARN) for the identity source that was created.

        
      

      - **CreationTime** *(datetime) --* 

        Timestamp when the identity source was created.

        
  
  **Exceptions**
  
  *   :py:class:`MultipartyApproval.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`MultipartyApproval.Client.exceptions.ValidationException`

  
  *   :py:class:`MultipartyApproval.Client.exceptions.ThrottlingException`

  
  *   :py:class:`MultipartyApproval.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`MultipartyApproval.Client.exceptions.InternalServerException`

  