Udostępnij za pośrednictwem

Items - Update Warehouse

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

Aktualizuje właściwości określonego magazynu.

Uprawnienia

Obiekt wywołujący musi mieć rolę współautora lub wyższą.

Wymagane zakresy delegowane

Warehouse.ReadWrite.All lub Item.ReadWrite.All

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

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
warehouseId
 path True

string

uuid

Identyfikator magazynu.
workspaceId
 path True

string

uuid

Identyfikator obszaru roboczego.

Treść żądania

Nazwa Typ Opis
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.

Odpowiedzi

Nazwa Typ Opis
200 OK

Warehouse

Żądanie zostało ukończone pomyślnie.
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • ItemNotFound — żądany element nie został znaleziony.

  • InvalidRequest — nieprawidłowe żądanie aktualizacji.

Przykłady

Update a warehouse example

Przykładowe żądanie

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses/5b218778-e7a5-4d73-8187-f10824047715

{
  "displayName": "Warehouse's New name",
  "description": "A new description for warehouse."
}

Przykładowa odpowiedź

Kod stanu:
200 
{
  "displayName": "Warehouse's New name",
  "description": "A new description for warehouse.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "properties": {
    "connectionString": "x6eps4xrq2xudenlfv6naeo3i4-ro6aurrmwwpujdbmljjuqvyisi.msit-datawarehouse.fabric.microsoft.com",
    "createdDate": "2025-03-04T18:20:39.5261099",
    "lastUpdatedTime": "2025-03-05T17:23:03.3485446",
    "collationType": "Latin1_General_100_BIN2_UTF8"
  }
}

Definicje

Nazwa Opis
CollationType

Sortowanie magazynu. Dodatkowe collations można dodawać z upływem czasu.
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.
UpdateWarehouseRequest

Aktualizowanie żądania magazynu.
Warehouse

Obiekt 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

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.

UpdateWarehouseRequest

Objekt

Aktualizowanie żądania magazynu.

Nazwa Typ Opis
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.

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.

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