取得 Blob 服務屬性
摺疊目錄
展開目錄
本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

取得 Blob 服務屬性

 

Get Blob Service Properties 作業可取得包含屬性的儲存體帳戶的 Blob 服務屬性 儲存體分析 和 CORS (跨原始資源共用) 規則。

如需 CORS 規則和評估邏輯的詳細資訊,請參閱 跨原始資源共用 (CORS) 支援 Azure 儲存體服務

Get Blob Service Properties 要求可能會以下面方式指定。 建議使用 HTTPS。 取代 <account-name> 的儲存體帳戶名稱:

方法

要求 URI

HTTP 版本

GET

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

HTTP/1.1

請注意,URI 一律需包含正斜線 (/),將主機名稱與 URI 的路徑和查詢部分隔開。 若為這項作業,URI 的路徑部分為空白。

URI 參數

說明

restype=service&comp=properties

必要項。 若要取得儲存體服務屬性,需要兩個查詢字串的組合。

timeout

選擇項。 timeout 參數以秒為單位。 如需詳細資訊,請參閱 設定 Blob 服務作業的逾時值

下表描述必要的和選用的要求標頭。

要求標頭

說明

Authorization

必要項。 指定驗證配置、儲存體帳戶名稱及簽章。 如需詳細資訊,請參閱 Azure 儲存體服務的驗證

Datex-ms-date

必要項。 指定要求的國際標準時間 (UTC)。 如需詳細資訊,請參閱 Azure 儲存體服務的驗證

x-ms-version

所有已驗證要求的必要項。 指定用於這個要求的作業版本。 如需詳細資訊,請參閱 Azure 儲存體服務版本控制

x-ms-client-request-id

選擇項。 提供啟用儲存體分析記錄時,由用戶端產生的不透明值,而且在分析記錄中記錄 1 KB 的字元限制。 要將用戶端活動與伺服器收到的要求產生關聯時,極力建議您使用這個標頭。 如需詳細資訊,請參閱 關於儲存體分析記錄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> <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </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> <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </StorageServiceProperties>

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

元素名稱

說明

記錄

將 Azure 分析 記錄 設定。

度量

將 Azure 分析 Metrics 設定。 度量 設定提供依應用程式開發介面分組對 blob 進行每小時彙總的要求統計資料的摘要。

HourMetrics

將 Azure 分析 HourMetrics 設定。 HourMetrics 設定提供依應用程式開發介面分組對 blob 進行每小時彙總的要求統計資料的摘要。

MinuteMetrics

將 Azure 分析 MinuteMetrics 設定。 MinuteMetrics 設定提供 blob 每一分鐘的要求統計資料。

Version

目前使用中的儲存體分析版本。

Delete

只適用於記錄組態。 指出是否會記錄刪除要求。

Read

只適用於記錄組態。 指出是否會記錄讀取要求。

Write

只適用於記錄組態。 指出是否會記錄寫入要求。

Enabled

指出 Blob 服務是否已啟用度量。

如果啟用了讀取權限的地理備援複寫,將會一併收集主要和次要度量。 如果未啟用讀取權限的地理備援複寫,只會收集主要度量。

IncludeAPIs

只適用於度量組態。 指出度量是否會產生所呼叫之 API 作業的摘要統計資料。

RetentionPolicy/Enabled

指出是否已啟用儲存體服務的保留原則。

RetentionPolicy/Days

指出度量或記錄資料的保留天數。 比此值更早的所有資料將會遭到刪除。

DefaultServiceVersion

DefaultServiceVersion 指出要使用 Blob 服務的要求未指定連入要求的版本的預設版本。 其值包含 2008-10-27 版及更新版本。 如需適用版本的詳細資訊,請參閱 Azure 儲存體服務版本控制

Cors

將所有 CORS 規則分組。

CorsRule

將 CORS 規則的設定分組。

AllowedOrigins

透過 CORS 所允許的原始網域以逗號分隔的清單,或 "*" 表示將允許所有網域。

ExposedHeaders

向 CORS 用戶端公開的回應標頭以逗號分隔的清單。

MaxAgeInSeconds

用戶端/瀏覽器應該快取預檢回應的秒數。

AllowedHeaders

允許併入跨原始要求的標頭以逗號分隔的清單。

AllowedMethods

允許由原始網域執行的 HTTP 方法以逗號分隔的清單。 就 Azure 儲存體而言,允許的方法為 DELETE、GET、HEAD、MERGE、POST、OPTIONS 或 PUT。

只有儲存體帳戶擁有者可以呼叫此作業。

下列範例 URI 會要求取得虛構儲存體帳戶的 Blob 服務屬性 myaccount:

GET https://myaccount.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

所傳送的要求包含下列標頭:

x-ms-version: 2013-08-15 x-ms-date: Wed, 23 Oct 2013 04:28:19 GMT Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE= Host: myaccount.blob.core.windows.net

傳送要求之後,會傳回下列回應:

HTTP/1.1 200 OK Content-Length: 1020 Content-Type: application/xml Date: Wed, 23 Oct 2013 04:28:20 GMT Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30 x-ms-version: 2013-08-15

回應包含下列 XML 主體:

<?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> <DefaultServiceVersion>2013-08-15</DefaultServiceVersion> </StorageServiceProperties>

顯示:
© 2016 Microsoft