Set Queue Service Properties
目次を折りたたむ
目次を展開する
この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

Set Queue Service Properties

 

Set Queue Service Properties 操作のプロパティを含む、ストレージ アカウントのキュー サービス エンドポイントのプロパティを設定する Storage Analytics や CORS (クロス オリジン リソース共有) ルール。 参照してください 共有 (CORS) のサポート、Azure のストレージ サービスのクロス オリジン リソース CORS ルールの詳細についてはします。

Set Queue Service Properties 要求は次のように指定することがあります。 HTTPS が推奨されます。 置き換える <account-name> をストレージ アカウントの名前。

メソッド

要求 URI

HTTP バージョン

put

https://<account-name>.queue.core.windows.net/?restype=service&comp=properties

HTTP/1.1

URI には必ずスラッシュ (/) を含めて、ホスト名を URI のパス部分とクエリ部分から分離する必要があります。 この操作の場合、URI のパス部分は空です。

Parameter

description

restype=service&comp=properties

必須。

ストレージ サービス プロパティを設定するには、両方のクエリ文字列を組み合わせる必要があります。

timeout

省略可能です。 timeout パラメーターは、秒単位で表されます。 詳細については、次を参照してください。 キュー サービス操作のタイムアウトの設定です。

次の表は、必須の要求ヘッダーおよび省略可能な要求ヘッダーを示します。

要求ヘッダー

description

Authorization

必須。

認証スキーム、ストレージ アカウント名、および署名を指定します。 詳細については、次を参照してください。 Azure ストレージ サービスの認証です。

Date または x-ms-date

必須。

要求の世界協定時刻 (UTC) を指定します。 詳細については、次を参照してください。 Azure ストレージ サービスの認証です。

x-ms-version

認証されたすべての要求について必須です。 この要求に使用する操作のバージョンを指定します。 詳細については、次を参照してください。 Azure ストレージ サービスのバージョン管理です。

x-ms-client-request-id

省略可能です。 ストレージ解析ロギングが有効なときに解析ログに記録される、クライアントで生成された非透過の値を 1 KB の文字制限付きで提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付けるために、このヘッダーを使用することを強くお勧めします。 詳細については、次を参照してください Storage Analytics Logging についてAzure ロギング:ログ ストレージ要求の追跡を使用したです。

バージョン 2012-02-12 以前では、要求本文の形式は次のとおりです。

<?xml version="1.0" encoding="utf-8"?> <StorageServiceProperties> <Logging> <Version>version-number</Version> <Delete>true|false</Delete> <Read>true|false</Read> <Write>true|false</Write> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </Logging> <Metrics> <Version>version-number</Version> <Enabled>true|false</Enabled> <IncludeAPIs>true|false</IncludeAPIs> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </Metrics> </StorageServiceProperties>

バージョン 2013-08-15 以降では、要求本文の形式は次のとおりです。

<?xml version="1.0" encoding="utf-8"?> <StorageServiceProperties> <Logging> <Version>version-number</Version> <Delete>true|false</Delete> <Read>true|false</Read> <Write>true|false</Write> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </Logging> <HourMetrics> <Version>version-number</Version> <Enabled>true|false</Enabled> <IncludeAPIs>true|false</IncludeAPIs> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </HourMetrics> <MinuteMetrics> <Version>version-number</Version> <Enabled>true|false</Enabled> <IncludeAPIs>true|false</IncludeAPIs> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </MinuteMetrics> <Cors> <CorsRule> <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins> <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods> <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds> <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders> <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders> </CorsRule> </Cors> </StorageServiceProperties>

バージョン 2013年-08-15 以降では、呼び出すことができます Set Queue Service Properties 1 つまたは複数のルート要素が要求本文で指定されているとします。 ルート要素は次のとおりです。

  • Logging

  • HourMetrics

  • MinuteMetrics

  • Cors

要求ですべてのルート要素を指定する必要はなくなりました。 ルート要素を省略した場合、その機能に対応したサービスの既存の設定が維持されます。 ただし、特定のルート要素を指定した場合、その要素のすべての子要素を指定する必要があります。

要求本文の要素を次の表に示します。

要素名

description

Logging

バージョン 2013-08-15 以降では省略可能です。 それよりも前のバージョンでは必須です。 Azure の分析をグループ化 Logging 設定します。

Metrics

バージョン 2012-02-12 以前では必須です。 バージョン 2013-08-15 以降には適用できません。 Azure の分析をグループ化 Metrics 設定します。 Metrics 設定は、キューの 1 時間ごとの集計で API によってグループ化された要求の統計の概要を提供します。

HourMetrics

バージョン 2013-08-15 以降では省略可能ですが、それよりも前のバージョンには適用できません。 Azure の分析をグループ化 HourMetrics 設定します。 HourMetrics 設定は、キューの 1 時間ごとの集計で API によってグループ化された要求の統計の概要を提供します。

MinuteMetrics

バージョン 2013-08-15 以降では省略可能ですが、それよりも前のバージョンには適用できません。 Azure の分析をグループ化 MinuteMetrics 設定します。 MinuteMetrics 設定は、キューの分単位の要求の統計情報を提供します。 2013-08-15 より前のバージョンの MinuteMetrics は応答本文に含まれません。

Version

必要な場合 Logging, 、Metrics, 、HourMetrics, 、または MinuteMetrics の設定を指定します。 構成する Storage Analytics のバージョン。

Delete

必要な場合 Logging, 、Metrics, 、HourMetrics, 、または MinuteMetrics の設定を指定します。 ログ構成にのみ適用されます。 すべての削除要求をログに記録するかどうかを示します。

Read

必要な場合 Logging, 、Metrics, 、HourMetrics, 、または MinuteMetrics の設定を指定します。 ログ構成にのみ適用されます。 すべての読み取り要求をログに記録するかどうかを示します。

Write

必要な場合 Logging, 、Metrics, 、HourMetrics, 、または MinuteMetrics の設定を指定します。 ログ構成にのみ適用されます。 すべての書き込み要求をログに記録するかどうかを示します。

Enabled

必須。

キュー サービスに対してメトリックが有効であるかどうかを示します。

読み取りアクセスの地理冗長レプリケーションが有効である場合、プライマリ メトリックとセカンダリ メトリックの両方が収集されます。 読み取りアクセスの地理冗長レプリケーションが有効でない場合、プライマリ メトリックだけが収集されます。

IncludeAPIs

メトリックが有効な場合のみ必須です。 メトリック構成にのみ適用されます。 メトリックで、呼び出された API 操作の概要統計情報を生成するかどうかを示します。

RetentionPolicy/Enabled

必須。

ストレージ サービスに対して保持ポリシーが有効であるかどうかを示します。

RetentionPolicy/Days

保持ポリシーが有効な場合のみ必須です。 メトリックまたはログ データを保持する日数を示します。 この値より古いデータは、すべて削除されます。 指定できる最小の値は 1。 最大値は 365 (1 年) です。

Cors

省略可能です。 Cors 要素は、バージョン 2013年-08-15 のサポートされている以降。 すべての CORS ルールをグループ化します。

この要素グループを省略しても、既存の CORS 設定は上書きされません。

CorsRule

省略可能です。 キュー サービスの CORS ルールを指定します。 最大 5 つを含めることができます CorsRule 要求内の要素。 ない場合は CorsRule 要素が要求本文に含まれている、すべての CORS ルールが削除、およびキュー サービスの CORS が無効になります。

AllowedOrigins

必要な場合 CorsRule 要素が存在します。 CORS または "*" を使用して許可される元のドメインのコンマ区切りのリストです ("*" はすべてのドメインを許可します)。 元のドメインは 64 個までに限定されています。 許可される元のドメインのそれぞれは、最大 256 文字で指定できます。

ExposedHeaders

必要な場合 CorsRule 要素が存在します。 CORS クライアントに公開されている応答ヘッダーのコンマ区切りのリストです。 定義済みのヘッダーは 64 個まで、プレフィックスが指定されたヘッダーは 2 個までに制限されています。 各ヘッダーは最大 256 文字で指定できます。

MaxAgeInSeconds

必要な場合 CorsRule 要素が存在します。 クライアント/ブラウザーがプレフライト応答をキャッシュする秒数。

AllowedHeaders

必要な場合 CorsRule 要素が存在します。 クロス オリジン要求の一部として許可されるヘッダーのコンマ区切りのリストです。 定義済みのヘッダーは 64 個まで、プレフィックスが指定されたヘッダーは 2 個までに制限されています。 各ヘッダーは最大 256 文字で指定できます。

AllowedMethods

必要な場合 CorsRule 要素が存在します。 元のドメインによる実行が許可される HTTP メソッドのコンマ区切りのリストです。 Azure Storage の場合、許可されているメソッドには、DELETE、GET、HEAD、MERGE、POST、OPTIONS、PUT があります。

応答には、HTTP ステータス コードと一連の応答ヘッダーが含まれます。

操作が正常に終了すると、ステータス コード 202 (Accepted) が返されます。

状態コードについては、次を参照してください。 サービス管理のステータス コードとエラー コードです。

この操作の応答には、次のヘッダーが含まれています。 追加の標準 HTTP ヘッダーが応答に含まれていることもあります。 すべての標準ヘッダーに準拠している、 http/1.1 プロトコル仕様です。

応答ヘッダー

description

x-ms-request-id

サービスに対して行われた要求を一意に識別する値。

x-ms-version

要求に対して使用される操作のバージョンを指定します。 詳細については、次を参照してください。 Azure ストレージ サービスのバージョン管理です。

ありません。

この操作を呼び出すことができるのはアカウント所有者のみです。

次の制約事項と制限事項は、Azure Storage の CORS ルールに適用されます。

  • 最大 5 つのルールを格納できます。

  • 要求で設定されているすべての CORS ルールの最大サイズ (XML タグを除く) は、2 KB を超えることはできません。

  • 許可されるヘッダー、公開されるヘッダー、許可される元のドメインの長さは、256 文字を超えることはできません。

  • 許可されるヘッダーと公開されるヘッダーとして、次のいずれかを使用できます。

    • ここで、正確なヘッダー名を指定などのリテラル ヘッダー x-ms-meta-processedです。 最大 64 個のリテラル ヘッダーを要求で指定できます。

    • 場所ヘッダーのプレフィックスはなどの指定のヘッダーをプレフィックスとして付加 x-ms-meta-data*です。 このような方法でプレフィックスを指定した場合は、指定のプレフィックスで始まるすべてのヘッダーが許可または公開されます。 最大 2 個のプレフィックスが指定されたヘッダーを要求で指定できます。

  • 指定されたメソッド (または HTTP 動詞)、 AllowedMethods 要素は、Azure ストレージ サービス Api でサポートされるメソッドに準拠している必要があります。 サポートされるメソッドは、DELETE、GET、HEAD、MERGE、POST、OPTIONS、PUT です。

要求での CORS ルールの指定は、省略できます。 呼び出す場合 Set Queue Service Properties を指定せず、 Cors 要素では、要求本文では、既存の CORS ルールが保持されます。

CORS を無効にするには、呼び出す Set Queue Service Properties 、空の CORS ルール設定 (など </Cors>) や内部の CORS ルールはありません。  この呼び出しによって、既存のルールが削除され、キュー サービスの CORS が無効になります。

すべての CORS ルール要素は必要な場合、 CorsRule 要素が指定されています。 エラー コード 400 で要求は失敗します (Bad Request) の任意の要素が見つからない場合。

バージョン 2013-08-15 以降では、XML 設定要素は省略できます。そのため、特定の要素の更新は、更新済みの要素のみを含む XML を送信することによって実行できます。その他の設定は影響を受けません。

CORS ルールと評価ロジックの詳細については、次を参照してください。 共有 (CORS) のサポート、Azure のストレージ サービスのクロス オリジン リソースです。

次のサンプル URI がという名前の架空のストレージ アカウントのキュー サービス プロパティを変更する要求を行う myaccount:

PUT https://myaccount.queue.core.windows.net/?restype=service&comp=properties HTTP/1.1

要求は次のヘッダーと共に送信されます。

x-ms-version: 2013-08-15 x-ms-date: Wed, 23 Oct 2013 04:28:19 GMT Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE= Host: myaccount.queue.core.windows.net

要求は次の XML 本文と共に送信されます。

<?xml version="1.0" encoding="utf-8"?> <StorageServiceProperties> <Logging> <Version>1.0</Version> <Delete>true</Delete> <Read>false</Read> <Write>true</Write> <RetentionPolicy> <Enabled>true</Enabled> <Days>7</Days> </RetentionPolicy> </Logging> <HourMetrics> <Version>1.0</Version> <Enabled>true</Enabled> <IncludeAPIs>false</IncludeAPIs> <RetentionPolicy> <Enabled>true</Enabled> <Days>7</Days> </RetentionPolicy> </HourMetrics> <MinuteMetrics> <Version>version-number</Version> <Enabled>true|false</Enabled> <IncludeAPIs>true|false</IncludeAPIs> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </MinuteMetrics> <Cors> <CorsRule> <AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins> <AllowedMethods>GET,PUT</AllowedMethods> <MaxAgeInSeconds>500</MaxAgeInSeconds> <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders> <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders> </CorsRule> </Cors> </StorageServiceProperties>


要求が送信された後、次の応答が返されます。

HTTP/1.1 202 Accepted Connection: Keep-Alive Transfer-Encoding: chunked Date: Wed, 23 Oct 2013 04:28:20 GMT Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30 x-ms-version: 2013-08-15

表示:
© 2016 Microsoft