Distribuera en Azure Gestione API-instans till flera Azure-regioner

Azure Gestione API stöder distribution i flera regioner, vilket gör det möjligt för API-utgivare att lägga till regionala API-gatewayer till en befintlig Gestione API instans i en eller flera Azure-regioner som stöds. Distribution i flera regioner bidrar till att minska svarstiden för begäranden som uppfattas av geografiskt distribuerade API-konsumenter och förbättrar tjänstens tillgänglighet om en region kopplas från.

När du lägger till en region konfigurerar du:

Viktigt

Funktionen för att aktivera lagring av kunddata i en enda region är för närvarande endast tillgänglig i Regionen Sydostasien (Singapore) i Asia Pacific Geo. För alla andra regioner lagras kunddata i Geo.

Tillgänglighet

Viktigt

Den här funktionen är endast tillgänglig på Premium-nivån för Gestione API.

Om distribution i flera regioner

  • Med distribution i flera regioner replikeras endast gatewaykomponenten i din Gestione API-instans till flera regioner. Instansens hanteringsplan och utvecklarportal finns endast i den primära regionen, den region där du ursprungligen distribuerade tjänsten.

  • Gatewaykonfigurationer som API:er och principdefinitioner synkroniseras regelbundet mellan de primära och sekundära regioner som du lägger till. Distribution i flera regioner ger tillgänglighet för API-gatewayen i mer än en region och ger tjänsttillgänglighet om en region kopplas från.

  • När Gestione API tar emot offentliga HTTP-begäranden till den primära gatewayslutpunkten dirigeras trafiken till en regional gateway baserat på lägsta svarstid, vilket kan minska svarstiden för geografiskt distribuerade API-konsumenter.

  • Om en region kopplas från dirigeras API-begäranden automatiskt runt den misslyckade regionen till nästa närmaste gateway.

  • Om den primära regionen går offline blir det Gestione API hanteringsplanet och utvecklarportalen otillgängliga, men sekundära regioner fortsätter att hantera API-begäranden med den senaste gatewaykonfigurationen.

Krav

  • Om du inte har skapat en Gestione API tjänstinstans läser du Skapa en Gestione API tjänstinstans. Välj Premium-tjänstnivån.
  • Om din Gestione API-instans distribueras i ett virtuellt nätverk kontrollerar du att du konfigurerar ett virtuellt nätverk, undernät och en offentlig IP-adress på den plats som du planerar att lägga till. Se krav för virtuellt nätverk.

Distribuera Gestione API-tjänsten till ytterligare en region

  1. I Azure-Portal navigerar du till din Gestione API-tjänst och väljer Platser på den vänstra menyn.
  2. Välj + Lägg till i det övre fältet.
  3. Välj den tillagda platsen i listrutan.
  4. Välj antalet skalningsenheter på platsen.
  5. Du kan också välja en eller flera tillgänglighetszoner.
  6. Om Gestione API-instansen distribueras i ett virtuellt nätverk konfigurerar du inställningar för virtuella nätverk på platsen. Välj ett befintligt virtuellt nätverk, undernät och en offentlig IP-adress som är tillgänglig på platsen.
  7. Välj Lägg till för att bekräfta.
  8. Upprepa den här processen tills du konfigurerar alla platser.
  9. Välj Spara i det övre fältet för att starta distributionsprocessen.

Ta bort en Gestione API tjänstregion

  1. I Azure-Portal navigerar du till din Gestione API-tjänst och väljer Platser på den vänstra menyn.
  2. För den plats som du vill ta bort väljer du snabbmenyn med knappen ... till höger i tabellen. Välj Ta bort.
  3. Bekräfta borttagningen och välj Spara för att tillämpa ändringarna.

Dirigera API-anrop till regionala serverdelstjänster

Som standard dirigerar varje API begäranden till en enda serverdelstjänst-URL. Även om du har konfigurerat Azure Gestione API-gatewayer i olika regioner vidarebefordrar API-gatewayen fortfarande begäranden till samma serverdelstjänst, som endast distribueras i en region. I det här fallet kommer prestandavinsten endast från svar som cachelagrats i Azure Gestione API i en region som är specifik för begäran. Att kontakta serverdelen över hela världen kan fortfarande orsaka långa svarstider.

Om du vill dra nytta av den geografiska distributionen av systemet bör du ha serverdelstjänster distribuerade i samma regioner som Azure Gestione API instanser. Med hjälp av principer och @(context.Deployment.Region) egenskaper kan du sedan dirigera trafiken till lokala instanser av serverdelen.

Tips

Du kan också ange disableGateway egenskapen i en regional gateway för att inaktivera routning av API-trafik där. Inaktivera till exempel tillfälligt en regional gateway vid testning eller uppdatering av en regional serverdelstjänst.

  1. Gå till din Azure Gestione API-instans och välj API:er på den vänstra menyn.

  2. Välj önskat API.

  3. Välj Kodredigeraren i listrutan pil i inkommande bearbetning.

    API-kodredigeraren

  4. Använd kombinerat set-backend med villkorsprinciper choose för att skapa en korrekt routningsprincip i <inbound> </inbound> avsnittet i filen.

    Följande XML-fil fungerar till exempel för regionerna USA, västra och Asien, östra:

    <policies>
        <inbound>
            <base />
            <choose>
                <when condition="@("West US".Equals(context.Deployment.Region, StringComparison.OrdinalIgnoreCase))">
                    <set-backend-service base-url="http://contoso-backend-us.com/" />
                </when>
                <when condition="@("East Asia".Equals(context.Deployment.Region, StringComparison.OrdinalIgnoreCase))">
                    <set-backend-service base-url="http://contoso-backend-asia.com/" />
                </when>
                <otherwise>
                    <set-backend-service base-url="http://contoso-backend-other.com/" />
                </otherwise>
            </choose>
        </inbound>
        <backend>
            <base />
        </backend>
        <outbound>
            <base />
        </outbound>
        <on-error>
            <base />
        </on-error>
    </policies>
    

Tips

Du kan också fronta dina serverdelstjänster med Azure Traffic Manager, dirigera API-anropen till Traffic Manager och låta det lösa routningen automatiskt.

Använda anpassad routning för att Gestione API regionala gatewayer

Gestione API dirigerar begäranden till en regional gateway baserat på den lägsta svarstiden. Även om det inte går att åsidosätta den här inställningen i Gestione API kan du använda din egen Traffic Manager med anpassade routningsregler.

  1. Skapa din egen Azure Traffic Manager.
  2. Om du använder en anpassad domän använder du den med Traffic Manager i stället för Gestione API-tjänsten.
  3. Konfigurera de Gestione API regionala slutpunkterna i Traffic Manager. De regionala slutpunkterna följer URL-mönstret https://<service-name>-<region>-01.regional.azure-api.netför , till exempel https://contoso-westus2-01.regional.azure-api.net.
  4. Konfigurera Gestione API regionala statusslutpunkter i Traffic Manager. De regionala statusslutpunkterna följer URL-mönstret https://<service-name>-<region>-01.regional.azure-api.net/status-0123456789abcdefför , till exempel https://contoso-westus2-01.regional.azure-api.net/status-0123456789abcdef.
  5. Ange routningsmetoden för Traffic Manager.

Virtuellt nätverk

Det här avsnittet innehåller överväganden för distributioner i flera regioner när den Gestione API instansen matas in i ett virtuellt nätverk.

  • Konfigurera varje regionalt nätverk oberoende av varandra. Anslutningskrav som obligatoriska regler för nätverkssäkerhetsgrupper för ett virtuellt nätverk i en tillagd region är desamma som för ett nätverk i den primära regionen.
  • Virtuella nätverk i de olika regionerna behöver inte peer-kopplas.

IP-adresser

  • En offentlig virtuell IP-adress skapas i varje region som läggs till med ett virtuellt nätverk. För virtuella nätverk i antingen externt läge eller internt läge krävs den här offentliga IP-adressen för hantering av trafik på porten 3443.

    • Externt VNet-läge – De offentliga IP-adresserna krävs också för att dirigera offentlig HTTP-trafik till API-gatewayerna.

    • Internt VNet-läge – En privat IP-adress skapas också i varje region som läggs till med ett virtuellt nätverk. Använd dessa adresser för att ansluta i nätverket till Gestione API slutpunkter i de primära och sekundära regionerna.

Routning

  • Externt VNet-läge – Routning av offentlig HTTP-trafik till de regionala gatewayerna hanteras automatiskt, på samma sätt som för en icke-nätverksansluten Gestione API instans.

  • Internt VNet-läge – Privat HTTP-trafik dirigeras inte eller belastningsutjämnas inte till de regionala gatewayerna som standard. Användarna äger routningen och ansvarar för att ta med sin egen lösning för att hantera routning och privat belastningsutjämning i flera regioner. Exempellösningar är Azure Application Gateway och Azure Traffic Manager.

Nästa steg