:doc:`Outposts <../../outposts>` / Client / create_outpost

**************
create_outpost
**************



.. py:method:: Outposts.Client.create_outpost(**kwargs)

  

  Creates an Outpost.

   

  You can specify either an Availability one or an AZ ID.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/outposts-2019-12-03/CreateOutpost>`_  


  **Request Syntax**
  ::

    response = client.create_outpost(
        Name='string',
        Description='string',
        SiteId='string',
        AvailabilityZone='string',
        AvailabilityZoneId='string',
        Tags={
            'string': 'string'
        },
        SupportedHardwareType='RACK'|'SERVER'
    )
    
  :type Name: string
  :param Name: **[REQUIRED]** 

    The name of the Outpost.

    

  
  :type Description: string
  :param Description: 

    The description of the Outpost.

    

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

    The ID or the Amazon Resource Name (ARN) of the site.

    

  
  :type AvailabilityZone: string
  :param AvailabilityZone: 

    The Availability Zone.

    

  
  :type AvailabilityZoneId: string
  :param AvailabilityZoneId: 

    The ID of the Availability Zone.

    

  
  :type Tags: dict
  :param Tags: 

    The tags to apply to the Outpost.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  :type SupportedHardwareType: string
  :param SupportedHardwareType: 

    The type of hardware for this Outpost.

    

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

    
    ::

      {
          'Outpost': {
              'OutpostId': 'string',
              'OwnerId': 'string',
              'OutpostArn': 'string',
              'SiteId': 'string',
              'Name': 'string',
              'Description': 'string',
              'LifeCycleStatus': 'string',
              'AvailabilityZone': 'string',
              'AvailabilityZoneId': 'string',
              'Tags': {
                  'string': 'string'
              },
              'SiteArn': 'string',
              'SupportedHardwareType': 'RACK'|'SERVER'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Outpost** *(dict) --* 

        Information about an Outpost.

        
        

        - **OutpostId** *(string) --* 

          The ID of the Outpost.

          
        

        - **OwnerId** *(string) --* 

          The Amazon Web Services account ID of the Outpost owner.

          
        

        - **OutpostArn** *(string) --* 

          The Amazon Resource Name (ARN) of the Outpost.

          
        

        - **SiteId** *(string) --* 

          The ID of the site.

          
        

        - **Name** *(string) --* 

          The name of the Outpost.

          
        

        - **Description** *(string) --* 

          The description of the Outpost.

          
        

        - **LifeCycleStatus** *(string) --* 

          The life cycle status.

          
        

        - **AvailabilityZone** *(string) --* 

          The Availability Zone.

          
        

        - **AvailabilityZoneId** *(string) --* 

          The ID of the Availability Zone.

          
        

        - **Tags** *(dict) --* 

          The Outpost tags.

          
          

          - *(string) --* 
            

            - *(string) --* 
      
    
        

        - **SiteArn** *(string) --* 

          The Amazon Resource Name (ARN) of the site.

          
        

        - **SupportedHardwareType** *(string) --* 

          The hardware type.

          
    
  
  **Exceptions**
  
  *   :py:class:`Outposts.Client.exceptions.ValidationException`

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

  
  *   :py:class:`Outposts.Client.exceptions.NotFoundException`

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

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

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

  