Creates a recipient list.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
ReceiversName | String | Yes | test | The name of the recipient list. Cannot be repeated and can be 1 to 30 characters in length. |
ReceiversAlias | String | Yes | a***@example.net | The alias of the recipient list. An email address can be up to 30 characters in length. |
Action | String | No | CreateReceiver | The operation that you want to perform. Set the value to CreateReceiver. |
Desc | String | No | Description | The description of the recipient list. |
Response parameters
Parameter | Type | Example | Description |
ReceiverId | String | xxxx | The ID of the recipient list. |
RequestId | String | 10A1AD70-E48E-476D-98D9-39BD92193837 | The ID of the request. |
Examples
Sample requests
http(s)://dm.aliyuncs.com/? Action=CreateReceiver
&ReceiversAlias=vme
&ReceiversName=xme
&<Common request parameters>Sample success responses
XML format
<CreateReceiverResponse>
<RequestId>10A1AD70-E48E-476D-98D9-39BD92193837</RequestId>
<ReceiverId>xxxx</ReceiverId>
</CreateReceiverResponse>JSON format
{
"RequestId":"10A1AD70-E48E-476D-98D9-39BD92193837",
"ReceiverId":"xxxx"
}Error codes
HTTP status code | Error code | Error message | Description |
400 | InvalidReceiverName.Malformed | The specified receiver name is wrongly formed. | The error message returned because the format of the recipient's email address is invalid. An email address must contain an account name, an at sign, and a domain name. The account name and domain name must contain digits, letters, underscores (_), hyphens (-), and periods (.). |
400 | InvalidReceiverStatus.Malformed | The specified receivers status is wrongly formed. | The error message returned because the status of the recipient is invalid. Check whether the recipient has been uploaded to the console. |
For a list of error codes, visit the API Error Center.