SendMessageToGlobe - - Centre de documentation Alibaba Cloud

Envoie des messages vers les régions en dehors de la Chine continentale, y compris Hong Kong (Chine), Macao (Chine) et Taïwan (Chine).

Description de l'opération

Envoie des messages vers les régions en dehors de la Chine continentale, y compris Hong Kong (Chine), Macao (Chine) et Taïwan (Chine). Vous pouvez également envoyer des messages via la console SMS.
Cette opération ne prend pas en charge l'envoi de messages vers la Chine continentale.
Vous ne pouvez pas utiliser de forfaits de ressources si votre compte présente un impayé. Avant d'appeler cette opération, vérifiez le solde de votre compte et le quota restant de vos forfaits de ressources.
Sur le site international (alibabacloud.com), le service SMS est facturé en fonction de l'état de soumission des messages. Vous êtes facturé même si un accusé de réception de l'opérateur indique que le message n'a pas pu être livré. Pour plus d'informations sur les forfaits de ressources et la méthode de facturation à l'usage, consultez Facturation.

Limites de QPS

Cette opération prend en charge jusqu'à 2 000 appels par seconde et par compte. Le dépassement de cette limite entraîne l'abandon des requêtes, ce qui provoque des interruptions de service.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

dysms:SendMessageToGlobe

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
To	string	Oui	Les numéros de téléphone auxquels le message est envoyé. Format : Indicatif téléphonique + Numéro de téléphone. Par exemple, 8521245567**. Pour les indicatifs téléphoniques, consultez Indicatifs téléphoniques. Remarque** Vous ne pouvez pas appeler cette opération pour envoyer des messages vers la Chine continentale.	8521245567****
From	string	Non	Le numéro de téléphone de l'expéditeur. Vous pouvez également spécifier un identifiant d'expéditeur, qui peut contenir des lettres et des chiffres. Un identifiant alphanumérique peut comporter jusqu'à 11 caractères, tandis qu'un identifiant uniquement numérique peut comporter jusqu'à 15 chiffres.	Alicloud321
Message	string	Oui	Le contenu du message.	Bonjour
Type	string	Non	Le type de message. Valeurs valides : OTP : message de code de vérification. NOTIFY : notification. MKT : message marketing.	NOTIFY
TaskId	string	Non	L'identifiant de la tâche. L'identifiant peut comporter jusqu'à 255 caractères. Vous pouvez obtenir l'identifiant de la tâche à partir du champ TaskId dans l'accusé de réception du message.	123****789
ValidityPeriod	integer	Non	La période de validité du message, en secondes.	600
ChannelId	string	Non	L'identifiant du canal.	3790

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
ResponseCode	string	Le code d'état de la requête de livraison.	OK
NumberDetail	object	Les détails du numéro de téléphone.
Carrier	string	L'opérateur.	CMI
Region	string	La région à laquelle le numéro de téléphone appartient.	HongKong
Country	string	Le pays où le numéro est enregistré.	Chine
RequestId	string	L'identifiant de la requête.	F655A8D5-B967-440B-8683-DAD6FF8DE990
Segments	string	Le nombre de messages facturés.	1
ResponseDescription	string	La description de l'état de la requête de livraison.	La requête d'envoi de SMS a été acceptée
From	string	L'identifiant d'expéditeur que vous avez spécifié.	Alicloud321
To	string	Le numéro de téléphone auquel le message est envoyé.	1380000****
MessageId	string	L'identifiant du message.	1008030300****

Exemples

JSON format

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

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.