:doc:`DirectoryService <../../ds>` / Client / add_region

**********
add_region
**********



.. py:method:: DirectoryService.Client.add_region(**kwargs)

  

  Adds two domain controllers in the specified Region for the specified directory.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ds-2015-04-16/AddRegion>`_  


  **Request Syntax**
  ::

    response = client.add_region(
        DirectoryId='string',
        RegionName='string',
        VPCSettings={
            'VpcId': 'string',
            'SubnetIds': [
                'string',
            ]
        }
    )
    
  :type DirectoryId: string
  :param DirectoryId: **[REQUIRED]** 

    The identifier of the directory to which you want to add Region replication.

    

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

    The name of the Region where you want to add domain controllers for replication. For example, ``us-east-1``.

    

  
  :type VPCSettings: dict
  :param VPCSettings: **[REQUIRED]** 

    Contains VPC information for the  CreateDirectory,  CreateMicrosoftAD, or  CreateHybridAD operation.

    

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

      The identifier of the VPC in which to create the directory.

      

    
    - **SubnetIds** *(list) --* **[REQUIRED]** 

      The identifiers of the subnets for the directory servers. The two subnets must be in different Availability Zones. Directory Service creates a directory server and a DNS server in each of these subnets.

      

    
      - *(string) --* 

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`DirectoryService.Client.exceptions.DirectoryUnavailableException`

  
  *   :py:class:`DirectoryService.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`DirectoryService.Client.exceptions.EntityDoesNotExistException`

  
  *   :py:class:`DirectoryService.Client.exceptions.DirectoryAlreadyInRegionException`

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

  
  *   :py:class:`DirectoryService.Client.exceptions.DirectoryDoesNotExistException`

  
  *   :py:class:`DirectoryService.Client.exceptions.RegionLimitExceededException`

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

  
  *   :py:class:`DirectoryService.Client.exceptions.ClientException`

  
  *   :py:class:`DirectoryService.Client.exceptions.ServiceException`

  