Domains - Create Domain

Tjeneste:

Admin

API-version:

v1

Seddel

Denne API er en prøveversion.

Opretter et nyt domæne.

Tilladelser

Den, der ringer op, skal være Fabric-administrator.

Påkrævede delegerede områder

Tenant.ReadWrite.All.

Begrænsninger

Maksimalt 25 anmodninger pr. minut pr. hovedkonto.

Microsoft Entra-understøttede identiteter

Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.

Identitet	Støtte
Bruger	Ja
tjenesteprincipal og administrerede identiteter	Ja

Grænseflade

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

Brødtekst for anmodning

Name	Påkrævet	Type	Beskrivelse
displayName	True	string	Det viste domænenavn. Det viste navn må ikke indeholde mere end 40 tegn.
description		string	Domænebeskrivelsen. Beskrivelsen må ikke indeholde mere end 256 tegn.
parentDomainId		string uuid	Det overordnede objekt-id for domænet.

Svar

Name	Type	Beskrivelse
201 Created	Domain	Domænet blev oprettet.
Other Status Codes	ErrorResponse	Almindelige fejlkoder: EntityNotFound – Oprettelse af domæne mislykkedes, fordi det overordnede domæne-id ikke blev fundet. EntityConflict – Oprettelse af domæne mislykkedes, fordi det viste navn for domænet allerede findes. InvalidInput – Ugyldigt overordnet domæne-id.

Eksempler

Create a domain example

Eksempelanmodning

HTTP

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

Eksempelsvar

Statuskode:

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

Definitioner

Name	Beskrivelse
ContributorsScopeType	Bidragyderområdet. Yderligere bidragyderområder kan tilføjes over tid.
CreateDomainRequest	Nyttedata for anmodning om oprettelse af et domæne eller underdomæne.
Domain	Repræsenterer et domæne eller underdomæne.
ErrorRelatedResource	Objektet med fejlrelaterede ressourceoplysninger.
ErrorResponse	Fejlsvaret.
ErrorResponseDetails	Oplysninger om fejlsvar.

ContributorsScopeType

Optælling

Bidragyderområdet. Yderligere bidragyderområder kan tilføjes over tid.

Værdi	Beskrivelse
AdminsOnly	Kun lejer- og domæneadministratorer.
AllTenant	Alle lejerens brugere.
SpecificUsersAndGroups	Specifikke brugere og grupper.

CreateDomainRequest

Object

Nyttedata for anmodning om oprettelse af et domæne eller underdomæne.

Name	Type	Beskrivelse
description	string	Domænebeskrivelsen. Beskrivelsen må ikke indeholde mere end 256 tegn.
displayName	string	Det viste domænenavn. Det viste navn må ikke indeholde mere end 40 tegn.
parentDomainId	string uuid	Det overordnede objekt-id for domænet.

Domain

Object

Repræsenterer et domæne eller underdomæne.

Name	Type	Beskrivelse
contributorsScope	ContributorsScopeType	Området for domænebidragydere.
description	string	Beskrivelsen af domænet.
displayName	string	Navnet på domænet.
id	string uuid	Domæneobjekt-id'et.
parentDomainId	string uuid	Det overordnede objekt-id for domænet.

ErrorRelatedResource

Object

Objektet med fejlrelaterede ressourceoplysninger.

Name	Type	Beskrivelse
resourceId	string	Det ressource-id, der er involveret i fejlen.
resourceType	string	Typen af ressource, der er involveret i fejlen.

ErrorResponse

Object

Fejlsvaret.

Name	Type	Beskrivelse
errorCode	string	Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message	string	En menneskelig læsbar gengivelse af fejlen.
moreDetails	ErrorResponseDetails[]	Liste over yderligere oplysninger om fejl.
relatedResource	ErrorRelatedResource	De fejlrelaterede ressourceoplysninger.
requestId	string	Id'et for den anmodning, der er knyttet til fejlen.

ErrorResponseDetails

Object

Oplysninger om fejlsvar.

Name	Type	Beskrivelse
errorCode	string	Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message	string	En menneskelig læsbar gengivelse af fejlen.
relatedResource	ErrorRelatedResource	De fejlrelaterede ressourceoplysninger.