Tous les produits
Search

Ce produit

    :Subscribe

    Centre de documentation

    :Subscribe

    Dernière mise à jour :Aug 07, 2026

    Appelle l'opération Subscribe pour créer un abonnement à une rubrique.

    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.

    mns:Subscribe

    update

    *Subscription

    acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}
    • mns:PushType
    		 Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    TopicName

    string

    Oui

    Le nom de la rubrique.

    topic****1
    SubscriptionName

    string

    Oui

    Le nom de l'abonnement.

    testSubscription
    PushType

    string

    Oui

    Type de push de l'abonnement

    Valeurs valides :

    • http : push HTTP/HTTPS. Distribue les messages vers une URL de rappel HTTP ou HTTPS spécifiée.

    • queue : push vers file d'attente. Distribue les messages vers une file d'attente SMQ spécifiée.

    • dm : push par e-mail. Envoie des notifications via DirectMail. Vous devez également définir les paramètres DmAttributes et StsRoleArn.

    • dysms : push par SMS. Envoie des notifications via Alibaba Cloud Short Message Service. Vous devez également définir le paramètre DysmsAttributes.

    • fc : push vers Function Compute. Distribue les messages vers Alibaba Cloud Function Compute (FC).

    • eventbus : push vers EventBridge. Distribue les messages vers un bus d'événements EventBridge.

    Remarque : Les valeurs suivantes sont obsolètes et ne sont utilisées que pour la compatibilité avec les anciens abonnements :

    • mpush : push mobile.

    • alisms : SMS ancien.

    • email : e-mail ancien. Utilisez dm à la place.

    • kafka : le type de push Kafka est obsolète.

    queue
    Endpoint

    string

    Oui

    Adresse de point de terminaison pour la réception des messages

    Le format varie en fonction de la valeur de PushType :

    • PushType=http : une URL de rappel HTTP/HTTPS, telle que http://example.com/callback ou https://example.com/callback.

    • PushType=queue : l'ARN de la file d'attente de destination, au format acs:mns:{RegionId}:{Alibaba Cloud account ID}:queues/{QueueName}.

    • PushType=dm : le point de terminaison de push par e-mail, au format fixe smq-ep:dm:{Alibaba Cloud account ID}:__dynamic. Remplacez {Alibaba Cloud account ID} par votre identifiant de compte Alibaba Cloud.

    • PushType=dysms : le point de terminaison de push par SMS, au format smq-ep:dysms:{Alibaba Cloud account ID}:{PhoneNumber}.

    • PushType=kafka : le point de terminaison de push Kafka. Le type de push Kafka est obsolète.

    • PushType=fc : le point de terminaison Function Compute, au format acs:fc:{RegionId}:{Alibaba Cloud account ID}:services/{ServiceName}/functions/{FunctionName}.

    • PushType=eventbus : le point de terminaison EventBridge, au format acs:eventbridge:{RegionId}:{Alibaba Cloud account ID}:eventbus/{EventBusName}.

    http://*****.com/uri1/xxx
    NotifyStrategy

    string

    Non

    La stratégie de nouvelle tentative lorsqu'une erreur se produit lors du push des messages vers le point de terminaison. Valeurs valides :

    • BACKOFF_RETRY : nouvelle tentative avec temporisation.

    • EXPONENTIAL_DECAY_RETRY : nouvelle tentative avec décroissance exponentielle.

    BACKOFF_RETRY
    NotifyContentFormat

    string

    Non

    Format du contenu du message distribué

    Valeurs valides :

    • XML : le corps du message est distribué au format XML. Il s'agit de la valeur par défaut.

    • JSON : le corps du message est distribué au format JSON.

    • SIMPLIFIED : seul le contenu brut du corps du message est distribué, sans encapsulation par les métadonnées SMQ.

    XML
    MessageTag

    string

    Non

    La balise utilisée pour le filtrage des messages dans cet abonnement. Seuls les messages avec une balise correspondante sont distribués. La valeur est une chaîne de 16 caractères maximum.

    Par défaut, aucun filtrage de message n'est appliqué.

    important
    DlqPolicy

    object

    Non

    La stratégie de file d'attente de lettres mortes.

    Enabled

    boolean

    Non

    Indique si la distribution des messages de lettres mortes doit être activée.

    true
    DeadLetterTargetQueue

    string

    Non

    La file d'attente de destination pour la distribution des messages de lettres mortes.

    deadLetterTargetQueue
    TenantRateLimitPolicy

    object

    Non

    La stratégie de limitation.

    Enabled

    boolean

    Non

    Indique si la stratégie de limitation doit être activée. Valeurs valides : true et false.

    MaxReceivesPerSecond

    integer

    Non

    Le nombre maximum de distributions ou de consommations par seconde.

    50
    StsRoleArn

    string

    Non

    L'ARN du rôle RAM endossé par le service. Le format est acs:ram::{Alibaba Cloud account ID}:role/{RoleName}. Remplacez {Alibaba Cloud account ID} par l'identifiant du compte Alibaba Cloud qui appelle l'opération d'API.

    acs:ram::1234567890:role/AliyunMNSNotificationRole
    DmAttributes

    object

    Non

    Les attributs de push par e-mail. Ce paramètre est requis lorsque PushType est défini sur dm. La valeur est au format JSON et contient les champs suivants :

    • AccountName : l'adresse de l'expéditeur configurée dans DirectMail (telle que notify@example.com).

    • Subject : l'objet de l'e-mail.

    AccountName

    string

    Non

    L'adresse de l'expéditeur.

    notify@example.com
    Subject

    string

    Non

    L'objet de l'e-mail.

    notify
    DysmsAttributes

    object

    Non

    Les attributs de push par SMS. Ce paramètre est requis lorsque PushType est défini sur alisms. La valeur est au format JSON et contient les champs suivants :

    • TemplateCode : le code du modèle SMS, qui peut être obtenu à partir de la console Short Message Service.

    • SignName : le nom de la signature SMS.

    TemplateCode

    string

    Non

    Le code du modèle SMS.

    123456
    SignName

    string

    Non

    Le nom de la signature SMS.

    阿里云短信测试专用
    KafkaAttributes

    object

    Non

    Le type de push Kafka est obsolète.

    BusinessMode

    string

    Non

    Le type de push Kafka est obsolète.

    Chaîne vide par défaut

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    RequestId

    string

    L'identifiant de la requête.

    06273500-249F-5863-121D-74D51123****
    Code

    integer

    Le code de réponse.

    200
    Status

    string

    L'état de la réponse.

    Success
    Message

    string

    Le message de réponse.

    operation success
    Success

    boolean

    Indique si la requête a réussi.

    true
    Data

    string

    Les données de réponse.

    {'Code': 200, 'Success': True}

    Exemples

    JSON format

    {
  "RequestId": "06273500-249F-5863-121D-74D51123****",
  "Code": 200,
  "Status": "Success",
  "Message": "operation success",
  "Success": true,
  "Data": "{'Code': 200, 'Success': True}"
}

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.