Workspaces - Create Workspace

Tjänst:: Core

API-version:: v1

Skapar en ny arbetsyta.

Behörigheter

Anroparen måste ha behörighet att skapa arbetsytor som beviljats av infrastrukturresursadministratören. Mer information finns i: skapa arbetsytor.
Anroparen måste ha deltagarbehörighet eller vara administratör för kapaciteten. Mer information finns i: kapacitetsanvändarbehörigheter.
Tjänstens huvudnamn måste ha behörighet beviljad av Infrastrukturresursadministratör. Mer information finns i: Tjänstens huvudnamn kan skapa arbetsytor, anslutningar och distributionspipelines.

Obligatoriska delegerade omfång

Arbetsutrymme.LäsSkriv.Allt

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet	Stöd
Användare	Ja
Tjänsthuvudnamn och hanterade identiteter	Ja

Gränssnitt

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

Begärandetext

Name	Obligatorisk	Typ	Description
displayName	True	string	Arbetsytans visningsnamn. Visningsnamnet får inte innehålla fler än 256 tecken. Endast namn på oanvända arbetsytor tillåts. "Administratörsövervakning" är ett reserverat arbetsytenamn.
capacityId		string (uuid)	ID:t för kapaciteten som arbetsytan ska tilldelas till.
description		string	Beskrivningen av arbetsytan. Beskrivningen får inte innehålla fler än 4 000 tecken.
domainId		string (uuid)	ID:t för domänen som arbetsytan ska tilldelas till.

Svar

Name Typ Description

201 Created

Name	Typ	Description
201 Created	Workspace	Har skapats. Sidhuvuden Location: string
429 Too Many Requests	ErrorResponse	Gränsen för tjänstfrekvens överskreds. Servern returnerar ett `Retry-After` huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas. Sidhuvuden Retry-After: integer
Other Status Codes	ErrorResponse	Vanliga felkoder: DomainNotFound – Den angivna domänen hittades inte InsufficientPermissionsToDomain – Användarbehörighet till domänen räcker inte för att utföra åtgärden UnknownError – Ett fel uppstod.

Workspace

Har skapats.

Sidhuvuden

Location: string

429 Too Many Requests

ErrorResponse

Gränsen för tjänstfrekvens överskreds. Servern returnerar ett Retry-After huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas.

Sidhuvuden

Retry-After: integer

Other Status Codes

ErrorResponse

Vanliga felkoder:

DomainNotFound – Den angivna domänen hittades inte
InsufficientPermissionsToDomain – Användarbehörighet till domänen räcker inte för att utföra åtgärden
UnknownError – Ett fel uppstod.

Exempel

Create a workspace example

Exempelbegäran

HTTP

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

{
  "displayName": "New workspace"
}

Exempelsvar

Statuskod:: 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"
}

Definitioner

Name	Description
CapacityRegion	Regionen för den kapacitet som är associerad med den här arbetsytan. Ytterligare kapacitetsregionvärden kan läggas till över tid.
CreateWorkspaceRequest	Skapa nyttolasten för arbetsytebegäran.
ErrorRelatedResource	Det felrelaterade resursinformationsobjektet.
ErrorResponse	Felsvaret.
ErrorResponseDetails	Information om felsvar.
Workspace	Ett arbetsyteobjekt.
WorkspaceAppliedTag	Representerar en tillämpad tagg.
WorkspaceType	En arbetsytetyp. Ytterligare arbetsytetyper kan läggas till över tid.

CapacityRegion

Uppräkning

Regionen för den kapacitet som är associerad med den här arbetsytan. Ytterligare kapacitetsregionvärden kan läggas till över tid.

Värde	Description
Australia East	Australien, östra
Australia Southeast	Australien, sydöstra regionen
Brazil South	Brasilien, södra regionen
Brazil Southeast	Brasilien, sydöstra regionen
Canada Central	Kanada, centrala regionen
Canada East	Kanada, östra
Central India	Indien, centrala
Central US	Regionen USA, centrala
Central US EUAP	EUAP-region i USA, centrala
East Asia	Asien, östra
East US	Region USA, östra
East US 2	Region USA, östra 2
France Central	Frankrike, centrala regionen
France South	Frankrike, södra regionen
Germany Central	Tyskland, centrala regionen
Germany Northeast	Tyskland, nordöstra regionen
Israel Central	Israel, centrala regionen
Italy North	Italien, norra regionen
Japan East	Regionen Japan, östra
Japan West	Regionen Japan, västra
Korea Central	Korea, centrala regionen
Korea South	Sydkorea, södra regionen
Mexico Central	Mexiko, centrala regionen
North Central US	Regionen USA, norra centrala
North Europe	Regionen Europa, norra
Norway East	Norge, östra
Norway West	Norge, västra
Poland Central	Polen, centrala regionen
South Africa North	Regionen Sydafrika, norra
South Africa West	Regionen Sydafrika, västra
South Central US	Regionen USA, södra centrala
South India	Regionen Indien, södra
Southeast Asia	Asien, sydöstra
Spain Central	Spanien, centrala regionen
Sweden Central	Region Sverige, centrala
Switzerland North	Schweiz, norra regionen
Switzerland West	Region, västra Schweiz
West Europe	Regionen Europa, västra
West India	Regionen Indien, västra
West US	Region usa, västra
West US 2	Region USA, västra 2
West US 3	Region USA, västra 3
West Central US	Usa, västra centrala
UAE Central	Förenade Arabemiratens centrala region
UAE North	Förenade Arabemiraten, norra
Qatar Central	Qatars centrala region
Germany West Central	Tyskland, västra centrala
Germany North	Tyskland, norra regionen
UK South	Storbritannien, södra regionen
UK West	Storbritannien, västra
China North	Kina, norra regionen
China East	Kina, östra regionen
China East 2	Kina, östra 2
China East 3	Kina, östra 3-regionen
China North 2	Kina, norra 2-regionen
China North 3	Kina, norra 3-regionen

CreateWorkspaceRequest

Objekt

Skapa nyttolasten för arbetsytebegäran.

Name	Typ	Description
capacityId	string (uuid)	ID:t för kapaciteten som arbetsytan ska tilldelas till.
description	string	Beskrivningen av arbetsytan. Beskrivningen får inte innehålla fler än 4 000 tecken.
displayName	string	Arbetsytans visningsnamn. Visningsnamnet får inte innehålla fler än 256 tecken. Endast namn på oanvända arbetsytor tillåts. "Administratörsövervakning" är ett reserverat arbetsytenamn.
domainId	string (uuid)	ID:t för domänen som arbetsytan ska tilldelas till.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name	Typ	Description
resourceId	string	Det resurs-ID som ingår i felet.
resourceType	string	Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
isRetriable	boolean	När det är sant kan begäran göras på nytt. Använd svarshuvudet `Retry-After` för att fastställa fördröjningen, om den är tillgänglig.
message	string	En mänsklig läsbar representation av felet.
moreDetails	ErrorResponseDetails[]	Lista över ytterligare felinformation.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.
requestId	string (uuid)	ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.

Workspace

Objekt

Ett arbetsyteobjekt.

Name	Typ	Description
apiEndpoint	string (uri)	HTTP-URL som representerar DEN API-slutpunkt som är specifik för arbetsytan. Det här slutpunktsvärdet returneras när användaren aktiverar preferWorkspaceSpecificEndpoints. Det ger API-åtkomst via privata länkar.
capacityId	string (uuid)	ID:t för den kapacitet som arbetsytan tilldelas till.
capacityRegion	CapacityRegion	Regionen för den kapacitet som är associerad med den här arbetsytan.
description	string	Beskrivningen av arbetsytan.
displayName	string	Arbetsytans visningsnamn.
domainId	string (uuid)	ID:t för domänen som arbetsytan är tilldelad till.
id	string (uuid)	Arbetsyte-ID.
tags	WorkspaceAppliedTag[]	Lista över tillämpade taggar.
type	WorkspaceType	Typ av arbetsyta.

WorkspaceAppliedTag

Objekt

Representerar en tillämpad tagg.

Name	Typ	Description
displayName	string	Namnet på taggen.
id	string (uuid)	Tagg-ID:t.

WorkspaceType

Uppräkning

En arbetsytetyp. Ytterligare arbetsytetyper kan läggas till över tid.

Värde	Description
Personal	Min mapp eller Min arbetsyta används för att hantera användarobjekt.
Workspace	Arbetsyta som används för att hantera infrastrukturobjekten.
AdminWorkspace	Arbetsyta för administratörsövervakning. Innehåller administratörsrapporter som granskningsrapporten och användnings- och implementeringsrapporten.