Delen via

Resource Groups - Create Or Update

Service:
Resource Management
API-versie:
2021-04-01

Hiermee maakt of werkt u een resourcegroep bij.

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

De naam van de resourcegroep die moet worden gemaakt of bijgewerkt. Kan alfanumerieke, onderstrepingstekens, haakjes, afbreekstreepjes, punttekens (behalve aan het einde) en Unicode-tekens bevatten die overeenkomen met de toegestane tekens.
subscriptionId
 path True

string

De microsoft Azure-abonnements-id.
api-version
 query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
location True

string

De locatie van de resourcegroep. Deze kan niet worden gewijzigd nadat de resourcegroep is gemaakt. Dit moet een van de ondersteunde Azure-locaties zijn.
managedBy

string

De id van de resource die deze resourcegroep beheert.
properties

ResourceGroupProperties

De eigenschappen van de resourcegroep.
tags

object

De tags die zijn gekoppeld aan de resourcegroep.

Antwoorden

Name Type Description
200 OK

ResourceGroup

OK: retourneert informatie over de nieuwe resourcegroep.
201 Created

ResourceGroup

Gemaakt: retourneert informatie over de nieuwe resourcegroep.
Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Create or update a resource group

Voorbeeldaanvraag

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

{
  "location": "eastus"
}

Voorbeeldrespons

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

Definities

Name Description
CloudError

Een foutbericht voor een aanvraag voor resourcebeheer.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorResponse

Foutreactie
ResourceGroup

Informatie over de resourcegroep.
ResourceGroupProperties

De eigenschappen van de resourcegroep.

CloudError

Object

Een foutbericht voor een aanvraag voor resourcebeheer.

Name Type Description
error

ErrorResponse

Foutreactie
Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactie-indeling.)

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorResponse

Object

Foutreactie

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorResponse[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ResourceGroup

Object

Informatie over de resourcegroep.

Name Type Description
id

string

De id van de resourcegroep.
location

string

De locatie van de resourcegroep. Deze kan niet worden gewijzigd nadat de resourcegroep is gemaakt. Dit moet een van de ondersteunde Azure-locaties zijn.
managedBy

string

De id van de resource die deze resourcegroep beheert.
name

string

De naam van de resourcegroep.
properties

ResourceGroupProperties

De eigenschappen van de resourcegroep.
tags

object

De tags die zijn gekoppeld aan de resourcegroep.
type

string

Het type resourcegroep.

ResourceGroupProperties

Object

De eigenschappen van de resourcegroep.

Name Type Description
provisioningState

string

De inrichtingsstatus.