Resource Groups - Create Or Update

Usługa:: Resource Management

Wersja interfejsu API:: 2021-04-01

Tworzy lub aktualizuje grupę zasobów.

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

Parametry identyfikatora URI

Nazwisko	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Nazwa grupy zasobów do utworzenia lub zaktualizowania. Może zawierać znaki alfanumeryczne, podkreślenie, nawiasy, łącznik, kropkę (z wyjątkiem na końcu) i znaki Unicode zgodne z dozwolonymi znakami.
subscriptionId	path	True	string	Identyfikator subskrypcji platformy Microsoft Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwisko	Wymagane	Typ	Opis
location	True	string	Lokalizacja grupy zasobów. Nie można jej zmienić po utworzeniu grupy zasobów. Musi to być jedna z obsługiwanych lokalizacji platformy Azure.
managedBy		string	Identyfikator zasobu, który zarządza tą grupą zasobów.
properties		ResourceGroupProperties	Właściwości grupy zasobów.
tags		object	Tagi dołączone do grupy zasobów.

Odpowiedzi

Nazwisko	Typ	Opis
200 OK	ResourceGroup	OK — zwraca informacje o nowej grupie zasobów.
201 Created	ResourceGroup	Created — zwraca informacje o nowej grupie zasobów.
Other Status Codes	CloudError	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Create or update a resource group

Przykładowe żądanie

HTTP

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

{
  "location": "eastus"
}

Przykładowa odpowiedź

Kod stanu:: 201

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

Kod stanu:: 200

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

Definicje

Nazwisko	Opis
CloudError	Odpowiedź na błąd żądania zarządzania zasobami.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorResponse	Odpowiedź na błąd
ResourceGroup	Informacje o grupie zasobów.
ResourceGroupProperties	Właściwości grupy zasobów.

CloudError

Objekt

Odpowiedź na błąd żądania zarządzania zasobami.

Nazwisko	Typ	Opis
error	ErrorResponse	Odpowiedź na błąd Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwisko	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwisko	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorResponse[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ResourceGroup

Objekt

Informacje o grupie zasobów.

Nazwisko	Typ	Opis
id	string	Identyfikator grupy zasobów.
location	string	Lokalizacja grupy zasobów. Nie można jej zmienić po utworzeniu grupy zasobów. Musi to być jedna z obsługiwanych lokalizacji platformy Azure.
managedBy	string	Identyfikator zasobu, który zarządza tą grupą zasobów.
name	string	Nazwa grupy zasobów.
properties	ResourceGroupProperties	Właściwości grupy zasobów.
tags	object	Tagi dołączone do grupy zasobów.
type	string	Typ grupy zasobów.

ResourceGroupProperties

Objekt

Właściwości grupy zasobów.

Nazwisko	Typ	Opis
provisioningState	string	Stan aprowizacji.