Workspaces - Create Workspace

Service:: Core

Version d’API:: v1

Crée un espace de travail.

Autorisations

L’appelant doit avoir l’autorisation de créer des espaces de travail accordés par l’administrateur Fabric. Pour plus d’informations, consultez : créer des espaces de travail.
L’appelant doit disposer d’autorisations de contributeur ou être administrateur sur la capacité. Pour plus d’informations, consultez : autorisations des utilisateurs de capacité.
Les principaux de service doivent disposer d’autorisations accordées par l’administrateur Fabric. Pour plus d’informations, consultez : les principaux de service peuvent créer des espaces de travail, des connexions et des pipelines de déploiement.

Étendues déléguées requises

Workspace.ReadWrite.All

Limites de la limitation

Type de limite	Value
Quota unifié pour les API de plateforme	200 appels/min
Limite d’API	200 appels/min

Identités prises en charge par Microsoft Entra

Cette API prend en charge les identités Microsoft répertoriées dans cette section.

Identité	Soutien
Utilisateur	Oui
Service principal et identités gérées	Oui

Interface

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

Corps de la demande

Nom	Obligatoire	Type	Description
displayName	True	string	Nom complet de l’espace de travail. Le nom complet ne peut pas contenir plus de 256 caractères. Seuls les noms d’espace de travail inutilisés sont autorisés. « Surveillance de l’administrateur » est un nom d’espace de travail réservé.
capacityId		string (uuid)	ID de la capacité à affecter l’espace de travail.
description		string	Description de l’espace de travail. La description ne peut pas contenir plus de 4 000 caractères.
domainId		string (uuid)	ID du domaine auquel affecter l’espace de travail.

Réponses

Nom Type Description

201 Created

Nom	Type	Description
201 Created	Workspace	Création réussie. En-têtes Location: string
429 Too Many Requests	ErrorResponse	La limite de débit de service a été dépassée. Le serveur retourne un `Retry-After` en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires. En-têtes Retry-After: integer
Other Status Codes	ErrorResponse	Codes d’erreur courants : DomainNotFound - Le domaine fourni est introuvable InsufficientPermissionsToDomain - L’autorisation utilisateur du domaine n’est pas suffisante pour effectuer l’opération UnknownError : une erreur s’est produite.

Workspace

Création réussie.

En-têtes

Location: string

429 Too Many Requests

ErrorResponse

La limite de débit de service a été dépassée. Le serveur retourne un Retry-After en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires.

En-têtes

Retry-After: integer

Other Status Codes

ErrorResponse

Codes d’erreur courants :

DomainNotFound - Le domaine fourni est introuvable
InsufficientPermissionsToDomain - L’autorisation utilisateur du domaine n’est pas suffisante pour effectuer l’opération
UnknownError : une erreur s’est produite.

Exemples

Create a workspace example

Exemple de requête

HTTP

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

{
  "displayName": "New workspace"
}

Exemple de réponse

Code d’état:: 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"
}

Définitions

Nom	Description
CapacityRegion	Région de la capacité associée à cet espace de travail. Des valeurs de région de capacité supplémentaires peuvent être ajoutées au fil du temps.
CreateWorkspaceRequest	Créez une charge utile de demande d’espace de travail.
ErrorRelatedResource	Objet de détails de ressource associé à l’erreur.
ErrorResponse	Réponse d’erreur.
ErrorResponseDetails	Détails de la réponse d’erreur.
Workspace	Objet d’espace de travail.
WorkspaceAppliedTag	Représente une balise appliquée.
WorkspaceType	Type d’espace de travail. Des types d’espace de travail supplémentaires peuvent être ajoutés au fil du temps.

CapacityRegion

Énumération

Région de la capacité associée à cet espace de travail. Des valeurs de région de capacité supplémentaires peuvent être ajoutées au fil du temps.

Valeur	Description
Australia East	Région Australie Est
Australia Southeast	Région Sud-Est de l’Australie
Brazil South	Région Sud du Brésil
Brazil Southeast	Région Sud-Est du Brésil
Canada Central	Région centre du Canada
Canada East	Région Canada Est
Central India	Région Inde centrale
Central US	Région USA Centre
Central US EUAP	Région EUAP USA Centre
East Asia	Région Asie Est
East US	Région USA Est
East US 2	RÉGION USA Est 2
France Central	Région France Centre
France South	Région France Sud
Germany Central	Région centrale de l’Allemagne
Germany Northeast	Région Nord-Est de l’Allemagne
Israel Central	Région centrale d’Israël
Italy North	Région Nord de l’Italie
Japan East	Région Japon Est
Japan West	Région Japon Ouest
Korea Central	Région centrale de Corée
Korea South	Corée du Sud
Mexico Central	Région centrale du Mexique
North Central US	Région USA Centre Nord
North Europe	Région Europe Nord
Norway East	Région Norvège Est
Norway West	Région ouest de la Norvège
Poland Central	Région centrale de Pologne
South Africa North	Région Nord de l’Afrique du Sud
South Africa West	Région Ouest de l’Afrique du Sud
South Central US	Région USA Centre Sud
South India	Région Inde Sud
Southeast Asia	Région Asie Sud-Est
Spain Central	Région centrale de l’Espagne
Sweden Central	Région centrale de La Suède
Switzerland North	Région Suisse Nord
Switzerland West	Région Suisse Ouest
West Europe	Région Europe Ouest
West India	Région Inde Ouest
West US	Région USA Ouest
West US 2	Région USA Ouest 2
West US 3	Région USA Ouest 3
West Central US	Région USA Centre Ouest
UAE Central	Région centrale des Émirats arabes unis
UAE North	Région Nord des Émirats arabes unis
Qatar Central	Région du Qatar Centre
Germany West Central	Région Centre-Ouest de l’Allemagne
Germany North	Région Nord de l’Allemagne
UK South	Région Royaume-Uni Sud
UK West	Région Ouest du Royaume-Uni
China North	Région Chine Nord
China East	Région Chine Est
China East 2	Région Chine Est 2
China East 3	Chine Est 3 région
China North 2	Région Chine Nord 2
China North 3	Région Chine Nord 3

CreateWorkspaceRequest

Objet

Créez une charge utile de demande d’espace de travail.

Nom	Type	Description
capacityId	string (uuid)	ID de la capacité à affecter l’espace de travail.
description	string	Description de l’espace de travail. La description ne peut pas contenir plus de 4 000 caractères.
displayName	string	Nom complet de l’espace de travail. Le nom complet ne peut pas contenir plus de 256 caractères. Seuls les noms d’espace de travail inutilisés sont autorisés. « Surveillance de l’administrateur » est un nom d’espace de travail réservé.
domainId	string (uuid)	ID du domaine auquel affecter l’espace de travail.

ErrorRelatedResource

Objet

Objet de détails de ressource associé à l’erreur.

Nom	Type	Description
resourceId	string	ID de ressource impliqué dans l’erreur.
resourceType	string	Type de la ressource impliquée dans l’erreur.

ErrorResponse

Objet

Réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
isRetriable	boolean	Lorsque la valeur est true, la requête peut être retentée. Utilisez l’en-tête `Retry-After` de réponse pour déterminer le délai, le cas échéant.
message	string	Représentation lisible humaine de l’erreur.
moreDetails	ErrorResponseDetails[]	Liste des détails d’erreur supplémentaires.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.
requestId	string (uuid)	ID de la demande associée à l’erreur.

ErrorResponseDetails

Objet

Détails de la réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.

Workspace

Objet

Objet d’espace de travail.

Nom	Type	Description
apiEndpoint	string (uri)	URL HTTP qui représente le point de terminaison d’API spécifique à l’espace de travail. Cette valeur de point de terminaison est retournée lorsque l’utilisateur active preferWorkspaceSpecificEndpoints. Il permet l’accès aux API via des liaisons privées.
capacityId	string (uuid)	ID de la capacité à laquelle l’espace de travail est affecté.
capacityRegion	CapacityRegion	Région de la capacité associée à cet espace de travail.
description	string	Description de l’espace de travail.
displayName	string	Nom complet de l’espace de travail.
domainId	string (uuid)	L’ID du domaine auquel l’espace de travail est affecté.
id	string (uuid)	Identifiant de l’espace de travail.
tags	WorkspaceAppliedTag[]	Liste des balises appliquées.
type	WorkspaceType	Type d’espace de travail.

WorkspaceAppliedTag

Objet

Représente une balise appliquée.

Nom	Type	Description
displayName	string	Nom de la balise.
id	string (uuid)	ID de balise.

WorkspaceType

Énumération

Type d’espace de travail. Des types d’espace de travail supplémentaires peuvent être ajoutés au fil du temps.

Valeur	Description
Personal	Mon dossier ou mon espace de travail utilisé pour gérer les éléments utilisateur.
Workspace	Espace de travail utilisé pour gérer les éléments Fabric.
AdminWorkspace	Espace de travail de surveillance administrateur. Contient des rapports d’administration tels que le rapport d’audit et le rapport d’utilisation et d’adoption.