다음을 통해 공유


스마트 카드 상태 업데이트

스마트 카드의 상태를 업데이트.

참고

이 문서의 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"
}

추가 정보