BLOB タグの設定

[アーティクル]
02/07/2024

この操作により Set Blob Tags 、指定した BLOB のユーザー定義タグが 1 つ以上のキーと値のペアとして設定されます。

要求

Set Blob Tags 要求の構成は次のとおりです。 HTTPS を使用することをお勧めします。 myaccount をストレージアカウントの名前に置き換えます。

PUT メソッド要求 URI	HTTP バージョン
`https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags` `https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags&versionid=<DateTime>`	HTTP/1.1

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

パラメーター	説明
`versionid`	バージョン 2019-12-12 以降では省略可能です。パラメーターは `versionid` 不透明 `DateTime` な値であり、存在する場合は、取得する BLOB のバージョンを指定します。
`timeout`	省略可能。 `timeout` パラメーターは、秒単位で表されます。詳細については、「 Blob Storage 操作のタイムアウトを設定する」を参照してください。

要求ヘッダー

必須の要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー	説明
`Authorization`	必須。承認スキーム、アカウント名、署名を指定します。詳細については、「Azure Storage への要求を承認する」をご覧ください。
`Date` または `x-ms-date`	必須。要求に対して協定世界時 (UTC) を指定します。詳細については、「Azure Storage への要求を承認する」をご覧ください。
`x-ms-version`	すべての承認された要求に必要です。この要求に使用する操作のバージョンを指定します。詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
`Content-Length`	必須。要求のコンテンツのサイズ (バイト単位)。このヘッダーは、BLOB 自体ではなく、タグドキュメントのコンテンツ長を参照します。
`Content-Type`	必須。このヘッダーの値は application/xml にする必要があります。charset=UTF-8。
`Content-MD5`	省略可能。要求のコンテンツの MD5 ハッシュ。このハッシュは転送時の要求コンテンツの整合性を確認するために使用します。 2 つのハッシュが一致しない場合、操作はエラーコード 400 (無効な要求) で失敗します。このヘッダーは、BLOB 自体のコンテンツではなく、要求コンテンツに関連付けられています。
`x-ms-content-crc64`	省略可能。要求コンテンツの CRC64 ハッシュ。このハッシュは転送時の要求コンテンツの整合性を確認するために使用します。 2 つのハッシュが一致しない場合、操作はエラーコード 400 (無効な要求) で失敗します。このヘッダーは、BLOB 自体のコンテンツではなく、要求コンテンツに関連付けられています。ヘッダーと `x-ms-content-crc64` ヘッダーの両方`Content-MD5`が存在する場合、要求はエラーコード 400 (無効な要求) で失敗します。
`x-ms-lease-id:<ID>`	BLOB にアクティブなリースが存在する場合は必須です。アクティブなリースが存在する BLOB に対してこの操作を実行するには、このヘッダーに有効なリース ID を指定します。要求で有効なリース ID が指定されていない場合、操作は状態コード 403 (禁止) で失敗します。
`x-ms-client-request-id`	省略可能。ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。詳細については、「Azure Blob Storageの監視」を参照してください。

この操作では、指定した条件が x-ms-if-tags 満たされた場合にのみ BLOB タグを設定する条件付きヘッダーがサポートされます。詳細については、「 Blob Storage 操作の条件付きヘッダーを指定する」を参照してください。

要求本文

要求本文の形式は次のとおりです。

<?xml version="1.0" encoding="utf-8"?>  
<Tags>  
    <TagSet>  
        <Tag>  
            <Key>tag-name-1</Key>  
            <Value>tag-value-1</Value>  
        </Tag>  
        <Tag>  
            <Key>tag-name-2</Key>  
            <Value>tag-value-2</Value>  
        </Tag>  
    </TagSet>  
</Tags>

要求本文は整形式の UTF-8 XML ドキュメントであり、BLOB のタグを表すタグセットが含まれている必要があります。

タグセットには、10 個以下のタグを含めることができます。タグキーとタグ値では、大文字と小文字が区別されます。タグキーは 1 ~ 128 文字、タグ値は 0 ~ 256 文字にする必要があります。有効なタグキーと値の文字は次のとおりです。

小文字と大文字 (a~z、A~Z)
数字 (0 から 9)
スペース ( )
プラス (+)、マイナス (-)、ピリオド (.)、スラッシュ (/)、コロン (:)、等しい (=)、アンダースコア (_)

Response

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

status code

操作が正常に終了すると、ステータスコード 204 (No Content) が返されます。

状態コードの詳細については、「状態とエラーコード」を参照してください。

応答ヘッダー

この操作の応答には、次のヘッダーが含まれています。応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。すべての標準ヘッダーは、HTTP/1.1 プロトコル仕様に準拠しています。

応答ヘッダー	説明
`x-ms-request-id`	作成された要求を一意に識別し、要求のトラブルシューティングに使用できます。詳細については、「 API 操作のトラブルシューティング」を参照してください。
`x-ms-version`	要求の実行に使用された Blob Storage のバージョン。
`Date`	サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。
`x-ms-client-request-id`	要求と対応する応答のトラブルシューティングに使用できます。このヘッダーの値は、要求に存在し、その値に 1,024 文字以下の ASCII 文字が含まれている場合、ヘッダーの値 `x-ms-client-request-id` と等しくなります。ヘッダーが `x-ms-client-request-id` 要求に存在しない場合、応答には存在しません。

応答本文

[なし] :

承認

Azure Storage でデータアクセス操作を呼び出す場合は、承認が必要です。以下で説明するように、操作を Set Blob Tags 承認できます。

重要

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 service に対する要求を認可するために使用できます。

Microsoft Entra IDを使用した承認の詳細については、「Microsoft Entra IDを使用して BLOB へのアクセスを承認する」を参照してください。

アクセス許可

Microsoft Entraユーザー、グループ、マネージド ID、またはサービスプリンシパルが操作を呼び出Set Blob Tagsすために必要な RBAC アクションと、このアクションを含む最小特権の組み込み Azure RBAC ロールを次に示します。

Azure RBAC アクション:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write
最小特権組み込みロール:ストレージ BLOB データ所有者

Azure RBAC を使用したロールの割り当ての詳細については、「 BLOB データにアクセスするための Azure ロールの割り当て」を参照してください。

Shared Access Signature (SAS) は、ストレージアカウント内のリソースへのセキュリティで保護された委任されたアクセスを提供します。 SAS を使用すると、クライアントがデータにアクセスする方法をきめ細かく制御できます。クライアントがアクセスできるリソース、それらのリソースに対するアクセス許可、および SAS が有効な期間を指定できます。

この操作では Set Blob Tags 、ユーザー委任 SAS、サービス SAS、アカウント SAS の 3 種類の共有アクセス署名がサポートされています。

セキュリティのベストプラクティスとして、ストレージアカウントキーではなくMicrosoft Entra資格情報を使用することをお勧めします。これは、より簡単に侵害される可能性があります。アプリケーション設計で共有アクセス署名が必要な場合は、可能であれば、Microsoft Entra資格情報を使用してユーザー委任 SAS を作成します。

ストレージアカウントに対して共有キーアクセスが許可されていない場合、サービス SAS トークンまたはアカウント SAS トークンは、Blob Storage への要求では許可されません。詳細については、「共有キーの禁止が SAS トークンにどのように影響するかを理解する」を参照してください。

ユーザー委任 SAS

ユーザー委任 SAS は、Microsoft Entra資格情報と、SAS に対して指定されたアクセス許可によっても保護されます。

BLOB リソースに Set Blob Tags 委任された SAS トークンを使用して操作を呼び出すには、ユーザー委任 SAS トークンの一部として Tags (t) アクセス許可が必要です。

ユーザー委任 SAS の詳細については、「ユーザー委任 SAS のCreate」を参照してください。

サービス SAS

サービス SAS は、ストレージアカウントキーで保護されます。サービス SAS は、BLOB ストレージなどの単一の Azure Storage サービス内のリソースへのアクセスを委任します。

BLOB リソースに Set Blob Tags 委任された SAS トークンを使用して操作を呼び出すには、サービス SAS トークンの一部として Tags (t) アクセス許可が必要です。

サービス SAS の詳細については、「サービス SAS のCreate」を参照してください。

アカウント SAS

アカウント SAS は、ストレージアカウントキーで保護されます。アカウント SAS は、1 つ以上のストレージサービスのリソースへのアクセスを委任します。サービスまたはユーザー委任 SAS を介して実行できるすべての操作は、アカウント SAS を介しても実行できます。

次の表は、アクセスを委任するときに指定する署名付きリソースの種類と署名付きアクセス許可を示しています。

操作	署名済みサービス	署名されたリソースの種類	署名されたアクセス許可
BLOB タグの設定	BLOB (b)	オブジェクト (o)	タグ (t)

アカウント SAS の詳細については、「アカウント SAS のCreate」を参照してください。

この操作では Set Blob Tags 、共有キーの承認がサポートされています。アカウントキーを使用した承認は、セキュリティが低く、ほとんどのシナリオでは推奨されません。

可能な場合は、ストレージアカウントの共有キーの承認を禁止することをお勧めします。詳細については、「共有キーによる承認の防止」を参照してください。

注釈

この Set Blob Tags 操作は、REST API バージョン 2019-12-12 以降でサポートされています。

階層型名前空間が有効になっているアカウントの場合、 Set Blob Tags BLOB タグは階層型名前空間アカウントではサポートされていないため、操作はサポートされていません。

この操作により Set Blob Tags 、BLOB 上のすべての既存のタグが上書きされます。 BLOB からすべてのタグを削除するには、空<TagSet>のを使用してSet Blob Tags要求を送信します。

この操作では、BLOB の ETag または最終変更時刻は更新されません。アーカイブされた BLOB にタグを設定できます。

ストレージサービスは、BLOB とそのタグの間で強力な一貫性を維持します。 BLOB タグに対する変更は、BLOB に対する後続 Get Blob Tags の操作にすぐに反映されます。ただし、セカンダリインデックスは最終的に一貫性があります。 BLOB のタグに対する変更が、操作に Find Blobs by Tags すぐには表示されない場合があります。

要求で無効なタグが提供された場合、Blob Storage は状態コード 400 (無効な要求) を返します。

請求

価格要求は、Blob Storage REST API を介して直接、または Azure Storage クライアントライブラリから Blob Storage API を使用するクライアントから送信できます。これらの要求では、トランザクションあたりの料金が発生します。トランザクションの種類は、アカウントの課金方法に影響します。たとえば、読み取りトランザクションは、書き込みトランザクションとは異なる課金カテゴリに計上されます。次の表は、ストレージアカウントの種類に基づく要求の課金カテゴリ Set Blob Tags を示しています。

操作	ストレージアカウントの種類	課金カテゴリ
BLOB タグの設定	Premium ブロック BLOB Standard 汎用 v2	その他の操作
BLOB タグの設定	Standard 汎用 v1	書き込み操作

指定した課金カテゴリの価格については、「Azure Blob Storage価格」を参照してください。

こちらもご覧ください

BLOB インデックスタグを使用して Blob Storage データを管理および検索する
 Azure Storage への要求を承認する
 状態コードとエラーコード
 Blob Storage のエラーコード

次の方法で共有