Items - Create Warehouse
Crée un entrepôt dans l’espace de travail spécifié.
Cette API prend en charge opérations longues (LRO).
Cette API ne prend pas en charge la création d’un entrepôt avec définition.
Autorisations
L’appelant doit avoir rôle de contributeur ou supérieur.
Étendues déléguées requises
Warehouse.ReadWrite.All ou Item.ReadWrite.All
Limitations
- Pour créer un entrepôt, l’espace de travail doit se trouver sur une capacité Fabric prise en charge. Pour plus d’informations, consultez : types de licences Microsoft Fabric.
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 |
principal de service et identités managées | Oui |
Interface
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehouses
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
ID de l’espace de travail. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
displayName | True |
string |
Nom complet de l’entrepôt. Le nom complet doit suivre les règles d’affectation de noms en fonction du type d’élément. |
creationPayload |
Charge utile de création de l’entrepôt. Utilisez |
||
description |
string |
Description de l’entrepôt. La longueur maximale est de 256 caractères. |
Réponses
Nom | Type | Description |
---|---|---|
201 Created |
Création réussie |
|
202 Accepted |
Demande acceptée, approvisionnement de l’entrepôt en cours. En-têtes
|
|
Other Status Codes |
Codes d’erreur courants :
|
Exemples
Create a warehouse example |
Create a warehouse example with payload |
Create a warehouse example
Exemple de requête
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses
{
"displayName": "Warehouse 1",
"description": "A warehouse description."
}
Exemple de réponse
{
"displayName": "Warehouse 1",
"description": "A warehouse description.",
"type": "Warehouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
Create a warehouse example with payload
Exemple de requête
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses
{
"displayName": "Warehouse 1",
"description": "A warehouse description.",
"creationPayload": {
"collationType": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8"
}
}
Exemple de réponse
{
"displayName": "Warehouse 1",
"description": "A warehouse description.",
"type": "Warehouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
Définitions
Nom | Description |
---|---|
Collation |
Classement de l’entrepôt. Des |
Create |
Créez une charge utile de demande d’entrepôt. |
Error |
Objet de détails de ressource associé à l’erreur. |
Error |
Réponse d’erreur. |
Error |
Détails de la réponse d’erreur. |
Item |
Type de l’élément. Des types d’éléments supplémentaires peuvent être ajoutés au fil du temps. |
Warehouse |
Objet d’entrepôt. |
Warehouse |
Charge utile de l’élément de l’entrepôt |
Warehouse |
Propriétés de l’élément de l’entrepôt. |
CollationType
Classement de l’entrepôt. Des collations
supplémentaires peuvent être ajoutées au fil du temps.
Valeur | Description |
---|---|
Latin1_General_100_BIN2_UTF8 |
Valeur par défaut : classement respectant la casse (CS) |
Latin1_General_100_CI_AS_KS_WS_SC_UTF8 |
Classement sans respect de la casse (CI) |
CreateWarehouseRequest
Créez une charge utile de demande d’entrepôt.
Nom | Type | Description |
---|---|---|
creationPayload |
Charge utile de création de l’entrepôt. Utilisez |
|
description |
string |
Description de l’entrepôt. La longueur maximale est de 256 caractères. |
displayName |
string |
Nom complet de l’entrepôt. Le nom complet doit suivre les règles d’affectation de noms en fonction du type d’élément. |
ErrorRelatedResource
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
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. |
moreDetails |
Liste des détails d’erreur supplémentaires. |
|
relatedResource |
Détails de la ressource associée à l’erreur. |
|
requestId |
string |
ID de la demande associée à l’erreur. |
ErrorResponseDetails
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 |
Détails de la ressource associée à l’erreur. |
ItemType
Type de l’élément. Des types d’éléments supplémentaires peuvent être ajoutés au fil du temps.
Valeur | Description |
---|---|
Dashboard |
Tableau de bord PowerBI. |
DataPipeline |
Un pipeline de données. |
Datamart |
Datamart PowerBI. |
Environment |
Environnement. |
Eventhouse |
Un eventhouse. |
Eventstream |
Flux d’événements. |
GraphQLApi |
API pour l’élément GraphQL. |
KQLDashboard |
Tableau de bord KQL. |
KQLDatabase |
Base de données KQL. |
KQLQueryset |
Ensemble de requêtes KQL. |
Lakehouse |
Un lac. |
MLExperiment |
Une expérience de Machine Learning. |
MLModel |
Modèle Machine Learning. |
MirroredDatabase |
Une base de données mise en miroir. |
MirroredWarehouse |
Un entrepôt mis en miroir. |
MountedDataFactory |
Un MountedDataFactory. |
Notebook |
Un bloc-notes. |
PaginatedReport |
Rapport paginé PowerBI. |
Reflex |
Un réflexe. |
Report |
Rapport PowerBI. |
SQLDatabase |
A SQLDatabase. |
SQLEndpoint |
Point de terminaison SQL. |
SemanticModel |
Modèle sémantique PowerBI. |
SparkJobDefinition |
Définition d’un travail Spark. |
Warehouse |
Un entrepôt. |
Warehouse
Objet d’entrepôt.
Nom | Type | Description |
---|---|---|
description |
string |
Description de l’élément. |
displayName |
string |
Nom complet de l’élément. |
id |
string uuid |
ID d’élément. |
properties |
Propriétés de l’entrepôt. |
|
type |
Type d’élément. |
|
workspaceId |
string uuid |
ID de l’espace de travail. |
WarehouseCreationPayload
Charge utile de l’élément de l’entrepôt
Nom | Type | Description |
---|---|---|
collationType |
Type de classement par défaut de l’entrepôt. |
WarehouseProperties
Propriétés de l’élément de l’entrepôt.
Nom | Type | Description |
---|---|---|
collationType |
Type de classement de l’entrepôt. |
|
connectionString |
string |
Chaîne de connexion SQL connectée à l’espace de travail contenant cet entrepôt. |
createdDate |
string date-time |
Date et heure de création de l’entrepôt. |
lastUpdatedTime |
string date-time |
Date et heure de la dernière mise à jour de l’entrepôt |