Workspaces - Create Workspace

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Luo uuden työtilan.

Käyttöoikeudet

• Kutsujalla on oltava Fabric-järjestelmänvalvojan myöntämä työtilojen luontioikeus. Lisätietoja on ohjeaiheessa Työtilojen luominen.
• Soittajalla on oltava osallistujan käyttöoikeudet tai hän voi olla kapasiteetin järjestelmänvalvoja. Lisätietoja on kohdassa Kapasiteetin käyttäjän käyttöoikeudet.
• Palvelun päänimillä on oltava Fabric-järjestelmänvalvojan myöntämä käyttöoikeus. Lisätietoja on ohjeaiheessa Palvelun päänimet voivat luoda työtiloja, yhteyksiä ja käyttöönottoputkia.

Vaaditut delegoidut vaikutusalueet

Workspace.ReadWrite.All

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ä

Liittymä

POST https://api.fabric.microsoft.com/v1/workspaces

Pyynnön leipäteksti

Nimi	Pakollinen	Tyyppi	Description
displayName	True	string	Työtilan näyttönimi. Näyttönimi voi sisältää enintään 256 merkkiä. Vain käyttämättömät työtilojen nimet sallitaan. Järjestelmänvalvojan valvonta on varattu työtilan nimi.
capacityId		string (uuid)	Sen kapasiteetin tunnus, jolle työtila määritetään.
description		string	Työtilan kuvaus. Kuvauksessa voi olla enintään 4 000 merkkiä.
domainId		string (uuid)	Sen toimialueen tunnus, jolle työtila määritetään.

Vastaukset

Nimi	Tyyppi	Description
201 Created	Workspace	Luonti onnistui. Otsikot Location: string
Other Status Codes	ErrorResponse	Yleiset virhekoodit: DomainNotFound – Annettua toimialuetta ei löytynyt InsufficientPermissionsToDomain – toimialueen käyttöoikeudet eivät riitä toiminnon suorittamiseen UnknownError – Ilmeni virhe.

Esimerkit

Create a workspace example

Mallipyyntö

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces

{
  "displayName": "New workspace"
}

Mallivastaus

Tilakoodi:

201

Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb22287ff

{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb22287ff",
  "displayName": "New workspace",
  "description": "",
  "type": "Workspace"
}

Määritelmät

Nimi	Description
CreateWorkspaceRequest	Työtilapyynnön tietojen luominen.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
Workspace	Työtilan objekti.
WorkspaceType	Työtilatyyppi. Lisää työtilatyyppejä voidaan lisätä ajan kuluessa.

CreateWorkspaceRequest

Object

Työtilapyynnön tietojen luominen.

Nimi	Tyyppi	Description
capacityId	string (uuid)	Sen kapasiteetin tunnus, jolle työtila määritetään.
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ä. Vain käyttämättömät työtilojen nimet sallitaan. Järjestelmänvalvojan valvonta on varattu työtilan nimi.
domainId	string (uuid)	Sen toimialueen tunnus, jolle työtila määritetään.

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.

Workspace

Object

Työtilan objekti.

Nimi	Tyyppi	Description
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.
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.
type	WorkspaceType	Työtilan tyyppi.

WorkspaceType

Luettelointi

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

Arvo	Description
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.