Resource Groups - Create Or Update

Služba:

Resource Management

Verze rozhraní API:

2021-04-01

Vytvoří nebo aktualizuje skupinu prostředků.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	Název skupiny prostředků, která se má vytvořit nebo aktualizovat Může obsahovat alfanumerické znaky, podtržítka, závorky, pomlčky, tečky (s výjimkou na konci) a znaky Unicode, které odpovídají povoleným znakům.
subscriptionId	path	True	string	ID předplatného Microsoft Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Umístění skupiny prostředků. Po vytvoření skupiny prostředků ji nelze změnit. Musí to být jedno z podporovaných umístění Azure.
managedBy		string	ID prostředku, který spravuje tuto skupinu prostředků.
properties		ResourceGroupProperties	Vlastnosti skupiny prostředků.
tags		object	Značky připojené ke skupině prostředků.

Odpovědi

Name	Typ	Description
200 OK	ResourceGroup	OK – Vrátí informace o nové skupině prostředků.
201 Created	ResourceGroup	Vytvořeno – vrátí informace o nové skupině prostředků.
Other Status Codes	CloudError	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Create or update a resource group

Ukázkový požadavek

HTTP

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

{
  "location": "eastus"
}

Ukázková odpověď

Stavový kód:

201

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

Stavový kód:

200

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

Definice

Name	Description
CloudError	Odpověď na chybu žádosti o správu prostředků.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorResponse	Odpověď na chybu
ResourceGroup	Informace o skupině prostředků
ResourceGroupProperties	Vlastnosti skupiny prostředků.

CloudError

Objekt

Odpověď na chybu žádosti o správu prostředků.

Name	Typ	Description
error	ErrorResponse	Odpověď na chybu Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorResponse

Objekt

Odpověď na chybu

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorResponse[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ResourceGroup

Objekt

Informace o skupině prostředků

Name	Typ	Description
id	string	ID skupiny prostředků.
location	string	Umístění skupiny prostředků. Po vytvoření skupiny prostředků ji nelze změnit. Musí to být jedno z podporovaných umístění Azure.
managedBy	string	ID prostředku, který spravuje tuto skupinu prostředků.
name	string	Název skupiny prostředků.
properties	ResourceGroupProperties	Vlastnosti skupiny prostředků.
tags	object	Značky připojené ke skupině prostředků.
type	string	Typ skupiny prostředků.

ResourceGroupProperties

Objekt

Vlastnosti skupiny prostředků.

Name	Typ	Description
provisioningState	string	Stav zřizování.