Dps Certificate - List

Service:

IoT Hub Device Provisioning Service

API Version:

2022-12-12

Obter todos os certificados vinculados ao serviço de provisionamento.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
provisioningServiceName	path	True	string	Nome do serviço de provisionamento para o qual recuperar certificados.
resourceGroupName	path	True	string	Nome do grupo de recursos.
subscriptionId	path	True	string	O identificador da assinatura.
api-version	query	True	string	A versão da API.

Respostas

Nome	Tipo	Description
200 OK	CertificateListDescription	Lista de descrições de certificado em uma matriz serializada por JSON.
Other Status Codes	ErrorDetails	Resposta de erro padrão.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Definições

Nome	Description
CertificateListDescription	A matriz serializada em JSON de objetos Certificate.
CertificateProperties	A descrição de um Certificado de Autoridade de Certificação X509.
CertificateResponse	O certificado X509.
createdByType	O tipo de identidade que criou o recurso.
ErrorDetails	Detalhes do erro.
systemData	Metadados relativos à criação e à última modificação do recurso.

CertificateListDescription

A matriz serializada em JSON de objetos Certificate.

Nome	Tipo	Description
value	CertificateResponse[]	A matriz de objetos Certificate.

CertificateProperties

A descrição de um Certificado de Autoridade de Certificação X509.

Nome	Tipo	Description
certificate	string	representação base-64 do certificado X509 .cer arquivo ou apenas o conteúdo do arquivo .pem.
created	string	Data e hora de criação do certificado.
expiry	string	Data e hora de validade do certificado.
isVerified	boolean	Determina se o certificado foi verificado.
subject	string	O nome da entidade do certificado.
thumbprint	string	a impressão digital do certificado.
updated	string	Data e hora da última atualização do certificado.

CertificateResponse

O certificado X509.

Nome	Tipo	Description
etag	string	A marca da entidade.
id	string	O identificador do recurso.
name	string	O nome do certificado.
properties	CertificateProperties	propriedades de um certificado
systemData	systemData	Metadados relativos à criação e à última modificação do recurso.
type	string	O tipo de recurso.

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Detalhes do erro.

Nome	Tipo	Description
code	integer	O código de erro.
details	string	Os detalhes do erro.
httpStatusCode	string	O código de status do HTTP.
message	string	A mensagem de erro.

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.