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	Workspace	Har skapats. Sidhuvuden Location: string
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"
}

Definitioner

Name	Description
CreateWorkspaceRequest	Skapa nyttolasten för arbetsytebegäran.
ErrorRelatedResource	Det felrelaterade resursinformationsobjektet.
ErrorResponse	Felsvaret.
ErrorResponseDetails	Information om felsvar.
Workspace	Ett arbetsyteobjekt.
WorkspaceType	En arbetsytetyp. Ytterligare arbetsytetyper kan läggas till över tid.

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.
message	string	En mänsklig läsbar representation av felet.
moreDetails	ErrorResponseDetails[]	Lista över ytterligare felinformation.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.
requestId	string	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.
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.
type	WorkspaceType	Typ av arbetsyta.

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.