Get Queue Service Stats
この操作では Get Queue Service Stats
、Azure Queue Storage のレプリケーションに関連する統計を取得します。 ストレージ アカウントに対して読み取りアクセス geo 冗長レプリケーションが有効になっている場合は、セカンダリ ロケーション エンドポイントでのみ使用できます。
要求
Get Queue Service Stats
要求の構成は次のとおりです。 HTTPS を使用することをお勧めします。
myaccount をストレージ アカウントの名前に置き換え、-secondary サフィックスが必要であることに注意してください。
Method | 要求 URI | HTTP バージョン |
---|---|---|
GET | https://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats |
HTTP/1.1 |
注意
URI のパスとクエリ部分からホスト名を分離するには、URI には常にスラッシュ文字 (/) を含める必要があります。 この操作では、URI のパス部分が空です。
URI パラメーター
要求 URI には、次の追加パラメーターを指定できます。
パラメーター | 説明 |
---|---|
Timeout |
省略可能。
timeout パラメーターは、秒単位で表されます。 |
要求ヘッダー
必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。
要求ヘッダー | 説明 |
---|---|
Authorization |
必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。 |
Date or x-ms-date |
必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。 |
x-ms-version |
すべての承認された要求に必要です。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。 |
x-ms-client-request-id |
省略可能。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。 詳細については、「 Azure Queue Storage の監視」を参照してください。 |
要求本文
なし。
[応答]
応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。
状態コード
操作に成功すると、状態コード 200 (OK) が返されます。 セカンダリの読み取りが有効になっていないセカンダリ ロケーション エンドポイントで呼び出されると、HTTP 状態コード 403 (アカウントのアクセス許可が不十分) が返されます。
応答ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答には追加の標準 HTTP ヘッダーも含まれます。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。
応答ヘッダー | 説明 |
---|---|
x-ms-request-id |
作成された要求を一意に識別し、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。 |
x-ms-version |
応答に使用された操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。 |
Date |
サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。 |
x-ms-client-request-id |
このヘッダーは、要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、その値に 1,024 文字以下の ASCII 文字が含まれている場合、ヘッダーの値 x-ms-client-request-id と等しくなります。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、応答には存在しません。 |
応答本文
応答本文の形式は次のとおりです。
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live|bootstrap|unavailable</Status>
<LastSyncTime>sync-time|<empty></LastSyncTime>
</GeoReplication>
</StorageServiceStats>
応答本文の要素を次の表に示します。
応答ヘッダー | 説明 |
---|---|
Status |
2 次拠点の状態。 次のいずれかの値になります。 - live: セカンダリの場所がアクティブで操作可能であることを示します。 - bootstrap: プライマリの場所からセカンダリの場所への初期同期が進行中であることを示します。 これは通常、レプリケーションが最初に有効になったときに発生します。 - unavailable: セカンダリの場所が一時的に使用できないことを示します。 |
LastSyncTime |
UTC の日付/時刻値 (秒単位)。 この値の前にあるすべてのプライマリ書き込みは、セカンダリ書き込み時の読み取り操作で使用できる必要があります。 この時点以降のプライマリ書き込みでは、読み取りに使用できる場合と使用できない場合があります。 が使用できない場合は、値が空になる可能性 LastSyncTime があります。 これは、レプリケーションの状態が ブートストラップ であるか 、使用できない場合に発生する可能性があります。geo レプリケーションは継続的に有効になっていますが、結果には、 LastSyncTime 数分ごとに更新されるサービスからのキャッシュされた値が反映される場合があります。 |
承認
この操作を呼び出すことができるのはアカウント所有者のみです。
注釈
geo 冗長レプリケーションを使用すると、Azure Storage は 2 つの場所でデータを永続的に維持します。 両方の場所で、Azure ストレージは継続的にデータの複数の正常なレプリカを維持します。
データの読み取り、作成、更新、または削除を行う場所は、1 次ストレージ アカウント拠点です。 プライマリの場所は、Azure Management Azure クラシック ポータル ( 米国中北部など) を使用してアカウントを作成するときに選択したリージョンに存在します。
データのレプリケート先の場所が、2 次拠点です。 セカンダリの場所は、プライマリ リージョンと地理的に自動的にペアになったリージョンに存在します。 読み取りアクセスの地理冗長レプリケーションがストレージ アカウントで有効な場合は、2 次拠点から読み取り専用アクセスを使用できます。
読み取りアクセス geo 冗長レプリケーションの詳細については、「 データ冗長」を参照してください。
セカンダリ エンドポイントに対する読み取り操作の要求を作成するには、Queue Storage からの読み取りに使用する URI のアカウント名にサフィックスとしてを追加 -secondary
します。 たとえば、 メッセージのピーク 操作のセカンダリ URI は と https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true
似ています。
要求と応答の例
以下に、Get Queue Service Stats
操作の要求の例を示します。
GET http://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1
要求は次のヘッダーと共に送信されます。
x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=
ステータス コードと応答ヘッダーは次のように返されます。
HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 23 Oct 2013 22:08:54 GMT
x-ms-version: 2013-08-15
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
応答には、次の XML 本文が含まれます。
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live</Status>
<LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>
</GeoReplication>
</StorageServiceStats>