Share via


Certificates - List By Iot Hub

Ottenere l'elenco di certificati.
Restituisce l'elenco dei certificati.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates?api-version=2023-06-30

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse contenente l'hub IoT.

resourceName
path True

string

Nome dell'hub IoT.

subscriptionId
path True

string

L'identificatore della sottoscrizione.

api-version
query True

string

Versione dell'API.

Risposte

Nome Tipo Descrizione
200 OK

CertificateListDescription

Il corpo contiene tutti gli elenchi di certificati.

Other Status Codes

ErrorDetails

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_ListByIotHub

Sample Request

GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testhub/certificates?api-version=2023-06-30

Sample Response

{
  "value": [
    {
      "properties": {
        "subject": "CN=testdevice1",
        "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
        "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
        "isVerified": false,
        "created": "Thu, 12 Oct 2017 19:23:50 GMT",
        "updated": "Thu, 12 Oct 2017 19:23:50 GMT",
        "certificate": "############################################"
      },
      "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/andbuc-hub/certificates/cert",
      "name": "cert",
      "type": "Microsoft.Devices/IotHubs/Certificates",
      "etag": "AAAAAAExpNs="
    }
  ]
}

Definizioni

Nome Descrizione
CertificateDescription

Certificato X509.

CertificateListDescription

Matrice serializzata JSON degli oggetti Certificate.

CertificateProperties

Descrizione di un certificato CA X509.

ErrorDetails

Dettagli degli errori.

CertificateDescription

Certificato X509.

Nome Tipo Descrizione
etag

string

Il tag di entità.

id

string

Identificatore di risorsa.

name

string

Nome del certificato.

properties

CertificateProperties

Descrizione di un certificato CA X509.

type

string

Tipo di risorsa.

CertificateListDescription

Matrice serializzata JSON degli oggetti Certificate.

Nome Tipo Descrizione
value

CertificateDescription[]

Matrice di oggetti Certificate.

CertificateProperties

Descrizione di un certificato CA X509.

Nome Tipo Descrizione
certificate

string

Contenuto del certificato

created

string

Il certificato crea data e ora.

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.

ErrorDetails

Dettagli degli errori.

Nome Tipo Descrizione
code

string

Codice di errore.

details

string

Dettagli dell'errore.

httpStatusCode

string

Codice di stato HTTP.

message

string

Messaggio di errore.