User Assigned Identities - Create Or Update

Служба:: Managed Identity

Версия API:: 2024-11-30

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}?api-version=2024-11-30

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
resourceName	path	True	string	Имя ресурса удостоверения.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

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

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
properties.isolationScope		IsolationScope	Перечисление для настройки региональных ограничений на назначение удостоверений при необходимости.
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	Identity	Операция обновления ресурса "Identity" выполнена успешно
201 Created	Identity	Операция по созданию ресурса 'Identity' выполнена успешно
Other Status Codes	CloudError	Непредвиденное сообщение об ошибке.

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

azure_auth

Azure Active Directory OAuth2 Flow.

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

Области

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

Примеры

IdentityCreate

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

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-5678-9012-123456789012/resourceGroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/resourceName?api-version=2024-11-30

{
  "location": "eastus",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}

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

Код состояния:: 200

{
  "name": "identityName",
  "type": "Microsoft.ManagedIdentity/userAssignedIdentities",
  "id": "/subscriptions/subid/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
  "location": "eastus",
  "properties": {
    "clientId": "4024ab25-56a8-4370-aea6-6389221caf29",
    "isolationScope": "None",
    "principalId": "25cc773c-7f05-40fc-a104-32d2300754ad",
    "tenantId": "b6c948ef-f6b5-4384-8354-da3a15eca969"
  },
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}

Код состояния:: 201

{
  "name": "identityName",
  "type": "Microsoft.ManagedIdentity/userAssignedIdentities",
  "id": "/subscriptions/subid/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
  "location": "eastus",
  "properties": {
    "clientId": "4024ab25-56a8-4370-aea6-6389221caf29",
    "isolationScope": "None",
    "principalId": "25cc773c-7f05-40fc-a104-32d2300754ad",
    "tenantId": "b6c948ef-f6b5-4384-8354-da3a15eca969"
  },
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}

Определения

Имя	Описание
CloudError	Ответ об ошибке службы ManagedServiceIdentity.
CloudErrorBody	Ответ об ошибке службы ManagedServiceIdentity.
createdByType	Тип удостоверения, создавшего ресурс.
Identity	Описывает ресурс удостоверений.
IsolationScope	Перечисление для настройки региональных ограничений на назначение удостоверений при необходимости.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

CloudError

Object

Ответ об ошибке службы ManagedServiceIdentity.

Имя	Тип	Описание
error	CloudErrorBody	Список дополнительных сведений об ошибке.

CloudErrorBody

Object

Ответ об ошибке службы ManagedServiceIdentity.

Имя	Тип	Описание
code	string	Идентификатор ошибки.
details	CloudErrorBody[]	Список дополнительных сведений об ошибке.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target	string	Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

Identity

Object

Описывает ресурс удостоверений.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties.clientId	string (uuid)	Идентификатор приложения, связанного с удостоверением. Это случайный код UUID с помощью MSI.
properties.isolationScope	IsolationScope	Перечисление для настройки региональных ограничений на назначение удостоверений при необходимости.
properties.principalId	string (uuid)	Идентификатор объекта субъекта-службы, связанного с созданным удостоверением.
properties.tenantId	string (uuid)	Идентификатор клиента, к которому принадлежит удостоверение.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

IsolationScope

Перечисление

Перечисление для настройки региональных ограничений на назначение удостоверений при необходимости.

Значение	Описание
None
Regional

systemData

Object

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.