Condividi tramite


Resource Groups - Create Or Update

Crea o aggiorna un gruppo di risorse.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse da creare o aggiornare. Può includere caratteri alfanumerici, caratteri di sottolineatura, parentesi, trattino, punto (tranne alla fine) e caratteri Unicode che corrispondono ai caratteri consentiti.

Criterio di espressione regolare: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID sottoscrizione di Microsoft Azure.

api-version
query True

string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
location True

string

Posizione del gruppo di risorse. Non può essere modificata dopo aver creato il gruppo di risorse. Deve essere una delle località di Azure supportate.

managedBy

string

ID della risorsa che gestisce questo gruppo di risorse.

properties

ResourceGroupProperties

Proprietà del gruppo di risorse.

tags

object

Tag associati al gruppo di risorse.

Risposte

Nome Tipo Descrizione
200 OK

ResourceGroup

OK: restituisce informazioni sul nuovo gruppo di risorse.

201 Created

ResourceGroup

Creato: restituisce informazioni sul nuovo gruppo di risorse.

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Create or update a resource group

Esempio di richiesta

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

{
  "location": "eastus"
}

Risposta di esempio

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

Definizioni

Nome Descrizione
CloudError

Risposta di errore per una richiesta di gestione delle risorse.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorResponse

Risposta di errore

ResourceGroup

Informazioni sul gruppo di risorse.

ResourceGroupProperties

Proprietà del gruppo di risorse.

CloudError

Risposta di errore per una richiesta di gestione delle risorse.

Nome Tipo Descrizione
error

ErrorResponse

Risposta di errore
Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorResponse[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ResourceGroup

Informazioni sul gruppo di risorse.

Nome Tipo Descrizione
id

string

ID del gruppo di risorse.

location

string

Posizione del gruppo di risorse. Non può essere modificata dopo aver creato il gruppo di risorse. Deve essere una delle località di Azure supportate.

managedBy

string

ID della risorsa che gestisce questo gruppo di risorse.

name

string

Nome del gruppo di risorse.

properties

ResourceGroupProperties

Proprietà del gruppo di risorse.

tags

object

Tag associati al gruppo di risorse.

type

string

Tipo del gruppo di risorse.

ResourceGroupProperties

Proprietà del gruppo di risorse.

Nome Tipo Descrizione
provisioningState

string

Stato del provisioning.