Sdílet prostřednictvím


Resource Groups - Create Or Update

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

Název skupiny prostředků, která se má vytvořit nebo aktualizovat. Může obsahovat alfanumerické znaky, podtržítka, závorky, spojovníky, tečky (s výjimkou na konci) a znaky Unicode, které odpovídají povoleným znakům.

Vzor regulárního výrazu: ^[-\w\._\(\)]+$

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 není možné změnit. Musí se jednat o 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

Tok Azure Active Directory OAuth2

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

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ěď

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

Definice

Name Description
CloudError

Chybová odpověď pro žádost 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

Chybová odpověď pro žádost o správu prostředků.

Name Typ Description
error

ErrorResponse

Odpověď na chybu
Běžná chybová odpověď pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (Tento formát také odpovídá formátu odpovědi na chybu OData.)

ErrorAdditionalInfo

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

Name Typ Description
info

object

Další informace.

type

string

Typ další informace.

ErrorResponse

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

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 není možné změnit. Musí se jednat o 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

Vlastnosti skupiny prostředků.

Name Typ Description
provisioningState

string

Stav zřizování.