Hierarchy Settings - Create Or Update

Referência

Service:: Management Groups

API Version:: 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 de URI

Nome	Em	Obrigatório	Tipo	Description
groupId	path	True	string	ID do Grupo de Gerenciamento.
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 da solicitação

Nome	Tipo	Description
properties.defaultManagementGroup	string	Configurações que definem o Grupo de Gerenciamento padrão sob o qual novas assinaturas são adicionadas nesse locatário. 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 Gerenciamento raiz. Se definido como true, o usuário exigirá a 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 tenham acesso.

Respostas

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Definições

Nome	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

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

Nome	Tipo	Description
properties.defaultManagementGroup	string	Configurações que definem o Grupo de Gerenciamento padrão sob o qual novas assinaturas são adicionadas nesse locatário. 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 Gerenciamento raiz. Se definido como true, o usuário exigirá a 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 tenham acesso.

ErrorDetails

Os detalhes do erro.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
details	string	Uma representação legível por humanos dos detalhes do erro.
message	string	Uma representação legível pelo homem do erro.

ErrorResponse

O objeto de erro.

Nome	Tipo	Description
error	ErrorDetails	Erro Os detalhes do erro.

HierarchySettings

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

Nome	Tipo	Description
id	string	A ID totalmente qualificada para o objeto de configurações. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000000/settings/default.
name	string	O nome do objeto. Nesse caso, padrão.
properties.defaultManagementGroup	string	Configurações que definem o Grupo de Gerenciamento padrão sob o qual novas assinaturas são adicionadas nesse locatário. 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 Gerenciamento raiz. Se definido como true, o usuário exigirá a 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 tenham acesso.
properties.tenantId	string	A ID do Locatário do AAD associada às configurações de hierarquia. Por exemplo, 000000000-0000-0000-0000-0000000000000
type	string	Tipo do recurso. Por exemplo, Microsoft.Management/managementGroups/settings.