스마트 카드 상태 업데이트
스마트 카드의 상태를 업데이트.
참고
이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com
)을 기준으로 합니다.
요청
메서드 | 요청 URL |
---|---|
GET | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid} |
URL 매개 변수
매개 변수 | Description |
---|---|
reqid | 필수 요소. MIM(Microsoft Identity Manager) CM(인증서 관리)과 관련된 요청 식별자입니다. |
scid | 필수 요소. MIM CM과 관련된 스마트 카드 식별자입니다. 값은 Microsoft.Clm.Shared.Smartcards.Smartcard 개체의 "uuid" 필드에 해당합니다. |
요청 헤더
일반적인 요청 헤더는 CM REST API 서비스 세부 정보의HTTP 요청 및 응답 헤더를 참조하세요.
요청 본문
요청 본문에는 다음 속성이 포함됩니다.
속성 | Description |
---|---|
상태 | 요청을 설정할 상태(예: "사용 중지됨")입니다. |
응답
이 섹션에서는 응답에 대해 설명합니다.
응답 코드
코드 | Description |
---|---|
200 | 확인 |
204 | 내용 없음 |
403 | 사용할 수 없음 |
500 | 내부 오류 |
응답 헤더
일반적인 응답 헤더는 CM REST API 서비스 세부 정보의HTTP 요청 및 응답 헤더를 참조하세요.
응답 본문
성공한 경우 다음 속성을 가진 JSON 직렬화된 Microsoft.Clm.Shared.Smartcards.Smartcard 개체를 반환합니다.
속성 | Description |
---|---|
AssignedUserUuid | 스마트 카드가 할당된 사용자의 식별자입니다. |
Atr | 현재 초기화되는 카드에 대한 스마트 카드 ATR(재설정 응답) 문자열입니다. |
의견 | 스마트 카드에 대한 설명입니다. |
플래그 | 스마트 카드를 설명하는 플래그입니다. |
미들웨어 | 스마트 카드에 대한 미들웨어입니다. |
ParentSmartcardUuid | 스마트 카드가 대체한 이전 스마트 카드의 식별자입니다. |
PermanentSmartcardUuid | 스마트 카드와 연결된 영구적인 스마트 카드의 식별자입니다. |
PrimarySmartcardUuid | 기본 스마트 카드의 식별자입니다. |
ProfileTemplateUuid | 스마트 카드를 제어하는 정책 및 설정이 포함된 프로필 템플릿의 식별자입니다. |
ProfileTemplateVersion | 스마트 카드 프로필을 만든 시점의 프로필 템플릿 버전입니다. |
SerialNumber | 스마트 카드의 일련 번호입니다. |
상태 | 스마트 카드의 상태입니다. |
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"
}