Users - Get

Ottenere il profilo utente.

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

Parametri dell'URI

Name In Required Type Description
labName
path True
  • string

Il nome del lab.

name
path True
  • string

Nome del profilo utente.

resourceGroupName
path True
  • string

Nome del gruppo di risorse.

subscriptionId
path True
  • string

ID della sottoscrizione.

api-version
query True
  • string

Versione API client.

$expand
query
  • string

Specificare la query $expand. Esempio: 'properties($select=identity)'

Risposte

Name Type Description
200 OK

OK

Other Status Codes

BadRequest

Sicurezza

azure_auth

Concessione implicita OAuth2

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

Scopes

Name Description
user_impersonation Accesso Microsoft Azure

Esempio

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

Definizioni

CloudError

Errore da una richiesta REST.

CloudErrorBody

Corpo di un errore da una richiesta REST.

User

Profilo di un utente del lab.

UserIdentity

Attributi di identità di un utente del lab.

UserSecretStore

Proprietà dell'archivio segreti di un utente.

CloudError

Errore da una richiesta REST.

Name Type Description
error

Errore cloud che si è verificato

CloudErrorBody

Corpo di un errore da una richiesta REST.

Name Type Description
code
  • string

Codice di errore.

details

Errori interni.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore.

User

Profilo di un utente del lab.

Name Type Description
id
  • string

Identificatore della risorsa.

location
  • string

Il percorso della risorsa.

name
  • string

Nome della risorsa.

properties.createdDate
  • string

Data di creazione del profilo utente.

properties.identity

Identità dell'utente.

properties.provisioningState
  • string

Stato del provisioning della risorsa.

properties.secretStore

Archivio segreto dell'utente.

properties.uniqueIdentifier
  • string

Identificatore univoco non modificabile di una risorsa (GUID).

tags
  • object

Tag della risorsa.

type
  • string

Tipo di risorsa.

UserIdentity

Attributi di identità di un utente del lab.

Name Type Description
appId
  • string

Impostare sull'ID app del token JWT client che effettua la richiesta.

objectId
  • string

Impostare sull'ID oggetto del token JWT client che effettua la richiesta. Non tutti gli utenti hanno ID oggetto. Per gli scenari CSP (rivenditore), ad esempio, l'ID oggetto non è disponibile.

principalId
  • string

Impostare sull'ID principale del token JWT client che effettua la richiesta. L'entità servizio non avrà l'ID entità.

principalName
  • string

Impostare sul nome dell'entità o sull'UPN del token JWT client che effettua la richiesta.

tenantId
  • string

Impostare sull'ID tenant del token JWT client che effettua la richiesta.

UserSecretStore

Proprietà dell'archivio segreti di un utente.

Name Type Description
keyVaultId
  • string

ID dell'insieme di credenziali delle chiavi dell'utente.

keyVaultUri
  • string

URI dell'insieme di credenziali delle chiavi dell'utente.