:doc:`TelcoNetworkBuilder <../../tnb>` / Client / create_sol_network_instance

***************************
create_sol_network_instance
***************************



.. py:method:: TelcoNetworkBuilder.Client.create_sol_network_instance(**kwargs)

  

  Creates a network instance.

   

  A network instance is a single network created in Amazon Web Services TNB that can be deployed and on which life-cycle operations (like terminate, update, and delete) can be performed. Creating a network instance is the third step after creating a network package. For more information about network instances, `Network instances <https://docs.aws.amazon.com/tnb/latest/ug/network-instances.html>`__ in the *Amazon Web Services Telco Network Builder User Guide*.

   

  Once you create a network instance, you can instantiate it. To instantiate a network, see `InstantiateSolNetworkInstance <https://docs.aws.amazon.com/tnb/latest/APIReference/API_InstantiateSolNetworkInstance.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/tnb-2008-10-21/CreateSolNetworkInstance>`_  


  **Request Syntax**
  ::

    response = client.create_sol_network_instance(
        nsDescription='string',
        nsName='string',
        nsdInfoId='string',
        tags={
            'string': 'string'
        }
    )
    
  :type nsDescription: string
  :param nsDescription: 

    Network instance description.

    

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

    Network instance name.

    

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

    ID for network service descriptor.

    

  
  :type tags: dict
  :param tags: 

    A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. You can use tags to search and filter your resources or track your Amazon Web Services costs.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


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

    
    ::

      {
          'arn': 'string',
          'id': 'string',
          'nsInstanceName': 'string',
          'nsdInfoId': 'string',
          'tags': {
              'string': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **arn** *(string) --* 

        Network instance ARN.

        
      

      - **id** *(string) --* 

        Network instance ID.

        
      

      - **nsInstanceName** *(string) --* 

        Network instance name.

        
      

      - **nsdInfoId** *(string) --* 

        Network service descriptor ID.

        
      

      - **tags** *(dict) --* 

        A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. You can use tags to search and filter your resources or track your Amazon Web Services costs.

        
        

        - *(string) --* 
          

          - *(string) --* 
    
  
  
  **Exceptions**
  
  *   :py:class:`TelcoNetworkBuilder.Client.exceptions.InternalServerException`

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

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

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

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

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

  