Tags - Bulk Create Tags

サービス:

Admin

API バージョン:

v1

注

この API はプレビュー中です。

新しいタグを作成します。

権限

呼び出し元には、Fabric 管理者などの管理者権限が必要です。

必要な委任されたスコープ

Tenant.ReadWrite.All。

制限事項

プリンシパルあたり 1 分あたり最大 25 個の要求。

Microsoft Entra でサポートされている ID

この API では、このセクションに記載されている Microsoft ID が サポートされます。

アイデンティティ	支援
ユーザー	イエス
サービス プリンシパル と マネージド ID	イエス

インターフェイス

POST https://api.fabric.microsoft.com/v1/admin/tags/bulkCreateTags

要求本文

名前	必須	型	説明
createTagsRequest	True	CreateTagRequest[]	createTagRequest の配列

応答

名前	型	説明
201 Created	CreateTagsResponse	タグが正常に作成されました。
Other Status Codes	ErrorResponse	一般的なエラー コード: UnknownError - エラーが発生しました InvalidInputs - 無効な入力が指定されました EntityConflict - タグの表示名が既に存在します

例

Create tags in bulk example

要求のサンプル

HTTP

POST https://api.fabric.microsoft.com/v1/admin/tags/bulkCreateTags

[
  {
    "displayName": "Finance 2024"
  },
  {
    "displayName": "HR 2024"
  }
]

応答のサンプル

状態コード:

201

{
  "tags": [
    {
      "id": "e281785b-5608-41ac-a1a1-78b48b95b825",
      "displayName": "Finance 2024"
    },
    {
      "id": "24402490-9519-48b9-9d51-b2db4095a56b",
      "displayName": "HR 2024"
    }
  ]
}

定義

名前	説明
CreateTagRequest	タグを作成するための要求ペイロード。
CreateTagsRequest	これは、タグのリストを作成するための要求ラッパーです。
CreateTagsResponse	作成されたタグの一覧の応答ラッパー。
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。
Tag	タグを表します。

CreateTagRequest

Object

タグを作成するための要求ペイロード。

名前	型	説明
displayName	string	タグの表示名。 表示名には 40 文字を超えることはできません。

CreateTagsRequest

Object

これは、タグのリストを作成するための要求ラッパーです。

名前	型	説明
createTagsRequest	CreateTagRequest[]	createTagRequest の配列

CreateTagsResponse

Object

作成されたタグの一覧の応答ラッパー。

名前	型	説明
tags	Tag[]	タグの配列

ErrorRelatedResource

Object

エラー関連のリソース詳細オブジェクト。

名前	型	説明
resourceId	string	エラーに関係するリソース ID。
resourceType	string	エラーに関係するリソースの種類。

ErrorResponse

Object

エラー応答。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
moreDetails	ErrorResponseDetails[]	その他のエラーの詳細の一覧。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。
requestId	string	エラーに関連付けられている要求の ID。

ErrorResponseDetails

Object

エラー応答の詳細。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。

Tag

Object

タグを表します。

名前	型	説明
displayName	string	タグの名前。
id	string (uuid)	タグ オブジェクト ID。