Sdílet prostřednictvím

Domains - Create Domain

  • Reference
Služba:
Admin
Verze rozhraní API:
v1

Poznámka

Toto rozhraní API je ve verzi Preview.

Vytvoří novou doménu.

Dovolení

Volající musí být správcem prostředků infrastruktury.

Požadované delegovaná rozsahy

Tenant.ReadWrite.All.

Omezení

Maximálně 25 požadavků za jednu minutu na objekt zabezpečení.

Podporované identity Microsoft Entra

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

Identita Podpora
Uživatel Ano
instančního objektu a spravované identity Ano

Rozhraní

POST https://api.fabric.microsoft.com/v1/admin/domains

Text požadavku

Name Vyžadováno Typ Description
displayName True

string

Zobrazovaný název domény. Zobrazovaný název nesmí obsahovat více než 40 znaků.
description

string

Popis domény. Popis nesmí obsahovat více než 256 znaků.
parentDomainId

string

uuid

ID nadřazeného objektu domény.

Odpovědi

Name Typ Description
201 Created

Domain

Doména byla úspěšně vytvořena.
Other Status Codes

ErrorResponse

Běžné kódy chyb:

  • EntityNotFound – Vytvoření domény se nezdařilo, protože se nenašlo ID nadřazené domény.

  • EntityConflict – Vytvoření domény se nezdařilo, protože zobrazovaný název domény již existuje.

  • InvalidInput – Neplatné ID nadřazené domény

Příklady

Create a domain example

Ukázkový požadavek

POST https://api.fabric.microsoft.com/v1/admin/domains

{
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}

Ukázková odpověď

Stavový kód:
201 
{
  "id": "9eba6944-daff-4441-b9b5-630ce34238fd",
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df",
  "contributorsScope": "AllTenant"
}

Definice

Name Description
ContributorsScopeType

Obor přispěvatele. V průběhu času je možné přidat další obory přispěvatelů.
CreateDomainRequest

Datová část požadavku pro vytvoření domény nebo subdomény.
Domain

Představuje doménu nebo subdoménu.
ErrorRelatedResource

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

Odpověď na chybu.
ErrorResponseDetails

Podrobnosti o odpovědi na chybu.

ContributorsScopeType

Výčet

Obor přispěvatele. V průběhu času je možné přidat další obory přispěvatelů.

Hodnota Description
AdminsOnly

Pouze správci tenantů a domén.
AllTenant

Všichni uživatelé tenanta.
SpecificUsersAndGroups

Konkrétní uživatelé a skupiny.

CreateDomainRequest

Objekt

Datová část požadavku pro vytvoření domény nebo subdomény.

Name Typ Description
description

string

Popis domény. Popis nesmí obsahovat více než 256 znaků.
displayName

string

Zobrazovaný název domény. Zobrazovaný název nesmí obsahovat více než 40 znaků.
parentDomainId

string

uuid

ID nadřazeného objektu domény.

Domain

Objekt

Představuje doménu nebo subdoménu.

Name Typ Description
contributorsScope

ContributorsScopeType

Obor přispěvatelů domény.
description

string

Popis domény.
displayName

string

Název domény.
id

string

uuid

ID objektu domény.
parentDomainId

string

uuid

ID nadřazeného objektu domény.

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.
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

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