Sdílet prostřednictvím

Vytvoření požadavku

Vytvořte žádost o správu certifikátů Microsoft Identity Manageru (MIM).

Poznámka:

Adresy URL v tomto článku jsou relativní vzhledem k názvu hostitele zvolenému během nasazování rozhraní API, například https://api.contoso.com.

Žádost

Metoda Adresa URL požadavku
PŘÍSPĚVEK /CertificateManagement/api/v1.0/requests

Parametry adresy URL

Žádné.

Hlavičky žádosti

Běžné hlavičky požadavků najdete v tématu hlavičky požadavku HTTP a odpovědi v podrobnostech služby rozhraní REST API CM.

Obsah požadavku

Text požadavku obsahuje následující vlastnosti:

Vlastnictví Popis
profiletemplateuuid Povinné. Identifikátor GUID šablony profilu, pro kterou uživatel vytváří požadavek.
datacollection Povinné. Kolekce párů name-value představujících data, která mají být poskytována registrací. Kolekci potřebných dat, která je potřeba poskytnout, je možné načíst ze zásad pracovního postupu šablony profilu. Lze zadat prázdnou kolekci.
cíl Volitelný. Identifikátor GUID cílového uživatele, pro kterého se má požadavek vytvořit. Pokud není zadaný, cíl se ve výchozím nastavení nastaví na aktuálního uživatele.
typ Povinné. Typ vytvářeného požadavku. Mezi dostupné typy žádostí patří Registrace, Duplicitní, OfflineUnblock, OnlineUpdate, Renew, Recover, Recover, RecoverOnBehalf, Reinstate, Vyřazení, Odvolání, Dočasné karty a Odblokování.

Poznámka: Ve všech šablonách profilů nejsou podporované všechny typy požadavků. Například u šablony profilu softwaru nemůžete zadat operaci Odblokovat.
komentář Povinné. Všechny komentáře, které může uživatel zadat. Zásady pracovního postupu definují, zda je vlastnost komentáře nezbytná. Lze zadat prázdný řetězec.
priorita Volitelný. Priorita požadavku. Pokud není zadána, použije se výchozí priorita požadavku určená nastavením šablony profilu.

Odpověď

Tato část popisuje odpověď.

Kódy odpovědí

Kód Popis
201 Vytvořeno
403 Zakázáno
500 Vnitřní chyba

Hlavičky odpovědi

Běžné hlavičky odpovědí najdete v tématu hlavičky požadavku HTTP a odpovědi v podrobnostech služby rozhraní REST API CM.

Obsah odpovědi

Při úspěchu vrátí identifikátor URI pro nově vytvořený požadavek.

Příklad

Tato část obsahuje příklad vytvoření žádostí o registraci a odblokování.

Příklad: Žádost 1

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

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

Příklad: Odpověď 1

HTTP/1.1 201 Created

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

Příklad: Žádost 2

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

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

Příklad: Odpověď 2

HTTP/1.1 201 Created

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

Příklad: Žádost 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"
}

Viz také

  • Last updated on