Verze rozhraní API rozhraní REST API roviny dat Azure IoT Central

Tento článek obsahuje seznam aktuálních a minulých verzí rozhraní REST API pro Azure IoT Central.

Stabilní verze

Tyto verze jsou stabilními verzemi, které je možné použít k vývoji produkčních řešení pomocí Azure IoT Central.

Verze Preview

Verze Preview se vydávají za účelem testování nových funkcí, získávání zpětné vazby a zjišťování a oprav problémů. Rozhraní API verze Preview jsou k dispozici v dodatečných podmínkách použití a nedoporučují se pro úlohy v produkčním prostředí.

Poznámky k verzi

2022-10-31-preview

Verze Preview rozhraní API roviny dat Azure IoT Central z 31. října 2022 přináší řadu vylepšení stávajících koncových bodů a přidává několik nových koncových bodů, které umožňují následující klíčové funkce.

• Funkce dotazu na vlastnosti aktuálního rozhraní API pro dotazy se už nepodporuje a omezuje rychlost na jeden požadavek za minutu.

  Poznámka

  Tato funkce bude odebrána do 30. června 2023.

• Podpora vytváření a správy životního cyklu pro manifesty nasazení Microsoft Edge.

  Poznámka

  Tyto manifesty jsou teď oddělené od šablon zařízení a dají se spravovat nezávisle.

• Odebrání deploymentManifest z definice DeviceTemplate. V rámci výše uvedené změny jsou teď manifesty nasazení nezávislé.

  Poznámka

  Tato aktualizace představuje zásadní změnu chování z předchozí verze 2022-06-30-preview.

• Podpora nového typu iotEdge byla přidána do entity Device jako typ: string[]. Toto pole umožňuje uživateli identifikovat zařízení jako zařízení s povolenou IoT Edge. Toto pole je volitelný typ a bez něj můžete pokračovat ve vytváření a správě instancí zařízení.

  
  {
  
      "type": ["iotEdge"]
  
  }
  
  

• Podpora nové applyDeploymentManifest trasy do Device. Tato operace umožňuje přidružit manifest nasazení IoT Edge k instanci zařízení.

• Podpora nového volitelného pole readAccess pro FileUpload konfiguraci.

• Podpora pro idScope v rámci EnrollmentGroup entity pro pohodlný přístup

• Aktualizace podpory stránkování s novými parametry, jako jsou maxpagesize, filter, . orderby Dříve podporované parametry, včetně $filter, $top$orderby byly nyní vyřazeny.

• Podpora pro nový deviceManifestMigration typ úlohy Tento nový typ úlohy umožňuje spravovat vozový park hraničních zařízení a nakonfigurovat pro ně zařízení deploymentManifest .

2022-07-31

Naše nejnovější verze GA z 31. července 2022 vylepšuje dříve existující 2022-05-31 verzi a je plně zpětně kompatibilní. K dnešnímu 2022-05-31 dne je tato verze označená jako deprecation a do července 2025 pro ni budeme chtít ukončit podporu. Tady je sada aktualizací zachycených v této verzi:

• Úlohy s podporou stavu průběhu
• Podpora naplánovaných úloh
• Podpora skupin registrace zařízení
• Podpora relací zařízení
• Skupiny zařízení – Seznam podpory zařízení

2022-06-30-preview

Verze Preview rozhraní API roviny dat Azure IoT Central z 30. června 2022 přináší řadu vylepšení stávajících koncových bodů a přidává podporu následujících klíčových funkcí:

• Podpora vytváření a správy Enrollment Groups pro onboarding zařízení
• Schopnost vytvářet a konfigurovat Scheduled Jobs
• Podpora programového vytváření Application Dashboard prostřednictvím rozhraní REST API
• Podpora nemodelovaných vlastností a příkazů pro Device
• Možnost vypsat seznam zařízení v rámci Device Group
• Souhrn průběhu podpory z úlohy
• Odebrané pole názvu z Device Relationship

2022-05-31

Naše nejnovější verze ga z 31. května 2022 zlepšuje dříve existující 1.0 verzi a je plně zpětně kompatibilní. K dnešnímu 1.0 dne je tato verze označená jako deprecation a do května 2025 pro ni budeme chtít ukončit podporu. Tady je sada aktualizací zachycených v této verzi:

• Podpora konfigurace úložiště pro nahrávání souborů
• Podpora CRUD skupiny zařízení
• Podpora CRUD organizace
• Podpora organizace pro zařízení, role, uživatele a tokeny rozhraní API

1.2-Preview (Deprecated)

Tato 1.2-preview verze průběžně vylepšuje koncové body rozhraní API z předchozích verzí Preview a přidává podporu následujících funkcí:

• Podpora CRUD skupiny zařízení
• Nový typ úlohy pro podporu migrace šablon zařízení

1.0

První verze ga rozhraní REST API pro Azure IoT Central, která zachycuje podporu pro následující koncové body: zařízení, seznam rolí, uživatele, šablony zařízení a tokeny rozhraní API. Další informace o jednotlivých koncových bodech najdete tady.

• Uživatelé bez podpory organizace
• Seznam rolí bez podpory organizace
• Podpora CRUD zařízení, vlastností, příkazů, přihlašovacích údajů a ověření identity
• Tokeny rozhraní API bez podpory organizace
• Šablona zařízení bez podpory PATCH

1.1-Preview (Deprecated)

Tato verze umožňuje podporu DTDL v2 v rámci rozhraní REST API pro Azure IoT Central. Zahrnuje zásadní změny ze starší preview verze (nyní zastaralé).

• DTDLv2 si přečtěte další podrobnosti.
• Podpora vztahů zařízení.
• Podpora konfigurace FileUpload.
• Podpora organizace.
• Podpora dotazů na telemetrii zařízení
• Podpora úloh.
• Odebrali jsme starší podporu průběžného exportu dat.
• Přidání podpory exportu a cíle exportu dat v2
• Odebrání rozhraní API/devices/{deviceId}/cloudProperties pomocí rozhraní API/devices/{deviceId}/properties.
• Vlastnosti a telemetrie zařízení v rámci zděděného rozhraní se nebudou považovat za kořenovou vlastnost a kořenovou telemetrii.
• Podpora oprav šablon zařízení
• Podpora manifestu Edge ze šablony zařízení

Preview (Deprecated & Removed)

První verze veřejného rozhraní API služby Azure IoT Central s podporou pouze pro DTDL v1 je nyní zastaralá a odebraná z koncových bodů rozhraní REST API.

Viz také

• Běžné kódy chyb
• Authentication
• Omezování