Dps Certificate - List

Service:

IoT Hub Device Provisioning Service

API Version:

2022-12-12

Get all the certificates tied to the provisioning service.

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

URI Parameters

Name	In	Required	Type	Description
provisioningServiceName	path	True	string	Name of provisioning service to retrieve certificates for.
resourceGroupName	path	True	string	Name of resource group.
subscriptionId	path	True	string	The subscription identifier.
api-version	query	True	string	The version of the API.

Responses

Name	Type	Description
200 OK	CertificateListDescription	List of certificate descriptions in a JSON-serialized array.
Other Status Codes	ErrorDetails	Default error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

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

Definitions

Name	Description
CertificateListDescription	The JSON-serialized array of Certificate objects.
CertificateProperties	The description of an X509 CA Certificate.
CertificateResponse	The X509 Certificate.
createdByType	The type of identity that created the resource.
ErrorDetails	Error details.
systemData	Metadata pertaining to creation and last modification of the resource.

CertificateListDescription

The JSON-serialized array of Certificate objects.

Name	Type	Description
value	CertificateResponse[]	The array of Certificate objects.

CertificateProperties

The description of an X509 CA Certificate.

Name	Type	Description
certificate	string	base-64 representation of X509 certificate .cer file or just .pem file content.
created	string	The certificate's creation date and time.
expiry	string	The certificate's expiration date and time.
isVerified	boolean	Determines whether certificate has been verified.
subject	string	The certificate's subject name.
thumbprint	string	The certificate's thumbprint.
updated	string	The certificate's last update date and time.

CertificateResponse

The X509 Certificate.

Name	Type	Description
etag	string	The entity tag.
id	string	The resource identifier.
name	string	The name of the certificate.
properties	CertificateProperties	properties of a certificate
systemData	systemData	Metadata pertaining to creation and last modification of the resource.
type	string	The resource type.

createdByType

The type of identity that created the resource.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Error details.

Name	Type	Description
code	integer	The error code.
details	string	The error details.
httpStatusCode	string	The HTTP status code.
message	string	The error message.

systemData

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.