다음을 통해 공유

요청 만들기

  • 아티클

MIM(Microsoft Identity Manager) CM(인증서 관리) 요청을 만듭니다.

참고

이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com)을 기준으로 합니다.

요청

메서드 요청 URL
POST /CertificateManagement/api/v1.0/requests

URL 매개 변수

없음

요청 헤더

일반적인 요청 헤더는 CM REST API 서비스 세부 정보의HTTP 요청 및 응답 헤더를 참조하세요.

요청 본문

요청 본문에는 다음 속성이 포함됩니다.

속성 Description
profiletemplateuuid 필수 요소. 사용자가 요청을 만드는 데 사용하는 프로필 템플릿의 GUID입니다.
datacollection 필수 요소. 등록자가 제공해야 하는 데이터를 나타내는 이름-값 쌍 컬렉션입니다. 제공되어야 하는 필요한 데이터 컬렉션은 프로필 템플릿의 워크플로 정책에서 검색할 수 있습니다. 빈 컬렉션을 지정할 수 있습니다.
대상 (선택 사항) 요청이 만들어질 대상 사용자의 GUID입니다. 지정하지 않으면 대상은 기본적으로 현재 사용자로 설정됩니다.
형식 필수 요소. 만들어지는 요청의 형식입니다. 사용 가능한 요청 유형에는 "등록", "중복", "OfflineUnblock", "OnlineUpdate", "갱신", "복구", "RecoverOnBehalf", "복원", "사용 중지", "해지", "임시 카드" 및 "차단 해제"가 포함됩니다.

참고: 모든 요청 유형이 모든 프로필 템플릿에서 지원되는 것은 아닙니다. 예를 들어 소프트웨어 프로필 템플릿에서 차단 해제 작업을 지정할 수 없습니다.
주석 필수 요소. 사용자가 입력할 수 있는 설명입니다. 워크플로 정책은 comment 속성이 필요한지 여부를 정의합니다. 빈 문자열을 지정할 수 있습니다.
priority (선택 사항) 요청의 우선 순위입니다. 지정하지 않으면 프로필 템플릿 설정에 따라 결정되는 기본 요청 우선 순위가 사용됩니다.

응답

이 섹션에서는 응답을 설명합니다.

응답 코드

코드 Description
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"
}

추가 정보