:doc:`ServiceCatalog <../../servicecatalog>` / Client / create_portfolio

****************
create_portfolio
****************



.. py:method:: ServiceCatalog.Client.create_portfolio(**kwargs)

  

  Creates a portfolio.

   

  A delegated admin is authorized to invoke this command.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/CreatePortfolio>`_  


  **Request Syntax**
  ::

    response = client.create_portfolio(
        AcceptLanguage='string',
        DisplayName='string',
        Description='string',
        ProviderName='string',
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ],
        IdempotencyToken='string'
    )
    
  :type AcceptLanguage: string
  :param AcceptLanguage: 

    The language code.

     

    
    * ``jp`` - Japanese
     
    * ``zh`` - Chinese
    

    

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

    The name to use for display purposes.

    

  
  :type Description: string
  :param Description: 

    The description of the portfolio.

    

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

    The name of the portfolio provider.

    

  
  :type Tags: list
  :param Tags: 

    One or more tags.

    

  
    - *(dict) --* 

      Information about a tag. A tag is a key-value pair. Tags are propagated to the resources created when provisioning a product.

      

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

        The tag key.

        

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

        The value for this key.

        

      
    

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

    A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

    This field is autopopulated if not provided.

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

    
    ::

      {
          'PortfolioDetail': {
              'Id': 'string',
              'ARN': 'string',
              'DisplayName': 'string',
              'Description': 'string',
              'CreatedTime': datetime(2015, 1, 1),
              'ProviderName': 'string'
          },
          'Tags': [
              {
                  'Key': 'string',
                  'Value': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **PortfolioDetail** *(dict) --* 

        Information about the portfolio.

        
        

        - **Id** *(string) --* 

          The portfolio identifier.

          
        

        - **ARN** *(string) --* 

          The ARN assigned to the portfolio.

          
        

        - **DisplayName** *(string) --* 

          The name to use for display purposes.

          
        

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

          The description of the portfolio.

          
        

        - **CreatedTime** *(datetime) --* 

          The UTC time stamp of the creation time.

          
        

        - **ProviderName** *(string) --* 

          The name of the portfolio provider.

          
    
      

      - **Tags** *(list) --* 

        Information about the tags associated with the portfolio.

        
        

        - *(dict) --* 

          Information about a tag. A tag is a key-value pair. Tags are propagated to the resources created when provisioning a product.

          
          

          - **Key** *(string) --* 

            The tag key.

            
          

          - **Value** *(string) --* 

            The value for this key.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`ServiceCatalog.Client.exceptions.InvalidParametersException`

  
  *   :py:class:`ServiceCatalog.Client.exceptions.LimitExceededException`

  
  *   :py:class:`ServiceCatalog.Client.exceptions.TagOptionNotMigratedException`

  