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

Makale
10/30/2024

Önemli

.NET SDK'sı 1. izden 2'ye güncelleştirildi. En kısa sürede track 2 SDK'sına geçiş gerçekleştirmenizi kesinlikle öneririz. Yönergeler için lütfen bu geçiş kılavuzuna bakın.

Azure Stack Hub Resource Manager için .NET SDK'sı, 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 İşlem, Ağ, Depolama, Uygulama Hizmetleri ve Key Vault bulunur. .NET SDK'sı 14 NuGet paketi içerir. Kullanım dışı izleme 1 .NET SDK'sını kullanıyorsanız (önerilmez), bu paketler 2020-09-01-hybrid ve 2019-03-01-hybrid gibi API profilleriyle sürümlenir. .NET SDK'sı içindeki API profilleri, genel Azure kaynaklarıyla Azure Stack Hub kaynakları arasında geçiş yapmanıza yardımcı olarak hibrit bulut geliştirmeye olanak tanır. Daha fazla bilgi için .NET ve API sürüm profilleri bölümüne bakın.

Azure .NET SDK'sını yükleme

Git'i yükleyin. Yönergeler için bkz . Başlarken - Git'i Yükleme.
Doğru NuGet paketlerini yüklemek için bkz . Kullanılabilir NuGet Dağıtım Sürümleri.

.NET ve API sürümü profilleri

API profili, kaynak sağlayıcıları ve API sürümlerinin birleşimidir. Bir kaynak sağlayıcısı paketindeki her kaynak türünün en son, en kararlı sürümünü almak için bir API profili kullanın.

track 2 .NET SDK'sını kullanıyorsanız (önerilen), standart Azure.* paketleri kullanabilir ve kodunuzda API sürümlerini yapılandırabilirsiniz. Bunun örnekleri ve standart Azure.* paketler için bu sorgu için örnekler bölümüne bakın.
İzleme 1 .NET SDK'sını kullanıyorsanız (önerilmez), Azure Stack Hub hizmetlerinizden yararlanmak için aşağıdaki paketlerden birini indirmeniz gerekir. API profilinize karşılık geleni indirdiğinizden emin olun:
- Microsoft.Azure.Management.Profiles.hybrid_2020_09_01.<ResourceProvider>. 1.0.0.nupkg
- Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.<ResourceProvider>. 0.9.0-preview.nupkg

Not

NuGet paket belirtiminin ResourceProvider bölümü değiştirilmelidir. Ayrıca, izleme 1 .NET SDK'sı paketleri kullanım dışı bırakıldığından hatalarla karşılaşabilirsiniz. En kısa sürede izleme 2 .NET SDK'sına güncelleştirmenizi öneririz.

Profiller

Tarih içeren profiller için farklı bir SDK profili veya sürümü kullanmak için içindeki tarihi Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManageryazın. Örneğin, 2008 sürümü için profil olur 2019_03_01ve dize olur Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. SDK ekibinin bazen paketlerin adını değiştirdiğini, bu nedenle bir dizenin tarihini farklı bir tarihle değiştirmenin çalışmayabileceğini unutmayın. 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.

Abonelik

Henüz bir 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 BIR JSON dosyasından (örneklerimizin kullandığı gibi) SDK dili tarafından desteklenen herhangi bir biçimde okuyabilirsiniz. Çalıştırılmakta olan ö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 resource manager 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 sistemlerde 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 (izleme 2) örnek kodu için bu örnek depoya bakın. 1 . örnek kodu izlemek için bu ö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ığını açıklayan kendi README.md örneğiyle birlikte belirli 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 ve aşağıya bakın.

Sonraki adımlar

API profilleri hakkında daha fazla bilgi edinin:

Aracılığıyla paylaş