:doc:`CloudTrail <../../cloudtrail>` / Client / put_resource_policy

*******************
put_resource_policy
*******************



.. py:method:: CloudTrail.Client.put_resource_policy(**kwargs)

  

  Attaches a resource-based permission policy to a CloudTrail event data store, dashboard, or channel. For more information about resource-based policies, see `CloudTrail resource-based policy examples <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html>`__ in the *CloudTrail User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/PutResourcePolicy>`_  


  **Request Syntax**
  ::

    response = client.put_resource_policy(
        ResourceArn='string',
        ResourcePolicy='string'
    )
    
  :type ResourceArn: string
  :param ResourceArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the CloudTrail event data store, dashboard, or channel attached to the resource-based policy.

     

    Example event data store ARN format: ``arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE``

     

    Example dashboard ARN format: ``arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash``

     

    Example channel ARN format: ``arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890``

    

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

    A JSON-formatted string for an Amazon Web Services resource-based policy.

     

    For example resource-based policies, see `CloudTrail resource-based policy examples <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html>`__ in the *CloudTrail User Guide*.

    

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

    
    ::

      {
          'ResourceArn': 'string',
          'ResourcePolicy': 'string',
          'DelegatedAdminResourcePolicy': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ResourceArn** *(string) --* 

        The Amazon Resource Name (ARN) of the CloudTrail event data store, dashboard, or channel attached to the resource-based policy.

         

        Example event data store ARN format: ``arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE``

         

        Example dashboard ARN format: ``arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash``

         

        Example channel ARN format: ``arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890``

        
      

      - **ResourcePolicy** *(string) --* 

        The JSON-formatted string of the Amazon Web Services resource-based policy attached to the CloudTrail event data store, dashboard, or channel.

        
      

      - **DelegatedAdminResourcePolicy** *(string) --* 

        The default resource-based policy that is automatically generated for the delegated administrator of an Organizations organization. This policy will be evaluated in tandem with any policy you submit for the resource. For more information about this policy, see `Default resource policy for delegated administrators <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-organizations.html#cloudtrail-lake-organizations-eds-rbp>`__.

        
  
  **Exceptions**
  
  *   :py:class:`CloudTrail.Client.exceptions.ResourceARNNotValidException`

  
  *   :py:class:`CloudTrail.Client.exceptions.ResourcePolicyNotValidException`

  
  *   :py:class:`CloudTrail.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`CloudTrail.Client.exceptions.ResourceTypeNotSupportedException`

  
  *   :py:class:`CloudTrail.Client.exceptions.ConflictException`

  
  *   :py:class:`CloudTrail.Client.exceptions.OperationNotPermittedException`

  
  *   :py:class:`CloudTrail.Client.exceptions.UnsupportedOperationException`

  