Users - Get

Benutzerprofil abrufen.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{name}?api-version=2018-09-15
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{name}?$expand={$expand}&api-version=2018-09-15

URI-Parameter

Name In Required Type Description
labName
path True
  • string

Der Name des Labs.

name
path True
  • string

Der Name des Benutzerprofils.

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe.

subscriptionId
path True
  • string

Die Abonnement-ID.

api-version
query True
  • string

Client-API-Version.

$expand
query
  • string

Geben Sie die $expand Abfrage an. Beispiel: "properties($select=identity)"

Antworten

Name Type Description
200 OK

OK

Other Status Codes

BadRequest

Sicherheit

azure_auth

Implizite OAuth2-Erteilung

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Access Microsoft Azure

Beispiele

Users_Get

Sample Request

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{devtestlabName}/users/{userName}?api-version=2018-09-15

Sample Response

{
  "properties": {
    "identity": {
      "principalName": "{principalName}",
      "principalId": "{principalId}",
      "tenantId": "{tenantId}",
      "objectId": "{objectId}",
      "appId": "{appId}"
    },
    "secretStore": {
      "keyVaultUri": "{keyVaultUri}",
      "keyVaultId": "{keyVaultId}"
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "provisioningState": "Succeeded",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}",
  "name": "{userName}",
  "type": "Microsoft.DevTestLab/labs/users",
  "location": "{location}",
  "tags": {
    "tagName1": "tagValue1"
  }
}

Definitionen

CloudError

Fehler aus einer REST-Anforderung.

CloudErrorBody

Textkörper eines Fehlers aus einer REST-Anforderung.

User

Profil eines Übungsbenutzers.

UserIdentity

Identitätsattribute eines Übungsbenutzers.

UserSecretStore

Eigenschaften des geheimen Speichers eines Benutzers.

CloudError

Fehler aus einer REST-Anforderung.

Name Type Description
error

Der aufgetretene Cloudfehler

CloudErrorBody

Textkörper eines Fehlers aus einer REST-Anforderung.

Name Type Description
code
  • string

Der Fehlercode.

details

Innere Fehler.

message
  • string

Die Fehlermeldung.

target
  • string

Das Fehlerziel.

User

Profil eines Übungsbenutzers.

Name Type Description
id
  • string

Der Bezeichner der Ressource.

location
  • string

Der Speicherort der Ressource.

name
  • string

Der Name der Ressource.

properties.createdDate
  • string

Das Erstellungsdatum des Benutzerprofils.

properties.identity

Die Identität des Benutzers.

properties.provisioningState
  • string

Der Bereitstellungsstatus der Ressource.

properties.secretStore

Der geheime Speicher des Benutzers.

properties.uniqueIdentifier
  • string

Der eindeutige unveränderliche Bezeichner einer Ressource (Guid).

tags
  • object

Die Tags der Ressource.

type
  • string

Der Typ der Ressource.

UserIdentity

Identitätsattribute eines Übungsbenutzers.

Name Type Description
appId
  • string

Legen Sie die App-ID des Client-JWT fest, der die Anforderung anfordert.

objectId
  • string

Legen Sie die Objekt-ID des Client-JWT fest, der die Anforderung anfordert. Nicht alle Benutzer verfügen über die Objekt-ID. Für CSP-Szenarien (Reseller) ist z. B. die Objekt-ID nicht verfügbar.

principalId
  • string

Legen Sie die Prinzipal-ID des Client-JWT fest, der die Anforderung anfordert. Der Dienstprinzipal verfügt nicht über die Prinzipal-ID.

principalName
  • string

Legen Sie den Prinzipalnamen /UPN des Client-JWT fest, der die Anforderung anfordert.

tenantId
  • string

Legen Sie die Mandanten-ID des Client-JWT fest, der die Anforderung anfordert.

UserSecretStore

Eigenschaften des geheimen Speichers eines Benutzers.

Name Type Description
keyVaultId
  • string

Die ID des Schlüsseltresors des Benutzers.

keyVaultUri
  • string

Der URI des Schlüsseltresors des Benutzers.