Workspaces - Create Workspace

Palvelu:
Core
Ohjelmointirajapinnan versio:
v1

Luo uuden työtilan.

Käyttöoikeudet

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 Kuvaus
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 Kuvaus
201 Created

Workspace

Luonti onnistui.

Otsikot

Location: string
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:

  • 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ö

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",
  "capacityRegion": "West US"
}

Määritelmät

Nimi Kuvaus
CapacityRegion

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

Työtilapyynnön tietojen luominen.
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen 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

CreateWorkspaceRequest

Kohde

Työtilapyynnön tietojen luominen.

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

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.

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.