다음을 통해 공유

API 버전 사용 중지(2024년 6월)

  • 아티클

적용 대상: 사용량 | 개발자 | 기본 | 표준 | 프리미엄

Azure API Management는 ARM(Azure Resource Manager)을 사용하여 API Management 인스턴스를 구성합니다. API 버전은 인프라를 설명하는 템플릿, 서비스를 구성하는 데 사용되는 도구 및 Azure API Management 서비스를 관리하기 위해 작성하는 프로그램 사용에 포함되어 있습니다.

2024년 6월 1일부터 2021-08-01 이전의 Azure API Management 서비스에 대한 모든 API 버전이 사용 중지됩니다(사용 안 함). 이전에 전달된 은퇴 날짜는 2023년 9월 30일이었습니다. 2024년 6월 1일 이후 언제든지 2021-08-01 이전의 API 버전을 사용하는 API 호출은 추가 통지 없이 실패할 수 있습니다. API 버전 2021-08-01 이상을 사용하도록 업데이트될 때까지는 사용 중지된 API 버전을 사용하여 기존 템플릿, 도구, 스크립트 및 프로그램을 사용하여 API Management 서비스를 더 이상 만들거나 관리할 수 없습니다. 데이터 평면 작업(예: 게이트웨이에서 API 요청 중재)은 2024년 6월 1일 이후를 포함하여 이 업데이트의 영향을 받지 않습니다.

이로 인해 내 서비스가 영향을 받나요?

서비스는 이 변경의 영향을 받지 않지만 Azure Resource Manager(예: Azure CLI, Azure PowerShell, Azure API Management DevOps Resource Kit 또는 Terraform)를 사용하여 API Management 서비스와 상호 작용하고 2021-08-01 이전의 API Management API 버전을 호출하는 도구, 스크립트 또는 프로그램은 이 변경의 영향을 받습니다. API 버전이 사용 중지된 후에는 도구를 업데이트하지 않으면 영향을 받는 도구를 성공적으로 실행할 수 없습니다.

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

영향을 받는 API 버전은 2024년 6월 1일부터 점진적으로 사용 중지됩니다.

API 버전이 사용 중지된 후 영향을 받는 도구, 스크립트 및 프로그램을 업데이트하지 않으려는 경우 서비스가 계속 실행됩니다. 그러나 API를 추가 또는 제거하거나, API 정책을 변경하거나, 영향을 받는 도구를 사용하여 API Management 서비스를 구성할 수 없습니다.

필요한 작업

다음 섹션의 세부 정보를 사용하여 도구, 스크립트 및 프로그램을 업데이트합니다.

또한 API Management 인스턴스에서 최소 API 버전을 설정하는 것이 좋습니다.

도구, 스크립트 및 프로그램 업데이트

  • ARM, Bicep 또는 Terraform 템플릿 - API 버전 2021-08-01 이상을 사용하도록 템플릿을 업데이트합니다.

  • Azure CLI - az version를 실행하여 버전을 확인합니다. 버전 2.42.0 이상을 실행하는 경우 아무 작업도 필요하지 않습니다. 필요한 경우 az upgrade 명령을 사용하여 Azure CLI를 업그레이드합니다. 자세한 내용은 Azure CLI를 업데이트하는 방법을 참조하세요.

  • Azure PowerShell - Get-Module -ListAvailable -Name Az를 실행하여 버전을 확인합니다. 버전 8.1.0 이상을 실행하는 경우 아무 작업도 필요하지 않습니다. 필요한 경우 Update-Module -Name Az -Repository PSGallery를 사용하여 모듈을 업데이트합니다. 자세한 내용은 Azure Az PowerShell 모듈 설치를 참조하세요.

  • 기타 도구 - 다음 버전(이상)을 사용합니다.

    • API Management DevOps 리소스 키트: 1.0.0
    • Terraform azurerm 공급자: 3.0.0

  • Azure SDK - Azure API Management SDK를 최신 버전 또는 적어도 다음 버전으로 업데이트합니다.

    • .NET: v1.1.0
    • Go: 1.0.0
    • Python: 3.0.0
    • JavaScript: 8.0.1
    • Java: 1.0.0-beta3

API Management 인스턴스에서 최소 API 버전 설정 업데이트

Azure Portal을 사용하거나 REST API 또는 기타 도구를 사용하여 API Management 인스턴스에 대한 최소 API 버전을 설정하는 것이 좋습니다. 이 설정은 인스턴스에 대한 컨트롤 플레인 API 호출을 이 값과 같거나 최신인 API 버전으로 제한합니다. 이 값을 2021-08-01로 설정하면 API 버전 사용 중지가 도구에 미치는 영향을 평가할 수 있습니다.

포털에서 최소 API 버전을 설정하려면 다음을 수행합니다.

  1. Azure Portal에서 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴의 배포 + 인프라에서 관리 API를 선택합니다.
  3. 관리 API 설정 탭을 선택합니다.
  4. 최소 API 버전 적용에서 예를 선택합니다. 최소 API 버전이 나타납니다.
  5. 저장을 선택합니다.

Important

포털의 최소 API 버전이 회색으로 표시되는 경우, 예를 들어 Azure CLI에서 REST API 또는 az apim update 명령을 사용하여 프로그래밍 방식으로만 설정을 업데이트할 수 있습니다.

자세한 정보

관련 콘텐츠

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