@datafire/amazonaws_support
v5.0.0
Published
DataFire integration for AWS Support
Downloads
15
Readme
@datafire/amazonaws_support
Client library for AWS Support
Installation and Usage
npm install --save @datafire/amazonaws_support
let amazonaws_support = require('@datafire/amazonaws_support').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
amazonaws_support.AddAttachmentsToSet({
"attachments": []
}).then(data => {
console.log(data);
});
Description
AWS Support The AWS Support API reference is intended for programmers who need detailed information about the AWS Support operations and data types. This service enables you to manage your AWS Support cases programmatically. It uses HTTP methods that return results in JSON format. The AWS Support service also exposes a set of Trusted Advisor features. You can retrieve a list of checks and their descriptions, get check results, specify checks to refresh, and get the refresh status of checks. The following list describes the AWS Support case management operations: Service names, issue categories, and available severity levels. The DescribeServices and DescribeSeverityLevels operations return AWS service names, service codes, service categories, and problem severity levels. You use these values when you call the CreateCase operation. Case creation, case details, and case resolution. The CreateCase, DescribeCases, DescribeAttachment, and ResolveCase operations create AWS Support cases, retrieve information about cases, and resolve cases. Case communication. The DescribeCommunications, AddCommunicationToCase, and AddAttachmentsToSet operations retrieve and add communications and attachments to AWS Support cases. The following list describes the operations available from the AWS Support service for Trusted Advisor: DescribeTrustedAdvisorChecks returns the list of checks that run against your AWS resources. Using the checkId for a specific check returned by DescribeTrustedAdvisorChecks, you can call DescribeTrustedAdvisorCheckResult to obtain the results for the check you specified. DescribeTrustedAdvisorCheckSummaries returns summarized results for one or more Trusted Advisor checks. RefreshTrustedAdvisorCheck requests that Trusted Advisor rerun a specified check. DescribeTrustedAdvisorCheckRefreshStatuses reports the refresh status of one or more checks. For authentication of requests, AWS Support uses Signature Version 4 Signing Process. See About the AWS Support API in the AWS Support User Guide for information about how to use this service to create and manage your support cases, and how to call Trusted Advisor for results of checks on your resources.
Actions
AddAttachmentsToSet
amazonaws_support.AddAttachmentsToSet({
"attachments": []
}, context)
Input
- input
object
- attachmentSetId AttachmentSetId
- attachments required Attachments
Output
- output AddAttachmentsToSetResponse
AddCommunicationToCase
amazonaws_support.AddCommunicationToCase({
"communicationBody": ""
}, context)
Input
- input
object
- attachmentSetId AttachmentSetId
- caseId CaseId
- ccEmailAddresses CcEmailAddressList
- communicationBody required CommunicationBody
Output
CreateCase
amazonaws_support.CreateCase({
"subject": "",
"communicationBody": ""
}, context)
Input
- input
object
- attachmentSetId AttachmentSetId
- categoryCode CategoryCode
- ccEmailAddresses CcEmailAddressList
- communicationBody required CommunicationBody
- issueType IssueType
- language Language
- serviceCode ServiceCode
- severityCode SeverityCode
- subject required Subject
Output
- output CreateCaseResponse
DescribeAttachment
amazonaws_support.DescribeAttachment({
"attachmentId": ""
}, context)
Input
- input
object
- attachmentId required AttachmentId
Output
- output DescribeAttachmentResponse
DescribeCases
amazonaws_support.DescribeCases({}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- afterTime AfterTime
- beforeTime BeforeTime
- caseIdList CaseIdList
- displayId DisplayId
- includeCommunications IncludeCommunications
- includeResolvedCases IncludeResolvedCases
- language Language
- maxResults MaxResults
- nextToken NextToken
- maxResults
Output
- output DescribeCasesResponse
DescribeCommunications
amazonaws_support.DescribeCommunications({
"caseId": ""
}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- afterTime AfterTime
- beforeTime BeforeTime
- caseId required CaseId
- maxResults MaxResults
- nextToken NextToken
- maxResults
Output
DescribeServices
amazonaws_support.DescribeServices({}, context)
Input
- input
object
- language Language
- serviceCodeList ServiceCodeList
Output
- output DescribeServicesResponse
DescribeSeverityLevels
amazonaws_support.DescribeSeverityLevels({}, context)
Input
- input
object
- language Language
Output
DescribeTrustedAdvisorCheckRefreshStatuses
amazonaws_support.DescribeTrustedAdvisorCheckRefreshStatuses({
"checkIds": []
}, context)
Input
- input
object
- checkIds required StringList
Output
DescribeTrustedAdvisorCheckResult
amazonaws_support.DescribeTrustedAdvisorCheckResult({
"checkId": ""
}, context)
Input
Output
DescribeTrustedAdvisorCheckSummaries
amazonaws_support.DescribeTrustedAdvisorCheckSummaries({
"checkIds": []
}, context)
Input
- input
object
- checkIds required StringList
Output
DescribeTrustedAdvisorChecks
amazonaws_support.DescribeTrustedAdvisorChecks({
"language": ""
}, context)
Input
- input
object
- language required String
Output
RefreshTrustedAdvisorCheck
amazonaws_support.RefreshTrustedAdvisorCheck({
"checkId": ""
}, context)
Input
- input
object
- checkId required String
Output
ResolveCase
amazonaws_support.ResolveCase({}, context)
Input
- input
object
- caseId CaseId
Output
- output ResolveCaseResponse
Definitions
AddAttachmentsToSetRequest
- AddAttachmentsToSetRequest
object
:- attachmentSetId AttachmentSetId
- attachments required Attachments
AddAttachmentsToSetResponse
- AddAttachmentsToSetResponse
object
: The ID and expiry time of the attachment set returned by the AddAttachmentsToSet operation.- attachmentSetId AttachmentSetId
- expiryTime ExpiryTime
AddCommunicationToCaseRequest
- AddCommunicationToCaseRequest
object
: To be written.- attachmentSetId AttachmentSetId
- caseId CaseId
- ccEmailAddresses CcEmailAddressList
- communicationBody required CommunicationBody
AddCommunicationToCaseResponse
- AddCommunicationToCaseResponse
object
: The result of the AddCommunicationToCase operation.- result Result
AfterTime
- AfterTime
string
Attachment
- Attachment
object
: An attachment to a case communication. The attachment consists of the file name and the content of the file.
AttachmentDetails
- AttachmentDetails
object
: The file name and ID of an attachment to a case communication. You can use the ID to retrieve the attachment with the DescribeAttachment operation.- attachmentId AttachmentId
- fileName FileName
AttachmentId
- AttachmentId
string
AttachmentIdNotFound
- AttachmentIdNotFound
object
: An attachment with the specified ID could not be found.- message ErrorMessage
AttachmentLimitExceeded
- AttachmentLimitExceeded
object
: The limit for the number of attachment sets created in a short period of time has been exceeded.- message ErrorMessage
AttachmentSet
- AttachmentSet
array
- items AttachmentDetails
AttachmentSetExpired
- AttachmentSetExpired
object
: The expiration time of the attachment set has passed. The set expires 1 hour after it is created.- message ErrorMessage
AttachmentSetId
- AttachmentSetId
string
AttachmentSetIdNotFound
- AttachmentSetIdNotFound
object
: An attachment set with the specified ID could not be found.- message ErrorMessage
AttachmentSetSizeLimitExceeded
- AttachmentSetSizeLimitExceeded
object
: A limit for the size of an attachment set has been exceeded. The limits are 3 attachments and 5 MB per attachment.- message ErrorMessage
Attachments
- Attachments
array
- items Attachment
BeforeTime
- BeforeTime
string
Boolean
- Boolean
boolean
CaseCreationLimitExceeded
- CaseCreationLimitExceeded
object
: The case creation limit for the account has been exceeded.- message ErrorMessage
CaseDetails
- CaseDetails
object
: A JSON-formatted object that contains the metadata for a support case. It is contained the response from a DescribeCases request. CaseDetails contains the following fields: caseId. The AWS Support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47. categoryCode. The category of problem for the AWS Support case. Corresponds to the CategoryCode values returned by a call to DescribeServices. displayId. The identifier for the case on pages in the AWS Support Center. language. The ISO 639-1 code for the language in which AWS provides support. AWS Support currently supports English ("en") and Japanese ("ja"). Language parameters must be passed explicitly for operations that take them. recentCommunications. One or more Communication objects. Fields of these objects are attachments, body, caseId, submittedBy, and timeCreated. nextToken. A resumption point for pagination. serviceCode. The identifier for the AWS service that corresponds to the service code defined in the call to DescribeServices. severityCode. The severity code assigned to the case. Contains one of the values returned by the call to DescribeSeverityLevels. status. The status of the case in the AWS Support Center. subject. The subject line of the case. submittedBy. The email address of the account that submitted the case. timeCreated. The time the case was created, in ISO-8601 format.- caseId CaseId
- categoryCode CategoryCode
- ccEmailAddresses CcEmailAddressList
- displayId DisplayId
- language Language
- recentCommunications RecentCaseCommunications
- serviceCode ServiceCode
- severityCode SeverityCode
- status Status
- subject Subject
- submittedBy SubmittedBy
- timeCreated TimeCreated
CaseId
- CaseId
string
CaseIdList
- CaseIdList
array
- items CaseId
CaseIdNotFound
- CaseIdNotFound
object
: The requested caseId could not be located.- message ErrorMessage
CaseList
- CaseList
array
- items CaseDetails
CaseStatus
- CaseStatus
string
Category
- Category
object
: A JSON-formatted name/value pair that represents the category name and category code of the problem, selected from the DescribeServices response for each AWS service.- code CategoryCode
- name CategoryName
CategoryCode
- CategoryCode
string
CategoryList
- CategoryList
array
- items Category
CategoryName
- CategoryName
string
CcEmailAddress
- CcEmailAddress
string
CcEmailAddressList
- CcEmailAddressList
array
- items CcEmailAddress
Communication
- Communication
object
: A communication associated with an AWS Support case. The communication consists of the case ID, the message body, attachment information, the account email address, and the date and time of the communication.- attachmentSet AttachmentSet
- body CommunicationBody
- caseId CaseId
- submittedBy SubmittedBy
- timeCreated TimeCreated
CommunicationBody
- CommunicationBody
string
CommunicationList
- CommunicationList
array
- items Communication
CreateCaseRequest
- CreateCaseRequest
object
:- attachmentSetId AttachmentSetId
- categoryCode CategoryCode
- ccEmailAddresses CcEmailAddressList
- communicationBody required CommunicationBody
- issueType IssueType
- language Language
- serviceCode ServiceCode
- severityCode SeverityCode
- subject required Subject
CreateCaseResponse
- CreateCaseResponse
object
: The AWS Support case ID returned by a successful completion of the CreateCase operation.- caseId CaseId
Data
- Data
string
DescribeAttachmentLimitExceeded
- DescribeAttachmentLimitExceeded
object
: The limit for the number of DescribeAttachment requests in a short period of time has been exceeded.- message ErrorMessage
DescribeAttachmentRequest
- DescribeAttachmentRequest
object
- attachmentId required AttachmentId
DescribeAttachmentResponse
- DescribeAttachmentResponse
object
: The content and file name of the attachment returned by the DescribeAttachment operation.- attachment Attachment
DescribeCasesRequest
- DescribeCasesRequest
object
:- afterTime AfterTime
- beforeTime BeforeTime
- caseIdList CaseIdList
- displayId DisplayId
- includeCommunications IncludeCommunications
- includeResolvedCases IncludeResolvedCases
- language Language
- maxResults MaxResults
- nextToken NextToken
DescribeCasesResponse
- DescribeCasesResponse
object
: Returns an array of CaseDetails objects and a nextToken that defines a point for pagination in the result set.
DescribeCommunicationsRequest
- DescribeCommunicationsRequest
object
:- afterTime AfterTime
- beforeTime BeforeTime
- caseId required CaseId
- maxResults MaxResults
- nextToken NextToken
DescribeCommunicationsResponse
- DescribeCommunicationsResponse
object
: The communications returned by the DescribeCommunications operation.- communications CommunicationList
- nextToken NextToken
DescribeServicesRequest
- DescribeServicesRequest
object
:- language Language
- serviceCodeList ServiceCodeList
DescribeServicesResponse
- DescribeServicesResponse
object
: The list of AWS services returned by the DescribeServices operation.- services ServiceList
DescribeSeverityLevelsRequest
- DescribeSeverityLevelsRequest
object
:- language Language
DescribeSeverityLevelsResponse
- DescribeSeverityLevelsResponse
object
: The list of severity levels returned by the DescribeSeverityLevels operation.- severityLevels SeverityLevelsList
DescribeTrustedAdvisorCheckRefreshStatusesRequest
- DescribeTrustedAdvisorCheckRefreshStatusesRequest
object
:- checkIds required StringList
DescribeTrustedAdvisorCheckRefreshStatusesResponse
- DescribeTrustedAdvisorCheckRefreshStatusesResponse
object
: The statuses of the Trusted Advisor checks returned by the DescribeTrustedAdvisorCheckRefreshStatuses operation.- statuses required TrustedAdvisorCheckRefreshStatusList
DescribeTrustedAdvisorCheckResultRequest
DescribeTrustedAdvisorCheckResultResponse
- DescribeTrustedAdvisorCheckResultResponse
object
: The result of the Trusted Advisor check returned by the DescribeTrustedAdvisorCheckResult operation.- result TrustedAdvisorCheckResult
DescribeTrustedAdvisorCheckSummariesRequest
- DescribeTrustedAdvisorCheckSummariesRequest
object
:- checkIds required StringList
DescribeTrustedAdvisorCheckSummariesResponse
- DescribeTrustedAdvisorCheckSummariesResponse
object
: The summaries of the Trusted Advisor checks returned by the DescribeTrustedAdvisorCheckSummaries operation.- summaries required TrustedAdvisorCheckSummaryList
DescribeTrustedAdvisorChecksRequest
- DescribeTrustedAdvisorChecksRequest
object
:- language required String
DescribeTrustedAdvisorChecksResponse
- DescribeTrustedAdvisorChecksResponse
object
: Information about the Trusted Advisor checks returned by the DescribeTrustedAdvisorChecks operation.- checks required TrustedAdvisorCheckList
DisplayId
- DisplayId
string
Double
- Double
number
ErrorMessage
- ErrorMessage
string
ExpiryTime
- ExpiryTime
string
FileName
- FileName
string
IncludeCommunications
- IncludeCommunications
boolean
IncludeResolvedCases
- IncludeResolvedCases
boolean
InternalServerError
- InternalServerError
object
: An internal server error occurred.- message ErrorMessage
IssueType
- IssueType
string
Language
- Language
string
Long
- Long
integer
MaxResults
- MaxResults
integer
NextToken
- NextToken
string
RecentCaseCommunications
- RecentCaseCommunications
object
: The five most recent communications associated with the case.- communications CommunicationList
- nextToken NextToken
RefreshTrustedAdvisorCheckRequest
- RefreshTrustedAdvisorCheckRequest
object
:- checkId required String
RefreshTrustedAdvisorCheckResponse
- RefreshTrustedAdvisorCheckResponse
object
: The current refresh status of a Trusted Advisor check.- status required TrustedAdvisorCheckRefreshStatus
ResolveCaseRequest
- ResolveCaseRequest
object
:- caseId CaseId
ResolveCaseResponse
- ResolveCaseResponse
object
: The status of the case returned by the ResolveCase operation.- finalCaseStatus CaseStatus
- initialCaseStatus CaseStatus
Result
- Result
boolean
Service
- Service
object
: Information about an AWS service returned by the DescribeServices operation.- categories CategoryList
- code ServiceCode
- name ServiceName
ServiceCode
- ServiceCode
string
ServiceCodeList
- ServiceCodeList
array
- items ServiceCode
ServiceList
- ServiceList
array
- items Service
ServiceName
- ServiceName
string
SeverityCode
- SeverityCode
string
SeverityLevel
- SeverityLevel
object
: A code and name pair that represent a severity level that can be applied to a support case.- code SeverityLevelCode
- name SeverityLevelName
SeverityLevelCode
- SeverityLevelCode
string
SeverityLevelName
- SeverityLevelName
string
SeverityLevelsList
- SeverityLevelsList
array
- items SeverityLevel
Status
- Status
string
String
- String
string
StringList
- StringList
array
- items String
Subject
- Subject
string
SubmittedBy
- SubmittedBy
string
TimeCreated
- TimeCreated
string
TrustedAdvisorCategorySpecificSummary
- TrustedAdvisorCategorySpecificSummary
object
: The container for summary information that relates to the category of the Trusted Advisor check.- costOptimizing TrustedAdvisorCostOptimizingSummary
TrustedAdvisorCheckDescription
- TrustedAdvisorCheckDescription
object
: The description and metadata for a Trusted Advisor check.- category required String
- description required String
- id required String
- metadata required StringList
- name required String
TrustedAdvisorCheckList
- TrustedAdvisorCheckList
array
TrustedAdvisorCheckRefreshStatus
- TrustedAdvisorCheckRefreshStatus
object
: The refresh status of a Trusted Advisor check.
TrustedAdvisorCheckRefreshStatusList
- TrustedAdvisorCheckRefreshStatusList
array
TrustedAdvisorCheckResult
- TrustedAdvisorCheckResult
object
: The results of a Trusted Advisor check returned by DescribeTrustedAdvisorCheckResult.- categorySpecificSummary required TrustedAdvisorCategorySpecificSummary
- checkId required String
- flaggedResources required TrustedAdvisorResourceDetailList
- resourcesSummary required TrustedAdvisorResourcesSummary
- status required String
- timestamp required String
TrustedAdvisorCheckSummary
- TrustedAdvisorCheckSummary
object
: A summary of a Trusted Advisor check result, including the alert status, last refresh, and number of resources examined.- categorySpecificSummary required TrustedAdvisorCategorySpecificSummary
- checkId required String
- hasFlaggedResources Boolean
- resourcesSummary required TrustedAdvisorResourcesSummary
- status required String
- timestamp required String
TrustedAdvisorCheckSummaryList
- TrustedAdvisorCheckSummaryList
array
TrustedAdvisorCostOptimizingSummary
- TrustedAdvisorCostOptimizingSummary
object
: The estimated cost savings that might be realized if the recommended actions are taken.
TrustedAdvisorResourceDetail
- TrustedAdvisorResourceDetail
object
: Contains information about a resource identified by a Trusted Advisor check.- isSuppressed Boolean
- metadata required StringList
- region String
- resourceId required String
- status required String
TrustedAdvisorResourceDetailList
- TrustedAdvisorResourceDetailList
array