Azure Stack 허브에서 API 버전 프로필 관리Manage API version profiles in Azure Stack Hub

API 프로필은 azure REST 끝점에 대 한 Azure 리소스 공급자와 API 버전을 지정 합니다.API profiles specify the Azure resource provider and the API version for Azure REST endpoints. API 프로필을 사용 하 여 다른 언어로 사용자 지정 클라이언트를 만들 수 있습니다.You can create custom clients in different languages using API profiles. 각 클라이언트는 API 프로필을 사용 하 여 Azure Stack 허브에 대 한 올바른 리소스 공급자 및 API 버전에 연결 합니다.Each client uses an API profile to contact the correct resource provider and API version for Azure Stack Hub.

Azure Stack 허브와 호환 되는 각 리소스 공급자 API의 버전을 정확히 몰라도 Azure 리소스 공급자와 함께 작동 하는 앱을 만들 수 있습니다.You can create an app to work with Azure resource providers without having to know exactly which version of each resource provider API is compatible with Azure Stack Hub. 앱을 프로필에 정렬 하면 SDK가 올바른 API 버전으로 되돌아갑니다.Just align your app to a profile and the SDK reverts to the correct API version.

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

  • Azure Stack 허브에 대 한 API 프로필을 이해 합니다.Understand API profiles for Azure Stack Hub.
  • API 프로필을 사용 하 여 솔루션을 개발 하는 방법을 알아봅니다.Learn how you can use API profiles to develop your solutions.
  • 코드 관련 지침을 찾을 수 있는 위치를 참조 하세요.See where to find code-specific guidance.

API 프로필 요약Summary of API profiles

  • API 프로필은 Azure 리소스 공급자 및 해당 API 버전의 집합을 나타내는 데 사용 됩니다.API profiles are used to represent a set of Azure resource providers and their API versions.
  • API 프로필을 만들어 여러 Azure 클라우드에서 템플릿을 만들 수 있습니다.API profiles were created for you to create templates across multiple Azure clouds. 프로필은 호환 가능 하 고 안정적인 인터페이스를 제공 합니다.Profiles provide a compatible and stable interface.
  • 프로필은 1 년에 4 번 릴리스됩니다.Profiles are released four times a year.
  • 세 가지 프로필 명명 규칙이 사용 됩니다.Three profile naming conventions are used:
    • 최신latest
      에는 글로벌 Azure에서 릴리스된 최신 API 버전이 포함 되어 있습니다.Contains the most recent API versions released in global Azure.
    • yyyy-mm-dd-하이브리드yyyy-mm-dd-hybrid
      이 릴리스는 bi 매년 릴리스 되었으며 여러 클라우드의 일관성과 안정성을 중심으로 다룹니다.Released bi-annually, this release focuses on consistency and stability across multiple clouds. 이 프로필은 최적의 Azure Stack 허브 호환성을 대상으로 합니다.This profile targets optimal Azure Stack Hub compatibility.
    • yyyy-mm-dd-프로필yyyy-mm-dd-profile
      최적의 안정성과 최신 기능을 분산 합니다.Balances optimal stability and the latest features.

Azure API 프로필 및 Azure Stack 허브 호환성Azure API profiles and Azure Stack Hub compatibility

최신 Azure API 프로필은 Azure Stack 허브와 호환 되지 않습니다.The newest Azure API profiles are not compatible with Azure Stack Hub. 다음 명명 규칙을 사용 하 여 Azure Stack 허브 솔루션에 사용할 프로필을 식별 합니다.Use the following naming conventions to identify which profiles to use for your Azure Stack Hub solutions:

최신Latest
이 프로필에는 Azure Stack 허브에서 작동 하지 않는 글로벌 Azure에 있는 최신 API 버전이 있습니다.This profile has the most up-to-date API versions found in global Azure, which do not work in Azure Stack Hub. 최신 버전 에는 주요 변경 내용이 가장 많이 있습니다.Latest has the largest number of breaking changes. 프로필은 다른 클라우드와의 안정성과 호환성을 확보 합니다.The profile puts aside stability and compatibility with other clouds. 최신 API 버전을 사용 하려는 경우 최신 프로필을 사용 해야 합니다.If you're trying to use the most up-to-date API versions, Latest is the profile you should use.

Yyyy-mm-dd-하이브리드Yyyy-mm-dd-hybrid
이 프로필은 매년 3 월과 9 월에 릴리스됩니다.This profile is released in March and September every year. 이는 다양 한 클라우드와 최적의 안정성과 호환성을 가지 며 글로벌 Azure 및 Azure Stack 허브를 대상으로 하도록 설계 되었습니다.It has optimal stability and compatibility with various clouds, and is designed to target global Azure and Azure Stack Hub. 이 프로필에 나열 된 Azure API 버전은 Azure Stack Hub에 나열 된 것과 동일 합니다.The Azure API versions listed in this profile will be the same as the ones that are listed in Azure Stack Hub. 이 프로필을 사용 하 여 하이브리드 클라우드 솔루션에 대 한 코드를 개발 합니다.Use this profile to develop code for hybrid cloud solutions.

yyyy-mm-dd-프로필yyyy-mm-dd-profile
이 프로필은 6 월 및 12 월에 글로벌 Azure에 대해 릴리스됩니다.This profile is released for global Azure in June and December. Azure Stack 허브에서는 작동 하지 않으며 일반적으로 많은 주요 변경 사항이 있습니다.It does not work with Azure Stack Hub, and there will typically be many breaking changes. 최적 안정성과 최신 기능을 균형 있게 하지만 최신 프로필과이 프로필 간의 차이점최신 이 api가 릴리스된 시기에 관계 없이 항상 최신 API 버전으로 구성 된다는 것입니다.Although it balances optimal stability and the latest features, the difference between Latest and this profile is that Latest always consists of the newest API versions, regardless of when the API is released. 예를 들어, 계산 API에 대 한 새 API 버전이 내일 생성 되는 경우이 프로필이 이미 존재 하기 때문에 해당 API 버전이 최신 버전에는 표시 되지만 yyyy-mm-dd 프로필 프로필에는 표시 되지 않습니다.For example, if a new API version is created for the Compute API tomorrow, that API version is listed in the Latest, but not in the yyyy-mm-dd-profile profile, because this profile already exists. yyyy-mm-dd 프로필 은 12 월 이전 또는 12 월 이전에 출시 된 최신 버전을 포함 합니다.yyyy-mm-dd-profile covers the most up-to-date versions released before June or before December.

Azure Resource Manager API 프로필Azure Resource Manager API profiles

Azure Stack 허브는 글로벌 Azure에 있는 최신 버전의 API 버전을 사용 하지 않습니다.Azure Stack Hub does not use the latest version of the API versions found in global Azure. 솔루션을 만들 때 Azure Stack 허브와 호환 되는 각 Azure 리소스 공급자에 대 한 API 버전을 찾아야 합니다.When you create a solution, you must find the API version for each Azure resource provider that is compatible with Azure Stack Hub.

모든 리소스 공급자와 Azure Stack 허브가 지 원하는 특정 버전을 조사 하는 대신 API 프로필을 사용할 수 있습니다.Rather than research every resource provider and the specific version supported by Azure Stack Hub, you can use an API profile. 프로필은 리소스 공급자 및 API 버전의 집합을 지정 합니다.The profile specifies a set of resource providers and API versions. Sdk 또는 SDK로 빌드된 도구는 프로필에 지정 된 대상으로 되돌아갑니다 api-version .The SDK, or a tool built with the SDK, will revert to the target api-version specified in the profile. API 프로필을 사용 하 여 전체 템플릿에 적용 되는 프로필 버전을 지정할 수 있습니다.With API profiles, you can specify a profile version that applies to an entire template. 런타임에 Azure Resource Manager는 리소스의 올바른 버전을 선택 합니다.At runtime, the Azure Resource Manager selects the right version of the resource.

API 프로필은 PowerShell, Azure CLI, SDK에서 제공 되는 코드 및 Microsoft Visual Studio와 같은 Azure Resource Manager를 사용 하는 도구와 함께 작동 합니다.API profiles work with tools that use Azure Resource Manager, such as PowerShell, Azure CLI, code provided in the SDK, and Microsoft Visual Studio. 도구 및 Sdk는 프로필을 사용 하 여 앱을 빌드할 때 포함할 모듈 및 라이브러리 버전을 읽을 수 있습니다.Tools and SDKs can use profiles to read which version of the modules and libraries to include when building an app.

예를 들어 microsoft. storage 리소스 공급자를 사용 하 여 api 버전 2016-03-30 및 VM을 지 원하는 microsoft. storage 리소스 공급자를 사용 하 여 저장소 계정을 만드는 경우 powershell을 사용 하 여 api 버전 2015-12-01을 사용 하는 경우에는 powershell 모듈에서 저장소에 대 한 2016-03-30을 지원 하 고 어떤 모듈이 계산에 대해 2015-02-01을 지원 하는지 확인 한 후 설치 해야 합니다.For example, if you use PowerShell to create a storage account using the Microsoft.Storage resource provider, which supports api-version 2016-03-30 and a VM using the Microsoft.Compute resource provider with api-version 2015-12-01, you must look up which PowerShell module supports 2016-03-30 for Storage, and which module supports 2015-02-01 for Compute, and then install them. 대신 프로필을 사용할 수 있습니다.Instead, you can use a profile. Cmdlet을 사용 하면 Install-Profile <profilename> PowerShell에서 올바른 버전의 모듈을 로드 합니다.Use the cmdlet Install-Profile <profilename>, and PowerShell loads the correct version of the modules.

마찬가지로 python SDK를 사용 하 여 Python 기반 앱을 빌드하는 경우 프로필을 지정할 수 있습니다.Similarly, when using the Python SDK to build a Python-based app, you can specify the profile. SDK는 스크립트에 지정 된 리소스 공급자에 대 한 올바른 모듈을 로드 합니다.The SDK loads the right modules for the resource providers that you've specified in your script.

개발자는 솔루션 작성에 집중할 수 있습니다.As a developer, you can focus on writing your solution. API 버전, 리소스 공급자 및 클라우드를 함께 사용 하는 방법을 조사 하는 대신 프로필을 사용 하 여 해당 프로필을 지 원하는 모든 클라우드에서 코드가 작동 하는지 확인할 수 있습니다.Instead of researching which API versions, resource provider, and cloud work together, you can use a profile and know that your code works across all clouds that support that profile.

API 프로필 코드 샘플API profile code samples

프로필을 사용 하 여 Azure Stack 허브와 솔루션을 선호 하는 언어와 통합 하는 데 도움이 되는 코드 샘플을 찾을 수 있습니다.You can find code samples to help you integrate your solution with your preferred language with Azure Stack Hub by using profiles. 현재 다음 언어에 대 한 지침과 예제를 찾을 수 있습니다.Currently, you can find guidance and samples for the following languages:

  • .NET.NET
    .NET API 프로필을 사용 하 여 리소스 공급자 패키지에서 각 리소스 종류의 가장 안정적인 최신 버전을 가져옵니다.Use the .NET API profile to get the latest, most stable version of each resource type in a resource provider package. 자세한 내용은 Azure Stack Hub의 .net에서 API 버전 프로필 사용을 참조 하세요.For more information, see Use API version profiles with .NET in Azure Stack Hub.
  • PowerShellPowerShell
    PowerShell 갤러리를 통해 사용할 수 있는 Az module을 사용 하 여 API 버전 프로필 작업에 필요한 PowerShell cmdlet을 가져옵니다.Use the Az.Bootstrapper module available through the PowerShell Gallery to get the PowerShell cmdlets required to work with API version profiles. 자세한 내용은 PowerShell에 API 버전 프로필 사용을 참조 하세요.For information, see Use API version profiles for PowerShell. PowerShell 갤러리를 통해 제공 되는 AzureRM 모듈을 사용 하 여 API 버전 프로필 작업에 필요한 PowerShell cmdlet을 가져옵니다.Use the AzureRM.Bootstrapper module available through the PowerShell Gallery to get the PowerShell cmdlets required to work with API version profiles. 자세한 내용은 PowerShell에 API 버전 프로필 사용을 참조 하세요.For information, see Use API version profiles for PowerShell.
  • Azure CLIAzure CLI
    Azure Stack 허브 특정 API 버전 프로필을 사용 하도록 환경 구성을 업데이트 합니다.Update your environment configuration to use the Azure Stack Hub specific API version profile. 자세한 내용은 Azure CLI에 API 버전 프로필 사용을 참조 하세요.For information, see Use API version profiles for Azure CLI.
  • GoGo
    Go SDK에서 프로필은 서로 다른 서비스와 다른 여러 버전의 리소스 유형을 조합한 것입니다.In the Go SDK, a profile is a combination of different resource types with different versions from different services. 프로필/경로에서 해당 버전을 yyyy-mm-dd 형식으로 사용할 수 있습니다.Profiles are available under the profiles/path with their version in the YYYY-MM-DD format. 자세한 내용은 Go에 대 한 API 버전 프로필 사용을 참조 하세요.For information, see Use API version profiles for Go.
  • RubyRuby
    Azure Stack 허브 리소스 관리자 Ruby SDK는 인프라를 구축 하 고 관리 하는 데 도움이 되는 도구를 제공 합니다.The Ruby SDK for the Azure Stack Hub Resource Manager provides tools to help you build and manage your infrastructure. SDK의 리소스 공급자에는 계산, 가상 네트워크 및 Ruby 언어가 포함 된 저장소가 포함 됩니다.Resource providers in the SDK include compute, virtual networks, and storage with the Ruby language. 자세한 내용은 Ruby를 사용 하 여 API 버전 프로필 사용을 참조 하세요.For information, see Use API version profiles with Ruby.
  • PythonPython
    Python SDK는 Azure Stack 허브, 글로벌 Azure 등의 다양 한 클라우드 플랫폼을 대상으로 하는 API 버전 프로필을 지원 합니다.The Python SDK supports API version profiles to target different cloud platforms such as Azure Stack Hub and global Azure. API 프로필을 사용 하 여 하이브리드 클라우드에 대 한 솔루션을 만듭니다.Use API profiles to create solutions for a hybrid cloud. 자세한 내용은 Python에서 API 버전 프로필 사용을 참조 하세요.For information, see Use API version profiles with Python.
  • Node.jsNode.js
    Azure Stack 허브 리소스 관리자 Node.js SDK는 인프라를 빌드하고 관리 하는 데 도움이 되는 도구를 제공 합니다.The Node.js SDK for the Azure Stack Hub Resource Manager provides tools to help you build and manage your infrastructure. 자세한 내용은 Node.js에 API 버전 프로필 사용 을 참조 하세요.For more information, see Use API version Profiles with Node.js.

다음 단계Next steps