Dps Certificate - List

Riferimento

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

Ottenere tutti i certificati associati al servizio di provisioning.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates?api-version=2022-12-12

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
provisioningServiceName	path	True	string	Nome del servizio di provisioning per cui recuperare i certificati.
resourceGroupName	path	True	string	Nome del gruppo di risorse.
subscriptionId	path	True	string	L'identificatore della sottoscrizione.
api-version	query	True	string	Versione dell'API.

Risposte

Nome	Tipo	Descrizione
200 OK	CertificateListDescription	Elenco delle descrizioni dei certificati in una matrice serializzata JSON.
Other Status Codes	ErrorDetails	Risposta di errore predefinita.

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

DPSGetCertificates

Sample Request

HTTP

GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates?api-version=2022-12-12

Sample Response

Status code:: 200

{
  "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": "MA=="
      },
      "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/andbuc-hub/certificates/cert",
      "name": "cert",
      "type": "Microsoft.Devices/ProvisioningServices/Certificates",
      "etag": "AAAAAAExpNs="
    }
  ]
}

Definizioni

Nome	Descrizione
CertificateListDescription	Matrice serializzata JSON di oggetti Certificate.
CertificateProperties	Descrizione di un certificato DELLA CA X509.
CertificateResponse	Certificato X509.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorDetails	Dettagli errore.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

CertificateListDescription

Matrice serializzata JSON di oggetti Certificate.

Nome	Tipo	Descrizione
value	CertificateResponse[]	Matrice di oggetti Certificate.

CertificateProperties

Descrizione di un certificato DELLA CA X509.

Nome	Tipo	Descrizione
certificate	string	rappresentazione di base 64 del certificato X509 .cer file o solo contenuto del file pem.
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.

CertificateResponse

Certificato X509.

Nome	Tipo	Descrizione
etag	string	Il tag di entità.
id	string	Identificatore della risorsa.
name	string	Nome del certificato.
properties	CertificateProperties	proprietà di un certificato
systemData	systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
type	string	Tipo di risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Dettagli errore.

Nome	Tipo	Descrizione
code	integer	Codice di errore.
details	string	Dettagli dell'errore.
httpStatusCode	string	Codice di stato HTTP.
message	string	Messaggio di errore.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione di risorse (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.