全部產品
Search

搜尋本產品

    Simple Message Queue (formerly MNS)：GetTopicAttributes

    文件中心

    Simple Message Queue (formerly MNS)：GetTopicAttributes

    更新時間：Oct 08, 2026

    呼叫GetTopicAttributes介面取得主題的屬性。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mns:GetTopicAttributes

    get

    *Topic

    acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    TopicName

    string

    是

    主題的名稱。

    demo-topic
    Tag

    array<object>

    否

    資源標籤清單。

    object

    否

    標籤清單。

    Key

    string

    否

    標籤的 key。

    tag1
    Value

    string

    否

    標籤值。

    test

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求的 ID。

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

    integer

    回應 code。

    200
    Status

    string

    回應的狀態。

    Success
    Message

    string

    回應資訊。

    operation success
    Success

    boolean

    請求是否成功。

    true
    Data

    object

    回應資料。

    TopicName

    string

    主題的名稱。

    demo-topic
    MessageCount

    integer

    目前該主題中訊息數目。

    0
    MaxMessageSize

    integer

    傳送到該主題的訊息主體最大長度，單位為 Byte。

    65536
    MessageRetentionPeriod

    integer

    訊息在主題中最長存活時間，從傳送到該主題開始經過此參數指定的時間後，不論訊息是否被成功推送給使用者都將被刪除，單位為秒。

    86400
    CreateTime

    integer

    主題的建立時間，為 UTC Unix 秒級時間戳記。

    1449554277
    LastModifyTime

    integer

    主題屬性最近一次修改時間，為 UTC Unix 秒級時間戳記。

    1449554460
    LoggingEnabled

    boolean

    是否開啟日誌管理功能。

    • True：啟用。

    • False：停用。

    True
    Tags

    array<object>

    資源標籤清單。

    object

    標籤鍵對應的標籤值。

    TagKey

    string

    標籤的 key。

    tag1
    TagValue

    string

    標籤值。

    test
    TopicType

    string

    主題類型。可取值如下：

    • normal: 普通主題

    • fifo: FIFO 主題

    normal
    TopicUrl

    string

    主題的公網存取 URL。

    http://111111111****.mns.us-west-1.aliyuncs.com/topics/testTopic
    TopicInnerUrl

    string

    主題的內網存取 URL。

    http://111111111****.mns.us-west-1-internal.aliyuncs.com/topics/testTopic
    EnableSSE

    boolean

    是否開啟儲存加密。取值：true 或 false。

    true
    SseType

    string

    儲存加密方式。取值：SMQ 或 KMS。

    KMS
    SseAlgorithm

    string

    儲存加密演算法，目前支援 AES-256-GCM；未指定時使用預設演算法。

    AES-256-GCM
    KmsKeyId

    string

    KMS 金鑰 ID。

    key-xxx
    EncryptionEnabled

    boolean

    是否已啟用儲存加密。

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "06273500-249F-5863-121D-74D51123****",
  "Code": 200,
  "Status": "Success",
  "Message": "operation success",
  "Success": true,
  "Data": {
    "TopicName": "demo-topic",
    "MessageCount": 0,
    "MaxMessageSize": 65536,
    "MessageRetentionPeriod": 86400,
    "CreateTime": 1449554277,
    "LastModifyTime": 1449554460,
    "LoggingEnabled": true,
    "Tags": [
      {
        "TagKey": "tag1",
        "TagValue": "test"
      }
    ],
    "TopicType": "normal",
    "TopicUrl": "http://111111111****.mns.us-west-1.aliyuncs.com/topics/testTopic",
    "TopicInnerUrl": "http://111111111****.mns.us-west-1-internal.aliyuncs.com/topics/testTopic",
    "EnableSSE": true,
    "SseType": "KMS",
    "SseAlgorithm": "AES-256-GCM",
    "KmsKeyId": "key-xxx",
    "EncryptionEnabled": true
  }
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。