Azure Stack Hub에서 API 버전 프로필 관리

  • 아티클

API 프로필은 Azure REST 엔드포인트에 대한 Azure 리소스 공급자 및 API 버전을 지정합니다. API 프로필을 사용하여 다양한 언어로 사용자 지정 클라이언트를 만들 수 있습니다. 각 클라이언트는 API 프로필을 사용하여 Azure Stack Hub에 대한 올바른 리소스 공급자 및 API 버전에 연결합니다.

Azure Stack Hub와 호환되는 각 리소스 공급자 API 버전을 정확히 알 필요 없이 Azure 리소스 공급자와 함께 작동하는 앱을 만들 수 있습니다. 앱을 프로필에 맞추면 SDK가 올바른 API 버전으로 되돌아갑니다.

이 항목의 정보를 참조하면 다음 작업을 수행할 수 있습니다.

  • Azure Stack Hub에 대한 API 프로필을 이해합니다.
  • API 프로필을 사용하여 솔루션을 개발하는 방법을 알아봅니다.
  • 코드별 지침을 찾을 수 있는 위치를 참조하세요.

API 프로필 요약

  • API 프로필은 Azure 리소스 공급자 및 해당 API 버전 집합을 나타내는 데 사용됩니다.
  • 여러 Azure 클라우드에서 템플릿을 만들 수 있도록 API 프로필이 만들어졌습니다. 프로필은 호환되고 안정적인 인터페이스를 제공합니다.
  • 프로필은 일년에 네 번 릴리스됩니다.
  • 세 가지 프로필 명명 규칙이 사용됩니다.
    • 최신
      글로벌 Azure에서 릴리스된 최신 API 버전을 포함합니다.
    • yyyy-mm-dd-hybrid
      격년으로 릴리스된 이 릴리스는 여러 클라우드의 일관성과 안정성에 중점을 둡니다. 이 프로필은 최적의 Azure Stack Hub 호환성을 대상으로 합니다.
    • yyyy-mm-dd-profile
      최적의 안정성과 최신 기능의 균형을 조정합니다.

Azure API 프로필 및 Azure Stack Hub 호환성

최신 Azure API 프로필은 Azure Stack Hub와 호환되지 않습니다. 다음 명명 규칙을 사용하여 Azure Stack Hub 솔루션에 사용할 프로필을 식별합니다.

최신
이 프로필에는 Azure Stack Hub에서 작동하지 않는 글로벌 Azure에 있는 최신 API 버전이 있습니다. 최신 에는 가장 많은 호환성이 손상되는 변경이 있습니다. 프로필은 다른 클라우드와의 안정성 및 호환성을 제쳐 놓습니다. 최신 API 버전을 사용하려는 경우 최신 은 사용해야 하는 프로필입니다.

Yyyy-mm-dd-hybrid
이 프로필은 매년 3월과 9월에 릴리스됩니다. 다양한 클라우드와의 최적의 안정성 및 호환성을 제공하며 글로벌 Azure 및 Azure Stack Hub를 대상으로 하도록 설계되었습니다. 이 프로필에 나열된 Azure API 버전은 Azure Stack Hub에 나열된 버전과 동일합니다. 이 프로필을 사용하여 하이브리드 클라우드 솔루션에 대한 코드를 개발합니다.

yyyy-mm-dd-profile
이 프로필은 6월과 12월에 글로벌 Azure에 대해 릴리스됩니다. Azure Stack Hub에서는 작동하지 않으며 일반적으로 많은 호환성이 손상되는 변경이 있습니다. 최적의 안정성과 최신 기능의 균형을 맞추지만 최신 프로필과 이 프로필의 차이점은 API가 출시되는 시기에 관계없이 항상 최신 API 버전으로 구성된다는 점입니다. 예를 들어 내일 Compute API에 대한 새 API 버전이 만들어지면 해당 API 버전은 최신 버전에 나열되지만 이 프로필은 이미 존재하기 때문에 yyyy-mm-dd-profile 프로필에는 나열되지 않습니다. yyyy-mm-dd-profile 은 6월 또는 12월 이전에 릴리스된 최신 버전을 다룹니다.

Azure Resource Manager API 프로필

Azure Stack Hub는 글로벌 Azure에 있는 최신 버전의 API 버전을 사용하지 않습니다. 솔루션을 만들 때 Azure Stack Hub와 호환되는 각 Azure 리소스 공급자에 대한 API 버전을 찾아야 합니다.

모든 리소스 공급자와 Azure Stack Hub에서 지원하는 특정 버전을 조사하는 대신 API 프로필을 사용할 수 있습니다. 프로필은 리소스 공급자 및 API 버전 집합을 지정합니다. SDK 또는 SDK로 빌드된 도구는 프로필에 지정된 대상 api-version 에 되돌리기. API 프로필을 사용하면 전체 템플릿에 적용되는 프로필 버전을 지정할 수 있습니다. 런타임 시 Azure Resource Manager 적절한 버전의 리소스를 선택합니다.

API 프로필은 PowerShell, Azure CLI, SDK에 제공된 코드 및 Microsoft Visual Studio와 같은 Azure Resource Manager 사용하는 도구에서 작동합니다. 도구 및 SDK는 프로필을 사용하여 앱을 빌드할 때 포함할 모듈 및 라이브러리의 버전을 읽을 수 있습니다.

예를 들어 PowerShell을 사용하여 Microsoft.Storage 리소스 공급자를 사용하여 스토리지 계정을 만드는 경우 api-version 2015-12-01에서 Microsoft.Compute 리소스 공급자를 사용하여 api-version 2016-03-30 및 VM을 지원하는 경우 스토리지용 2016-03-30을 지원하는 PowerShell 모듈과 Compute용 2015-02-01을 지원하는 모듈을 조회한 다음 설치해야 합니다. 대신 프로필을 사용할 수 있습니다. cmdlet Install-Profile <profilename>을 사용하고 PowerShell은 올바른 버전의 모듈을 로드합니다.

마찬가지로 Python SDK를 사용하여 Python 기반 앱을 빌드할 때 프로필을 지정할 수 있습니다. SDK는 스크립트에서 지정한 리소스 공급자에 적합한 모듈을 로드합니다.

개발자는 솔루션 작성에 집중할 수 있습니다. 어떤 API 버전, 리소스 공급자 및 클라우드가 함께 작동하는지 조사하는 대신 프로필을 사용하고 해당 프로필을 지원하는 모든 클라우드에서 코드가 작동한다는 것을 알 수 있습니다.

API 프로필 코드 샘플

프로필을 사용하여 솔루션을 Azure Stack Hub와 기본 설정 언어와 통합하는 데 도움이 되는 코드 샘플을 찾을 수 있습니다. 현재 다음 언어에 대한 지침 및 샘플을 찾을 수 있습니다.

다음 단계