Labels - Bulk Remove Labels

Tjänst:

Admin

API-version:

v1

Ta bort känslighetsetiketter från Infrastrukturobjekt (till exempel lakehouses och rapporter) efter objekt-ID. Känslighetsetiketterna för de automatiskt genererade objekten som är länkade till objekten i anropet tas bort och deras ID returneras inte. Objekt med länkade automatiskt genererade objekt som stöds är: Lakehouse, Warehouse, Datamart, SQLDatabase, MirroredDatabase.

Ett användningsexempel finns i Ange eller ta bort känslighetsetiketter.

Behörigheter

• Användaren måste vara infrastrukturadministratör.
• Administratörsanvändaren måste ha tillräcklig användningsrättigheter för att ta bort etiketter.

Obligatoriskt omfång

Tenant.ReadWrite.All

Begränsningar

• Maximalt 25 begäranden per timme.
• Varje begäran kan uppdatera upp till 2 000 infrastrukturobjekt.

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet	Stöd
Användare	Ja
Tjänstens huvudnamn och hanterade identiteter	Nej

Gränssnitt

POST https://api.fabric.microsoft.com/v1/admin/items/bulkRemoveLabels

Begärandetext

Name	Typ	Description
items	ItemInfo[]	En lista över objekt.

Svar

Name	Typ	Description
200 OK	ItemsChangeLabelResponse	Begäran har slutförts.
Other Status Codes	ErrorResponse	Vanliga felkoder: BadRequest – Det går inte att bearbeta åtgärden på grund av ett fel i begäran.

Exempel

Remove labels example

Exempelbegäran

HTTP

POST https://api.fabric.microsoft.com/v1/admin/items/bulkRemoveLabels

{
  "items": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a",
      "type": "Dashboard"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b",
      "type": "Dashboard"
    },
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c",
      "type": "Report"
    },
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542e",
      "type": "SemanticModel"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8f",
      "type": "Notebook"
    }
  ]
}

Exempelsvar

Statuskod:

200

{
  "itemsChangeLabelStatus": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a",
      "type": "Dashboard",
      "status": "NotFound"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b",
      "type": "Dashboard",
      "status": "Failed"
    },
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c",
      "type": "Report",
      "status": "Succeeded"
    },
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542e",
      "type": "SemanticModel",
      "status": "InsufficientUsageRights"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8f",
      "type": "Notebook",
      "status": "FailedToGetUsageRights"
    }
  ]
}

Definitioner

Name	Description
ErrorRelatedResource	Det felrelaterade resursinformationsobjektet.
ErrorResponse	Felsvaret.
ErrorResponseDetails	Information om felsvar.
ItemChangeLabelStatus	Det unika ID:t och informationsskyddsetiketten ändrar status för ett infrastrukturobjekt
ItemInfo	Objektinformationen, inklusive objekt-ID och typ.
ItemsChangeLabelResponse	En lista över de unika ID:na och informationsskyddsetikettens ändringsstatus för fabric-objekten i begäran om etikettändring.
ItemType	Typ av objekt. Ytterligare objekttyper kan läggas till över tid.
RemoveLabelsRequest	En lista över objekt som kräver en uppdatering av informationsskyddsetiketten. Varje objekt i listan innehåller objekt-ID och Typ av infrastrukturobjekt.
Status	Status för en ändringsåtgärd för informationsskyddsetiketter. Ytterligare egenskapstyper för klientinställning kan läggas till över tid.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name	Typ	Description
resourceId	string	Det resurs-ID som ingår i felet.
resourceType	string	Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
moreDetails	ErrorResponseDetails[]	Lista över ytterligare felinformation.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.
requestId	string	ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.

ItemChangeLabelStatus

Objekt

Det unika ID:t och informationsskyddsetiketten ändrar status för ett infrastrukturobjekt

Name	Typ	Description
id	string	Det unika ID:t för ett fabric-objekt. ID:t är i UUID-format.
status	Status	Status för en ändringsåtgärd för informationsskyddsetiketter. Ytterligare egenskapstyper för klientinställning kan läggas till över tid.
type	ItemType	Typ av infrastrukturobjekt.

ItemInfo

Objekt

Objektinformationen, inklusive objekt-ID och typ.

Name	Typ	Description
id	string (uuid)	Ett ID i UUID-format.
type	ItemType	Objekttypen.

ItemsChangeLabelResponse

Objekt

En lista över de unika ID:na och informationsskyddsetikettens ändringsstatus för fabric-objekten i begäran om etikettändring.

Name	Typ	Description
itemsChangeLabelStatus	ItemChangeLabelStatus[]	En lista med objekt ändrar etikettstatus.

ItemType

Uppräkning

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde	Description
ApacheAirflowJob	Ett ApacheAirflowJob.
CopyJob	Ett kopieringsjobb.
Dashboard	PowerBI-instrumentpanel.
DataPipeline	En datapipeline.
Dataflow	Ett dataflöde.
Datamart	PowerBI-datamart.
DigitalTwinBuilder	En DigitalTwinBuilder.
DigitalTwinBuilderFlow	Ett Digital Twin Builder Flow.
Environment	En miljö.
Eventhouse	Ett eventhouse.
Eventstream	En händelseström.
GraphQLApi	Ett API för GraphQL-objekt.
KQLDashboard	En KQL-instrumentpanel.
KQLDatabase	En KQL-databas.
KQLQueryset	En KQL-frågeuppsättning.
Lakehouse	Ett sjöhus.
MLExperiment	Ett maskininlärningsexperiment.
MLModel	En maskininlärningsmodell.
MirroredAzureDatabricksCatalog	En speglad azure databricks-katalog.
MirroredDatabase	En speglad databas.
MirroredWarehouse	Ett speglat lager.
MountedDataFactory	En MountedDataFactory.
Notebook	En notebook-fil.
PaginatedReport	Sidnumrerad PowerBI-rapport.
Reflex	En reflex.
Report	PowerBI-rapport.
SQLDatabase	En SQLDatabase.
SQLEndpoint	En SQL-slutpunkt.
SemanticModel	PowerBI-semantisk modell.
SparkJobDefinition	En definition för Spark-jobb.
VariableLibrary	En VariableLibrary.
Warehouse	Ett lager.
WarehouseSnapshot	En ögonblicksbild av lagret.

RemoveLabelsRequest

Objekt

En lista över objekt som kräver en uppdatering av informationsskyddsetiketten. Varje objekt i listan innehåller objekt-ID och Typ av infrastrukturobjekt.

Name	Typ	Description
items	ItemInfo[]	En lista över objekt.

Status

Uppräkning

Status för en ändringsåtgärd för informationsskyddsetiketter. Ytterligare egenskapstyper för klientinställning kan läggas till över tid.

Värde	Description
Failed	Det gick inte att ange en ny etikett. Försök igen.
FailedToGetUsageRights	Det gick inte att ange en ny etikett. Objektet Infrastruktur har en känslighetsetikett med skyddsinställningar och Fabric kunde inte verifiera att användaren har tillräcklig användningsbehörighet för att ändra etiketten.
InsufficientUsageRights	Det gick inte att ange en ny etikett. Objektet Infrastruktur har en känslighetsetikett med skyddsinställningar, och administratörsanvändaren (och den delegerade användaren, om det anges) har inte tillräcklig användningsbehörighet för att ändra etiketten.
NotFound	Det gick inte att hitta objekt-ID, etikett eller typ för Infrastruktur.
Succeeded	Etiketten Fabric-objekt har ändrats.