Enrollment Groups - Get X509

Ottenere il certificato x509 primario o secondario di un gruppo di registrazioni
Ottenere informazioni dettagliate sul certificato x509 primario o secondario di un gruppo di registrazioni, se esistente.

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

Parametri dell'URI

Name In Required Type Description
baseDomain
path True
  • string

Dominio di base per tutte le richieste di servizio di Azure IoT Central.

enrollmentGroupId
path True
  • string

ID univoco del gruppo di registrazione.

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

entry
path True

L'immissione del certificato supporta solo primario e secondario.

subdomain
path True
  • string

Sottodominio dell'applicazione.

api-version
query True
  • string

Versione dell'API chiamata.

Risposte

Name Type Description
200 OK

Operazione riuscita

Other Status Codes

Risposta di errore ricevuta dal servizio IoT Central.

Headers

  • x-ms-error-code: string

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

CertificateEntry

L'immissione del certificato supporta solo primario e secondario.

Error

Definizione dell'errore di risposta.

ErrorDetails

Informazioni dettagliate sull'errore.

SigningX509Certificate

Definizione del certificato X509.

X509CertificateInfo

Informazioni sul certificato X509.

CertificateEntry

L'immissione del certificato supporta solo primario e secondario.

Name Type Description
primary
  • string

Voce del certificato primario

secondary
  • string

Voce di certificato secondario

Error

Definizione dell'errore di risposta.

Name Type Description
error

Dettagli dell'errore per la richiesta corrente.

ErrorDetails

Informazioni dettagliate sull'errore.

Name Type Description
code
  • string

Codice di errore.

message
  • string

Dettagli del messaggio di errore.

requestId
  • string

ID correlazione per la richiesta corrente.

time
  • string

Ora in cui la richiesta di errore non è riuscita.

SigningX509Certificate

Definizione del certificato X509.

Name Type Default Value Description
certificate
  • string

Rappresentazione di stringa del certificato.

etag
  • string

ETag usato per evitare conflitti tra più aggiornamenti

info

Informazioni su questo certificato.

verified
  • boolean
False

Indica se il certificato è stato verificato.

X509CertificateInfo

Informazioni sul certificato X509.

Name Type Description
sha1Thumbprint
  • string

Valore hash SHA-1 del certificato.