Runtime Registration - Operation Status Lookup

Hizmet:: IoT Hub Device Provisioning Service

API Sürümü:: 2021-10-01

Kayıt işlem durumunu alıyor.

GET https://global.azure-devices-provisioning.net/{idScope}/registrations/{registrationId}/operations/{operationId}?api-version=2021-10-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
idScope	path	True	string	DPS örneğinin kapsamı.
operationId	path	True	string	İşlem Kimliği.
registrationId	path	True	string	Kayıt kimliği.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	RegistrationOperationStatus	İstek başarılı oldu.
202 Accepted	RegistrationOperationStatus	İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı. Üst Bilgiler Location: string retry-after: integer
Other Status Codes	ProvisioningServiceErrorDetails	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Name

Tür

Description

200 OK

RegistrationOperationStatus

İstek başarılı oldu.

202 Accepted

RegistrationOperationStatus

İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.

Üst Bilgiler

Location: string
retry-after: integer

Other Status Codes

ProvisioningServiceErrorDetails

Beklenmeyen bir hata yanıtı.

Üst Bilgiler

x-ms-error-code: string

Örnekler

RuntimeRegistration_OperationStatusLookup_MaximumSet_Gen

RuntimeRegistration_OperationStatusLookup_MinimumSet_Gen

RuntimeRegistration_OperationStatusLookup_MaximumSet_Gen

Örnek isteği

HTTP

GET https://global.azure-devices-provisioning.net/arjoldcjeedohmpuhenotyesppkgk/registrations/ojruvwccsgwnmscfwodrfjrecxuf/operations/fdjhztahuvcjjmutvihsmflepzvsfn?api-version=2021-10-01

Örnek yanıt

Durum kodu:: 200

{
  "operationId": "xosjboksmobnotwgqejpvxiwi",
  "registrationState": {
    "assignedHub": "ljexps",
    "createdDateTimeUtc": "2025-10-01T17:41:56.535Z",
    "deviceId": "hjvdlwpugzlk",
    "errorCode": 13,
    "errorMessage": "zpctqazbkbiqjkwosis",
    "etag": "hjtelksspyfzhmet",
    "lastUpdatedDateTimeUtc": "2025-10-01T17:41:56.535Z",
    "payload": {},
    "registrationId": "urejrffpkqneou",
    "status": "unassigned",
    "substatus": "initialAssignment",
    "symmetricKey": {
      "enrollmentGroupId": "w"
    },
    "tpm": {
      "authenticationKey": "sofbxakhjrxpiyysjjxkx"
    },
    "x509": {
      "certificateInfo": {
        "issuerName": "pvpbipnhcahytrcq",
        "notAfterUtc": "2025-10-01T17:41:56.534Z",
        "notBeforeUtc": "2025-10-01T17:41:56.534Z",
        "serialNumber": "jjvdijgwgpagrjdi",
        "sha1Thumbprint": "guqltcfgusf",
        "sha256Thumbprint": "ysryarleygpkejrjlwuxacvcwbxqw",
        "subjectName": "jtsfqnbcmmott",
        "version": 20
      },
      "enrollmentGroupId": "qbw",
      "signingCertificateInfo": {
        "issuerName": "pvpbipnhcahytrcq",
        "notAfterUtc": "2025-10-01T17:41:56.534Z",
        "notBeforeUtc": "2025-10-01T17:41:56.534Z",
        "serialNumber": "jjvdijgwgpagrjdi",
        "sha1Thumbprint": "guqltcfgusf",
        "sha256Thumbprint": "ysryarleygpkejrjlwuxacvcwbxqw",
        "subjectName": "jtsfqnbcmmott",
        "version": 20
      }
    }
  },
  "status": "unassigned"
}

Durum kodu:: 202

{
  "operationId": "xosjboksmobnotwgqejpvxiwi",
  "registrationState": {
    "assignedHub": "ljexps",
    "createdDateTimeUtc": "2025-10-01T17:41:56.535Z",
    "deviceId": "hjvdlwpugzlk",
    "errorCode": 13,
    "errorMessage": "zpctqazbkbiqjkwosis",
    "etag": "hjtelksspyfzhmet",
    "lastUpdatedDateTimeUtc": "2025-10-01T17:41:56.535Z",
    "payload": {},
    "registrationId": "urejrffpkqneou",
    "status": "unassigned",
    "substatus": "initialAssignment",
    "symmetricKey": {
      "enrollmentGroupId": "w"
    },
    "tpm": {
      "authenticationKey": "sofbxakhjrxpiyysjjxkx"
    },
    "x509": {
      "certificateInfo": {
        "issuerName": "pvpbipnhcahytrcq",
        "notAfterUtc": "2025-10-01T17:41:56.534Z",
        "notBeforeUtc": "2025-10-01T17:41:56.534Z",
        "serialNumber": "jjvdijgwgpagrjdi",
        "sha1Thumbprint": "guqltcfgusf",
        "sha256Thumbprint": "ysryarleygpkejrjlwuxacvcwbxqw",
        "subjectName": "jtsfqnbcmmott",
        "version": 20
      },
      "enrollmentGroupId": "qbw",
      "signingCertificateInfo": {
        "issuerName": "pvpbipnhcahytrcq",
        "notAfterUtc": "2025-10-01T17:41:56.534Z",
        "notBeforeUtc": "2025-10-01T17:41:56.534Z",
        "serialNumber": "jjvdijgwgpagrjdi",
        "sha1Thumbprint": "guqltcfgusf",
        "sha256Thumbprint": "ysryarleygpkejrjlwuxacvcwbxqw",
        "subjectName": "jtsfqnbcmmott",
        "version": 20
      }
    }
  },
  "status": "unassigned"
}

RuntimeRegistration_OperationStatusLookup_MinimumSet_Gen

Örnek isteği

HTTP

GET https://global.azure-devices-provisioning.net/cxcukjqvjopedcgnhtggfdt/registrations/pzgoamgarcmcwvapl/operations/wacw?api-version=2021-10-01

Örnek yanıt

Durum kodu:: 200

{
  "operationId": "xosjboksmobnotwgqejpvxiwi"
}

Durum kodu:: 202

{
  "operationId": "xosjboksmobnotwgqejpvxiwi"
}

Tanımlar

Name	Description
AssignedDeviceSubstatus	'Atanan' cihazlar için alt durum. Olası değerler arasında - 'initialAssignment': Cihaz ilk kez bir IoT hub'a atanmıştır, 'deviceDataMigrated': Cihaz farklı bir IoT hub'a atanmış ve cihaz verisi önceden atanan IoT merkezinden taşınmıştır. Cihaz verileri, önceden atanan IoT merkezinden olan 'deviceDataReset'ten kaldırıldı: Cihaz farklı bir IoT hub'a atanmış ve cihaz verisi, kayıtta saklanan ilk durumdan itibaren doldurulmuştur. Cihaz verileri, önceden atanan IoT merkezinden çıkarıldı, 'reprovisionedToInitialAssignment': Cihaz, önceden atanan bir IoT hub'a yeniden sağlandı.
DeviceRegistrationResult	Cihaz kayıt sonucu.
EnrollmentStatus	Kayıt durumu.
ProvisioningServiceErrorDetails	Azure IoT Hub Provisioning Service tarafından döndürülen bir hatanın özelliklerini içerir.
RegistrationOperationStatus	Kayıt operasyon durumu.
SymmetricKeyRegistrationResult	SymmetricKey doğrulaması kullanıldığında kayıt sonucu geri döndü.
TpmRegistrationResult	TPM kayıt sonucu.
X509CertificateInfo	X509 sertifika bilgisi.
X509RegistrationResult	X509 kayıt sonucu.

AssignedDeviceSubstatus

Numaralandırma

'Atanan' cihazlar için alt durum. Olası değerler arasında - 'initialAssignment': Cihaz ilk kez bir IoT hub'a atanmıştır, 'deviceDataMigrated': Cihaz farklı bir IoT hub'a atanmış ve cihaz verisi önceden atanan IoT merkezinden taşınmıştır. Cihaz verileri, önceden atanan IoT merkezinden olan 'deviceDataReset'ten kaldırıldı: Cihaz farklı bir IoT hub'a atanmış ve cihaz verisi, kayıtta saklanan ilk durumdan itibaren doldurulmuştur. Cihaz verileri, önceden atanan IoT merkezinden çıkarıldı, 'reprovisionedToInitialAssignment': Cihaz, önceden atanan bir IoT hub'a yeniden sağlandı.

Değer	Description
initialAssignment	başlangıçAtama
deviceDataMigrated	deviceDataMigrated
deviceDataReset	deviceDataReset
reprovisionedToInitialAssignment	reprovisionedToInitial Assignment

DeviceRegistrationResult

Nesne

Cihaz kayıt sonucu.

Name	Tür	Description
assignedHub	string	Azure IoT Hub atandı.
createdDateTimeUtc	string (date-time)	Kayıt, tarih saatini oluştur (UTC'de).
deviceId	string	Cihaz kimliği.
errorCode	integer (int32)	Hata kodu.
errorMessage	string	Hata mesajı.
etag	string	Kaynakla ilişkili varlık etiketi.
lastUpdatedDateTimeUtc	string (date-time)	Son güncellenen tarih saati (UTC'de).
payload		Herhangi bir nesne
registrationId	string	Bu id, bir kayıt cihazının kayıt cihazını benzersiz şekilde tanımlamak için kullanılır. Alfanumerik karakterler ve belirli özel karakterlerden oluşan küçük harfi duyarsız (128 karaktere kadar uzunluğunda) bir dizi : . _ -. Başta veya sonunda özel karakterlere izin verilmez.
status	EnrollmentStatus	Kayıt durumu.
substatus	AssignedDeviceSubstatus	'Atanan' cihazlar için alt durum. Olası değerler arasında - 'initialAssignment': Cihaz ilk kez bir IoT hub'a atanmıştır, 'deviceDataMigrated': Cihaz farklı bir IoT hub'a atanmış ve cihaz verisi önceden atanan IoT merkezinden taşınmıştır. Cihaz verileri, önceden atanan IoT merkezinden olan 'deviceDataReset'ten kaldırıldı: Cihaz farklı bir IoT hub'a atanmış ve cihaz verisi, kayıtta saklanan ilk durumdan itibaren doldurulmuştur. Cihaz verileri, önceden atanan IoT merkezinden çıkarıldı, 'reprovisionedToInitialAssignment': Cihaz, önceden atanan bir IoT hub'a yeniden sağlandı.
symmetricKey	SymmetricKeyRegistrationResult	SymmetricKey doğrulaması kullanıldığında kayıt sonucu geri döndü.
tpm	TpmRegistrationResult	TPM kayıt sonucu.
x509	X509RegistrationResult	X509 kayıt sonucu.

EnrollmentStatus

Numaralandırma

Kayıt durumu.

Değer	Description
unassigned	Atanma -mış
assigning	Atama
assigned	Atanmış
failed	başarısız
disabled	engelli

ProvisioningServiceErrorDetails

Nesne

Azure IoT Hub Provisioning Service tarafından döndürülen bir hatanın özelliklerini içerir.

Name	Tür	Description
errorCode	integer (int32)	Sayısal hata kodu.
info	object	<dize> sözlüğü
message	string	Hata mesajı.
timestampUtc	string (date-time)	Hata zaman damgası (UTC).
trackingId	string	Hata takip kimliği.

RegistrationOperationStatus

Nesne

Kayıt operasyon durumu.

Name	Tür	Description
operationId	string minLength: 1	İşlem Kimliği.
registrationState	DeviceRegistrationResult	Cihaz kayıt sonucu.
status	EnrollmentStatus	Cihaz kayıt durumu.

SymmetricKeyRegistrationResult

Nesne

SymmetricKey doğrulaması kullanıldığında kayıt sonucu geri döndü.

Name	Tür	Description
enrollmentGroupId	string	Kayıt grubu kimliği.

TpmRegistrationResult

Nesne

TPM kayıt sonucu.

Name	Tür	Description
authenticationKey	string	Şifreli kimlik doğrulama anahtarı.

X509CertificateInfo

Nesne

X509 sertifika bilgisi.

Name	Tür	Description
issuerName	string	Sertifika verenin adı.
notAfterUtc	string (date-time)	Sertifikanın son kullanma tarihi (UTC).
notBeforeUtc	string (date-time)	Sertifika geçerliliği başlangıç tarihi (UTC).
serialNumber	string	Sertifika seri numarası.
sha1Thumbprint	string	Sertifikanın SHA-1 parmak izi.
sha256Thumbprint	string	Sertifikanın SHA-256 parmak izi.
subjectName	string	Sertifika konu adı.
version	integer (int32)	Sertifika sürümü.

X509RegistrationResult

Nesne

X509 kayıt sonucu.

Name	Tür	Description
certificateInfo	X509CertificateInfo	X509 sertifika bilgisi.
enrollmentGroupId	string	Kayıt grubu kimliği.
signingCertificateInfo	X509CertificateInfo	X509 sertifika bilgisi.