Compartilhar via


Certificates - List By Iot Hub

Obtenha a lista de certificados.
Retorna a lista de certificados.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates?api-version=2023-06-30

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos que contém o hub IoT.

resourceName
path True

string

O nome do hub IoT.

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

O corpo contém toda a lista de certificados.

Other Status Codes

ErrorDetails

DefaultErrorResponse

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Certificates_ListByIotHub

Solicitação de exemplo

GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testhub/certificates?api-version=2023-06-30

Resposta de exemplo

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

Definições

Nome Description
CertificateDescription

O certificado X509.

CertificateListDescription

A matriz serializada JSON de objetos Certificate.

CertificateProperties

A descrição de um certificado de autoridade de certificação X509.

ErrorDetails

Detalhes do erro.

CertificateDescription

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

A descrição de um certificado de autoridade de certificação X509.

type

string

O tipo de recurso.

CertificateListDescription

A matriz serializada JSON de objetos Certificate.

Nome Tipo Description
value

CertificateDescription[]

A matriz de objetos Certificate.

CertificateProperties

A descrição de um certificado de autoridade de certificação X509.

Nome Tipo Description
certificate

string

O conteúdo do certificado

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.

ErrorDetails

Detalhes do erro.

Nome Tipo Description
code

string

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.