요청에 스마트 카드 할당
지정된 스마트 카드를 지정된 요청에 바인딩합니다. 스마트 카드가 바인딩된 후에는 지정된 카드로만 요청을 실행할 수 있습니다.
참고
이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com)을 기준으로 합니다.
요청
| 메서드 | 요청 URL |
|---|---|
| POST | /CertificateManagement/api/v1.0/smartcards |
URL 매개 변수
없음
요청 헤더
일반적인 요청 헤더는 CM REST API 서비스 세부 정보의HTTP 요청 및 응답 헤더를 참조하세요.
요청 본문
요청 본문에는 다음 속성이 포함됩니다.
| 속성 | Description |
|---|---|
| requestid | 스마트 카드에 바인딩할 요청의 ID입니다. |
| cardid | 스마트 카드의 카드 ID입니다. |
| atr | 스마트 카드 ATR(재설정 응답) 문자열입니다. |
응답
이 섹션에서는 응답을 설명합니다.
응답 코드
| 코드 | Description |
|---|---|
| 201 | 생성일 |
| 204 | 내용 없음 |
| 403 | 사용할 수 없음 |
| 500 | 내부 오류 |
응답 헤더
일반적인 응답 헤더는 CM REST API 서비스 세부 정보의HTTP 요청 및 응답 헤더를 참조하세요.
응답 본문
성공하면 새로 만든 스마트 카드 개체에 대한 URI를 반환합니다.
예
이 섹션에서는 스마트 카드를 바인딩하는 예제를 제공합니다.
예: 요청
POST /CertificateManagement/api/v1.0/smartcards HTTP/1.1
{
"requestid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"cardid":"bc88f13f-83ba-4037-8262-46eba1291c6e",
"atr":"3b8d0180fba000000397425446590301c8"
}
예: 응답
HTTP/1.1 201 Created
"api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9"