Udostępnij za pośrednictwem


Szybki start: wdrażanie aplikacji interfejsu API RESTful w usłudze Azure Spring Apps

Uwaga

Plany Podstawowa, Standardowa i Enterprise zostaną wycofane od połowy marca 2025 r. z 3-letnim okresem emerytalnym. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Zużycie standardowe i dedykowany plan zostaną wycofane od 30 września 2024 r. z całkowitym zamknięciem po sześciu miesiącach. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz Migrowanie użycia usługi Azure Spring Apps w warstwie Standardowa i dedykowanego planu do usługi Azure Container Apps.

W tym artykule opisano sposób wdrażania aplikacji interfejsu API RESTful chronionej przez identyfikator Entra firmy Microsoft w usłudze Azure Spring Apps. Przykładowy projekt jest uproszczoną wersją opartą na aplikacji internetowej Simple Todo , która udostępnia tylko usługę zaplecza i używa identyfikatora Entra firmy Microsoft do ochrony interfejsów API RESTful.

Te interfejsy API RESTful są chronione przez zastosowanie kontroli dostępu opartej na rolach (RBAC). Użytkownicy anonimowi nie mogą uzyskiwać dostępu do żadnych danych i nie mogą kontrolować dostępu dla różnych użytkowników. Użytkownicy anonimowi mają tylko następujące trzy uprawnienia:

  • Przeczytaj: Z tym uprawnieniem użytkownik może odczytywać dane zadań do wykonania.
  • Napisz: za pomocą tego uprawnienia użytkownik może dodawać lub aktualizować dane zadań do wykonania.
  • Usuń: za pomocą tego uprawnienia użytkownik może usunąć dane zadań do wykonania.

Po pomyślnym wdrożeniu można wyświetlić i przetestować interfejsy API za pomocą interfejsu użytkownika struktury Swagger.

Zrzut ekranu przedstawiający interfejs użytkownika programu Swagger przedstawiający dokument interfejsu API.

Na poniższym diagramie przedstawiono architekturę systemu:

Diagram przedstawiający architekturę aplikacji internetowej Spring.

W tym artykule opisano następujące opcje tworzenia zasobów i wdrażania ich w usłudze Azure Spring Apps:

  • Opcja wtyczki Azure Portal + Maven zapewnia bardziej konwencjonalny sposób tworzenia zasobów i wdrażania aplikacji krok po kroku. Ta opcja jest odpowiednia dla deweloperów platformy Spring korzystających z usług w chmurze platformy Azure po raz pierwszy.
  • Opcja interfejsu wiersza polecenia dla deweloperów platformy Azure to bardziej wydajny sposób automatycznego tworzenia zasobów i wdrażania aplikacji za pomocą prostych poleceń. Interfejs wiersza polecenia dewelopera platformy Azure używa szablonu do aprowizowania potrzebnych zasobów platformy Azure i wdrażania kodu aplikacji. Ta opcja jest odpowiednia dla deweloperów platformy Spring, którzy znają usługi w chmurze platformy Azure.

W tym artykule opisano następujące opcje tworzenia zasobów i wdrażania ich w usłudze Azure Spring Apps:

  • Opcja wtyczki Azure Portal + Maven zapewnia bardziej konwencjonalny sposób tworzenia zasobów i wdrażania aplikacji krok po kroku. Ta opcja jest odpowiednia dla deweloperów platformy Spring korzystających z usług w chmurze platformy Azure po raz pierwszy.
  • Opcja interfejsu wiersza polecenia platformy Azure używa zaawansowanego narzędzia wiersza polecenia do zarządzania zasobami platformy Azure. Ta opcja jest odpowiednia dla deweloperów platformy Spring, którzy znają usługi w chmurze platformy Azure.

1. Wymagania wstępne

2. Przygotowanie projektu Spring

Aby wdrożyć aplikację interfejsu API RESTful, pierwszym krokiem jest przygotowanie projektu Spring do uruchomienia lokalnie.

Aby sklonować i uruchomić aplikację lokalnie, wykonaj następujące kroki:

  1. Użyj następującego polecenia, aby sklonować przykładowy projekt z usługi GitHub:

    git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
    
  2. Jeśli chcesz uruchomić aplikację lokalnie, najpierw wykonaj kroki opisane w sekcjach Uwidaczniaj interfejsy API RESTful i Zaktualizuj konfigurację aplikacji, a następnie uruchom przykładową aplikację za pomocą narzędzia Maven za pomocą następującego polecenia:

    cd ASA-Samples-Restful-Application
    ./mvnw spring-boot:run
    

3. Przygotowanie środowiska chmury

Główne zasoby wymagane do uruchomienia tej przykładowej aplikacji to wystąpienie usługi Azure Spring Apps i wystąpienie usługi Azure Database for PostgreSQL. W poniższych sekcjach opisano sposób tworzenia tych zasobów.

3.1. Zaloguj się do witryny Azure Portal.

Przejdź do witryny Azure Portal i wprowadź swoje poświadczenia, aby zalogować się do portalu. Widok domyślny to pulpit nawigacyjny usług.

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

Aby utworzyć wystąpienie usługi Azure Spring Apps, wykonaj następujące kroki:

  1. Wybierz pozycję Utwórz zasób w rogu witryny Azure Portal.

  2. Wybierz pozycję Compute>Azure Spring Apps.

  3. Wypełnij formularz Podstawowe, korzystając z następujących informacji:

    Ustawienie Sugerowana wartość opis
    Subskrypcja Nazwa subskrypcji. Subskrypcja platformy Azure, która ma być używana dla serwera. Jeśli masz wiele subskrypcji, wybierz subskrypcję, w której chcesz naliczać opłaty za zasób.
    Grupa zasobów: myresourcegroup Nowa nazwa grupy zasobów lub istniejąca nazwa z subskrypcji.
    Nazwa/nazwisko myasa Unikatowa nazwa identyfikująca usługę Azure Spring Apps. Nazwa musi mieć długość od 4 do 32 znaków i może zawierać tylko małe litery, cyfry i łączniki. Pierwszy znak nazwy usługi musi być literą, a ostatni znak musi być literą lub cyfrą.
    Planowanie Przedsiębiorstwo Plan cenowy określający zasób i koszt skojarzony z wystąpieniem.
    Region Region najbliżej Twoich użytkowników. Lokalizacja znajdująca się najbliżej użytkowników.
    Strefowo nadmiarowy Niezaznaczone Opcja tworzenia usługi Azure Spring Apps w strefie dostępności platformy Azure. Ta funkcja nie jest obecnie obsługiwana we wszystkich regionach.
    Plan adresów IP oprogramowania Płatność zgodnie z rzeczywistym użyciem Plan cenowy, który umożliwia płacenie zgodnie z rzeczywistym użyciem za pomocą usługi Azure Spring Apps.
    Warunki Wybrano Pole wyboru umowy skojarzone z ofertą witryny Marketplace. Musisz zaznaczyć to pole wyboru.
    Wdrażanie przykładowego projektu Niezaznaczone Opcja użycia wbudowanej przykładowej aplikacji.
  4. Wybierz pozycję Przejrzyj i Utwórz , aby przejrzeć wybrane opcje. Następnie wybierz pozycję Utwórz , aby aprowizować wystąpienie usługi Azure Spring Apps.

  5. Na pasku narzędzi wybierz ikonę Powiadomienia (dzwonek), aby monitorować proces wdrażania. Po zakończeniu wdrażania możesz wybrać pozycję Przypnij do pulpitu nawigacyjnego, co spowoduje utworzenie kafelka dla tej usługi na pulpicie nawigacyjnym witryny Azure Portal jako skrótu do strony Przegląd usługi.

    Zrzut ekranu witryny Azure Portal przedstawiający okienko Powiadomienia dotyczące tworzenia usługi Azure Spring Apps.

  6. Wybierz pozycję Przejdź do zasobu , aby przejść do strony Przegląd usługi Azure Spring Apps.

3.3. Przygotowywanie wystąpienia bazy danych PostgreSQL

Aby utworzyć serwer usługi Azure Database for PostgreSQL, wykonaj następujące czynności:

  1. Przejdź do witryny Azure Portal i wybierz pozycję Utwórz zasób.

  2. Wybierz pozycję Bazy danych>Azure Database for PostgreSQL.

  3. Wybierz opcję Wdrożenie serwera elastycznego.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę wybierz opcję wdrażania usługi Azure Database for PostgreSQL.

  4. Wypełnij kartę Podstawy następującymi informacjami:

    • Nazwa serwera: my-demo-pgsql
    • Region: Wschodnie stany USA
    • Wersja bazy danych PostgreSQL: 14
    • Typ obciążenia: Programowanie
    • Włącz wysoką dostępność: niezaznaczone
    • Metoda uwierzytelniania: tylko uwierzytelnianie postgreSQL
    • Nazwa użytkownika administratora: myadmin
    • Hasło i potwierdź hasło: wprowadź hasło.
  5. Użyj poniższych informacji, aby skonfigurować kartę Sieć :

    • Metoda łączności: dostęp publiczny (dozwolone adresy IP)
    • Zezwalaj na dostęp publiczny z dowolnej usługi platformy Azure na platformie Azure do tego serwera: wybrane
  6. Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć wybrane opcje, a następnie wybierz pozycję Utwórz , aby aprowizować serwer. Ta operacja może potrwać kilka minut.

  7. Przejdź do serwera PostgreSQL w witrynie Azure Portal. Na stronie Przegląd wyszukaj wartość Nazwa serwera, a następnie zapisz ją do późniejszego użycia. Potrzebne jest skonfigurowanie zmiennych środowiskowych dla aplikacji w usłudze Azure Spring Apps.

  8. Wybierz pozycję Bazy danych z menu nawigacji, aby utworzyć bazę danych — na przykład todo.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę Bazy danych z otwartym okienkiem Tworzenie bazy danych.

3.4. Łączenie wystąpienia aplikacji z wystąpieniem bazy danych PostgreSQL

Aby połączyć wystąpienia usługi, wykonaj następujące czynności:

  1. Przejdź do wystąpienia usługi Azure Spring Apps w witrynie Azure Portal.

  2. W menu nawigacji otwórz pozycję Aplikacje, a następnie wybierz pozycję Utwórz aplikację.

  3. Na stronie Tworzenie aplikacji wypełnij nazwę aplikacji simple-todo-api, a następnie wybierz pozycję Artefakty Java jako typ wdrożenia.

  4. Wybierz pozycję Utwórz , aby zakończyć tworzenie aplikacji, a następnie wybierz aplikację, aby wyświetlić szczegóły.

  5. Przejdź do aplikacji utworzonej w witrynie Azure Portal. Na stronie Przegląd wybierz pozycję Przypisz punkt końcowy, aby uwidocznić publiczny punkt końcowy dla aplikacji. Zapisz adres URL na potrzeby uzyskiwania dostępu do aplikacji po wdrożeniu.

  6. Wybierz pozycję Łącznik usługi w okienku nawigacji, a następnie wybierz pozycję Utwórz , aby utworzyć nowe połączenie z usługą.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę łącznika usługi planu przedsiębiorstwa z wyróżnionym przyciskiem Utwórz.

  7. Wypełnij kartę Podstawy następującymi informacjami:

    • Typ usługi: serwer elastyczny DB for PostgreSQL
    • Nazwa połączenia: jest wypełniana automatycznie wygenerowana nazwa, którą można również zmodyfikować.
    • Subskrypcja: wybierz swoją subskrypcję.
    • Serwer elastyczny PostgreSQL: my-demo-pgsql
    • Baza danych PostgreSQL: wybierz utworzoną bazę danych.
    • Typ klienta: SpringBoot

    Zrzut ekranu witryny Azure Portal przedstawiający kartę Podstawowe w okienku Utworzone połączenie na potrzeby nawiązywania połączenia z usługą Service Bus.

  8. Skonfiguruj kartę Dalej: Uwierzytelnianie przy użyciu następujących informacji:

    • Wybierz typ uwierzytelniania, którego chcesz użyć między usługą obliczeniową a usługą docelową.: Wybierz pozycję Parametry połączenia.
    • Kontynuuj z...: wybierz pozycję Poświadczenia bazy danych
    • Nazwa użytkownika: myadmin
    • Hasło: wprowadź hasło.

    Zrzut ekranu witryny Azure Portal przedstawiający kartę Uwierzytelnianie okienka Tworzenie połączenia z wyróżnioną opcją Parametry połączenia.

  9. Wybierz pozycję Dalej: Sieć. Użyj opcji domyślnej Skonfiguruj reguły zapory, aby włączyć dostęp do usługi docelowej.

  10. Wybierz pozycję Dalej: Przejrzyj i utwórz , aby przejrzeć wybrane opcje, a następnie wybierz pozycję Utwórz , aby utworzyć połączenie.

3.5. Uwidacznianie interfejsów API RESTful

Wykonaj następujące kroki, aby uwidocznić interfejsy API RESTful w identyfikatorze Entra firmy Microsoft:

  1. Zaloguj się w witrynie Azure Portal.

  2. Jeśli masz dostęp do wielu dzierżaw, użyj filtru Katalog i subskrypcja ( ), aby wybrać dzierżawę, w której chcesz zarejestrować aplikację.

  3. Wyszukaj i wybierz Tożsamość Microsoft Entra.

  4. W obszarze Zarządzanie wybierz pozycję Rejestracje aplikacji> Nowa rejestracja.

  5. Wprowadź nazwę aplikacji w polu Nazwa — na przykład Todo. Użytkownicy aplikacji mogą zobaczyć tę nazwę i możesz ją zmienić później.

  6. W obszarze Obsługiwane typy kont wybierz pozycję Konta w dowolnym katalogu organizacyjnym (dowolny katalog Microsoft Entra — Multitenant) i osobiste konta Microsoft.

  7. Wybierz pozycję Zarejestruj, aby utworzyć aplikację.

  8. Na stronie Przegląd aplikacji wyszukaj wartość Identyfikator aplikacji (klienta), a następnie zapisz ją do późniejszego użycia. Potrzebny jest go do skonfigurowania pliku konfiguracji YAML dla tego projektu.

  9. W obszarze Zarządzanie wybierz pozycję Uwidaczniaj interfejs API, znajdź identyfikator URI identyfikatora aplikacji na początku strony, a następnie wybierz pozycję Dodaj.

  10. Na stronie Edytowanie identyfikatora URI identyfikatora aplikacji zaakceptuj proponowany identyfikator URI identyfikatora aplikacji (api://{client ID}) lub użyj znaczącej nazwy zamiast identyfikatora klienta, takiego jak api://simple-todo, a następnie wybierz pozycję Zapisz.

  11. W obszarze Zarządzanie wybierz pozycję Uwidacznianie interfejsu API>Dodaj zakres, a następnie wprowadź następujące informacje:

    • W polu Nazwa zakresu wprowadź ciąg ToDo.Read.
    • W obszarze Kto może wyrazić zgodę, wybierz pozycję Tylko administratorzy.
    • W polu Nazwa wyświetlana zgody administratora wprowadź ciąg Odczyt danych zadań do wykonania.
    • W polu Opis zgody administratora wprowadź Zezwalaj uwierzytelnieni użytkownikom na odczytywanie danych zadań do wykonania.
    • W obszarze Stan zachowaj włączoną wartość .
    • Wybierz Dodaj zakres.
  12. Powtórz poprzednie kroki, aby dodać dwa pozostałe zakresy: ToDo.Write i ToDo.Delete.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę uwidaczniającą interfejs API RESTful.

3.6. Aktualizowanie konfiguracji aplikacji

Wykonaj następujące kroki, aby zaktualizować plik YAML, aby użyć informacji o zarejestrowanej aplikacji firmy Microsoft w celu ustanowienia relacji z aplikacją interfejsu API RESTful:

  1. Znajdź plik src/main/resources/application.yml dla simple-todo-api aplikacji. Zaktualizuj konfigurację w spring.cloud.azure.active-directory sekcji, aby odpowiadała poniższemu przykładowi. Pamiętaj, aby zastąpić symbole zastępcze utworzonymi wcześniej wartościami.

    spring:
      cloud:
        azure:
          active-directory:
            profile:
              tenant-id: <tenant>
            credential:
              client-id: <your-application-ID-of-ToDo>
            app-id-uri: <your-application-ID-URI-of-ToDo>
    

    Uwaga

    W tokenach w wersji 1.0 konfiguracja wymaga identyfikatora klienta interfejsu API, natomiast w tokenach w wersji 2.0 można użyć identyfikatora klienta lub identyfikatora URI aplikacji w żądaniu. Oba te elementy można skonfigurować tak, aby prawidłowo ukończyć walidację odbiorców.

    Dozwolone tenant-id wartości to: common, organizations, consumerslub identyfikator dzierżawy. Aby uzyskać więcej informacji na temat tych wartości, zobacz sekcję Użycie nieprawidłowego punktu końcowego (konta osobiste i konta organizacji) w sekcji Błąd AADSTS50020 — konto użytkownika od dostawcy tożsamości nie istnieje w dzierżawie. Aby uzyskać informacje na temat konwertowania aplikacji z jedną dzierżawą, zobacz Konwertowanie aplikacji z jedną dzierżawą na wielodostępny w usłudze Microsoft Entra ID.

  2. Użyj następującego polecenia, aby ponownie skompilować przykładowy projekt:

    ./mvnw clean package
    

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

Teraz możesz wdrożyć aplikację w usłudze Azure Spring Apps.

Wykonaj następujące kroki, aby wdrożyć przy użyciu wtyczki Maven dla usługi Azure Spring Apps:

  1. Przejdź do kompletnego katalogu, a następnie uruchom następujące polecenie, aby skonfigurować aplikację w usłudze Azure Spring Apps:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
    

    Poniższa lista zawiera opis interakcji poleceń:

    • Logowanie OAuth2: musisz autoryzować logowanie do platformy Azure na podstawie protokołu OAuth2.
    • Wybierz subskrypcję: wybierz numer listy subskrypcji utworzonego wystąpienia usługi Azure Spring Apps, które jest domyślnie ustawione na pierwszą subskrypcję na liście. Jeśli używasz numeru domyślnego, naciśnij Enter bezpośrednio.
    • Użyj istniejących aplikacji Azure Spring Apps na platformie Azure: naciśnij y , aby użyć istniejącego wystąpienia usługi Azure Spring Apps.
    • Wybierz pozycję Azure Spring Apps do wdrożenia: wybierz liczbę utworzonego wystąpienia usługi Azure Spring Apps. Jeśli używasz numeru domyślnego, naciśnij Enter bezpośrednio.
    • Użyj istniejącej aplikacji w usłudze Azure Spring Apps <nazwa-wystąpienia>: naciśnij y , aby użyć utworzonej aplikacji.
    • Potwierdź, aby zapisać wszystkie powyższe konfiguracje: naciśnij y. Jeśli naciśniesz n, konfiguracja nie zostanie zapisana w plikach POM.
  2. Aby wdrożyć aplikację, użyj następującego polecenia:

    ./mvnw azure-spring-apps:deploy
    

    Na poniższej liście opisano interakcję z poleceniem:

    • Logowanie OAuth2: musisz autoryzować logowanie do platformy Azure na podstawie protokołu OAuth2.

    Po wykonaniu polecenia można zobaczyć następujące komunikaty dziennika, że wdrożenie zakończyło się pomyślnie:

[INFO] Deployment Status: Running
[INFO]   InstanceName:simple-todo-api-default-15-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A       
[INFO] Getting public url of app(simple-todo-api)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-api.azuremicroservices.io

5. Weryfikowanie aplikacji

Teraz możesz uzyskać dostęp do interfejsu API RESTful, aby sprawdzić, czy działa.

5.1. Poproś o token dostępu

Interfejsy API RESTful działają jako serwer zasobów, który jest chroniony przez identyfikator Entra firmy Microsoft. Przed uzyskaniem tokenu dostępu należy zarejestrować inną aplikację w usłudze Microsoft Entra ID i udzielić uprawnień aplikacji klienckiej o nazwie ToDoWeb.

Rejestrowanie aplikacji klienckiej

Wykonaj następujące kroki, aby zarejestrować aplikację w usłudze Microsoft Entra ID, która służy do dodawania ToDo uprawnień dla aplikacji:

  1. Zaloguj się w witrynie Azure Portal.

  2. Jeśli masz dostęp do wielu dzierżaw, użyj filtru Katalog i subskrypcja ( ), aby wybrać dzierżawę, w której chcesz zarejestrować aplikację.

  3. Wyszukaj i wybierz Tożsamość Microsoft Entra.

  4. W obszarze Zarządzanie wybierz pozycję Rejestracje aplikacji> Nowa rejestracja.

  5. Wprowadź nazwę aplikacji w polu Nazwa — na przykład ToDoWeb. Użytkownicy aplikacji mogą zobaczyć tę nazwę i możesz ją zmienić później.

  6. W przypadku obsługiwanych typów kont użyj wartości domyślnej Konta tylko w tym katalogu organizacyjnym.

  7. Wybierz pozycję Zarejestruj, aby utworzyć aplikację.

  8. Na stronie Przegląd aplikacji wyszukaj wartość Identyfikator aplikacji (klienta), a następnie zapisz ją do późniejszego użycia. Potrzebujesz go, aby uzyskać token dostępu.

  9. Wybierz pozycję Uprawnienia>interfejsu API Dodaj uprawnienie>Moje interfejsy API. Wybierz zarejestrowaną wcześniej aplikację ToDo , a następnie wybierz uprawnienia ToDo.Read, ToDo.Write i ToDo.Delete . Wybierz Przyznaj uprawnienia.

  10. Wybierz pozycję Udziel zgody administratora dla <nazwy> dzierżawy, aby udzielić zgody administratora dla dodanych uprawnień.

    Zrzut ekranu witryny Azure Portal przedstawiający uprawnienia interfejsu API aplikacji internetowej.

Dodawanie użytkownika w celu uzyskania dostępu do interfejsów API RESTful

Wykonaj poniższe kroki, aby utworzyć użytkownika członkowskiego w dzierżawie firmy Microsoft Entra. Następnie użytkownik może zarządzać danymi ToDo aplikacji za pomocą interfejsów API RESTful.

  1. W obszarze Zarządzanie wybierz pozycję Użytkownicy>Nowy użytkownik>Utwórz nowego użytkownika.

  2. Na stronie Tworzenie nowego użytkownika wprowadź następujące informacje:

    • Główna nazwa użytkownika: wprowadź nazwę użytkownika.
    • Nazwa wyświetlana: wprowadź nazwę wyświetlaną użytkownika.
    • Hasło: skopiuj automatycznie wygenerowane hasło podane w polu Hasło.

    Uwaga

    Nowi użytkownicy muszą ukończyć pierwsze uwierzytelnianie logowania i zaktualizować swoje hasła. W przeciwnym razie podczas uzyskiwania tokenu dostępu zostanie wyświetlony AADSTS50055: The password is expired błąd.

    Gdy nowy użytkownik zaloguje się, otrzyma monit o akcję wymaganą. Mogą wybrać pozycję Zapytaj później , aby pominąć walidację.

  3. Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć wybrane opcje. Wybierz pozycję Utwórz , aby utworzyć użytkownika.

Aktualizowanie konfiguracji protokołu OAuth2 na potrzeby autoryzacji interfejsu użytkownika programu Swagger

Wykonaj poniższe kroki, aby zaktualizować konfigurację protokołu OAuth2 dla autoryzacji interfejsu użytkownika struktury Swagger. Następnie możesz autoryzować użytkowników do uzyskiwania tokenów dostępu za pośrednictwem ToDoWeb aplikacji.

  1. Otwórz dzierżawę identyfikatora entra firmy Microsoft w witrynie Azure Portal i przejdź do zarejestrowanej ToDoWeb aplikacji.

  2. W obszarze Zarządzanie wybierz pozycję Uwierzytelnianie, wybierz pozycję Dodaj platformę, a następnie wybierz pozycję Aplikacja jednostronicowa.

  3. Użyj formatu <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html jako adresu URL przekierowania OAuth2 w polu Identyfikatory URI przekierowania, a następnie wybierz pozycję Konfiguruj.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę Uwierzytelnianie dla identyfikatora entra firmy Microsoft.

2. Przygotowanie projektu Spring

Aby wdrożyć aplikację interfejsu API RESTful, pierwszym krokiem jest przygotowanie projektu Spring do uruchomienia lokalnie.

Aby sklonować i uruchomić aplikację lokalnie, wykonaj następujące kroki:

  1. Użyj następującego polecenia, aby sklonować przykładowy projekt z usługi GitHub:

    git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
    
  2. Jeśli chcesz uruchomić aplikację lokalnie, najpierw wykonaj kroki opisane w sekcjach Uwidaczniaj interfejsy API RESTful i Zaktualizuj konfigurację aplikacji, a następnie uruchom przykładową aplikację za pomocą narzędzia Maven za pomocą następującego polecenia:

    cd ASA-Samples-Restful-Application
    ./mvnw spring-boot:run
    

3. Przygotowanie środowiska chmury

Główne zasoby wymagane do uruchomienia tej przykładowej aplikacji to wystąpienie usługi Azure Spring Apps i wystąpienie usługi Azure Database for PostgreSQL. W poniższych sekcjach opisano sposób tworzenia tych zasobów.

3.1. Zaloguj się do witryny Azure Portal.

Przejdź do witryny Azure Portal i wprowadź swoje poświadczenia, aby zalogować się do portalu. Widok domyślny to pulpit nawigacyjny usług.

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

Aby utworzyć wystąpienie usługi, wykonaj następujące czynności:

  1. Wybierz pozycję Utwórz zasób w rogu portalu.

  2. Wybierz pozycję Compute>Azure Spring Apps.

  3. Wypełnij formularz Podstawy. Poniższa tabela stanowi przewodnik po ukończeniu formularza. Zalecaną wartością planu jest użycie standardowe i dedykowane (wersja zapoznawcza).

    Ustawienie Sugerowana wartość opis
    Subskrypcja Nazwa subskrypcji. Subskrypcja platformy Azure, która ma być używana dla serwera. Jeśli masz wiele subskrypcji, wybierz subskrypcję, w której chcesz naliczać opłaty za zasób.
    Grupa zasobów: myresourcegroup Nowa nazwa grupy zasobów lub istniejąca nazwa z subskrypcji.
    Nazwa/nazwisko myasa Unikatowa nazwa identyfikująca usługę Azure Spring Apps. Nazwa musi mieć długość od 4 do 32 znaków i może zawierać tylko małe litery, cyfry i łączniki. Pierwszy znak nazwy usługi musi być literą, a ostatni znak musi być literą lub cyfrą.
    Planowanie Użycie standardowe i dedykowane (wersja zapoznawcza) Plan cenowy określa zasoby i koszty skojarzone z wystąpieniem.
    Region Region najbliżej Twoich użytkowników. Lokalizacja znajdująca się najbliżej użytkowników.
    Środowisko usługi Container Apps myenvironment Opcja wybrania wystąpienia środowiska usługi Container Apps do współużytkowania tej samej sieci wirtualnej z innymi usługami i zasobami.

    Poniższa tabela zawiera wskazówki dotyczące tworzenia środowiska usługi Container Apps:

    Ustawienie Sugerowana wartość opis
    Nazwa środowiska myenvironment Unikatowa nazwa identyfikująca usługę Azure Container Apps Environment.
    Planowanie Zużycie Plan cenowy określa zasoby i koszty skojarzone z wystąpieniem.
    Strefowo nadmiarowy Disabled Opcja tworzenia usługi Container Apps Environment w strefie dostępności platformy Azure.
  4. Wybierz pozycję Przejrzyj i Utwórz , aby przejrzeć wybrane opcje. Następnie wybierz pozycję Utwórz , aby aprowizować wystąpienie usługi Azure Spring Apps.

  5. Na pasku narzędzi wybierz ikonę Powiadomienia (dzwonek), aby monitorować proces wdrażania. Po zakończeniu wdrażania możesz wybrać pozycję Przypnij do pulpitu nawigacyjnego, co spowoduje utworzenie kafelka dla tej usługi na pulpicie nawigacyjnym witryny Azure Portal jako skrótu do strony Przegląd usługi.

  6. Wybierz pozycję Przejdź do zasobu, aby otworzyć stronę Przegląd usługi.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę Przegląd z otwartą stroną Powiadomienia.

Ważne

Profil obciążenia Zużycie ma model rozliczeniowy z płatnością zgodnie z rzeczywistym użyciem bez kosztów początkowych. Opłaty są naliczane za dedykowany profil obciążenia na podstawie zaaprowizowanych zasobów. Aby uzyskać więcej informacji, zobacz Profile obciążeń w usłudze Azure Container Apps i Cennik usługi Azure Spring Apps.

3.3. Przygotowywanie wystąpienia bazy danych PostgreSQL

Aby utworzyć serwer usługi Azure Database for PostgreSQL, wykonaj następujące czynności:

  1. Przejdź do witryny Azure Portal i wybierz pozycję Utwórz zasób.

  2. Wybierz pozycję Bazy danych>Azure Database for PostgreSQL.

  3. Wybierz opcję Wdrożenie serwera elastycznego.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę wybierz opcję wdrażania usługi Azure Database for PostgreSQL.

  4. Wypełnij kartę Podstawy następującymi informacjami:

    • Nazwa serwera: my-demo-pgsql
    • Region: Wschodnie stany USA
    • Wersja bazy danych PostgreSQL: 14
    • Typ obciążenia: Programowanie
    • Włącz wysoką dostępność: niezaznaczone
    • Metoda uwierzytelniania: tylko uwierzytelnianie postgreSQL
    • Nazwa użytkownika administratora: myadmin
    • Hasło i potwierdź hasło: wprowadź hasło.
  5. Użyj poniższych informacji, aby skonfigurować kartę Sieć :

    • Metoda łączności: dostęp publiczny (dozwolone adresy IP)
    • Zezwalaj na dostęp publiczny z dowolnej usługi platformy Azure na platformie Azure do tego serwera: wybrane
  6. Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć wybrane opcje, a następnie wybierz pozycję Utwórz , aby aprowizować serwer. Ta operacja może potrwać kilka minut.

  7. Przejdź do serwera PostgreSQL w witrynie Azure Portal. Na stronie Przegląd wyszukaj wartość Nazwa serwera, a następnie zapisz ją do późniejszego użycia. Potrzebne jest skonfigurowanie zmiennych środowiskowych dla aplikacji w usłudze Azure Spring Apps.

  8. Wybierz pozycję Bazy danych z menu nawigacji, aby utworzyć bazę danych — na przykład todo.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę Bazy danych z otwartym okienkiem Tworzenie bazy danych.

3.4. Łączenie wystąpienia aplikacji z wystąpieniem bazy danych PostgreSQL

Aby połączyć wystąpienia usługi, wykonaj następujące czynności:

  1. Przejdź do wystąpienia usługi Azure Spring Apps w witrynie Azure Portal.

  2. W menu nawigacji otwórz pozycję Aplikacje, a następnie wybierz pozycję Utwórz aplikację.

  3. Na stronie Tworzenie aplikacji wypełnij nazwę aplikacji simple-todo-api i wybierz pozycję Artefakty Java jako typ wdrożenia.

  4. Wybierz pozycję Utwórz , aby zakończyć tworzenie aplikacji, a następnie wybierz aplikację, aby wyświetlić szczegóły.

  5. Przejdź do aplikacji utworzonej w witrynie Azure Portal. Na stronie Przegląd wybierz pozycję Przypisz punkt końcowy, aby uwidocznić publiczny punkt końcowy dla aplikacji. Zapisz adres URL na potrzeby uzyskiwania dostępu do aplikacji po wdrożeniu.

  6. Przejdź do utworzonej aplikacji, rozwiń węzeł Ustawienia i wybierz pozycję Konfiguracja z menu nawigacji, a następnie wybierz pozycję Zmienne środowiskowe, aby ustawić zmienne środowiskowe.

  7. Dodaj następujące zmienne środowiskowe dla połączenia PostgreSQL, a następnie wybierz pozycję Zapisz , aby zakończyć aktualizację konfiguracji aplikacji. Pamiętaj, aby zastąpić symbole zastępcze własnymi wartościami utworzonymi wcześniej.

    Zmienna środowiskowa Wartość
    SPRING_DATASOURCE_URL jdbc:postgresql://<your-PostgreSQL-server-name>:5432/<your-PostgreSQL-database-name>
    SPRING_DATASOURCE_USERNAME <your-PostgreSQL-admin-user>
    SPRING_DATASOURCE_PASSWORD <your-PostgreSQL-admin-password>

    Zrzut ekranu witryny Azure Portal przedstawiający kartę Zmienne środowiskowe ze wszystkimi wartościami połączenia PostgreSQL.

3.5. Uwidacznianie interfejsów API RESTful

Wykonaj następujące kroki, aby uwidocznić interfejsy API RESTful w identyfikatorze Entra firmy Microsoft:

  1. Zaloguj się w witrynie Azure Portal.

  2. Jeśli masz dostęp do wielu dzierżaw, użyj filtru Katalog i subskrypcja ( ), aby wybrać dzierżawę, w której chcesz zarejestrować aplikację.

  3. Wyszukaj i wybierz Tożsamość Microsoft Entra.

  4. W obszarze Zarządzanie wybierz pozycję Rejestracje aplikacji> Nowa rejestracja.

  5. Wprowadź nazwę aplikacji w polu Nazwa — na przykład Todo. Użytkownicy aplikacji mogą zobaczyć tę nazwę i możesz ją zmienić później.

  6. W obszarze Obsługiwane typy kont wybierz pozycję Konta w dowolnym katalogu organizacyjnym (dowolny katalog Microsoft Entra — Multitenant) i osobiste konta Microsoft.

  7. Wybierz pozycję Zarejestruj, aby utworzyć aplikację.

  8. Na stronie Przegląd aplikacji wyszukaj wartość Identyfikator aplikacji (klienta), a następnie zapisz ją do późniejszego użycia. Potrzebny jest go do skonfigurowania pliku konfiguracji YAML dla tego projektu.

  9. W obszarze Zarządzanie wybierz pozycję Uwidaczniaj interfejs API, znajdź identyfikator URI identyfikatora aplikacji na początku strony, a następnie wybierz pozycję Dodaj.

  10. Na stronie Edytowanie identyfikatora URI identyfikatora aplikacji zaakceptuj proponowany identyfikator URI identyfikatora aplikacji (api://{client ID}) lub użyj znaczącej nazwy zamiast identyfikatora klienta, takiego jak api://simple-todo, a następnie wybierz pozycję Zapisz.

  11. W obszarze Zarządzanie wybierz pozycję Uwidacznianie interfejsu API>Dodaj zakres, a następnie wprowadź następujące informacje:

    • W polu Nazwa zakresu wprowadź ciąg ToDo.Read.
    • W obszarze Kto może wyrazić zgodę, wybierz pozycję Tylko administratorzy.
    • W polu Nazwa wyświetlana zgody administratora wprowadź ciąg Odczyt danych zadań do wykonania.
    • W polu Opis zgody administratora wprowadź Zezwalaj uwierzytelnieni użytkownikom na odczytywanie danych zadań do wykonania.
    • W obszarze Stan zachowaj włączoną wartość .
    • Wybierz Dodaj zakres.
  12. Powtórz poprzednie kroki, aby dodać dwa pozostałe zakresy: ToDo.Write i ToDo.Delete.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę uwidaczniającą interfejs API RESTful.

3.6. Aktualizowanie konfiguracji aplikacji

Wykonaj następujące kroki, aby zaktualizować plik YAML, aby użyć informacji o zarejestrowanej aplikacji firmy Microsoft w celu ustanowienia relacji z aplikacją interfejsu API RESTful:

  1. Znajdź plik src/main/resources/application.yml dla simple-todo-api aplikacji. Zaktualizuj konfigurację w spring.cloud.azure.active-directory sekcji, aby odpowiadała poniższemu przykładowi. Pamiętaj, aby zastąpić symbole zastępcze utworzonymi wcześniej wartościami.

    spring:
      cloud:
        azure:
          active-directory:
            profile:
              tenant-id: <tenant>
            credential:
              client-id: <your-application-ID-of-ToDo>
            app-id-uri: <your-application-ID-URI-of-ToDo>
    

    Uwaga

    W tokenach w wersji 1.0 konfiguracja wymaga identyfikatora klienta interfejsu API, natomiast w tokenach w wersji 2.0 można użyć identyfikatora klienta lub identyfikatora URI aplikacji w żądaniu. Oba te elementy można skonfigurować tak, aby prawidłowo ukończyć walidację odbiorców.

    Dozwolone tenant-id wartości to: common, organizations, consumerslub identyfikator dzierżawy. Aby uzyskać więcej informacji na temat tych wartości, zobacz sekcję Użycie nieprawidłowego punktu końcowego (konta osobiste i konta organizacji) w sekcji Błąd AADSTS50020 — konto użytkownika od dostawcy tożsamości nie istnieje w dzierżawie. Aby uzyskać informacje na temat konwertowania aplikacji z jedną dzierżawą, zobacz Konwertowanie aplikacji z jedną dzierżawą na wielodostępny w usłudze Microsoft Entra ID.

  2. Użyj następującego polecenia, aby ponownie skompilować przykładowy projekt:

    ./mvnw clean package
    

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

Teraz możesz wdrożyć aplikację w usłudze Azure Spring Apps.

Wykonaj następujące kroki, aby wdrożyć przy użyciu wtyczki Maven dla usługi Azure Spring Apps:

  1. Przejdź do kompletnego katalogu, a następnie uruchom następujące polecenie, aby skonfigurować aplikację w usłudze Azure Spring Apps:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
    

    Poniższa lista zawiera opis interakcji poleceń:

    • Logowanie OAuth2: musisz autoryzować logowanie do platformy Azure na podstawie protokołu OAuth2.
    • Wybierz subskrypcję: wybierz numer listy subskrypcji utworzonego wystąpienia usługi Azure Spring Apps, które jest domyślnie ustawione na pierwszą subskrypcję na liście. Jeśli używasz numeru domyślnego, naciśnij Enter bezpośrednio.
    • Użyj istniejących aplikacji Azure Spring Apps na platformie Azure: naciśnij y , aby użyć istniejącego wystąpienia usługi Azure Spring Apps.
    • Wybierz pozycję Azure Spring Apps do wdrożenia: wybierz liczbę utworzonego wystąpienia usługi Azure Spring Apps. Jeśli używasz numeru domyślnego, naciśnij Enter bezpośrednio.
    • Użyj istniejącej aplikacji w usłudze Azure Spring Apps <nazwa-wystąpienia>: naciśnij y , aby użyć utworzonej aplikacji.
    • Potwierdź, aby zapisać wszystkie powyższe konfiguracje: naciśnij y. Jeśli naciśniesz n, konfiguracja nie zostanie zapisana w plikach POM.
  2. Aby wdrożyć aplikację, użyj następującego polecenia:

    ./mvnw azure-spring-apps:deploy
    

    Na poniższej liście opisano interakcję z poleceniem:

    • Logowanie OAuth2: musisz autoryzować logowanie do platformy Azure na podstawie protokołu OAuth2.

    Po wykonaniu polecenia można zobaczyć następujące komunikaty dziennika, że wdrożenie zakończyło się pomyślnie:

[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:NONE
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io

5. Weryfikowanie aplikacji

Teraz możesz uzyskać dostęp do interfejsu API RESTful, aby sprawdzić, czy działa.

5.1. Poproś o token dostępu

Interfejsy API RESTful działają jako serwer zasobów, który jest chroniony przez identyfikator Entra firmy Microsoft. Przed uzyskaniem tokenu dostępu należy zarejestrować inną aplikację w usłudze Microsoft Entra ID i udzielić uprawnień aplikacji klienckiej o nazwie ToDoWeb.

Rejestrowanie aplikacji klienckiej

Wykonaj następujące kroki, aby zarejestrować aplikację w usłudze Microsoft Entra ID, która służy do dodawania ToDo uprawnień dla aplikacji:

  1. Zaloguj się w witrynie Azure Portal.

  2. Jeśli masz dostęp do wielu dzierżaw, użyj filtru Katalog i subskrypcja ( ), aby wybrać dzierżawę, w której chcesz zarejestrować aplikację.

  3. Wyszukaj i wybierz Tożsamość Microsoft Entra.

  4. W obszarze Zarządzanie wybierz pozycję Rejestracje aplikacji> Nowa rejestracja.

  5. Wprowadź nazwę aplikacji w polu Nazwa — na przykład ToDoWeb. Użytkownicy aplikacji mogą zobaczyć tę nazwę i możesz ją zmienić później.

  6. W przypadku obsługiwanych typów kont użyj wartości domyślnej Konta tylko w tym katalogu organizacyjnym.

  7. Wybierz pozycję Zarejestruj, aby utworzyć aplikację.

  8. Na stronie Przegląd aplikacji wyszukaj wartość Identyfikator aplikacji (klienta), a następnie zapisz ją do późniejszego użycia. Potrzebujesz go, aby uzyskać token dostępu.

  9. Wybierz pozycję Uprawnienia>interfejsu API Dodaj uprawnienie>Moje interfejsy API. Wybierz zarejestrowaną wcześniej aplikację ToDo , a następnie wybierz uprawnienia ToDo.Read, ToDo.Write i ToDo.Delete . Wybierz Przyznaj uprawnienia.

  10. Wybierz pozycję Udziel zgody administratora dla <nazwy> dzierżawy, aby udzielić zgody administratora dla dodanych uprawnień.

    Zrzut ekranu witryny Azure Portal przedstawiający uprawnienia interfejsu API aplikacji internetowej.

Dodawanie użytkownika w celu uzyskania dostępu do interfejsów API RESTful

Wykonaj poniższe kroki, aby utworzyć użytkownika członkowskiego w dzierżawie firmy Microsoft Entra. Następnie użytkownik może zarządzać danymi ToDo aplikacji za pomocą interfejsów API RESTful.

  1. W obszarze Zarządzanie wybierz pozycję Użytkownicy>Nowy użytkownik>Utwórz nowego użytkownika.

  2. Na stronie Tworzenie nowego użytkownika wprowadź następujące informacje:

    • Główna nazwa użytkownika: wprowadź nazwę użytkownika.
    • Nazwa wyświetlana: wprowadź nazwę wyświetlaną użytkownika.
    • Hasło: skopiuj automatycznie wygenerowane hasło podane w polu Hasło.

    Uwaga

    Nowi użytkownicy muszą ukończyć pierwsze uwierzytelnianie logowania i zaktualizować swoje hasła. W przeciwnym razie podczas uzyskiwania tokenu dostępu zostanie wyświetlony AADSTS50055: The password is expired błąd.

    Gdy nowy użytkownik zaloguje się, otrzyma monit o akcję wymaganą. Mogą wybrać pozycję Zapytaj później , aby pominąć walidację.

  3. Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć wybrane opcje. Wybierz pozycję Utwórz , aby utworzyć użytkownika.

Aktualizowanie konfiguracji protokołu OAuth2 na potrzeby autoryzacji interfejsu użytkownika programu Swagger

Wykonaj poniższe kroki, aby zaktualizować konfigurację protokołu OAuth2 dla autoryzacji interfejsu użytkownika struktury Swagger. Następnie możesz autoryzować użytkowników do uzyskiwania tokenów dostępu za pośrednictwem ToDoWeb aplikacji.

  1. Otwórz dzierżawę identyfikatora entra firmy Microsoft w witrynie Azure Portal i przejdź do zarejestrowanej ToDoWeb aplikacji.

  2. W obszarze Zarządzanie wybierz pozycję Uwierzytelnianie, wybierz pozycję Dodaj platformę, a następnie wybierz pozycję Aplikacja jednostronicowa.

  3. Użyj formatu <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html jako adresu URL przekierowania OAuth2 w polu Identyfikatory URI przekierowania, a następnie wybierz pozycję Konfiguruj.

    Zrzut ekranu witryny Azure Portal przedstawiający stronę Uwierzytelnianie dla identyfikatora entra firmy Microsoft.

Uzyskiwanie tokenu dostępu

Wykonaj następujące kroki, aby użyć metody przepływu kodu autoryzacji OAuth 2.0 w celu uzyskania tokenu dostępu z identyfikatorem Entra firmy Microsoft, a następnie uzyskać dostęp do interfejsów ToDo API RESTful aplikacji:

  1. Otwórz adres URL uwidoczniony przez aplikację, a następnie wybierz pozycję Autoryzuj , aby przygotować uwierzytelnianie OAuth2.

  2. W oknie Dostępne autoryzacje wprowadź identyfikator ToDoWeb klienta aplikacji w polu client_id, wybierz wszystkie zakresy pola Zakresy, zignoruj pole client_secret, a następnie wybierz pozycję Autoryzuj, aby przekierować do strony logowania microsoft Entra.

Po zakończeniu logowania przy użyciu poprzedniego użytkownika wrócisz do okna Dostępne autoryzacje .

5.2. Uzyskiwanie dostępu do interfejsów API RESTful

Wykonaj następujące kroki, aby uzyskać dostęp do interfejsów ToDo API RESTful aplikacji w interfejsie użytkownika struktury Swagger:

  1. Wybierz interfejs API POST /api/simple-todo/lists , a następnie wybierz pozycję Wypróbuj. Wprowadź następującą treść żądania, a następnie wybierz pozycję Wykonaj , aby utworzyć listę zadań do wykonania.

    {
      "name": "My List"
    }
    

    Po zakończeniu wykonywania zostanie wyświetlona następująca treść odpowiedzi:

    {
      "id": "<ID-of-the-ToDo-list>",
      "name": "My List",
      "description": null
    }
    
  2. Wybierz interfejs API POST /api/simple-todo/lists/{listId}/items , a następnie wybierz pozycję Wypróbuj. W polu listId wprowadź utworzony wcześniej identyfikator listy zadań do wykonania, wprowadź następującą treść żądania, a następnie wybierz pozycję Wykonaj , aby utworzyć element ToDo.

    {
      "name": "My first ToDo item", 
      "listId": "<ID-of-the-ToDo-list>",
      "state": "todo"
    }
    

    Ta akcja zwraca następujący element ToDo:

    {
      "id": "<ID-of-the-ToDo-item>",
      "listId": "<ID-of-the-ToDo-list>",
      "name": "My first ToDo item",
      "description": null,
      "state": "todo",
      "dueDate": "2023-07-11T13:59:24.9033069+08:00",
      "completedDate": null
    }
    
  3. Wybierz interfejs API GET /api/simple-todo/lists , a następnie wybierz pozycję Wykonaj , aby wykonać zapytanie o listy zadań do wykonania. Ta akcja zwraca następujące listy zadań do wykonania:

    [
      {
        "id": "<ID-of-the-ToDo-list>",
        "name": "My List",
        "description": null
      }
    ]
    
  4. Wybierz interfejs API GET /api/simple-todo/lists/{listId}/items , a następnie wybierz pozycję Wypróbuj. W polu listId wprowadź utworzony wcześniej identyfikator listy zadań do wykonania, a następnie wybierz pozycję Wykonaj , aby wykonać zapytanie o elementy zadań do wykonania. Ta akcja zwraca następujący element ToDo:

    [
      {
        "id": "<ID-of-the-ToDo-item>",
        "listId": "<ID-of-the-ToDo-list>",
        "name": "My first ToDo item",
        "description": null,
        "state": "todo",
        "dueDate": "2023-07-11T13:59:24.903307+08:00",
        "completedDate": null
      }
    ]
    
  5. Wybierz interfejs API PUT /api/simple-todo/lists/{listId}/items/{itemId}, a następnie wybierz pozycję Wypróbuj. W polu listId wprowadź identyfikator listy Zadań do wykonania. W polu itemId wprowadź identyfikator elementu ToDo, wprowadź następującą treść żądania, a następnie wybierz pozycję Wykonaj , aby zaktualizować element ToDo.

    {
      "id": "<ID-of-the-ToDo-item>",
      "listId": "<ID-of-the-ToDo-list>",
      "name": "My first ToDo item",
      "description": "Updated description.",
      "dueDate": "2023-07-11T13:59:24.903307+08:00",
      "state": "inprogress"
    }
    

    Ta akcja zwraca następujący zaktualizowany element ToDo:

    {
      "id": "<ID-of-the-ToDo-item>",
      "listId": "<ID-of-the-ToDo-list>",
      "name": "My first ToDo item",
      "description": "Updated description.",
      "state": "inprogress",
      "dueDate": "2023-07-11T05:59:24.903307Z",
      "completedDate": null
    }
    
  6. Wybierz interfejs API DELETE /api/simple-todo/lists/{listId}/items/{itemId} , a następnie wybierz pozycję Wypróbuj. W polu listId wprowadź identyfikator listy Zadań do wykonania. W polu itemId wprowadź identyfikator elementu ToDo, a następnie wybierz pozycję Wykonaj , aby usunąć element ToDo. Powinien zostać wyświetlony kod odpowiedzi serwera: 204.

6. Czyszczenie zasobów

Możesz usunąć grupę zasobów platformy Azure zawierającą wszystkie zasoby w tej grupie.

Wykonaj następujące kroki, aby usunąć całą grupę zasobów, w tym nowo utworzoną usługę:

  1. Znajdź grupę zasobów w witrynie Azure Portal.

  2. W menu nawigacji wybierz pozycję Grupy zasobów. Następnie wybierz nazwę grupy zasobów — na przykład myresourcegroup.

  3. Na stronie grupy zasobów wybierz pozycję Usuń. Wprowadź nazwę grupy zasobów w polu tekstowym, aby potwierdzić usunięcie — na przykład myresourcegroup. Następnie wybierz pozycję Usuń.

Wykonaj następujące kroki, aby usunąć całą grupę zasobów, w tym nowo utworzoną usługę:

  1. Znajdź grupę zasobów w witrynie Azure Portal.

  2. W menu nawigacji wybierz pozycję Grupy zasobów. Następnie wybierz nazwę grupy zasobów — na przykład myresourcegroup.

  3. Na stronie grupy zasobów wybierz pozycję Usuń. Wprowadź nazwę grupy zasobów w polu tekstowym, aby potwierdzić usunięcie — na przykład myresourcegroup. Następnie wybierz pozycję Usuń.

7. Następne kroki

Aby uzyskać więcej informacji, zobacz następujące artykuły: