Aracılığıyla paylaş

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

  • Makale

API profilleri, Azure kaynak sağlayıcısını ve Azure REST uç noktaları için 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önmeniz gerekir.

Bu konu size yardımcı olur:

  • 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.
  • Api profilleri, birden çok Azure bulutu arasında şablon oluşturmanız için oluşturulmuştur. Profiller uyumlu ve kararlı bir arabirim sağlar.
  • Profiller yılda dört kez yayınlanmaktadır.
  • Üç profil adlandırma kuralı kullanılır:
    • sonuncu
      Genel Azure'da yayınlanan 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 bulut genelinde 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:

sonuncu
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 ve 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 yayınlanır. 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 kullanıma sunulduğundan 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 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ıyorsanız, api-version 2016-03-30'u ve api-version 2015-12-01 ile Microsoft.Compute kaynak sağlayıcısını kullanan bir VM'yi destekleyen, Hangi PowerShell modülünün Depolama için 2016-03-30'u desteklediğini ve hangi modülün İşlem için 2015-02-01'i desteklediğini 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 profili kod örnekleri

Profilleri kullanarak çözümünüzü Azure Stack Hub ile tercih ettiğiniz dille 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. Daha fazla 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. Daha fazla bilgi için bkz . PowerShell için API sürüm profillerini kullanma.
  • Azure CLI
    Ortam yapılandırmanızı Azure Stack Hub'a özgü API sürümü profilini kullanacak şekilde güncelleştirin. Daha fazla 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, profillerin/yolun altında, sürümleri YYYY-AA-GG biçiminde bulunur. Bilgi için bkz . Go için API sürüm profillerini kullanma.
  • Python
    Python SDK'sı, Azure Stack Hub ve genel Azure gibi farklı bulut platformlarını hedeflemek için API sürüm profillerini destekler. Karma 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 . Node.js ile API sürümü Profillerini kullanma.

Sonraki adımlar