Publie un message dans une rubrique spécifiée. Une fois le message publié, Message Service (MNS) le transmet aux endpoints spécifiés.
En-têtes de requête
Cette opération utilise uniquement les en-têtes de requête communs et ne possède pas d'en-têtes spécifiques. Pour plus d'informations, consultez Paramètres communs.
Syntaxe de la requête
POST /topics/$TopicName/messages HTTP/1.1
Avant d'appeler cette API pour envoyer un message, encodez le corps du message en Base64. Cette précaution évite les erreurs inattendues liées aux caractères spéciaux.
Paramètres de requête
|
Paramètre |
Type |
Obligatoire |
Description |
|
MessageBody |
String |
Oui |
Le contenu du message. |
|
MessageTag |
String |
Non |
Le tag du message. |
|
MessageAttributes |
Object |
Non |
Les attributs du message. Si vous envoyez le message vers des serveurs HTTP ou des files d'attente, il n'est pas nécessaire de définir ce paramètre. |
Paramètres de réponse
|
Paramètre |
Type |
Exemple |
Description |
|
MessageId |
String |
D273CD6A89564E54-1-15180395A19-20000**** |
L'ID du message. L'ID du message est unique au sein de la rubrique. |
|
MessageBodyMD5 |
String |
3AC6DD36D2D6B7283F2F490A0975**** |
Le hachage MD5 du corps du message. |
Exemples
Exemple de requête
POST /topics/MyTopic/messages HTTP/1.1
Host: 123456789098****.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 06:13:40 GMT
Content-Length:500
Content-Type:text/xml;charset=utf-8
Authorization: MNS 15B4D3461F177624****:aibzWu1iDEx9LwO56+kHgA3e****
x-mns-version: 2015-06-06
<?xml version="1.0" encoding="UTF-8"?>
<Message xmlns="http://mns.aliyuncs.com/doc/v1">
<MessageBody>hello topic</MessageBody>
</Message>Exemple de réponse
HTTP/1.1 201 Created
Content-Length:120
Content-Type:text/xml;charset=utf-8
x-mns-request-id:56667514B2B71C9C1600****
x-mns-version:2015-06-06
<?xml version="1.0" encoding="utf-8"?>
<Message xmlns="http://mns.aliyuncs.com/doc/v1/">
<MessageId>D273CD6A89564E54-1-15180395A19-20000****</MessageId>
<MessageBodyMD5>3AC6DD36D2D6B7283F2F490A0975****</MessageBodyMD5>
</Message> Codes d'erreur
|
Code d'erreur |
Message d'erreur |
Code d'état HTTP |
|
TopicNotExist |
The topic you provided does not exist. |
404 |