Labels - Bulk Set Labels

Tjänst:: Admin

API-version:: v1

Ange känslighetsetiketter för Infrastrukturobjekt, till exempel lakehouses och rapporter, efter objekt-ID. Känslighetsetiketterna tillämpas på de automatiskt genererade objekten som är relaterade till de begärda objekten och deras ID:n returneras inte. Objekt med länkade autogenererade objekt som stöds är: Lakehouse, Warehouse, Datamart, SQLDatabase och MirroredDatabase.

Om du vill ange en känslighetsetikett med det här API:et måste administratörsanvändaren eller den delegerade användaren, om den tillhandahålls, ha etiketten inkluderad i deras etikettprincip. Ett användningsexempel finns i: Ange eller ta bort känslighetsetiketter.

Behörigheter

Användaren måste vara infrastrukturadministratör.
Administratörsanvändaren och den delegerade användaren måste, om den tillhandahålls, ha tillräckliga användningsrättigheter för att kunna ange 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/bulkSetLabels

Begärandetext

Name	Obligatorisk	Typ	Description
items	True	ItemInfo[]	En lista över objekt. Listan innehåller objekt-ID och typ.
labelId	True	string (uuid)	Etikett-ID:t, som måste finnas i användarens etikettprincip.
assignmentMethod		AssignmentMethod	Anger om den tilldelade etiketten har angetts av en automatiserad process eller manuellt. Ytterligare egenskapstyper för klientinställning kan läggas till över tid.
delegatedPrincipal		Principal: UserPrincipal ServicePrincipalPrincipal GroupPrincipal ServicePrincipalProfilePrincipal EntireTenantPrincipal	Delegerad användarinformation. En delegerad användare är en användare inom en organisation vars administratör anger en etikett för användarens räkning. Även om administratören anger etiketten markeras den delegerade användaren som etikett utfärdare. Endast huvudnamn av typen "Användare" stöds.

Svar

Name Typ Description

200 OK

Name	Typ	Description
200 OK	ItemsChangeLabelResponse	Begäran har slutförts.
429 Too Many Requests	ErrorResponse	Gränsen för tjänstfrekvens överskreds. Servern returnerar ett `Retry-After` huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas. Sidhuvuden Retry-After: integer
Other Status Codes	ErrorResponse	Vanliga felkoder: BadRequest – Det går inte att bearbeta åtgärden på grund av ett fel i begäran.

ItemsChangeLabelResponse

Begäran har slutförts.

429 Too Many Requests

ErrorResponse

Gränsen för tjänstfrekvens överskreds. Servern returnerar ett Retry-After huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas.

Sidhuvuden

Retry-After: integer

Other Status Codes

ErrorResponse

Vanliga felkoder:

BadRequest – Det går inte att bearbeta åtgärden på grund av ett fel i begäran.

Exempel

Set labels example

Exempelbegäran

HTTP

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

{
  "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"
    }
  ],
  "labelId": "fe472f5e-636e-4c10-a1c6-7e9edc0b542d",
  "assignmentMethod": "Standard",
  "delegatedPrincipal": {
    "id": "796ce6ad-9163-4c16-9559-c68192a251de",
    "type": "User"
  }
}

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
AssignmentMethod	Anger om den tilldelade etiketten har angetts av en automatiserad process eller manuellt. Ytterligare egenskapstyper för klientinställning kan läggas till över tid.
EntireTenantPrincipal	Representerar ett klientorganisationsobjekt
ErrorRelatedResource	Det felrelaterade resursinformationsobjektet.
ErrorResponse	Felsvaret.
ErrorResponseDetails	Information om felsvar.
GroupDetails	Gruppera specifik information. Gäller när huvudtypen är `Group`.
GroupPrincipal	Representerar en säkerhetsgrupp.
GroupType	Gruppens typ. Ytterligare grupptyper kan läggas till över tid.
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.
PrincipalType	Typ av huvudnamn. Ytterligare huvudnamnstyper kan läggas till över tid.
ServicePrincipalDetails	Specifik information om tjänstens huvudnamn. Gäller när huvudtypen är `ServicePrincipal`.
ServicePrincipalPrincipal	Representerar tjänstens huvudnamn för Microsoft Entra.
ServicePrincipalProfileDetails	Profilinformation för tjänstens huvudnamn. Gäller när huvudtypen är `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Representerar en profil för tjänstens huvudnamn.
SetLabelsRequest	En sammansatt etikettinformation som krävs för att uppdatera en informationsskyddsetikett.
Status	Status för en ändringsåtgärd för informationsskyddsetiketter. Ytterligare egenskapstyper för klientinställning kan läggas till över tid.
UserDetails	Specifik information om användarens huvudnamn. Gäller när huvudtypen är `User`.
UserPrincipal	Representerar ett Microsoft Entra-användarhuvudnamn.

AssignmentMethod

Uppräkning

Anger om den tilldelade etiketten har angetts av en automatiserad process eller manuellt. Ytterligare egenskapstyper för klientinställning kan läggas till över tid.

Värde	Description
Standard	Etiketten har angetts av en automatiserad process (standardvärde).
Priviledged	Etiketten har angetts manuellt.

EntireTenantPrincipal

Objekt

Representerar ett klientorganisationsobjekt

Name	Typ	Description
displayName	string	Huvudkontots visningsnamn.
id	string (uuid)	Huvudmannens ID.
type	string: EntireTenant	Typ av huvudnamn. Ytterligare huvudnamnstyper 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.
isRetriable	boolean	När det är sant kan begäran göras på nytt. Använd svarshuvudet `Retry-After` för att fastställa fördröjningen, om den är tillgänglig.
message	string	En mänsklig läsbar representation av felet.
moreDetails	ErrorResponseDetails[]	Lista över ytterligare felinformation.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.
requestId	string (uuid)	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.

GroupDetails

Objekt

Gruppera specifik information. Gäller när huvudtypen är Group.

Name	Typ	Description
groupType	GroupType	Gruppens typ. Ytterligare grupptyper kan läggas till över tid.

GroupPrincipal

Objekt

Representerar en säkerhetsgrupp.

Name	Typ	Description
displayName	string	Huvudkontots visningsnamn.
groupDetails	GroupDetails	Gruppera specifik information. Gäller när huvudtypen är `Group`.
id	string (uuid)	Huvudmannens ID.
type	string: Group	Typ av huvudnamn. Ytterligare huvudnamnstyper kan läggas till över tid.

GroupType

Uppräkning

Gruppens typ. Ytterligare grupptyper kan läggas till över tid.

Värde	Description
Unknown	Huvudgrupptypen är okänd.
SecurityGroup	Huvudnamn är en säkerhetsgrupp.
DistributionList	Huvudnamn är en distributionslista.

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
Dashboard	PowerBI-instrumentpanel.
Report	PowerBI-rapport.
SemanticModel	PowerBI-semantisk modell.
PaginatedReport	Sidnumrerad PowerBI-rapport.
Datamart	PowerBI-datamart.
Lakehouse	Ett sjöhus.
Eventhouse	Ett eventhouse.
Environment	En miljö.
KQLDatabase	En KQL-databas.
KQLQueryset	En KQL-frågeuppsättning.
KQLDashboard	En KQL-instrumentpanel.
DataPipeline	En datapipeline.
Notebook	En notebook-fil.
SparkJobDefinition	En definition för Spark-jobb.
MLExperiment	Ett maskininlärningsexperiment.
MLModel	En maskininlärningsmodell.
Warehouse	Ett lager.
Eventstream	En händelseström.
SQLEndpoint	En SQL-slutpunkt.
MirroredWarehouse	Ett speglat lager.
MirroredDatabase	En speglad databas.
Reflex	En reflex.
GraphQLApi	Ett API för GraphQL-objekt.
MountedDataFactory	En MountedDataFactory.
SQLDatabase	En SQLDatabase.
CopyJob	Ett kopieringsjobb.
VariableLibrary	En VariableLibrary.
Dataflow	Ett dataflöde.
ApacheAirflowJob	Ett ApacheAirflowJob.
WarehouseSnapshot	En ögonblicksbild av lagret.
DigitalTwinBuilder	En DigitalTwinBuilder.
DigitalTwinBuilderFlow	Ett Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	En speglad azure databricks-katalog.
Map	En karta.
AnomalyDetector	En avvikelseidentifiering.
UserDataFunction	En användardatafunktion.
GraphModel	En GraphModel.
GraphQuerySet	En Graph QuerySet.
SnowflakeDatabase	En Snowflake-databas för att lagra isbergstabeller som skapats från Snowflake-kontot.
OperationsAgent	En OperationsAgent.
CosmosDBDatabase	En Cosmos DB-databas.
Ontology	En ontologi.
EventSchemaSet	En EventSchemaSet.
DataAgent	En DataAgent.
MirroredCatalog	En MirroredCatalog.
AppBackend	En AppBackend.
OrgApp	En organisationsapp.
OrgAppAudience	En målgrupp för en organisationsapp.
DataBuildToolJob	Ett DataBuildToolJob.
AzureDatabricksStorage	Ett OneLake-säkerhetskopierat lagringsobjekt för Azure Databricks.

PrincipalType

Uppräkning

Typ av huvudnamn. Ytterligare huvudnamnstyper kan läggas till över tid.

Värde	Description
User	Principal är ett Microsoft Entra-användarhuvudnamn.
ServicePrincipal	Principal är microsoft entra-tjänstens huvudnamn.
Group	Huvudnamn är en säkerhetsgrupp.
ServicePrincipalProfile	Huvudnamn är en profil för tjänstens huvudnamn.
EntireTenant	Huvudkontot representerar alla klientanvändare.

ServicePrincipalDetails

Objekt

Specifik information om tjänstens huvudnamn. Gäller när huvudtypen är ServicePrincipal.

Name	Typ	Description
aadAppId	string (uuid)	Tjänstens huvudnamns Microsoft Entra AppId.

ServicePrincipalPrincipal

Objekt

Representerar tjänstens huvudnamn för Microsoft Entra.

Name	Typ	Description
displayName	string	Huvudkontots visningsnamn.
id	string (uuid)	Huvudmannens ID.
servicePrincipalDetails	ServicePrincipalDetails	Specifik information om tjänstens huvudnamn. Gäller när huvudtypen är `ServicePrincipal`.
type	string: ServicePrincipal	Typ av huvudnamn. Ytterligare huvudnamnstyper kan läggas till över tid.

ServicePrincipalProfileDetails

Objekt

Profilinformation för tjänstens huvudnamn. Gäller när huvudtypen är ServicePrincipalProfile.

Name	Typ	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Tjänstens huvudnamnsprofils överordnade huvudnamn.

ServicePrincipalProfilePrincipal

Objekt

Representerar en profil för tjänstens huvudnamn.

Name	Typ	Description
displayName	string	Huvudkontots visningsnamn.
id	string (uuid)	Huvudmannens ID.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Profilinformation för tjänstens huvudnamn. Gäller när huvudtypen är `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	Typ av huvudnamn. Ytterligare huvudnamnstyper kan läggas till över tid.

SetLabelsRequest

Objekt

En sammansatt etikettinformation som krävs för att uppdatera en informationsskyddsetikett.

Name	Typ	Description
assignmentMethod	AssignmentMethod	Anger om den tilldelade etiketten har angetts av en automatiserad process eller manuellt. Ytterligare egenskapstyper för klientinställning kan läggas till över tid.
delegatedPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Delegerad användarinformation. En delegerad användare är en användare inom en organisation vars administratör anger en etikett för användarens räkning. Även om administratören anger etiketten markeras den delegerade användaren som etikett utfärdare. Endast huvudnamn av typen "Användare" stöds.
items	ItemInfo[]	En lista över objekt. Listan innehåller objekt-ID och typ.
labelId	string (uuid)	Etikett-ID:t, som måste finnas i användarens etikettprincip.

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.

UserDetails

Objekt

Specifik information om användarens huvudnamn. Gäller när huvudtypen är User.

Name	Typ	Description
userPrincipalName	string	Användarens huvudnamn.

UserPrincipal

Objekt

Representerar ett Microsoft Entra-användarhuvudnamn.

Name	Typ	Description
displayName	string	Huvudkontots visningsnamn.
id	string (uuid)	Huvudmannens ID.
type	string: User	Typ av huvudnamn. Ytterligare huvudnamnstyper kan läggas till över tid.
userDetails	UserDetails	Specifik information om användarens huvudnamn. Gäller när huvudtypen är `User`.