Enrollment Groups - Get X509

Service:

IoT Central

API Version:

2022-07-31

등록 그룹의 기본 또는 보조 x509 인증서 가져오기
등록 그룹의 기본 또는 보조 x509 인증서(있는 경우)에 대한 세부 정보를 가져옵니다.

GET https://{subdomain}.{baseDomain}/api/enrollmentGroups/{enrollmentGroupId}/certificates/{entry}?api-version=2022-07-31

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
baseDomain	path	True	string	모든 Azure IoT Central 서비스 요청에 대한 기본 도메인입니다.
enrollmentGroupId	path	True	string	등록 그룹의 고유 ID입니다. Regex pattern: ^[a-zA-Z0-9-]*$
entry	path	True	CertificateEntry	인증서 항목은 기본 및 보조만 지원합니다.
subdomain	path	True	string	애플리케이션 하위 도메인입니다.
api-version	query	True	string	호출되는 API의 버전입니다.

응답

Name	형식	Description
200 OK	SigningX509Certificate	Success
Other Status Codes	Error	IoT Central 서비스에서 받은 오류 응답입니다. Headers x-ms-error-code: string

보안

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	사용자 계정 가장

예제

Get primary or secondary X509

Sample Request

HTTP

GET https://appsubdomain.azureiotcentral.com/api/enrollmentGroups/myEnrollmentGroupId/certificates/primary?api-version=2022-07-31

Sample Response

Status code:

200

{
  "verified": true,
  "info": {
    "sha1Thumbprint": "644543467786B60C14DFE6B7C968A1990CF63EAC"
  },
  "etag": "IjE3MDAwODNhLTAwMDAtMDcwMC0wMDAwLTYyNjFmNzk0MDAwMCI="
}

정의

Name	Description
CertificateEntry	인증서 항목은 기본 및 보조만 지원합니다.
Error	응답 오류 정의입니다.
ErrorDetails	오류의 세부 정보입니다.
SigningX509Certificate	X509 인증서 정의입니다.
X509CertificateInfo	X509 인증서 정보입니다.

CertificateEntry

인증서 항목은 기본 및 보조만 지원합니다.

Name	형식	Description
primary	string	기본 인증서의 항목
secondary	string	보조 인증서의 항목

Error

응답 오류 정의입니다.

Name	형식	Description
error	ErrorDetails	현재 요청에 대한 오류 세부 정보입니다.

ErrorDetails

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드
message	string	오류 메시지 세부 정보입니다.
requestId	string	현재 요청에 대한 상관 관계 ID입니다.
time	string	오류 요청이 실패한 시간입니다.

SigningX509Certificate

X509 인증서 정의입니다.

Name	형식	기본값	Description
certificate	string		이 인증서의 문자열 표현입니다.
etag	string		여러 업데이트에서 충돌을 방지하는 데 사용되는 ETag
info	X509CertificateInfo		이 인증서에 대한 정보입니다.
verified	boolean	False	인증서가 확인되었는지 여부입니다.

X509CertificateInfo

X509 인증서 정보입니다.

Name	형식	Description
sha1Thumbprint	string	인증서의 SHA-1 해시 값입니다.