Items - Create Warehouse

Service:: Warehouse

API-versie:: v1

Hiermee maakt u een magazijn in de opgegeven werkruimte.
Deze API ondersteunt langlopende bewerkingen (LRO).

Deze API biedt geen ondersteuning voor het maken van een magazijn met definitie.

Machtigingen

De aanroeper moet een werkruimterol inzender hebben.

Vereiste gedelegeerde bereiken

Warehouse.ReadWrite.All of Item.ReadWrite.All

Beperkingen

Als u een magazijn wilt maken, moet de werkruimte zich op een ondersteunde Infrastructuurcapaciteit bevinden. Zie voor meer informatie: Microsoft Fabric-licentietypen.

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Steunen
Gebruiker	Ja
service-principal en beheerde identiteiten	Ja

gebruikersinterface

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

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string (uuid)	De werkruimte-id.

Aanvraagbody

Name	Vereist	Type	Description
displayName	True	string	De weergavenaam van het magazijn. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.
creationPayload		WarehouseCreationPayload	De nettolading voor het maken van het magazijn. Gebruik `creationPayload`. U kunt `definition` of `creationPayload` niet tegelijkertijd gebruiken.
description		string	De beschrijving van het magazijn. De maximale lengte is 256 tekens.
folderId		string (uuid)	De map-id. Als dit niet is opgegeven of null is, wordt het magazijn gemaakt met de werkruimte als map.

Antwoorden

Name	Type	Description
201 Created	Warehouse	Gemaakt
202 Accepted		Aanvraag geaccepteerd, inrichting van magazijn wordt uitgevoerd. Kopteksten Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: InvalidItemType - Itemtype is ongeldig. ItemDisplayNameAlreadyInUse - Weergavenaam van item wordt al gebruikt. CorruptedPayload: de opgegeven nettolading is beschadigd. WorkspaceItemsLimitExceeded - Limiet voor werkruimte-items is overschreden.

Name

Type

Description

201 Created

Warehouse

Gemaakt

202 Accepted

Aanvraag geaccepteerd, inrichting van magazijn wordt uitgevoerd.

Kopteksten

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

InvalidItemType - Itemtype is ongeldig.
ItemDisplayNameAlreadyInUse - Weergavenaam van item wordt al gebruikt.
CorruptedPayload: de opgegeven nettolading is beschadigd.
WorkspaceItemsLimitExceeded - Limiet voor werkruimte-items is overschreden.

Voorbeelden

Create a warehouse example

Create a warehouse example with payload

Create a warehouse example

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Definities

Name	Description
CollationType	Magazijnsortering. Er kunnen na verloop van tijd extra `collations` worden toegevoegd.
CreateWarehouseRequest	Maak de nettolading van de magazijnaanvraag.
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
ItemTag	Vertegenwoordigt een tag die is toegepast op een item.
ItemType	Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
Warehouse	Een magazijnobject.
WarehouseCreationPayload	Nettolading van magazijnitem
WarehouseProperties	De eigenschappen van het magazijnitem.

CollationType

Inventarisatie

Magazijnsortering. Er kunnen na verloop van tijd extra collations worden toegevoegd.

Waarde	Description
Latin1_General_100_BIN2_UTF8	De standaardsortering - hoofdlettergevoelig (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8	HOOFDLETTERGEVOELIGE (CI)-sortering

CreateWarehouseRequest

Object

Maak de nettolading van de magazijnaanvraag.

Name	Type	Description
creationPayload	WarehouseCreationPayload	De nettolading voor het maken van het magazijn. Gebruik `creationPayload`. U kunt `definition` of `creationPayload` niet tegelijkertijd gebruiken.
description	string	De beschrijving van het magazijn. De maximale lengte is 256 tekens.
displayName	string	De weergavenaam van het magazijn. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.
folderId	string (uuid)	De map-id. Als dit niet is opgegeven of null is, wordt het magazijn gemaakt met de werkruimte als map.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

ItemTag

Object

Vertegenwoordigt een tag die is toegepast op een item.

Name	Type	Description
displayName	string	De naam van de tag.
id	string (uuid)	De tag-id.

ItemType

Inventarisatie

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde	Description
ApacheAirflowJob	Een ApacheAirflowJob.
CopyJob	Een kopieertaak.
Dashboard	PowerBI-dashboard.
DataPipeline	Een gegevenspijplijn.
Dataflow	Een gegevensstroom.
Datamart	PowerBI-datamart.
DigitalTwinBuilder	Een DigitalTwinBuilder.
DigitalTwinBuilderFlow	Een Digital Twin Builder Flow.
Environment	Een omgeving.
Eventhouse	Een eventhouse.
Eventstream	Een eventstream.
GraphQLApi	Een API voor GraphQL-item.
KQLDashboard	Een KQL-dashboard.
KQLDatabase	Een KQL-database.
KQLQueryset	Een KQL-queryset.
Lakehouse	Een lakehouse.
MLExperiment	Een machine learning-experiment.
MLModel	Een machine learning-model.
MirroredAzureDatabricksCatalog	Een gespiegelde Azure Databricks-catalogus.
MirroredDatabase	Een gespiegelde database.
MirroredWarehouse	Een gespiegeld magazijn.
MountedDataFactory	Een MountedDataFactory.
Notebook	Een notitieblok.
PaginatedReport	Gepagineerd Power BI-rapport.
Reflex	Een reflex.
Report	PowerBI-rapport.
SQLDatabase	Een SQLDatabase.
SQLEndpoint	Een SQL-eindpunt.
SemanticModel	Semantisch Power BI-model.
SparkJobDefinition	Een Spark-taakdefinitie.
VariableLibrary	Een VariableLibrary.
Warehouse	Een magazijn.
WarehouseSnapshot	Een momentopname van een magazijn.

Warehouse

Object

Een magazijnobject.

Name	Type	Description
description	string	De beschrijving van het item.
displayName	string	De weergavenaam van het item.
folderId	string (uuid)	De map-id.
id	string (uuid)	De item-id.
properties	WarehouseProperties	De magazijneigenschappen.
tags	ItemTag[]	Lijst met toegepaste tags.
type	ItemType	Het itemtype.
workspaceId	string (uuid)	De werkruimte-id.

WarehouseCreationPayload

Object

Nettolading van magazijnitem

Name	Type	Description
collationType	CollationType	Het standaardsorteringstype van het magazijn.

WarehouseProperties

Object

De eigenschappen van het magazijnitem.

Name	Type	Description
collationType	CollationType	Het sorteringstype van het magazijn.
connectionString	string	De SQL-verbindingsreeks die is verbonden met de werkruimte die dit magazijn bevat.
createdDate	string (date-time)	De datum en tijd waarop het magazijn is gemaakt.
lastUpdatedTime	string (date-time)	De datum en tijd waarop het magazijn voor het laatst is bijgewerkt

Delen via

Items - Create Warehouse

Machtigingen

Vereiste gedelegeerde bereiken

Beperkingen

Door Microsoft Entra ondersteunde identiteiten

gebruikersinterface

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

Create a warehouse example

Voorbeeldaanvraag

Voorbeeldrespons

Create a warehouse example with payload

Voorbeeldaanvraag

Voorbeeldrespons

Definities

CollationType

CreateWarehouseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

Warehouse

WarehouseCreationPayload

WarehouseProperties