연습 - 백엔드 API 만들기

  • 15분

이 연습에서는 다음 작업을 수행하는 방법을 배웁니다.

  • APIM(API Management) 인스턴스 만들기
  • API 가져오기
  • 백 엔드 설정 구성
  • API 테스트

사전 요구 사항

  • 활성 구독이 있는 Azure 계정. 구독이 아직 없다면 https://azure.com/free에서 평가판을 신청할 수 있습니다.

Azure에 로그인

  1. Azure Portal에 로그인하고 Cloud Shell을 엽니다.

    Cloud Shell 시작 단추의 위치.

  2. 셸이 열리면 Bash 환경을 선택해야 합니다.

    Bash 환경 선택.

API Management 인스턴스 만들기

  1. CLI 명령에서 다시 입력하는 양을 줄이는 데 사용할 몇 가지 변수를 설정해 보겠습니다. <myLocation>을 적절한 지역으로 바꿉니다. APIM 이름은 전역적으로 고유한 이름이어야 하며 다음 스크립트는 임의의 문자열을 생성합니다. <myEmail>을 액세스할 수 있는 이메일 주소로 바꿉니다.

    myApiName=az204-apim-$RANDOM
myLocation=<myLocation>
myEmail=<myEmail>

  2. 리소스 그룹을 만듭니다. 다음 명령은 az204-apim-rg라는 리소스 그룹을 만듭니다.

    az group create --name az204-apim-rg --location $myLocation

  3. APIM 인스턴스를 만듭니다. az apim create 명령은 인스턴스를 만드는 데 사용됩니다. --sku-name Consumption 옵션은 연습 진행 속도를 높이기 위해 사용됩니다.

    az apim create -n $myApiName \
    --location $myLocation \
    --publisher-email $myEmail  \
    --resource-group az204-apim-rg \
    --publisher-name AZ204-APIM-Exercise \
    --sku-name Consumption

    참고

    작업은 약 5분이면 완료됩니다.

백 엔드 API 가져오기

이 섹션에서는 OpenAPI 사양 백 엔드 API를 가져오고 게시하는 방법을 보여 줍니다.

  1. Azure Portal에서 API Management Services를 검색하여 선택합니다.

  2. API Management 화면에서 만든 API Management 인스턴스를 선택합니다.

  3. API Management 서비스 탐색 창의 APIs에서 APIs를 선택합니다.

    서비스 탐색 창에서 API를 선택합니다.

  4. 목록에서 OpenAPI를 선택하고 팝업에서 전체를 선택합니다.

    OpenAPI 대화 상자. 필드는 다음 표에 자세히 설명되어 있습니다.

    다음 표의 값을 사용하여 양식을 작성합니다. 언급되지 않은 필드는 모두 기본값 그대로 둘 수 있습니다.

    설정 값 설명
    OpenAPI 사양 https://bigconference.azurewebsites.net/ API를 구현하는 서비스를 참조하며, 요청이 이 주소로 전달됩니다. 양식에 필요한 대부분의 정보는 이 정보를 입력하면 자동으로 채워집니다.
    표시 이름 빅 컨퍼런스 API 이 이름은 개발자 포털에 표시됩니다.
    이름 big-conference-api API의 고유한 이름을 제공합니다.
    설명 자동으로 채워짐 API에 대한 선택적 설명을 제공합니다.

  5. 만들기를 실행합니다.

API 설정 구성

Big Conference API가 만들어졌습니다. API 설정을 구성합니다.

  1. 오른쪽 블레이드에서 설정을 선택합니다.

  2. https://bigconference.azurewebsites.net/이 웹 서비스 URL 필드에 있는지 확인합니다.

  3. 구독 필요 확인란을 선택 취소합니다.

    API에 대한 백 엔드 URL을 지정합니다.

  4. 저장을 선택합니다.

API 테스트

이제 API를 가져오고 구성했으므로 API를 테스트할 시간입니다.

  1. 테스트를 선택합니다.

    오른쪽 창에서 테스트를 선택합니다.

  2. Speakers_Get을 선택합니다. 페이지에 쿼리 매개 변수 및 헤더(있는 경우)가 표시됩니다.

  3. 보내기를 선택합니다.

    백 엔드는 200 정상 및 일부 데이터로 응답합니다.

Azure 리소스 정리

이 연습에서 만든 리소스에 대한 작업이 끝나면 다음 명령을 사용하여 리소스 그룹과 모든 관련 리소스를 삭제할 수 있습니다.

az group delete --name az204-apim-rg