Dela via


Certificates - List By Iot Hub

Hämta certifikatlistan.
Returnerar listan över certifikat.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen som innehåller IoT-hubben.

resourceName
path True

string

Namnet på IoT-hubben.

subscriptionId
path True

string

Prenumerationsidentifieraren.

api-version
query True

string

Versionen av API:et.

Svar

Name Typ Description
200 OK

CertificateListDescription

Brödtexten innehåller hela certifikatlistan.

Other Status Codes

ErrorDetails

DefaultErrorResponse

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Certificates_ListByIotHub

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
CertificateDescription

X509-certifikatet.

CertificateListDescription

Den JSON-serialiserade matrisen med certifikatobjekt.

CertificateProperties

Beskrivning av ett X509 CA-certifikat.

ErrorDetails

Felinformation.

CertificateDescription

X509-certifikatet.

Name Typ Description
etag

string

Entitetstaggen.

id

string

Resursidentifieraren.

name

string

Namnet på certifikatet.

properties

CertificateProperties

Beskrivning av ett X509 CA-certifikat.

type

string

Resurstypen.

CertificateListDescription

Den JSON-serialiserade matrisen med certifikatobjekt.

Name Typ Description
value

CertificateDescription[]

Matrisen med certifikatobjekt.

CertificateProperties

Beskrivning av ett X509 CA-certifikat.

Name Typ Description
certificate

string

Certifikatinnehållet

created

string

Certifikatets skapandedatum och -tid.

expiry

string

Certifikatets förfallodatum och -tid.

isVerified

boolean

Avgör om certifikatet har verifierats.

subject

string

Certifikatets ämnesnamn.

thumbprint

string

Certifikatets tumavtryck.

updated

string

Certifikatets senaste uppdateringsdatum och -tid.

ErrorDetails

Felinformation.

Name Typ Description
code

string

Felkoden.

details

string

Felinformationen.

httpStatusCode

string

HTTP-statuskoden.

message

string

Felmeddelandet.