Del via


Domains - Create Domain

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

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

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

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

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

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

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

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

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.