全部產品
Search
文件中心

:SetTopicAttributes

更新時間:Jan 24, 2025

調用SetTopicAttributes介面來修改主題的屬性。

授權資訊

預設僅限阿里雲帳號使用本介面,RAM使用者只有在被授予了相關API操作許可權後方可使用。本介面的授權資訊如下表所示。更多資訊,請參見授權策略和樣本

NameValue
APISetTopicAttributes
RAM授權操作mns:SetTopicAttributes
資源acs:mns:$region:$accountid:/topics/$topicName

請求訊息

請求訊息由請求行、HTTP頭和訊息體三部分組成:

  • 請求行

    PUT /topics/$TopicName?metaoverride=true HTTP/1.1

  • 特有URI參數

    metaoverride=true將會修改主題的屬性。

  • 特有Request Header

    無。

  • Request Body

    Request Body為XML格式,XML格式中包含設定主題的屬性。

    參數名稱類型是否必選樣本值描述
    MaximumMessageSizeInteger65536發送到該主題的訊息體最大長度。

    取值範圍:1024~65536,單位為Byte。

    預設值:65536。

    LoggingEnabledBooleanTrue是否開啟日誌管理功能。
    取值範圍:
    • True:啟用。
    • False:停用。

    預設值:False。

    如果您使用Terraform管理alicloud_message_service_topic,請按照下表說明對參數進行調用。

    參數名稱類型是否必選樣本值描述
    MaximumMessageSizeInteger65536發送到該主題的訊息體最大長度。

    取值範圍:1024~65536,單位為Byte。

    預設值:65536。

    EnableLoggingBooleanTrue是否開啟日誌管理功能。
    取值範圍:
    • True:啟用。
    • False:停用。

    預設值:False。

返回訊息

返回訊息由返回狀態行、HTTP頭和訊息體三部分組成:

  • HTTP Status Code

    HTTP/1.1 204 No Content

  • 特有Response Header

    無。

  • Response Body

    無。

樣本

請求樣本:

PUT /topics/$TopicName?metaoverride=true HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
x-mns-version: 2015-06-06
Date: Tue, 08 Dec 2015 06:01:00 GMT
Authorization:MNS 15B4D3461F177624206A:SeIRcZk3lKiP7bl19WB9Uz07****

<?xml version="1.0" encoding="utf-8"?>
<Topic xmlns="http://mns.aliyuncs.com/doc/v1/">
    <MaximumMessageSize>65536</MaximumMessageSize>
    <LoggingEnabled>True</LoggingEnabled>
</Topic>    

返回樣本:

HTTP/1.1 204 No Content
x-mns-request-id:5666721CB2B71C9C1600****
x-mns-version: 2015-06-06

錯誤碼

錯誤碼錯誤訊息HTTP狀態代碼內容描述
TopicNotExistThe topic you provided does not exist.404主題不存在,請先建立主題。