:doc:`ServiceQuotas <../../service-quotas>` / Client / request_service_quota_increase

******************************
request_service_quota_increase
******************************



.. py:method:: ServiceQuotas.Client.request_service_quota_increase(**kwargs)

  

  Submits a quota increase request for the specified quota at the account or resource level.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/service-quotas-2019-06-24/RequestServiceQuotaIncrease>`_  


  **Request Syntax**
  ::

    response = client.request_service_quota_increase(
        ServiceCode='string',
        QuotaCode='string',
        DesiredValue=123.0,
        ContextId='string',
        SupportCaseAllowed=True|False
    )
    
  :type ServiceCode: string
  :param ServiceCode: **[REQUIRED]** 

    Specifies the service identifier. To find the service code value for an Amazon Web Services service, use the  ListServices operation.

    

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

    Specifies the quota identifier. To find the quota code for a specific quota, use the  ListServiceQuotas operation, and look for the ``QuotaCode`` response in the output for the quota you want.

    

  
  :type DesiredValue: float
  :param DesiredValue: **[REQUIRED]** 

    Specifies the new, increased value for the quota.

    

  
  :type ContextId: string
  :param ContextId: 

    Specifies the resource with an Amazon Resource Name (ARN).

    

  
  :type SupportCaseAllowed: boolean
  :param SupportCaseAllowed: 

    Specifies if an Amazon Web Services Support case can be opened for the quota increase request. This parameter is optional.

     

    By default, this flag is set to ``True`` and Amazon Web Services may create a support case for some quota increase requests. You can set this flag to ``False`` if you do not want a support case created when you request a quota increase. If you set the flag to ``False``, Amazon Web Services does not open a support case and updates the request status to ``Not approved``.

    

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

    
    ::

      {
          'RequestedQuota': {
              'Id': 'string',
              'RequestType': 'AutomaticManagement',
              'CaseId': 'string',
              'ServiceCode': 'string',
              'ServiceName': 'string',
              'QuotaCode': 'string',
              'QuotaName': 'string',
              'DesiredValue': 123.0,
              'Status': 'PENDING'|'CASE_OPENED'|'APPROVED'|'DENIED'|'CASE_CLOSED'|'NOT_APPROVED'|'INVALID_REQUEST',
              'Created': datetime(2015, 1, 1),
              'LastUpdated': datetime(2015, 1, 1),
              'Requester': 'string',
              'QuotaArn': 'string',
              'GlobalQuota': True|False,
              'Unit': 'string',
              'QuotaRequestedAtLevel': 'ACCOUNT'|'RESOURCE'|'ALL',
              'QuotaContext': {
                  'ContextScope': 'RESOURCE'|'ACCOUNT',
                  'ContextScopeType': 'string',
                  'ContextId': 'string'
              }
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **RequestedQuota** *(dict) --* 

        Information about the quota increase request.

        
        

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

          The unique identifier.

          
        

        - **RequestType** *(string) --* 

          The type of quota increase request. Possible values include:

           

          
          * ``AutomaticManagement`` - The request was automatically created by Service Quotas Automatic Management when quota utilization approached the limit.
          

           

          If this field is not present, the request was manually created by a user.

          
        

        - **CaseId** *(string) --* 

          The case ID.

          
        

        - **ServiceCode** *(string) --* 

          Specifies the service identifier. To find the service code value for an Amazon Web Services service, use the  ListServices operation.

          
        

        - **ServiceName** *(string) --* 

          Specifies the service name.

          
        

        - **QuotaCode** *(string) --* 

          Specifies the quota identifier. To find the quota code for a specific quota, use the  ListServiceQuotas operation, and look for the ``QuotaCode`` response in the output for the quota you want.

          
        

        - **QuotaName** *(string) --* 

          Specifies the quota name.

          
        

        - **DesiredValue** *(float) --* 

          The new, increased value for the quota.

          
        

        - **Status** *(string) --* 

          The state of the quota increase request.

           

          
          * ``PENDING``: The quota increase request is under review by Amazon Web Services.
           
          * ``CASE_OPENED``: Service Quotas opened a support case to process the quota increase request. Follow-up on the support case for more information.
           
          * ``APPROVED``: The quota increase request is approved.
           
          * ``DENIED``: The quota increase request can't be approved by Service Quotas. Contact Amazon Web Services Support for more details.
           
          * ``NOT APPROVED``: The quota increase request can't be approved by Service Quotas. Contact Amazon Web Services Support for more details.
           
          * ``CASE_CLOSED``: The support case associated with this quota increase request was closed. Check the support case correspondence for the outcome of your quota request.
           
          * ``INVALID_REQUEST``: Service Quotas couldn't process your resource-level quota increase request because the Amazon Resource Name (ARN) specified as part of the ``ContextId`` is invalid.
          

          
        

        - **Created** *(datetime) --* 

          The date and time when the quota increase request was received and the case ID was created.

          
        

        - **LastUpdated** *(datetime) --* 

          The date and time of the most recent change.

          
        

        - **Requester** *(string) --* 

          The IAM identity of the requester.

          
        

        - **QuotaArn** *(string) --* 

          The Amazon Resource Name (ARN) of the quota.

          
        

        - **GlobalQuota** *(boolean) --* 

          Indicates whether the quota is global.

          
        

        - **Unit** *(string) --* 

          The unit of measurement.

          
        

        - **QuotaRequestedAtLevel** *(string) --* 

          Filters the response to return quota requests for the ``ACCOUNT``, ``RESOURCE``, or ``ALL`` levels. ``ACCOUNT`` is the default.

          
        

        - **QuotaContext** *(dict) --* 

          The context for this service quota.

          
          

          - **ContextScope** *(string) --* 

            Specifies the scope to which the quota value is applied. If the scope is ``RESOURCE``, the quota value is applied to each resource in the Amazon Web Services account. If the scope is ``ACCOUNT``, the quota value is applied to the Amazon Web Services account.

            
          

          - **ContextScopeType** *(string) --* 

            Specifies the resource type to which the quota can be applied.

            
          

          - **ContextId** *(string) --* 

            Specifies the resource, or resources, to which the quota applies. The value for this field is either an Amazon Resource Name (ARN) or *. If the value is an ARN, the quota value applies to that resource. If the value is *, then the quota value applies to all resources listed in the ``ContextScopeType`` field. The quota value applies to all resources for which you haven’t previously applied a quota value, and any new resources you create in your Amazon Web Services account.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`ServiceQuotas.Client.exceptions.DependencyAccessDeniedException`

  
  *   :py:class:`ServiceQuotas.Client.exceptions.QuotaExceededException`

  
  *   :py:class:`ServiceQuotas.Client.exceptions.ResourceAlreadyExistsException`

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

  
  *   :py:class:`ServiceQuotas.Client.exceptions.NoSuchResourceException`

  
  *   :py:class:`ServiceQuotas.Client.exceptions.IllegalArgumentException`

  
  *   :py:class:`ServiceQuotas.Client.exceptions.InvalidResourceStateException`

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

  
  *   :py:class:`ServiceQuotas.Client.exceptions.TooManyRequestsException`

  