Delen via

Profielgegevens ophalen

Hiermee haalt u een lijst met softwarecertificaatprofielen voor een gebruiker op. De lijst bevat de mogelijke bewerkingen die door de huidige gebruiker kunnen worden uitgevoerd. Een aanvraag kan vervolgens worden gestart voor een van de opgegeven bewerkingen.

Belangrijk

De server stelt de pincode alleen in als het profielsjabloonbeleid aangeeft dat dit moet worden gedaan. Anders moet de gebruiker de pincode opgeven.

Notitie

De URL's in dit artikel zijn relatief ten opzichte van de hostnaam die tijdens de API-implementatie is gekozen, zoals https://api.contoso.com.

Aanvraag

Methode Aanvraag-URL
GET /CertificateManagement/api/v1.0/profiles
/CertificateManagement/api/v1.0/profiles/{id}
/CertificateManagement/api/v1.0/requests/{requestid}/profiles

URL-parameters

Maatstaf Beschrijving
identiteitskaart De id (GUID) van het profiel dat moet worden geretourneerd.
verzoekId De id van de aanvraag waarvoor de profielen moeten worden geretourneerd.

Query parameters

Maatstaf Beschrijving
stand van zaken Facultatief. Geeft de status aan van de profielen waarvoor gegevens moeten worden opgehaald. De mogelijke statustypen zijn 'Actief', 'Goedgekeurd', 'Geannuleerd', 'Voltooid', 'Geweigerd', 'Uitvoeren', 'Mislukt', 'Geen' en 'In behandeling'.
Als er geen status is opgegeven, worden alle profielen geretourneerd, ongeacht de status.

Headers aanvragen

Zie HTTP-aanvraag- en antwoordheaders in CM REST API-servicedetailsvoor algemene aanvraagheaders.

Inhoud van het verzoek

Geen.

Reactie

In deze sectie wordt het antwoord beschreven.

Antwoordcodes

Code Beschrijving
200 OK
204 Geen inhoud
403 Verboden
500 Interne fout

Antwoordheaders

Zie HTTP-aanvraag- en antwoordheaders in CM REST API-servicedetailsvoor algemene antwoordheaders.

Antwoordlichaam

Retourneert een lijst met door JSON geserialiseerde Microsoft.Clm.Shared.Profiles.Profile objecten met de volgende eigenschappen:

Vastgoed Beschrijving
AssignedUserUuid De id van de gebruiker aan wie het profiel is toegewezen.
Opmerking De opmerking die het profiel beschrijft.
Vlaggen De vlaggen die het profiel beschrijven.
ParentProfileUuid De id van het oude profiel dat het profiel heeft vervangen.
PrimaryProfileUuid De id van het primaire profiel.
ProfileOperations De lijst met mogelijke bewerkingen die door de huidige gebruiker in het profiel kunnen worden uitgevoerd.
ProfileTemplateUuid De id van de profielsjabloon die het beleid en de instellingen bevat die het profiel bepalen.
ProfileTemplateVersion De versie van de profielsjabloon op het moment dat het profiel is gemaakt.
Toestand De status van het profiel.
Uuid De id van het profiel.

Voorbeeld

Deze sectie bevat een voorbeeld om de profielgegevens voor een gebruiker op te halen.

Voorbeeld: aanvraag

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

Voorbeeld: respons

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

Zie ook

  • Last updated on