사용자의 스마트 카드 프로필 목록을 가져옵니다. 목록에는 현재 사용자가 수행할 수 있는 가능한 작업이 포함됩니다. 그런 다음 지정된 작업에 대해 요청을 시작할 수 있습니다.
메모
이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com)을 기준으로 합니다.
요청
| 메서드 | 요청 URL |
|---|---|
| 가져오기 | /CertificateManagement/api/v1.0/smartcards /CertificateManagement/api/v1.0/smartcards/{smartcarduuid} |
URL 매개 변수
| 재산 | 설명 |
|---|---|
| smartcarduuid | 선택 사항. MIM(Microsoft Identity Manager) CM(인증서 관리)에서 나타내는 스마트 카드 UUID입니다. 값은 microsoft.Clm.Shared.Smartcards.Smartcard 개체 "uuid" 필드에 해당합니다. |
쿼리 매개 변수
| 재산 | 설명 |
|---|---|
| cardid | 선택 사항. MIM CM에서 나타내는 스마트 카드 UUID입니다. 값은 microsoft.Clm.Shared.Smartcards.Smartcard 개체 "uuid" 필드에 해당합니다. |
요청 헤더
일반적인 요청 헤더는 CM REST API 서비스 세부 정보 HTTP 요청 및 응답 헤더를 참조하세요.
요청 메시지 본문
없음.
응답
이 섹션에서는 응답에 대해 설명합니다.
응답 코드
| 코드 | 설명 |
|---|---|
| 200 | 그래 |
| 204 | 콘텐츠 없음 |
| 403 | 금지 |
| 500 | 내부 오류 |
응답 헤더
일반적인 응답 헤더는 CM REST API 서비스 세부 정보 HTTP 요청 및 응답 헤더를 참조하세요.
응답 메시지 본문
성공하면 다음 속성이 포함된 JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard 개체를 반환합니다.
| 이름 | 설명 |
|---|---|
| AssignedUserUuid | 스마트 카드가 할당된 사용자의 식별자입니다. |
| Atr | 현재 초기화 중인 카드의 스마트 카드 ATR(응답 재설정) 문자열입니다. |
| 주석 | 스마트 카드를 설명하는 주석입니다. |
| 플래그 | 스마트 카드를 설명하는 플래그입니다. |
| 미들웨어(Middleware) | 스마트 카드의 미들웨어입니다. |
| ParentSmartcardUuid | 스마트 카드가 대체한 이전 스마트 카드의 식별자입니다. |
| PermanentSmartcardUuid | 스마트 카드와 연결된 영구 스마트 카드의 식별자입니다. |
| PrimarySmartcardUuid | 기본 스마트 카드의 식별자입니다. |
| ProfileTemplateUuid | 스마트 카드를 제어하는 정책 및 설정이 포함된 프로필 템플릿의 식별자입니다. |
| ProfileTemplateVersion | 스마트 카드 프로필을 만든 시점의 프로필 템플릿 버전입니다. |
| 시리얼 번호 | 스마트 카드의 일련 번호입니다. |
| 상태 | 스마트 카드의 상태입니다. |
| Uuid | 스마트 카드 프로필의 식별자입니다. |
예시
이 섹션에서는 사용자의 스마트 카드 프로필을 가져오는 예제를 제공합니다.
예: 요청 1
GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1
예: 응답 1
HTTP/1.1 200 OK
{
"Uuid":"438d1b30-f3b4-4bed-85fa-285e08605ba7",
"Status":3,
"Flags":1,
"ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
"PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"ProfileTemplateVersion":46,
"Comment":"",
"SerialNumber":"{d1ef6869-5517-42a0-8f05-16ca1a0b834d}",
"Middleware":"MSBaseCSP",
"Atr":"3b8d0180fba000000397425446590301c8"
}
예: 요청 2
GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1
예: 응답 2
HTTP/1.1 200 OK
{
"Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"Status":2,
"Flags":1,
"ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
"PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"ProfileTemplateVersion":46,
"Comment":"",
"SerialNumber":"{bc88f13f-83ba-4037-8262-46eba1291c6e}",
"Middleware":"MSBaseCSP",
"Atr":"3b8d0180fba000000397425446590301c8"
}