Aracılığıyla paylaş

Domains - Update Domain

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

Not

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

Belirtilen etki alanı bilgilerini güncelleştirir.

İ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

PATCH https://api.fabric.microsoft.com/v1/admin/domains/{domainId}

URI Parametreleri

Name İçinde Gerekli Tür Description
domainId
 path True

string

uuid

Etki alanı kimliği.

İstek Gövdesi

Name Tür Description
contributorsScope

ContributorsScopeType

Etki alanı katkıda bulunanları kapsamı.
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.

Yanıtlar

Name Tür Description
200 OK

Domain

İstek başarıyla tamamlandı.
Other Status Codes

ErrorResponse

Yaygın hata kodları:

  • UnknownError - Bir hata oluştu.

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

Örnekler

Update a domain example

Örnek isteği

PATCH https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f

{
  "displayName": "Domain's new name",
  "description": "Domain's new description",
  "contributorsScope": "SpecificUsersAndGroups"
}

Örnek yanıt

Durum kodu:
200 
{
  "id": "f2f6a374-789e-4d1d-9cc7-6e0b934fc529",
  "displayName": "Domain's new name",
  "description": "Domain's new description",
  "parentDomainId": null,
  "contributorsScope": "SpecificUsersAndGroups"
}

Tanımlar

Name Description
ContributorsScopeType

Katkıda bulunan kapsamı. Zaman içinde ek katkıda bulunan kapsamları eklenebilir.
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ı.
UpdateDomainRequest

Bir etki alanını güncelleştirmek için istek yükü.

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.

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ı.

UpdateDomainRequest

Object

Bir etki alanını güncelleştirmek için istek yükü.

Name Tür Description
contributorsScope

ContributorsScopeType

Etki alanı katkıda bulunanları kapsamı.
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.