Devices - Get Attestation

デバイス構成証明を取得する

GET https://{subdomain}.{baseDomain}/api/devices/{deviceId}/attestation?api-version=2022-07-31

URI パラメーター

Name In Required Type Description
baseDomain
path True
  • string

すべての Azure IoT Central サービス要求のベース ドメイン。

deviceId
path True
  • string

デバイスの一意の ID。

subdomain
path True
  • string

アプリケーション サブドメイン。

api-version
query True
  • string

呼び出される API のバージョン。

応答

Name Type Description
200 OK Attestation:

Success

Other Status Codes

IoT Central サービスから受信したエラー応答。

Headers

  • x-ms-error-code: string

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

Scopes

Name Description
user_impersonation ユーザー アカウントを偽装する

Get device attestation

Sample Request

GET https://appsubdomain.azureiotcentral.com/api/devices/CheckoutThermostat/attestation?api-version=2022-07-31

Sample Response

{
  "type": "x509",
  "x509": {
    "clientCertificates": {
      "primary": {
        "info": {
          "sha1Thumbprint": "<thumbprint>"
        }
      }
    }
  }
}

定義

Error

応答エラーの定義。

ErrorDetails

エラーの詳細情報。

SymmetricKey

対称キーの定義。

SymmetricKeyAttestation

対称キー構成証明の定義。

Tpm

信頼されたプラットフォーム モジュールの定義。

TpmAttestation

TPM 構成証明の定義。

X509

X509 定義。

X509Attestation

X509 構成証明の定義。

X509Certificate

X509 証明書の定義。

X509CertificateInfo

X509 証明書情報。

X509Certificates

X509 証明書の定義。

Error

応答エラーの定義。

Name Type Description
error

現在の要求のエラーの詳細。

ErrorDetails

エラーの詳細情報。

Name Type Description
code
  • string

エラー コード。

message
  • string

エラー メッセージの詳細。

requestId
  • string

現在の要求の関連付け ID。

time
  • string

エラー要求が失敗した時刻。

SymmetricKey

対称キーの定義。

Name Type Description
primaryKey
  • string

この資格情報の主キー。

secondaryKey
  • string

この資格情報のセカンダリ キー。

SymmetricKeyAttestation

対称キー構成証明の定義。

Name Type Description
symmetricKey

この構成証明の対称キー資格情報。

type string:
  • symmetricKey

構成証明の種類。

Tpm

信頼されたプラットフォーム モジュールの定義。

Name Type Description
endorsementKey
  • string

この資格情報の TPM 保証キー。

TpmAttestation

TPM 構成証明の定義。

Name Type Description
tpm

この構成証明の TPM 資格情報。

type string:
  • tpm

構成証明の種類。

X509

X509 定義。

Name Type Description
clientCertificates

この資格情報の X.509 クライアント証明書。

X509Attestation

X509 構成証明の定義。

Name Type Description
type string:
  • x509

構成証明の種類。

x509

この構成証明の X.509 資格情報。

X509Certificate

X509 証明書の定義。

Name Type Description
certificate
  • string

この証明書の文字列表現。

info

この証明書に関する情報。

X509CertificateInfo

X509 証明書情報。

Name Type Description
sha1Thumbprint
  • string

証明書の SHA-1 ハッシュ値。

X509Certificates

X509 証明書の定義。

Name Type Description
primary

この資格情報のプライマリ X.509 証明書。

secondary

この資格情報のセカンダリ X.509 証明書。