Aracılığıyla paylaş

Items - Create Warehouse

  • Başvuru
Hizmet:
Warehouse
API Sürümü:
v1

Belirtilen çalışma alanında bir ambar oluşturur.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

Bu API, tanımı olan bir ambar oluşturmayı desteklemez.

İzinler

Çağıranın katkıda bulunan veya daha yüksek çalışma alanı rolü olmalıdır.

Gerekli Temsilci Kapsamları

Warehouse.ReadWrite.All veya Item.ReadWrite.All

Sınırlama

  • Bir ambar oluşturmak için çalışma alanının desteklenen bir Doku kapasitesinde olması gerekir. Daha fazla bilgi için bkz. Microsoft Fabric lisans türleri.

Microsoft Entra tarafından desteklenen kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik Destek
Kullanıcı Evet
Hizmet sorumlusu ve yönetilen kimlikler Evet

Arayüz

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

URI Parametreleri

Name İçinde Gerekli Tür Description
workspaceId
 path True

string

uuid

Çalışma alanı kimliği.

İstek Gövdesi

Name Gerekli Tür Description
displayName True

string

Ambar görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.
creationPayload

WarehouseCreationPayload

Ambar oluşturma yükü. creationPayloadkullanın. definition veya creationPayload aynı anda kullanamazsınız.
description

string

Ambar açıklaması. Uzunluk üst sınırı 256 karakterdir.

Yanıtlar

Name Tür Description
201 Created

Warehouse

Başarıyla oluşturuldu
202 Accepted

İstek kabul edildi, ambar sağlama devam ediyor.

Üst Bilgiler

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

ErrorResponse

Yaygın hata kodları:

  • InvalidItemType - Öğe türü geçersiz.

  • ItemDisplayNameAlreadyInUse - Öğe görünen adı zaten kullanılıyor.

  • BozukPayload - Sağlanan yük bozuk.

Örnekler

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

Örnek isteği

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

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

Örnek yanıt

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

Örnek isteği

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

Örnek yanıt

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

Tanımlar

Name Description
CollationType

Ambar harmanlaması. Zaman içinde ek collations eklenebilir.
CreateWarehouseRequest

Ambar isteği yükü oluşturma.
ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse

Hata yanıtı.
ErrorResponseDetails

Hata yanıtı ayrıntıları.
ItemType

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
Warehouse

Ambar nesnesi.
WarehouseCreationPayload

Ambar öğesi yükü
WarehouseProperties

Ambar öğesi özellikleri.

CollationType

Listeleme

Ambar harmanlaması. Zaman içinde ek collations eklenebilir.

Değer Description
Latin1_General_100_BIN2_UTF8

Varsayılan - büyük/küçük harfe duyarlı (CS) harmanlama
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

büyük/küçük harfe duyarlı olmayan (CI) harmanlama

CreateWarehouseRequest

Object

Ambar isteği yükü oluşturma.

Name Tür Description
creationPayload

WarehouseCreationPayload

Ambar oluşturma yükü. creationPayloadkullanın. definition veya creationPayload aynı anda kullanamazsınız.
description

string

Ambar açıklaması. Uzunluk üst sınırı 256 karakterdir.
displayName

string

Ambar görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.

ErrorRelatedResource

Object

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name Tür Description
resourceId

string

Hataya dahil olan kaynak kimliği.
resourceType

string

Hataya dahil olan kaynağın türü.

ErrorResponse

Object

Hata yanıtı.

Name Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message

string

Hatanın okunabilir bir gösterimi.
moreDetails

ErrorResponseDetails[]

Ek hata ayrıntılarının listesi.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.
requestId

string

Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Object

Hata yanıtı ayrıntıları.

Name Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message

string

Hatanın okunabilir bir gösterimi.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.

ItemType

Listeleme

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer Description
Dashboard

PowerBI panosu.
DataPipeline

Veri işlem hattı.
Datamart

PowerBI datamart.
Environment

Bir ortam.
Eventhouse

Bir olay evi.
Eventstream

Bir olay akışı.
GraphQLApi

GraphQL öğesi için bir API.
KQLDashboard

KQL panosu.
KQLDatabase

KQL veritabanı.
KQLQueryset

KQL sorgu kümesi.
Lakehouse

Göl evi.
MLExperiment

Makine öğrenmesi denemesi.
MLModel

Makine öğrenmesi modeli.
MirroredDatabase

Yansıtılmış veritabanı.
MirroredWarehouse

Aynalı bir depo.
MountedDataFactory

Bir MountedDataFactory.
Notebook

Bir not defteri.
PaginatedReport

PowerBI sayfalandırılmış raporu.
Reflex

Bir refleks.
Report

PowerBI raporu.
SQLDatabase

A SQLDatabase.
SQLEndpoint

Bir SQL uç noktası.
SemanticModel

PowerBI anlam modeli.
SparkJobDefinition

Spark iş tanımı.
Warehouse

Bir depo.

Warehouse

Object

Ambar nesnesi.

Name Tür Description
description

string

Öğe açıklaması.
displayName

string

Öğenin görünen adı.
id

string

uuid

Öğe kimliği.
properties

WarehouseProperties

Ambar özellikleri.
type

ItemType

Öğe türü.
workspaceId

string

uuid

Çalışma alanı kimliği.

WarehouseCreationPayload

Object

Ambar öğesi yükü

Name Tür Description
collationType

CollationType

Ambarın varsayılan harmanlama türü.

WarehouseProperties

Object

Ambar öğesi özellikleri.

Name Tür Description
collationType

CollationType

Ambarın harmanlama türü.
connectionString

string

Bu ambarı içeren çalışma alanına bağlı SQL bağlantı dizesi.
createdDate

string

date-time

Ambarın oluşturulduğu tarih ve saat.
lastUpdatedTime

string

date-time

Ambarın son güncelleştirildiği tarih ve saat