Aracılığıyla paylaş

Domains - Create Domain

  • Başvuru
Hizmet:
Admin
API Sürümü:
v1

Not

Bu API önizleme aşamasındadır.

Yeni bir etki alanı oluşturur.

İzinler

Çağıranın Doku yöneticisi olması gerekir.

Gerekli Temsilci Kapsamları

Tenant.ReadWrite.All.

Sınırlama

Sorumlu başına bir dakika başına en fazla 25 istek.

Microsoft Entra tarafından desteklenen kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik Destek
Kullanıcı Evet
Hizmet sorumlusu ve yönetilen kimlikler Evet

Arayüz

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

İstek Gövdesi

Name Gerekli Tür Description
displayName True

string

Etki alanı görünen adı. Görünen ad 40'tan fazla karakter içeremez.
description

string

Etki alanı açıklaması. Açıklama 256'dan fazla karakter içeremez.
parentDomainId

string

uuid

Etki alanı üst nesne kimliği.

Yanıtlar

Name Tür Description
201 Created

Domain

Etki alanı başarıyla oluşturuldu.
Other Status Codes

ErrorResponse

Yaygın hata kodları:

  • EntityNotFound - Üst etki alanı kimliği bulunamadığından etki alanı oluşturulamadı.

  • EntityConflict - Etki alanı görünen adı zaten mevcut olduğundan etki alanı oluşturulamadı.

  • InvalidInput - Geçersiz üst etki alanı kimliği.

Örnekler

Create a domain example

Örnek isteği

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

Örnek yanıt

Durum kodu:
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"
}

Tanımlar

Name Description
ContributorsScopeType

Katkıda bulunan kapsamı. Zaman içinde ek katkıda bulunan kapsamları eklenebilir.
CreateDomainRequest

Etki alanı veya alt etki alanı oluşturmak için istek yükü.
Domain

Bir etki alanını veya alt etki alanını temsil eder.
ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse

Hata yanıtı.
ErrorResponseDetails

Hata yanıtı ayrıntıları.

ContributorsScopeType

Listeleme

Katkıda bulunan kapsamı. Zaman içinde ek katkıda bulunan kapsamları eklenebilir.

Değer Description
AdminsOnly

Yalnızca kiracı ve etki alanı yöneticileri.
AllTenant

Kiracının tüm kullanıcıları.
SpecificUsersAndGroups

Belirli kullanıcılar ve gruplar.

CreateDomainRequest

Object

Etki alanı veya alt etki alanı oluşturmak için istek yükü.

Name Tür Description
description

string

Etki alanı açıklaması. Açıklama 256'dan fazla karakter içeremez.
displayName

string

Etki alanı görünen adı. Görünen ad 40'tan fazla karakter içeremez.
parentDomainId

string

uuid

Etki alanı üst nesne kimliği.

Domain

Object

Bir etki alanını veya alt etki alanını temsil eder.

Name Tür Description
contributorsScope

ContributorsScopeType

Etki alanı katkıda bulunanları kapsamı.
description

string

Etki alanının açıklaması.
displayName

string

Etki alanının adı.
id

string

uuid

Etki alanı nesne kimliği.
parentDomainId

string

uuid

Etki alanı üst nesne kimliği.

ErrorRelatedResource

Object

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name Tür Description
resourceId

string

Hataya dahil olan kaynak kimliği.
resourceType

string

Hataya dahil olan kaynağın türü.

ErrorResponse

Object

Hata yanıtı.

Name Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message

string

Hatanın okunabilir bir gösterimi.
moreDetails

ErrorResponseDetails[]

Ek hata ayrıntılarının listesi.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.
requestId

string

Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Object

Hata yanıtı ayrıntıları.

Name Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message

string

Hatanın okunabilir bir gösterimi.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.