Condividi tramite

Ottenere i dati del profilo

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 qualsiasi 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 Identificatore (GUID) del profilo da restituire.
ID richiesta Identificatore della richiesta per cui restituire i profili.

Parametri di query

Parametro Descrizione
stato Opzionale. 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.

Header di 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 Va bene
204 Nessun contenuto
403 Vietato
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 oggetti Microsoft.Clm.Shared.Profiles.Profile con le proprietà seguenti:

Proprietà Descrizione
AssignedUserUuid Identificatore dell'utente a cui è assegnato il profilo.
Commento Commento che descrive il profilo.
Bandiere Flag che descrivono il profilo.
ParentProfileUuid Identificatore del profilo precedente sostituito dal profilo.
PrimaryProfileUuid Identificatore del profilo primario.
ProfileOperations Elenco delle possibili operazioni che possono essere eseguite dall'utente corrente nel profilo.
ProfileTemplateUuid Identificatore del modello di profilo che contiene i criteri e le impostazioni che regolano il profilo.
ProfileTemplateVersion Versione del modello di profilo al momento della creazione del profilo.
Stato 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"
        ]
    }
]

Vedere anche

  • Last updated on