Abrufen von Profilvorlagen
Ruft eine Liste der Profilvorlagen ab, für die sich der angegebene Benutzer registrieren kann. Diese Methode gibt eine eingeschränkte Ansicht der Profilvorlage zurück. Die zurückgegebenen Profilvorlagendaten sollten ausreichend sein, damit der anfordernde Benutzer entscheiden kann, für welche Profilvorlage er sich ggf. registriert. Wenn kein Workflow und keine Berechtigung angegeben sind, werden alle Profilvorlagen zurückgegeben, die für den Benutzer sichtbar sind.
Hinweis
Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z https://api.contoso.com
. B. .
Anforderung
Methode | Anforderungs-URL |
---|---|
GET | /CertificateManagement/api/v1.0/profiletemplates? [targetuser] |
URL-Parameter
Parameter | BESCHREIBUNG |
---|---|
targetuser | Optional. Gibt den Zielbenutzer an, für den Profilvorlagen zurückgegeben werden sollen. Wenn nicht angegeben, wird die Identität des aktuellen Benutzers verwendet. Hinweis: Derzeit wird nur der aktuelle Benutzer unterstützt. |
Anforderungsheader
Informationen zu gängigen Anforderungsheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.
Anforderungstext
Keine.
Antwort
In diesem Abschnitt wird die Antwort beschrieben.
Antwortcodes
Code | BESCHREIBUNG |
---|---|
200 | OK |
204 | Kein Inhalt |
500 | Interner Fehler |
Antwortheader
Informationen zu allgemeinen Antwortheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Antworttext
Gibt bei Erfolg eine Liste von ProfileTemplateLimitedView-Objekten mit den folgenden Eigenschaften zurück:
Eigenschaft | type | BESCHREIBUNG |
---|---|---|
Name | Zeichenfolge | Der Anzeigename der Profilvorlage. |
BESCHREIBUNG | Zeichenfolge | Die Beschreibung für die Profilvorlage. |
Uuid | Guid | Der Bezeichner für die Profilvorlage. |
IsSmartcardProfileTemplate | bool | Gibt an, ob es sich bei der Vorlage um eine Smartcard-Profilvorlage handelt. |
IsVirtualSmartcardProfileTemplate | bool | Gibt an, ob für die Profilvorlage eine virtuelle Smartcard erforderlich ist. |
Beispiel
Dieser Abschnitt enthält ein Beispiel zum Abrufen der Liste der Profilvorlagen für den angegebenen Benutzer.
Beispiel: Anforderung
GET /certificatemanagement/api/v1.0/profiletemplates HTTP/1.1
Beispiel: Antwort
HTTP/1.1 200 OK
[
{
"Name":"FIM CM Sample Profile Template",
"Description":"Description of the template goes here",
"Uuid":"12bd5120-86a2-4ee1-8d05-131066871578",
"IsSmartcardProfileTemplate":false,
"IsVirtualSmartcardProfileTemplate":false
},
{
"Name":"FIM CM Sample Smart Card Logon Profile Template",
"Description":"Description of the template goes here",
"Uuid":"2b7044cf-aa96-4911-b886-177947e9271b",
"IsSmartcardProfileTemplate":true,
"IsVirtualSmartcardProfileTemplate":false
}
]