Devices - Replace Properties

Zastępowanie właściwości urządzenia
Zamień wszystkie wartości właściwości urządzenia według identyfikatora urządzenia.

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}

Parametry identyfikatora URI

Name In Required Type Description
baseDomain
path True
  • string

Domena podstawowa dla wszystkich żądań obsługi usługi Azure IoT Central.

deviceId
path True
  • string

Unikatowy identyfikator urządzenia.

subdomain
path True
  • string

Poddomena aplikacji.

api-version
query True
  • string

Wywoływana wersja interfejsu API.

unmodeled
query
  • boolean

Parametr zapytania do obsługi niemodelowanych właściwości.

Treść żądania

Name Type Description
body
  • DeviceProperties

Właściwości urządzenia.

Odpowiedzi

Name Type Description
202 Accepted
  • DeviceProperties

Powodzenie

Other Status Codes

Odebrano odpowiedź o błędzie z usługi IoT Central.

Headers

  • x-ms-error-code: string

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Name Description
user_impersonation personifikacja konta użytkownika

Przykłady

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
      }
    }
  }
}

Definicje

Error

Definicja błędu odpowiedzi.

ErrorDetails

Szczegółowe informacje o błędzie.

Error

Definicja błędu odpowiedzi.

Name Type Description
error

Szczegóły błędu dla bieżącego żądania.

ErrorDetails

Szczegółowe informacje o błędzie.

Name Type Description
code
  • string

Kod błędu.

message
  • string

Szczegóły komunikatu o błędzie.

requestId
  • string

Identyfikator korelacji dla bieżącego żądania.

time
  • string

Czas niepowodzenia żądania błędu.