Workspaces - Create Workspace

Tjeneste:: Core

API-version:: v1

Opretter et nyt arbejdsområde.

Tilladelser

Den, der ringer op, skal have tilladelse til at oprette arbejdsområder, der er tildelt af Fabric-administratoren. Du kan få flere oplysninger under: Opret arbejdsområder.
Den, der ringer op, skal have bidragydertilladelser eller være administrator af kapaciteten. Du kan få flere oplysninger under: kapacitetsbrugertilladelser.
Tjenesteprincipaler skal have tilladelse fra Fabric-administratoren. Du kan få flere oplysninger under: Tjenesteprincipaler kan oprette arbejdsområder, forbindelser og udrulningspipelines.

Påkrævede delegerede områder

Workspace.ReadWrite.All

Microsoft Entra-understøttede identiteter

Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.

Identitet	Støtte
Bruger	Ja
tjenesteprincipal og administrerede identiteter	Ja

Grænseflade

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

Brødtekst for anmodning

Name	Påkrævet	Type	Beskrivelse
displayName	True	string	Det viste navn på arbejdsområdet. Det viste navn må ikke indeholde mere end 256 tegn. Kun ubrugte arbejdsområdenavne er tilladt. "Administratorovervågning" er et reserveret arbejdsområdenavn.
capacityId		string (uuid)	Id'et for den kapacitet, arbejdsområdet skal tildeles til.
description		string	Beskrivelsen af arbejdsområdet. Beskrivelsen må ikke indeholde mere end 4000 tegn.
domainId		string (uuid)	Id'et for det domæne, arbejdsområdet skal tildeles til.

Svar

Name Type Beskrivelse

201 Created

Name	Type	Beskrivelse
201 Created	Workspace	Oprettet. Headere Location: string
429 Too Many Requests	ErrorResponse	Grænsen for tjenestetakst blev overskredet. Serveren returnerer en `Retry-After` header, der angiver, i sekunder, hvor længe klienten skal vente, før der sendes yderligere anmodninger. Headere Retry-After: integer
Other Status Codes	ErrorResponse	Almindelige fejlkoder: DomainNotFound – Det angivne domæne blev ikke fundet InsufficientPermissionsToDomain – Brugertilladelse til domænet er ikke tilstrækkelig til at udføre handlingen UnknownError – Der opstod en fejl.

Workspace

Oprettet.

Headere

Location: string

429 Too Many Requests

ErrorResponse

Grænsen for tjenestetakst blev overskredet. Serveren returnerer en Retry-After header, der angiver, i sekunder, hvor længe klienten skal vente, før der sendes yderligere anmodninger.

Headere

Retry-After: integer

Other Status Codes

ErrorResponse

Almindelige fejlkoder:

DomainNotFound – Det angivne domæne blev ikke fundet
InsufficientPermissionsToDomain – Brugertilladelse til domænet er ikke tilstrækkelig til at udføre handlingen
UnknownError – Der opstod en fejl.

Eksempler

Create a workspace example

Eksempelanmodning

HTTP

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

{
  "displayName": "New workspace"
}

Eksempelsvar

Statuskode:: 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	Beskrivelse
CapacityRegion	Området for den kapacitet, der er knyttet til dette arbejdsområde. Der kan tilføjes yderligere værdier for kapacitetsområde over tid.
CreateWorkspaceRequest	Opret nyttedata for anmodning om arbejdsområde.
ErrorRelatedResource	Objektet med fejlrelaterede ressourceoplysninger.
ErrorResponse	Fejlsvaret.
ErrorResponseDetails	Oplysninger om fejlsvar.
Workspace	Et arbejdsområdeobjekt.
WorkspaceAppliedTag	Repræsenterer en anvendt kode.
WorkspaceType	En arbejdsområdetype. Der kan tilføjes flere typer arbejdsområder over tid.

CapacityRegion

Optælling

Området for den kapacitet, der er knyttet til dette arbejdsområde. Der kan tilføjes yderligere værdier for kapacitetsområde over tid.

Værdi	Beskrivelse
Australia East	Det østlige Australien
Australia Southeast	Det sydøstlige Australien
Brazil South	Det sydlige Brasilien
Brazil Southeast	Det sydøstlige Brasilien
Canada Central	Det centrale Canada-område
Canada East	Det østlige Canada-område
Central India	Området Centralindien
Central US	Det centrale USA-område
Central US EUAP	Det centrale US EUAP-område
East Asia	Området Østasien
East US	Område i det østlige USA
East US 2	Det østlige USA 2-område
France Central	Det centrale Frankrig
France South	Det sydlige Frankrig
Germany Central	Det centrale Tyskland
Germany Northeast	Det nordøstlige Tyskland
Israel Central	Det centrale Israel-område
Italy North	Norditalien
Japan East	Det østlige Japan-område
Japan West	Det vestlige Japan-område
Korea Central	Det centrale Korea
Korea South	Sydkoreas område
Mexico Central	Det centrale Mexico-område
North Central US	Det nordcentrale USA-område
North Europe	North Europe-området
Norway East	Det østlige Norge
Norway West	Det vestlige Norge-område
Poland Central	Det centrale Polen
South Africa North	Nordafrika
South Africa West	Det vestlige Afrika
South Central US	Det sydcentrale USA-område
South India	Det sydindiske område
Southeast Asia	Det sydøstlige Asien
Spain Central	Det centrale Spanien
Sweden Central	Det centrale Sverige
Switzerland North	Det nordlige Schweiz
Switzerland West	Det vestlige Schweiz
West Europe	Område i Det vestlige Europa
West India	Området Vestindien
West US	Det vestlige USA-område
West US 2	Det vestlige USA 2-område
West US 3	Det vestlige USA 3-område
West Central US	Det vestlige centrale USA-område
UAE Central	Det centrale UAE-område
UAE North	Nordområde for De Forenede Arabiske Emirater
Qatar Central	Det centrale Qatar-område
Germany West Central	Det vestlige centrale Tyskland
Germany North	Det nordlige Tyskland
UK South	Det sydlige Storbritannien
UK West	Det vestlige Storbritannien
China North	Det nordlige Kina
China East	Det østlige Kina
China East 2	Det østlige Kina 2-område
China East 3	Det østlige Kina 3-område
China North 2	Det nordlige Kina 2-område
China North 3	Det nordlige Kina 3-område

CreateWorkspaceRequest

Objekt

Opret nyttedata for anmodning om arbejdsområde.

Name	Type	Beskrivelse
capacityId	string (uuid)	Id'et for den kapacitet, arbejdsområdet skal tildeles til.
description	string	Beskrivelsen af arbejdsområdet. Beskrivelsen må ikke indeholde mere end 4000 tegn.
displayName	string	Det viste navn på arbejdsområdet. Det viste navn må ikke indeholde mere end 256 tegn. Kun ubrugte arbejdsområdenavne er tilladt. "Administratorovervågning" er et reserveret arbejdsområdenavn.
domainId	string (uuid)	Id'et for det domæne, arbejdsområdet skal tildeles til.

ErrorRelatedResource

Objekt

Objektet med fejlrelaterede ressourceoplysninger.

Name	Type	Beskrivelse
resourceId	string	Det ressource-id, der er involveret i fejlen.
resourceType	string	Typen af ressource, der er involveret i fejlen.

ErrorResponse

Objekt

Fejlsvaret.

Name	Type	Beskrivelse
errorCode	string	Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
isRetriable	boolean	Når sand, kan anmodningen prøves igen. Brug svarheaderen `Retry-After` til at bestemme forsinkelsen, hvis den er tilgængelig.
message	string	En menneskelig læsbar gengivelse af fejlen.
moreDetails	ErrorResponseDetails[]	Liste over yderligere oplysninger om fejl.
relatedResource	ErrorRelatedResource	De fejlrelaterede ressourceoplysninger.
requestId	string (uuid)	Id'et for den anmodning, der er knyttet til fejlen.

ErrorResponseDetails

Objekt

Oplysninger om fejlsvar.

Name	Type	Beskrivelse
errorCode	string	Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message	string	En menneskelig læsbar gengivelse af fejlen.
relatedResource	ErrorRelatedResource	De fejlrelaterede ressourceoplysninger.

Workspace

Objekt

Et arbejdsområdeobjekt.

Name	Type	Beskrivelse
apiEndpoint	string (uri)	HTTP URL-adresse, der repræsenterer det API-slutpunkt, der er specifikt for arbejdsområdet. Denne slutpunktsværdi returneres, når brugeren aktiverer preferWorkspaceSpecificEndpoints. Det giver API-adgang via private links.
capacityId	string (uuid)	Id'et for den kapacitet, arbejdsområdet er tildelt til.
capacityRegion	CapacityRegion	Området for den kapacitet, der er knyttet til dette arbejdsområde.
description	string	Beskrivelsen af arbejdsområdet.
displayName	string	Det viste navn på arbejdsområdet.
domainId	string (uuid)	Id'et for det domæne, arbejdsområdet er tildelt til.
id	string (uuid)	Arbejdsområde-id'et.
tags	WorkspaceAppliedTag[]	Liste over anvendte mærker.
type	WorkspaceType	Arbejdsområdetypen.

WorkspaceAppliedTag

Objekt

Repræsenterer en anvendt kode.

Name	Type	Beskrivelse
displayName	string	Navnet på mærket.
id	string (uuid)	Tag-id'et.

WorkspaceType

Optælling

En arbejdsområdetype. Der kan tilføjes flere typer arbejdsområder over tid.

Værdi	Beskrivelse
Personal	Min mappe eller Mit arbejdsområde, der bruges til at administrere brugerelementer.
Workspace	Arbejdsområde, der bruges til at administrere Fabric-elementerne.
AdminWorkspace	Administrationsovervågningsarbejdsområde. Indeholder administratorrapporter, f.eks. overvågningsrapporten og forbrugs- og indføringsrapporten.