|
Did this page help you?Yes No Tell us about it... |
||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.amazonaws.AmazonWebServiceClient
com.amazonaws.services.support.AWSSupportClient
public class AWSSupportClient
Client for accessing AWSSupport. All service calls made using this client are blocking, and will not return until the service call completes.
AWS Support
The AWS Support API reference is intended for programmers who need detailed information about the AWS Support actions and data types. This service enables you to manage with your AWS Support cases programmatically. It is built on the AWS Query API programming model and provides HTTP methods that take parameters and return results in JSON format.
The AWS Support service also exposes a set of Trusted Advisor features. You can retrieve a list of checks you can run on your resources, specify checks to run and refresh, and check the status of checks you have submitted.
The following list describes the AWS Support case management actions:
The following list describes the actions available from the AWS Support service for Trusted Advisor:
For authentication of requests, the AWS Support uses Signature Version 4 Signing Process .
See the AWS Support Developer Guide for information about how to use this service to manage create and manage your support cases, and how to call Trusted Advisor for results of checks on your resources.
Constructor Summary | |
---|---|
AWSSupportClient()
Constructs a new client to invoke service methods on AWSSupport. |
|
AWSSupportClient(AWSCredentials awsCredentials)
Constructs a new client to invoke service methods on AWSSupport using the specified AWS account credentials. |
|
AWSSupportClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on AWSSupport using the specified AWS account credentials and client configuration options. |
|
AWSSupportClient(AWSCredentialsProvider awsCredentialsProvider)
Constructs a new client to invoke service methods on AWSSupport using the specified AWS account credentials provider. |
|
AWSSupportClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on AWSSupport using the specified AWS account credentials provider and client configuration options. |
|
AWSSupportClient(ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on AWSSupport. |
Method Summary | |
---|---|
AddCommunicationToCaseResult |
addCommunicationToCase(AddCommunicationToCaseRequest addCommunicationToCaseRequest)
This action adds additional customer communication to an AWS Support case. |
CreateCaseResult |
createCase(CreateCaseRequest createCaseRequest)
Creates a new case in the AWS Support Center. |
DescribeCasesResult |
describeCases()
This action returns a list of cases that you specify by passing one or more CaseIds. |
DescribeCasesResult |
describeCases(DescribeCasesRequest describeCasesRequest)
This action returns a list of cases that you specify by passing one or more CaseIds. |
DescribeCommunicationsResult |
describeCommunications(DescribeCommunicationsRequest describeCommunicationsRequest)
This action returns communications regarding the support case. |
DescribeServicesResult |
describeServices()
Returns the current list of AWS services and a list of service categories that applies to each one. |
DescribeServicesResult |
describeServices(DescribeServicesRequest describeServicesRequest)
Returns the current list of AWS services and a list of service categories that applies to each one. |
DescribeSeverityLevelsResult |
describeSeverityLevels()
This action returns the list of severity levels that you can assign to an AWS Support case. |
DescribeSeverityLevelsResult |
describeSeverityLevels(DescribeSeverityLevelsRequest describeSeverityLevelsRequest)
This action returns the list of severity levels that you can assign to an AWS Support case. |
DescribeTrustedAdvisorCheckRefreshStatusesResult |
describeTrustedAdvisorCheckRefreshStatuses(DescribeTrustedAdvisorCheckRefreshStatusesRequest describeTrustedAdvisorCheckRefreshStatusesRequest)
Returns the status of all refresh requests Trusted Advisor checks called using RefreshTrustedAdvisorCheck. |
DescribeTrustedAdvisorCheckResultResult |
describeTrustedAdvisorCheckResult(DescribeTrustedAdvisorCheckResultRequest describeTrustedAdvisorCheckResultRequest)
This action responds with the results of a Trusted Advisor check. |
DescribeTrustedAdvisorChecksResult |
describeTrustedAdvisorChecks(DescribeTrustedAdvisorChecksRequest describeTrustedAdvisorChecksRequest)
This action enables you to get a list of the available Trusted Advisor checks. |
DescribeTrustedAdvisorCheckSummariesResult |
describeTrustedAdvisorCheckSummaries(DescribeTrustedAdvisorCheckSummariesRequest describeTrustedAdvisorCheckSummariesRequest)
This action enables you to get the latest summaries for Trusted Advisor checks that you specify in your request. |
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. |
RefreshTrustedAdvisorCheckResult |
refreshTrustedAdvisorCheck(RefreshTrustedAdvisorCheckRequest refreshTrustedAdvisorCheckRequest)
This action enables you to query the service to request a refresh for a specific Trusted Advisor check. |
ResolveCaseResult |
resolveCase()
Takes a CaseId and returns the initial state of the case along with the state of the case after the call to ResolveCase completed. |
ResolveCaseResult |
resolveCase(ResolveCaseRequest resolveCaseRequest)
Takes a CaseId and returns the initial state of the case along with the state of the case after the call to ResolveCase completed. |
void |
setEndpoint(String endpoint,
String serviceName,
String regionId)
Overrides the default endpoint for this client ("support.us-east-1.amazonaws.com") and explicitly provides an AWS region ID and AWS service name to use when the client calculates a signature for requests. |
Methods inherited from class com.amazonaws.AmazonWebServiceClient |
---|
addRequestHandler, getTimeOffset, removeRequestHandler, setConfiguration, setEndpoint, setRegion, setTimeOffset, shutdown, withTimeOffset |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface com.amazonaws.services.support.AWSSupport |
---|
setEndpoint, setRegion, shutdown |
Constructor Detail |
---|
public AWSSupportClient()
All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProvider
public AWSSupportClient(ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration
- The client configuration options controlling how this
client connects to AWSSupport
(ex: proxy settings, retry counts, etc.).DefaultAWSCredentialsProvider
public AWSSupportClient(AWSCredentials awsCredentials)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.public AWSSupportClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.clientConfiguration
- The client configuration options controlling how this
client connects to AWSSupport
(ex: proxy settings, retry counts, etc.).public AWSSupportClient(AWSCredentialsProvider awsCredentialsProvider)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials
to authenticate requests with AWS services.public AWSSupportClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials
to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this
client connects to AWSSupport
(ex: proxy settings, retry counts, etc.).Method Detail |
---|
public DescribeCasesResult describeCases(DescribeCasesRequest describeCasesRequest) throws AmazonServiceException, AmazonClientException
This action returns a list of cases that you specify by passing one or more CaseIds. In addition, you can filter the cases by date by setting values for the AfterTime and BeforeTime request parameters.
The response returns the following in JSON format:
describeCases
in interface AWSSupport
describeCasesRequest
- Container for the necessary parameters to
execute the DescribeCases service method on AWSSupport.
InternalServerErrorException
CaseIdNotFoundException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeTrustedAdvisorCheckRefreshStatusesResult describeTrustedAdvisorCheckRefreshStatuses(DescribeTrustedAdvisorCheckRefreshStatusesRequest describeTrustedAdvisorCheckRefreshStatusesRequest) throws AmazonServiceException, AmazonClientException
Returns the status of all refresh requests Trusted Advisor checks called using RefreshTrustedAdvisorCheck.
describeTrustedAdvisorCheckRefreshStatuses
in interface AWSSupport
describeTrustedAdvisorCheckRefreshStatusesRequest
- Container for
the necessary parameters to execute the
DescribeTrustedAdvisorCheckRefreshStatuses service method on
AWSSupport.
InternalServerErrorException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeSeverityLevelsResult describeSeverityLevels(DescribeSeverityLevelsRequest describeSeverityLevelsRequest) throws AmazonServiceException, AmazonClientException
This action returns the list of severity levels that you can assign to an AWS Support case. The severity level for a case is also a field in the CaseDetails data type included in any CreateCase request.
describeSeverityLevels
in interface AWSSupport
describeSeverityLevelsRequest
- Container for the necessary
parameters to execute the DescribeSeverityLevels service method on
AWSSupport.
InternalServerErrorException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeCommunicationsResult describeCommunications(DescribeCommunicationsRequest describeCommunicationsRequest) throws AmazonServiceException, AmazonClientException
This action returns communications regarding the support case. You can use the AfterTime and BeforeTime parameters to filter by date. The CaseId parameter enables you to identify a specific case by its CaseId number.
The MaxResults and NextToken parameters enable you to control the pagination of the result set. Set MaxResults to the number of cases you want displayed on each page, and use NextToken to specify the resumption of pagination.
describeCommunications
in interface AWSSupport
describeCommunicationsRequest
- Container for the necessary
parameters to execute the DescribeCommunications service method on
AWSSupport.
InternalServerErrorException
CaseIdNotFoundException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public AddCommunicationToCaseResult addCommunicationToCase(AddCommunicationToCaseRequest addCommunicationToCaseRequest) throws AmazonServiceException, AmazonClientException
This action adds additional customer communication to an AWS Support case. You use the CaseId value to identify the case to which you want to add communication. You can list a set of email addresses to copy on the communication using the CcEmailAddresses value. The CommunicationBody value contains the text of the communication.
This action's response indicates the success or failure of the request.
This action implements a subset of the behavior on the AWS Support Your Support Cases web form.
addCommunicationToCase
in interface AWSSupport
addCommunicationToCaseRequest
- Container for the necessary
parameters to execute the AddCommunicationToCase service method on
AWSSupport.
InternalServerErrorException
CaseIdNotFoundException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public CreateCaseResult createCase(CreateCaseRequest createCaseRequest) throws AmazonServiceException, AmazonClientException
Creates a new case in the AWS Support Center. This action is modeled on the behavior of the AWS Support Center Open a new case page. Its parameters require you to specify the following information:
NOTE:The AWS Support API does not currently support the ability to add attachments to cases. You can, however, call AddCommunicationToCase to add information to an open case.
A successful CreateCase request returns an AWS Support case number. Case numbers are used by DescribeCases request to retrieve existing AWS Support support cases.
createCase
in interface AWSSupport
createCaseRequest
- Container for the necessary parameters to
execute the CreateCase service method on AWSSupport.
InternalServerErrorException
CaseCreationLimitExceededException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeTrustedAdvisorChecksResult describeTrustedAdvisorChecks(DescribeTrustedAdvisorChecksRequest describeTrustedAdvisorChecksRequest) throws AmazonServiceException, AmazonClientException
This action enables you to get a list of the available Trusted Advisor checks. You must specify a language code. English ("en") and Japanese ("jp") are currently supported. The response contains a list of TrustedAdvisorCheckDescription objects.
describeTrustedAdvisorChecks
in interface AWSSupport
describeTrustedAdvisorChecksRequest
- Container for the necessary
parameters to execute the DescribeTrustedAdvisorChecks service method
on AWSSupport.
InternalServerErrorException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeTrustedAdvisorCheckResultResult describeTrustedAdvisorCheckResult(DescribeTrustedAdvisorCheckResultRequest describeTrustedAdvisorCheckResultRequest) throws AmazonServiceException, AmazonClientException
This action responds with the results of a Trusted Advisor check. Once you have obtained the list of available Trusted Advisor checks by calling DescribeTrustedAdvisorChecks, you specify the CheckId for the check you want to retrieve from AWS Support.
The response for this action contains a JSON-formatted TrustedAdvisorCheckResult object
, which is a container for the following three objects:
In addition, the response contains the following fields:
describeTrustedAdvisorCheckResult
in interface AWSSupport
describeTrustedAdvisorCheckResultRequest
- Container for the
necessary parameters to execute the DescribeTrustedAdvisorCheckResult
service method on AWSSupport.
InternalServerErrorException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public ResolveCaseResult resolveCase(ResolveCaseRequest resolveCaseRequest) throws AmazonServiceException, AmazonClientException
Takes a CaseId and returns the initial state of the case along with the state of the case after the call to ResolveCase completed.
resolveCase
in interface AWSSupport
resolveCaseRequest
- Container for the necessary parameters to
execute the ResolveCase service method on AWSSupport.
InternalServerErrorException
CaseIdNotFoundException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public RefreshTrustedAdvisorCheckResult refreshTrustedAdvisorCheck(RefreshTrustedAdvisorCheckRequest refreshTrustedAdvisorCheckRequest) throws AmazonServiceException, AmazonClientException
This action enables you to query the service to request a refresh for a specific Trusted Advisor check. Your request body contains a CheckId for which you are querying. The response body contains a RefreshTrustedAdvisorCheckResult object containing Status and TimeUntilNextRefresh fields.
refreshTrustedAdvisorCheck
in interface AWSSupport
refreshTrustedAdvisorCheckRequest
- Container for the necessary
parameters to execute the RefreshTrustedAdvisorCheck service method on
AWSSupport.
InternalServerErrorException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeServicesResult describeServices(DescribeServicesRequest describeServicesRequest) throws AmazonServiceException, AmazonClientException
Returns the current list of AWS services and a list of service categories that applies to each one. You then use service names and categories in your CreateCase requests. Each AWS service has its own set of categories.
The service codes and category codes correspond to the values that are
displayed in the Service and Category drop-down lists on
the AWS Support Center Open a new case
page. The values in those fields, however, do not necessarily match
the service codes and categories returned by the
DescribeServices
request. Always use the service codes
and categories obtained programmatically. This practice ensures that
you always have the most recent set of service and category codes.
describeServices
in interface AWSSupport
describeServicesRequest
- Container for the necessary parameters
to execute the DescribeServices service method on AWSSupport.
InternalServerErrorException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeTrustedAdvisorCheckSummariesResult describeTrustedAdvisorCheckSummaries(DescribeTrustedAdvisorCheckSummariesRequest describeTrustedAdvisorCheckSummariesRequest) throws AmazonServiceException, AmazonClientException
This action enables you to get the latest summaries for Trusted Advisor checks that you specify in your request. You submit the list of Trusted Advisor checks for which you want summaries. You obtain these CheckIds by submitting a DescribeTrustedAdvisorChecks request.
The response body contains an array of TrustedAdvisorCheckSummary objects.
describeTrustedAdvisorCheckSummaries
in interface AWSSupport
describeTrustedAdvisorCheckSummariesRequest
- Container for the
necessary parameters to execute the
DescribeTrustedAdvisorCheckSummaries service method on AWSSupport.
InternalServerErrorException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeCasesResult describeCases() throws AmazonServiceException, AmazonClientException
This action returns a list of cases that you specify by passing one or more CaseIds. In addition, you can filter the cases by date by setting values for the AfterTime and BeforeTime request parameters.
The response returns the following in JSON format:
describeCases
in interface AWSSupport
InternalServerErrorException
CaseIdNotFoundException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeSeverityLevelsResult describeSeverityLevels() throws AmazonServiceException, AmazonClientException
This action returns the list of severity levels that you can assign to an AWS Support case. The severity level for a case is also a field in the CaseDetails data type included in any CreateCase request.
describeSeverityLevels
in interface AWSSupport
InternalServerErrorException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public ResolveCaseResult resolveCase() throws AmazonServiceException, AmazonClientException
Takes a CaseId and returns the initial state of the case along with the state of the case after the call to ResolveCase completed.
resolveCase
in interface AWSSupport
InternalServerErrorException
CaseIdNotFoundException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public DescribeServicesResult describeServices() throws AmazonServiceException, AmazonClientException
Returns the current list of AWS services and a list of service categories that applies to each one. You then use service names and categories in your CreateCase requests. Each AWS service has its own set of categories.
The service codes and category codes correspond to the values that are
displayed in the Service and Category drop-down lists on
the AWS Support Center Open a new case
page. The values in those fields, however, do not necessarily match
the service codes and categories returned by the
DescribeServices
request. Always use the service codes
and categories obtained programmatically. This practice ensures that
you always have the most recent set of service and category codes.
describeServices
in interface AWSSupport
InternalServerErrorException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AWSSupport indicating
either a problem with the data in the request, or a server side issue.public void setEndpoint(String endpoint, String serviceName, String regionId) throws IllegalArgumentException
This method is not threadsafe. Endpoints should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit.
Callers can pass in just the endpoint (ex: "support.us-east-1.amazonaws.com") or a full
URL, including the protocol (ex: "support.us-east-1.amazonaws.com"). If the
protocol is not specified here, the default protocol from this client's
ClientConfiguration
will be used, which by default is HTTPS.
For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID=3912
endpoint
- The endpoint (ex: "support.us-east-1.amazonaws.com") or a full URL,
including the protocol (ex: "support.us-east-1.amazonaws.com") of
the region specific AWS endpoint this client will communicate
with.serviceName
- The name of the AWS service to use when signing requests.regionId
- The ID of the region in which this service resides.
IllegalArgumentException
- If any problems are detected with the specified endpoint.AmazonDynamoDB#setRegion(Region)
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
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 the request.
getCachedResponseMetadata
in interface AWSSupport
request
- The originally executed request
|
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |