Enrollment Groups - Get X509

Mendapatkan sertifikat x509 primer atau sekunder dari grup pendaftaran
Dapatkan detail tentang sertifikat x509 primer atau sekunder dari grup pendaftaran, jika ada.

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

Parameter URI

Name In Required Type Description
baseDomain
path True
  • string

Domain dasar untuk semua permintaan layanan Azure IoT Central.

enrollmentGroupId
path True
  • string

ID unik grup pendaftaran.

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

entry
path True

Entri sertifikat hanya mendukung primer dan sekunder.

subdomain
path True
  • string

Subdomain aplikasi.

api-version
query True
  • string

Versi API yang dipanggil.

Respons

Name Type Description
200 OK

Berhasil

Other Status Codes

Respons kesalahan yang diterima dari IoT Central Service.

Headers

  • x-ms-error-code: string

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

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

Scopes

Name Description
user_impersonation meniru akun pengguna Anda

Contoh

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="
}

Definisi

CertificateEntry

Entri sertifikat hanya mendukung primer dan sekunder.

Error

Definisi kesalahan respons.

ErrorDetails

Informasi detail kesalahan.

SigningX509Certificate

Definisi sertifikat X509.

X509CertificateInfo

Info sertifikat X509.

CertificateEntry

Entri sertifikat hanya mendukung primer dan sekunder.

Name Type Description
primary
  • string

Entri sertifikat utama

secondary
  • string

Entri sertifikat sekunder

Error

Definisi kesalahan respons.

Name Type Description
error

Detail kesalahan untuk permintaan saat ini.

ErrorDetails

Informasi detail kesalahan.

Name Type Description
code
  • string

Kode Kesalahan.

message
  • string

Detail pesan kesalahan.

requestId
  • string

Id Korelasi untuk permintaan saat ini.

time
  • string

Waktu permintaan kesalahan gagal.

SigningX509Certificate

Definisi sertifikat X509.

Name Type Default Value Description
certificate
  • string

Representasi string sertifikat ini.

etag
  • string

ETag digunakan untuk mencegah konflik di beberapa pembaruan

info

Informasi tentang sertifikat ini.

verified
  • boolean
False

Apakah sertifikat telah diverifikasi.

X509CertificateInfo

Info sertifikat X509.

Name Type Description
sha1Thumbprint
  • string

Nilai hash SHA-1 sertifikat.