Enrollment Groups - Get X509

Obter o certificado x509 primário ou secundário de um grupo de registro
Obtenha detalhes sobre o certificado x509 primário ou secundário de um grupo de registro, se ele existir.

GET https://{subdomain}.{baseDomain}/api/enrollmentGroups/{enrollmentGroupId}/certificates/{entry}?api-version=2022-07-31

Parâmetros de URI

Name In Required Type Description
baseDomain
path True
  • string

O domínio base para todas as solicitações de serviço do Azure IoT Central.

enrollmentGroupId
path True
  • string

ID exclusiva do grupo de registro.

Regex pattern: ^[a-zA-Z0-9-]*$

entry
path True

A entrada do certificado dá suporte apenas ao primário e ao secundário.

subdomain
path True
  • string

O subdomínio do aplicativo.

api-version
query True
  • string

A versão da API que está sendo chamada.

Respostas

Name Type Description
200 OK

Sucesso

Other Status Codes

Uma resposta de erro recebida do Serviço Central de IoT.

Headers

  • x-ms-error-code: string

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

Get primary or secondary X509

Sample Request

GET https://appsubdomain.azureiotcentral.com/api/enrollmentGroups/myEnrollmentGroupId/certificates/primary?api-version=2022-07-31

Sample Response

{
  "verified": true,
  "info": {
    "sha1Thumbprint": "644543467786B60C14DFE6B7C968A1990CF63EAC"
  },
  "etag": "IjE3MDAwODNhLTAwMDAtMDcwMC0wMDAwLTYyNjFmNzk0MDAwMCI="
}

Definições

CertificateEntry

A entrada do certificado dá suporte apenas ao primário e ao secundário.

Error

A definição de erro de resposta.

ErrorDetails

As informações detalhadas do erro.

SigningX509Certificate

A definição do certificado X509.

X509CertificateInfo

As informações do certificado X509.

CertificateEntry

A entrada do certificado dá suporte apenas ao primário e ao secundário.

Name Type Description
primary
  • string

A entrada do certificado primário

secondary
  • string

A entrada do certificado secundário

Error

A definição de erro de resposta.

Name Type Description
error

Detalhes do erro da solicitação atual.

ErrorDetails

As informações detalhadas do erro.

Name Type Description
code
  • string

Código do erro.

message
  • string

Detalhes da mensagem de erro.

requestId
  • string

ID de correlação para a solicitação atual.

time
  • string

A hora em que a solicitação de erro falhou.

SigningX509Certificate

A definição do certificado X509.

Name Type Default Value Description
certificate
  • string

A representação de cadeia de caracteres desse certificado.

etag
  • string

ETag usada para evitar conflitos em várias atualizações

info

Informações sobre esse certificado.

verified
  • boolean
False

Se o certificado foi verificado.

X509CertificateInfo

As informações do certificado X509.

Name Type Description
sha1Thumbprint
  • string

O valor de hash SHA-1 do certificado.