Dela via

Migrera från API:er för förhandsversionen av Azure Digital Twins-kontrollplanet till en stabil GA-version

Från och med den 2 maj 2023 dras följande API:er för Azure Digital Twins-kontrollplanet tillbaka och underhålls inte längre:

Den här artikeln förklarar hur du migrerar från dessa förhandsversioner till den senaste stabila GA-versionen av API:et 2023-01-31. Ga-versionen innehåller fler funktioner, inklusive tidsseriedatabasanslutningar och hanterad identitet.

Migrera från kontrollplans-API:t 2020-03-01-preview

Det här avsnittet innehåller en lista över ändringar som du bör känna till när du förbereder migreringen från API-versionen 2020-03-01-preview till API-versionen2023-01-31 (GA). Ändringarna omfattar ändrade objektnamn eller namngivningskrav, slutpunktskrav och ändringar i instans- och API-svar.

Ändringarna från API-versionen 2020-03-01-preview till API-versionen 2023-01-31 (GA) är följande:

  • För Event Hubs-slutpunkter har värdena connectionString-PrimaryKey och connectionString-SecondaryKey ändrats till connectionStringPrimaryKey respektive connectionStringSecondaryKey (bindestrecken tas bort).
  • Patch API-svaret har ändrats från synkron till asynkron.
    • Eftersom korrigeringsuppdateringarna nu slutförs asynkront returnerar patch-API:et för Azure Digital Twins-resurser nu 202 Accepterade i stället för 200 OK. Användare kan spåra status för uppdateringen med en PUT-begäran.
  • Slutpunktsnamn måste vara minst två tecken långa (tidigare ett tecken i förhandsversions-API:et) och får innehålla högst 49 tecken (tidigare 64)
  • Digital Twins-resursnamn måste vara minst tre tecken långa (tidigare ett) och får innehålla högst 63 tecken (tidigare 64)
  • För Service Bus, Event Hubs och Event Grid-slutpunkter krävs inte längre sekundära hemligheter (t.ex. anslutningssträngar och åtkomstnycklar). Nu är de valfria.
  • Instanser i Azure Digital Twins returnerar inte längre SKU som en egenskap i JSON-brödtextsvaret.
    • I API:t 2020-03-01-preview finns det en DigitalTwinsResource som inte längre finns i API-versionen 2020-10-31 (GA). Därför bör alla referenser till SKU en Azure Digital Twins-instans tas bort.

Om du använder en associerad SDK för API:et 2020-03-01-preview rekommenderar vi att du uppdaterar till den senaste versionen av hanterings-SDK:n. Använd följande länkar för att veta vilka ytterligare ändringar som krävs för att migrera till den nya hanterings-SDK:n.

Migrera från kontrollplans-API:t 2021-06-30-preview

API-versionen för målversion (2023-01-31 (GA) API-versionen) är bakåtkompatibel med API-versionen 2021-06-30-preview. Förutom funktionerna i API-versionen 2021-06-30-preview introducerar API-versionen 2023-01-31 (GA) dessutom användartilldelade hanterade identiteter.

Det finns inga ändringar som bryter funktionalitet vid migrering till den ersättande API-versionen för 2023-01-31 (GA) API-version. Det finns en mindre ändring: Slutpunkter och TSDB-anslutningar har nu ett explicit uppdateringstillstånd som definierats i API-kontraktet.

Om du använder en associerad SDK för API:et 2021-06-30-preview rekommenderar vi att du uppdaterar till den senaste versionen av hanterings-SDK:n. Använd följande länkar för att veta vilka ytterligare ändringar som krävs för att migrera till den nya hanterings-SDK:n.

Nästa steg

Visa det senaste stabila GA-API:et , 2023-01-31, i GitHub.