Items - Create Warehouse

Referens

Tjänst:: Warehouse

API-version:: v1

Skapar ett lager på den angivna arbetsytan.
Det här API:et stöder tidskrävande åtgärder (LRO).

Det här API:et stöder inte att skapa ett lager med definition.

Behörigheter

Anroparen måste ha deltagare eller högre arbetsyteroll.

Obligatoriska delegerade omfång

Warehouse.ReadWrite.All eller Item.ReadWrite.All

Begränsningar

Om du vill skapa ett lager måste arbetsytan finnas på en infrastrukturresurskapacitet som stöds. Mer information finns i: Microsoft Fabric-licenstyper.

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet	Stöd
Användare	Ja
Tjänstens huvudnamn och hanterade identiteter	Ja

Gränssnitt

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
workspaceId	path	True	string uuid	Arbetsytans ID.

Begärandetext

Name	Obligatorisk	Typ	Description
displayName	True	string	Informationslagrets visningsnamn. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.
creationPayload		WarehouseCreationPayload	Nyttolasten för skapande av lager. Använd `creationPayload`. Du kan inte använda `definition` eller `creationPayload` på samma gång.
description		string	Informationslagerbeskrivningen. Maximal längd är 256 tecken.

Svar

Name	Typ	Description
201 Created	Warehouse	Har skapats
202 Accepted		Begäran accepterad, lageretablering pågår. Sidhuvuden Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Vanliga felkoder: InvalidItemType – Objekttypen är ogiltig. ItemDisplayNameAlreadyInUse – Objektets visningsnamn används redan. CorruptedPayload – den angivna nyttolasten är skadad.

Name

Typ

Description

201 Created

Warehouse

Har skapats

202 Accepted

Begäran accepterad, lageretablering pågår.

Sidhuvuden

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

Other Status Codes

ErrorResponse

Vanliga felkoder:

InvalidItemType – Objekttypen är ogiltig.
ItemDisplayNameAlreadyInUse – Objektets visningsnamn används redan.
CorruptedPayload – den angivna nyttolasten är skadad.

Exempel

Create a warehouse example

Create a warehouse example with payload

Create a warehouse example

Exempelbegäran

HTTP

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

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

Exempelsvar

Statuskod:: 201

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Statuskod:: 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

Exempelbegäran

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

Exempelsvar

Statuskod:: 201

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Statuskod:: 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

Definitioner

Name	Description
CollationType	Sortering av lager. Ytterligare `collations` kan läggas till över tid.
CreateWarehouseRequest	Skapa nyttolast för lagerbegäran.
ErrorRelatedResource	Det felrelaterade resursinformationsobjektet.
ErrorResponse	Felsvaret.
ErrorResponseDetails	Information om felsvar.
ItemType	Typ av objekt. Ytterligare objekttyper kan läggas till över tid.
Warehouse	Ett lagerobjekt.
WarehouseCreationPayload	Nyttolast för lagerartikel
WarehouseProperties	Egenskaperna för lagerartikeln.

CollationType

Uppräkning

Sortering av lager. Ytterligare collations kan läggas till över tid.

Värde	Description
Latin1_General_100_BIN2_UTF8	Standardsorteringen – skiftlägeskänslig (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8	skiftlägesokänslig sortering (CI)

CreateWarehouseRequest

Objekt

Skapa nyttolast för lagerbegäran.

Name	Typ	Description
creationPayload	WarehouseCreationPayload	Nyttolasten för skapande av lager. Använd `creationPayload`. Du kan inte använda `definition` eller `creationPayload` på samma gång.
description	string	Informationslagerbeskrivningen. Maximal längd är 256 tecken.
displayName	string	Informationslagrets visningsnamn. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name	Typ	Description
resourceId	string	Det resurs-ID som ingår i felet.
resourceType	string	Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
moreDetails	ErrorResponseDetails[]	Lista över ytterligare felinformation.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.
requestId	string	ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.

ItemType

Uppräkning

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde	Description
Dashboard	PowerBI-instrumentpanel.
DataPipeline	En datapipeline.
Datamart	PowerBI-datamart.
Environment	En miljö.
Eventhouse	Ett eventhouse.
Eventstream	En händelseström.
GraphQLApi	Ett API för GraphQL-objekt.
KQLDashboard	En KQL-instrumentpanel.
KQLDatabase	En KQL-databas.
KQLQueryset	En KQL-frågeuppsättning.
Lakehouse	Ett sjöhus.
MLExperiment	Ett maskininlärningsexperiment.
MLModel	En maskininlärningsmodell.
MirroredDatabase	En speglad databas.
MirroredWarehouse	Ett speglat lager.
MountedDataFactory	En MountedDataFactory.
Notebook	En notebook-fil.
PaginatedReport	Sidnumrerad PowerBI-rapport.
Reflex	En reflex.
Report	PowerBI-rapport.
SQLDatabase	En SQLDatabase.
SQLEndpoint	En SQL-slutpunkt.
SemanticModel	PowerBI-semantisk modell.
SparkJobDefinition	En definition för Spark-jobb.
Warehouse	Ett lager.

Warehouse

Objekt

Ett lagerobjekt.

Name	Typ	Description
description	string	Objektbeskrivningen.
displayName	string	Objektets visningsnamn.
id	string uuid	Objekt-ID:t.
properties	WarehouseProperties	Lageregenskaperna.
type	ItemType	Objekttypen.
workspaceId	string uuid	Arbetsytans ID.

WarehouseCreationPayload

Objekt

Nyttolast för lagerartikel

Name	Typ	Description
collationType	CollationType	Standardsorteringstypen för lagret.

WarehouseProperties

Objekt

Egenskaperna för lagerartikeln.

Name	Typ	Description
collationType	CollationType	Sorteringstypen för lagret.
connectionString	string	SQL-anslutningssträngen som är ansluten till arbetsytan som innehåller det här lagret.
createdDate	string date-time	Datum och tid då lagret skapades.
lastUpdatedTime	string date-time	Datum och tid då lagret senast uppdaterades

Dela via

Items - Create Warehouse

Behörigheter

Obligatoriska delegerade omfång

Begränsningar

Identiteter som stöds av Microsoft Entra

Gränssnitt

URI-parametrar

Begärandetext

Svar

Exempel

Create a warehouse example

Exempelbegäran

Exempelsvar

Create a warehouse example with payload

Exempelbegäran

Exempelsvar

Definitioner

CollationType

CreateWarehouseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemType

Warehouse

WarehouseCreationPayload

WarehouseProperties

Ytterligare resurser