Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

PutTaxExemption

Adds the tax exemption for a single account or all accounts listed in a consolidated billing family. The IAM action is tax:UpdateExemptions.

Request Syntax


POST /PutTaxExemption HTTP/1.1
Content-type: application/json

{
   "accountIds": [ "string" ],
   "authority": { 
      "country": "string",
      "state": "string"
   },
   "exemptionCertificate": { 
      "documentFile": blob,
      "documentName": "string"
   },
   "exemptionType": "string"
}

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

accountIds

The list of unique account identifiers.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 5 items.

Length Constraints: Fixed length of 12.

Pattern: ^\d+$

Required: Yes

authority

The address domain associate with the tax information.

Type: Authority object

Required: Yes

exemptionCertificate

The exemption certificate.

Type: ExemptionCertificate object

Required: Yes

exemptionType

The exemption type.

Type: String

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

Pattern: ^[\s\S]*$

Required: Yes

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "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 customer support case ID.

Type: String

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

Pattern: ^[\s\S]*$

Errors

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

AccessDeniedException

The access is denied for the AWS Support API.

HTTP Status Code: 401

AttachmentUploadException

Failed to upload the tax exemption document to AWS Support case.

HTTP Status Code: 400

CaseCreationLimitExceededException

You've exceeded the AWS Support case creation limit for your account.

HTTP Status Code: 413

InternalServerException

The exception thrown when an unexpected error occurs when processing a request.

HTTP Status Code: 500

ResourceNotFoundException

The exception thrown when the input doesn't have a resource associated to it.

HTTP Status Code: 404

ValidationException

The exception when the input doesn't pass validation for at least one of the input parameters.

HTTP Status Code: 400