Vytvořit žádost

Článek
09/14/2023

Vytvořte žádost Microsoft Identity Manager (MIM) Certificate Management (CM).

Poznámka

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

Žádost

Metoda	Adresa URL požadavku
POST	/CertificateManagement/api/v1.0/requests

Parametry adresy URL

Žádné

Hlavičky požadavku

Běžné hlavičky požadavků najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě CM REST API.

Text požadavku

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

Vlastnost	Popis
Housynová	Povinná hodnota. Identifikátor GUID šablony profilu, pro kterou uživatel vytváří požadavek.
datacollection	Povinná hodnota. Kolekce dvojic název-hodnota představující data, která má zapsat. Kolekci potřebných dat, která je třeba poskytnout, lze načíst ze zásad pracovního postupu šablony profilu. Je možné zadat prázdnou kolekci.
Cíl	Nepovinný parametr. Identifikátor GUID cílového uživatele, pro kterého se má požadavek vytvořit. Pokud není zadaný, jako výchozí cíl se použije aktuální uživatel.
typ	Povinná hodnota. Typ vytvářeného požadavku. Mezi dostupné typy požadavků patří "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryCards" a "Unblock". Poznámka: Ne všechny typy požadavků jsou podporované ve všech šablonách profilů. U šablony profilu softwaru například nemůžete zadat operaci Odblokování.
comment	Povinná hodnota. Všechny komentáře, které může uživatel zadat. Zásady pracovního postupu definují, zda je vlastnost komentáře nutná. Je možné zadat prázdný řetězec.
Prioritou	Nepovinný parametr. Priorita požadavku. Pokud není zadaný, 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	Description
201	Vytvořeno
403	Forbidden
500	Vnitřní chyba

Hlavičky odpovědi

Běžné hlavičky odpovědi najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě CM REST API.

Text odpovědi

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

Příklad

Tato část obsahuje příklad vytvoření požadavků na 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"
}

Sdílet prostřednictvím