User Assigned Identities - Create Or Update

Referenz

Dienst:: Managed Identity

API-Version:: 2024-11-30

Erstellen oder Aktualisieren einer Identität in der angegebenen Abonnement- und Ressourcengruppe.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, zu der die Identität gehört.
resourceName	path	True	string	Der Name der Identitätsressource.
subscriptionId	path	True	string	Die ID des Abonnements, zu dem die Identität gehört.
api-version	query	True	string	Version der API, die aufgerufen werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
location	True	string	Der geografische Standort, an dem sich die Ressource befindet
properties.isolationScope		isolationScope	Aufzählung, um regionale Einschränkungen für die Identitätszuweisung nach Bedarf zu konfigurieren.
tags		object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	Identity	Aktualisierte Identität
201 Created	Identity	Erstellte Identität
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

IdentityCreate

Beispielanforderung

HTTP

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

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

Beispiel für eine Antwort

Statuscode:: 201

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

Statuscode:: 200

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

Definitionen

Name	Beschreibung
CloudError	Eine Fehlerantwort des ManagedServiceIdentity-Diensts.
CloudErrorBody	Eine Fehlerantwort des ManagedServiceIdentity-Diensts.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
Identity	Beschreibt eine Identitätsressource.
isolationScope	Aufzählung, um regionale Einschränkungen für die Identitätszuweisung nach Bedarf zu konfigurieren.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

CloudError

Eine Fehlerantwort des ManagedServiceIdentity-Diensts.

Name	Typ	Beschreibung
error	CloudErrorBody	Eine Liste mit zusätzlichen Details zum Fehler.

CloudErrorBody

Eine Fehlerantwort des ManagedServiceIdentity-Diensts.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler.
details	CloudErrorBody[]	Eine Liste mit zusätzlichen Details zum Fehler.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
target	string	Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

Identity

Beschreibt eine Identitätsressource.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.clientId	string	Die ID der App, die der Identität zugeordnet ist. Dies ist eine zufällig generierte UUID durch MSI.
properties.isolationScope	isolationScope	Aufzählung, um regionale Einschränkungen für die Identitätszuweisung nach Bedarf zu konfigurieren.
properties.principalId	string	Die ID des Dienstprinzipalobjekts, das der erstellten Identität zugeordnet ist.
properties.tenantId	string	Die ID des Mandanten, zu dem die Identität gehört.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

isolationScope

Aufzählung, um regionale Einschränkungen für die Identitätszuweisung nach Bedarf zu konfigurieren.

Name	Typ	Beschreibung
None	string
Regional	string

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über