Publie un message sur une rubrique. Une fois le message publié, Simple Message Queue (anciennement MNS) le pousse vers les endpoints spécifiés.
Syntaxe de la requête
POST /topics/$TopicName/messages HTTP/1.1Remplacez $TopicName par le nom de la rubrique cible.
En-têtes de requête
Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la section Paramètres communs.
Corps de la requête
Le corps de la requête est un message XML contenant les éléments suivants.
| Parameter | Type | Required | Description |
|---|---|---|---|
| MessageBody | String | Yes | The message content. |
| MessageTag | String | No | The message tag. |
| MessageAttributes | Object | Yes | The push endpoint type. Valid values: HTTP (HTTP gateway) and Queue (push to an SMQ queue). |
L'espace de noms XML doit être http://mns.aliyuncs.com/doc/v1/. Les requêtes omettant cet espace de noms ou utilisant un espace de noms incorrect renvoient une erreur.
Paramètres de réponse
| Parameter | Type | Example | Description |
|---|---|---|---|
| MessageId | String | D273CD6A89564E54-1-15180395A19-20000\\\\ | A unique identifier for the message within the topic. |
| MessageBodyMD5 | String | 3AC6DD36D2D6B7283F2F490A0975\\\\ | The MD5 hash of the message body. Compare this value against a locally computed hash to verify message integrity. |
Exemple de réponse positive
Exemple de réponse positive
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
Pour les erreurs communes à toutes les opérations, consultez la section Paramètres communs.
Le tableau suivant répertorie les codes d'erreur spécifiques à l'opération PublishMessage.
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 404 | TopicNotExist | The topic you provided does not exist. | The topic name in the request URI does not match any existing topic. Verify the topic name. |