Freigeben über

Resource Groups - Create Or Update

Dienst:
Resource Management
API-Version:
2021-04-01

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

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

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

string

Die Microsoft Azure-Abonnement-ID.
api-version
 query True

string

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Ressourcengruppenspeicherort auswählen. Sie kann nicht geändert werden, nachdem die Ressourcengruppe erstellt wurde. Es muss sich um einen der unterstützten Azure-Speicherorte sein.
managedBy

string

Die ID der Ressource, die diese Ressourcengruppe verwaltet.
properties

ResourceGroupProperties

Die Ressourcengruppeneigenschaften.
tags

object

Die tags, die der Ressourcengruppe zugeordnet 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, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

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

Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorResponse

Fehlerantwort
ResourceGroup

Ressourcengruppeninformationen.
ResourceGroupProperties

Die Ressourcengruppeneigenschaften.

CloudError

Objekt

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

Name Typ Beschreibung
error

ErrorResponse

Fehlerantwort
Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.
type

string

Der zusätzliche Informationstyp.

ErrorResponse

Objekt

Fehlerantwort

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.
code

string

Der Fehlercode.
details

ErrorResponse[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ResourceGroup

Objekt

Ressourcengruppeninformationen.

Name Typ Beschreibung
id

string

Die ID der Ressourcengruppe.
location

string

Ressourcengruppenspeicherort auswählen. Sie kann nicht geändert werden, nachdem die Ressourcengruppe erstellt wurde. Es muss sich um einen der unterstützten Azure-Speicherorte 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 der Ressourcengruppe zugeordnet sind.
type

string

Der Typ der Ressourcengruppe.

ResourceGroupProperties

Objekt

Die Ressourcengruppeneigenschaften.

Name Typ Beschreibung
provisioningState

string

Der Bereitstellungsstatus.