Enrollment Groups - Get X509

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

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

URI 매개 변수

Name In Required Type Description
baseDomain
path True
  • string

모든 Azure IoT Central 서비스 요청에 대한 기본 도메인입니다.

enrollmentGroupId
path True
  • string

등록 그룹의 고유 ID입니다.

Regex pattern: ^[a-zA-Z0-9-]*$

entry
path True

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

subdomain
path True
  • string

애플리케이션 하위 도메인입니다.

api-version
query True
  • string

호출되는 API의 버전입니다.

응답

Name Type Description
200 OK

Success

Other Status Codes

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

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

Sample Response

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

정의

CertificateEntry

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

Error

응답 오류 정의입니다.

ErrorDetails

오류의 세부 정보입니다.

SigningX509Certificate

X509 인증서 정의입니다.

X509CertificateInfo

X509 인증서 정보입니다.

CertificateEntry

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

Name Type Description
primary
  • string

기본 인증서의 항목

secondary
  • string

보조 인증서의 항목

Error

응답 오류 정의입니다.

Name Type Description
error

현재 요청에 대한 오류 세부 정보입니다.

ErrorDetails

오류의 세부 정보입니다.

Name Type Description
code
  • string

오류 코드

message
  • string

오류 메시지 세부 정보입니다.

requestId
  • string

현재 요청에 대한 상관 관계 ID입니다.

time
  • string

오류 요청이 실패한 시간입니다.

SigningX509Certificate

X509 인증서 정의입니다.

Name Type Default Value Description
certificate
  • string

이 인증서의 문자열 표현입니다.

etag
  • string

여러 업데이트에서 충돌을 방지하는 데 사용되는 ETag

info

이 인증서에 대한 정보입니다.

verified
  • boolean
False

인증서가 확인되었는지 여부입니다.

X509CertificateInfo

X509 인증서 정보입니다.

Name Type Description
sha1Thumbprint
  • string

인증서의 SHA-1 해시 값입니다.