Resource Groups - Create Or Update

Service:

Resource Management

API Version:

2021-04-01

Membuat atau memperbarui grup sumber daya.

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

Parameter URI

Name	In	Required	Type	Description
resourceGroupName	path	True	string	Nama grup sumber daya yang akan dibuat atau diperbarui. Dapat menyertakan karakter alfanumerik, garis bawah, tanda kurung, tanda hubung, titik (kecuali di akhir), dan karakter Unicode yang cocok dengan karakter yang diizinkan. Regex pattern: ^[-\w\._\(\)]+$
subscriptionId	path	True	string	ID langganan Microsoft Azure.
api-version	query	True	string	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Name	Required	Type	Description
location	True	string	Lokasi grup sumber daya. Ini tidak dapat diubah setelah grup sumber daya dibuat. Ini harus menjadi salah satu lokasi Azure yang didukung.
managedBy		string	ID sumber daya yang mengelola grup sumber daya ini.
properties		ResourceGroupProperties	Properti grup sumber daya.
tags		object	Tag yang dilampirkan ke grup sumber daya.

Respons

Name	Type	Description
200 OK	ResourceGroup	OK - Mengembalikan informasi tentang grup sumber daya baru.
201 Created	ResourceGroup	Dibuat - Mengembalikan informasi tentang grup sumber daya baru.
Other Status Codes	CloudError	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name	Description
user_impersonation	meniru akun pengguna Anda

Contoh

Create or update a resource group

Sample Request

HTTP

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

{
  "location": "eastus"
}

Go

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/tree/main/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()
	client, err := armresources.NewResourceGroupsClient("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := client.CreateOrUpdate(ctx,
		"my-resource-group",
		armresources.ResourceGroup{
			Location: to.Ptr("eastus"),
		},
		nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// TODO: use response item
	_ = res
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

JavsScirpt

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 = "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = "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);
}

createOrUpdateAResourceGroup().catch(console.error);

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:

201

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

Status code:

200

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

Definisi

CloudError	Respons kesalahan untuk permintaan manajemen sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorResponse	Respons Kesalahan
ResourceGroup	Informasi grup sumber daya.
ResourceGroupProperties	Properti grup sumber daya.

CloudError

Respons kesalahan untuk permintaan manajemen sumber daya.

Name	Type	Description
error	ErrorResponse	Respons Kesalahan Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.)

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Name	Type	Description
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorResponse

Respons Kesalahan

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorResponse[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ResourceGroup

Informasi grup sumber daya.

Name	Type	Description
id	string	ID grup sumber daya.
location	string	Lokasi grup sumber daya. Ini tidak dapat diubah setelah grup sumber daya dibuat. Ini harus menjadi salah satu lokasi Azure yang didukung.
managedBy	string	ID sumber daya yang mengelola grup sumber daya ini.
name	string	Nama grup sumber daya.
properties	ResourceGroupProperties	Properti grup sumber daya.
tags	object	Tag yang dilampirkan ke grup sumber daya.
type	string	Jenis grup sumber daya.

ResourceGroupProperties

Properti grup sumber daya.

Name	Type	Description
provisioningState	string	Status penyediaan.