Sdílet prostřednictvím

Správa profilů verzí rozhraní API ve službě Azure Stack Hub

  • Článek

Profily rozhraní API určují poskytovatele prostředků Azure a verzi rozhraní API pro koncové body Azure REST. Vlastní klienty můžete vytvářet v různých jazycích pomocí profilů rozhraní API. Každý klient používá profil rozhraní API ke kontaktování správného poskytovatele prostředků a verze rozhraní API pro Azure Stack Hub.

Můžete vytvořit aplikaci pro práci s poskytovateli prostředků Azure, aniž byste museli přesně vědět, jakou verzi rozhraní API poskytovatele prostředků je kompatibilní se službou Azure Stack Hub. Stačí zarovnat aplikaci k profilu a sada SDK se vrátí ke správné verzi rozhraní API.

Toto téma vám pomůže:

  • Seznamte se s profily rozhraní API pro Azure Stack Hub.
  • Naučte se používat profily rozhraní API k vývoji řešení.
  • Podívejte se, kde najít pokyny specifické pro kód.

Souhrn profilů rozhraní API

  • Profily rozhraní API se používají k reprezentaci sady poskytovatelů prostředků Azure a jejich verzí rozhraní API.
  • Profily rozhraní API byly vytvořeny, abyste mohli vytvářet šablony napříč několika cloudy Azure. Profily poskytují kompatibilní a stabilní rozhraní.
  • Profily se vydávají čtyřikrát ročně.
  • Používají se tři zásady vytváření názvů profilů:
    • nejnovější
      Obsahuje nejnovější verze rozhraní API vydané v globálním Azure.
    • yyyy-mm-dd-hybrid
      Vydaná bi-ročně, tato verze se zaměřuje na konzistenci a stabilitu napříč několika cloudy. Tento profil cílí na optimální kompatibilitu služby Azure Stack Hub.
    • yyyy-mm-dd-profile
      Vyrovnává optimální stabilitu a nejnovější funkce.

Profily rozhraní Azure API a kompatibilita služby Azure Stack Hub

Nejnovější profily rozhraní Azure API nejsou kompatibilní se službou Azure Stack Hub. Pomocí následujících zásad vytváření názvů identifikujte profily, které se mají použít pro vaše řešení služby Azure Stack Hub:

nejnovější
Tento profil obsahuje nejaktuálnější verze rozhraní API, které se nacházejí v globálním Azure, které ve službě Azure Stack Hub nefungují. Nejnovější obsahuje největší počet zásadních změn. Profil dává stranou stabilitu a kompatibilitu s jinými cloudy. Pokud se pokoušíte používat nejaktuálnější verze rozhraní API, nejnovější je profil, který byste měli použít.

Yyyy-mm-dd-hybrid
Tento profil se vydává každý rok v březnu a září. Má optimální stabilitu a kompatibilitu s různými cloudy a je navržená tak, aby cílila na globální Azure a Azure Stack Hub. Verze rozhraní Azure API uvedené v tomto profilu budou stejné jako verze uvedené ve službě Azure Stack Hub. Tento profil použijte k vývoji kódu pro hybridní cloudová řešení.

yyyy-mm-dd-profile
Tento profil je vydán pro globální Azure v červnu a prosinci. Nefunguje se službou Azure Stack Hub a obvykle dojde k mnoha zásadním změnám. I když vyrovnává optimální stabilitu a nejnovější funkce, rozdíl mezi nejnovějším a tímto profilem spočívá v tom, že nejnovější verze rozhraní API se vždy skládají z nejnovějších verzí rozhraní API bez ohledu na to, kdy je rozhraní API vydáno. Pokud se například zítra vytvoří nová verze rozhraní API pro výpočetní rozhraní API, bude tato verze rozhraní API uvedená v nejnovější verzi, ale ne v profilu yyyy-mm-dd,protože tento profil již existuje. yyyy-mm-dd-profile pokrývá nejaktuálnější verze vydané před červnem nebo před prosincem.

Profily rozhraní API Azure Resource Manageru

Azure Stack Hub nepoužívá nejnovější verzi verzí rozhraní API nalezených v globálním Azure. Při vytváření řešení musíte najít verzi rozhraní API pro každého poskytovatele prostředků Azure, který je kompatibilní se službou Azure Stack Hub.

Místo zkoumání všech poskytovatelů prostředků a konkrétní verze podporované službou Azure Stack Hub můžete použít profil rozhraní API. Profil určuje sadu poskytovatelů prostředků a verzí rozhraní API. Sada SDK nebo nástroj vytvořený pomocí sady SDK se vrátí k cíli api-version zadanému v profilu. Pomocí profilů rozhraní API můžete zadat verzi profilu, která se vztahuje na celou šablonu. Za běhu azure Resource Manager vybere správnou verzi prostředku.

Profily rozhraní API fungují s nástroji, které používají Azure Resource Manager, jako je PowerShell, Azure CLI, kód poskytnutý v sadě SDK a Microsoft Visual Studio. Nástroje a sady SDK můžou používat profily ke čtení verzí modulů a knihoven, které se mají zahrnout při vytváření aplikace.

Pokud například pomocí PowerShellu vytvoříte účet úložiště pomocí poskytovatele prostředků Microsoft.Storage , který podporuje rozhraní API-version 2016-03-30 a virtuální počítač používající poskytovatele prostředků Microsoft.Compute s rozhraním API-version 2015-12-01, musíte vyhledat modul PowerShellu, který podporuje 2016-03-30 pro úložiště, a který modul podporuje 2015-02-01 pro Compute a pak je nainstalovat. Místo toho můžete použít profil. Použijte rutinu Install-Profile <profilename>a PowerShell načte správnou verzi modulů.

Podobně můžete při použití sady Python SDK k sestavení aplikace založené na Pythonu určit profil. Sada SDK načte správné moduly pro poskytovatele prostředků, které jste zadali ve skriptu.

Jako vývojář to znamená, že se můžete soustředit na psaní řešení. Místo toho, abyste prozkoumali, které verze rozhraní API, poskytovatel prostředků a cloud spolupracují, můžete použít profil a vědět, že váš kód funguje ve všech cloudech, které tento profil podporují.

Ukázky kódu profilu rozhraní API

Ukázky kódu, které vám pomůžou integrovat vaše řešení s upřednostňovaným jazykem se službou Azure Stack Hub, najdete pomocí profilů. V současné době najdete pokyny a ukázky pro následující jazyky:

Další kroky