Partager via

Resource Groups - Create Or Update

Service:
Resource Management
Version de l’API:
2021-04-01

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 d’URI

Nom Dans Obligatoire Type Description
resourceGroupName
 path True

string

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

Nom du groupe de ressources à créer ou à mettre à jour. Peut inclure des caractères alphanumériques, traits de soulignement, parenthèses, traits d’union, point (sauf à la fin) et caractères Unicode qui correspondent aux caractères autorisés.
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 requête

Nom Obligatoire Type Description
location True

string

Emplacement du groupe de ressources. Elle ne peut pas être modifiée 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 pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Couler: 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

Demande d’échantillon

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

Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group",
  "name": "my-resource-group",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}
Code d’état:
200 
{
  "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

Objet

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 afin de retourner les détails de l’erreur pour les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.)

ErrorAdditionalInfo

Objet

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

Nom Type Description
info

object

Informations supplémentaires.
type

string

Type d’informations supplémentaire.

ErrorResponse

Objet

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

Objet

Informations sur le groupe de ressources.

Nom Type Description
id

string

ID du groupe de ressources.
location

string

Emplacement du groupe de ressources. Elle ne peut pas être modifiée 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

Objet

Propriétés du groupe de ressources.

Nom Type Description
provisioningState

string

État d’approvisionnement.