キューを変更します。
認証
デフォルトでは、Alibaba Cloudアカウントのみがこの操作を呼び出すことができます。 RAMユーザーは、関連する権限が付与された後にのみ、この操作を呼び出すことができます。次の表に、この操作の認証情報を示します。 詳細については、「アクセス許可ポリシーと例」をご参照ください。
| 名前 | 値 |
| API | SetQueueAttributes |
| アクション | mns:SetQueueAttributes |
| 項目 | acs:mns:$region:$accountid:/queues/$queueName |
リクエスト
リクエストは、次の部分で構成されます。
- リクエスト行
PUT /queues/$queueName?metaoverride=true HTTP/1.1 - URIパラメーター
キューのパラメーターを変更するには、URIで
metaoverride=trueを指定します。 - 操作固有のリクエストヘッダー
なし。
リクエスト本文
リクエスト本文はXML形式です。キューのパラメーターは、リクエスト本文に含めることができます。すべてのパラメーターはオプションです。
パラメーター タイプ 必須 例 説明 DelaySeconds 整数 いいえ。 0 キューに送信されるすべてのメッセージが使用可能になるまでの遅延時間。 有効な値:0~604800。単位:秒。
デフォルト値:0。
MaximumMessageSize 整数 いいえ。 1024 キューに送信できるメッセージ本文の最大サイズ。 有効な値:1024~65536。単位:バイト。
デフォルト値:65536。
MessageRetentionPeriod 整数 いいえ。 120 メッセージをキューに保持できる最大期間。この期間が終了すると、メッセージが使用されているかどうかに関係なく、メッセージは削除されます。 有効な値:60~604800。単位:秒。
デフォルト値:345600。
VisibilityTimeout 整数 いいえ。 60 受信したメッセージが非アクティブ状態のままになる非表示期間。 有効な値:1~43200。単位:秒。
デフォルト値:30。
PollingWaitSeconds 整数 いいえ。 0 キューで使用可能なメッセージがない場合に、ReceiveMessageリクエストが待機する最大期間。 有効な値:0~30。単位:秒。
デフォルト値:0。
LoggingEnabled ブール値 いいえ True ログ管理機能を有効にするかどうかを指定します。有効な値: 有効な値:- True:ログ管理機能を有効にします。
- False:ログ管理機能を無効にします。
デフォルト値:False。
Terraformを使用して alicloud_message_service_queue を管理する場合は、LoggingEnabled パラメーターを EnableLogging パラメーターに置き換えます。
エラーメッセージ
レスポンスは、次の部分で構成されます。
- HTTPステータスコード
HTTP/1.1 204 No Content - 操作固有のレスポンスヘッダー
なし。
- レスポンス本文
なし。
例
サンプルリクエスト
PUT /queues/$queueName?Metaoverride=true HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Wed, 08 Mar 2012 12:00:00 GMT
x-mns-version: 2015-06-06
Authorization: MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAM****
<?xml version="1.0" encoding="UTF-8"?>
<Queue xmlns="http://mns.aliyuncs.com/doc/v1/">
<VisibilityTimeout >60</VisibilityTimeout>
<MaximumMessageSize>1024</MaximumMessageSize>
<MessageRetentionPeriod>120</MessageRetentionPeriod>
<DelaySeconds>30</DelaySeconds>
<LoggingEnabled>True</LoggingEnabled>
</Queue> サンプルレスポンス
HTTP/1.1 204 No Content
x-mns-request-id:512B2A634403E52B1956****
x-mns-version: 2015-06-06 エラーコード
| エラーコード | エラーメッセージ | HTTPステータスコード | 説明 |
| InvalidArgument | 要素の値は、Low~High秒/バイトの範囲内である必要があります。 | 400 | パラメーター値が無効なために返されたエラーメッセージ。値が値の範囲内にあることを確認してください。 |
| QueueNotExist | 指定されたキュー名は存在しません。 | 404 | 指定されたキューが存在しないために返されたエラーメッセージ。キューを作成する必要があります。 |