次の方法で共有

要求を作成

Microsoft Identity Manager (MIM) 証明書管理 (CM) 要求を作成します。

注

この記事の URL は、https://api.contoso.comなど、API のデプロイ時に選択されたホスト名を基準にしています。

依頼

メソッド 要求 URL
投稿 /CertificateManagement/api/v1.0/requests

URL パラメーター

なし。

要求ヘッダー

一般的な要求ヘッダーについては、CM REST API サービスの詳細に HTTP 要求ヘッダーと応答ヘッダー を参照してください。

リクエストの本文

要求本文には、次のプロパティが含まれています。

プロパティ 説明
profiletemplateuuid 必須。 ユーザーが要求を作成しているプロファイル テンプレートの GUID。
datacollection 必須。 登録ユーザーによって提供されるデータを表す名前と値のペアのコレクション。 指定する必要がある必要があるデータのコレクションは、プロファイル テンプレートのワークフロー ポリシーから取得できます。 空のコレクションを指定できます。
目標 随意。 要求の作成対象となるターゲット ユーザーの GUID。 指定しない場合、ターゲットは既定で現在のユーザーに設定されます。
種類 必須。 作成される要求の種類。 使用可能な要求の種類には、"登録"、"複製"、"OfflineUnblock"、"OnlineUpdate"、"Renew"、"Recover"、"RecoverOnBehalf"、"Reinstate"、"Retire"、"Revoke"、"TemporaryCards"、"Unblock" などがあります。

注: すべての要求の種類が、すべてのプロファイル テンプレートでサポートされているわけではありません。 たとえば、ソフトウェア プロファイル テンプレートでブロック解除操作を指定することはできません。
comment 必須。 ユーザーが入力できるコメント。 ワークフロー ポリシーは、コメント プロパティが必要かどうかを定義します。 空の文字列を指定できます。
優先権 随意。 要求の優先順位。 指定しない場合は、プロファイル テンプレートの設定によって決定される既定の要求優先度が使用されます。

応答

このセクションでは、応答について説明します。

応答コード

コード 説明
201 作成
403 禁じられた
500 内部エラー

応答ヘッダー

一般的な応答ヘッダーについては、CM REST API サービスの詳細に HTTP 要求ヘッダーと応答ヘッダーの に関するページを参照してください。

応答内容

成功した場合は、新しく作成された要求の URI を返します。

例

このセクションでは、登録要求とブロック解除要求を作成する例を示します。

例: 要求 1

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

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

例: 応答 1

HTTP/1.1 201 Created

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

例: 要求 2

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

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

例: 応答 2

HTTP/1.1 201 Created

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

例: 要求 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"
}

こちらもご覧ください

  • Last updated on