:doc:`ManagedBlockchain <../../managedblockchain>` / Client / create_accessor

***************
create_accessor
***************



.. py:method:: ManagedBlockchain.Client.create_accessor(**kwargs)

  

  Creates a new accessor for use with Amazon Managed Blockchain service that supports token based access. The accessor contains information required for token based access.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/managedblockchain-2018-09-24/CreateAccessor>`_  


  **Request Syntax**
  ::

    response = client.create_accessor(
        ClientRequestToken='string',
        AccessorType='BILLING_TOKEN',
        Tags={
            'string': 'string'
        },
        NetworkType='ETHEREUM_GOERLI'|'ETHEREUM_MAINNET'|'ETHEREUM_MAINNET_AND_GOERLI'|'POLYGON_MAINNET'|'POLYGON_MUMBAI'
    )
    
  :type ClientRequestToken: string
  :param ClientRequestToken: **[REQUIRED]** 

    This is a unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than once. This identifier is required only if you make a service request directly using an HTTP client. It is generated automatically if you use an Amazon Web Services SDK or the Amazon Web Services CLI.

    This field is autopopulated if not provided.

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

    The type of accessor.

     

    .. note::

      

      Currently, accessor type is restricted to ``BILLING_TOKEN``.

      

    

  
  :type Tags: dict
  :param Tags: 

    Tags to assign to the Accessor.

     

    Each tag consists of a key and an optional value. You can specify multiple key-value pairs in a single request with an overall maximum of 50 tags allowed per resource.

     

    For more information about tags, see `Tagging Resources <https://docs.aws.amazon.com/managed-blockchain/latest/ethereum-dev/tagging-resources.html>`__ in the *Amazon Managed Blockchain Ethereum Developer Guide*, or `Tagging Resources <https://docs.aws.amazon.com/managed-blockchain/latest/hyperledger-fabric-dev/tagging-resources.html>`__ in the *Amazon Managed Blockchain Hyperledger Fabric Developer Guide*.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  :type NetworkType: string
  :param NetworkType: 

    The blockchain network that the ``Accessor`` token is created for.

     

    .. note::

      

      
      * Use the actual ``networkType`` value for the blockchain network that you are creating the ``Accessor`` token for.
       
      * With the shut down of the *Ethereum Goerli* and *Polygon Mumbai Testnet* networks the following ``networkType`` values are no longer available for selection and use. 

        
        * ``ETHEREUM_MAINNET_AND_GOERLI``
         
        * ``ETHEREUM_GOERLI``
         
        * ``POLYGON_MUMBAI``
        

       

      However, your existing ``Accessor`` tokens with these ``networkType`` values will remain unchanged.

      
      

      

    

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

    
    ::

      {
          'AccessorId': 'string',
          'BillingToken': 'string',
          'NetworkType': 'ETHEREUM_GOERLI'|'ETHEREUM_MAINNET'|'ETHEREUM_MAINNET_AND_GOERLI'|'POLYGON_MAINNET'|'POLYGON_MUMBAI'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **AccessorId** *(string) --* 

        The unique identifier of the accessor.

        
      

      - **BillingToken** *(string) --* 

        The billing token is a property of the Accessor. Use this token to when making calls to the blockchain network. The billing token is used to track your accessor token for billing requests.

        
      

      - **NetworkType** *(string) --* 

        The blockchain network that the accessor token is created for.

        
  
  **Exceptions**
  
  *   :py:class:`ManagedBlockchain.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`ManagedBlockchain.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`ManagedBlockchain.Client.exceptions.ResourceAlreadyExistsException`

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

  
  *   :py:class:`ManagedBlockchain.Client.exceptions.ResourceLimitExceededException`

  
  *   :py:class:`ManagedBlockchain.Client.exceptions.InternalServiceErrorException`

  
  *   :py:class:`ManagedBlockchain.Client.exceptions.TooManyTagsException`

  