Workspaces - Update Workspace

Palvelu:: Core

Ohjelmointirajapinnan versio:: v1

Päivittää määritetyt työtilan ominaisuudet.

Oikeudet

Soittajalla on oltava järjestelmänvalvojan työtilan rooli.

Vaaditut delegoidut vaikutusalueet

Workspace.ReadWrite.All

Rajoitinrajoitukset

Rajoitustyyppi	Arvo
Käyttöympäristön ohjelmointirajapintojen yhdistetty kiintiö	200 puhelua/min
Ohjelmointirajapinnan raja	200 puhelua/min

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/workspaces/{workspaceId}

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Kuvaus
workspaceId	path	True	string (uuid)	Työtilan tunnus.

Pyynnön leipäteksti

Nimi	Tyyppi	Kuvaus
description	string	Työtilan kuvaus. Kuvauksessa voi olla enintään 4 000 merkkiä.
displayName	string	Työtilan näyttönimi. Näyttönimi voi sisältää enintään 256 merkkiä. Työtilojen nimien on oltava yksilöllisiä vuokraajassa. Järjestelmänvalvojan valvonta on varattu työtilan nimi.

Vastaukset

Nimi Tyyppi Kuvaus

200 OK

Nimi	Tyyppi	Kuvaus
200 OK	Workspace	Pyynnön valmistuttua.
429 Too Many Requests	ErrorResponse	Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka `Retry-After` ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään. Otsikot Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: UnknownError – Ilmeni virhe.

Workspace

Pyynnön valmistuttua.

429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer

Other Status Codes

ErrorResponse

Yleiset virhekoodit:

UnknownError – Ilmeni virhe.

Esimerkit

Update a workspace example

Mallipyyntö

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/33bae707-5fe7-4352-89bd-061a1318b60a

{
  "displayName": "Workspace New displayName",
  "description": "Workspace New description"
}

Mallivastaus

Tilakoodi:: 200

{
  "id": "33bae707-5fe7-4352-89bd-061a1318b60a",
  "displayName": "Workspace New displayName",
  "description": "Workspace New description",
  "type": "Workspace",
  "domainId": "686177b9-ef29-45e4-a5db-1786ca6dbb9f",
  "capacityRegion": "East US"
}

Määritelmät

Nimi	Kuvaus
CapacityRegion	Tähän työtilaan liittyvän kapasiteetin alue. Lisää kapasiteettialueen arvoja voidaan lisätä ajan mittaan.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
UpdateWorkspaceRequest	Päivitä työtilapyynnön tiedot.
Workspace	Työtilan objekti.
WorkspaceAppliedTag	Edustaa käytössä olevaa tunnistetta.
WorkspaceType	Työtilatyyppi. Lisää työtilatyyppejä voidaan lisätä ajan kuluessa.

CapacityRegion

Luettelointi

Tähän työtilaan liittyvän kapasiteetin alue. Lisää kapasiteettialueen arvoja voidaan lisätä ajan mittaan.

Arvo	Kuvaus
Australia East	Australia, itäinen alue
Australia Southeast	Kaakkois-Australia
Brazil South	Brasilian eteläinen alue
Brazil Southeast	Kaakkois-Brasilia
Canada Central	Kanada, keskinen alue
Canada East	Kanada, itäinen alue
Central India	Keski-Intian alue
Central US	Keski-Yhdysvaltain alue
Central US EUAP	Yhdysvaltojen keskinen EUAP-alue
East Asia	Itä-Aasian alue
East US	Itä-Yhdysvaltain alue
East US 2	Itä-Yhdysvallat 2 -alue
France Central	Ranska, keskinen alue
France South	Ranska, eteläinen alue
Germany Central	Saksa, keskinen alue
Germany Northeast	Saksa, koillisalue
Israel Central	Israelin keskiosa
Italy North	Italia, pohjoinen alue
Japan East	Japani, itäinen alue
Japan West	Japani, läntinen alue
Korea Central	Korea, keskinen alue
Korea South	Korea, eteläinen alue
Mexico Central	Meksikon keskiosa
North Central US	Yhdysvaltojen pohjoinen keskiosa
North Europe	Pohjois-Euroopan alue
Norway East	Norja, itäinen alue
Norway West	Norja, läntinen alue
Poland Central	Puolan keskinen alue
South Africa North	Etelä-Afrikka Pohjoinen alue
South Africa West	Etelä-Afrikka Läntinen alue
South Central US	Yhdysvaltojen eteläinen keskiosa
South India	Etelä-Intian alue
Southeast Asia	Kaakkois-Aasian alue
Spain Central	Espanja, keskinen alue
Sweden Central	Ruotsi, keskinen alue
Switzerland North	Sveitsi, pohjoinen alue
Switzerland West	Sveitsi, läntinen alue
West Europe	Länsi-Euroopan alue
West India	Länsi-Intian alue
West US	Länsi-Yhdysvaltain alue
West US 2	Länsi-Yhdysvallat 2 -alue
West US 3	Länsi-Yhdysvallat 3 -alue
West Central US	Läntinen keskiosa, Yhdysvallat, alue
UAE Central	UAE Central region
UAE North	Pohjoinen UAE-alue
Qatar Central	Qatarin keskiosa
Germany West Central	Saksa, läntinen keskinen alue
Germany North	Saksa, pohjoinen alue
UK South	Yhdistynyt kuningaskunta, eteläinen alue
UK West	Yhdistynyt kuningaskunta, läntinen alue
China North	Kiina, pohjoinen alue
China East	Kiina, itäinen alue
China East 2	Kiina, itäinen 2 alue
China East 3	Kiina, itäinen 3-alue
China North 2	Kiina, Pohjoinen 2 -alue
China North 3	Kiina, Pohjoinen 3 -alue

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Kuvaus
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Kuvaus
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
isRetriable	boolean	Kun arvo on tosi, pyyntöä voidaan yrittää uudelleen. Määritä viive vastausotsikon `Retry-After` avulla, jos se on käytettävissä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string (uuid)	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi	Tyyppi	Kuvaus
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.

UpdateWorkspaceRequest

Kohde

Päivitä työtilapyynnön tiedot.

Nimi	Tyyppi	Kuvaus
description	string	Työtilan kuvaus. Kuvauksessa voi olla enintään 4 000 merkkiä.
displayName	string	Työtilan näyttönimi. Näyttönimi voi sisältää enintään 256 merkkiä. Työtilojen nimien on oltava yksilöllisiä vuokraajassa. Järjestelmänvalvojan valvonta on varattu työtilan nimi.

Workspace

Kohde

Työtilan objekti.

Nimi	Tyyppi	Kuvaus
apiEndpoint	string (uri)	HTTP-URL-osoite, joka edustaa työtilalle määritettyä ohjelmointirajapinnan päätepistettä. Tämä päätepistearvo palautetaan, kun käyttäjä ottaa käyttöön preferWorkspaceSpecificEndpoints-asetuksen. Se mahdollistaa ohjelmointirajapinnan käytön yksityisten linkkien kautta.
capacityId	string (uuid)	Sen kapasiteetin tunnus, jolle työtila on määritetty.
capacityRegion	CapacityRegion	Tähän työtilaan liittyvän kapasiteetin alue.
description	string	Työtilan kuvaus.
displayName	string	Työtilan näyttönimi.
domainId	string (uuid)	Sen toimialueen tunnus, jolle työtila on määritetty.
id	string (uuid)	Työtilan tunnus.
tags	WorkspaceAppliedTag[]	Luettelo käytössä olevista tunnisteista.
type	WorkspaceType	Työtilan tyyppi.

WorkspaceAppliedTag

Kohde

Edustaa käytössä olevaa tunnistetta.

Nimi	Tyyppi	Kuvaus
displayName	string	Tunnisteen nimi.
id	string (uuid)	Tunnisteen tunnus.

WorkspaceType

Luettelointi

Työtilatyyppi. Lisää työtilatyyppejä voidaan lisätä ajan kuluessa.

Arvo	Kuvaus
Personal	Oma kansio tai Oma työtila, jota käytetään käyttäjäkohteiden hallintaan.
Workspace	Fabric-kohteiden hallintaan käytetty työtila.
AdminWorkspace	Järjestelmänvalvojan valvontatyötila. Sisältää järjestelmänvalvojan raportit, kuten valvontaraportin sekä käyttö- ja käyttöönottoraportin.