Bagikan melalui

Domains - Create Domain

  • Referensi
Layanan:
Admin
Versi API:
v1

Nota

API ini dalam pratinjau.

Membuat domain baru.

Izin

Pemanggil harus menjadi administrator Fabric.

Cakupan yang Didelegasikan yang Diperlukan

Tenant.ReadWrite.All.

Keterbatasan

Maksimum 25 permintaan per satu menit per prinsipal.

Identitas yang didukung Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas Dukung
Pengguna Ya
perwakilan Layanan dan identitas terkelola Ya

Antarmuka

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

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
displayName True

string

Nama tampilan domain. Nama tampilan tidak boleh berisi lebih dari 40 karakter.
description

string

Deskripsi domain. Deskripsi tidak boleh berisi lebih dari 256 karakter.
parentDomainId

string

uuid

ID objek induk domain.

Respons

Nama Jenis Deskripsi
201 Created

Domain

Domain berhasil dibuat.
Other Status Codes

ErrorResponse

Kode kesalahan umum:

  • EntityNotFound - Buat domain gagal karena ID domain induk tidak ditemukan.

  • EntityConflict - Buat domain gagal karena nama tampilan domain sudah ada.

  • InvalidInput - ID domain induk tidak valid.

Contoh

Create a domain example

Permintaan sampel

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

Respon sampel

Kode status:
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"
}

Definisi

Nama Deskripsi
ContributorsScopeType

Cakupan kontributor. Cakupan kontributor tambahan dapat ditambahkan dari waktu ke waktu.
CreateDomainRequest

Payload permintaan untuk membuat domain atau subdomain.
Domain

Mewakili domain atau subdomain.
ErrorRelatedResource

Objek detail sumber daya terkait kesalahan.
ErrorResponse

Respons kesalahan.
ErrorResponseDetails

Detail respons kesalahan.

ContributorsScopeType

Enumeration

Cakupan kontributor. Cakupan kontributor tambahan dapat ditambahkan dari waktu ke waktu.

Nilai Deskripsi
AdminsOnly

Hanya admin penyewa dan domain.
AllTenant

Semua pengguna penyewa.
SpecificUsersAndGroups

Pengguna dan grup tertentu.

CreateDomainRequest

Objek

Payload permintaan untuk membuat domain atau subdomain.

Nama Jenis Deskripsi
description

string

Deskripsi domain. Deskripsi tidak boleh berisi lebih dari 256 karakter.
displayName

string

Nama tampilan domain. Nama tampilan tidak boleh berisi lebih dari 40 karakter.
parentDomainId

string

uuid

ID objek induk domain.

Domain

Objek

Mewakili domain atau subdomain.

Nama Jenis Deskripsi
contributorsScope

ContributorsScopeType

Cakupan kontributor domain.
description

string

Deskripsi domain.
displayName

string

Nama domain.
id

string

uuid

ID objek domain.
parentDomainId

string

uuid

ID objek induk domain.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama Jenis Deskripsi
resourceId

string

ID sumber daya yang terlibat dalam kesalahan.
resourceType

string

Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama Jenis Deskripsi
errorCode

string

Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message

string

Representasi kesalahan yang dapat dibaca manusia.
moreDetails

ErrorResponseDetails[]

Daftar detail kesalahan tambahan.
relatedResource

ErrorRelatedResource

Detail sumber daya terkait kesalahan.
requestId

string

ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama Jenis Deskripsi
errorCode

string

Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message

string

Representasi kesalahan yang dapat dibaca manusia.
relatedResource

ErrorRelatedResource

Detail sumber daya terkait kesalahan.