Megosztás a következőn keresztül:

Domains - Create Domain

  • Referencia
Szolgáltatás:
Admin
API-verzió:
v1

Jegyzet

Ez az API előzetes verzióban érhető el.

Új tartományt hoz létre.

Engedélyek

A hívónak háló-rendszergazdának kell lennie.

Kötelező delegált hatókörök

Tenant.ReadWrite.All.

Korlátozások

Legfeljebb 25 kérelem egy percenként.

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság Támogat
Felhasználó Igen
szolgáltatásnév és felügyelt identitások Igen

Interfész

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

Kérelem törzse

Name Kötelező Típus Description
displayName True

string

A tartomány megjelenítendő neve. A megjelenítendő név legfeljebb 40 karaktert tartalmazhat.
description

string

A tartomány leírása. A leírás legfeljebb 256 karaktert tartalmazhat.
parentDomainId

string

uuid

A tartomány szülőobjektum-azonosítója.

Válaszok

Name Típus Description
201 Created

Domain

A tartomány létrehozása sikeresen megtörtént.
Other Status Codes

ErrorResponse

Gyakori hibakódok:

  • EntityNotFound – A tartomány létrehozása nem sikerült, mert a szülőtartomány azonosítója nem található.

  • EntityConflict – A tartomány létrehozása nem sikerült, mert a tartománymegjelenítés neve már létezik.

  • InvalidInput – Érvénytelen szülőtartomány-azonosító.

Példák

Create a domain example

Mintakérelem

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

Mintaválasz

Állapotkó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"
}

Definíciók

Name Description
ContributorsScopeType

A közreműködői hatókör. Idővel további közreműködői hatókörök is hozzáadhatók.
CreateDomainRequest

A tartomány vagy altartomány létrehozásához szükséges hasznos adatkérés.
Domain

Tartományt vagy altartományt jelöl.
ErrorRelatedResource

A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse

A hibaválasz.
ErrorResponseDetails

A hibaválasz részletei.

ContributorsScopeType

Enumerálás

A közreműködői hatókör. Idővel további közreműködői hatókörök is hozzáadhatók.

Érték Description
AdminsOnly

Csak bérlői és tartományi rendszergazdák.
AllTenant

A bérlő összes felhasználója.
SpecificUsersAndGroups

Adott felhasználók és csoportok.

CreateDomainRequest

Objektum

A tartomány vagy altartomány létrehozásához szükséges hasznos adatkérés.

Name Típus Description
description

string

A tartomány leírása. A leírás legfeljebb 256 karaktert tartalmazhat.
displayName

string

A tartomány megjelenítendő neve. A megjelenítendő név legfeljebb 40 karaktert tartalmazhat.
parentDomainId

string

uuid

A tartomány szülőobjektum-azonosítója.

Domain

Objektum

Tartományt vagy altartományt jelöl.

Name Típus Description
contributorsScope

ContributorsScopeType

A tartomány közreműködőinek hatóköre.
description

string

A tartomány leírása.
displayName

string

A tartomány neve.
id

string

uuid

A tartományobjektum azonosítója.
parentDomainId

string

uuid

A tartomány szülőobjektum-azonosítója.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name Típus Description
resourceId

string

A hibában érintett erőforrás-azonosító.
resourceType

string

A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
moreDetails

ErrorResponseDetails[]

További hibaadatok listája.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.
requestId

string

A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.