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

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

{
  "___location": "eastus"
}

package armresources_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresources"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4fd842fb73656039ec94ce367bcedee25a57bd18/specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/CreateResourceGroup.json
func ExampleResourceGroupsClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armresources.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewResourceGroupsClient().CreateOrUpdate(ctx, "my-resource-group", armresources.ResourceGroup{
		Location: to.Ptr("eastus"),
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ResourceGroup = armresources.ResourceGroup{
	// 	Name: to.Ptr("my-resource-group"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group"),
	// 	Location: to.Ptr("eastus"),
	// 	Properties: &armresources.ResourceGroupProperties{
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ResourceManagementClient } = require("@azure/arm-resources");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Creates or updates a resource group.
 *
 * @summary Creates or updates a resource group.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/CreateResourceGroup.json
 */
async function createOrUpdateAResourceGroup() {
  const subscriptionId =
    process.env["RESOURCES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["RESOURCES_RESOURCE_GROUP"] || "my-resource-group";
  const parameters = { ___location: "eastus" };
  const credential = new DefaultAzureCredential();
  const client = new ResourceManagementClient(credential, subscriptionId);
  const result = await client.resourceGroups.createOrUpdate(resourceGroupName, parameters);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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.

Partilhar via

Resource Groups - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Create or update a resource group

Pedido de amostra

Resposta da amostra

Definições

CloudError

ErrorAdditionalInfo

ErrorResponse

ResourceGroup

ResourceGroupProperties