com.amazonaws.services.servicequotas

Interface AWSServiceQuotas

All Known Subinterfaces:

AWSServiceQuotasAsync

All Known Implementing Classes:

AbstractAWSServiceQuotas, AbstractAWSServiceQuotasAsync, AWSServiceQuotasAsyncClient, AWSServiceQuotasClient

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public interface AWSServiceQuotas

Interface for accessing Service Quotas.

Note: Do not directly implement this interface, new methods are added to it regularly. Extend from AbstractAWSServiceQuotas instead.

Service Quotas is a web service that you can use to manage many of your AWS service quotas. Quotas, also referred to as limits, are the maximum values for a resource, item, or operation. This guide provide descriptions of the Service Quotas actions that you can call from an API. For the Service Quotas user guide, which explains how to use Service Quotas from the console, see What is Service Quotas.

AWS provides SDKs that consist of libraries and sample code for programming languages and platforms (Java, Ruby, .NET, iOS, Android, etc...,). The SDKs provide a convenient way to create programmatic access to Service Quotas and AWS. For information about the AWS SDKs, including how to download and install them, see the Tools for Amazon Web Services page.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ENDPOINT_PREFIX The region metadata service name for computing region endpoints.

Method Summary

Modifier and Type	Method and Description
AssociateServiceQuotaTemplateResult	associateServiceQuotaTemplate(AssociateServiceQuotaTemplateRequest associateServiceQuotaTemplateRequest) 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.
DeleteServiceQuotaIncreaseRequestFromTemplateResult	deleteServiceQuotaIncreaseRequestFromTemplate(DeleteServiceQuotaIncreaseRequestFromTemplateRequest deleteServiceQuotaIncreaseRequestFromTemplateRequest) Removes a service quota increase request from the Service Quotas template.
DisassociateServiceQuotaTemplateResult	disassociateServiceQuotaTemplate(DisassociateServiceQuotaTemplateRequest disassociateServiceQuotaTemplateRequest) Disables the Service Quotas template.
GetAssociationForServiceQuotaTemplateResult	getAssociationForServiceQuotaTemplate(GetAssociationForServiceQuotaTemplateRequest getAssociationForServiceQuotaTemplateRequest) Retrieves the ServiceQuotaTemplateAssociationStatus value from the service.
GetAWSDefaultServiceQuotaResult	getAWSDefaultServiceQuota(GetAWSDefaultServiceQuotaRequest getAWSDefaultServiceQuotaRequest) Retrieves the default service quotas values.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected.
GetRequestedServiceQuotaChangeResult	getRequestedServiceQuotaChange(GetRequestedServiceQuotaChangeRequest getRequestedServiceQuotaChangeRequest) Retrieves the details for a particular increase request.
GetServiceQuotaResult	getServiceQuota(GetServiceQuotaRequest getServiceQuotaRequest) Returns the details for the specified service quota.
GetServiceQuotaIncreaseRequestFromTemplateResult	getServiceQuotaIncreaseRequestFromTemplate(GetServiceQuotaIncreaseRequestFromTemplateRequest getServiceQuotaIncreaseRequestFromTemplateRequest) Returns the details of the service quota increase request in your template.
ListAWSDefaultServiceQuotasResult	listAWSDefaultServiceQuotas(ListAWSDefaultServiceQuotasRequest listAWSDefaultServiceQuotasRequest) Lists all default service quotas for the specified AWS service or all AWS services.
ListRequestedServiceQuotaChangeHistoryResult	listRequestedServiceQuotaChangeHistory(ListRequestedServiceQuotaChangeHistoryRequest listRequestedServiceQuotaChangeHistoryRequest) Requests a list of the changes to quotas for a service.
ListRequestedServiceQuotaChangeHistoryByQuotaResult	listRequestedServiceQuotaChangeHistoryByQuota(ListRequestedServiceQuotaChangeHistoryByQuotaRequest listRequestedServiceQuotaChangeHistoryByQuotaRequest) Requests a list of the changes to specific service quotas.
ListServiceQuotaIncreaseRequestsInTemplateResult	listServiceQuotaIncreaseRequestsInTemplate(ListServiceQuotaIncreaseRequestsInTemplateRequest listServiceQuotaIncreaseRequestsInTemplateRequest) Returns a list of the quota increase requests in the template.
ListServiceQuotasResult	listServiceQuotas(ListServiceQuotasRequest listServiceQuotasRequest) Lists all service quotas for the specified AWS service.
ListServicesResult	listServices(ListServicesRequest listServicesRequest) Lists the AWS services available in Service Quotas.
PutServiceQuotaIncreaseRequestIntoTemplateResult	putServiceQuotaIncreaseRequestIntoTemplate(PutServiceQuotaIncreaseRequestIntoTemplateRequest putServiceQuotaIncreaseRequestIntoTemplateRequest) Defines and adds a quota to the service quota template.
RequestServiceQuotaIncreaseResult	requestServiceQuotaIncrease(RequestServiceQuotaIncreaseRequest requestServiceQuotaIncreaseRequest) Retrieves the details of a service quota increase request.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.

Field Detail

ENDPOINT_PREFIX

static final String ENDPOINT_PREFIX

The region metadata service name for computing region endpoints. You can use this value to retrieve metadata (such as supported regions) of the service.

See Also:

RegionUtils.getRegionsForService(String), Constant Field Values

Method Detail

associateServiceQuotaTemplate

AssociateServiceQuotaTemplateResult associateServiceQuotaTemplate(AssociateServiceQuotaTemplateRequest associateServiceQuotaTemplateRequest)

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.

Parameters:

associateServiceQuotaTemplateRequest -

Returns:

Result of the AssociateServiceQuotaTemplate operation returned by the service.

Throws:

DependencyAccessDeniedException - You can't perform this action because a dependency does not have access.

AccessDeniedException - You do not have sufficient access to perform this action.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

AWSServiceAccessNotEnabledException - The action you attempted is not allowed unless Service Access with Service Quotas is enabled in your organization. To enable, call AssociateServiceQuotaTemplate.

OrganizationNotInAllFeaturesModeException - The organization that your account belongs to, is not in All Features mode. To enable all features mode, see EnableAllFeatures.

TemplatesNotAvailableInRegionException - The Service Quotas template is not available in the Region where you are making the request. Please make the request in us-east-1.

NoAvailableOrganizationException - The account making this call is not a member of an organization.

See Also:

AWS API Documentation

deleteServiceQuotaIncreaseRequestFromTemplate

DeleteServiceQuotaIncreaseRequestFromTemplateResult deleteServiceQuotaIncreaseRequestFromTemplate(DeleteServiceQuotaIncreaseRequestFromTemplateRequest deleteServiceQuotaIncreaseRequestFromTemplateRequest)

Removes a service quota increase request from the Service Quotas template.

Parameters:

deleteServiceQuotaIncreaseRequestFromTemplateRequest -

Returns:

Result of the DeleteServiceQuotaIncreaseRequestFromTemplate operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

ServiceException - Something went wrong.

DependencyAccessDeniedException - You can't perform this action because a dependency does not have access.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

AWSServiceAccessNotEnabledException - The action you attempted is not allowed unless Service Access with Service Quotas is enabled in your organization. To enable, call AssociateServiceQuotaTemplate.

TemplatesNotAvailableInRegionException - The Service Quotas template is not available in the Region where you are making the request. Please make the request in us-east-1.

NoAvailableOrganizationException - The account making this call is not a member of an organization.

See Also:

AWS API Documentation

disassociateServiceQuotaTemplate

DisassociateServiceQuotaTemplateResult disassociateServiceQuotaTemplate(DisassociateServiceQuotaTemplateRequest disassociateServiceQuotaTemplateRequest)

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.

Parameters:

disassociateServiceQuotaTemplateRequest -

Returns:

Result of the DisassociateServiceQuotaTemplate operation returned by the service.

Throws:

DependencyAccessDeniedException - You can't perform this action because a dependency does not have access.

ServiceQuotaTemplateNotInUseException - The quota request template is not associated with your organization.

To use the template, call AssociateServiceQuotaTemplate.

AccessDeniedException - You do not have sufficient access to perform this action.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

AWSServiceAccessNotEnabledException - The action you attempted is not allowed unless Service Access with Service Quotas is enabled in your organization. To enable, call AssociateServiceQuotaTemplate.

TemplatesNotAvailableInRegionException - The Service Quotas template is not available in the Region where you are making the request. Please make the request in us-east-1.

NoAvailableOrganizationException - The account making this call is not a member of an organization.

See Also:

AWS API Documentation

getAWSDefaultServiceQuota

GetAWSDefaultServiceQuotaResult getAWSDefaultServiceQuota(GetAWSDefaultServiceQuotaRequest getAWSDefaultServiceQuotaRequest)

Retrieves the default service quotas values. The Value returned for each quota is the AWS default value, even if the quotas have been increased..

Parameters:

getAWSDefaultServiceQuotaRequest -

Returns:

Result of the GetAWSDefaultServiceQuota operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

See Also:

AWS API Documentation

getAssociationForServiceQuotaTemplate

GetAssociationForServiceQuotaTemplateResult getAssociationForServiceQuotaTemplate(GetAssociationForServiceQuotaTemplateRequest getAssociationForServiceQuotaTemplateRequest)

Retrieves the ServiceQuotaTemplateAssociationStatus value from the service. Use this action to determine if the Service Quota template is associated, or enabled.

Parameters:

getAssociationForServiceQuotaTemplateRequest -

Returns:

Result of the GetAssociationForServiceQuotaTemplate operation returned by the service.

Throws:

DependencyAccessDeniedException - You can't perform this action because a dependency does not have access.

ServiceQuotaTemplateNotInUseException - The quota request template is not associated with your organization.

To use the template, call AssociateServiceQuotaTemplate.

AccessDeniedException - You do not have sufficient access to perform this action.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

AWSServiceAccessNotEnabledException - The action you attempted is not allowed unless Service Access with Service Quotas is enabled in your organization. To enable, call AssociateServiceQuotaTemplate.

TemplatesNotAvailableInRegionException - The Service Quotas template is not available in the Region where you are making the request. Please make the request in us-east-1.

NoAvailableOrganizationException - The account making this call is not a member of an organization.

See Also:

AWS API Documentation

getRequestedServiceQuotaChange

GetRequestedServiceQuotaChangeResult getRequestedServiceQuotaChange(GetRequestedServiceQuotaChangeRequest getRequestedServiceQuotaChangeRequest)

Retrieves the details for a particular increase request.

Parameters:

getRequestedServiceQuotaChangeRequest -

Returns:

Result of the GetRequestedServiceQuotaChange operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

See Also:

AWS API Documentation

getServiceQuota

GetServiceQuotaResult getServiceQuota(GetServiceQuotaRequest getServiceQuotaRequest)

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.

Parameters:

getServiceQuotaRequest -

Returns:

Result of the GetServiceQuota operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

See Also:

AWS API Documentation

getServiceQuotaIncreaseRequestFromTemplate

GetServiceQuotaIncreaseRequestFromTemplateResult getServiceQuotaIncreaseRequestFromTemplate(GetServiceQuotaIncreaseRequestFromTemplateRequest getServiceQuotaIncreaseRequestFromTemplateRequest)

Returns the details of the service quota increase request in your template.

Parameters:

getServiceQuotaIncreaseRequestFromTemplateRequest -

Returns:

Result of the GetServiceQuotaIncreaseRequestFromTemplate operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

DependencyAccessDeniedException - You can't perform this action because a dependency does not have access.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

AWSServiceAccessNotEnabledException - The action you attempted is not allowed unless Service Access with Service Quotas is enabled in your organization. To enable, call AssociateServiceQuotaTemplate.

TemplatesNotAvailableInRegionException - The Service Quotas template is not available in the Region where you are making the request. Please make the request in us-east-1.

NoAvailableOrganizationException - The account making this call is not a member of an organization.

See Also:

AWS API Documentation

listAWSDefaultServiceQuotas

ListAWSDefaultServiceQuotasResult listAWSDefaultServiceQuotas(ListAWSDefaultServiceQuotasRequest listAWSDefaultServiceQuotasRequest)

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.

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.

Parameters:

listAWSDefaultServiceQuotasRequest -

Returns:

Result of the ListAWSDefaultServiceQuotas operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

InvalidPaginationTokenException - Invalid input was provided.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

See Also:

AWS API Documentation

listRequestedServiceQuotaChangeHistory

ListRequestedServiceQuotaChangeHistoryResult listRequestedServiceQuotaChangeHistory(ListRequestedServiceQuotaChangeHistoryRequest listRequestedServiceQuotaChangeHistoryRequest)

Requests a list of the changes to quotas for a service.

Parameters:

listRequestedServiceQuotaChangeHistoryRequest -

Returns:

Result of the ListRequestedServiceQuotaChangeHistory operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

InvalidPaginationTokenException - Invalid input was provided.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

See Also:

AWS API Documentation

listRequestedServiceQuotaChangeHistoryByQuota

ListRequestedServiceQuotaChangeHistoryByQuotaResult listRequestedServiceQuotaChangeHistoryByQuota(ListRequestedServiceQuotaChangeHistoryByQuotaRequest listRequestedServiceQuotaChangeHistoryByQuotaRequest)

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.

Parameters:

listRequestedServiceQuotaChangeHistoryByQuotaRequest -

Returns:

Result of the ListRequestedServiceQuotaChangeHistoryByQuota operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

InvalidPaginationTokenException - Invalid input was provided.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

See Also:

AWS API Documentation

listServiceQuotaIncreaseRequestsInTemplate

ListServiceQuotaIncreaseRequestsInTemplateResult listServiceQuotaIncreaseRequestsInTemplate(ListServiceQuotaIncreaseRequestsInTemplateRequest listServiceQuotaIncreaseRequestsInTemplateRequest)

Returns a list of the quota increase requests in the template.

Parameters:

listServiceQuotaIncreaseRequestsInTemplateRequest -

Returns:

Result of the ListServiceQuotaIncreaseRequestsInTemplate operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

DependencyAccessDeniedException - You can't perform this action because a dependency does not have access.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

IllegalArgumentException - Invalid input was provided.

AWSServiceAccessNotEnabledException - The action you attempted is not allowed unless Service Access with Service Quotas is enabled in your organization. To enable, call AssociateServiceQuotaTemplate.

TemplatesNotAvailableInRegionException - The Service Quotas template is not available in the Region where you are making the request. Please make the request in us-east-1.

NoAvailableOrganizationException - The account making this call is not a member of an organization.

See Also:

AWS API Documentation

listServiceQuotas

ListServiceQuotasResult listServiceQuotas(ListServiceQuotasRequest listServiceQuotasRequest)

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.

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.

Parameters:

listServiceQuotasRequest -

Returns:

Result of the ListServiceQuotas operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

InvalidPaginationTokenException - Invalid input was provided.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

See Also:

AWS API Documentation

listServices

ListServicesResult listServices(ListServicesRequest listServicesRequest)

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.

Parameters:

listServicesRequest -

Returns:

Result of the ListServices operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

IllegalArgumentException - Invalid input was provided.

InvalidPaginationTokenException - Invalid input was provided.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

See Also:

AWS API Documentation

putServiceQuotaIncreaseRequestIntoTemplate

PutServiceQuotaIncreaseRequestIntoTemplateResult putServiceQuotaIncreaseRequestIntoTemplate(PutServiceQuotaIncreaseRequestIntoTemplateRequest putServiceQuotaIncreaseRequestIntoTemplateRequest)

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.

Parameters:

putServiceQuotaIncreaseRequestIntoTemplateRequest -

Returns:

Result of the PutServiceQuotaIncreaseRequestIntoTemplate operation returned by the service.

Throws:

AccessDeniedException - You do not have sufficient access to perform this action.

DependencyAccessDeniedException - You can't perform this action because a dependency does not have access.

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

IllegalArgumentException - Invalid input was provided.

QuotaExceededException - You have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.

NoSuchResourceException - The specified resource does not exist.

AWSServiceAccessNotEnabledException - The action you attempted is not allowed unless Service Access with Service Quotas is enabled in your organization. To enable, call AssociateServiceQuotaTemplate.

TemplatesNotAvailableInRegionException - The Service Quotas template is not available in the Region where you are making the request. Please make the request in us-east-1.

NoAvailableOrganizationException - The account making this call is not a member of an organization.

See Also:

AWS API Documentation

requestServiceQuotaIncrease

RequestServiceQuotaIncreaseResult requestServiceQuotaIncrease(RequestServiceQuotaIncreaseRequest requestServiceQuotaIncreaseRequest)

Retrieves the details of a service quota increase request. The response to this command provides the details in the RequestedServiceQuotaChange object.

Parameters:

requestServiceQuotaIncreaseRequest -

Returns:

Result of the RequestServiceQuotaIncrease operation returned by the service.

Throws:

DependencyAccessDeniedException - You can't perform this action because a dependency does not have access.

QuotaExceededException - You have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.

ResourceAlreadyExistsException - The specified resource already exists.

AccessDeniedException - You do not have sufficient access to perform this action.

NoSuchResourceException - The specified resource does not exist.

IllegalArgumentException - Invalid input was provided.

InvalidResourceStateException - Invalid input was provided for the .

ServiceException - Something went wrong.

TooManyRequestsException - Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

See Also:

AWS API Documentation

shutdown

void shutdown()

Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.

getCachedResponseMetadata

ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.

Parameters:

request - The originally executed request.

Returns:

The response metadata for the specified request, or null if none is available.