エクスポート (0) 印刷
すべて展開

Get Table Service Properties

更新日: 2013年12月

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

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

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

 

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

GET

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

HTTP/1.1

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

 

URI パラメーター 説明

restype=service&comp=properties

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

timeout

省略可能。timeout パラメーターは、秒単位で表されます。

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

 

要求ヘッダー 説明

Authorization

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

Date またはx-ms-date

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

x-ms-version

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

x-ms-client-request-id

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

なし。

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

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

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

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

 

応答ヘッダー 説明

x-ms-request-id

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

x-ms-version

要求に対して使用される操作のバージョンを指定します。詳細については、「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>

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

 

要素名 説明

ログ記録

Windows Azure の Analytics の Logging 設定をグループ化します。

Metrics

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

HourMetrics

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

MinuteMetrics

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

Version

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

削除

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

Read

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

Write

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

有効

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

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

IncludeAPIs

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

RetentionPolicy/Enabled

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

RetentionPolicy/Days

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

Cors

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

CorsRule

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

AllowedOrigins

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

ExposedHeaders

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

MaxAgeInSeconds

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

AllowedHeaders

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

AllowedMethods

元のドメインによる実行が許可される HTTP メソッドのコンマ区切りのリストです。Windows Azure のストレージの場合、許可されているメソッドには、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>

関連項目

表示:
© 2014 Microsoft