Jaa

Domains - Create Domain

  • Viite
Palvelu:
Admin
Ohjelmointirajapinnan versio:
v1

Muistiinpano

Tämä ohjelmointirajapinta on esikatselutilassa.

Luo uuden toimialueen.

Käyttöoikeudet

Soittajan on oltava Fabric-järjestelmänvalvoja.

Vaaditut delegoidut vaikutusalueet

Tenant.ReadWrite.All.

Rajoitukset

Enintään 25 pyyntöä minuuttia kohti per päänimi.

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kyllä

Rajapinta

POST https://api.fabric.microsoft.com/v1/admin/domains

Pyynnön leipäteksti

Nimi Pakollinen Tyyppi Description
displayName True

string

Toimialueen näyttönimi. Näyttönimi voi sisältää enintään 40 merkkiä.
description

string

Toimialueen kuvaus. Kuvauksessa voi olla enintään 256 merkkiä.
parentDomainId

string

uuid

Toimialueen pääobjektitunnus.

Vastaukset

Nimi Tyyppi Description
201 Created

Domain

Toimialueen luominen onnistui.
Other Status Codes

ErrorResponse

Yleiset virhekoodit:

  • EntityNotFound – Toimialueen luominen epäonnistui, koska päätoimialuetunnusta ei löytynyt.

  • EntityConflict – Toimialueen luominen epäonnistui, koska toimialueen näyttönimi on jo olemassa.

  • InvalidInput – Virheellinen päätoimialuetunnus.

Esimerkit

Create a domain example

Mallipyyntö

POST https://api.fabric.microsoft.com/v1/admin/domains

{
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}

Mallivastaus

Tilakoodi:
201 
{
  "id": "9eba6944-daff-4441-b9b5-630ce34238fd",
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df",
  "contributorsScope": "AllTenant"
}

Määritelmät

Nimi Description
ContributorsScopeType

Osallistujan vaikutusalue. Muita osallistujaalueita voidaan lisätä ajan kuluessa.
CreateDomainRequest

Pyynnön tiedot toimialueen tai alitoimialueen luomista varten.
Domain

Edustaa toimialuetta tai alitoimialuetta.
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.

ContributorsScopeType

Luettelointi

Osallistujan vaikutusalue. Muita osallistujaalueita voidaan lisätä ajan kuluessa.

Arvo Description
AdminsOnly

Vain vuokraajan ja toimialueen järjestelmänvalvojat.
AllTenant

Vuokraajan kaikki käyttäjät.
SpecificUsersAndGroups

Määritetyt käyttäjät ja ryhmät.

CreateDomainRequest

Object

Pyynnön tiedot toimialueen tai alitoimialueen luomista varten.

Nimi Tyyppi Description
description

string

Toimialueen kuvaus. Kuvauksessa voi olla enintään 256 merkkiä.
displayName

string

Toimialueen näyttönimi. Näyttönimi voi sisältää enintään 40 merkkiä.
parentDomainId

string

uuid

Toimialueen pääobjektitunnus.

Domain

Object

Edustaa toimialuetta tai alitoimialuetta.

Nimi Tyyppi Description
contributorsScope

ContributorsScopeType

Toimialueen osallistujien vaikutusalue.
description

string

Toimialueen kuvaus.
displayName

string

Toimialueen nimi.
id

string

uuid

Toimialueen objektitunnus.
parentDomainId

string

uuid

Toimialueen pääobjektitunnus.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

Virhevastaus.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.
requestId

string

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Object

Virheen vastauksen tiedot.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.