ServiceQuotas / Client / request_service_quota_increase

request_service_quota_increase

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

Request Syntax

response = client.request_service_quota_increase(
    ServiceCode='string',
    QuotaCode='string',
    DesiredValue=123.0,
    ContextId='string',
    SupportCaseAllowed=True|False
)
Parameters:

  • ServiceCode (string) –

    [REQUIRED]

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

  • QuotaCode (string) –

    [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.

  • DesiredValue (float) –

    [REQUIRED]

    Specifies the new, increased value for the quota.

  • ContextId (string) – Specifies the resource with an Amazon Resource Name (ARN).

  • SupportCaseAllowed (boolean) –

    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.

Return type:

dict

Returns:

Response Syntax

{
    'RequestedQuota': {
        'Id': 'string',
        '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.

      • 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