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 프로필이 만들어졌습니다. 프로필은 호환되고 안정적인 인터페이스를 제공합니다.
- 프로필은 일년에 네 번 릴리스됩니다.
- 세 가지 프로필 명명 규칙이 사용됩니다.
- latest
글로벌 Azure에서 릴리스된 최신 API 버전을 포함합니다. - yyyy-mm-dd-hybrid
격년으로 릴리스된 이 릴리스는 여러 클라우드의 일관성과 안정성에 중점을 둡니다. 이 프로필은 최적의 Azure Stack Hub 호환성을 대상으로 합니다. - yyyy-mm-dd-profile
최적의 안정성과 최신 기능의 균형을 조정합니다.
- latest
Azure API 프로필 및 Azure Stack Hub 호환성
최신 Azure API 프로필은 Azure Stack Hub와 호환되지 않습니다. 다음 명명 규칙을 사용하여 Azure Stack Hub 솔루션에 사용할 프로필을 식별합니다.
latest
이 프로필에는 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을 지원하는 PowerShell 모듈은 Storage용 2016-03-30을 지원하고 컴퓨팅에 대해 2015-02-01을 지원하는 모듈을 조회한 다음 설치해야 합니다. 대신 프로필을 사용할 수 있습니다. cmdlet Install-Profile <profilename>을 사용하고 PowerShell은 올바른 버전의 모듈을 로드합니다.
마찬가지로 Python SDK를 사용하여 Python 기반 앱을 빌드하는 경우 프로필을 지정할 수 있습니다. SDK는 스크립트에서 지정한 리소스 공급자에 적합한 모듈을 로드합니다.
개발자는 솔루션 작성에 집중할 수 있습니다. 어떤 API 버전, 리소스 공급자 및 클라우드가 함께 작동하는지 조사하는 대신 프로필을 사용하고 해당 프로필을 지원하는 모든 클라우드에서 코드가 작동한다는 것을 알 수 있습니다.
API 프로필 코드 샘플
프로필을 사용하여 Azure Stack Hub와 솔루션을 기본 설정 언어와 통합하는 데 도움이 되는 코드 샘플을 찾을 수 있습니다. 현재 다음 언어에 대한 지침 및 샘플을 찾을 수 있습니다.
- .NET
.NET API 프로필을 사용하여 리소스 공급자 패키지에서 각 리소스 유형의 가장 안정적인 최신 버전을 가져옵니다. 자세한 내용은 Azure Stack Hub에서 .NET과 함께 API 버전 프로필 사용을 참조하세요. - PowerShell
PowerShell 갤러리 통해 사용할 수 있는 Az.Bootstrapper 모듈을 사용하여 API 버전 프로필을 사용하는 데 필요한 PowerShell cmdlet을 가져옵니다. 자세한 내용은 PowerShell에 대한 API 버전 프로필 사용을 참조하세요. PowerShell 갤러리 통해 사용할 수 있는 AzureRM.Bootstrapper 모듈을 사용하여 API 버전 프로필을 사용하는 데 필요한 PowerShell cmdlet을 가져옵니다. 자세한 내용은 PowerShell에 대한 API 버전 프로필 사용을 참조하세요. - Azure CLI
Azure Stack Hub 특정 API 버전 프로필을 사용하도록 환경 구성을 업데이트합니다. 자세한 내용은 Azure CLI에 대한 API 버전 프로필 사용을 참조하세요. - Go
Go SDK에서 프로필은 서로 다른 서비스와 다른 버전이 있는 다양한 리소스 유형의 조합입니다. 프로필은 YYYY-MM-DD 형식의 해당 버전이 있는 프로필/경로에서 사용할 수 있습니다. 자세한 내용은 Go용 API 버전 프로필 사용을 참조 하세요. - Python
Python SDK는 Azure Stack Hub 및 글로벌 Azure와 같은 다양한 클라우드 플랫폼을 대상으로 하는 API 버전 프로필을 지원합니다. API 프로필을 사용하여 하이브리드 클라우드에 대한 솔루션을 만듭니다. 자세한 내용은 Python에서 API 버전 프로필 사용을 참조 하세요. - Node.js
Azure Stack Hub Resource Manager용 Node.js SDK는 인프라를 빌드하고 관리하는 데 도움이 되는 도구를 제공합니다. 자세한 내용은 Node.js API 버전 프로필 사용을 참조하세요.