:doc:`Bedrock <../../bedrock>` / Client / create_provisioned_model_throughput

***********************************
create_provisioned_model_throughput
***********************************



.. py:method:: Bedrock.Client.create_provisioned_model_throughput(**kwargs)

  

  Creates dedicated throughput for a base or custom model with the model units and for the duration that you specify. For pricing details, see `Amazon Bedrock Pricing <http://aws.amazon.com/bedrock/pricing/>`__. For more information, see `Provisioned Throughput <https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html>`__ in the `Amazon Bedrock User Guide <https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/CreateProvisionedModelThroughput>`_  


  **Request Syntax**
  ::

    response = client.create_provisioned_model_throughput(
        clientRequestToken='string',
        modelUnits=123,
        provisionedModelName='string',
        modelId='string',
        commitmentDuration='OneMonth'|'SixMonths',
        tags=[
            {
                'key': 'string',
                'value': 'string'
            },
        ]
    )
    
  :type clientRequestToken: string
  :param clientRequestToken: 

    A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see `Ensuring idempotency <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html>`__ in the Amazon S3 User Guide.

    This field is autopopulated if not provided.

  
  :type modelUnits: integer
  :param modelUnits: **[REQUIRED]** 

    Number of model units to allocate. A model unit delivers a specific throughput level for the specified model. The throughput level of a model unit specifies the total number of input and output tokens that it can process and generate within a span of one minute. By default, your account has no model units for purchasing Provisioned Throughputs with commitment. You must first visit the `Amazon Web Services support center <https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase>`__ to request MUs.

     

    For model unit quotas, see `Provisioned Throughput quotas <https://docs.aws.amazon.com/bedrock/latest/userguide/quotas.html#prov-thru-quotas>`__ in the `Amazon Bedrock User Guide <https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html>`__.

     

    For more information about what an MU specifies, contact your Amazon Web Services account manager.

    

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

    The name for this Provisioned Throughput.

    

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

    The Amazon Resource Name (ARN) or name of the model to associate with this Provisioned Throughput. For a list of models for which you can purchase Provisioned Throughput, see `Amazon Bedrock model IDs for purchasing Provisioned Throughput <https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#prov-throughput-models>`__ in the `Amazon Bedrock User Guide <https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html>`__.

    

  
  :type commitmentDuration: string
  :param commitmentDuration: 

    The commitment duration requested for the Provisioned Throughput. Billing occurs hourly and is discounted for longer commitment terms. To request a no-commit Provisioned Throughput, omit this field.

     

    Custom models support all levels of commitment. To see which base models support no commitment, see `Supported regions and models for Provisioned Throughput <https://docs.aws.amazon.com/bedrock/latest/userguide/pt-supported.html>`__ in the `Amazon Bedrock User Guide <https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html>`__

    

  
  :type tags: list
  :param tags: 

    Tags to associate with this Provisioned Throughput.

    

  
    - *(dict) --* 

      Definition of the key/value pair for a tag.

      

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

        Key for the tag.

        

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

        Value for the tag.

        

      
    

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

    
    ::

      {
          'provisionedModelArn': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **provisionedModelArn** *(string) --* 

        The Amazon Resource Name (ARN) for this Provisioned Throughput.

        
  
  **Exceptions**
  
  *   :py:class:`Bedrock.Client.exceptions.ResourceNotFoundException`

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

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

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

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

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

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

  