Ottenere i dati del profilo

Articolo
09/14/2023

Ottiene un elenco di profili certificato software per un utente. L'elenco include le possibili operazioni che possono essere eseguite dall'utente corrente. È quindi possibile avviare una richiesta per una delle operazioni specificate.

Importante

Il server imposta il PIN solo se i criteri del modello di profilo indicano che deve essere eseguita. In caso contrario, l'utente deve fornire il PIN.

Nota

Gli URL in questo articolo sono relativi al nome host scelto durante la distribuzione dell'API, ad esempio https://api.contoso.com.

Richiesta

Metodo	URL richiesta
GET	/CertificateManagement/api/v1.0/profiles /CertificateManagement/api/v1.0/profiles/{id} /CertificateManagement/api/v1.0/requests/{requestid}/profiles

Parametri URL

Parametro	Descrizione
id	L'identificatore (GUID) del profilo da restituire.
requestId	Identificatore della richiesta per cui restituire i profili.

Parametri di query

Parametro	Descrizione
status	Facoltativa. Indica lo stato dei profili per cui recuperare i dati. I tipi di stato possibili sono "Active", "Approved", "Canceled", "Completed", "Denied", "Executing", "Failed", "None" e "Pending". Se non viene specificato alcuno stato, vengono restituiti tutti i profili, indipendentemente dallo stato.

Intestazioni della richiesta

Per le intestazioni di richiesta comuni, vedere Intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm.

Testo della richiesta

Nessuno.

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice	Descrizione
200	OK
204	Nessun contenuto
403	Accesso negato
500	Errore interno

Intestazioni di risposta

Per le intestazioni di risposta comuni, vedere Intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm.

Corpo della risposta

In caso di esito positivo, restituisce un elenco di oggetti serializzati JSON Microsoft.Clm.Shared.Profiles.Profile con le proprietà seguenti:

Proprietà	Descrizione
AssignedUserUuid	Identificatore dell'utente a cui viene assegnato il profilo.
Commento	Il commento che descrive il profilo.
Flags	I flag che descrivono il profilo.
ParentProfileUuid	Identificatore del profilo precedente sostituito dall’attuale profilo.
PrimaryProfileUuid	Identificatore del profilo primario.
ProfileOperations	Elenco di possibili operazioni che possono essere eseguite dall'utente corrente per il profilo specificato.
ProfileTemplateUuid	Identificatore del modello di profilo che contiene criteri e impostazioni che controllano il profilo.
ProfileTemplateVersion	La versione del modello di profilo al momento della creazione del profilo.
Stato	Lo stato del profilo.
Uuid	Identificatore del profilo.

Esempio

Questa sezione fornisce un esempio per ottenere i dati del profilo per un utente.

Esempio: Richiesta

GET /certificatemanagement/api/v1.0/profiles?status=Active HTTP/1.1

Esempio: Risposta

HTTP/1.1 200 OK

[
    {
        "Uuid":"c0dd5c7d-ec35-4346-baca-3ad711e9722f",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"1c9e2606-fea2-4048-a6ac-b014e54c22df",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
        "ProfileTemplateVersion":8,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable",
            "recover"
        ]
    },
    {
        "Uuid":"5ad77b40-aa42-4533-9396-c9c59fd021a8",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
        "ProfileTemplateVersion":8,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable",
            "recover"
        ]
    },
    {
        "Uuid":"ff342953-c444-4dc7-b144-f5515d6460c6",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"1e3a31fe-699b-4a6b-945c-18b83c985bc1",
        "ProfileTemplateVersion":9,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable"
        ]
    }
]

Vedi anche

Classe Microsoft.Clm.Shared.Profiles.Profile

Condividi tramite