User - Get

Servizio:

API Management

Versione API:

2024-05-01

Ottiene i dettagli dell'utente specificato dal relativo identificatore.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}?api-version=2024-05-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
serviceName	path	True	string minLength: 1 maxLength: 50 pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$	Nome del servizio Gestione API.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
userId	path	True	string minLength: 1 maxLength: 80	Identificatore utente. Deve essere univoco nell'istanza corrente del servizio Gestione API.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	UserContract	Ottiene l'entità utente specificata. Intestazioni ETag: string
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ApiManagementGetUser

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512a88c680b?api-version=2024-05-01

Risposta di esempio

Codice di stato:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512a88c680b",
  "type": "Microsoft.ApiManagement/service/users",
  "name": "5931a75ae4bbd512a88c680b",
  "properties": {
    "firstName": "foo",
    "lastName": "bar",
    "email": "foobar@outlook.com",
    "state": "active",
    "registrationDate": "2017-06-02T17:58:50.357Z",
    "identities": [
      {
        "provider": "Microsoft",
        "id": "*************"
      }
    ]
  }
}

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
GroupContractProperties	Proprietà del contratto di gruppo.
GroupType	Tipo di gruppo.
UserContract	Dettagli utente.
UserIdentityContract	Dettagli identità utente.
UserState	Stato dell'account. Specifica se l'utente è attivo o meno. Gli utenti bloccati non possono accedere al portale per sviluppatori o chiamare le API dei prodotti sottoscritti. Lo stato predefinito è Attivo.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

GroupContractProperties

Object

Proprietà del contratto di gruppo.

Nome	Tipo	Descrizione
builtIn	boolean	true se il gruppo è uno dei tre gruppi di sistema (Amministratori, Sviluppatori o Guest); in caso contrario false.
description	string maxLength: 1000	Descrizione gruppo. Può contenere tag di formattazione HTML.
displayName	string minLength: 1 maxLength: 300	Nome gruppo.
externalId	string	Per i gruppi esterni, questa proprietà contiene l'ID del gruppo dal provider di identità esterno, ad esempio per Azure Active Directory aad://<tenant>.onmicrosoft.com/groups/<group object id>; in caso contrario, il valore è Null.
type	GroupType	Tipo di gruppo.

GroupType

Enumerazione

Tipo di gruppo.

Valore	Descrizione
custom
system
external

UserContract

Object

Dettagli utente.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string		Nome della risorsa
properties.email	string		Indirizzo email.
properties.firstName	string		Nome di battesimo.
properties.groups	GroupContractProperties[]		La raccolta di utenti di gruppi fa parte di .
properties.identities	UserIdentityContract[]		Raccolta di identità utente.
properties.lastName	string		Cognome.
properties.note	string		Nota facoltativa su un utente impostato dall'amministratore.
properties.registrationDate	string (date-time)		Data di registrazione dell'utente. La data è conforme al formato seguente: yyyy-MM-ddTHH:mm:ssZ come specificato dallo standard ISO 8601.
properties.state	UserState	active	Stato dell'account. Specifica se l'utente è attivo o meno. Gli utenti bloccati non possono accedere al portale per sviluppatori o chiamare le API dei prodotti sottoscritti. Lo stato predefinito è Attivo.
type	string		Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

UserIdentityContract

Object

Dettagli identità utente.

Nome	Tipo	Descrizione
id	string	Valore dell'identificatore all'interno del provider.
provider	string	Nome del provider di identità.

UserState

Enumerazione

Stato dell'account. Specifica se l'utente è attivo o meno. Gli utenti bloccati non possono accedere al portale per sviluppatori o chiamare le API dei prodotti sottoscritti. Lo stato predefinito è Attivo.

Valore	Descrizione
active	Lo stato utente è attivo.
blocked	L'utente è bloccato. Gli utenti bloccati non possono eseguire l'autenticazione nel portale per sviluppatori o chiamare l'API.
pending	L'account utente è in sospeso. Richiede la conferma dell'identità prima che possa essere attivata.
deleted	L'account utente è chiuso. Tutte le identità e le entità correlate vengono rimosse.