Jaa

Items - Create Warehouse

Palvelu:
Warehouse
Ohjelmointirajapinnan versio:
v1

Luo varaston määritettyyn työtilaan.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Tämä ohjelmointirajapinta ei tue varaston luomista määrityksen kanssa.

Käyttöoikeudet

Kutsujalla on oltava osallistujan työtilan rooli.

Vaaditut delegoidut vaikutusalueet

Warehouse.ReadWrite.All tai Item.ReadWrite.All

Rajoitukset

tuettujen käyttäjätietojen Microsoft Entra

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft identities.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kyllä

Rajapinta

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

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
workspaceId
 path True

string (uuid)

Työtilan tunnus.

Pyynnön leipäteksti

Nimi Pakollinen Tyyppi Description
displayName True

string

Varaston näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
creationPayload

WarehouseCreationPayload

Varaston luonnin hyötykuorma. Käytä creationPayload. et voi käyttää definition tai creationPayload samaan aikaan.
description

string

Varaston kuvaus. Enimmäispituus on 256 merkkiä.
folderId

string (uuid)

Kansion tunnus. Jos sitä ei määritetä tai se on tyhjäarvoinen, varasto luodaan niin, että työtila on sen kansio.
sensitivityLabelSettings

SensitivityLabelSettings

Tämä on varaston luottamuksellisuustunnisteen asetukset.

Vastaukset

Nimi Tyyppi Description
201 Created

Warehouse

Luonti onnistui
202 Accepted

Pyyntö hyväksytty, varaston valmistelu on meneillään.

Otsikot

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer
Other Status Codes

ErrorResponse

Yleiset virhekoodit:

  • InvalidItemType – Kohdetyyppi on virheellinen.

  • ItemDisplayNameAlreadyInUse – Kohteen näyttönimi on jo käytössä.

  • VioittunutPayload – Annetut tiedot ovat vioittuneet.

  • WorkspaceItemsLimitExceeded – Työtilan kohteen raja ylitetty.

Esimerkit

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

Mallipyyntö

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

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

Mallivastaus

Tilakoodi:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Tilakoodi:
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

Mallipyyntö

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

Mallivastaus

Tilakoodi:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Tilakoodi:
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

Määritelmät

Nimi Description
CollationType

Varaston koostaminen. Lisää collations voidaan lisätä ajan kuluessa.
CreateWarehouseRequest

Luo varastopyynnön tiedot.
EntireTenantPrincipal

Edustaa vuokraajan päänimeä
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.
GroupDetails

Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.
GroupPrincipal

Edustaa käyttöoikeusryhmää.
GroupType

Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.
ItemTag

Edustaa kohteelle käytettyä tunnistetta.
ItemType

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.
PrincipalType

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.
SensitivityLabel

Edustaa kohteelle käytettyä luottamuksellisuustunnistetta.
SensitivityLabelApplyStrategy

Tämä on luottamuksellisuustunnisteen käyttöön tarkoitettu strategia. Oletusarvo on ApplyOrFail. Muita tyyppejä voidaan lisätä ajan mittaan.
SensitivityLabelSettings

Luottamuksellisuustunnisteen asetukset.
ServicePrincipalDetails

Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.
ServicePrincipalPrincipal

Ilmaisee Microsoft Entra palvelun päänimen.
ServicePrincipalProfileDetails

Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.
ServicePrincipalProfilePrincipal

Edustaa palvelun pääprofiilia.
UserDetails

Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.
UserPrincipal

Edustaa Microsoft Entra käyttäjäobjektia.
Warehouse

Varasto-objekti.
WarehouseCreationPayload

Varastonimikkeen hyötykuorma
WarehouseProperties

Varastonimikkeen ominaisuudet.

CollationType

Luettelointi

Varaston koostaminen. Lisää collations voidaan lisätä ajan kuluessa.

Arvo Description
Latin1_General_100_BIN2_UTF8

Oletusarvo – kirjainkoko on merkitsevä (CS) -lajittelu
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

case-insensitive (CI) -lajittelu

CreateWarehouseRequest

Kohde

Luo varastopyynnön tiedot.

Nimi Tyyppi Description
creationPayload

WarehouseCreationPayload

Varaston luonnin hyötykuorma. Käytä creationPayload. et voi käyttää definition tai creationPayload samaan aikaan.
description

string

Varaston kuvaus. Enimmäispituus on 256 merkkiä.
displayName

string

Varaston näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
folderId

string (uuid)

Kansion tunnus. Jos sitä ei määritetä tai se on tyhjäarvoinen, varasto luodaan niin, että työtila on sen kansio.
sensitivityLabelSettings

SensitivityLabelSettings

Tämä on varaston luottamuksellisuustunnisteen asetukset.

EntireTenantPrincipal

Kohde

Edustaa vuokraajan päänimeä

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
id

string (uuid)

Päänimen tunnus.
type string:

EntireTenant

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.
requestId

string (uuid)

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

GroupDetails

Kohde

Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.

Nimi Tyyppi Description
groupType

GroupType

Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.

GroupPrincipal

Kohde

Edustaa käyttöoikeusryhmää.

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
groupDetails

GroupDetails

Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.
id

string (uuid)

Päänimen tunnus.
type string:

Group

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

GroupType

Luettelointi

Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.

Arvo Description
Unknown

Pääryhmän tyyppi on tuntematon.
SecurityGroup

Principal on käyttöoikeusryhmä.
DistributionList

Principal on jakeluluettelo.

ItemTag

Kohde

Edustaa kohteelle käytettyä tunnistetta.

Nimi Tyyppi Description
displayName

string

Tunnisteen nimi.
id

string (uuid)

Tunnisteen tunnus.

ItemType

Luettelointi

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
Dashboard

Power BI -koontinäyttö.
Report

PowerBI -raportti.
SemanticModel

PowerBI:n semanttinen malli.
PaginatedReport

PowerBI:n sivutettu raportti.
Datamart

PowerBI -tietomarssi.
Lakehouse

Tämä on lakehouse.
Eventhouse

Tapahtumatalo.
Environment

Ympäristö.
KQLDatabase

KQL-tietokanta.
KQLQueryset

KQL-kyselyjoukko.
KQLDashboard

KQL-koontinäyttö.
DataPipeline

Tietoputki.
Notebook

Muistikirja.
SparkJobDefinition

Spark-työn määritelmä.
MLExperiment

Koneoppimisen kokeilu.
MLModel

Koneoppimismalli.
Warehouse

Varasto.
Eventstream

Tapahtumavirta.
SQLEndpoint

SQL-päätepiste.
MirroredWarehouse

Peilattu varasto.
MirroredDatabase

Peilattu tietokanta.
Reflex

Refleksi.
GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.
MountedDataFactory

A MountedDataFactory.
SQLDatabase

A SQLDatabase.
CopyJob

Kopiotyö.
VariableLibrary

MuuttujaLibrary.
Dataflow

Tietovuo.
ApacheAirflowJob

An ApacheAirflowJob.
WarehouseSnapshot

Varastotilannevedos.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Digital Twin Builder -työnkulku.
MirroredAzureDatabricksCatalog

Peilattu Azure Databricks -luettelo.
Map

Kartta.
AnomalyDetector

Poikkeamien tunnistaminen.
UserDataFunction

Käyttäjätietofunktio.
GraphModel

A GraphModel.
GraphQuerySet

A Graph QuerySet.
SnowflakeDatabase

Snowflake-tietokannalla tallennetaan Snowflake-tililtä luodut Iceberg-taulukot.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Cosmos DB -tietokanta.
Ontology

Ontologia.
EventSchemaSet

An EventSchemaSet.
DataAgent

A DataAgent.

PrincipalType

Luettelointi

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

Arvo Description
User

Principal on Microsoft Entra käyttäjäobjekti.
ServicePrincipal

Principal on Microsoft Entra palvelun päänimi.
Group

Principal on käyttöoikeusryhmä.
ServicePrincipalProfile

Principal on palvelun pääprofiili.
EntireTenant

Principal edustaa kaikkia vuokraajan käyttäjiä.

SensitivityLabel

Kohde

Edustaa kohteelle käytettyä luottamuksellisuustunnistetta.

Nimi Tyyppi Description
id

string (uuid)

Tämä on luottamuksellisuustunnisteen tunnus.

SensitivityLabelApplyStrategy

Luettelointi

Tämä on luottamuksellisuustunnisteen käyttöön tarkoitettu strategia. Oletusarvo on ApplyOrFail. Muita tyyppejä voidaan lisätä ajan mittaan.

Arvo Description
ApplyOrFail

Käytä luottamuksellisuustunnistetta tai epäonnistu toiminto, jos sitä ei voi käyttää.
Ignore

Ohita luottamuksellisuustunniste, jos sitä ei voi käyttää, ja jatka toiminnolla ilman tunnisteen käyttämistä.

SensitivityLabelSettings

Kohde

Luottamuksellisuustunnisteen asetukset.

Nimi Tyyppi Description
labelId

string (uuid)

Tämä on luottamuksellisuustunnisteen tunnus.
sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

Tämä on luottamuksellisuustunnisteen käyttöön tarkoitettu strategia.

ServicePrincipalDetails

Kohde

Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.

Nimi Tyyppi Description
aadAppId

string (uuid)

Palvelun päänimen Microsoft Entra AppId.

ServicePrincipalPrincipal

Kohde

Ilmaisee Microsoft Entra palvelun päänimen.

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
id

string (uuid)

Päänimen tunnus.
servicePrincipalDetails

ServicePrincipalDetails

Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.
type string:

ServicePrincipal

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

ServicePrincipalProfileDetails

Kohde

Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.

Nimi Tyyppi Description
parentPrincipal Principal:

Palvelun pääprofiilin pääobjekti.

ServicePrincipalProfilePrincipal

Kohde

Edustaa palvelun pääprofiilia.

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
id

string (uuid)

Päänimen tunnus.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.
type string:

ServicePrincipalProfile

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

UserDetails

Kohde

Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.

Nimi Tyyppi Description
userPrincipalName

string

Täydellinen käyttäjänimi.

UserPrincipal

Kohde

Edustaa Microsoft Entra käyttäjäobjektia.

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
id

string (uuid)

Päänimen tunnus.
type string:

User

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.
userDetails

UserDetails

Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.

Warehouse

Kohde

Varasto-objekti.

Nimi Tyyppi Description
defaultIdentity Principal:

Kohteen oletusarvoiset käyttäjätiedot.
description

string

Kohteen kuvaus.
displayName

string

Kohteen näyttönimi.
folderId

string (uuid)

Kansion tunnus.
id

string (uuid)

Kohdetunnus.
properties

WarehouseProperties

Varaston ominaisuudet.
sensitivityLabel

SensitivityLabel

Kohteen luottamuksellisuustunniste.
tags

ItemTag[]

Luettelo käytössä olevista tunnisteista.
type

ItemType

Kohdetyyppi.
workspaceId

string (uuid)

Työtilan tunnus.

WarehouseCreationPayload

Kohde

Varastonimikkeen hyötykuorma

Nimi Tyyppi Description
collationType

CollationType

Varaston oletuslaji.

WarehouseProperties

Kohde

Varastonimikkeen ominaisuudet.

Nimi Tyyppi Description
collationType

CollationType

Varaston lajittelutyyppi.
connectionString

string

SQL-yhteysmerkkijono yhdistetty työtilaan, joka sisältää tämän varaston.
createdDate

string (date-time)

Päivämäärä ja aika, jolloin varasto luotiin.
lastUpdatedTime

string (date-time)

Päivämäärä ja kellonaika, jolloin varasto on viimeksi päivitetty