Condividi tramite

Items - Create Warehouse

Servizio:
Warehouse
Versione API:
v1

Crea un magazzino nell'area di lavoro specificata.
Questa API supporta operazioni con esecuzione prolungata (LRO).

Questa API non supporta la creazione di un warehouse con definizione.

Autorizzazioni

Il chiamante deve avere un ruolo di area di lavoro collaboratore .

Ambiti delegati obbligatori

Warehouse.ReadWrite.All o Item.ReadWrite.All

Limitazioni

  • Per creare un magazzino, l'area di lavoro deve essere in una capacità di Fabric supportata. Per altre informazioni, vedere: Microsoft Fabric tipi di licenza.

Microsoft Entra identità supportate

Questa API supporta i Microsoft identities elencati in questa sezione.

Identità Appoggiare
Utente Sì
Principale del servizio e Identità gestite Sì

Interfaccia

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehouses

Parametri dell'URI

Nome In Necessario Tipo Descrizione
workspaceId
 path True

string (uuid)

ID dell'area di lavoro.

Corpo della richiesta

Nome Necessario Tipo Descrizione
displayName True

string

Nome visualizzato del magazzino. Il nome visualizzato deve seguire le regole di denominazione in base al tipo di elemento.
creationPayload

WarehouseCreationPayload

Payload di creazione del magazzino. Utilizzare il creationPayload. Non è possibile usare definition o creationPayload contemporaneamente.
description

string

Descrizione del magazzino. La lunghezza massima è di 256 caratteri.
folderId

string (uuid)

ID cartella. Se non specificato o null, il warehouse viene creato con l'area di lavoro come cartella.
sensitivityLabelSettings

SensitivityLabelSettings

Impostazioni dell'etichetta di riservatezza per il magazzino.

Risposte

Nome Tipo Descrizione
201 Created

Warehouse

Creazione completata
202 Accepted

Richiesta accettata, provisioning del magazzino in corso.

Intestazioni

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive.

Intestazioni

Retry-After: integer
Other Status Codes

ErrorResponse

Codici di errore comuni:

  • InvalidItemType: il tipo di elemento non è valido.

  • ItemDisplayNameAlreadyInUse: il nome visualizzato dell'elemento è già usato.

  • CorruptedPayload: il payload fornito è danneggiato.

  • WorkspaceItemsLimitExceeded - Limite di elementi dell'area di lavoro superato.

Esempio

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

Esempio di richiesta

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description."
}

Risposta di esempio

Codice di stato:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Codice di stato:
202 
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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Codice di stato:
202 
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

Definizioni

Nome Descrizione
CollationType

Regole di confronto del magazzino. È possibile aggiungere collations aggiuntive nel tempo.
CreateWarehouseRequest

Creare il payload della richiesta di warehouse.
EntireTenantPrincipal

Rappresenta un'entità tenant
ErrorRelatedResource

Oggetto dettagli risorsa correlato all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.
GroupDetails

Dettagli specifici del gruppo. Applicabile quando il tipo di entità è Group.
GroupPrincipal

Rappresenta un gruppo di sicurezza.
GroupType

Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.
ItemTag

Rappresenta un tag applicato a un elemento.
ItemType

Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.
PrincipalType

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.
SensitivityLabel

Rappresenta un'etichetta di riservatezza applicata a un elemento.
SensitivityLabelApplyStrategy

Strategia per l'applicazione dell'etichetta di riservatezza. Il valore predefinito è ApplyOrFail. È possibile aggiungere altri tipi nel tempo.
SensitivityLabelSettings

Impostazioni dell'etichetta di riservatezza.
ServicePrincipalDetails

Dettagli specifici dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipal.
ServicePrincipalPrincipal

Rappresenta un'entità servizio Microsoft Entra.
ServicePrincipalProfileDetails

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipalProfile.
ServicePrincipalProfilePrincipal

Rappresenta un profilo dell'entità servizio.
UserDetails

Dettagli specifici dell'entità utente. Applicabile quando il tipo di entità è User.
UserPrincipal

Rappresenta un'entità utente Microsoft Entra.
Warehouse

Oggetto warehouse.
WarehouseCreationPayload

Payload dell'articolo del magazzino
WarehouseProperties

Proprietà dell'articolo del magazzino.

CollationType

Enumerazione

Regole di confronto del magazzino. È possibile aggiungere collations aggiuntive nel tempo.

Valore Descrizione
Latin1_General_100_BIN2_UTF8

Regole di confronto con distinzione tra maiuscole e minuscole (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

Regole di confronto senza distinzione tra maiuscole e minuscole (CI)

CreateWarehouseRequest

Oggetto

Creare il payload della richiesta di warehouse.

Nome Tipo Descrizione
creationPayload

WarehouseCreationPayload

Payload di creazione del magazzino. Utilizzare il creationPayload. Non è possibile usare definition o creationPayload contemporaneamente.
description

string

Descrizione del magazzino. La lunghezza massima è di 256 caratteri.
displayName

string

Nome visualizzato del magazzino. Il nome visualizzato deve seguire le regole di denominazione in base al tipo di elemento.
folderId

string (uuid)

ID cartella. Se non specificato o null, il warehouse viene creato con l'area di lavoro come cartella.
sensitivityLabelSettings

SensitivityLabelSettings

Impostazioni dell'etichetta di riservatezza per il magazzino.

EntireTenantPrincipal

Oggetto

Rappresenta un'entità tenant

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
id

string (uuid)

ID dell'entità.
type string:

EntireTenant

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.

ErrorRelatedResource

Oggetto

Oggetto dettagli risorsa correlato all'errore.

Nome Tipo Descrizione
resourceId

string

ID risorsa coinvolto nell'errore.
resourceType

string

Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
moreDetails

ErrorResponseDetails[]

Elenco di dettagli aggiuntivi sull'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.
requestId

string (uuid)

ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.

GroupDetails

Oggetto

Dettagli specifici del gruppo. Applicabile quando il tipo di entità è Group.

Nome Tipo Descrizione
groupType

GroupType

Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.

GroupPrincipal

Oggetto

Rappresenta un gruppo di sicurezza.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
groupDetails

GroupDetails

Dettagli specifici del gruppo. Applicabile quando il tipo di entità è Group.
id

string (uuid)

ID dell'entità.
type string:

Group

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.

GroupType

Enumerazione

Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.

Valore Descrizione
Unknown

Il tipo di gruppo principale è sconosciuto.
SecurityGroup

Principal è un gruppo di sicurezza.
DistributionList

Principal è una lista di distribuzione.

ItemTag

Oggetto

Rappresenta un tag applicato a un elemento.

Nome Tipo Descrizione
displayName

string

Nome del tag.
id

string (uuid)

ID tag.

ItemType

Enumerazione

Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.

Valore Descrizione
Dashboard

Dashboard di Power BI.
Report

Report di Power BI.
SemanticModel

Modello semantico di PowerBI.
PaginatedReport

Report impaginato di Power BI.
Datamart

Datamart di PowerBI.
Lakehouse

Una lakehouse.
Eventhouse

Una casa eventi.
Environment

Un ambiente.
KQLDatabase

Un database KQL.
KQLQueryset

Set di query KQL.
KQLDashboard

Dashboard KQL.
DataPipeline

Una pipeline di dati.
Notebook

Un notebook.
SparkJobDefinition

Definizione di processo Spark.
MLExperiment

Esperimento di Machine Learning.
MLModel

Modello di Machine Learning.
Warehouse

Un magazzino.
Eventstream

Flusso di eventi.
SQLEndpoint

Endpoint SQL.
MirroredWarehouse

Magazzino con mirroring.
MirroredDatabase

Database con mirroring.
Reflex

Un riflesso.
GraphQLApi

API per l'elemento GraphQL.
MountedDataFactory

Oggetto MountedDataFactory.
SQLDatabase

A SQLDatabase.
CopyJob

Processo di copia.
VariableLibrary

VariabileLibrary.
Dataflow

Flusso di dati.
ApacheAirflowJob

An ApacheAirflowJob.
WarehouseSnapshot

Uno snapshot del warehouse.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Flusso di Generatore di gemelli digitali.
MirroredAzureDatabricksCatalog

Catalogo di Azure databricks con mirroring.
Map

Una mappa.
AnomalyDetector

Rilevamento anomalie.
UserDataFunction

Funzione dati utente.
GraphModel

A GraphModel.
GraphQuerySet

Oggetto Graph QuerySet.
SnowflakeDatabase

Un database Snowflake per archiviare le tabelle Iceberg create dall'account Snowflake.
OperationsAgent

Oggetto OperationsAgent.
CosmosDBDatabase

Un database Cosmos DB.
Ontology

Ontologia.
EventSchemaSet

An EventSchemaSet.
DataAgent

Oggetto DataAgent.

PrincipalType

Enumerazione

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.

Valore Descrizione
User

Principal è un'entità utente Microsoft Entra.
ServicePrincipal

Principal è un'entità servizio Microsoft Entra.
Group

Principal è un gruppo di sicurezza.
ServicePrincipalProfile

Principal è un profilo dell'entità servizio.
EntireTenant

Principal rappresenta tutti gli utenti tenant.

SensitivityLabel

Oggetto

Rappresenta un'etichetta di riservatezza applicata a un elemento.

Nome Tipo Descrizione
id

string (uuid)

ID etichetta di riservatezza.

SensitivityLabelApplyStrategy

Enumerazione

Strategia per l'applicazione dell'etichetta di riservatezza. Il valore predefinito è ApplyOrFail. È possibile aggiungere altri tipi nel tempo.

Valore Descrizione
ApplyOrFail

Applicare l'etichetta di riservatezza o non eseguire l'operazione se non può essere applicata.
Ignore

Ignorare l'etichetta di riservatezza se non può essere applicata e procedere con l'operazione senza applicare l'etichetta.

SensitivityLabelSettings

Oggetto

Impostazioni dell'etichetta di riservatezza.

Nome Tipo Descrizione
labelId

string (uuid)

ID etichetta di riservatezza.
sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

Strategia per l'applicazione dell'etichetta di riservatezza.

ServicePrincipalDetails

Oggetto

Dettagli specifici dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipal.

Nome Tipo Descrizione
aadAppId

string (uuid)

L'entità servizio Microsoft Entra AppId.

ServicePrincipalPrincipal

Oggetto

Rappresenta un'entità servizio Microsoft Entra.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
id

string (uuid)

ID dell'entità.
servicePrincipalDetails

ServicePrincipalDetails

Dettagli specifici dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipal.
type string:

ServicePrincipal

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.

ServicePrincipalProfileDetails

Oggetto

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipalProfile.

Nome Tipo Descrizione
parentPrincipal Principal:

Entità padre del profilo dell'entità servizio.

ServicePrincipalProfilePrincipal

Oggetto

Rappresenta un profilo dell'entità servizio.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
id

string (uuid)

ID dell'entità.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipalProfile.
type string:

ServicePrincipalProfile

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.

UserDetails

Oggetto

Dettagli specifici dell'entità utente. Applicabile quando il tipo di entità è User.

Nome Tipo Descrizione
userPrincipalName

string

Nome principale utente.

UserPrincipal

Oggetto

Rappresenta un'entità utente Microsoft Entra.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
id

string (uuid)

ID dell'entità.
type string:

User

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.
userDetails

UserDetails

Dettagli specifici dell'entità utente. Applicabile quando il tipo di entità è User.

Warehouse

Oggetto

Oggetto warehouse.

Nome Tipo Descrizione
defaultIdentity Principal:

Identità predefinita dell'elemento.
description

string

Descrizione dell'elemento.
displayName

string

Nome visualizzato dell'elemento.
folderId

string (uuid)

ID cartella.
id

string (uuid)

ID elemento.
properties

WarehouseProperties

Proprietà del magazzino.
sensitivityLabel

SensitivityLabel

Etichetta di riservatezza dell'elemento.
tags

ItemTag[]

Elenco di tag applicati.
type

ItemType

Tipo di elemento.
workspaceId

string (uuid)

ID dell'area di lavoro.

WarehouseCreationPayload

Oggetto

Payload dell'articolo del magazzino

Nome Tipo Descrizione
collationType

CollationType

Tipo di regole di confronto predefinito del magazzino.

WarehouseProperties

Oggetto

Proprietà dell'articolo del magazzino.

Nome Tipo Descrizione
collationType

CollationType

Tipo di regole di confronto del magazzino.
connectionString

string

SQL stringa di connessione connesso all'area di lavoro contenente questo warehouse.
createdDate

string (date-time)

Data e ora di creazione del magazzino.
lastUpdatedTime

string (date-time)

Data e ora dell'ultimo aggiornamento del magazzino