Tags - List Tags

Tjeneste:

Admin

API-versjon:

v1

Merk deg

Denne API-en er i forhåndsvisning.

Returnerer en liste over alle leierkodene.

Nødvendige delegerte omfang

Tenant.Read.All eller Tenant.ReadWrite.All

Begrensninger

Maksimalt 25 forespørsler per minutt per hovedstol.

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet	Støtte
Bruker	Ja
tjenestekontohaver og administrerte identiteter	Ja

Grensesnitt

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

Med valgfrie parametere:

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

URI-parametere

Navn	I	Obligatorisk	Type	Beskrivelse
continuationToken	query		string	Et token for å hente neste side med resultater.

Svar

Navn	Type	Beskrivelse
200 OK	AdminTagsInfo	Forespørselen var vellykket.
Other Status Codes	ErrorResponse	Vanlige feilkoder: UnknownError - Det oppstod en feil

Eksempler

List of all tenant's tags example

List of all tenant's tags with continuation example

List of all tenant's tags example

Eksempelforespørsel

HTTP

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

Eksempelsvar

Statuskode:

200

{
  "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

Eksempelforespørsel

HTTP

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

Eksempelsvar

Statuskode:

200

{
  "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"
}

Definisjoner

Navn	Beskrivelse
AdminTagInfo	Representerer en kode.
AdminTagsInfo	En svarbryting for en liste over koder.
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.

AdminTagInfo

Object

Representerer en kode.

Navn	Type	Beskrivelse
displayName	string	Navnet på koden.
id	string (uuid)	Objekt-ID-en for koden.

AdminTagsInfo

Object

En svarbryting for en liste over koder.

Navn	Type	Beskrivelse
continuationToken	string	Tokenet for den neste resultatsettgruppen. Hvis det ikke er flere poster, fjernes den fra svaret.
continuationUri	string	URI-en for neste satsvise resultatsett. Hvis det ikke er flere poster, fjernes den fra svaret.
value	AdminTagInfo[]	En matrise med merker

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.