지정된 MIM(Microsoft Identity Manager) CM(인증서 관리) 요청을 하나 이상 가져옵니다.
메모
이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com)을 기준으로 합니다.
요청
| 메서드 | 요청 URL |
|---|---|
| 가져오기 | /CertificateManagement/api/v1.0/requests/{id} |
URL 매개 변수
| 재산 | 설명 |
|---|---|
| 아이디 | 선택 사항. 검색할 요청의 GUID입니다. |
쿼리 매개 변수
| 재산 | 설명 |
|---|---|
| targetuser | 선택 사항. 요청의 대상 사용자입니다. 대상이 지정되지 않은 경우 대상 사용자에 관계없이 모든 요청이 반환됩니다. 참고: 현재 "현재" 값만 지원됩니다. |
| 상태 | 선택 사항. 검색할 요청의 상태를 나타냅니다. 가능한 상태 유형은 "승인됨", "취소됨", "완료됨", "거부됨", "실행 중", "실패함", "없음" 및 "보류 중"입니다. 상태가 지정되지 않으면 상태에 관계없이 모든 요청이 반환됩니다. |
요청 헤더
일반적인 요청 헤더는 CM REST API 서비스 세부 정보 HTTP 요청 및 응답 헤더를 참조하세요.
요청 메시지 본문
없음.
응답
이 섹션에서는 응답에 대해 설명합니다.
응답 코드
| 코드 | 설명 |
|---|---|
| 200 | 그래 |
| 204 | 콘텐츠 없음 |
| 403 | 금지 |
| 500 | 내부 오류 |
응답 헤더
일반적인 응답 헤더는 CM REST API 서비스 세부 정보 HTTP 요청 및 응답 헤더를 참조하세요.
응답 메시지 본문
성공하면 다음 속성을 사용하여 하나 이상의 Request 개체를 반환합니다.
| 이름 | 설명 |
|---|---|
| 주석 | MIM CM 요청과 연결된 주석입니다. |
| 완료됨 | MIM CM 요청이 완료된 시간입니다. |
| DataCollection | MIM CM 요청과 연결된 데이터 컬렉션 항목입니다. |
| DataCollectionFlags | MIM CM 요청에 대한 데이터 수집 옵션입니다. |
| 플래그 | MIM CM 요청과 연결된 옵션입니다. |
| IsDataCollectionComplete | MIM CM 요청에 대해 데이터 수집이 완료되었는지 여부를 나타내는 부울 값입니다. |
| IsEnrollmentAgent | MIM CM 요청을 실행하는 데 등록 에이전트가 필요한지 여부를 나타내는 부울 값입니다. |
| IsSmartcard | MIM CM 요청이 스마트 카드 요청인지 또는 소프트웨어 프로필 요청인지를 나타내는 부울 값입니다. |
| NewProfileUuid | MIM CM 요청에 의해 생성되는 새 소프트웨어 프로필의 ID입니다. |
| NewSmartcardUuid | MIM CM 요청에 의해 할당된 새 스마트 카드의 ID입니다. |
| OldProfileUuid | MIM CM 요청을 만든 소프트웨어 프로필의 ID입니다. |
| OldSmartcardUuid | MIM CM 요청을 만든 스마트 카드의 ID입니다. |
| OriginatorUserUuid | MIM CM 요청을 시작한 사용자의 ID입니다. |
| 우선권 | MIM CM 요청의 우선 순위입니다. |
| ProfileTemplateUuid | MIM CM 요청을 만든 프로필 템플릿의 ID입니다. |
| RequestType | MIM CM 요청의 형식입니다. |
| 보안 설명자 | MIM CM 요청에 대한 보안 설명자입니다. |
| 상태 | MIM CM 요청의 상태입니다. |
| 제출됨 | MIM CM 요청이 제출된 시간입니다. |
| TargetUserUuid | MIM CM 요청에 대한 대상 사용자의 ID입니다. |
| Uuid | MIM CM 요청에 대한 식별자입니다. |
예시
이 섹션에서는 지정된 MIM CM 요청을 가져오는 예제를 제공합니다.
예: 요청 1
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
예: 응답 1
HTTP/1.1 200 OK
{
"Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"RequestType":1,
"Status":3,
"Flags":2,
"DataCollection":[
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:36:21.93Z",
"Completed":"0001-01-01T00:00:00",
"NewProfileUuid":"00000000-0000-0000-0000-000000000000",
"OldProfileUuid":"00000000-0000-0000-0000-000000000000",
"NewSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"OldSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"Priority":0,
"Comment":"",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094534)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5219125)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}
예: 요청 2
GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1
예: 응답 2
HTTP/1.1 200 OK
{
"Uuid":"0c96d73f-967b-420e-854a-43ad2a1504bc",
"RequestType":5,
"Status":3,
"Flags":2,
"DataCollection":[
{
"Name":"Sample Data Item",
"Value":null
}
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:40:33.133Z",
"Completed":"0001-01-01T00:00:00",
"NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"OldProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"OldSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"Priority":0,
"Comment":"",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}