Workspaces - Assign To Domain

Tilordner det angitte arbeidsområdet til det angitte domenet.

Tillatelser

  • Innringeren må ha bidragsytertillatelser eller være domeneadministrator.
  • Innringeren må ha administratorrolle for arbeidsområdet.

Obligatorisk omfang

Workspace.ReadWrite.All

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

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/assignToDomain

URI-parametere

Name I Obligatorisk Type Beskrivelse
workspaceId
path True

string (uuid)

Arbeidsområde-ID-en.

Brødtekst for forespørsel

Name Obligatorisk Type Beskrivelse
domainId True

string (uuid)

ID-en for domenet arbeidsområdet skal tilordnes til.

Svar

Name Type Beskrivelse
200 OK

Forespørselen er fullført.

429 Too Many Requests

ErrorResponse

Grensen for tjenestesats ble overskredet. Serveren returnerer en Retry-After topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler.

Overskrifter

Retry-After: integer

Other Status Codes

ErrorResponse

Vanlige feilkoder:

  • DomainNotFound – Det angitte domenet ble ikke funnet

  • WorkspaceNotFound – Det angitte arbeidsområdet ble ikke funnet

  • InsufficientPermissionsToDomain – Innringer har ikke nok tillatelser til domenet til å utføre operasjonen

  • InsufficientWorkspaceRole – Anroper har ikke nok tillatelser til arbeidsområdet til å utføre operasjonen

  • UnknownError - Det oppstod en feil.

Eksempler

Assign a workspace to a domain example

Eksempelforespørsel

POST https://api.fabric.microsoft.com/v1/workspaces/f97451ca-d6a0-482f-a46a-cc4b2c48ba56/assignToDomain

{
  "domainId": "9d04ca81-bb30-4009-bd1a-a9213a4c8d75"
}

Eksempelsvar

Definisjoner

Name Beskrivelse
AssignWorkspaceToDomainRequest

En forespørsel om domenetilordning.

ErrorParameter

En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil.

ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.

ErrorResponse

Feilsvaret.

ErrorResponseDetails

Feilsvardetaljene.

AssignWorkspaceToDomainRequest

En forespørsel om domenetilordning.

Name Type Beskrivelse
domainId

string (uuid)

ID-en for domenet arbeidsområdet skal tilordnes til.

ErrorParameter

En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil.

Name Type Beskrivelse
message

string

En lesbar beskrivelse av parameterens betydning.

name

string

Parameteridentifikatoren.

value

string

Parameterverdien.

ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.

Name Type Beskrivelse
resourceId

string

Ressurs-ID-en som er involvert i feilen.

resourceType

string

Typen ressurs som er involvert i feilen.

ErrorResponse

Feilsvaret.

Name Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.

isRetriable

boolean

Når sann, kan forespørselen prøves på nytt. Retry-After Bruk svarhodet til å fastslå forsinkelsen, hvis tilgjengelig.

message

string

En menneskelig lesbar representasjon av feilen.

moreDetails

ErrorResponseDetails[]

Liste over flere feildetaljer.

parameters

ErrorParameter[]

Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen.

relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.

requestId

string (uuid)

ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Feilsvardetaljene.

Name 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.

parameters

ErrorParameter[]

Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen.

relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.