サブスクリプションのパラメーターを照会します。
認証
デフォルトでは、Alibaba Cloud アカウントのみがこの操作を呼び出すことができます。 RAM ユーザーは、関連する権限が付与された後にのみ、この操作を呼び出すことができます。次の表に、この操作の認証情報を示します。詳細については、「権限ポリシーと例」をご参照ください。
| 項目 | 値 |
| API 操作 | GetSubscriptionAttributes |
| アクション | mns:GetSubscriptionAttributes |
| リソース | acs:mns:$region:$accountid:/topics/$topicName/subscriptions/$subscriptionName |
リクエスト
リクエストは、次の部分で構成されます。
- リクエスト行
GET /topics/$TopicName/subscriptions/$SubscriptionName HTTP/1.1 - 操作固有のリクエストヘッダー
なし。
- リクエスト本文
なし。
レスポンス
レスポンスは、次の部分で構成されます。
- HTTP ステータスコード
HTTP/1.1 200 OK - 操作固有のレスポンスヘッダー
なし。
- レスポンス本文
パラメーター タイプ 例 説明 SubscriptionName String MySubscription サブスクリプションの名前。 Subscriber String MyQueue サブスクライバーのアカウント ID。 TopicOwner String 123456789098**** トピック所有者のアカウント ID。 TopicName String MyTopic トピックの名前。 Endpoint String http://example.com メッセージのプッシュ先エンドポイント。 NotifyStrategy Boolean BACKOFF_RETRY MNS がエンドポイントにメッセージをプッシュするときにエラーが発生した場合に適用される再試行ポリシー。 有効な値:- BACKOFF_RETRY: 固定バックオフ間隔で再試行します。
- EXPONENTIAL_DECAY_RETRY: 指数関数的バックオフで再試行します。
NotifyContentFormat Boolean XML エンドポイントにプッシュされるメッセージのコンテンツ形式。 有効な値:- XML
- JSON
- SIMPLIFIED
FilterTag String important メッセージをフィルタリングするために使用されるタグ。指定されたタグが添付されているメッセージのみがプッシュされます。 CreateTime Long 1449554806 サブスクリプションが作成された時刻。この値は、エポックタイム 1970 年 1 月 1 日 00:00:00 UTC から経過したミリ秒数を表す UNIX タイムスタンプです。 LastModifyTime Long 1449554962 サブスクリプションが最後に変更された時刻。この値は、エポックタイム 1970 年 1 月 1 日 00:00:00 UTC から経過したミリ秒数を表す UNIX タイムスタンプです。
例
リクエストの例
GET /topics/$TopicName/subscriptions/$SubscriptionName HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 06:09:58 GMT
Authorization: MNS 15B4D3461F177624206A:GvaApggLQfMu6B6W5sbF6HEj****
x-mns-version: 2015-06-06成功レスポンスの例
HTTP/1.1 200 OK
Content-Type=text/xml;utf-8
Content-Length:451
x-mns-request-id:56667436B2B71C9C1600****
x-mns-version: 2015-06-06
<?xml version="1.0" encoding="utf-8"?>
<Subscription xmlns="http://mns.aliyuncs.com/doc/v1">
<CreateTime>1449554806</CreateTime>
<Endpoint>http://example.com</Endpoint>
<FilterTag>important</FilterTag>
<LastModifyTime>1449554962</LastModifyTime>
<NotifyContentFormat>XML</NotifyContentFormat>
<NotifyStrategy>BACKOFF_RETRY</NotifyStrategy>
<SubscriptionName>MySubscription</SubscriptionName>
<Subscriber>MyQueue</Subscriber>
<TopicName>MyTopic</TopicName>
<TopicOwner>123456789098****</TopicOwner>
</Subscription> エラーコード
| エラーコード | エラーメッセージ | HTTP ステータスコード | 説明 |
| SubscriptionNotExist | 指定されたサブスクリプションが存在しません。 | 404 | 指定されたサブスクリプションが存在しないために返されるエラーメッセージ。サブスクリプションを作成してください。 |