Compartilhar via


Resource Groups - Create Or Update

Criar ou atualizar 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

O nome do grupo de recursos a ser criado ou atualizado. Pode incluir caracteres alfanuméricos, sublinhados, parênteses, hífen, ponto final (exceto no final) e caracteres Unicode que correspondem aos caracteres permitidos.

Padrão Regex: ^[-\w\._\(\)]+$

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

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

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group",
  "name": "my-resource-group",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}
{
  "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

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 para retornar detalhes de erro de operações com falha. (Isso também segue o formato de resposta de erro OData.)

ErrorAdditionalInfo

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

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

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

As propriedades do grupo de recursos.

Nome Tipo Description
provisioningState

string

O estado de provisionamento.