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 |
Domænet blev oprettet. |
|
Other Status Codes |
Almindelige fejlkoder:
|
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 |
---|---|
Contributors |
Bidragyderområdet. Yderligere bidragyderområder kan tilføjes over tid. |
Create |
Nyttedata for anmodning om oprettelse af et domæne eller underdomæne. |
Domain |
Repræsenterer et domæne eller underdomæne. |
Error |
Objektet med fejlrelaterede ressourceoplysninger. |
Error |
Fejlsvaret. |
Error |
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 |
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 |
Liste over yderligere oplysninger om fejl. |
|
relatedResource |
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 |
De fejlrelaterede ressourceoplysninger. |