Partager via


Resource Groups - Create Or Update

Crée ou met à jour un groupe de ressources.

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

Nom du groupe de ressources à créer ou à mettre à jour. Peut inclure des caractères alphanumériques, des traits de soulignement, des parenthèses, un trait d’union, un point (sauf à la fin) et des caractères Unicode qui correspondent aux caractères autorisés.

Modèle d’expression régulière: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID d’abonnement Microsoft Azure.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement du groupe de ressources. Il ne peut pas être modifié une fois le groupe de ressources créé. Il doit s’agir de l’un des emplacements Azure pris en charge.

managedBy

string

ID de la ressource qui gère ce groupe de ressources.

properties

ResourceGroupProperties

Propriétés du groupe de ressources.

tags

object

Balises attachées au groupe de ressources.

Réponses

Nom Type Description
200 OK

ResourceGroup

OK : retourne des informations sur le nouveau groupe de ressources.

201 Created

ResourceGroup

Créé : retourne des informations sur le nouveau groupe de ressources.

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Create or update a resource group

Exemple de requête

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

{
  "location": "eastus"
}

Exemple de réponse

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

Définitions

Nom Description
CloudError

Réponse d’erreur pour une demande de gestion des ressources.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorResponse

Réponse d’erreur

ResourceGroup

Informations sur le groupe de ressources.

ResourceGroupProperties

Propriétés du groupe de ressources.

CloudError

Réponse d’erreur pour une demande de gestion des ressources.

Nom Type Description
error

ErrorResponse

Réponse d’erreur
Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.)

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorResponse

Réponse d’erreur

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorResponse[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ResourceGroup

Informations sur le groupe de ressources.

Nom Type Description
id

string

ID du groupe de ressources.

location

string

Emplacement du groupe de ressources. Il ne peut pas être modifié une fois le groupe de ressources créé. Il doit s’agir de l’un des emplacements Azure pris en charge.

managedBy

string

ID de la ressource qui gère ce groupe de ressources.

name

string

Nom du groupe de ressources.

properties

ResourceGroupProperties

Propriétés du groupe de ressources.

tags

object

Balises attachées au groupe de ressources.

type

string

Type du groupe de ressources.

ResourceGroupProperties

Propriétés du groupe de ressources.

Nom Type Description
provisioningState

string

État d’approvisionnement.