Dps Certificate - List

Referência

Serviço:: IoT Hub Device Provisioning Service

Versão da API:: 2022-12-12

Obtenha todos os certificados associados ao serviço de aprovisionamento.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
provisioningServiceName	path	True	string	Nome do serviço de aprovisionamento para o qual obter certificados.
resourceGroupName	path	True	string	o nome do grupo de recursos.
subscriptionId	path	True	string	O identificador da subscrição.
api-version	query	True	string	A versão da API.

Respostas

Name	Tipo	Description
200 OK	CertificateListDescription	Lista de descrições de certificados numa matriz serializada JSON.
Other Status Codes	ErrorDetails	Resposta de erro predefinida.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

DPSGetCertificates

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Name	Description
CertificateListDescription	A matriz serializada JSON de objetos de Certificado.
CertificateProperties	A descrição de um Certificado de AC 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 JSON de objetos de Certificado.

Name	Tipo	Description
value	CertificateResponse[]	A matriz de objetos de Certificado.

CertificateProperties

A descrição de um Certificado de AC X509.

Name	Tipo	Description
certificate	string	representação base 64 do certificado X509 .cer ficheiro ou apenas conteúdo de ficheiro .pem.
created	string	Data e hora de criação do certificado.
expiry	string	A data e hora de expiração do certificado.
isVerified	boolean	Determina se o certificado foi verificado.
subject	string	O nome do requerente do certificado.
thumbprint	string	O thumbprint do certificado.
updated	string	A data e hora da última atualização do certificado.

CertificateResponse

O Certificado X509.

Name	Tipo	Description
etag	string	A etiqueta de entidade.
id	string	O identificador de recursos.
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.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Detalhes do erro.

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

systemData

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

Name	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.

Partilhar via