Hierarchy Settings - Create Or Update

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

Name In Required Type Description
groupId
path True
  • string

ID Grup Manajemen.

api-version
query True
  • string

Versi API yang akan digunakan dengan permintaan klien. Versi saat ini adalah 2018-01-01-preview.

Isi Permintaan

Name Type Description
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 saat 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

Name Type Description
200 OK

OK

Other Status Codes

Kesalahan

Keamanan

azure_auth

Azure Active Directory Flow OAuth2.

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

Scopes

Name Description
user_impersonation meniru akun pengguna Anda

Contoh

GetGroupSettings

Sample Request

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

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

CreateOrUpdateSettingsRequest

Parameter untuk membuat atau memperbarui pengaturan Grup Manajemen

ErrorDetails

Detail kesalahan.

ErrorResponse

Objek kesalahan.

HierarchySettings

Pengaturan ditentukan pada cakupan Grup Manajemen.

CreateOrUpdateSettingsRequest

Parameter untuk membuat atau memperbarui pengaturan Grup Manajemen

Name Type Description
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 saat 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.

Name Type Description
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.

Name Type Description
error

Kesalahan
Detail kesalahan.

HierarchySettings

Pengaturan ditentukan pada cakupan Grup Manajemen.

Name Type Description
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 saat 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, 000000000-0000-0000-0000-000000000000

type
  • string

Jenis sumber daya. Misalnya, Microsoft.Management/managementGroups/settings.