Del via

Items - Create Warehouse

  • Referanse
Tjeneste:
Warehouse
API-versjon:
v1

Oppretter et lager i det angitte arbeidsområdet.
Denne API-en støtter langvarige operasjoner (LRO).

Denne API-en støtter ikke oppretting av et lager med definisjon.

Tillatelser

Innringeren må ha bidragsyter eller høyere arbeidsområderolle.

Nødvendige delegerte omfang

Warehouse.ReadWrite.All eller Item.ReadWrite.All

Begrensninger

  • Hvis du vil opprette et lager, må arbeidsområdet være på en støttet stoffkapasitet. Hvis du vil ha mer informasjon, kan du se: Microsoft Fabric-lisenstyper.

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet Støtte
Bruker Ja
tjenestekontohaver og administrerte identiteter Ja

Grensesnitt

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

URI-parametere

Navn I Obligatorisk Type Beskrivelse
workspaceId
 path True

string

uuid

Arbeidsområde-ID-en.

Brødtekst for forespørsel

Navn Obligatorisk Type Beskrivelse
displayName True

string

Visningsnavnet for lageret. Visningsnavnet må følge navnereglene i henhold til elementtype.
creationPayload

WarehouseCreationPayload

Nyttelast for lageroppretting. Bruk creationPayload. Du kan ikke bruke definition eller creationPayload samtidig.
description

string

Lagerbeskrivelsen. Maksimal lengde er 256 tegn.

Svar

Navn Type Beskrivelse
201 Created

Warehouse

Opprettet
202 Accepted

Forespørsel godtatt, lagerklargjøring pågår.

Overskrifter

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

ErrorResponse

Vanlige feilkoder:

  • InvalidItemType – elementtypen er ugyldig.

  • ItemDisplayNameAlreadyInUse – visningsnavnet for elementet er allerede brukt.

  • CorruptedPayload – den angitte nyttelasten er skadet.

Eksempler

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

Eksempelforespørsel

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

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

Eksempelsvar

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

Eksempelforespørsel

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

Eksempelsvar

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

Definisjoner

Navn Beskrivelse
CollationType

Lager sortering. Ytterligere collations kan legges til over tid.
CreateWarehouseRequest

Opprett nyttelast for lagerforespørsel.
ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.
ErrorResponse

Feilsvaret.
ErrorResponseDetails

Feilsvardetaljene.
ItemType

Typen element. Flere elementtyper kan legges til over tid.
Warehouse

Et lagerobjekt.
WarehouseCreationPayload

Nyttelast for lagerelement
WarehouseProperties

Lagerelementegenskapene.

CollationType

Opplisting

Lager sortering. Ytterligere collations kan legges til over tid.

Verdi Beskrivelse
Latin1_General_100_BIN2_UTF8

Standard – CS-sortering (skiller mellom store og små bokstaver)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

skille mellom store og små bokstaver (CI) sortering

CreateWarehouseRequest

Object

Opprett nyttelast for lagerforespørsel.

Navn Type Beskrivelse
creationPayload

WarehouseCreationPayload

Nyttelast for lageroppretting. Bruk creationPayload. Du kan ikke bruke definition eller creationPayload samtidig.
description

string

Lagerbeskrivelsen. Maksimal lengde er 256 tegn.
displayName

string

Visningsnavnet for lageret. Visningsnavnet må følge navnereglene i henhold til elementtype.

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn Type Beskrivelse
resourceId

string

Ressurs-ID-en som er involvert i feilen.
resourceType

string

Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
moreDetails

ErrorResponseDetails[]

Liste over flere feildetaljer.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.
requestId

string

ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.

ItemType

Opplisting

Typen element. Flere elementtyper kan legges til over tid.

Verdi Beskrivelse
Dashboard

PowerBI-instrumentbord.
DataPipeline

Et datasamlebånd.
Datamart

PowerBI-datamart.
Environment

Et miljø.
Eventhouse

Et arrangementshus.
Eventstream

En hendelsesstrøm.
GraphQLApi

En API for GraphQL-element.
KQLDashboard

Et KQL-instrumentbord.
KQLDatabase

En KQL-database.
KQLQueryset

Et KQL-spørringssett.
Lakehouse

Et innsjøhus.
MLExperiment

Et maskinlæringseksperiment.
MLModel

En maskinlæringsmodell.
MirroredDatabase

En speilvendt database.
MirroredWarehouse

Et speilvendt lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notatblokk.
PaginatedReport

Paginert powerbi-rapport.
Reflex

En refleks.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

Et SQL-endepunkt.
SemanticModel

Semantisk PowerBI-modell.
SparkJobDefinition

En spark-jobbdefinisjon.
Warehouse

Et lager.

Warehouse

Object

Et lagerobjekt.

Navn Type Beskrivelse
description

string

Elementbeskrivelsen.
displayName

string

Visningsnavnet for elementet.
id

string

uuid

Element-ID-en.
properties

WarehouseProperties

Lageregenskapene.
type

ItemType

Elementtypen.
workspaceId

string

uuid

Arbeidsområde-ID-en.

WarehouseCreationPayload

Object

Nyttelast for lagerelement

Navn Type Beskrivelse
collationType

CollationType

Standard sorteringstype for lageret.

WarehouseProperties

Object

Lagerelementegenskapene.

Navn Type Beskrivelse
collationType

CollationType

Sorteringstypen for lageret.
connectionString

string

SQL-tilkoblingsstrengen som er koblet til arbeidsområdet som inneholder dette lageret.
createdDate

string

date-time

Datoen og klokkeslettet lageret ble opprettet.
lastUpdatedTime

string

date-time

Datoen og klokkeslettet da lageret sist ble oppdatert