Workspaces - Create Workspace

Služba:
Core
Verze rozhraní API:
v1

Vytvoří nový pracovní prostor.

Povolení

Požadované delegovaná rozsahy

Workspace.ReadWrite.All

Limity škrcení

Typ limitu Value
Sjednocená kvóta pro rozhraní API platformy 200 volání za minutu
Limit rozhraní API 200 volání za minutu

Podporované identity v Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita Podpora
Uživatel Ano
Hlavní služba a Spravované identity Ano

Rozhraní

POST https://api.fabric.microsoft.com/v1/workspaces

Text požadavku

Name Vyžadováno Typ Description
displayName True

string

Zobrazovaný název pracovního prostoru.
Zobrazovaný název nesmí obsahovat více než 256 znaků.
Jsou povoleny pouze názvy nepoužívaných pracovních prostorů.
Monitorování správců je název vyhrazeného pracovního prostoru.
capacityId

string (uuid)

ID kapacity pro přiřazení pracovního prostoru.
description

string

Popis pracovního prostoru.
Popis nesmí obsahovat více než 4 000 znaků.
domainId

string (uuid)

ID domény pro přiřazení pracovního prostoru.

Odpovědi

Name Typ Description
201 Created

Workspace

Úspěšně se vytvořilo.

Hlavičky

Location: string
429 Too Many Requests

ErrorResponse

Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku označující Retry-After , jak dlouho musí klient čekat před odesláním dalších požadavků.

Hlavičky

Retry-After: integer
Other Status Codes

ErrorResponse

Běžné kódy chyb:

  • DomainNotFound – Zadaná doména nebyla nalezena.

  • InsufficientPermissionsToDomain – Oprávnění uživatele k doméně nestačí k provedení operace.

  • Neznámá chyba – došlo k chybě.

Příklady

Create a workspace example

Ukázkový požadavek

POST https://api.fabric.microsoft.com/v1/workspaces

{
  "displayName": "New workspace"
}

Ukázková odpověď

Stavový kód:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb22287ff
{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb22287ff",
  "displayName": "New workspace",
  "description": "",
  "type": "Workspace",
  "capacityRegion": "West US"
}

Definice

Name Description
CapacityRegion

Oblast kapacity přidružené k tomuto pracovnímu prostoru V průběhu času je možné přidat další hodnoty oblasti kapacity.
CreateWorkspaceRequest

Vytvořte datovou část žádosti o pracovní prostor.
ErrorRelatedResource

Chyba související s objektem podrobností o prostředku.
ErrorResponse

Odpověď na chybu.
ErrorResponseDetails

Podrobnosti o odpovědi na chybu.
Workspace

Objekt pracovního prostoru.
WorkspaceAppliedTag

Představuje použitou značku.
WorkspaceType

Typ pracovního prostoru. V průběhu času je možné přidat další typy pracovních prostorů.

CapacityRegion

Výčet

Oblast kapacity přidružené k tomuto pracovnímu prostoru V průběhu času je možné přidat další hodnoty oblasti kapacity.

Hodnota Description
Australia East

Austrálie – východ
Australia Southeast

Austrálie – jihovýchod
Brazil South

Brazílie – jih
Brazil Southeast

Brazílie – jihovýchod
Canada Central

Kanada – střed
Canada East

Kanada – východ
Central India

Oblast Indie – střed
Central US

Oblast USA – střed
Central US EUAP

Oblast EUAP – střed USA
East Asia

Východní Asie
East US

Oblast USA – východ
East US 2

OBLAST USA – východ 2
France Central

Francie – střed
France South

Francie – jih
Germany Central

Německo – střed
Germany Northeast

Německo – severovýchod
Israel Central

Izrael – střed
Italy North

Itálie – sever
Japan East

Japonsko – východ
Japan West

Japonsko – západ
Korea Central

Korea – střed
Korea South

Jižní Korea – jih
Mexico Central

Mexiko – střed
North Central US

Oblast USA – středosever
North Europe

Severní Evropa – oblast
Norway East

Norsko – východ
Norway West

Norsko – západ
Poland Central

Polsko – střed
South Africa North

Jižní Afrika – sever
South Africa West

Jižní Afrika – západ
South Central US

Oblast USA – středojižní
South India

Oblast Indie – jih
Southeast Asia

Jihovýchodní Asie – oblast
Spain Central

Španělsko – střed
Sweden Central

Švédsko – střed
Switzerland North

Švýcarsko – sever
Switzerland West

Oblast Švýcarsko – západ
West Europe

Oblast Západní Evropa
West India

Oblast Indie – západ
West US

Oblast USA – západ
West US 2

Oblast USA – západ 2
West US 3

Oblast USA – západ 3
West Central US

Oblast USA – středozápad
UAE Central

Spojené arabské emiráty – střed
UAE North

Spojené arabské emiráty – sever
Qatar Central

Katar – střed
Germany West Central

Německo – středozápad
Germany North

Německo – sever
UK South

Velká Británie – jih
UK West

Oblast Velká Británie – západ
China North

Čína – sever
China East

Oblast Čína – východ
China East 2

Čína – východ 2 – oblast
China East 3

Čína – východ 3 – oblast
China North 2

Čína – sever 2 – oblast
China North 3

Čína – sever 3

CreateWorkspaceRequest

Objekt

Vytvořte datovou část žádosti o pracovní prostor.

Name Typ Description
capacityId

string (uuid)

ID kapacity pro přiřazení pracovního prostoru.
description

string

Popis pracovního prostoru.
Popis nesmí obsahovat více než 4 000 znaků.
displayName

string

Zobrazovaný název pracovního prostoru.
Zobrazovaný název nesmí obsahovat více než 256 znaků.
Jsou povoleny pouze názvy nepoužívaných pracovních prostorů.
Monitorování správců je název vyhrazeného pracovního prostoru.
domainId

string (uuid)

ID domény pro přiřazení pracovního prostoru.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name Typ Description
resourceId

string

ID prostředku, které je součástí chyby.
resourceType

string

Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
isRetriable

boolean

Pokud je hodnota true, je možné požadavek opakovat. Pomocí hlavičky Retry-After odpovědi určete zpoždění, pokud je k dispozici.
message

string

Lidské čitelné vyjádření chyby.
moreDetails

ErrorResponseDetails[]

Seznam dalších podrobností o chybě
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou
requestId

string (uuid)

ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

Workspace

Objekt

Objekt pracovního prostoru.

Name Typ Description
apiEndpoint

string (uri)

Adresa URL PROTOKOLU HTTP, která představuje koncový bod rozhraní API specifický pro daný pracovní prostor. Tato hodnota koncového bodu se vrátí, když uživatel povolí preferWorkspaceSpecificEndpoints. Umožňuje přístup k rozhraní API přes privátní propojení.
capacityId

string (uuid)

ID kapacity, ke které je pracovní prostor přiřazen.
capacityRegion

CapacityRegion

Oblast kapacity přidružené k tomuto pracovnímu prostoru
description

string

Popis pracovního prostoru.
displayName

string

Zobrazovaný název pracovního prostoru.
domainId

string (uuid)

ID domény, ke které je pracovní prostor přiřazen.
id

string (uuid)

Identifikátor pracovního prostoru.
tags

WorkspaceAppliedTag[]

Seznam použitých značek
type

WorkspaceType

Typ pracovního prostoru.

WorkspaceAppliedTag

Objekt

Představuje použitou značku.

Name Typ Description
displayName

string

Název značky.
id

string (uuid)

ID značky.

WorkspaceType

Výčet

Typ pracovního prostoru. V průběhu času je možné přidat další typy pracovních prostorů.

Hodnota Description
Personal

Složka nebo pracovní prostor použitý ke správě položek uživatelů
Workspace

Pracovní prostor používaný ke správě položek infrastruktury
AdminWorkspace

Pracovní prostor monitorování pro správce Obsahuje sestavy správců, jako je sestava auditu a sestava využití a přijetí.