Поделиться через


Resource Groups - Create Or Update

Создает или обновляет группу ресурсов.

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

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

Имя группы ресурсов для создания или обновления. Может включать буквенно-цифровые, символы подчеркивания, круглые скобки, дефис, точку (за исключением конца) и символы Юникода, соответствующие допустимым символам.

Шаблон регулярного выражения: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Идентификатор подписки Microsoft Azure.

api-version
query True

string

Версия API, используемая для данной операции.

Текст запроса

Имя Обязательно Тип Описание
location True

string

Расположение группы ресурсов. Его нельзя изменить после создания группы ресурсов. Это должно быть одно из поддерживаемых расположений Azure.

managedBy

string

Идентификатор ресурса, который управляет этой группой ресурсов.

properties

ResourceGroupProperties

Свойства группы ресурсов.

tags

object

Теги, присоединенные к группе ресурсов.

Ответы

Имя Тип Описание
200 OK

ResourceGroup

ОК. Возвращает сведения о новой группе ресурсов.

201 Created

ResourceGroup

Создано — возвращает сведения о новой группе ресурсов.

Other Status Codes

CloudError

Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Create or update a resource group

Образец запроса

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

{
  "location": "eastus"
}

Пример ответа

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

Определения

Имя Описание
CloudError

Ответ об ошибке для запроса на управление ресурсами.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorResponse

Сообщение об ошибке

ResourceGroup

Информация о группе ресурсов.

ResourceGroupProperties

Свойства группы ресурсов.

CloudError

Ответ об ошибке для запроса на управление ресурсами.

Имя Тип Описание
error

ErrorResponse

Сообщение об ошибке
Общие ответы об ошибках для всех API-интерфейсов Azure Resource Manager возвращать сведения об ошибках для неудачных операций. (Это также соответствует формату ответа об ошибке OData.)

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Тип дополнительных сведений.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorResponse[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ResourceGroup

Информация о группе ресурсов.

Имя Тип Описание
id

string

Идентификатор группы ресурсов.

location

string

Расположение группы ресурсов. Его нельзя изменить после создания группы ресурсов. Это должно быть одно из поддерживаемых расположений Azure.

managedBy

string

Идентификатор ресурса, который управляет этой группой ресурсов.

name

string

Имя группы ресурсов.

properties

ResourceGroupProperties

Свойства группы ресурсов.

tags

object

Теги, присоединенные к группе ресурсов.

type

string

Тип группы ресурсов.

ResourceGroupProperties

Свойства группы ресурсов.

Имя Тип Описание
provisioningState

string

Состояние подготовки.