取得 Blob 服務屬性

發行項
02/07/2024

作業Get Blob Service Properties會取得 Azure Blob 儲存體帳戶的屬性，包括儲存體分析和跨原始來源資源分享的屬性， (CORS) 規則。

如需 CORS 規則和評估邏輯的詳細資訊，請參閱 Azure 記憶體服務的 CORS 支援。

要求

您可以指定 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`	必要。需要這兩個查詢字串的組合，才能取得 Blob 記憶體屬性。
`timeout`	選擇性。 `timeout` 參數以秒為單位。如需詳細資訊，請參閱設定 Blob 記憶體作業的逾時。

要求標頭

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

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

要求本文

無。

回應

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

狀態碼

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

回應標頭

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

回應標頭	描述
`x-ms-request-id`	唯一識別針對服務提出的要求。
`x-ms-version`	指定用於回應的作業版本。如需詳細資訊，請參閱 Azure 儲存體服務的版本。
`x-ms-client-request-id`	可用來針對要求和對應的回應進行疑難解答。如果此標頭存在於要求中，則此標頭的值等於標頭的值 `x-ms-client-request-id` ，且值不包含超過 1,024 個可見的 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>  
    <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-verbs</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>  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>

自 2017-07-29 版起，回應本文的格式如下所示：

  
<?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-verbs</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>  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
    <DeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>number-of-days</Days>
    </DeleteRetentionPolicy>
</StorageServiceProperties>

自 2018-03-28 版起，回應本文的格式如下所示：

<?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-verbs</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>    
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
    <DeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>number-of-days</Days>
    </DeleteRetentionPolicy>
    <StaticWebsite>
        <Enabled>true|false</Enabled>
        <IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
        <ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
    </StaticWebsite>
</StorageServiceProperties>

自 2019-12-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>  
    <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-verbs</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>    
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
    <DeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>number-of-days</Days>
    </DeleteRetentionPolicy>
    <StaticWebsite>
        <Enabled>true|false</Enabled>
        <IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
        <DefaultIndexDocumentPath>absolute-path-of-the-default-index-page</DefaultIndexDocumentPath>
        <ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
    </StaticWebsite>
</StorageServiceProperties>

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

元素名稱	Description
Logging	將 Azure 分析 Logging 設定分組。
計量	群組 Azure Analytics 計量設定。計量設定會提供要求統計數據的摘要，依 API 每小時匯總的 Blob 分組。
HourMetrics	將 Azure 分析 HourMetrics 設定分組。 HourMetrics 設定會提供要求統計數據的摘要，依 API 以 Blob 的每小時匯總分組。
MinuteMetrics	將 Azure 分析 MinuteMetrics 設定分組。 MinuteMetrics 設定提供 Blob 每一分鐘的要求統計資料。
版本	目前使用中的儲存體分析版本。
刪除	只適用於記錄組態。指出是否會記錄刪除要求。
讀取	只適用於記錄組態。指出是否會記錄讀取要求。
寫入	只適用於記錄組態。指出是否會記錄寫入要求。
啟用	指出是否為 Blob 記憶體啟用計量。如果啟用了讀取權限的地理備援複寫，將會一併收集主要和次要度量。如果未啟用讀取許可權異地備援複寫，則只會收集主要計量。
IncludeAPIs	只適用於度量組態。指出度量是否會產生所呼叫之 API 作業的摘要統計資料。
RetentionPolicy/Enabled	指出是否已啟用 Azure 記憶體的保留原則。
RetentionPolicy/Days	指出度量或記錄資料的保留天數。所有早於此值的數據都會遭到刪除。
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。
DeleteRetentionPolicy	群組 Azure 刪除設定。僅適用於 Blob 記憶體。
啟用	指出已刪除的 Blob 或快照集會保留或立即由刪除作業移除。
天	指出應保留已刪除 Blob 的天數。超過此值的所有數據都會永久刪除。
StaticWebsite	群組 staticwebsite 設定。僅適用於 Blob 記憶體。
StaticWebsite/Enabled	指出是否為指定的帳戶啟用 staticwebsite 支援。
StaticWebsite/IndexDocument	Azure 記憶體針對網站或任何子資料夾的要求提供網頁，例如) (`index.html` 。此值區分大小寫。
StaticWebsite/DefaultIndexDocumentPath	Azure 記憶體針對未對應至現有檔案的要求提供之網頁的絕對路徑。頁面的內容會以 `HTTP 200 OK` (傳回，例如) `index.html` 。專案與 `StaticWebsite/IndexDocument`互斥。此值區分大小寫。
StaticWebsite/ErrorDocument404Path	Azure 記憶體針對未對應至現有檔案的要求提供之網頁的絕對路徑。頁面的內容會以 `HTTP 404 Not Found` (傳回，例如) `error/404.html` 。此值區分大小寫。

授權

在 Azure 記憶體中呼叫任何數據存取作業時，需要授權。您可以授權 Get Blob Service Properties 作業，如下所述。

重要

Microsoft 建議搭配受控識別使用 Microsoft Entra ID 來授權對 Azure 記憶體的要求。相較於共用密鑰授權，Microsoft Entra ID 提供更高的安全性和易於使用性。

Azure 記憶體支援使用 Microsoft Entra ID 來授權 Blob 數據的要求。使用 Microsoft Entra ID，您可以使用 Azure 角色型存取控制 (Azure RBAC) 授與安全性主體的許可權。安全性主體可能是使用者、群組、應用程式服務主體或 Azure 受控識別。安全性主體會由 Microsoft Entra ID 驗證，以傳回 OAuth 2.0 令牌。權杖接著可以用來授權對 Blob 服務的要求。

若要深入瞭解使用 Microsoft Entra ID 授權，請參閱使用 Microsoft Entra ID 授權 Blob 的存取權。

權限

以下是 Microsoft Entra 使用者、群組、受控識別或服務主體呼叫Get Blob Service Properties作業所需的 RBAC 動作，以及包含此動作的最低特殊許可權 Azure RBAC 角色：

Azure RBAC action：Microsoft.Storage/storageAccounts/blobServices/read
最低特殊許可權的內建角色：記憶體帳戶參與者

若要深入瞭解如何使用 Azure RBAC 指派角色，請參閱指派 Azure 角色以存取 Blob 數據。

SAS) 共用存取簽章 (提供記憶體帳戶中資源的安全委派存取權。透過 SAS，您可以細微地控制用戶端如何存取數據。您可以指定用戶端可以存取的資源、這些資源的許可權，以及 SAS 的有效時間長度。

此 Get Blob Service Properties 作業支援使用帳戶 SAS 進行授權。

不允許記憶體帳戶存取共用密鑰時，對 Blob 記憶體的要求不允許帳戶 SAS 令牌。若要深入瞭解，請參閱瞭解不允許共用密鑰如何影響 SAS 令牌。

帳戶 SAS

帳戶 SAS 會使用儲存體帳戶金鑰加以保護。帳戶 SAS 則將存取權限委派給一或多個儲存體服務的資源。所有作業皆可透過服務 SAS 或使用者委派 SAS 取得，也可透過帳戶 SAS 取得。

下表指出委派存取權時所要指定的已簽署資源類型和已簽署許可權：

作業	已簽署的服務	已簽署的資源類型	已簽署的許可權
取得 Blob 服務屬性	Blob (b)	服務 (s)	讀取 r ()

若要深入了解帳戶 SAS，請參閱 Create 帳戶 SAS。

備註

無。如需此作業如何影響成本的詳細資訊，請參閱帳單資訊。

計費

定價要求可能源自使用 Blob 記憶體 API 的用戶端，無論是直接透過 Blob 記憶體 REST API，還是來自 Azure 記憶體用戶端連結庫。這些要求會累算每個交易的費用。交易類型會影響帳戶的收費方式。例如，讀取交易會累算到與寫入交易不同的計費類別。下表根據記憶體帳戶類型顯示要求的計費類別 Get Blob Service Properties ：

作業	儲存體帳戶類型	計費類別
取得 Blob 服務屬性	進階區塊 Blob 標準一般用途 v2	其他作業
取得 Blob 服務屬性	標準一般用途 v1	讀取作業

若要瞭解指定計費類別的定價，請參閱 Azure Blob 儲存體定價。

範例要求與回應

下列範例 URI 會提出要求，以取得名為 myaccount 的虛構記憶體帳戶 Blob 記憶體屬性：

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

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

x-ms-version: 2018-03-28
x-ms-date: Tue, 12 Sep 2018 23:38:36 GMT
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.blob.core.windows.net

傳送要求之後，會傳回下列回應：

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2018-03-28
Date: Tue, 12 Sep 2018 23:38:35 GMT

回應包含下列 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>2017-07-29</DefaultServiceVersion>
    <DeleteRetentionPolicy>
        <Enabled>true</Enabled>
        <Days>5</Days>
    </DeleteRetentionPolicy>
    <StaticWebsite>  
        <Enabled>true</Enabled>  
        <IndexDocument>index.html</IndexDocument>  
        <ErrorDocument404Path>error/404.html</ErrorDocument404Path>  
    </StaticWebsite>      
</StorageServiceProperties>

另請參閱

Storage Analytics
Azure 記憶體服務的 CORS 支援
 CORS HTTP 規格

共用方式為