Enrollment Groups - Get X509

Service:

IoT Central

API Version:

2022-07-31

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

Nome	In	Necessario	Tipo	Descrizione
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	CertificateEntry	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

Nome	Tipo	Descrizione
200 OK	SigningX509Certificate	Operazione riuscita
Other Status Codes	Error	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

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

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

Definizioni

Nome	Descrizione
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.

Nome	Tipo	Descrizione
primary	string	Voce del certificato primario
secondary	string	Voce di certificato secondario

Error

Definizione dell'errore di risposta.

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore per la richiesta corrente.

ErrorDetails

Informazioni dettagliate sull'errore.

Nome	Tipo	Descrizione
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.

Nome	Tipo	Valore predefinito	Descrizione
certificate	string		Rappresentazione di stringa del certificato.
etag	string		ETag usato per evitare conflitti tra più aggiornamenti
info	X509CertificateInfo		Informazioni su questo certificato.
verified	boolean	False	Indica se il certificato è stato verificato.

X509CertificateInfo

Informazioni sul certificato X509.

Nome	Tipo	Descrizione
sha1Thumbprint	string	Valore hash SHA-1 del certificato.