Udostępnij przez

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

Nazwa 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

Nazwa 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

Nazwa 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

Zakresów

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Create or update a resource group

Przykładowe zapytanie

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

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

Sprzeciwiać się

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

Nazwa 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

Sprzeciwiać się

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

Nazwa Typ Opis
info

object

Dodatkowe informacje.
type

string

Dodatkowy typ informacji.

ErrorResponse

Sprzeciwiać się

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

Sprzeciwiać się

Informacje o grupie zasobów.

Nazwa 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

Sprzeciwiać się

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

Nazwa Typ Opis
provisioningState

string

Stan aprowizacji.