Azure Stack Hub'da API sürümü profillerini yönetme

  • Makale

API profilleri, Azure rest uç noktaları için Azure kaynak sağlayıcısını ve API sürümünü belirtir. API profillerini kullanarak farklı dillerde özel istemciler oluşturabilirsiniz. Her istemci, Azure Stack Hub için doğru kaynak sağlayıcısına ve API sürümüne başvurmak için bir API profili kullanır.

Her kaynak sağlayıcısı API'sinin Azure Stack Hub ile tam olarak hangi sürümünün uyumlu olduğunu bilmek zorunda kalmadan Azure kaynak sağlayıcılarıyla çalışacak bir uygulama oluşturabilirsiniz. Uygulamanızı bir profile hizalamanız ve SDK'nın doğru API sürümüne geri döndürmesi gerekir.

Bu konuda aşağıdaki başlıklarla ilgili yardım sağlanır:

  • Azure Stack Hub için API profillerini anlama.
  • Çözümlerinizi geliştirmek için API profillerini nasıl kullanabileceğinizi öğrenin.
  • Koda özgü yönergelerin nerede bulunacağı konusunda bilgi edinin.

API profillerinin özeti

  • API profilleri, bir dizi Azure kaynak sağlayıcısını ve bunların API sürümlerini temsil etmek için kullanılır.
  • Birden çok Azure bulutu arasında şablon oluşturmanız için API profilleri oluşturuldu. Profiller uyumlu ve kararlı bir arabirim sağlar.
  • Profiller yılda dört kez yayınlanıyor.
  • Üç profil adlandırma kuralı kullanılır:
    • Son
      Genel Azure'da yayımlanan en son API sürümlerini içerir.
    • yyyy-mm-dd-hybrid
      Her yıl iki kez yayımlanan bu sürüm, birden çok bulutta tutarlılık ve kararlılık konusuna odaklanır. Bu profil en iyi Azure Stack Hub uyumluluğunu hedefler.
    • yyyy-mm-dd-profile
      En iyi kararlılığı ve en son özellikleri dengeler.

Azure API profilleri ve Azure Stack Hub uyumluluğu

En yeni Azure API profilleri Azure Stack Hub ile uyumlu değildir. Azure Stack Hub çözümleriniz için hangi profillerin kullanılacağını belirlemek için aşağıdaki adlandırma kurallarını kullanın:

Son
Bu profil, Azure Stack Hub'da çalışmayan genel Azure'da bulunan en güncel API sürümlerine sahiptir. en son , en fazla hataya neden olan değişiklik sayısına sahiptir. Profil, diğer bulutlarla kararlılığı ve uyumluluğu bir kenara bırakır. En güncel API sürümlerini kullanmaya çalışıyorsanız, kullanmanız gereken profil en son sürümdür.

Yyyy-mm-dd-hybrid
Bu profil her yıl Mart ve Eylül aylarında yayınlanır. Çeşitli bulutlarla en iyi kararlılığı ve uyumluluğu sağlar ve genel Azure ile Azure Stack Hub'ı hedeflemek için tasarlanmıştır. Bu profilde listelenen Azure API sürümleri, Azure Stack Hub'da listelenenlerle aynı olacaktır. Hibrit bulut çözümleri için kod geliştirmek için bu profili kullanın.

yyyy-mm-dd-profile
Bu profil, Haziran ve Aralık aylarında genel Azure için kullanıma sunulmuştur. Azure Stack Hub ile çalışmaz ve genellikle birçok hataya neden olan değişiklik olur. En iyi kararlılığı ve en son özellikleri dengelese de, en son ile bu profil arasındaki fark, API'nin ne zaman yayımlandığından bağımsız olarak en son sürümün her zaman en yeni API sürümlerinden oluşmasıdır. Örneğin, yarın İşlem API'si için yeni bir API sürümü oluşturulursa bu API sürümü en son sürümde listelenir, ancak bu profil zaten mevcut olduğundan yyyy-mm-dd-profile profilinde listelenmez. yyyy-mm-dd-profile , Haziran'dan önce veya Aralık'tan önce yayınlanan en güncel sürümleri kapsar.

Azure Resource Manager API profilleri

Azure Stack Hub, genel Azure'da bulunan API sürümlerinin en son sürümünü kullanmaz. Bir çözüm oluşturduğunuzda, Azure Stack Hub ile uyumlu her Azure kaynak sağlayıcısı için API sürümünü bulmanız gerekir.

Her kaynak sağlayıcısını ve Azure Stack Hub tarafından desteklenen belirli bir sürümü araştırmak yerine bir API profili kullanabilirsiniz. Profil, bir dizi kaynak sağlayıcısını ve API sürümünü belirtir. SDK veya SDK ile oluşturulan bir araç, profilde belirtilen hedefe api-version geri döner. API profilleriyle, şablonun tamamı için geçerli olan bir profil sürümü belirtebilirsiniz. Çalışma zamanında Azure Resource Manager kaynağın doğru sürümünü seçer.

API profilleri PowerShell, Azure CLI, SDK'da sağlanan kod ve Microsoft Visual Studio gibi Azure Resource Manager kullanan araçlarla çalışır. Araçlar ve SDK'lar, uygulama oluştururken modüllerin ve kitaplıkların hangi sürümünün dahil kullanılacağını okumak için profilleri kullanabilir.

Örneğin, Microsoft.Storage kaynak sağlayıcısını kullanarak bir depolama hesabı oluşturmak için PowerShell kullanırsanız, Api-version 2015-12-01 ile Microsoft.Compute kaynak sağlayıcısını kullanan api-version 2016-03-30'u ve bir VM'yi destekleyen, Depolama için 2016-03-30'u destekleyen PowerShell modülünü ve İşlem için 2015-02-01'i destekleyen modülü aramanız ve sonra bunları yüklemeniz gerekir. Bunun yerine bir profil kullanabilirsiniz. cmdlet'ini Install-Profile <profilename>kullandığınızda PowerShell modüllerin doğru sürümünü yükler.

Benzer şekilde, Python tabanlı bir uygulama oluşturmak için Python SDK'sını kullanırken profili belirtebilirsiniz. SDK, betiğinizde belirttiğiniz kaynak sağlayıcıları için doğru modülleri yükler.

Geliştirici olarak bu, çözümünüzü yazmaya odaklanabileceğiniz anlamına gelir. Hangi API sürümlerinin, kaynak sağlayıcısının ve bulutun birlikte çalıştığını araştırmak yerine bir profil kullanabilir ve kodunuzun bu profili destekleyen tüm bulutlarda çalıştığını bilirsiniz.

API profil kodu örnekleri

Profilleri kullanarak çözümünüzü tercih ettiğiniz dille Azure Stack Hub ile tümleştirmenize yardımcı olacak kod örnekleri bulabilirsiniz. Şu anda aşağıdaki diller için rehberlik ve örnekler bulabilirsiniz:

  • .NET
    Bir kaynak sağlayıcısı paketindeki her kaynak türünün en son, en kararlı sürümünü almak için .NET API profilini kullanın. Daha fazla bilgi için bkz. Azure Stack Hub'da .NET ile API sürümü profillerini kullanma.
  • PowerShell
    API sürüm profilleriyle çalışmak için gereken PowerShell cmdlet'lerini almak için PowerShell Galerisi aracılığıyla sağlanan Az.Bootstrapper modülünü kullanın. Bilgi için bkz. PowerShell için API sürüm profillerini kullanma. API sürüm profilleriyle çalışmak için gereken PowerShell cmdlet'lerini almak için PowerShell Galerisi aracılığıyla sağlanan AzureRM.Bootstrapper modülünü kullanın. Bilgi için bkz. PowerShell için API sürüm profillerini kullanma.
  • Azure CLI
    Azure Stack Hub'a özgü API sürümü profilini kullanmak için ortam yapılandırmanızı güncelleştirin. Bilgi için bkz. Azure CLI için API sürüm profillerini kullanma.
  • Git
    Go SDK'sında profil, farklı hizmetlerden farklı sürümlere sahip farklı kaynak türlerinin birleşimidir. Profiller, profiller/yol altında YYYY-AA-GG biçimindeki sürümleriyle birlikte kullanılabilir. Bilgi için bkz. Go için API sürüm profillerini kullanma.
  • Ruby
    Azure Stack Hub Resource Manager için Ruby SDK, altyapınızı oluşturmanıza ve yönetmenize yardımcı olacak araçlar sağlar. SDK'daki kaynak sağlayıcıları arasında Ruby diliyle işlem, sanal ağlar ve depolama yer alır. Bilgi için bkz. Ruby ile API sürüm profillerini kullanma.
  • Python
    Python SDK, Azure Stack Hub ve genel Azure gibi farklı bulut platformlarını hedeflemek için API sürüm profillerini destekler. Hibrit buluta yönelik çözümler oluşturmak için API profillerini kullanın. Bilgi için bkz. Python ile API sürüm profillerini kullanma.
  • Node.js
    Azure Stack Hub Resource Manager için Node.js SDK'sı, altyapınızı oluşturmanıza ve yönetmenize yardımcı olacak araçlar sağlar. Daha fazla bilgi için bkz. api sürümü profillerini Node.jsile kullanma .

Sonraki adımlar