Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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"
]
}
]