Freigeben über


Profildaten abrufen

Ruft eine Liste der Softwarezertifikatprofile für einen Benutzer ab. Die Liste enthält die möglichen Vorgänge, die vom aktuellen Benutzer ausgeführt werden können. Eine Anforderung kann dann für jede der angegebenen Vorgänge initiiert werden.

Wichtig

Der Server legt die PIN nur fest, wenn die Profilvorlagenrichtlinie angibt, dass sie ausgeführt werden soll. Andernfalls sollte der Benutzer die PIN angeben.

Hinweis

Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.

Anfrage

Methode Anforderungs-URL
ERHALTEN/Bekommen /CertificateManagement/api/v1.0/profiles
/CertificateManagement/api/v1.0/profiles/{id}
/CertificateManagement/api/v1.0/requests/{requestid}/profiles

URL-Parameter

Parameter BESCHREIBUNG
id Der Bezeichner (GUID) des zurückzugebenden Profils.
requestId Der Bezeichner der Anforderung, für die die Profile zurückgegeben werden sollen.

Abfrageparameter

Parameter BESCHREIBUNG
Status Wahlfrei. Gibt den Status der Profile an, für die Daten abgerufen werden sollen. Die möglichen Statustypen sind "Aktiv", "Genehmigt", "Abgebrochen", "Abgeschlossen", "Abgelehnt", "Ausführen", "Fehlgeschlagen", "Keine" und "Ausstehend".
Wenn kein Status angegeben ist, werden alle Profile unabhängig vom Status zurückgegeben.

Anforderungsheader

Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.

Anfragekörper

Keiner.

Antwort

In diesem Abschnitt wird die Antwort beschrieben.

Antwortcodes

Code BESCHREIBUNG
200 OKAY
204 Kein Inhalt
403 Verboten
500 Interner Fehler

Antwortheader

Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.

Antwortkörper

Gibt bei Erfolg eine Liste von JSON-serialisierten Microsoft.Clm.Shared.Profiles.Profile--Objekten mit den folgenden Eigenschaften zurück:

Eigentum BESCHREIBUNG
AssignedUserUuid Der Bezeichner des Benutzers, dem das Profil zugewiesen ist.
Kommentar Der Kommentar, der das Profil beschreibt.
Flaggen Die Kennzeichen, die das Profil beschreiben.
ParentProfileUuid Der Bezeichner des alten Profils, das das Profil ersetzt hat.
PrimaryProfileUuid Der Bezeichner des primären Profils.
ProfileOperations Die Liste der möglichen Vorgänge, die vom aktuellen Benutzer im Profil ausgeführt werden können.
ProfileTemplateUuid Der Bezeichner der Profilvorlage, die die Richtlinien und Einstellungen enthält, die das Profil steuern.
ProfileTemplateVersion Die Version der Profilvorlage zum Zeitpunkt der Erstellung des Profils.
Status Der Status des Profils.
Uuid Der Bezeichner des Profils.

Beispiel

Dieser Abschnitt enthält ein Beispiel zum Abrufen der Profildaten für einen Benutzer.

Beispiel: Anforderung

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

Beispiel: Antwort

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

Siehe auch