Certificates - Verify
Verificare il possesso della chiave privata del certificato.
Verifica il possesso della chiave privata del certificato specificando il certificato foglia emesso dal certificato precaricati.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates/{certificateName}/verify?api-version=2023-06-30
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
certificate
|
path | True |
string |
Nome del certificato Regex pattern: |
resource
|
path | True |
string |
Nome del gruppo di risorse che contiene l'hub IoT. |
resource
|
path | True |
string |
Nome dell'hub IoT. |
subscription
|
path | True |
string |
L'identificatore della sottoscrizione. |
api-version
|
query | True |
string |
Versione dell'API. |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
If-Match | True |
string |
ETag del certificato. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
certificate |
string |
rappresentazione di base 64 del certificato X509 .cer file o solo contenuto del file pem. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Il corpo contiene il certificato. |
|
Other Status Codes |
DefaultErrorResponse |
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
Certificates_Verify
Sample Request
POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/myFirstProvisioningService/certificates/cert/verify?api-version=2023-06-30
{
"certificate": "#####################################"
}
Sample Response
{
"properties": {
"subject": "CN=andbucdevice1",
"expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
"thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
"isVerified": true,
"created": "Thu, 12 Oct 2017 19:23:50 GMT",
"updated": "Thu, 12 Oct 2017 19:26:56 GMT"
},
"id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService/certificates/cert",
"name": "cert",
"type": "Microsoft.Devices/IotHubs/Certificates",
"etag": "AAAAAAExpTQ="
}
Definizioni
Nome | Descrizione |
---|---|
Certificate |
Certificato X509. |
Certificate |
Descrizione di un certificato DELLA CA X509. |
Certificate |
Certificato foglia serializzato JSON |
Error |
Dettagli errore. |
CertificateDescription
Certificato X509.
Nome | Tipo | Descrizione |
---|---|---|
etag |
string |
Il tag di entità. |
id |
string |
Identificatore della risorsa. |
name |
string |
Nome del certificato. |
properties |
Descrizione di un certificato DELLA CA X509. |
|
type |
string |
Tipo di risorsa. |
CertificateProperties
Descrizione di un certificato DELLA CA X509.
Nome | Tipo | Descrizione |
---|---|---|
certificate |
string |
Contenuto del certificato |
created |
string |
Data e ora di creazione del certificato. |
expiry |
string |
Data e ora di scadenza del certificato. |
isVerified |
boolean |
Determina se il certificato è stato verificato. |
subject |
string |
Nome soggetto del certificato. |
thumbprint |
string |
identificazione personale del certificato. |
updated |
string |
Data e ora dell'ultimo aggiornamento del certificato. |
CertificateVerificationDescription
Certificato foglia serializzato JSON
Nome | Tipo | Descrizione |
---|---|---|
certificate |
string |
rappresentazione di base 64 del certificato X509 .cer file o solo contenuto del file pem. |
ErrorDetails
Dettagli errore.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
details |
string |
Dettagli dell'errore. |
httpStatusCode |
string |
Codice di stato HTTP. |
message |
string |
Messaggio di errore. |