스마트 카드의 상태를 업데이트합니다.
메모
이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com)을 기준으로 합니다.
요청
| 메서드 | 요청 URL |
|---|---|
| 가져오기 | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid} |
URL 매개 변수
| 매개 변수 | 설명 |
|---|---|
| reqid | 필수 사항입니다. MIM(Microsoft Identity Manager) CM(인증서 관리)과 관련된 요청 식별자입니다. |
| scid | 필수 사항입니다. MIM CM과 관련된 스마트 카드 식별자입니다. 값은 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 | 스마트 카드 프로필의 식별자입니다. |
예시
이 섹션에서는 스마트 카드의 상태를 업데이트하는 예제를 제공합니다.
예제: 요청
PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1
예제: 응답
HTTP/1.1 200 OK
{
"Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"Status":6,
"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"
}