Revize ve službě Azure API Management

PLATÍ PRO: Všechny úrovně služby správy rozhraní API

Revize umožňují provádět změny rozhraní API řízeným a bezpečným způsobem. Pokud chcete provést změny, vytvořte novou revizi. Pak můžete rozhraní API upravovat a testovat bez narušení uživatelů rozhraní API. Až budete připraveni, proveďte revizi a nastavte ji jako aktuální. Zároveň můžete volitelně publikovat položku do protokolu změn, aby uživatelé rozhraní API měli aktuální informace o změnách, které jste provedli. Protokol změn se publikuje na portálu pro vývojáře.

Poznámka:

Portál pro vývojáře není na úrovni Consumption dostupný.

S revizemi můžete:

• Bezpečně proveďte změny definic a zásad rozhraní API bez narušení produkčního rozhraní API.
• Vyzkoušejte změny před jejich publikováním.
• Zdokumentujte provedené změny, aby vývojáři pochopili, co je nového.
• Pokud zjistíte problémy, vraťte se zpět.

Začněte s revizemi podle našeho názorného postupu.

Přístup ke konkrétním revizím

Ke každé revizi rozhraní API se dostanete pomocí speciálně vytvořené adresy URL. Připojte ;rev={revisionNumber} na konec adresy URL rozhraní API, před řetězec dotazu, abyste získali přístup ke konkrétní revizi tohoto rozhraní API. Tuto adresu URL můžete například použít pro přístup k revizi 3 customers rozhraní API:

https://apis.contoso.com/customers;rev=3/leads?customerId=123

Ve výchozím nastavení má každá revize stejná nastavení zabezpečení jako aktuální revize. Pokud chcete, aby se pro každou revizi použilo jiné zabezpečení, můžete zásady pro určitou revizi záměrně změnit. Můžete například chtít přidat zásadu filtrování IP adres, která externím volajícím zabrání v přístupu k revizi, která je stále ve vývoji.

Poznámka:

;rev={id} musí být připojen k ID rozhraní API, nikoliv k cestě URI.

Aktuální revize

Jednu revizi lze nastavit jako aktuální revizi. Tato revize je ta, která se používá pro všechny požadavky rozhraní API, které v adrese URL nezadávají explicitní číslo revize. Předchozí revizi můžete vrátit tak, že tuto revizi nastavíte jako aktuální.

Revizi můžete nastavit jako aktuální pomocí webu Azure Portal. Pokud používáte PowerShell, můžete použít tuto rutinu New-AzApiManagementApiRelease .

Popisy revizí

Při vytváření revize můžete nastavit popis pro vlastní účely sledování. Popisy se uživatelům rozhraní API nezobrazují.

Pokud nastavíte revizi jako aktuální, můžete také volitelně zadat poznámku k veřejnému protokolu změn. Protokol změn je součástí vývojářského portálu, kde můžou uživatelé rozhraní API zobrazit. Poznámku protokolu změn můžete upravit pomocí rutiny PowerShellu Update-AzApiManagementApiRelease .

Upozornění

Pokud upravujete neaktuální revizi rozhraní API, nemůžete změnit následující vlastnosti:

• Název
• Typ
• Popis
• Požadováno předplatné
• Verze rozhraní API
• Popis verze rozhraní API
• Cesta
• Protokoly

Tyto vlastnosti lze změnit pouze v aktuální revizi. Pokud vaše úpravy změní některou z těchto vlastností v neaktuální revizi, zobrazí se chybová zpráva Can't change property for non-current revision .

Převést revizi do offline režimu

Revizi je možné převést do offline režimu, což volajícím znepřístupňuje, i když se pokusí získat přístup k revizi prostřednictvím adresy URL. Revizi můžete označit jako offline pomocí webu Azure Portal.

Poznámka:

Doporučujeme převést revize do offline režimu, když je nepoužíváte k testování.

Verze a revize

Verze a revize představují odlišné funkce. Každá verze může mít více revizí, stejně jako neverzní rozhraní API. Revize můžete používat bez použití verzí nebo naopak. Verze se obvykle používají k oddělení verzí rozhraní API se zásadními změnami, zatímco revize se dají použít pro menší a nezasahující do funkčnosti změny rozhraní API.

Pokud má revize zásadní změny nebo pokud chcete formálně změnit revizi na beta/testovací verzi, můžete vytvořit verzi z revize. Na portálu Azure vyberte v kontextové nabídce na kartě Revize možnost "Vytvořit verzi z revize".