你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Dps Certificate - List

参考

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

获取绑定到预配服务的所有证书。

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

URI 参数

名称	在	必需	类型	说明
provisioningServiceName	path	True	string	要为其检索证书的预配服务的名称。
resourceGroupName	path	True	string	资源组的名称。
subscriptionId	path	True	string	订阅标识符。
api-version	query	True	string	API 的版本。

响应

名称	类型	说明
200 OK	CertificateListDescription	JSON 序列化数组中的证书说明列表。
Other Status Codes	ErrorDetails	默认错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

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

定义

名称	说明
CertificateListDescription	证书对象的 JSON 序列化数组。
CertificateProperties	X509 CA 证书的说明。
CertificateResponse	X509 证书。
createdByType	创建资源的标识类型。
ErrorDetails	错误详细信息。
systemData	与资源的创建和上次修改相关的元数据。

CertificateListDescription

证书对象的 JSON 序列化数组。

名称	类型	说明
value	CertificateResponse[]	Certificate 对象的数组。

CertificateProperties

X509 CA 证书的说明。

名称	类型	说明
certificate	string	x509 证书.cer文件或仅 .pem 文件内容的 base-64 表示形式。
created	string	证书的创建日期和时间。
expiry	string	证书的过期日期和时间。
isVerified	boolean	确定是否已验证证书。
subject	string	证书的使用者名称。
thumbprint	string	证书的指纹。
updated	string	证书的上次更新日期和时间。

CertificateResponse

X509 证书。

名称	类型	说明
etag	string	实体标记。
id	string	资源标识符。
name	string	证书的名称。
properties	CertificateProperties	证书的属性
systemData	systemData	与资源的创建和上次修改相关的元数据。
type	string	资源类型。

createdByType

创建资源的标识类型。

名称	类型	说明
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

错误详细信息。

名称	类型	说明
code	integer	错误代码。
details	string	错误详细信息。
httpStatusCode	string	HTTP 状态代码。
message	string	错误消息。

systemData

与资源的创建和上次修改相关的元数据。

名称	类型	说明
createdAt	string	资源的创建时间戳 (UTC) 。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识类型。
lastModifiedAt	string	资源上次修改的时间戳 (UTC)
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识类型。

通过