Udostępnij przez

Tworzenie żądania

Utwórz żądanie zarządzania certyfikatami programu Microsoft Identity Manager (MIM).

Uwaga

Adresy URL w tym artykule są powiązane z nazwą hosta wybraną podczas wdrażania interfejsu API, taką jak https://api.contoso.com.

Żądanie

Metoda Adres URL żądania
Bez znajomości kontekstu, w którym "POST" jest używany, nie mogę zaproponować dokładnego tłumaczenia. Jeżeli dotyczy HTTP, pozostaw jako "POST". /CertificateManagement/api/v1.0/requests

Parametry URL

Żaden.

Nagłówki zapytań

Aby uzyskać typowe nagłówki żądań, zobacz nagłówki żądań i odpowiedzi HTTP w szczegółach usługi interfejsu API REST CM.

Ciało żądania

Treść żądania zawiera następujące właściwości:

Nieruchomość / Majątek Opis
profiletemplateuuid To jest wymagane. Identyfikator GUID szablonu profilu, dla którego użytkownik tworzy żądanie.
datacollection To jest wymagane. Kolekcja par name-value reprezentujących dane, które mają być udostępniane przez rejestrację. Zbieranie niezbędnych danych, które należy podać, można pobrać z zasad przepływu pracy szablonu profilu. Można określić pustą kolekcję.
cel Opcjonalny. Identyfikator GUID użytkownika docelowego, dla którego ma zostać utworzone żądanie. Jeśli nie zostanie określony, wartość docelowa zostanie domyślnie ustawiona na bieżącego użytkownika.
rodzaj To jest wymagane. Typ tworzonego żądania. Dostępne typy żądań obejmują "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryCards" i "Unblock".

Uwaga: Nie wszystkie typy żądań są obsługiwane we wszystkich szablonach profilów. Na przykład nie można określić operacji Odblokowywanie w szablonie profilu oprogramowania.
komentarz To jest wymagane. Wszelkie komentarze, które mogą zostać wprowadzone przez użytkownika. Zasady przepływu pracy określają, czy właściwość komentarza jest niezbędna. Można określić pusty ciąg.
priorytet Opcjonalny. Priorytet żądania. Jeśli nie zostanie określony, zostanie użyty domyślny priorytet żądania określony przez ustawienia szablonu profilu.

Odpowiedź

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
201 Utworzono
403 Zakazany
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Aby uzyskać typowe nagłówki odpowiedzi, zobacz nagłówki żądań HTTP i odpowiedzi w szczegółach usługi API REST.

Ciało odpowiedzi

Po powodzeniu zwraca identyfikator URI nowo utworzonego żądania.

Przykład

Ta sekcja zawiera przykład tworzenia rejestracji i odblokowywania żądań.

Przykład: żądanie 1

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "datacollection":"[]",
    "type":"Enroll",
    "profiletemplateuuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "comment":""
}

Przykład: odpowiedź 1

HTTP/1.1 201 Created

"api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099"

Przykład: żądanie 2

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{  
    "datacollection":"[]",
    "type":"Unblock",
    "smartcard":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "comment":""
}

Przykład: odpowiedź 2

HTTP/1.1 201 Created

"api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc"

Przykład: żądanie 3

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "profiletemplateuuid" : "97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1",
    "datacollection":
    [
        {"name" : "pavle"},
        {"city" : "seattle"}
    ],
    "target" : "97CC3493-F556-4C9B-9D8B-982434201527",
    "type" : "Enroll",
    "comment" : "LALALALA",
    "priority" :  "4"
}

Zobacz też

  • Last updated on