Devices - Replace Properties

Eszköztulajdonságok cseréje
Cserélje le az eszköz összes tulajdonságértékét az eszközazonosítóra.

PUT https://{subdomain}.{baseDomain}/api/devices/{deviceId}/properties?api-version=2022-06-30-preview
PUT https://{subdomain}.{baseDomain}/api/devices/{deviceId}/properties?api-version=2022-06-30-preview&unmodeled={unmodeled}

URI-paraméterek

Name In Required Type Description
baseDomain
path True
  • string

Az összes Azure IoT Central-szolgáltatáskérés alaptartománya.

deviceId
path True
  • string

Az eszköz egyedi azonosítója.

subdomain
path True
  • string

Az alkalmazás altartománya.

api-version
query True
  • string

A meghívandó API verziója.

unmodeled
query
  • boolean

A nem átalakított tulajdonságok támogatásának lekérdezési paramétere.

Kérelem törzse

Name Type Description
body
  • DeviceProperties

Eszköztulajdonságok.

Válaszok

Name Type Description
202 Accepted
  • DeviceProperties

Siker

Other Status Codes

Az IoT Central szolgáltatástól kapott hibaválasz.

Headers

  • x-ms-error-code: string

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

Update properties

Sample Request

PATCH https://appsubdomain.azureiotcentral.com/api/devices/mx1/properties?api-version=2022-06-30-preview

{
  "settings": {
    "voltage": 25,
    "current": 7
  }
}

Sample Response

{
  "settings": {
    "$metadata": {
      "voltage": {
        "desiredValue": 25
      },
      "current": {
        "desiredValue": 7
      }
    }
  }
}

Definíciók

Error

A válaszhiba definíciója.

ErrorDetails

A hiba részletes információi.

Error

A válaszhiba definíciója.

Name Type Description
error

Az aktuális kérelem hibaadatai.

ErrorDetails

A hiba részletes információi.

Name Type Description
code
  • string

Hibakód.

message
  • string

A hibaüzenet részletei.

requestId
  • string

Az aktuális kérés korrelációs azonosítója.

time
  • string

A hibakérés sikertelen volt.