Sdílet prostřednictvím

Items - Create Warehouse

  • Reference
Služba:
Warehouse
Verze rozhraní API:
v1

Vytvoří sklad v zadaném pracovním prostoru.
Toto rozhraní API podporuje dlouhotrvajících operací (LRO).

Toto rozhraní API nepodporuje vytvoření skladu s definicí.

Dovolení

Volající musí mít roli přispěvatele nebo vyšší.

Požadované delegovaná rozsahy

Warehouse.ReadWrite.All nebo Item.ReadWrite.All

Omezení

  • Pokud chcete vytvořit sklad, musí být pracovní prostor v podporované kapacitě Fabric. Další informace naleznete v tématu: typy licencí Microsoft Fabric.

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita Podpora
Uživatel Ano
instančního objektu a spravované identity Ano

Rozhraní

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
workspaceId
 path True

string

uuid

ID pracovního prostoru.

Text požadavku

Name Vyžadováno Typ Description
displayName True

string

Zobrazovaný název skladu. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.
creationPayload

WarehouseCreationPayload

Datová část vytvoření skladu. Použijte creationPayload. Nemůžete současně používat definition ani creationPayload.
description

string

Popis skladu. Maximální délka je 256 znaků.

Odpovědi

Name Typ Description
201 Created

Warehouse

Úspěšně vytvořeno
202 Accepted

Žádost byla přijata, probíhá zřizování skladu.

Hlavičky

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

ErrorResponse

Běžné kódy chyb:

  • InvalidItemType – Typ položky je neplatný.

  • ItemDisplayNameAlreadyInUse – Zobrazovaný název položky je již použit.

  • Poškozená částPayload – zadanou datovou část je poškozena.

Příklady

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

Ukázkový požadavek

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

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
CollationType

Kolace skladu. Další collations je možné přidat v průběhu času.
CreateWarehouseRequest

Vytvořte datovou část požadavku na sklad.
ErrorRelatedResource

Chyba související s objektem podrobností o prostředku.
ErrorResponse

Odpověď na chybu.
ErrorResponseDetails

Podrobnosti o odpovědi na chybu.
ItemType

Typ položky. V průběhu času je možné přidat další typy položek.
Warehouse

Objekt skladu.
WarehouseCreationPayload

Datová část položky skladu
WarehouseProperties

Vlastnosti položky skladu.

CollationType

Výčet

Kolace skladu. Další collations je možné přidat v průběhu času.

Hodnota Description
Latin1_General_100_BIN2_UTF8

Výchozí kolace s rozlišováním velkých a malých písmen (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

Kolace nerozlišující velká a malá písmena (CI)

CreateWarehouseRequest

Objekt

Vytvořte datovou část požadavku na sklad.

Name Typ Description
creationPayload

WarehouseCreationPayload

Datová část vytvoření skladu. Použijte creationPayload. Nemůžete současně používat definition ani creationPayload.
description

string

Popis skladu. Maximální délka je 256 znaků.
displayName

string

Zobrazovaný název skladu. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name Typ Description
resourceId

string

ID prostředku, které je součástí chyby.
resourceType

string

Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
moreDetails

ErrorResponseDetails[]

Seznam dalších podrobností o chybě
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou
requestId

string

ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

ItemType

Výčet

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota Description
Dashboard

Řídicí panel PowerBI
DataPipeline

Datový kanál.
Datamart

Datový diagram PowerBI
Environment

Prostředí.
Eventhouse

Eventhouse.
Eventstream

Eventstream.
GraphQLApi

Rozhraní API pro položku GraphQL
KQLDashboard

Řídicí panel KQL.
KQLDatabase

Databáze KQL.
KQLQueryset

Sada dotazů KQL.
Lakehouse

Jezero.
MLExperiment

Experiment strojového učení.
MLModel

Model strojového učení.
MirroredDatabase

Zrcadlené databáze.
MirroredWarehouse

Zrcadlený sklad.
MountedDataFactory

A MountedDataFactory.
Notebook

Poznámkový blok.
PaginatedReport

Stránkovaná sestava PowerBI
Reflex

A Reflex.
Report

Sestava PowerBI
SQLDatabase

Databáze SQLDatabase.
SQLEndpoint

Koncový bod SQL.
SemanticModel

Sémantický model PowerBI
SparkJobDefinition

Definice úlohy Sparku.
Warehouse

Sklad.

Warehouse

Objekt

Objekt skladu.

Name Typ Description
description

string

Popis položky.
displayName

string

Zobrazovaný název položky.
id

string

uuid

ID položky.
properties

WarehouseProperties

Vlastnosti skladu.
type

ItemType

Typ položky.
workspaceId

string

uuid

ID pracovního prostoru.

WarehouseCreationPayload

Objekt

Datová část položky skladu

Name Typ Description
collationType

CollationType

Výchozí typ kolace skladu.

WarehouseProperties

Objekt

Vlastnosti položky skladu.

Name Typ Description
collationType

CollationType

Typ kolace skladu.
connectionString

string

Připojovací řetězec SQL připojený k pracovnímu prostoru obsahujícímu tento sklad.
createdDate

string

date-time

Datum a čas vytvoření skladu.
lastUpdatedTime

string

date-time

Datum a čas poslední aktualizace skladu