list_service_quotas

ServiceQuotas.Client.list_service_quotas(**kwargs)

Lists the applied quota values for the specified AWS service. For some quotas, only the default values are available. If the applied quota value is not available for a quota, the quota is not retrieved.

See also: AWS API Documentation

Request Syntax

response = client.list_service_quotas(
    ServiceCode='string',
    NextToken='string',
    MaxResults=123
)
Parameters
  • ServiceCode (string) --

    [REQUIRED]

    The service identifier.

  • NextToken (string) -- The token for the next page of results.
  • MaxResults (integer) -- The maximum number of results to return with a single call. To retrieve the remaining results, if any, make another call with the token returned from this call.
Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'Quotas': [
        {
            'ServiceCode': 'string',
            'ServiceName': 'string',
            'QuotaArn': 'string',
            'QuotaCode': 'string',
            'QuotaName': 'string',
            'Value': 123.0,
            'Unit': 'string',
            'Adjustable': True|False,
            'GlobalQuota': True|False,
            'UsageMetric': {
                'MetricNamespace': 'string',
                'MetricName': 'string',
                'MetricDimensions': {
                    'string': 'string'
                },
                'MetricStatisticRecommendation': 'string'
            },
            'Period': {
                'PeriodValue': 123,
                'PeriodUnit': 'MICROSECOND'|'MILLISECOND'|'SECOND'|'MINUTE'|'HOUR'|'DAY'|'WEEK'
            },
            'ErrorReason': {
                'ErrorCode': 'DEPENDENCY_ACCESS_DENIED_ERROR'|'DEPENDENCY_THROTTLING_ERROR'|'DEPENDENCY_SERVICE_ERROR'|'SERVICE_QUOTA_NOT_AVAILABLE_ERROR',
                'ErrorMessage': 'string'
            }
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.

    • Quotas (list) --

      Information about the quotas.

      • (dict) --

        Information about a quota.

        • ServiceCode (string) --

          The service identifier.

        • ServiceName (string) --

          The service name.

        • QuotaArn (string) --

          The Amazon Resource Name (ARN) of the quota.

        • QuotaCode (string) --

          The quota identifier.

        • QuotaName (string) --

          The quota name.

        • Value (float) --

          The quota value.

        • Unit (string) --

          The unit of measurement.

        • Adjustable (boolean) --

          Indicates whether the quota value can be increased.

        • GlobalQuota (boolean) --

          Indicates whether the quota is global.

        • UsageMetric (dict) --

          Information about the measurement.

          • MetricNamespace (string) --

            The namespace of the metric.

          • MetricName (string) --

            The name of the metric.

          • MetricDimensions (dict) --

            The metric dimension. This is a name/value pair that is part of the identity of a metric.

            • (string) --
              • (string) --
          • MetricStatisticRecommendation (string) --

            The metric statistic that we recommend you use when determining quota usage.

        • Period (dict) --

          The period of time.

          • PeriodValue (integer) --

            The value.

          • PeriodUnit (string) --

            The time unit.

        • ErrorReason (dict) --

          The error code and error reason.

          • ErrorCode (string) --

            Service Quotas returns the following error values:

            • DEPENDENCY_ACCESS_DENIED_ERROR - The caller does not have the required permissions to complete the action. To resolve the error, you must have permission to access the service or quota.
            • DEPENDENCY_THROTTLING_ERROR - The service is throttling Service Quotas.
            • DEPENDENCY_SERVICE_ERROR - The service is not available.
            • SERVICE_QUOTA_NOT_AVAILABLE_ERROR - There was an error in Service Quotas.
          • ErrorMessage (string) --

            The error message.

Exceptions

  • ServiceQuotas.Client.exceptions.AccessDeniedException
  • ServiceQuotas.Client.exceptions.NoSuchResourceException
  • ServiceQuotas.Client.exceptions.IllegalArgumentException
  • ServiceQuotas.Client.exceptions.InvalidPaginationTokenException
  • ServiceQuotas.Client.exceptions.ServiceException
  • ServiceQuotas.Client.exceptions.TooManyRequestsException