Hämta profildata

Artikel
09/14/2023

Hämtar en lista över programcertifikatprofiler för en användare. Listan innehåller de möjliga åtgärder som kan utföras av den aktuella användaren. En begäran kan sedan initieras för någon av de angivna åtgärderna.

Viktigt

Servern anger endast PIN-koden om profilmallsprincipen anger att den ska göras. Annars bör användaren ange PIN-koden.

Anteckning

URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.

Förfrågan

Metod	Begärans-URL
GET	/CertificateManagement/api/v1.0/profiles /CertificateManagement/api/v1.0/profiles/{id} /CertificateManagement/api/v1.0/requests/{requestid}/profiles

URL-parametrar

Parameter	Beskrivning
id	Identifieraren (GUID) för profilen som ska returneras.
requestId	Identifieraren för begäran att returnera profilerna för.

Frågeparametrar

Parameter	Beskrivning
status	Valfritt. Anger status för de profiler som data ska hämtas för. Möjliga statustyper är "Active", "Approved", "Canceled", "Completed", "Denied", "Executing", "Failed", "None" och "Pending". Om ingen status anges returneras alla profiler, oavsett status.

Begärandehuvuden

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Begärandetext

Inga.

Svarsåtgärder

I det här avsnittet beskrivs svaret.

Svarskoder

Kod	Description
200	OK
204	Inget innehåll
403	Förbjudet
500	Internt fel

Svarshuvuden

Vanliga svarshuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Själva svaret

Vid lyckat resultat returneras en lista över JSON-serialiserade Microsoft.Clm.Shared.Profiles.Profile-objekt med följande egenskaper:

Egenskap	Beskrivning
AssignedUserUuid	Identifieraren för den användare som profilen har tilldelats.
Kommentar	Kommentaren som beskriver profilen.
Flaggor	Flaggorna som beskriver profilen.
ParentProfileUuid	Identifieraren för den gamla profilen som profilen har ersatt.
PrimaryProfileUuid	Identifieraren för den primära profilen.
ProfileOperations	Listan över möjliga åtgärder som kan utföras av den aktuella användaren i profilen.
ProfileTemplateUuid	Identifieraren för profilmallen som innehåller de principer och inställningar som styr profilen.
ProfileTemplateVersion	Versionen av profilmallen vid den tidpunkt då profilen skapades.
Status	Profilens status.
Uuid	Profilens identifierare.

Exempel

Det här avsnittet innehåller ett exempel för att hämta profildata för en användare.

Exempel: Begäran

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

Exempel: Svar

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

Se även

Klassen Microsoft.Clm.Shared.Profiles.Profile

Dela via