次の方法で共有


Tags - List Tags

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

すべてのテナントのタグの一覧を返します。

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

Tenant.Read.All または Tenant.ReadWrite.All

制限事項

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

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

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

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

インターフェイス

GET https://api.fabric.microsoft.com/v1/admin/tags
GET https://api.fabric.microsoft.com/v1/admin/tags?continuationToken={continuationToken}

URI パラメーター

名前 / 必須 説明
continuationToken
query

string

結果の次のページを取得するためのトークン。

応答

名前 説明
200 OK

AdminTagsInfo

要求は成功しました。

Other Status Codes

ErrorResponse

一般的なエラー コード:

  • UnknownError - エラーが発生しました

List of all tenant's tags example
List of all tenant's tags with continuation example

List of all tenant's tags example

要求のサンプル

GET https://api.fabric.microsoft.com/v1/admin/tags

応答のサンプル

{
  "value": [
    {
      "id": "bc23d4c6-cc92-4eb6-bcb5-0ff98429bbff",
      "displayName": "Finance"
    },
    {
      "id": "b0bca781-003c-4041-b1c4-f94d34ba76d4",
      "displayName": "Human resources"
    },
    {
      "id": "6af5a1b6-bc4c-4c0a-b60d-30c68e6e3034",
      "displayName": "Engineering P1"
    },
    {
      "id": "6c00e8eb-51d4-46f7-8b90-7e98520ea7a0",
      "displayName": "Marketing Q1"
    },
    {
      "id": "17df435d-9efd-48c1-a937-7d6fd70ab26a",
      "displayName": "HR Sales Q1"
    },
    {
      "id": "fb765fe3-d404-4f24-9d67-5916449c4c50",
      "displayName": "Root"
    },
    {
      "id": "bda31be4-7efe-4272-8b85-e1b2ff0f0592",
      "displayName": "Legal EMEA"
    }
  ]
}

List of all tenant's tags with continuation example

要求のサンプル

GET https://api.fabric.microsoft.com/v1/admin/tags

応答のサンプル

{
  "value": [
    {
      "id": "bc23d4c6-cc92-4eb6-bcb5-0ff98429bbff",
      "displayName": "Finance"
    },
    {
      "id": "b0bca781-003c-4041-b1c4-f94d34ba76d4",
      "displayName": "Human resources"
    },
    {
      "id": "6af5a1b6-bc4c-4c0a-b60d-30c68e6e3034",
      "displayName": "Engineering P1"
    },
    {
      "id": "6c00e8eb-51d4-46f7-8b90-7e98520ea7a0",
      "displayName": "Marketing Q1"
    },
    {
      "id": "17df435d-9efd-48c1-a937-7d6fd70ab26a",
      "displayName": "HR Sales Q1"
    },
    {
      "id": "fb765fe3-d404-4f24-9d67-5916449c4c50",
      "displayName": "Root"
    },
    {
      "id": "bda31be4-7efe-4272-8b85-e1b2ff0f0592",
      "displayName": "Legal EMEA"
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/admin/tags?continuationToken=LDEsMTAwMDAwLDA%3D"
}

定義

名前 説明
AdminTagInfo

タグを表します。

AdminTagsInfo

タグの一覧の応答ラッパー。

ErrorRelatedResource

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

ErrorResponse

エラー応答。

ErrorResponseDetails

エラー応答の詳細。

AdminTagInfo

タグを表します。

名前 説明
displayName

string

タグの名前。

id

string (uuid)

タグ オブジェクト ID。

AdminTagsInfo

タグの一覧の応答ラッパー。

名前 説明
continuationToken

string

次の結果セット バッチのトークン。 これ以上レコードがない場合は、応答から削除されます。

continuationUri

string

次の結果セット バッチの URI。 これ以上レコードがない場合は、応答から削除されます。

value

AdminTagInfo[]

タグの配列

ErrorRelatedResource

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

名前 説明
resourceId

string

エラーに関係するリソース ID。

resourceType

string

エラーに関係するリソースの種類。

ErrorResponse

エラー応答。

名前 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。

message

string

エラーの人間が判読できる表現。

moreDetails

ErrorResponseDetails[]

その他のエラーの詳細の一覧。

relatedResource

ErrorRelatedResource

エラー関連のリソースの詳細。

requestId

string

エラーに関連付けられている要求の ID。

ErrorResponseDetails

エラー応答の詳細。

名前 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。

message

string

エラーの人間が判読できる表現。

relatedResource

ErrorRelatedResource

エラー関連のリソースの詳細。