セールス: 1-800-867-1380

Get Queue Service Properties

更新日: 2015年4月

Get Queue Service Properties 操作は、ストレージ アカウントのキュー サービスのプロパティを取得します。このプロパティには、Storage Analytics や CORS (クロス オリジン リソース共有) ルールのプロパティが含まれます。

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

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

 

メソッド 要求 URI HTTP バージョン

GET

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

HTTP/1.1

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

次の追加パラメーターを要求の URI で指定できます。

 

Parameter 説明

restype=service&comp=properties

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

timeout

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

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

 

要求ヘッダー 説明

Authorization

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

Date またはx-ms-date

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

x-ms-version

認証されたすべての要求について必須です。この要求に使用する操作のバージョンを指定します。詳細については、「Windows Azure の BLOB サービス、キュー サービス、およびテーブル サービスのバージョン管理」を参照してください。

x-ms-client-request-id

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

ありません。

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

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

ステータス コードの詳細については、「サービス管理のステータス コードとエラー コード」を参照してください。

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

 

応答ヘッダー 説明

x-ms-request-id

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

x-ms-version

要求に対して使用される操作のバージョンを指定します。詳細については、「Windows Azure の BLOB サービス、キュー サービス、およびテーブル サービスのバージョン管理」を参照してください。

バージョン 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> 

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

 

要素名 説明

ログ記録

Azure Analytics の ログ記録 設定をグループ化します。

Metrics

Azure Analytics の Metrics 設定をグループ化します。 Metrics 設定によって、キューの 1 時間ごとの集計で API 別にグループ化された要求の統計に関する概要が示されます。

HourMetrics

Azure Analytics の HourMetrics 設定をグループ化します。 HourMetrics 設定によって、キューの 1 時間ごとの集計で API 別にグループ化された要求の統計に関する概要が示されます。

MinuteMetrics

Azure Analytics の MinuteMetrics 設定をグループ化します。 MinuteMetrics 設定によって、キューの分単位の要求の統計が示されます。

Version

現在使用中の Storage Analytics のバージョン。

削除

ログ構成にのみ適用されます。削除要求をログに記録するかどうかを示します。

読み取り

ログ構成にのみ適用されます。読み取り要求をログに記録するかどうかを示します。

書き込み

ログ構成にのみ適用されます。書き込み要求をログに記録するかどうかを示します。

有効

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

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

IncludeAPIs

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

RetentionPolicy/Enabled

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

RetentionPolicy/Days

メトリックまたはログ データを保持する日数を示します。この値より古いデータは、すべて削除されます。

Cors

すべての CORS ルールをグループ化します。

CorsRule

CORS ルールの設定をグループ化します。

AllowedOrigins

CORS または "*" を使用して許可される元のドメインのコンマ区切りのリストです ("*" はすべてのドメインを許可します)。

ExposedHeaders

CORS クライアントに公開されている応答ヘッダーのコンマ区切りのリストです。

MaxAgeInSeconds

クライアント/ブラウザーがプレフライト応答をキャッシュする秒数。

AllowedHeaders

クロス オリジン要求の一部として許可されるヘッダーのコンマ区切りのリストです。

AllowedMethods

元のドメインによる実行が許可される HTTP メソッドのコンマ区切りのリストです。Azure ストレージの場合、許可されているメソッドには、DELETE、GET、HEAD、MERGE、POST、OPTIONS、PUT があります。

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

次の URI の例では、架空のストレージ アカウント名 myaccount のキュー サービス プロパティを取得するように要求します。myaccount:

GET 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:49:03 GMT Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE= Host: myaccount.queue.core.windows.net

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

HTTP/1.1 200 OK Content-Length: 1020 Content-Type: application/xml Date: Wed, 23 Oct 2013 04:49:04 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 

応答本文は次のようになります。

<?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>1.0</Version>         <Enabled>true</Enabled>         <IncludeAPIs>true</IncludeAPIs>         <RetentionPolicy>             <Enabled>true</Enabled>             <Days>7</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>

関連項目

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2015 Microsoft