Menu
AWS Support
API Reference (API Version 2013-04-15)

CreateCase

Creates a new case in the AWS Support Center. This operation is modeled on the behavior of the AWS Support Center Create Case page. Its parameters require you to specify the following information:

  • issueType. The type of issue for the case. You can specify either "customer-service" or "technical." If you do not indicate a value, the default is "technical."

    Note

    Service limit increases are not supported by the Support API; you must submit service limit increase requests in Support Center.

  • serviceCode. The code for an AWS service. You can get the possible serviceCode values by calling DescribeServices.

  • categoryCode. The category for the service defined for the serviceCode value. You also get the category code for a service by calling DescribeServices. Each AWS service defines its own set of category codes.

  • severityCode. A value that indicates the urgency of the case, which in turn determines the response time according to your service level agreement with AWS Support. You can get the possible severityCode values by calling DescribeSeverityLevels. For more information about the meaning of the codes, see SeverityLevel and Choosing a Severity.

  • subject. The Subject field on the AWS Support Center Create Case page.

  • communicationBody. The Description field on the AWS Support Center Create Case page.

  • attachmentSetId. The ID of a set of attachments that has been created by using AddAttachmentsToSet.

  • language. The human language in which AWS Support handles the case. English and Japanese are currently supported.

  • ccEmailAddresses. The AWS Support Center CC field on the Create Case page. You can list email addresses to be copied on any correspondence about the case. The account that opens the case is already identified by passing the AWS Credentials in the HTTP POST method or in a method or function call from one of the programming languages supported by an AWS SDK.

Note

To add additional communication or attachments to an existing case, use AddCommunicationToCase.

A successful CreateCase request returns an AWS Support case number. Case numbers are used by the DescribeCases operation to retrieve existing AWS Support cases.

Request Syntax

{
   "attachmentSetId": "string",
   "categoryCode": "string",
   "ccEmailAddresses": [ "string" ],
   "communicationBody": "string",
   "issueType": "string",
   "language": "string",
   "serviceCode": "string",
   "severityCode": "string",
   "subject": "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.

attachmentSetId

The ID of a set of one or more attachments for the case. Create the set by using AddAttachmentsToSet.

Type: String

categoryCode

The category of problem for the AWS Support case.

Type: String

ccEmailAddresses

A list of email addresses that AWS Support copies on case correspondence.

Type: Array of strings

Array Members: Minimum number of 0 items. Maximum number of 10 items.

communicationBody

The communication body text when you create an AWS Support case by calling CreateCase.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 8000.

issueType

The type of issue for the case. You can specify either "customer-service" or "technical." If you do not indicate a value, the default is "technical."

Note

Service limit increases are not supported by the Support API; you must submit service limit increase requests in Support Center.

Type: String

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.

Type: String

serviceCode

The code for the AWS service returned by the call to DescribeServices.

Type: String

severityCode

The code for the severity level returned by the call to DescribeSeverityLevels.

Note

The availability of severity levels depends on the support plan for the account.

Type: String

subject

The title of the AWS Support case.

Type: String

Response Syntax

{
   "caseId": "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.

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

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

AttachmentSetExpired

The expiration time of the attachment set has passed. The set expires 1 hour after it is created.

HTTP Status Code: 400

AttachmentSetIdNotFound

An attachment set with the specified ID could not be found.

HTTP Status Code: 400

CaseCreationLimitExceeded

The case creation limit for the account has been exceeded.

HTTP Status Code: 400

InternalServerError

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: