SendMessageToGlobe - Short Message Service - Alibaba Cloud Documentation Center

Sends an international message to a mobile phone number.

Operation Description

Usage notes

You cannot call the SendMessageToGlobe operation to send messages to the Chinese mainland.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Association operation
dysms:SendMessageToGlobe	Read	SMS acs:dysms::{#accountId}: SMS acs:dysms:{#regionId}:{#accountId}:*	none	none

Request parameters

Parameter	Type	Required	Description	Example
To	string	Yes	The mobile phone number of the recipient. You must add the dialing code to the beginning of each mobile phone number. Example: 8521245567****. For more information, see Dialing codes.	8521245567****
From	string	No	The mobile phone number of the sender. You can specify the sender ID when you call the API operation. The sender ID can contain digits and letters. If the sender ID contains letters and digits, it can be a maximum of 11 characters in length. If the sender ID contains only digits, it can be a maximum of 15 characters in length.	Alicloud321
Message	string	Yes	The content of the message.	Hello
TaskId	string	No	The ID of the messaging campaign. It must be 1 to 255 characters in length. The ID is the value of the TaskId field in the delivery receipt of the message.	123****789

Response parameters

Parameter	Type	Description	Example
	object
ResponseCode	string	The status code that indicates whether the message was sent.	OK
NumberDetail	object	The details about the recipient phone number.
Carrier	string	The carrier that provides the recipient phone number.	CMI
Region	string	The region to which the recipient phone number belongs.	HongKong
Country	string	The country to which the recipient phone number belongs.	Hongkong, China
RequestId	string	The ID of the request.	F655A8D5-B967-440B-8683-DAD6FF8DE990
Segments	string	The number of the messages that incurred fees.	1
ResponseDescription	string	The description of the status code that indicates whether the message was sent.	The SMS Send Request was accepted
From	string	The sender ID that was returned. The API operation returns the sender ID that you have specified in the request parameters.	Alicloud321
To	string	The mobile phone number of the recipient.	1380000****
MessageId	string	The ID of the message.	1008030300****

Examples

Sample success responses

JSONformat

{
  "ResponseCode": "OK",
  "NumberDetail": {
    "Carrier": "CMI",
    "Region": "HongKong",
    "Country": "Hongkong, China"
  },
  "RequestId": "F655A8D5-B967-440B-8683-DAD6FF8DE990",
  "Segments": "1",
  "ResponseDescription": "The SMS Send Request was accepted",
  "From": "Alicloud321",
  "To": "1380000****",
  "MessageId": "1008030300****"
}

Error codes

For a list of error codes, visit the Service error codes.