Resource Groups - Create Or Update

Serviço:

Resource Management

Versão da API:

2021-04-01

Cria ou atualiza um grupo de recursos.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2021-04-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	O nome do grupo de recursos a ser criado ou atualizado. Pode incluir caracteres alfanuméricos, sublinhados, parênteses, hifen, ponto (exceto no final) e caracteres Unicode que correspondem aos caracteres permitidos.
subscriptionId	path	True	string	A ID da assinatura do Microsoft Azure.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
location	True	string	O local do grupo de recursos. Ele não pode ser alterado após a criação do grupo de recursos. Ele deve ser um dos locais do Azure com suporte.
managedBy		string	A ID do recurso que gerencia esse grupo de recursos.
properties		ResourceGroupProperties	As propriedades do grupo de recursos.
tags		object	As marcas anexadas ao grupo de recursos.

Respostas

Nome	Tipo	Description
200 OK	ResourceGroup	OK - Retorna informações sobre o novo grupo de recursos.
201 Created	ResourceGroup	Criado – Retorna informações sobre o novo grupo de recursos.
Other Status Codes	CloudError	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Create or update a resource group

Solicitação de exemplo

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group?api-version=2021-04-01

{
  "location": "eastus"
}

Resposta de exemplo

Código de status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group",
  "name": "my-resource-group",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}

Código de status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group",
  "name": "my-resource-group",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}

Definições

Nome	Description
CloudError	Uma resposta de erro para uma solicitação de gerenciamento de recursos.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorResponse	Resposta de erro
ResourceGroup	Informações do grupo de recursos.
ResourceGroupProperties	As propriedades do grupo de recursos.

CloudError

Objeto

Uma resposta de erro para uma solicitação de gerenciamento de recursos.

Nome	Tipo	Description
error	ErrorResponse	Resposta de erro Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorResponse[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ResourceGroup

Objeto

Informações do grupo de recursos.

Nome	Tipo	Description
id	string	A ID do grupo de recursos.
location	string	O local do grupo de recursos. Ele não pode ser alterado após a criação do grupo de recursos. Ele deve ser um dos locais do Azure com suporte.
managedBy	string	A ID do recurso que gerencia esse grupo de recursos.
name	string	O nome do grupo de recursos.
properties	ResourceGroupProperties	As propriedades do grupo de recursos.
tags	object	As marcas anexadas ao grupo de recursos.
type	string	O tipo do grupo de recursos.

ResourceGroupProperties

Objeto

As propriedades do grupo de recursos.

Nome	Tipo	Description
provisioningState	string	O estado de provisionamento.