Freigeben über

Items - Create Warehouse

  • Referenz
Dienst:
Warehouse
API-Version:
v1

Erstellt ein Lagerhaus im angegebenen Arbeitsbereich.
Diese API unterstützt LRO-.

Diese API unterstützt das Erstellen eines Lagers mit Definition nicht.

Erlaubnisse

Der Anrufer muss Mitwirkender oder höherer Arbeitsbereichsrolle haben.

Erforderliche delegierte Bereiche

Warehouse.ReadWrite.All oder Item.ReadWrite.All

Begrenzungen

  • Um ein Lager zu erstellen, muss sich der Arbeitsbereich auf einer unterstützten Fabric-Kapazität befindet. Weitere Informationen finden Sie unter: Microsoft Fabric-Lizenztypen.

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität Unterstützen
Benutzer Ja
Dienstprinzipal und verwaltete Identitäten Ja

Schnittstelle

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
workspaceId
 path True

string

uuid

Die Arbeitsbereichs-ID.

Anforderungstext

Name Erforderlich Typ Beschreibung
displayName True

string

Der Anzeigename des Lagers. Der Anzeigename muss den Benennungsregeln entsprechend dem Elementtyp entsprechen.
creationPayload

WarehouseCreationPayload

Die Lagererstellungsnutzlast. Verwenden Sie creationPayload. Sie können definition oder creationPayload nicht gleichzeitig verwenden.
description

string

Die Lagerbeschreibung. Die maximale Länge beträgt 256 Zeichen.

Antworten

Name Typ Beschreibung
201 Created

Warehouse

Erfolgreich erstellt
202 Accepted

Fordern Sie die akzeptierte Lagerbereitstellung an, die in Bearbeitung ist.

Header

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • InvalidItemType – Elementtyp ist ungültig.

  • ItemDisplayNameAlreadyInUse - Der Anzeigename des Elements wird bereits verwendet.

  • CorruptedPayload – Die bereitgestellte Nutzlast ist beschädigt.

Beispiele

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

Beispielanforderung

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

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

Beispiel für eine Antwort

Statuscode:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Statuscode:
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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Statuscode:
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

Definitionen

Name Beschreibung
CollationType

Lagersortierung. Zusätzliche collations können im Laufe der Zeit hinzugefügt werden.
CreateWarehouseRequest

Erstellen Sie die Nutzlast der Lageranforderung.
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
ItemType

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.
Warehouse

Ein Lagerobjekt.
WarehouseCreationPayload

Nutzlast des Lagerelements
WarehouseProperties

Die Lagerartikeleigenschaften.

CollationType

Enumeration

Lagersortierung. Zusätzliche collations können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
Latin1_General_100_BIN2_UTF8

Die Standardsortierung "Groß-/Kleinschreibung beachten" (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

Sortierung zwischen Groß-/Kleinschreibung (CI)

CreateWarehouseRequest

Objekt

Erstellen Sie die Nutzlast der Lageranforderung.

Name Typ Beschreibung
creationPayload

WarehouseCreationPayload

Die Lagererstellungsnutzlast. Verwenden Sie creationPayload. Sie können definition oder creationPayload nicht gleichzeitig verwenden.
description

string

Die Lagerbeschreibung. Die maximale Länge beträgt 256 Zeichen.
displayName

string

Der Anzeigename des Lagers. Der Anzeigename muss den Benennungsregeln entsprechend dem Elementtyp entsprechen.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

ItemType

Enumeration

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
Dashboard

PowerBI-Dashboard.
DataPipeline

Eine Datenpipeline.
Datamart

PowerBI datamart.
Environment

Eine Umgebung.
Eventhouse

Ein Eventhouse.
Eventstream

Ein Ereignisstream.
GraphQLApi

Eine API für GraphQL-Element.
KQLDashboard

Ein KQL-Dashboard.
KQLDatabase

Eine KQL-Datenbank.
KQLQueryset

Ein KQL-Abfrageset.
Lakehouse

Ein Seehaus.
MLExperiment

Ein Machine Learning-Experiment.
MLModel

Ein Machine Learning-Modell.
MirroredDatabase

Eine gespiegelte Datenbank.
MirroredWarehouse

Ein gespiegeltes Lager.
MountedDataFactory

Eine MountedDataFactory.
Notebook

Ein Notizbuch.
PaginatedReport

PowerBI-Paginated-Bericht.
Reflex

Ein Reflex.
Report

PowerBI-Bericht.
SQLDatabase

Eine SQLDatabase.
SQLEndpoint

Ein SQL-Endpunkt.
SemanticModel

PowerBI-Semantikmodell.
SparkJobDefinition

Eine Sparkauftragsdefinition.
Warehouse

Ein Lagerhaus.

Warehouse

Objekt

Ein Lagerobjekt.

Name Typ Beschreibung
description

string

Die Elementbeschreibung.
displayName

string

Der Anzeigename des Elements.
id

string

uuid

Die Element-ID.
properties

WarehouseProperties

Die Lagerimmobilien.
type

ItemType

Der Elementtyp.
workspaceId

string

uuid

Die Arbeitsbereichs-ID.

WarehouseCreationPayload

Objekt

Nutzlast des Lagerelements

Name Typ Beschreibung
collationType

CollationType

Der Standardsortierungstyp des Lagers.

WarehouseProperties

Objekt

Die Lagerartikeleigenschaften.

Name Typ Beschreibung
collationType

CollationType

Die Sortierungsart des Lagers.
connectionString

string

Die SQL-Verbindungszeichenfolge, die mit dem Arbeitsbereich verbunden ist, der dieses Lager enthält.
createdDate

string

date-time

Das Datum und die Uhrzeit der Erstellung des Lagers.
lastUpdatedTime

string

date-time

Datum und Uhrzeit der letzten Aktualisierung des Lagers