Get Table Service Properties

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

cors ルールと評価ロジックの詳細については、「 Storage サービスの cors のサポート」を参照してください。

Request

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

Method 要求 URI HTTP バージョン
GET https://<account-name>.table.core.windows.net/?restype=service&comp=properties HTTP/1.1

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

URI パラメーター

URI パラメーター 説明
restype=service&comp=properties 必須。 テーブル サービス プロパティを取得するには、両方のクエリ文字列を組み合わせる必要があります。
timeout 任意。 timeout パラメーターは、秒単位で表されます。

要求ヘッダー

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

要求ヘッダー 説明
Authorization 必須。 認証スキーム、ストレージアカウント名、および署名を指定します。 詳細については、「 Azure Storage 要求を承認する」を参照してください。
Date または x-ms-date 必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「 Azure Storage 要求を承認する」を参照してください。
x-ms-version すべての承認された要求に必須です。 この要求に使用する操作のバージョンを指定します。 詳細については、「 Azure Storage サービスのバージョン管理」を参照してください。
x-ms-client-request-id 任意。 ストレージ分析ログが有効になっている場合に analytics ログに記録される、クライアントによって生成される非透過の値を 1 KiB 文字の制限付きで提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付けるには、このヘッダーを使用することが強く推奨されます。 詳細については、「 Storage Analytics のログ記録Azure Logging: ログを使用した Storage 要求の追跡」を参照してください。

要求本文

[なし] :

Response

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

状態コード

操作に成功すると、状態コード 200 (OK) が返されます。

レスポンス ヘッダー

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

応答ヘッダー 説明
x-ms-request-id サービスに対して行われた要求を一意に識別する値。
x-ms-version 要求に対して使用される操作のバージョンを指定します。 詳細については、「 Azure Storage サービスのバージョン管理」を参照してください。
x-ms-client-request-id このヘッダーを使用して、要求および対応する応答のトラブルシューティングを行うことができます。 このヘッダーの値は、要求内に存在する場合はヘッダーの値と同じで、 x-ms-client-request-id 値は最大で1024の表示可能な ASCII 文字になります。 x-ms-client-request-idヘッダーが要求内に存在しない場合、このヘッダーは応答に存在しません。

応答本文

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

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

要素名 説明
Logging Azure Analytics の Logging 設定をグループ化します。
メトリック Azure Analytics の メトリック の設定をグループ化します。 Metrics 設定によって、テーブルの 1 時間ごとの集計で API 別にグループ化された要求の統計に関する概要が示されます。
HourMetrics Azure Analytics の HourMetrics 設定をグループ化します。 HourMetrics 設定によって、テーブルの 1 時間ごとの集計で API 別にグループ化された要求の統計に関する概要が示されます。
MinuteMetrics Azure Analytics の MinuteMetrics 設定をグループ化します。 MinuteMetrics 設定によって、テーブルの分単位の要求の統計が示されます。
[バージョン] 現在使用中の Storage Analytics のバージョン。
削除 ログ構成にのみ適用されます。 削除要求をログに記録するかどうかを示します。
読み取り ログ構成にのみ適用されます。 読み取り要求をログに記録するかどうかを示します。
書き込み ログ構成にのみ適用されます。 書き込み要求をログに記録するかどうかを示します。
Enabled テーブル サービスに対してメトリックが有効であるかどうかを示します。

読み取りアクセスの地理冗長レプリケーションが有効である場合、プライマリ メトリックとセカンダリ メトリックの両方が収集されます。 読み取りアクセスの地理冗長レプリケーションが有効でない場合、プライマリ メトリックだけが収集されます。
IncludeAPIs メトリック構成にのみ適用されます。 メトリックで、呼び出された API 操作の概要統計情報を生成するかどうかを示します。
RetentionPolicy/Enabled ストレージ サービスに対して保持ポリシーが有効であるかどうかを示します。
RetentionPolicy/Days メトリックまたはログ データを保持する日数を示します。 この値より古いデータは、すべて削除されます。
Cors すべての CORS ルールをグループ化します。
CorsRule CORS ルールの設定をグループ化します。
AllowedOrigins CORS または "" を使用して許可される元のドメインのコンマ区切りのリストです ("" はすべてのドメインを許可します)。
ExposedHeaders CORS クライアントに公開されている応答ヘッダーのコンマ区切りのリストです。
MaxAgeInSeconds クライアント/ブラウザーがプレフライト応答をキャッシュする秒数。
AllowedHeaders クロス オリジン要求の一部として許可されるヘッダーのコンマ区切りのリストです。
AllowedMethods 元のドメインによる実行が許可される HTTP メソッドのコンマ区切りのリストです。 Azure Storage の場合、許可されているメソッドには、DELETE、GET、HEAD、MERGE、POST、OPTIONS、PUT があります。

承認

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

要求と応答の例

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

GET https://myaccount.table.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.table.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-Table/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>  

関連項目

Storageアナリティクス
Storage サービスの CORS サポート
CORS HTTP の仕様