AddAttachmentsToSet
Adds one or more attachments to an attachment set.
An attachment set is a temporary container for attachments that you add to a case or
case communication. The set is available for 1 hour after it's created. The
expiryTime returned in the response is when the set expires.
Note
-
You must have a Business, Enterprise On-Ramp, or Enterprise Support plan to use the AWS Support API.
-
If you call the AWS Support API from an account that doesn't have a Business, Enterprise On-Ramp, or Enterprise Support plan, the
SubscriptionRequiredExceptionerror message appears. For information about changing your support plan, see AWS Support.
Request Syntax
{
"attachments": [
{
"data": blob,
"fileName": "string"
}
],
"attachmentSetId": "string"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- attachments
-
One or more attachments to add to the set. You can add up to three attachments per set. The size limit is 5 MB per attachment.
In the
Attachmentobject, use thedataparameter to specify the contents of the attachment file. In the previous request syntax, the value fordataappear asblob, which is represented as a base64-encoded string. The value forfileNameis the name of the attachment, such astroubleshoot-screenshot.png.Type: Array of Attachment objects
- attachmentSetId
-
The ID of the attachment set. If an
attachmentSetIdis not specified, a new attachment set is created, and the ID of the set is returned in the response. If anattachmentSetIdis specified, the attachments are added to the specified set, if it exists.Type: String
Response Syntax
{
"attachmentSetId": "string",
"expiryTime": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- attachmentSetId
-
The ID of the attachment set. If an
attachmentSetIdwas not specified, a new attachment set is created, and the ID of the set is returned in the response. If anattachmentSetIdwas specified, the attachments are added to the specified set, if it exists.Type: String
- expiryTime
-
The time and date when the attachment set expires.
Type: String
Errors
For information about the errors that are common to all actions, see Common Errors.
- AttachmentLimitExceeded
-
The limit for the number of attachment sets created in a short period of time has been exceeded.
- message
-
The limit for the number of attachment sets created in a short period of time has been exceeded.
HTTP Status Code: 400
- AttachmentSetExpired
-
The expiration time of the attachment set has passed. The set expires 1 hour after it is created.
- message
-
The expiration time of the attachment set has passed. The set expires one hour after it is created.
HTTP Status Code: 400
- AttachmentSetIdNotFound
-
An attachment set with the specified ID could not be found.
- message
-
An attachment set with the specified ID could not be found.
HTTP Status Code: 400
- AttachmentSetSizeLimitExceeded
-
A limit for the size of an attachment set has been exceeded. The limits are three attachments and 5 MB per attachment.
- message
-
A limit for the size of an attachment set has been exceeded. The limits are three attachments and 5 MB per attachment.
HTTP Status Code: 400
- InternalServerError
-
An internal server error occurred.
- message
-
An internal server error occurred.
HTTP Status Code: 500
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: