Udostępnij za pośrednictwem


Resource Groups - Create Or Update

Tworzy lub aktualizuje grupę zasobów.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów do utworzenia lub zaktualizowania. Może zawierać alfanumeryczne, podkreślenie, nawiasy, łącznik, kropkę (z wyjątkiem końca) i znaki Unicode zgodne z dozwolonymi znakami.

Wzorzec wyrażenia regularnego: ^[-\w\._\(\)]+$

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

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja grupy zasobów. Nie można go zmienić po utworzeniu grupy zasobów. Musi być jedną 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

Nazwa Typ Opis
200 OK

ResourceGroup

OK — zwraca informacje o nowej grupie zasobów.

201 Created

ResourceGroup

Utworzono — 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 OAuth2 usługi Azure Active Directory

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

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Create or update a resource group

Przykładowe żądanie

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ź

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

Definicje

Nazwa 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

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

Nazwa Typ Opis
error

ErrorResponse

Odpowiedź na błąd
Typowa odpowiedź na błąd dla wszystkich interfejsów API usługi Azure Resource Manager zwraca szczegóły błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi oData).

ErrorAdditionalInfo

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

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorResponse

Odpowiedź na błąd

Nazwa 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

Informacje o grupie zasobów.

Nazwa Typ Opis
id

string

Identyfikator grupy zasobów.

location

string

Lokalizacja grupy zasobów. Nie można go zmienić po utworzeniu grupy zasobów. Musi być jedną 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

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

Nazwa Typ Opis
provisioningState

string

Stan aprowizacji.