사용자의 소프트웨어 인증서 프로필 목록을 가져옵니다. 목록에는 현재 사용자가 수행할 수 있는 가능한 작업이 포함됩니다. 그런 다음 지정된 작업에 대해 요청을 시작할 수 있습니다.
중요합니다
서버는 프로필 템플릿 정책이 PIN을 수행해야 한다고 나타내는 경우에만 PIN을 설정합니다. 그렇지 않으면 사용자가 PIN을 제공해야 합니다.
메모
이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com)을 기준으로 합니다.
요청
| 메서드 | 요청 URL |
|---|---|
| 가져오기 | /CertificateManagement/api/v1.0/profiles /CertificateManagement/api/v1.0/profiles/{id} /CertificateManagement/api/v1.0/requests/{requestid}/profiles |
URL 매개 변수
| 매개 변수 | 설명 |
|---|---|
| 아이디 | 반환할 프로필의 식별자(GUID)입니다. |
| 요청 ID | 프로필을 반환할 요청의 식별자입니다. |
쿼리 매개 변수
| 매개 변수 | 설명 |
|---|---|
| 상태 | 선택 사항. 데이터를 검색할 프로필의 상태를 나타냅니다. 가능한 상태 유형은 "활성", "승인됨", "취소됨", "완료됨", "거부됨", "실행 중", "실패함", "없음" 및 "보류 중"입니다. 상태를 지정하지 않으면 상태에 관계없이 모든 프로필이 반환됩니다. |
요청 헤더
일반적인 요청 헤더는 CM REST API 서비스 세부 정보 HTTP 요청 및 응답 헤더를 참조하세요.
요청 메시지 본문
없음.
응답
이 섹션에서는 응답에 대해 설명합니다.
응답 코드
| 코드 | 설명 |
|---|---|
| 200 | 그래 |
| 204 | 콘텐츠 없음 |
| 403 | 금지 |
| 500 | 내부 오류 |
응답 헤더
일반적인 응답 헤더는 CM REST API 서비스 세부 정보 HTTP 요청 및 응답 헤더를 참조하세요.
응답 메시지 본문
성공하면 다음 속성을 사용하여 JSON 직렬화된 Microsoft.Clm.Shared.Profiles.Profile 개체 목록을 반환합니다.
| 재산 | 설명 |
|---|---|
| AssignedUserUuid | 프로필이 할당된 사용자의 식별자입니다. |
| 주석 | 프로필을 설명하는 주석입니다. |
| 플래그 | 프로필을 설명하는 플래그입니다. |
| ParentProfileUuid | 프로필이 대체된 이전 프로필의 식별자입니다. |
| PrimaryProfileUuid | 기본 프로필의 식별자입니다. |
| ProfileOperations | 프로필에서 현재 사용자가 수행할 수 있는 가능한 작업 목록입니다. |
| ProfileTemplateUuid | 프로필을 제어하는 정책 및 설정을 포함하는 프로필 템플릿의 식별자입니다. |
| ProfileTemplateVersion | 프로필을 만든 시점의 프로필 템플릿 버전입니다. |
| 상태 | 프로필의 상태입니다. |
| Uuid | 프로필의 식별자입니다. |
예시
이 섹션에서는 사용자의 프로필 데이터를 가져오는 예제를 제공합니다.
예제: 요청
GET /certificatemanagement/api/v1.0/profiles?status=Active HTTP/1.1
예제: 응답
HTTP/1.1 200 OK
[
{
"Uuid":"c0dd5c7d-ec35-4346-baca-3ad711e9722f",
"Status":2,
"Flags":1,
"ParentProfileUuid":"1c9e2606-fea2-4048-a6ac-b014e54c22df",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
"ProfileTemplateVersion":8,
"Comment":"",
"ProfileOperations":[
"renew",
"disable",
"recover"
]
},
{
"Uuid":"5ad77b40-aa42-4533-9396-c9c59fd021a8",
"Status":2,
"Flags":1,
"ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
"ProfileTemplateVersion":8,
"Comment":"",
"ProfileOperations":[
"renew",
"disable",
"recover"
]
},
{
"Uuid":"ff342953-c444-4dc7-b144-f5515d6460c6",
"Status":2,
"Flags":1,
"ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"1e3a31fe-699b-4a6b-945c-18b83c985bc1",
"ProfileTemplateVersion":9,
"Comment":"",
"ProfileOperations":[
"renew",
"disable"
]
}
]