Hierarchy Settings - Create Or Update

Service:

Management Groups

API Version:

2020-05-01

Membuat atau memperbarui pengaturan hierarki yang ditentukan di tingkat Grup Manajemen.

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/settings/default?api-version=2020-05-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
groupId	path	True	string	ID Grup Manajemen.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien. Versi saat ini adalah pratinjau 2018-01-01.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.defaultManagementGroup	string	Pengaturan yang mengatur Grup Manajemen default tempat langganan baru ditambahkan di penyewa ini. Misalnya, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Menunjukkan apakah akses RBAC diperlukan pada pembuatan grup di bawah Grup Manajemen akar. Jika diatur ke true, pengguna akan memerlukan tindakan Microsoft.Management/managementGroups/write pada cakupan Grup Manajemen akar untuk membuat Grup baru langsung di bawah akar. Ini akan mencegah pengguna baru membuat Grup Manajemen baru, kecuali mereka diberi akses.

Respons

Nama	Jenis	Deskripsi
200 OK	HierarchySettings	OK
Other Status Codes	ErrorResponse	Kesalahan

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

GetGroupSettings

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/root/settings/default?api-version=2020-05-01

{
  "properties": {
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Sample Response

Status code:

200

{
  "id": "/providers/Microsoft.Management/managementGroups/root/settings/default",
  "type": "Microsoft.Management/managementGroups/settings",
  "name": "root",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Definisi

Nama	Deskripsi
CreateOrUpdateSettingsRequest	Parameter untuk membuat atau memperbarui pengaturan Grup Manajemen
ErrorDetails	Detail kesalahan.
ErrorResponse	Objek kesalahan.
HierarchySettings	Pengaturan yang ditentukan pada cakupan Grup Manajemen.

CreateOrUpdateSettingsRequest

Parameter untuk membuat atau memperbarui pengaturan Grup Manajemen

Nama	Jenis	Deskripsi
properties.defaultManagementGroup	string	Pengaturan yang mengatur Grup Manajemen default tempat langganan baru ditambahkan di penyewa ini. Misalnya, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Menunjukkan apakah akses RBAC diperlukan pada pembuatan grup di bawah Grup Manajemen akar. Jika diatur ke true, pengguna akan memerlukan tindakan Microsoft.Management/managementGroups/write pada cakupan Grup Manajemen akar untuk membuat Grup baru langsung di bawah akar. Ini akan mencegah pengguna baru membuat Grup Manajemen baru, kecuali mereka diberi akses.

ErrorDetails

Detail kesalahan.

Nama	Jenis	Deskripsi
code	string	Salah satu set kode kesalahan yang ditentukan server.
details	string	Representasi yang dapat dibaca manusia dari detail kesalahan.
message	string	Representasi kesalahan yang dapat dibaca manusia.

ErrorResponse

Objek kesalahan.

Nama	Jenis	Deskripsi
error	ErrorDetails	Kesalahan Detail kesalahan.

HierarchySettings

Pengaturan yang ditentukan pada cakupan Grup Manajemen.

Nama	Jenis	Deskripsi
id	string	ID yang sepenuhnya memenuhi syarat untuk objek pengaturan. Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000/settings/default.
name	string	Nama objek. Dalam hal ini, default.
properties.defaultManagementGroup	string	Pengaturan yang mengatur Grup Manajemen default tempat langganan baru ditambahkan di penyewa ini. Misalnya, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Menunjukkan apakah akses RBAC diperlukan pada pembuatan grup di bawah Grup Manajemen akar. Jika diatur ke true, pengguna akan memerlukan tindakan Microsoft.Management/managementGroups/write pada cakupan Grup Manajemen akar untuk membuat Grup baru langsung di bawah akar. Ini akan mencegah pengguna baru membuat Grup Manajemen baru, kecuali mereka diberi akses.
properties.tenantId	string	ID Penyewa AAD yang terkait dengan pengaturan hierarki. Misalnya, 00000000-0000-0000-0000-000000000000
type	string	Jenis sumber daya. Misalnya, Microsoft.Management/managementGroups/settings.