Azure Stack Hub'da Go ile API sürüm profillerini kullanma

  • Makale

Git ve sürüm profilleri

Profil, farklı hizmetlerden farklı sürümlere sahip farklı kaynak türlerinin birleşimidir. Profil kullanmak, farklı kaynak türleri arasında karıştırmanıza ve eşleştirmenize yardımcı olur. Profiller aşağıdaki avantajları sağlayabilir:

  • Belirli API sürümlerine kilitlenerek uygulamanız için kararlılık.
  • Uygulamanızın Azure Stack Hub ve bölgesel Azure veri merkezleriyle uyumluluğu.

Go SDK'sında profiller profil yolunun altında bulunur. Profil sürüm numaraları YYYY-AA-GG biçiminde etiketlenir. Örneğin, Azure Stack Hub API profil sürümü 2020-09-01 , Azure Stack Hub 2102 veya sonraki sürümleri içindir. Belirli bir hizmeti bir profilden içeri aktarmak için ilgili modülünü profilden içeri aktarın. Örneğin, İşlem hizmetini 2020-09-01 profilinden içeri aktarmak için aşağıdaki kodu kullanın:

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

Go için Azure SDK’yı yükleme

  1. Git'i yükleyin. Bkz . Başlarken - Git'i Yükleme.
  2. Go'u yükleyin. Azure için API profilleri Go sürüm 1.9 veya üzerini gerektirir. Bkz. Go programlama dili.

Profiller

Farklı bir SDK profili veya sürümü kullanmak için, tarihi gibi github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storagebir içeri aktarma deyiminde kullanın. Örneğin, 2008 sürümü için profil olur 2019-03-01ve dize olur github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. Bazen SDK ekibinin paketlerin adını değiştirdiğini unutmayın; bu nedenle bir dizenin tarihini farklı bir tarihle değiştirmek işe yaramayabilir. Profillerin ve Azure Stack sürümlerinin ilişkilendirmesi için aşağıdaki tabloya bakın.

Azure Stack sürümü Profil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020-09-01
2102 2020-09-01
2008 2019-03-01

Azure Stack Hub ve API profilleri hakkında daha fazla bilgi için bkz. API profillerinin özeti.

Bkz. Go SDK profilleri.

Abonelik

Henüz aboneliğiniz yoksa bir abonelik oluşturun ve daha sonra kullanmak üzere abonelik kimliğini kaydedin. Abonelik oluşturma hakkında bilgi için bu belgeye bakın.

Hizmet sorumlusu

Bir hizmet sorumlusu ve ilişkili ortam bilgileri oluşturulup bir yere kaydedilmelidir. Rolü olan owner hizmet sorumlusu önerilir, ancak örne bağlı olarak bir contributor rol yeterli olabilir. Gerekli değerler için örnek depodaki BENİOKU'ya bakın. Bu değerleri SDK dili tarafından desteklenen JSON dosyasından (örneklerimizin kullandığı) gibi herhangi bir biçimde okuyabilirsiniz. Çalıştırılan örne bağlı olarak, bu değerlerin tümü kullanılamaz. Güncelleştirilmiş örnek kod veya daha fazla bilgi için örnek depoya bakın.

Kiracı Kimliği

Azure Stack Hub'ınızın dizin veya kiracı kimliğini bulmak için bu makaledeki yönergeleri izleyin.

Kaynak sağlayıcılarını kaydetme

Bu belgeyi izleyerek gerekli kaynak sağlayıcılarını kaydedin. Çalıştırmak istediğiniz örneklere bağlı olarak bu kaynak sağlayıcıları gereklidir. Örneğin, bir VM örneği çalıştırmak istiyorsanız kaynak Microsoft.Compute sağlayıcısı kaydı gereklidir.

Azure Stack kaynak yöneticisi uç noktası

Azure Resource Manager (ARM), yöneticilerin Azure kaynaklarını dağıtmasını, yönetmesini ve izlemesini sağlayan bir yönetim çerçevesidir. Azure Resource Manager bu görevleri tek bir işlemde tek tek değil grup olarak işleyebilir. Meta veri bilgilerini Resource Manager uç noktasından alabilirsiniz. Uç nokta, kodunuzu çalıştırmak için gereken bilgileri içeren bir JSON dosyası döndürür.

  • Azure Stack Geliştirme Seti'ndeki (ASDK) ResourceManagerEndpointUrl : https://management.local.azurestack.external/.
  • Tümleşik sistemlerdeki ResourceManagerEndpointUrl şu şekildedir: https://management.region.<fqdn>/burada <fqdn> tam etki alanı adınızdır.
  • Gerekli meta verileri almak için: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Kullanılabilir API sürümleri için bkz. Azure rest API belirtimleri. Örneğin, 2020-09-01 profil sürümünde kaynak sağlayıcısı microsoft.resourcesiçin olarak değiştirebilirsiniz api-version2019-10-01.

Örnek JSON:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Örnekler

Güncel güncelleştirme örnek kodu için örnek depoya bakın. Kök README.md , genel gereksinimleri açıklar ve her alt dizin, bu örneğin nasıl çalıştırıldığına ilişkin belirli README.md bir örneği içerir.

Azure Stack sürümü 2008 veya profili 2019-03-01 için geçerli olan örnek için buraya bakın ve aşağıya bakın.

Sonraki adımlar

API profilleri hakkında daha fazla bilgi edinin: