アカウント情報を取得する
操作は Get Account Information
、指定されたアカウントの SKU 名とアカウントの種類を返します。 これは、バージョン 2018-03-28 以降のバージョンのサービスで使用できます。
要求
共有キーまたは共有アクセス署名 (SAS) 承認によって承認された有効な要求を使用して、要求を構築 Get Account Information
できます。
の値と の値をrestype
追加すると、comp
要求で 操作がGet Account Information
使用properties
されます。account
次の表に例を示します。
Method | 要求 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 Storage への要求を承認する」をご覧ください。 |
Date or x-ms-date |
必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。 |
x-ms-version |
すべての承認された要求に必要です。 この要求に使用する操作のバージョンを指定します。 この操作の場合、バージョンは 2018-03-28 以降である必要があります。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。 |
x-ms-client-request-id |
省略可能。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。 |
要求本文
[なし] :
Response
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。
status code
操作に成功すると、状態コード 200 (OK) が返されます。
状態コードの詳細については、「 状態とエラー コード」を参照してください。
応答ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーも含まれる場合があります。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。
応答ヘッダー | 説明 |
---|---|
x-ms-request-id |
行われた要求を一意に識別します。 これを使用して、要求のトラブルシューティングを行うことができます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。 |
x-ms-version |
バージョン 2009-09-19 以降。 要求の実行に使用されるAzure Blob Storageのバージョンを示します。 |
Date |
サービスが応答を送信した時刻を示す UTC 日付/時刻値。 |
Content-Length |
要求本文の長さを指定します。 この操作では、コンテンツの長さは常に 0 になります。 |
x-ms-sku-name |
指定したアカウントの SKU 名 を識別します。 |
x-ms-account-kind |
指定した アカウントのアカウントの種類 を識別します。 設定可能な値は Storage 、BlobStorage 、StorageV2 です。 ヘッダーは、GPv2 アカウントの部分文字列V2 を使用して、General Purpose v1 (GPv1) と General Purpose 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 Storage でデータ アクセス操作を呼び出す場合は、承認が必要です。 操作は、以下で Get Account Information
説明するように承認できます。
この操作では、Azure Active Directory/MSI からのアクセス トークンまたはユーザー委任 SAS を介した OAuth ベースの承認はサポートされていません。
注釈
要求の URL パスは、この操作によって提供される情報には影響しません。 その目的は、許可されたリソースを指定する SAS トークンを使用して要求を正しく承認できるようにすることです。
この操作を成功させるために、指定されたリソースが存在する必要はありません。 たとえば、存在しない BLOB と有効なアクセス許可で生成された SAS トークンは、正しいアカウント名、正しいコンテナー名、存在しない BLOB の名前を含む URL パスで成功します。
請求
価格要求は、Blob Storage REST API を介して直接、または Azure Storage クライアント ライブラリから Blob Storage API を使用するクライアントから送信できます。 これらの要求では、トランザクションあたりの料金が発生します。 トランザクションの種類は、アカウントの課金方法に影響します。 たとえば、読み取りトランザクションは、書き込みトランザクションとは異なる課金カテゴリに計上されます。 次の表は、ストレージ アカウントの種類に基づく要求の課金カテゴリ Get Account Information
を示しています。
操作 | ストレージ アカウントの種類 | 課金カテゴリ |
---|---|---|
アカウント情報を取得する | Premium ブロック BLOB Standard 汎用 v2 |
その他の操作 |
アカウント情報を取得する | Standard 汎用 v1 | 操作を読み取ります。 |
指定した課金カテゴリの価格については、「Azure Blob Storage価格」を参照してください。