Share via

작업 영역 - 호환성이 손상되는 변경(2024년 6월)

  • 아티클

적용 대상: 개발자 | 표준 | 프리미엄

2024년 6월 14일 이후 Azure API Management에서 작업 영역(미리 보기) 개발의 일환으로 몇 가지 주요 변경 내용이 도입되었습니다.

2024년 6월 14일 이후에는 변경하도록 설정된 기능에 계속 의존하는 경우 관리되는 작업 영역 및 API가 작동을 중지할 수 있습니다. 작업 영역 외부에서 관리되는 API 및 리소스는 이 변경의 영향을 받지 않습니다.

내 서비스가 이러한 변경 내용의 영향을 받나요?

API Management 인스턴스에서 작업 영역(미리 보기)을 구성한 경우 서비스가 이러한 변경 내용의 영향을 받을 수 있습니다. 이 기능은 프리미엄, 표준 및 개발자 계층에서 도입되었습니다.

호환성이 손상되는 변경

다음 주요 변경 내용을 검토하여 조치를 취해야 하는지 확인합니다.

지원되는 서비스 계층으로 변경

다음 서비스 계층은 더 이상 작업 영역을 지원하지 않습니다. 표준 및 개발자. 작업 영역은 프리미엄 계층에서 사용할 수 있습니다.

v2 계층의 가용성은 Azure API Management v2 계층을 참조 하세요.

작업 영역에서 서비스 수준 엔터티를 할당하기 위한 지원 변경 내용

서비스 수준 엔터티에 대한 작업 영역 엔터티의 다음 할당은 더 이상 지원되지 않습니다.

  • 서비스 수준 제품에 작업 영역 API 할당

  • 서비스 수준 태그에 작업 영역 API 할당

  • 서비스 수준 태그에 작업 영역 제품 할당

  • 가시성 제어를 위해 작업 영역 제품에 서비스 수준 그룹 할당

    참고 항목

    기본 제공 게스트 및 개발자 그룹은 작업 영역에서 계속 사용할 수 있습니다.

지원되는 컨텍스트 개체에 대한 변경 내용

다음 context 개체는 작업 영역 정책 또는 서비스 수준의 모든 API 정책에서 더 이상 지원되지 않습니다.

  • context.Api.Workspace
  • context.Product.Workspace

개체를 context.Workspace 대신 사용할 수 있습니다.

참고 항목

작업 영역 수준 정책에서 개체의 서비스 수준에서 context 사용자를 계속 참조할 수 있습니다.

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

호환성이 손상되는 변경 내용은 2024년 6월 14일 이후에 도입될 예정입니다. 해당 날짜 이전에 작업 영역 구성에 필요한 모든 변경을 수행하는 것이 좋습니다.

해야 할 작업

작업 영역이 이러한 변경의 영향을 받는 경우 새 기능에 맞게 작업 영역 구성을 업데이트해야 합니다.

표준 계층 고객

표준 계층에서 작업 영역을 사용하는 경우 프리미엄 계층으로 업그레이드하여 작업 영역을 계속 사용합니다.

개발자 계층 고객

개발자 계층은 단일 사용자 또는 단일 팀 사용 사례를 위해 설계되었습니다. 제한된 컴퓨팅 리소스, SLA 부족 및 인프라 중복성으로 인해 작업 영역과의 다중 팀 협업을 용이하게 할 수 없습니다. 개발자 계층에서 작업 영역 미리 보기를 사용하는 경우 다음 옵션 중 하나를 선택할 수 있습니다.

  • 프리미엄 계층 인스턴스의 집계

    각 개발자 계층 인스턴스를 프리미엄 계층으로 업그레이드하는 것은 옵션이지만 단일 프리미엄 계층 인스턴스에서 여러 비프로덕션 환경을 집계하는 것이 좋습니다. 프리미엄 계층의 작업 영역을 사용하여 다양한 환경을 격리합니다.

  • 개발에 개발자 계층 인스턴스 사용, 프로덕션을 위한 프리미엄 계층의 작업 영역으로 마이그레이션

    개발 환경에 개발자 계층 인스턴스를 사용할 수 있습니다. 더 높은 환경의 경우 각 개발자 계층 서비스의 구성을 프리미엄 계층 서비스의 작업 영역(예: CI/CD 파이프라인 사용)으로 마이그레이션할 수 있습니다. 이 방법을 사용하면 환경 간에 구성을 관리할 때 문제가 발생하거나 충돌이 발생할 수 있습니다.

    현재 개발자 계층 인스턴스에서 작업 영역을 사용하는 경우 작업 영역 구성을 작업 영역 없이 개발자 계층 인스턴스로 마이그레이션할 수 있습니다.

    1. API Management 인스턴스에서 Resource Manager 템플릿을 내보냅니다. Azure Portal에서 또는 다른 도구를 사용하여 템플릿을 내보낼 수 있습니다.
    2. 리소스 ID 값의 다음 부분 문자열을 제거합니다. /workspaces/[^/]+
    3. 템플릿을 배포합니다. 자세한 내용은 빠른 시작: Azure Portal을 사용하여 ARM 템플릿 만들기 및 배포를 참조하세요.

    사용 사례에 따라 API Management 인스턴스에서 다른 구성 변경을 수행해야 할 수 있습니다.

작업 영역 수준 엔터티 할당

작업 영역 미리 보기의 서비스 수준 엔터티에 작업 영역 수준 엔터티를 할당한 경우 마이그레이션 지침은 다음 표를 참조하세요.

할당이 더 이상 지원되지 않음 권장되는 마이그레이션 단계
서비스 수준 제품에 작업 영역 API 할당 작업 영역 수준 제품 사용
서비스 수준 태그에 작업 영역 API 또는 제품 할당 작업 영역 수준 태그 사용

도움말 및 지원 

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

자세한 정보

관련 콘텐츠

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