Table Service の統計情報を取得する
この操作では Get Table Service Stats
、Azure Table Storage のレプリケーションに関連する統計が取得されます。 ストレージ アカウントに対して読み取りアクセス geo 冗長レプリケーションが有効になっている場合は、セカンダリ ロケーション エンドポイントでのみ使用できます。
要求
Get Table Service Stats
要求の構成は次のとおりです。 HTTPS を使用することをお勧めします。
myaccount をストレージ アカウントの名前に置き換え、-secondary サフィックスが必要であることに注意してください。
Method | 要求 URI | HTTP バージョン |
---|---|---|
GET | https://myaccount-secondary.table.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 Table 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 |
要求とそれに対応する応答のトラブルシューティングに使用できます。 このヘッダーの値 x-ms-client-request-id は、要求に存在し、値に 1,024 文字以下の ASCII 文字が含まれている場合、ヘッダーの値と同じです。 ヘッダーが 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 |
2 番目の UTC 日付/時刻値。 この値より前のすべてのプライマリ書き込みでは、セカンダリ書き込み時の読み取り操作が可能であることが保証されます。 この時点以降のプライマリ書き込みでは、読み取りに使用できる場合と使用できない場合があります。 が使用できない場合は、値が空である可能性 LastSyncTime があります。 これは、レプリケーションの状態が ブートストラップ または 使用できない場合に発生する可能性があります。geo レプリケーションは継続的に有効になっていますが、 LastSyncTime 結果には、数分ごとに更新されるサービスからのキャッシュされた値が反映される場合があります。 |
承認
この操作を呼び出すことができるのはアカウント所有者のみです。
注釈
geo 冗長レプリケーションを使用すると、Azure Storage はデータを 2 つの場所に永続的に保持します。 どちらの場所でも、Azure Storage はデータの複数の正常なレプリカを常に維持します。
データの読み取り、作成、更新、または削除を行う場所は、1 次ストレージ アカウント拠点です。 プライマリの場所は、Azure Management Azure クラシック ポータル ( 米国中北部など) を使用してアカウントを作成するときに選択したリージョンに存在します。
データのレプリケート先の場所が、2 次拠点です。 セカンダリの場所は、プライマリ リージョンと自動的に地理的にペアになったリージョンに存在します。 読み取りアクセスの地理冗長レプリケーションがストレージ アカウントで有効な場合は、2 次拠点から読み取り専用アクセスを使用できます。
読み取りアクセス geo 冗長レプリケーションの詳細については、「 データの冗長性」を参照してください。
セカンダリ エンドポイントに対する読み取り操作の要求を作成するには、Table Storage からの読み取りに使用する URI のアカウント名に -secondary を追加します。 たとえば、 クエリ エンティティ 操作のセカンダリ URI は と似ています https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>')
。
要求と応答の例
以下に、Get Table Service Stats
操作の要求の例を示します。
GET http://myaccount-secondary.table.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-Table/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>