取得帳戶資訊

發行項
02/03/2024

作業 Get Account Information 會傳回指定帳戶的 SKU 名稱和帳戶種類。它適用於 2018-03-28 版和更新版本的服務。

要求

您可以使用透過共用密鑰或共用存取簽章授權的有效要求， (SAS) 授權來建構 Get Account Information 要求。

如果您加入 restype 的值 account 和 comp 的值 properties，要求將會使用 Get Account Information 作業。下表顯示範例：

方法	要求 URI	HTTP 版本
`GET/HEAD`	`https://myaccount.blob.core.windows.net/?restype=account&comp=properties`	HTTP/1.1
`GET/HEAD`	`https://myaccount.blob.core.windows.net/?restype=account&comp=properties&sv=myvalidsastoken`	HTTP/1.1
`GET/HEAD`	`https://myaccount.blob.core.windows.net/mycontainer/?restype=account&comp=properties&sv=myvalidsastoken`	HTTP/1.1
`GET/HEAD`	`https://myaccount.blob.core.windows.net/mycontainer/myblob?restype=account&comp=properties&sv=myvalidsastoken`	HTTP/1.1

URI 參數

您可以在要求 URI 上指定下列其他參數：

參數	描述
`restype`	必要。參數 `restype` 值必須是 `account`。
`comp`	必要。參數 `comp` 值必須是 `properties`。

要求標頭

下表描述必要和選擇性的要求標頭：

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

要求本文

無。

回應

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

狀態碼

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

如需狀態代碼的相關信息，請參閱狀態和錯誤碼。

回應標頭

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

回應標頭	描述
`x-ms-request-id`	可唯一識別所提出的要求。您可以使用它對要求進行疑難解答。如需詳細資訊，請參閱針對 API 作業進行疑難解答。
`x-ms-version`	版本 2009-09-19 和更新版本。指出用來執行要求的 Azure Blob 儲存體版本。
`Date`	UTC 日期/時間值，指出服務傳送響應的時間。
`Content-Length`	指定要求主體的長度。針對此作業，內容長度一律為零。
`x-ms-sku-name`	識別指定帳戶的 SKU 名稱。
`x-ms-account-kind`	識別指定帳戶的帳戶種類。可能的值為：`Storage`、`BlobStorage`和 `StorageV2`。標頭會使用 GPv2 帳戶的子字串`V2`，區分常規用途 v1 (GPv1) 和常規用途 v2 (GPv2) 儲存器帳戶。
`x-ms-client-request-id`	可用來針對要求和對應的回應進行疑難解答。如果此標頭存在於要求中，此標頭的值等於標頭的值 `x-ms-client-request-id` ，且此值最多為 1,024 個可見的 ASCII 字元。 `x-ms-client-request-id`如果要求中沒有標頭，則回應中不會顯示此標頭。
`x-ms-is-hns-enabled`	版本 2019-07-07 和更新版本。指出帳戶是否已啟用階層命名空間。

回應本文

無。

範例回應

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Date: Sat, 28 Mar 2018 12:43:08 GMT  
x-ms-version: 2018-03-28  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0  
x-ms-sku-name: Standard_LRS  
x-ms-account-kind: StorageV2

授權

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

這項作業不支援透過來自 Azure Active Directory/MSI 或使用者委派 SAS 的存取令牌進行 OAuth 型授權。

共用存取簽章 (SAS)
共用金鑰

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

此 Get Account Information 作業支援使用帳戶 SAS 或服務 SAS 進行授權，且至少具有一個可用許可權。

帳戶 SAS

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

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

服務 SAS

服務 SAS 會使用儲存體帳戶金鑰加以保護。服務 SAS 會將存取權委派給單一 Azure 記憶體服務中的資源，例如 Blob 記憶體。

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

若要深入瞭解服務 SAS，請參閱建立服務 SAS。

備註

要求的 URL 路徑不會影響這項作業提供的資訊。其用途是允許要求使用指定允許資源的SAS令牌正確授權。

指定的資源不需要存在，此作業才能成功。例如，以不存在 Blob 產生的 SAS 令牌，且有效許可權會成功，且 URL 路徑包含正確的帳戶名稱、正確的容器名稱，以及不存在的 Blob 名稱。

計費

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

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

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