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

Name	Em	Necessá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, hífen, ponto (exceto no final) e Unicode que correspondam aos caracteres permitidos.
subscriptionId	path	True	string	A ID de assinatura do Microsoft Azure.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A localização do grupo de recursos. Ele não pode ser alterado após a criação do grupo de recursos. Tem de ser uma das localizações do Azure suportadas.
managedBy		string	A ID do recurso que gerencia esse grupo de recursos.
properties		ResourceGroupProperties	As propriedades do grupo de recursos.
tags		object	As tags anexadas ao grupo de recursos.

Respostas

Name	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 descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Create or update a resource group

Pedido de amostra

HTTP

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

{
  "location": "eastus"
}

Resposta da amostra

Código de estado:

201

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

Código de estado:

200

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

Definições

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

CloudError

Object

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

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

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

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

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
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

Object

Informações do grupo de recursos.

Name	Tipo	Description
id	string	A ID do grupo de recursos.
location	string	A localização do grupo de recursos. Ele não pode ser alterado após a criação do grupo de recursos. Tem de ser uma das localizações do Azure suportadas.
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 tags anexadas ao grupo de recursos.
type	string	O tipo do grupo de recursos.

ResourceGroupProperties

Object

As propriedades do grupo de recursos.

Name	Tipo	Description
provisioningState	string	O estado de provisionamento.