アカウント情報の取得
Get Account Information 操作は、指定されたアカウントの SKU 名とアカウントの種類を返します。 バージョン 2018-03-28 以降のバージョンのサービスで使用できます。
依頼
共有キーまたは Shared Access Signature (SAS) 承認によって承認された有効な要求を使用して、Get Account Information 要求を作成できます。
account の restype 値と propertiesの comp 値を追加すると、要求は 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 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) 文字制限を持つクライアント生成の不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティと、サーバーが受信する要求を関連付けすることを強くお勧めします。 |
要求本文
何一つ。
応答
応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。
状態コード
操作が成功すると、状態コード 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 |
要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、値が最大 1,024 文字表示される ASCII 文字である場合、x-ms-client-request-id ヘッダーの値と等しくなります。
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 操作を承認できます。
大事な
Microsoft では、マネージド ID で Microsoft Entra ID を使用して、Azure Storage への要求を承認することをお勧めします。 Microsoft Entra ID は、共有キーの承認と比較して優れたセキュリティと使いやすさを提供します。
Azure Storage では、Microsoft Entra ID を使用して BLOB データへの要求を承認できます。 Microsoft Entra ID を使用すると、Azure ロールベースのアクセス制御 (Azure RBAC) を使用して、セキュリティ プリンシパルにアクセス許可を付与できます。 セキュリティ プリンシパルには、ユーザー、グループ、アプリケーション サービス プリンシパル、または Azure マネージド ID を指定できます。 セキュリティ プリンシパルは、OAuth 2.0 トークンを返すために Microsoft Entra ID によって認証されます。 その後、トークンを使用して、BLOB サービスに対する要求を承認できます。
Microsoft Entra ID を使用した承認の詳細については、「Microsoft Entra IDを使用して BLOB へのアクセスを承認する」を参照してください。
権限
Microsoft Entra ユーザー、グループ、マネージド ID、またはサービス プリンシパルが Get Account Information 操作を呼び出すために必要な RBAC アクションを次に示します。
Azure RBAC アクション: Microsoft.Storage/storageAccounts/blobServices/getInfo/action を します
この RBAC アクションは所有者ロールに含まれています。または、このアクションをカスタム ロールに割り当てることができます。
Azure RBAC を使用したロールの割り当ての詳細については、「BLOB データにアクセスするための Azure ロールの割り当て」を参照してください。
備考
要求の URL パスは、この操作によって提供される情報には影響しません。 その目的は、許可されたリソースを指定する SAS トークンを使用して要求が正しく承認されるようにすることです。
この操作を成功させるために、指定されたリソースが存在する必要はありません。 たとえば、存在しない BLOB と有効なアクセス許可で生成された SAS トークンは、正しいアカウント名、正しいコンテナー名、存在しない BLOB の名前を含む URL パスで成功します。
請求
価格要求は、Blob Storage API を使用するクライアントから、Blob Storage REST API を介して直接、または Azure Storage クライアント ライブラリから送信できます。 これらの要求には、トランザクションあたりの料金が発生します。 トランザクションの種類は、アカウントの課金方法に影響します。 たとえば、読み取りトランザクションは、書き込みトランザクションとは異なる課金カテゴリに発生します。 次の表に、ストレージ アカウントの種類に基づく Get Account Information 要求の課金カテゴリを示します。
| 操作 | ストレージ アカウントの種類 | 課金カテゴリ |
|---|---|---|
| アカウント情報の取得 | Premium ブロック BLOB 標準汎用 v2 |
その他の操作 |
| アカウント情報の取得 | 標準汎用 v1 | 読み取り操作 |
指定された課金カテゴリの価格については、Azure Blob Storage の価格