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 |
|---|---|---|---|---|
|
workspace
|
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 |
Grensen for tjenestesats ble overskredet. Serveren returnerer en Overskrifter Retry-After: integer |
|
| Other Status Codes |
Vanlige feilkoder:
|
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 |
|---|---|
|
Assign |
En forespørsel om domenetilordning. |
|
Error |
En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil. |
|
Error |
Objektet for feilrelaterte ressursdetaljer. |
|
Error |
Feilsvaret. |
|
Error |
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.
|
| message |
string |
En menneskelig lesbar representasjon av feilen. |
| moreDetails |
Liste over flere feildetaljer. |
|
| parameters |
Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen. |
|
| relatedResource |
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 |
Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen. |
|
| relatedResource |
Feilrelaterte ressursdetaljer. |