Hierarchy Settings - Create Or Update

Referência

Serviço:: Management Groups

Versão da API:: 2020-05-01

Cria ou atualiza as definições de hierarquia definidas ao nível do Grupo de Gestão.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
groupId	path	True	string	ID do Grupo de Gestão.
api-version	query	True	string	Versão da API a utilizar com o pedido de cliente. A versão atual é 2018-01-01-preview.

Corpo do Pedido

Name	Tipo	Description
properties.defaultManagementGroup	string	Definições que definem o Grupo de Gestão predefinido ao abrigo do qual são adicionadas novas subscrições neste inquilino. Por exemplo, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Indica se o acesso RBAC é necessário após a criação do grupo no Grupo de Gestão de raiz. Se estiver definido como verdadeiro, o utilizador exigirá a ação Microsoft.Management/managementGroups/write no âmbito do Grupo de Gestão de raiz para criar novos Grupos diretamente na raiz. Isto impedirá os novos utilizadores de criarem novos Grupos de Gestão, a menos que lhes seja concedido acesso.

Respostas

Name	Tipo	Description
200 OK	HierarchySettings	OK
Other Status Codes	ErrorResponse	Erro

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

GetGroupSettings

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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
  }
}

Definições

Name	Description
CreateOrUpdateSettingsRequest	Parâmetros para criar ou atualizar as definições do Grupo de Gestão
ErrorDetails	Os detalhes do erro.
ErrorResponse	O objeto de erro.
HierarchySettings	Definições definidas no âmbito do Grupo de Gestão.

CreateOrUpdateSettingsRequest

Parâmetros para criar ou atualizar as definições do Grupo de Gestão

Name	Tipo	Description
properties.defaultManagementGroup	string	Definições que definem o Grupo de Gestão predefinido ao abrigo do qual são adicionadas novas subscrições neste inquilino. Por exemplo, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Indica se o acesso RBAC é necessário após a criação do grupo no Grupo de Gestão de raiz. Se estiver definido como verdadeiro, o utilizador exigirá a ação Microsoft.Management/managementGroups/write no âmbito do Grupo de Gestão de raiz para criar novos Grupos diretamente na raiz. Isto impedirá os novos utilizadores de criarem novos Grupos de Gestão, a menos que lhes seja concedido acesso.

ErrorDetails

Os detalhes do erro.

Name	Tipo	Description
code	string	Um dos conjuntos de códigos de erro definidos pelo servidor.
details	string	Uma representação legível por humanos dos detalhes do erro.
message	string	Uma representação legível por humanos do erro.

ErrorResponse

O objeto de erro.

Name	Tipo	Description
error	ErrorDetails	Erro Os detalhes do erro.

HierarchySettings

Definições definidas no âmbito do Grupo de Gestão.

Name	Tipo	Description
id	string	O ID completamente qualificado para o objeto de definições. Por exemplo, /providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-000000000000000/settings/default.
name	string	O nome do objeto. Neste caso, predefinição.
properties.defaultManagementGroup	string	Definições que definem o Grupo de Gestão predefinido ao abrigo do qual são adicionadas novas subscrições neste inquilino. Por exemplo, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Indica se o acesso RBAC é necessário após a criação do grupo no Grupo de Gestão de raiz. Se estiver definido como verdadeiro, o utilizador exigirá a ação Microsoft.Management/managementGroups/write no âmbito do Grupo de Gestão de raiz para criar novos Grupos diretamente na raiz. Isto impedirá os novos utilizadores de criarem novos Grupos de Gestão, a menos que lhes seja concedido acesso.
properties.tenantId	string	O ID do Inquilino do AAD associado às definições da hierarquia. Por exemplo, 000000000-0000-0000-0000-0000000000000
type	string	O tipo de recurso. Por exemplo, Microsoft.Management/managementGroups/settings.

Partilhar via