調用SetTopicAttributes介面來修改主題的屬性。
授權資訊
預設僅限阿里雲帳號使用本介面,RAM使用者只有在被授予了相關API操作許可權後方可使用。本介面的授權資訊如下表所示。更多資訊,請參見授權策略和樣本。
| Name | Value |
| API | SetTopicAttributes |
| 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格式中包含設定主題的屬性。
參數名稱 類型 是否必選 樣本值 描述 MaximumMessageSize Integer 否 65536 發送到該主題的訊息體最大長度。 取值範圍:1024~65536,單位為Byte。
預設值:65536。
LoggingEnabled Boolean 否 True 是否開啟日誌管理功能。 取值範圍:- True:啟用。
- False:停用。
預設值:False。
如果您使用Terraform管理alicloud_message_service_topic,請按照下表說明對參數進行調用。
參數名稱 類型 是否必選 樣本值 描述 MaximumMessageSize Integer 否 65536 發送到該主題的訊息體最大長度。 取值範圍:1024~65536,單位為Byte。
預設值:65536。
EnableLogging Boolean 否 True 是否開啟日誌管理功能。 取值範圍:- 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狀態代碼 | 內容描述 |
| TopicNotExist | The topic you provided does not exist. | 404 | 主題不存在,請先建立主題。 |