다음을 통해 공유

작업 영역의 호환성이 손상되는 변경, 2부(2025년 3월)

  • 아티클

적용 대상: 프리미엄

Important

이러한 호환성이 손상되는 변경은 Azure API Management의 미리 보기 작업 영역에만 적용됩니다. 2024년 8월 일반 공급 릴리스 이후 작업 영역을 만들었고, 작업 영역 게이트웨이에서 작업 영역을 사용하려는 경우, 작업 영역은 이러한 변경 내용의 영향을 받지 않습니다.

Azure API Management 작업 영역은 이제 일반 공급되며, 해당 릴리스에서 몇 가지 기능 업데이트가 도입되었습니다. 지속적인 작업 영역 개발의 일환으로 미리 보기 작업 영역(2024년 8월 이전에 생성)에 대한 지원을 중단할 예정입니다. Azure API Management에서 미리 보기 작업 영역을 만들고 계속해서 사용하려면 작업 영역을 일반 공급 버전으로 마이그레이션해야 합니다.

2025년 3월 31일 이후에는 최신 작업 영역 기능으로 마이그레이션하지 않은 경우 미리 보기 작업 영역 및 해당 작업 영역에서 관리되는 API의 작동이 중지될 수 있습니다. 작업 영역 외부에서 관리되는 API 및 리소스는 이 변경의 영향을 받지 않습니다.

이러한 변경으로 인해 내 서비스가 영향을 받나요?

2024년 8월의 작업 영역 일반 공급 릴리스 전에 API Management 인스턴스에서 미리 보기 작업 영역을 만든 경우, 서비스는 이러한 변경의 영향을 받을 수 있습니다. API 런타임에 대한 작업 영역 게이트웨이를 사용하는 일반 공급 릴리스 날짜 이후에 만든 작업 영역은 호환성이 손상되는 변경의 영향을 받지 않습니다.

호환성이 손상되는 변경

다음은 미리 보기 작업 영역을 일반 공급 버전으로 마이그레이션하기 위한 작업을 수행해야 하는 호환성이 손상되는 변경입니다.

  • 작업 영역 API 게이트웨이가 필요함 - 각 작업 영역은 작업 영역의 런타임 트래픽을 격리하는 작업 영역 API 게이트웨이와 연결되어야 합니다. 미리 보기에서 작업 영역은 서비스와 게이트웨이를 공유했습니다.
  • 서비스 수준 관리 ID는 지원되지 않음 - 작업 영역의 보안을 개선하기 위해 서비스 수준에서 사용하도록 설정된 시스템 할당 및 사용자 할당 관리 ID는 작업 영역에서 사용할 수 없습니다. 현재 Azure Key Vault에 명명된 값 및 인증서를 저장하고 authentication-managed-identity 정책을 사용하는 등 관리 ID에 의존하는 관련 API Management 기능은 작업 영역에서 지원되지 않습니다.

참고 항목

이러한 호환성이 손상되는 변경은 이전에 발표된 미리 보기 작업 영역에 대한 2024년 6월 호환성이 손상되는 변경에 추가됩니다.

변경 기한은 어떻게 되나요?

이 호환성이 손상되는 변경은 2025년 3월 31일 이후에 미리 보기 작업 영역에 적용될 예정입니다. 해당 날짜 이전에 미리 보기 작업 영역의 구성에 필요한 모든 변경을 수행하는 것이 좋습니다.

해야 할 작업

작업 영역이 이러한 변경의 영향을 받는 경우 일반 공급 기능에 맞게 작업 영역을 마이그레이션해야 합니다. 다음 섹션에서는 작업 영역을 마이그레이션하는 방법에 대한 지침을 제공합니다.

API Management 인스턴스에 프리미엄 계층을 사용합니다.

작업 영역을 계속 사용하려면 API Management 인스턴스가 프리미엄 계층에서 실행되고 있는지 확인합니다. 이전에 발표된 대로 인스턴스가 표준 또는 개발자 계층에 있는 경우 프리미엄 계층으로 업그레이드해야 합니다.

인스턴스의 지역 확인

작업 영역에 작업 영역 게이트웨이를 추가하려면 게이트웨이가 인스턴스와 동일한 지역에 있어야 합니다. 현재, 작업 영역 게이트웨이는 API Management를 사용할 수 있는 지역 하위 집합에서 지원됩니다. 작업 영역 게이트웨이를 지원하는 지역은 시간이 지남에 따라 업데이트됩니다.

미리 보기 작업 영역이 지원되는 지역에 있는지 확인하려면 다음을 수행합니다.

  1. Azure Portal에서 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴의 API에서 작업 영역을 선택하고 작업 영역을 선택합니다.
  3. 작업 영역이 작업 영역 게이트웨이를 지원하지 않는 지역에 있는 경우 포털에 "작업 영역은 현재 API Management 서비스의 지역에서 사용할 수 없습니다."라는 메시지가 표시됩니다.
    • 이 메시지가 표시되면 지원되는 지역으로 API Management 인스턴스를 이동할 수 있습니다.
    • 이 메시지가 표시되지 않으면 작업 영역이 지원되는 지역에 있으며 작업 영역 게이트웨이를 계속 추가할 수 있습니다.

작업 영역에 작업 영역 게이트웨이 추가

다음은 작업 영역에 작업 영역 게이트웨이를 추가하는 단계를 간단히 나타낸 것입니다. 게이트웨이 네트워킹 옵션, 필수 구성 요소 및 자세한 지침은 작업 영역 만들기 및 관리를 참조하세요.

참고 항목

  • 작업 영역 게이트웨이에는 추가 요금이 발생합니다. 자세한 내용은 API Management 가격을 참조하세요.
  • 여러 작업 영역을 작업 영역 게이트웨이와 연결하는 기능을 도입하여 조직이 더 저렴한 비용으로 작업 영역과 API를 관리할 수 있도록 지원합니다. 이 기능은 2024년 12월부터 출시되고 있으며, 1월 이전에는 모든 적격 서비스에서 사용할 수 없습니다. 자세한 정보
  1. Azure Portal에서 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴의 API 아래에서 작업 영역을 선택합니다.
  3. 작업 영역을 선택합니다.
  4. 왼쪽 메뉴에 있는 배포 + 인프라에서 게이트웨이>+ 추가를 선택합니다.
  5. 마법사를 완료하여 게이트웨이를 만듭니다. 현재 게이트웨이의 프로비전은 몇 분에서 최대 3시간 이상 걸릴 수 있습니다.
  6. 게이트웨이가 프로비전되면 게이트웨이의 개요 페이지로 이동합니다. 런타임 호스트 이름 값을 확인합니다. 이 값을 사용하여 작업 영역의 API를 호출하는 클라이언트 앱을 업데이트합니다.
  7. 나머지 작업 영역에 대해 이전 단계를 반복합니다.

새 게이트웨이 호스트 이름을 사용하도록 클라이언트 앱 업데이트

작업 영역에 게이트웨이를 추가한 후에는 API Management 인스턴스의 게이트웨이 호스트 이름 대신 새 게이트웨이 호스트 이름을 사용하도록 작업 영역의 API를 호출하는 클라이언트 앱을 업데이트해야 합니다.

참고 항목

작업 영역의 마이그레이션을 돕기 위해 작업 영역 게이트웨이가 작업 영역과 연결된 경우에도 2024년 10월까지는 API Management 인스턴스의 게이트웨이 호스트 이름을 사용하여 런타임에 작업 영역의 API에 계속 액세스할 수 있습니다. 이 날짜 전에 마이그레이션을 완료할 것을 강력히 권장합니다. 작업 영역 게이트웨이가 프라이빗 인바운드 액세스 및 프라이빗 아웃바운드 액세스로 구성된 경우 API Management 인스턴스의 기본 제공 게이트웨이에 대한 연결도 보호해야 합니다.

서비스 수준 관리 ID에 대한 종속성 업데이트

작업 영역 엔터티(예: 명명된 값 또는 인증서)의 구성에서 서비스 수준 관리 ID를 사용하는 경우 구성을 업데이트해야 합니다. 권장 단계는 엔터티에 따라 다릅니다. 예: Azure Key Vault에 저장된 비밀 대신 비밀 값을 사용하도록 명명된 값을 업데이트

도움말 및 지원 

질문이 있는 경우, Microsoft Q&A에서 커뮤니티 전문가의 답변을 받으세요. 지원 계획이 있고 기술 지원이 필요한 경우 지원 요청을 만드세요.

자세한 정보

관련 콘텐츠

모든 예정된 주요 변경 내용 및 기능 사용 중지를 확인합니다.