Hierarchy Settings - Create Or Update

관리 그룹 수준에서 정의된 계층 설정을 만들거나 업데이트합니다.

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

URI 매개 변수

Name In Required Type Description
groupId
path True
  • string

관리 그룹 ID입니다.

api-version
query True
  • string

클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2018-01-01-preview입니다.

요청 본문

Name Type Description
properties.defaultManagementGroup
  • string

이 테넌트에 새 구독이 추가되는 기본 관리 그룹을 설정하는 설정. 예: /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation
  • boolean

루트 관리 그룹에서 그룹을 만들 때 RBAC 액세스가 필요한지 여부를 나타냅니다. true로 설정하면 루트 바로 아래에 새 그룹을 만들려면 루트 관리 그룹 범위에 대한 Microsoft.Management/managementGroups/write 작업이 필요합니다. 이렇게 하면 액세스 권한이 부여되지 않는 한 새 사용자가 새 관리 그룹을 만들지 못하게 됩니다.

응답

Name Type Description
200 OK

확인

Other Status Codes

Error

보안

azure_auth

OAuth2 Flow Azure Active Directory.

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

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

정의

CreateOrUpdateSettingsRequest

관리 그룹 설정을 만들거나 업데이트하기 위한 매개 변수

ErrorDetails

오류의 세부 정보입니다.

ErrorResponse

오류 개체입니다.

HierarchySettings

설정 관리 그룹 범위에 정의됩니다.

CreateOrUpdateSettingsRequest

관리 그룹 설정을 만들거나 업데이트하기 위한 매개 변수

Name Type Description
properties.defaultManagementGroup
  • string

이 테넌트에 새 구독이 추가되는 기본 관리 그룹을 설정하는 설정. 예: /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation
  • boolean

루트 관리 그룹에서 그룹을 만들 때 RBAC 액세스가 필요한지 여부를 나타냅니다. true로 설정하면 루트 바로 아래에 새 그룹을 만들려면 루트 관리 그룹 범위에 대한 Microsoft.Management/managementGroups/write 작업이 필요합니다. 이렇게 하면 액세스 권한이 부여되지 않는 한 새 사용자가 새 관리 그룹을 만들지 못하게 됩니다.

ErrorDetails

오류의 세부 정보입니다.

Name Type Description
code
  • string

서버에서 정의한 오류 코드 집합 중 하나입니다.

details
  • string

사용자가 읽을 수 있는 오류 세부 정보 표현입니다.

message
  • string

사람이 읽을 수 있는 오류 표현입니다.

ErrorResponse

오류 개체입니다.

Name Type Description
error

Error
오류의 세부 정보입니다.

HierarchySettings

설정 관리 그룹 범위에 정의됩니다.

Name Type Description
id
  • string

설정 개체의 정규화된 ID입니다. 예를 들어 /providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-000000000000/settings/default입니다.

name
  • string

개체의 이름입니다. 이 경우 기본값입니다.

properties.defaultManagementGroup
  • string

이 테넌트에 새 구독이 추가되는 기본 관리 그룹을 설정하는 설정. 예: /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation
  • boolean

루트 관리 그룹에서 그룹을 만들 때 RBAC 액세스가 필요한지 여부를 나타냅니다. true로 설정하면 루트 바로 아래에 새 그룹을 만들려면 루트 관리 그룹 범위에 대한 Microsoft.Management/managementGroups/write 작업이 필요합니다. 이렇게 하면 액세스 권한이 부여되지 않는 한 새 사용자가 새 관리 그룹을 만들지 못하게 됩니다.

properties.tenantId
  • string

계층 설정과 연결된 AAD 테넌트 ID입니다. 예를 들어 000000000-0000-0000-0000-000000000000

type
  • string

리소스 형식입니다. 예를 들어 Microsoft.Management/managementGroups/settings입니다.