Udostępnij za pośrednictwem

Items - Create Warehouse

  • Odwołanie
Usługa:
Warehouse
Wersja interfejsu API:
v1

Tworzy magazyn w określonym obszarze roboczym.
Ten interfejs API obsługuje długotrwałych operacji (LRO).

Ten interfejs API nie obsługuje tworzenia magazynu z definicją.

Uprawnienia

Obiekt wywołujący musi mieć rolę współautora lub nowszego obszaru roboczego.

Wymagane zakresy delegowane

Warehouse.ReadWrite.All lub Item.ReadWrite.All

Ograniczenia

Tożsamości obsługiwane przez firmę Microsoft

Ten interfejs API obsługuje tożsamości firmy Microsoft wymienione w tej sekcji.

Tożsamość Wsparcie
Użytkownik Tak
jednostki usługi i tożsamości zarządzanych Tak

Interfejs

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
workspaceId
 path True

string

uuid

Identyfikator obszaru roboczego.

Treść żądania

Nazwa Wymagane Typ Opis
displayName True

string

Nazwa wyświetlana magazynu. Nazwa wyświetlana musi być zgodna z regułami nazewnictwa zgodnie z typem elementu.
creationPayload

WarehouseCreationPayload

Ładunek tworzenia magazynu. Użyj creationPayload. Nie można jednocześnie używać definition ani creationPayload.
description

string

Opis magazynu. Maksymalna długość to 256 znaków.

Odpowiedzi

Nazwa Typ Opis
201 Created

Warehouse

Pomyślnie utworzono
202 Accepted

Żądanie zaakceptowane, aprowizacja magazynu w toku.

Nagłówki

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

ErrorResponse

Typowe kody błędów:

  • InvalidItemType — typ elementu jest nieprawidłowy.

  • ItemDisplayNameAlreadyInUse — nazwa wyświetlana elementu jest już używana.

  • CorruptedPayload — podany ładunek jest uszkodzony.

Przykłady

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

Przykładowe żądanie

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

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
CollationType

Sortowanie magazynu. Dodatkowe collations można dodawać z upływem czasu.
CreateWarehouseRequest

Utwórz ładunek żądania magazynu.
ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.
ItemType

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.
Warehouse

Obiekt magazynu.
WarehouseCreationPayload

Ładunek elementu magazynu
WarehouseProperties

Właściwości elementu magazynu.

CollationType

Wyliczanie

Sortowanie magazynu. Dodatkowe collations można dodawać z upływem czasu.

Wartość Opis
Latin1_General_100_BIN2_UTF8

Sortowanie domyślne — z uwzględnieniem wielkości liter (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

sortowanie bez uwzględniania wielkości liter

CreateWarehouseRequest

Objekt

Utwórz ładunek żądania magazynu.

Nazwa Typ Opis
creationPayload

WarehouseCreationPayload

Ładunek tworzenia magazynu. Użyj creationPayload. Nie można jednocześnie używać definition ani creationPayload.
description

string

Opis magazynu. Maksymalna długość to 256 znaków.
displayName

string

Nazwa wyświetlana magazynu. Nazwa wyświetlana musi być zgodna z regułami nazewnictwa zgodnie z typem elementu.

ErrorRelatedResource

Objekt

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

ItemType

Wyliczanie

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.

Wartość Opis
Dashboard

Pulpit nawigacyjny usługi Power BI.
DataPipeline

Potok danych.
Datamart

Datamart usługi Power BI.
Environment

Środowisko.
Eventhouse

Magazyn zdarzeń.
Eventstream

Strumień zdarzeń.
GraphQLApi

Interfejs API dla elementu GraphQL.
KQLDashboard

Pulpit nawigacyjny KQL.
KQLDatabase

Baza danych KQL.
KQLQueryset

Zestaw zapytań KQL.
Lakehouse

Jezioro.
MLExperiment

Eksperyment uczenia maszynowego.
MLModel

Model uczenia maszynowego.
MirroredDatabase

Dublowana baza danych.
MirroredWarehouse

Dublowany magazyn.
MountedDataFactory

A MountedDataFactory.
Notebook

Notes.
PaginatedReport

Raport podzielony na strony usługi PowerBI.
Reflex

Refleks.
Report

Raport usługi Power BI.
SQLDatabase

Baza danych SQLDatabase.
SQLEndpoint

Punkt końcowy SQL.
SemanticModel

Model semantyczny usługi PowerBI.
SparkJobDefinition

Definicja zadania platformy Spark.
Warehouse

Magazyn.

Warehouse

Objekt

Obiekt magazynu.

Nazwa Typ Opis
description

string

Opis elementu.
displayName

string

Nazwa wyświetlana elementu.
id

string

uuid

Identyfikator elementu.
properties

WarehouseProperties

Właściwości magazynu.
type

ItemType

Typ elementu.
workspaceId

string

uuid

Identyfikator obszaru roboczego.

WarehouseCreationPayload

Objekt

Ładunek elementu magazynu

Nazwa Typ Opis
collationType

CollationType

Domyślny typ sortowania magazynu.

WarehouseProperties

Objekt

Właściwości elementu magazynu.

Nazwa Typ Opis
collationType

CollationType

Typ sortowania magazynu.
connectionString

string

Parametry połączenia SQL połączone z obszarem roboczym zawierającym ten magazyn.
createdDate

string

date-time

Data i godzina utworzenia magazynu.
lastUpdatedTime

string

date-time

Data i godzina ostatniej aktualizacji magazynu