Jaa

Domains - Update Domain

  • Viite
Palvelu:
Admin
Ohjelmointirajapinnan versio:
v1

Muistiinpano

Tämä ohjelmointirajapinta on esikatselutilassa.

Päivittää määritetyt toimialuetiedot.

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

PATCH https://api.fabric.microsoft.com/v1/admin/domains/{domainId}

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
domainId
 path True

string

uuid

Toimialuetunnus.

Pyynnön leipäteksti

Nimi Tyyppi Description
contributorsScope

ContributorsScopeType

Toimialueen osallistujien vaikutusalue.
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ä.

Vastaukset

Nimi Tyyppi Description
200 OK

Domain

Pyynnön valmistuttua.
Other Status Codes

ErrorResponse

Yleiset virhekoodit:

  • UnknownError – Ilmeni virhe.

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

Esimerkit

Update a domain example

Mallipyyntö

PATCH https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f

{
  "displayName": "Domain's new name",
  "description": "Domain's new description",
  "contributorsScope": "SpecificUsersAndGroups"
}

Mallivastaus

Tilakoodi:
200 
{
  "id": "f2f6a374-789e-4d1d-9cc7-6e0b934fc529",
  "displayName": "Domain's new name",
  "description": "Domain's new description",
  "parentDomainId": null,
  "contributorsScope": "SpecificUsersAndGroups"
}

Määritelmät

Nimi Description
ContributorsScopeType

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

Edustaa toimialuetta tai alitoimialuetta.
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.
UpdateDomainRequest

Tietopyynnön tiedot toimialueen päivittämistä varten.

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.

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.

UpdateDomainRequest

Object

Tietopyynnön tiedot toimialueen päivittämistä varten.

Nimi Tyyppi Description
contributorsScope

ContributorsScopeType

Toimialueen osallistujien vaikutusalue.
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ä.