すべてのプロダクト
Search
ドキュメントセンター

:SetQueueAttributes

最終更新日:Mar 14, 2025

キューを変更します。

認証

デフォルトでは、Alibaba Cloudアカウントのみがこの操作を呼び出すことができます。 RAMユーザーは、関連する権限が付与された後にのみ、この操作を呼び出すことができます。次の表に、この操作の認証情報を示します。 詳細については、「アクセス許可ポリシーと例」をご参照ください。

名前
APISetQueueAttributes
アクション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指定されたキューが存在しないために返されたエラーメッセージ。キューを作成する必要があります。