• 本栏最新文章
  • 本栏推荐文章
当前位置: 主页 > 博狗bodog >

Subscription操作_主题接口规范_API 参考_消息服务

时间:2018-07-24    作者:admin    来源:网络整理

Subscribe

特性描述

此管嘴用于订阅提供。,建立 Subscription。
Subscription 明确不姓人家 256 字母串,必要的是字母或数字的第人家角色,其余者的可以容纳字母。、数字穿插线。
建立订阅 时,您需求详细阐明有关的的 Endpoint,别的方式违反规则的。

Request

Request 该机构首要由以下结合的结合:

  • 命令行

    PUT /topics/$TopicName/subscriptions/$SubscriptionName HTTP/

  • 特效药 Request Header

    无,请商量 召唤方式/公共限制因素

  • Request Body

    Request Body 为 XML 体式,XML 总容纳建立 Subscription 的属性。

限制因素明确阐明限制因素值选择能力
Endpoint特性描述在本订阅中接纳到的音讯的末期的地址。四种消失点 1. HttpEndpoint,必要的是http://的前缀 2. QueueEndpoint, 体式为acs:mns:{REGION}:{AccountID}:queues/{QueueName} 3. MailEndpoint, 体式为mail:directmail:{MailAddress} 4. SmsEndpoint, 体式是SMS:直截了当地短信:隐姓埋名 或sms:directsms:{Phone}Required
FilterTag特性描述订阅中音讯过滤的监视(监视分歧)不超越16字母串,默许音讯过滤Optional
NotifyStrategy特性描述支座 Endpoint 推进运动音讯出年代误植的重试战略BACKOFF_RETRY 或许 EXPONENTIAL_DECAY_RETRY,默许是回退重试。,请参阅重试战略的详细阐明 基本概念/告发战略Optional
NotifyContentFormat特性描述支座 Endpoint 推进运动音讯体式XML 、JSON 或许 SIMPLIFIED,默许是 XML,请商量音讯体式的详细特性描述 基本概念/告发心甘情愿的体式Optional

Response

汇成音讯由汇成健康状况行产额。产额。产额。产额。产额。、HTTP头和音讯体的三个使相称

  • HTTP Status Code

    HTTP/ 201
    相同的用户在相同的提供 Subscription 不克不及改名,当有人家激烈的的名字,免得它被发明了 Subscription 早已在的 Subscription 属性完全相同。,汇成 204,别的方式汇成 409 (冲)。

  • 特效药 Response Header

其它 Response Header 请商量 召唤方式/公共限制因素

Special Error

里面的代码里面的报文健康状况码
SubscriptionNameLengthErrorSubscription name length is out of range, should be between 1 and 256.400
SubscriptionNameInvalidThe subscription you provided is 残废者。 SubscriptionName should start with alpha or digit, and contain only alpha, digit or -.400
SubscriptionAlreadyExistThe subscription you want to create already 在。409
EndpointInvalidThe endpoint you provided is 残废者。400
InvalidArgumentThe length of filter tag should be between 1 and 16.400

命令加盖于:

  1. PUT /topics/$TopicName/subscriptions/$SubscriptionName HTTP/
  2. Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
  3. Date:Tue,08Dec201506:06:46 GMT
  4. Authorization:MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=
  5. x-mns-version:2015-06-06
  6. xml version="" encoding="utf-8"?>
  7. <Subscription xmlns="">
  8. <Endpoint>http://company.com
  9. <NotifyStrategy>BACKOFF_RETRYNotifyStrategy>
  10. <NotifyContentFormat>SIMPLIFIEDNotifyContentFormat>
  11. <FilterTag>importantFilterTag>
  12. Subscription>

汇成示例:

  1. HTTP/201
  2. x-mns-request-id:56667376B2B71C9C16000025
  3. x-mns-version:2015-06-06
  4. Location: http://$$TopicName/subscriptions/$SubscriptionName

SetSubscriptionAttributes

特性描述

管嘴用于修正 Subscription 的属性

Request

Request 该机构首要由以下结合的结合:

  • 命令行

    PUT /topics/$TopicName/subscriptions/$SubscriptionName?metaoverride=true HTTP/

  • 特效药 URI 限制因素

    metaoverride=true 将被修正 Subscription 的属性

  • 特效药 Request Header

    无,请商量 召唤方式/公共限制因素

  • Request Body

    Request Body 为 XML 体式,XML 包孕修正 Subscription 的属性:

限制因素明确阐明限制因素值选择能力
NotifyStrategy特性描述支座 Endpoint 推进运动音讯出年代误植的重试战略BACKOFF_RETRY 或许 EXPONENTIAL_DECAY_RETRY,默许是回退重试。,请参阅重试战略的详细阐明 基本概念/告发战略Optional

Response

汇成音讯由汇成健康状况行产额。产额。产额。产额。产额。、HTTP头的三使相称和音讯体

  • HTTP Status Code

    HTTP/ 204 No Content

  • 特效药 Response Header

    无,请商量 召唤方式/公共限制因素

  • Response Body

Special Error:

里面的代码里面的音讯健康状况码
SubscriptionNotExistThe subscription you provided does not 在。404

命令加盖于:

  1. PUT /topics/$TopicName/subscriptions/$SubscriptionName?metaoverride=true HTTP/
  2. Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
  3. Date:Tue,08Dec201506:09:22 GMT
  4. Authorization: MNS 15B4D3461F177624206A:rNT4xclLS297/n0UFYIezzHJI7Q=
  5. x-mns-version:2015-06-06
  6. xml version="" encoding="utf-8"?>
  7. <Subscription xmlns="">
  8. <NotifyStrategy>BACKOFF_RETRYNotifyStrategy>
  9. Subscription>

汇成示例:

  1. HTTP/204NoContent
  2. x-mns-request-id:56667412B2B71C9C16000027
  3. x-mns-version:2015-06-06

GetSubscriptionAttributes

特性描述

此管嘴用于获取 Subscription 的属性

Request

Request 该机构首要由以下结合的结合:

  • 命令行

    GET /topics/$TopicName/subscriptions/$SubscriptionName HTTP/

  • 特效药 Request Header

    无,请商量 召唤方式/公共限制因素

  • Request Body

Response

汇成音讯由汇成健康状况行产额。产额。产额。产额。产额。、HTTP头和音讯的三个使相称

  • HTTP Status Code

    HTTP/ 200 OK

  • 特效药 Response Header

    无,请商量 召唤方式/公共限制因素

  • Response Body

限制因素明确阐明
SubscriptionNameSubscription 的明确
SubscriberSubscription 订阅者的 AccountId
TopicOwnerSubscription 订阅提供专利的 AccountId
TopicNameSubscription 订阅的提供明确
Endpoint订阅末期的地址
NotifyStrategy向 Endpoint 推进运动音讯里面的的重试战略
NotifyContentFormat向 Endpoint 推进运动的音讯心甘情愿的体式
FilterTag特性描述此订阅做成某事音讯过滤的监视(仅标志为Co)。
CreateTimeSubscription 创作工夫,从 1970-1-1 00:00:00 第二次时值
LastModifyTime修正 Subscription 属性新闻的结局一次,从 1970-1-1 00:00:00 第二次时值

Special Error

里面的代码里面的报文健康状况码
SubscriberNotExistThe subscription you provided does not exist.404

命令加盖于:

  1. GET /topics/$TopicName/subscriptions/$SubscriptionName HTTP/
  2. Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
  3. Date:Tue,08Dec201506:09:58 GMT
  4. Authorization: MNS 15B4D3461F177624206A:GvaApggLQfMu6B6W5sbF6HEjV6Y=
  5. x-mns-version:2015-06-06

汇成示例:

  1. HTTP/200 OK
  2. Content-Type=text/xml;utf-8
  3. Content-Length:451
  4. x-mns-request-id:56667436B2B71C9C16000029
  5. x-mns-version:2015-06-06
  6. xml version="" encoding="utf-8"?>
  7. <Subscription xmlns="">
  8. <CreateTime>1449554806CreateTime>
  9. <Endpoint>http://company.com
  10. <FilterTag>importantFilterTag>
  11. <LastModifyTime>1449554962LastModifyTime>
  12. <NotifyContentFormat>XMLNotifyContentFormat>
  13. <NotifyStrategy>BACKOFF_RETRYNotifyStrategy>
  14. <SubscriptionName>$SubscriptionNameSubscriptionName>
  15. <Subscriber>$SubscriberSubscriber>
  16. <TopicName>$TopicNameTopicName>
  17. <TopicOwner>$TopicOwnerTopicOwner>
  18. Subscription>

Unsubscribe

特性描述

此管嘴用于约去建立的管嘴。 Subscription。

Request

Request 该机构首要由以下结合的结合:

  • 命令行

    DELETE /topics/$TopicName/subscriptions/$SubscriptionName HTTP/

  • 特效药 Request Header

    无,请商量 召唤方式/公共限制因素

  • Request Body

Response

汇成音讯由汇成健康状况行产额。产额。产额。产额。产额。、HTTP头和音讯体的三个使相称

  • HTTP Status Code

    HTTP/ 204 No Content
    免得 Unsubscribe 的 Subscription 不在,汇成 204,退订成

  • 特效药 Response Header

    无,请商量 召唤方式/公共限制因素

  • Response Body

命令加盖于:

  1. DELETE /topics/$TopicName/Subscriptions/$SubscriptionName HTTP/
  2. Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
  3. Date:Tue,08Dec201506:18:04 GMT
  4. Authorization: MNS 15B4D3461F177624206A:UOEb7OmC9GX7G9BLY3XryP6vtjQ=
  5. x-mns-version:2015-06-06

汇成示例:

  1. HTTP/204NoContent
  2. x-mns-request-id:5666761CB2B71C9C16000035
  3. x-mns-version:2015-06-06

ListSubscriptionByTopic

特性描述

此管嘴用于列出提供。 Subscription 列表,获取通知的分页。

Tips:

免得此命令的终结汇成 Subscription 总共超越因此命令 x-mns-ret-number 限制因素值,汇成的 XML 终结包孕 NextMarker 指明下对开的纸的幼芽得第二名,将值分分配物下人家命令 x-mns-marker 限制因素汇成下对开的纸的终结。。

Request

Request 该机构首要由以下结合的结合:

  • 命令行

    GET /topics/$TopicName/subscriptions HTTP/

  • 特效药 Request Header

限制因素明确阐明选择能力
x-mns-prefix从前缀开端 SubscriptionName 举行查找Optional
x-mns-marker命令下人家分页的幼芽得第二名,从结局一次寻呼的终结汇成 NextMarker 获取Optional
x-mns-ret-number隐士命令终结的最大汇成数,1 - 1000 范围内的圆整数值,默许值为 1000Optional

其它 Request Header 请商量 召唤方式/公共限制因素

Response

汇成音讯由汇成健康状况行产额。产额。产额。产额。产额。、HTTP头和音讯体的三个使相称

  • HTTP Status Code

    HTTP/ 200 OK

  • 特效药 Response Header

    无,请商量 召唤方式/公共限制因素

  • Response Body

    汇成 XML 体式化终结,上层林冠 Subscriptions 元素容纳不停地人家元素。 Subscription 元素,Subscription 元素容纳 SubscriptionURL,SubscriptionURL 表现 Subscription 的 URL 出口地址。免得汇成终结大于 x-mns-ret-number 的限制因素值,容纳 NextMarker 元素表现下人家分页的幼芽得第二名。。

命令加盖于:

  1. GET /topics/$TopicName/subscriptions HTTP/
  2. x-mns-ret-number:2
  3. Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
  4. Date:Tue,08Dec201506:16:18 GMT
  5. Authorization: MNS 15B4D3461F177624206A:dXSLY5yGG8Ri5f26ZEmxMCq1CC4=
  6. x-mns-version:2015-06-06

汇成示例:

  1. HTTP/200 OK
  2. x-mns-request-id:566675B2B2B71C9C16000033
  3. x-mns-version:2015-06-06
  4. xml version="" encoding="utf-8"?>
  5. <Subscriptions xmlns="">
  6. <Subscription>
  7. <SubscriptionURL>http://$$TopicName/subscriptions/$SubscriptionName1
  8. Subscription>
  9. <Subscription>
  10. <SubscriptionURL>http://$$TopicName/subscriptions/$SubscriptionName2
  11. Subscription>
  12. <NextMarker>OTczNjU4MTcvYmRwejd6NXluby8yNjg0Mi9+fn5FI1Rlc3RUb3BpYy0xI2JkcHo3ejV5bm8jVGVzdFN1Yi0zLzA=NextMarker>
  13. Subscriptions>

上一篇:小沈阳护女却遭"背叛 ",沈佳润自爆其家庭内幕!吓傻网友!!
下一篇:没有了