取得表格服務屬性

Get Table Service Properties 作業會取得 Azure 資料表儲存體帳戶的屬性,包括儲存體分析和跨原始來源資源分享的屬性, (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 參數

URI 參數 描述
restype=service&comp=properties 必要。 需要這兩個查詢字串,才能取得資料表儲存體屬性。
timeout 選擇性。 timeout 參數以秒為單位。

要求標頭

下表說明必要的和選擇性要求標頭:

要求標頭 描述
Authorization 必要。 指定授權配置、儲存體帳戶名稱和簽章。 如需詳細資訊,請參閱授權對 Azure 儲存體提出要求
Datex-ms-date 必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊,請參閱授權對 Azure 儲存體提出要求
x-ms-version 所有已授權要求都需要。 指定用於這個要求的作業版本。 如需詳細資訊,請參閱 Azure 儲存體服務的版本
x-ms-client-request-id 選擇性。 提供用戶端產生的不透明值,其中包含設定記錄時記錄在儲存體分析記錄中的 1 kibibyte (KiB) 字元限制。 強烈建議您使用此標頭,將用戶端活動與伺服器接收的要求相互關聯。 如需詳細資訊,請參閱 監視 Azure 資料表儲存體

要求本文

無。

回應

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

回應標頭

這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格

回應標頭 描述
x-ms-request-id 可唯一識別針對服務提出的要求。
x-ms-version 指定用於回應的作業版本。 如需詳細資訊,請參閱 Azure 儲存體服務的版本
x-ms-client-request-id 可用來針對要求及其對應的回應進行疑難排解。 如果此標頭存在於要求中,且值包含不超過 1,024 個可見的 ASCII 字元,則此標頭的值等於 標頭的值 x-ms-client-request-idx-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-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-separated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>  
  

下表描述回應主體的元素:

元素 Description
Logging 將儲存體分析記錄設定分組。
計量 將儲存體分析計量設定分組計量設定會提供要求統計資料的摘要,依 API 以每小時匯總的資料表分組。
HourMetrics 將儲存體分析HourMetrics設定分組。 HourMetrics設定會提供要求統計資料的摘要,依 API 依資料表的每小時匯總分組。
MinuteMetrics 將儲存體分析MinuteMetrics設定分組。 MinuteMetrics 設定提供表格每一分鐘的要求統計資料。
版本 目前使用中的儲存體分析版本。
刪除 僅適用于記錄組態。 指出是否會記錄刪除要求。
讀取 僅適用于記錄組態。 指出是否會記錄讀取要求。
寫入 僅適用于記錄組態。 指出是否會記錄寫入要求。
Enabled 指出資料表儲存體是否啟用計量。

如果啟用了讀取權限的地理備援複寫,將會一併收集主要和次要度量。 如果未啟用讀取權限異地備援複寫,則只會收集主要計量。
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的虛構儲存體帳戶資料表儲存體屬性:

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 Analytics
Azure 儲存體服務的 CORS 支援
CORS HTTP 規格