Uzyskiwanie zasad przepływu pracy

Pobiera zasady szablonu profilu dla określonego przepływu pracy. Dane są używane podczas tworzenia żądania. Zasady przepływu pracy określają, które dane są wymagane przez klienta w celu utworzenia żądania. Dane mogą obejmować różne elementy zbierania danych, komentarze do żądań i zasady haseł jedno raz.

Uwaga

Adresy URL w tym artykule są względne względem nazwy hosta wybranej podczas wdrażania interfejsu API, takiej jak https://api.contoso.com .

Żądanie

Metoda Adres URL żądania
GET /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type}

Parametry URL

Parametr Opis
identyfikator Wymagane. Identyfikator GUID odpowiadający szablonowi profilu, z których mają zostać wyodrębnione zasady.
typ Wymagane. Typ żądanych zasad. Możliwe wartości to "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryEnroll" i "Unblock".

Nagłówki żądań

Aby uzyskać informacje o typowych nagłówkach żądań, zobacz Nagłówki żądań i odpowiedzi HTTP w sekcji Szczegóły usługi interfejsu API REST usługi CM.

Treść żądania

Brak.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
403 Forbidden
204 Brak zawartości
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Aby uzyskać informacje o typowych nagłówkach odpowiedzi, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w te tematu CM REST API service details (Szczegółyusługi interfejsu API REST usługi CM).

Treść odpowiedzi

W przypadku powodzenia zwraca obiekt zasad oparty na obiekcie ProfileTemplatePolicy. Co najmniej obiekt zasad zawiera właściwości w poniższej tabeli, ale może zawierać dodatkowe właściwości w zależności od żądanych zasad. Na przykład żądanie zasad rejestracji zwraca obiekt EnrollPolicy. Aby uzyskać więcej informacji, zobacz dokumentację obiektu zasad skojarzonego z parametrem {type} w żądaniu. Dokumentację różnych typów obiektów zasad można znaleźć w dokumentacji przestrzeni nazw Microsoft.Clm.Shared.ProfileTemplates.

Właściwość Opis
ZatwierdzeniaNeeded Liczba zatwierdzeń wymaganych dla żądań zarządzania certyfikatami programu Forefront Identity Manager (FIM) dla zasad.
AuthorizedApprover Deskryptor zabezpieczeń dla użytkowników, którzy są autoryzowani do zatwierdzania żądań zarządzania zasadami fim dla zasad.
AuthorizedEnrollmentAgent Deskryptor zabezpieczeń dla użytkowników, którzy mogą działać jako agenci rejestracji dla zasad.
AuthorizedInitiator Deskryptor zabezpieczeń dla użytkowników, którzy mogą inicjować żądania cmdli fim dla zasad.
CollectComments Wartość logiczna wskazująca, czy kolekcja komentarzy jest włączona dla żądań cmdelek fim dla zasad.
CollectRequestPriority Wartość logiczna wskazująca, czy kolekcja priorytetów żądań jest włączona dla żądań cmdelek fim dla zasad.
DefaultRequestPriority Domyślny priorytet żądań CM programu FIM dla zasad.
Dokumenty Dokumenty zasad skonfigurowane dla zasad.
Enabled (Włączony) Wartość logiczna wskazująca, czy zasady są włączone.
EnrollAgentRequired Wartość logiczna wskazująca, czy agenci rejestracji są wymagani dla żądań cmdelek programu FIM dla zasad.
OneTimePasswordPolicy Metoda dystrybucji haseł dla haseł raz dla żądań menedżerów zarządzania programem FIM dla zasad.
Personalizacja Opcje personalizacji karty inteligentnej dla zasad.
PolicyDataCollection Elementy zbierania danych skojarzone z zasadami.
SelfServiceEnabled Wartość logiczna wskazująca, czy dla zasad jest włączona samoobsługowa inicjacja żądań cmdelek fim.

Przykład

Ta sekcja zawiera przykład uzyskania zasad szablonu profilu dla przepływu pracy.

Przykład: Żądanie 1

GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1

Przykład: Odpowiedź 1

HTTP/1.1 200 OK

... body coming soon

Przykład: Żądanie 2

GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1

Przykład: Odpowiedź 2

HTTP/1.1 200 OK

... body coming soon

Zobacz też