Freigeben über


Resource Groups - Create Or Update

Erstellt oder aktualisiert eine Ressourcengruppe.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Der Name der zu erstellenden oder zu aktualisierenden Ressourcengruppe. Kann alphanumerische Zeichen, Unterstriche, Klammern, Bindestriche, Punkt (außer am Ende) und Unicode-Zeichen enthalten, die den zulässigen Zeichen entsprechen.

RegEx-Muster: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Die Microsoft Azure-Abonnement-ID.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Der Standort der Ressourcengruppe. Dieser kann nicht verändert werden, nachdem die Ressourcengruppe erstellt wurde. Es muss einer der unterstützten Azure-Standorte sein.

managedBy

string

Die ID der Ressource, die diese Ressourcengruppe verwaltet.

properties

ResourceGroupProperties

Die Ressourcengruppeneigenschaften.

tags

object

Die Tags, die an die Ressourcengruppe angefügt sind.

Antworten

Name Typ Beschreibung
200 OK

ResourceGroup

OK: Gibt Informationen zur neuen Ressourcengruppe zurück.

201 Created

ResourceGroup

Erstellt: Gibt Informationen zur neuen Ressourcengruppe zurück.

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Create or update a resource group

Beispielanforderung

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

{
  "location": "eastus"
}

Beispiel für eine Antwort

{
  "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"
  }
}

Definitionen

Name Beschreibung
CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorResponse

Fehlerantwort

ResourceGroup

Informationen zur Ressourcengruppe.

ResourceGroupProperties

Die Ressourcengruppeneigenschaften.

CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

Name Typ Beschreibung
error

ErrorResponse

Fehlerantwort
Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.)

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorResponse[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ResourceGroup

Informationen zur Ressourcengruppe.

Name Typ Beschreibung
id

string

Die ID der Ressourcengruppe.

location

string

Der Standort der Ressourcengruppe. Dieser kann nicht verändert werden, nachdem die Ressourcengruppe erstellt wurde. Es muss einer der unterstützten Azure-Standorte sein.

managedBy

string

Die ID der Ressource, die diese Ressourcengruppe verwaltet.

name

string

Der Name der Ressourcengruppe.

properties

ResourceGroupProperties

Die Ressourcengruppeneigenschaften.

tags

object

Die Tags, die an die Ressourcengruppe angefügt sind.

type

string

Der Typ der Ressourcengruppe.

ResourceGroupProperties

Die Ressourcengruppeneigenschaften.

Name Typ Beschreibung
provisioningState

string

Der Bereitstellungsstatus.