2019/06/24 - Service Quotas - 16 new api methods
Changes Service Quotas enables you to view and manage your quotas for AWS services from a central location.
Lists the AWS services available in Service Quotas. Not all AWS services are available in Service Quotas. To list the see the list of the service quotas for a specific service, use ListServiceQuotas.
See also: AWS API Documentation
Request Syntax
client.list_services(
NextToken='string',
MaxResults=123
)
string
(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from.
integer
(Optional) Limits the number of results that you want to include in the response. If you don't include this parameter, the response defaults to a value that's specific to the operation. If additional items exist beyond the specified maximum, the NextToken element is present and has a value (isn't null). Include that value as the NextToken request parameter in the call to the operation to get the next part of the results. You should check NextToken after every operation to ensure that you receive all of the results.
dict
Response Syntax
{
'NextToken': 'string',
'Services': [
{
'ServiceCode': 'string',
'ServiceName': 'string'
},
]
}
Response Structure
(dict) --
NextToken (string) --
If present in the response, this value indicates there's more output available that what's included in the current response. This can occur even when the response includes no values at all, such as when you ask for a filtered view of a very long list. Use this value in the NextToken request parameter in a subsequent call to the operation to continue processing and get the next part of the output. You should repeat this until the NextToken response element comes back empty (as null ).
Services (list) --
Returns a list of services.
(dict) --
A structure that contains the ServiceName and ServiceCode . It does not include all details of the service quota. To get those values, use the ListServiceQuotas operation.
ServiceCode (string) --
Specifies the service that you want to use.
ServiceName (string) --
The name of the AWS service specified in the increase request.
Retrieves the ServiceQuotaTemplateAssociationStatus value from the service. Use this action to determine if the Service Quota template is associated, or enabled.
See also: AWS API Documentation
Request Syntax
client.get_association_for_service_quota_template()
dict
Response Syntax
{
'ServiceQuotaTemplateAssociationStatus': 'ASSOCIATED'|'DISASSOCIATED'
}
Response Structure
(dict) --
ServiceQuotaTemplateAssociationStatus (string) --
Specifies whether the template is ASSOCIATED or DISASSOCIATED . If the template is ASSOCIATED , then it requests service quota increases for all new accounts created in your organization.
Associates the Service Quotas template with your organization so that when new accounts are created in your organization, the template submits increase requests for the specified service quotas. Use the Service Quotas template to request an increase for any adjustable quota value. After you define the Service Quotas template, use this operation to associate, or enable, the template.
See also: AWS API Documentation
Request Syntax
client.associate_service_quota_template()
dict
Response Syntax
{}
Response Structure
(dict) --
Removes a service quota increase request from the Service Quotas template.
See also: AWS API Documentation
Request Syntax
client.delete_service_quota_increase_request_from_template(
ServiceCode='string',
QuotaCode='string',
AwsRegion='string'
)
string
[REQUIRED]
Specifies the code for the service that you want to delete.
string
[REQUIRED]
Specifies the code for the quota that you want to delete.
string
[REQUIRED]
Specifies the AWS Region for the quota that you want to delete.
dict
Response Syntax
{}
Response Structure
(dict) --
Lists all default service quotas for the specified AWS service or all AWS services. ListAWSDefaultServiceQuotas is similar to ListServiceQuotas except for the Value object. The Value object returned by ListAWSDefaultServiceQuotas is the default value assigned by AWS. This request returns a list of all service quotas for the specified service. The listing of each you'll see the default values are the values that AWS provides for the quotas.
Note
Always check the NextToken response parameter when calling any of the List* operations. These operations can return an unexpected list of results, even when there are more results available. When this happens, the NextToken response parameter contains a value to pass the next call to the same API to request the next part of the list.
See also: AWS API Documentation
Request Syntax
client.list_aws_default_service_quotas(
ServiceCode='string',
NextToken='string',
MaxResults=123
)
string
[REQUIRED]
Specifies the service that you want to use.
string
(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from. If additional items exist beyond the specified maximum, the NextToken element is present and has a value (isn't null). Include that value as the NextToken request parameter in the call to the operation to get the next part of the results. You should check NextToken after every operation to ensure that you receive all of the results.
integer
(Optional) Limits the number of results that you want to include in the response. If you don't include this parameter, the response defaults to a value that's specific to the operation. If additional items exist beyond the specified maximum, the NextToken element is present and has a value (isn't null). Include that value as the NextToken request parameter in the call to the operation to get the next part of the results. You should check NextToken after every operation to ensure that you receive all of the results.
dict
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) --
(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from.
Quotas (list) --
A list of the quotas in the account with the AWS default values.
(dict) --
A structure that contains the full set of details that define the service quota.
ServiceCode (string) --
Specifies the service that you want to use.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaArn (string) --
The Amazon Resource Name (ARN) of the service quota.
QuotaCode (string) --
The code identifier for the service quota specified.
QuotaName (string) --
The name identifier of the service quota.
Value (float) --
The value of service quota.
Unit (string) --
The unit of measurement for the value of the service quota.
Adjustable (boolean) --
Specifies if the quota value can be increased.
GlobalQuota (boolean) --
Specifies if the quota is global.
UsageMetric (dict) --
Specifies the details about the measurement.
MetricNamespace (string) --
The namespace of the metric. The namespace is a container for CloudWatch metrics. You can specify a name for the namespace when you create a metric.
MetricName (string) --
The name of the CloudWatch metric that measures usage of a service quota. This is a required field.
MetricDimensions (dict) --
A dimension is a name/value pair that is part of the identity of a metric. Every metric has specific characteristics that describe it, and you can think of dimensions as categories for those characteristics. These dimensions are part of the CloudWatch Metric Identity that measures usage against a particular service quota.
(string) --
(string) --
MetricStatisticRecommendation (string) --
Statistics are metric data aggregations over specified periods of time. This is the recommended statistic to use when comparing usage in the CloudWatch Metric against your Service Quota.
Period (dict) --
Identifies the unit and value of how time is measured.
PeriodValue (integer) --
The value of a period.
PeriodUnit (string) --
The time unit of a period.
ErrorReason (dict) --
Specifies the ErrorCode and ErrorMessage when success isn't achieved.
ErrorCode (string) --
Service Quotas returns the following error values.
DEPENDENCY_ACCESS_DENIED_ERROR is returned when the caller does not have permission to call the service or service quota. To resolve the error, you need permission to access the service or service quota.
DEPENDENCY_THROTTLING_ERROR is returned when the service being called is throttling Service Quotas.
DEPENDENCY_SERVICE_ERROR is returned when the service being called has availability issues.
SERVICE_QUOTA_NOT_AVAILABLE_ERROR is returned when there was an error in Service Quotas.
ErrorMessage (string) --
The error message that provides more detail.
Lists all service quotas for the specified AWS service. This request returns a list of the service quotas for the specified service. you'll see the default values are the values that AWS provides for the quotas.
Note
Always check the NextToken response parameter when calling any of the List* operations. These operations can return an unexpected list of results, even when there are more results available. When this happens, the NextToken response parameter contains a value to pass the next call to the same API to request the next part of the list.
See also: AWS API Documentation
Request Syntax
client.list_service_quotas(
ServiceCode='string',
NextToken='string',
MaxResults=123
)
string
[REQUIRED]
The identifier for a service. When performing an operation, use the ServiceCode to specify a particular service.
string
(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from.
integer
(Optional) Limits the number of results that you want to include in the response. If you don't include this parameter, the response defaults to a value that's specific to the operation. If additional items exist beyond the specified maximum, the NextToken element is present and has a value (isn't null). Include that value as the NextToken request parameter in the call to the operation to get the next part of the results. You should check NextToken after every operation to ensure that you receive all of the results.
dict
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) --
If present in the response, this value indicates there's more output available that what's included in the current response. This can occur even when the response includes no values at all, such as when you ask for a filtered view of a very long list. Use this value in the NextToken request parameter in a subsequent call to the operation to continue processing and get the next part of the output. You should repeat this until the NextToken response element comes back empty (as null ).
Quotas (list) --
The response information for a quota lists all attribute information for the quota.
(dict) --
A structure that contains the full set of details that define the service quota.
ServiceCode (string) --
Specifies the service that you want to use.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaArn (string) --
The Amazon Resource Name (ARN) of the service quota.
QuotaCode (string) --
The code identifier for the service quota specified.
QuotaName (string) --
The name identifier of the service quota.
Value (float) --
The value of service quota.
Unit (string) --
The unit of measurement for the value of the service quota.
Adjustable (boolean) --
Specifies if the quota value can be increased.
GlobalQuota (boolean) --
Specifies if the quota is global.
UsageMetric (dict) --
Specifies the details about the measurement.
MetricNamespace (string) --
The namespace of the metric. The namespace is a container for CloudWatch metrics. You can specify a name for the namespace when you create a metric.
MetricName (string) --
The name of the CloudWatch metric that measures usage of a service quota. This is a required field.
MetricDimensions (dict) --
A dimension is a name/value pair that is part of the identity of a metric. Every metric has specific characteristics that describe it, and you can think of dimensions as categories for those characteristics. These dimensions are part of the CloudWatch Metric Identity that measures usage against a particular service quota.
(string) --
(string) --
MetricStatisticRecommendation (string) --
Statistics are metric data aggregations over specified periods of time. This is the recommended statistic to use when comparing usage in the CloudWatch Metric against your Service Quota.
Period (dict) --
Identifies the unit and value of how time is measured.
PeriodValue (integer) --
The value of a period.
PeriodUnit (string) --
The time unit of a period.
ErrorReason (dict) --
Specifies the ErrorCode and ErrorMessage when success isn't achieved.
ErrorCode (string) --
Service Quotas returns the following error values.
DEPENDENCY_ACCESS_DENIED_ERROR is returned when the caller does not have permission to call the service or service quota. To resolve the error, you need permission to access the service or service quota.
DEPENDENCY_THROTTLING_ERROR is returned when the service being called is throttling Service Quotas.
DEPENDENCY_SERVICE_ERROR is returned when the service being called has availability issues.
SERVICE_QUOTA_NOT_AVAILABLE_ERROR is returned when there was an error in Service Quotas.
ErrorMessage (string) --
The error message that provides more detail.
Retrieves the details of a service quota increase request. The response to this command provides the details in the RequestedServiceQuotaChange object.
See also: AWS API Documentation
Request Syntax
client.request_service_quota_increase(
ServiceCode='string',
QuotaCode='string',
DesiredValue=123.0
)
string
[REQUIRED]
Specifies the service that you want to use.
string
[REQUIRED]
Specifies the service quota that you want to use.
float
[REQUIRED]
Specifies the value submitted in the service quota increase request.
dict
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',
'Created': datetime(2015, 1, 1),
'LastUpdated': datetime(2015, 1, 1),
'Requester': 'string',
'QuotaArn': 'string',
'GlobalQuota': True|False,
'Unit': 'string'
}
}
Response Structure
(dict) --
RequestedQuota (dict) --
Returns a list of service quota requests.
Id (string) --
The unique identifier of a requested service quota change.
CaseId (string) --
The case Id for the service quota increase request.
ServiceCode (string) --
Specifies the service that you want to use.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaCode (string) --
Specifies the service quota that you want to use.
QuotaName (string) --
Name of the service quota.
DesiredValue (float) --
New increased value for the service quota.
Status (string) --
State of the service quota increase request.
Created (datetime) --
The date and time when the service quota increase request was received and the case Id was created.
LastUpdated (datetime) --
The date and time of the most recent change in the service quota increase request.
Requester (string) --
The IAM identity who submitted the service quota increase request.
QuotaArn (string) --
The Amazon Resource Name (ARN) of the service quota.
GlobalQuota (boolean) --
Identifies if the quota is global.
Unit (string) --
Specifies the unit used for the quota.
Returns the details of the service quota increase request in your template.
See also: AWS API Documentation
Request Syntax
client.get_service_quota_increase_request_from_template(
ServiceCode='string',
QuotaCode='string',
AwsRegion='string'
)
string
[REQUIRED]
Specifies the service that you want to use.
string
[REQUIRED]
Specifies the quota you want.
string
[REQUIRED]
Specifies the AWS Region for the quota that you want to use.
dict
Response Syntax
{
'ServiceQuotaIncreaseRequestInTemplate': {
'ServiceCode': 'string',
'ServiceName': 'string',
'QuotaCode': 'string',
'QuotaName': 'string',
'DesiredValue': 123.0,
'AwsRegion': 'string',
'Unit': 'string',
'GlobalQuota': True|False
}
}
Response Structure
(dict) --
ServiceQuotaIncreaseRequestInTemplate (dict) --
This object contains the details about the quota increase request.
ServiceCode (string) --
The code identifier for the AWS service specified in the increase request.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaCode (string) --
The code identifier for the service quota specified in the increase request.
QuotaName (string) --
The name of the service quota in the increase request.
DesiredValue (float) --
Identifies the new, increased value of the service quota in the increase request.
AwsRegion (string) --
The AWS Region where the increase request occurs.
Unit (string) --
The unit of measure for the increase request.
GlobalQuota (boolean) --
Specifies if the quota is a global quota.
Requests a list of the changes to specific service quotas. This command provides additional granularity over the ListRequestedServiceQuotaChangeHistory command. Once a quota change request has reached CASE_CLOSED, APPROVED, or DENIED , the history has been kept for 90 days.
See also: AWS API Documentation
Request Syntax
client.list_requested_service_quota_change_history_by_quota(
ServiceCode='string',
QuotaCode='string',
Status='PENDING'|'CASE_OPENED'|'APPROVED'|'DENIED'|'CASE_CLOSED',
NextToken='string',
MaxResults=123
)
string
[REQUIRED]
Specifies the service that you want to use.
string
[REQUIRED]
Specifies the service quota that you want to use
string
Specifies the status value of the quota increase request.
string
(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from.
integer
(Optional) Limits the number of results that you want to include in the response. If you don't include this parameter, the response defaults to a value that's specific to the operation. If additional items exist beyond the specified maximum, the NextToken element is present and has a value (isn't null). Include that value as the NextToken request parameter in the call to the operation to get the next part of the results. You should check NextToken after every operation to ensure that you receive all of the results.
dict
Response Syntax
{
'NextToken': 'string',
'RequestedQuotas': [
{
'Id': 'string',
'CaseId': 'string',
'ServiceCode': 'string',
'ServiceName': 'string',
'QuotaCode': 'string',
'QuotaName': 'string',
'DesiredValue': 123.0,
'Status': 'PENDING'|'CASE_OPENED'|'APPROVED'|'DENIED'|'CASE_CLOSED',
'Created': datetime(2015, 1, 1),
'LastUpdated': datetime(2015, 1, 1),
'Requester': 'string',
'QuotaArn': 'string',
'GlobalQuota': True|False,
'Unit': 'string'
},
]
}
Response Structure
(dict) --
NextToken (string) --
If present in the response, this value indicates there's more output available that what's included in the current response. This can occur even when the response includes no values at all, such as when you ask for a filtered view of a very long list. Use this value in the NextToken request parameter in a subsequent call to the operation to continue processing and get the next part of the output. You should repeat this until the NextToken response element comes back empty (as null ).
RequestedQuotas (list) --
Returns a list of service quota requests.
(dict) --
A structure that contains information about a requested change for a quota.
Id (string) --
The unique identifier of a requested service quota change.
CaseId (string) --
The case Id for the service quota increase request.
ServiceCode (string) --
Specifies the service that you want to use.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaCode (string) --
Specifies the service quota that you want to use.
QuotaName (string) --
Name of the service quota.
DesiredValue (float) --
New increased value for the service quota.
Status (string) --
State of the service quota increase request.
Created (datetime) --
The date and time when the service quota increase request was received and the case Id was created.
LastUpdated (datetime) --
The date and time of the most recent change in the service quota increase request.
Requester (string) --
The IAM identity who submitted the service quota increase request.
QuotaArn (string) --
The Amazon Resource Name (ARN) of the service quota.
GlobalQuota (boolean) --
Identifies if the quota is global.
Unit (string) --
Specifies the unit used for the quota.
Disables the Service Quotas template. Once the template is disabled, it does not request quota increases for new accounts in your organization. Disabling the quota template does not apply the quota increase requests from the template.
Related operations
To enable the quota template, call AssociateServiceQuotaTemplate.
To delete a specific service quota from the template, use DeleteServiceQuotaIncreaseRequestFromTemplate.
See also: AWS API Documentation
Request Syntax
client.disassociate_service_quota_template()
dict
Response Syntax
{}
Response Structure
(dict) --
Defines and adds a quota to the service quota template. To add a quota to the template, you must provide the ServiceCode , QuotaCode , AwsRegion , and DesiredValue . Once you add a quota to the template, use ListServiceQuotaIncreaseRequestsInTemplate to see the list of quotas in the template.
See also: AWS API Documentation
Request Syntax
client.put_service_quota_increase_request_into_template(
QuotaCode='string',
ServiceCode='string',
AwsRegion='string',
DesiredValue=123.0
)
string
[REQUIRED]
Specifies the service quota that you want to use.
string
[REQUIRED]
Specifies the service that you want to use.
string
[REQUIRED]
Specifies the AWS Region for the quota.
float
[REQUIRED]
Specifies the new, increased value for the quota.
dict
Response Syntax
{
'ServiceQuotaIncreaseRequestInTemplate': {
'ServiceCode': 'string',
'ServiceName': 'string',
'QuotaCode': 'string',
'QuotaName': 'string',
'DesiredValue': 123.0,
'AwsRegion': 'string',
'Unit': 'string',
'GlobalQuota': True|False
}
}
Response Structure
(dict) --
ServiceQuotaIncreaseRequestInTemplate (dict) --
A structure that contains information about one service quota increase request.
ServiceCode (string) --
The code identifier for the AWS service specified in the increase request.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaCode (string) --
The code identifier for the service quota specified in the increase request.
QuotaName (string) --
The name of the service quota in the increase request.
DesiredValue (float) --
Identifies the new, increased value of the service quota in the increase request.
AwsRegion (string) --
The AWS Region where the increase request occurs.
Unit (string) --
The unit of measure for the increase request.
GlobalQuota (boolean) --
Specifies if the quota is a global quota.
Retrieves the details for a particular increase request.
See also: AWS API Documentation
Request Syntax
client.get_requested_service_quota_change(
RequestId='string'
)
string
[REQUIRED]
Identifies the quota increase request.
dict
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',
'Created': datetime(2015, 1, 1),
'LastUpdated': datetime(2015, 1, 1),
'Requester': 'string',
'QuotaArn': 'string',
'GlobalQuota': True|False,
'Unit': 'string'
}
}
Response Structure
(dict) --
RequestedQuota (dict) --
Returns the RequestedServiceQuotaChange object for the specific increase request.
Id (string) --
The unique identifier of a requested service quota change.
CaseId (string) --
The case Id for the service quota increase request.
ServiceCode (string) --
Specifies the service that you want to use.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaCode (string) --
Specifies the service quota that you want to use.
QuotaName (string) --
Name of the service quota.
DesiredValue (float) --
New increased value for the service quota.
Status (string) --
State of the service quota increase request.
Created (datetime) --
The date and time when the service quota increase request was received and the case Id was created.
LastUpdated (datetime) --
The date and time of the most recent change in the service quota increase request.
Requester (string) --
The IAM identity who submitted the service quota increase request.
QuotaArn (string) --
The Amazon Resource Name (ARN) of the service quota.
GlobalQuota (boolean) --
Identifies if the quota is global.
Unit (string) --
Specifies the unit used for the quota.
Returns a list of the quota increase requests in the template.
See also: AWS API Documentation
Request Syntax
client.list_service_quota_increase_requests_in_template(
ServiceCode='string',
AwsRegion='string',
NextToken='string',
MaxResults=123
)
string
The identifier for a service. When performing an operation, use the ServiceCode to specify a particular service.
string
Specifies the AWS Region for the quota that you want to use.
string
(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from.
integer
(Optional) Limits the number of results that you want to include in the response. If you don't include this parameter, the response defaults to a value that's specific to the operation. If additional items exist beyond the specified maximum, the NextToken element is present and has a value (isn't null). Include that value as the NextToken request parameter in the call to the operation to get the next part of the results. You should check NextToken after every operation to ensure that you receive all of the results.
dict
Response Syntax
{
'ServiceQuotaIncreaseRequestInTemplateList': [
{
'ServiceCode': 'string',
'ServiceName': 'string',
'QuotaCode': 'string',
'QuotaName': 'string',
'DesiredValue': 123.0,
'AwsRegion': 'string',
'Unit': 'string',
'GlobalQuota': True|False
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
ServiceQuotaIncreaseRequestInTemplateList (list) --
Returns the list of values of the quota increase request in the template.
(dict) --
A structure that contains information about one service quota increase request.
ServiceCode (string) --
The code identifier for the AWS service specified in the increase request.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaCode (string) --
The code identifier for the service quota specified in the increase request.
QuotaName (string) --
The name of the service quota in the increase request.
DesiredValue (float) --
Identifies the new, increased value of the service quota in the increase request.
AwsRegion (string) --
The AWS Region where the increase request occurs.
Unit (string) --
The unit of measure for the increase request.
GlobalQuota (boolean) --
Specifies if the quota is a global quota.
NextToken (string) --
If present in the response, this value indicates there's more output available that what's included in the current response. This can occur even when the response includes no values at all, such as when you ask for a filtered view of a very long list. Use this value in the NextToken request parameter in a subsequent call to the operation to continue processing and get the next part of the output. You should repeat this until the NextToken response element comes back empty (as null ).
Returns the details for the specified service quota. This operation provides a different Value than the GetAWSDefaultServiceQuota operation. This operation returns the applied value for each quota. GetAWSDefaultServiceQuota returns the default AWS value for each quota.
See also: AWS API Documentation
Request Syntax
client.get_service_quota(
ServiceCode='string',
QuotaCode='string'
)
string
[REQUIRED]
Specifies the service that you want to use.
string
[REQUIRED]
Identifies the service quota you want to select.
dict
Response Syntax
{
'Quota': {
'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) --
Quota (dict) --
Returns the ServiceQuota object which contains all values for a quota.
ServiceCode (string) --
Specifies the service that you want to use.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaArn (string) --
The Amazon Resource Name (ARN) of the service quota.
QuotaCode (string) --
The code identifier for the service quota specified.
QuotaName (string) --
The name identifier of the service quota.
Value (float) --
The value of service quota.
Unit (string) --
The unit of measurement for the value of the service quota.
Adjustable (boolean) --
Specifies if the quota value can be increased.
GlobalQuota (boolean) --
Specifies if the quota is global.
UsageMetric (dict) --
Specifies the details about the measurement.
MetricNamespace (string) --
The namespace of the metric. The namespace is a container for CloudWatch metrics. You can specify a name for the namespace when you create a metric.
MetricName (string) --
The name of the CloudWatch metric that measures usage of a service quota. This is a required field.
MetricDimensions (dict) --
A dimension is a name/value pair that is part of the identity of a metric. Every metric has specific characteristics that describe it, and you can think of dimensions as categories for those characteristics. These dimensions are part of the CloudWatch Metric Identity that measures usage against a particular service quota.
(string) --
(string) --
MetricStatisticRecommendation (string) --
Statistics are metric data aggregations over specified periods of time. This is the recommended statistic to use when comparing usage in the CloudWatch Metric against your Service Quota.
Period (dict) --
Identifies the unit and value of how time is measured.
PeriodValue (integer) --
The value of a period.
PeriodUnit (string) --
The time unit of a period.
ErrorReason (dict) --
Specifies the ErrorCode and ErrorMessage when success isn't achieved.
ErrorCode (string) --
Service Quotas returns the following error values.
DEPENDENCY_ACCESS_DENIED_ERROR is returned when the caller does not have permission to call the service or service quota. To resolve the error, you need permission to access the service or service quota.
DEPENDENCY_THROTTLING_ERROR is returned when the service being called is throttling Service Quotas.
DEPENDENCY_SERVICE_ERROR is returned when the service being called has availability issues.
SERVICE_QUOTA_NOT_AVAILABLE_ERROR is returned when there was an error in Service Quotas.
ErrorMessage (string) --
The error message that provides more detail.
Requests a list of the changes to quotas for a service.
See also: AWS API Documentation
Request Syntax
client.list_requested_service_quota_change_history(
ServiceCode='string',
Status='PENDING'|'CASE_OPENED'|'APPROVED'|'DENIED'|'CASE_CLOSED',
NextToken='string',
MaxResults=123
)
string
Specifies the service that you want to use.
string
Specifies the status value of the quota increase request.
string
(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from.
integer
(Optional) Limits the number of results that you want to include in the response. If you don't include this parameter, the response defaults to a value that's specific to the operation. If additional items exist beyond the specified maximum, the NextToken element is present and has a value (isn't null). Include that value as the NextToken request parameter in the call to the operation to get the next part of the results. You should check NextToken after every operation to ensure that you receive all of the results.
dict
Response Syntax
{
'NextToken': 'string',
'RequestedQuotas': [
{
'Id': 'string',
'CaseId': 'string',
'ServiceCode': 'string',
'ServiceName': 'string',
'QuotaCode': 'string',
'QuotaName': 'string',
'DesiredValue': 123.0,
'Status': 'PENDING'|'CASE_OPENED'|'APPROVED'|'DENIED'|'CASE_CLOSED',
'Created': datetime(2015, 1, 1),
'LastUpdated': datetime(2015, 1, 1),
'Requester': 'string',
'QuotaArn': 'string',
'GlobalQuota': True|False,
'Unit': 'string'
},
]
}
Response Structure
(dict) --
NextToken (string) --
If present in the response, this value indicates there's more output available that what's included in the current response. This can occur even when the response includes no values at all, such as when you ask for a filtered view of a very long list. Use this value in the NextToken request parameter in a subsequent call to the operation to continue processing and get the next part of the output. You should repeat this until the NextToken response element comes back empty (as null ).
RequestedQuotas (list) --
Returns a list of service quota requests.
(dict) --
A structure that contains information about a requested change for a quota.
Id (string) --
The unique identifier of a requested service quota change.
CaseId (string) --
The case Id for the service quota increase request.
ServiceCode (string) --
Specifies the service that you want to use.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaCode (string) --
Specifies the service quota that you want to use.
QuotaName (string) --
Name of the service quota.
DesiredValue (float) --
New increased value for the service quota.
Status (string) --
State of the service quota increase request.
Created (datetime) --
The date and time when the service quota increase request was received and the case Id was created.
LastUpdated (datetime) --
The date and time of the most recent change in the service quota increase request.
Requester (string) --
The IAM identity who submitted the service quota increase request.
QuotaArn (string) --
The Amazon Resource Name (ARN) of the service quota.
GlobalQuota (boolean) --
Identifies if the quota is global.
Unit (string) --
Specifies the unit used for the quota.
Retrieves the default service quotas values. The Value returned for each quota is the AWS default value, even if the quotas have been increased..
See also: AWS API Documentation
Request Syntax
client.get_aws_default_service_quota(
ServiceCode='string',
QuotaCode='string'
)
string
[REQUIRED]
Specifies the service that you want to use.
string
[REQUIRED]
Identifies the service quota you want to select.
dict
Response Syntax
{
'Quota': {
'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) --
Quota (dict) --
Returns the ServiceQuota object which contains all values for a quota.
ServiceCode (string) --
Specifies the service that you want to use.
ServiceName (string) --
The name of the AWS service specified in the increase request.
QuotaArn (string) --
The Amazon Resource Name (ARN) of the service quota.
QuotaCode (string) --
The code identifier for the service quota specified.
QuotaName (string) --
The name identifier of the service quota.
Value (float) --
The value of service quota.
Unit (string) --
The unit of measurement for the value of the service quota.
Adjustable (boolean) --
Specifies if the quota value can be increased.
GlobalQuota (boolean) --
Specifies if the quota is global.
UsageMetric (dict) --
Specifies the details about the measurement.
MetricNamespace (string) --
The namespace of the metric. The namespace is a container for CloudWatch metrics. You can specify a name for the namespace when you create a metric.
MetricName (string) --
The name of the CloudWatch metric that measures usage of a service quota. This is a required field.
MetricDimensions (dict) --
A dimension is a name/value pair that is part of the identity of a metric. Every metric has specific characteristics that describe it, and you can think of dimensions as categories for those characteristics. These dimensions are part of the CloudWatch Metric Identity that measures usage against a particular service quota.
(string) --
(string) --
MetricStatisticRecommendation (string) --
Statistics are metric data aggregations over specified periods of time. This is the recommended statistic to use when comparing usage in the CloudWatch Metric against your Service Quota.
Period (dict) --
Identifies the unit and value of how time is measured.
PeriodValue (integer) --
The value of a period.
PeriodUnit (string) --
The time unit of a period.
ErrorReason (dict) --
Specifies the ErrorCode and ErrorMessage when success isn't achieved.
ErrorCode (string) --
Service Quotas returns the following error values.
DEPENDENCY_ACCESS_DENIED_ERROR is returned when the caller does not have permission to call the service or service quota. To resolve the error, you need permission to access the service or service quota.
DEPENDENCY_THROTTLING_ERROR is returned when the service being called is throttling Service Quotas.
DEPENDENCY_SERVICE_ERROR is returned when the service being called has availability issues.
SERVICE_QUOTA_NOT_AVAILABLE_ERROR is returned when there was an error in Service Quotas.
ErrorMessage (string) --
The error message that provides more detail.