Hierarchy Settings - Create Or Update

Serviço:

Management Groups

Versão da API:

2020-05-01

Cria ou atualiza as configurações de hierarquia definidas no nível do Grupo de Gerenciamento.

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 ser usada com a solicitação do cliente. A versão atual é 2018-01-01-preview.

Corpo do Pedido

Name	Tipo	Description
properties.defaultManagementGroup	string	Configurações que definem o Grupo de Gerenciamento padrão sob o qual novas assinaturas são adicionadas neste locatário. Por exemplo, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Indica se o acesso RBAC é necessário na criação do grupo no Grupo de Gerenciamento raiz. Se definido como true, o usuário exigirá uma ação Microsoft.Management/managementGroups/write no escopo do Grupo de Gerenciamento raiz para criar novos Grupos diretamente na raiz. Isso impedirá que novos usuários criem novos Grupos de Gerenciamento, 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 Ative Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar 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 configurações do Grupo de Gerenciamento
ErrorDetails	Os detalhes do erro.
ErrorResponse	O objeto de erro.
HierarchySettings	Configurações definidas no escopo do Grupo de Gerenciamento.

CreateOrUpdateSettingsRequest

Object

Parâmetros para criar ou atualizar as configurações do Grupo de Gerenciamento

Name	Tipo	Description
properties.defaultManagementGroup	string	Configurações que definem o Grupo de Gerenciamento padrão sob o qual novas assinaturas são adicionadas neste locatário. Por exemplo, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Indica se o acesso RBAC é necessário na criação do grupo no Grupo de Gerenciamento raiz. Se definido como true, o usuário exigirá uma ação Microsoft.Management/managementGroups/write no escopo do Grupo de Gerenciamento raiz para criar novos Grupos diretamente na raiz. Isso impedirá que novos usuários criem novos Grupos de Gerenciamento, a menos que lhes seja concedido acesso.

ErrorDetails

Object

Os detalhes do erro.

Name	Tipo	Description
code	string	Um de um conjunto de códigos de erro definido 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

Object

O objeto de erro.

Name	Tipo	Description
error	ErrorDetails	Erro Os detalhes do erro.

HierarchySettings

Object

Configurações definidas no escopo do Grupo de Gerenciamento.

Name	Tipo	Description
id	string	A ID totalmente qualificada para o objeto de configurações. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000/settings/default.
name	string	O nome do objeto. Neste caso, padrão.
properties.defaultManagementGroup	string	Configurações que definem o Grupo de Gerenciamento padrão sob o qual novas assinaturas são adicionadas neste locatário. Por exemplo, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Indica se o acesso RBAC é necessário na criação do grupo no Grupo de Gerenciamento raiz. Se definido como true, o usuário exigirá uma ação Microsoft.Management/managementGroups/write no escopo do Grupo de Gerenciamento raiz para criar novos Grupos diretamente na raiz. Isso impedirá que novos usuários criem novos Grupos de Gerenciamento, a menos que lhes seja concedido acesso.
properties.tenantId	string	O ID do locatário do AAD associado às configurações de hierarquia. Por exemplo, 00000000-0000-0000-0000-00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
type	string	O tipo do recurso. Por exemplo, Microsoft.Management/managementGroups/settings.