Öğretici: Azure Data Box Blob depolama alanına veri kopyalamak için REST API'lerini kullanma

Önemli

Azure Data Box artık blob düzeyinde erişim katmanı atamasını destekliyor. Bu öğreticide yer alan adımlar güncelleştirilmiş veri kopyalama işlemini yansıtır ve blok bloblarına özeldir.

Blok blob verileriniz için uygun erişim katmanını belirleme konusunda yardım için Blok blobları için uygun erişim katmanlarını belirleme bölümüne bakın. Verilerinizi uygun erişim katmanına kopyalamak için Data Box'a veri kopyalama bölümünde yer alan adımları izleyin.

Bu bölümde yer alan bilgiler 1 Nisan 2024'e kadar verilen siparişler için geçerlidir.

Dikkat

Bu makale, Kullanım Süresi Sonu (EOL) durumu olan bir Linux dağıtımı olan CentOS'a başvurur. Lütfen kullanımınızı ve buna uygun planlamayı göz önünde bulundurun. Daha fazla bilgi için bkz . CentOS Kullanım Süresi Sonu kılavuzu.

Bu öğreticide, http veya https üzerinden REST API'leri aracılığıyla Azure Data Box Blob depolamaya bağlanma yordamları açıklanmaktadır. Bağlandıktan sonra, verileri Data Box Blob depolama alanına kopyalamak ve Data Box'ı göndermeye hazırlamak için gereken adımlar da açıklanır.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

• Önkoşullar
• Http veya https üzerinden Data Box Blob depolamaya bağlanma
• Data Box'a veri kopyalama

Önkoşullar

Başlamadan önce aşağıdakilerden emin olun:

1. Öğretici: Azure Data Box'ın kurulumunu tamamladınız.
2. Data Box'ınızı alırsınız ve portaldaki sipariş durumu Teslim Edildi'dir.
3. Data Box Blob depolama için sistem gereksinimlerini gözden geçirirsiniz ve API'lerin, SDK'ların ve araçların desteklenen sürümleri hakkında bilgi sahibi olursunuz.
4. Data Box'a kopyalamak istediğiniz verileri içeren bir konak bilgisayara erişiminiz vardır. Ana bilgisayarınızın:
   • Desteklenen bir işletim sistemi çalıştırılmalıdır.
   • Yüksek hızlı bir ağa bağlı olmalıdır. En az bir adet 10 GbE bağlantınızın olması önemle tavsiye edilir. 10 GbE bağlantı yoksa, 1 GbE veri bağlantısı kullanılabilir ancak kopyalama hızı etkilenir.
5. Ana bilgisayarınıza AzCopy V10'u indirin. AzCopy, konak bilgisayarınızdan Azure Data Box Blob depolama alanına veri kopyalamak için kullanılır.

http veya https üzerinden bağlanma

Data Box Blob depolamaya http veya https üzerinden bağlanabilirsiniz.

• Https , Data Box Blob depolamaya bağlanmanın güvenli ve önerilen yoludur.
• Http , güvenilen ağlar üzerinden bağlanırken kullanılır.

Http veya https üzerinden Data Box Blob depolamaya bağlandığınızda bağlanma adımları farklıdır.

http üzerinden bağlanma

Http üzerinden Data Box Blob depolama REST API'lerine bağlantı aşağıdaki adımları gerektirir:

• Cihaz IP'sini ve blob hizmet uç noktasını uzak ana bilgisayara ekleme
• İş ortağı yazılımını yapılandırma ve bağlantıyı doğrulama

Bu adımların her biri aşağıdaki bölümlerde açıklanmıştır.

Cihaz IP adresi ve blob hizmet uç noktası ekleme

1. Data Box cihazında oturum açın. Kilidinin açık olduğundan emin olun.

   

2. Ağ arabirimlerini ayarla'ya gidin. İstemciye bağlanmak için kullanılan ağ arabiriminin cihaz IP adresini not edin.

   

3. Bağlan ve kopyala'ya gidip Dinlen'e tıklayın.

   

4. Access Depolama hesabı ve verileri karşıya yükle iletişim kutusunda Blob Hizmeti Uç Noktası'nı kopyalayın.

   

5. Not Defteri'ni yönetici olarak başlatın ve konumundaki C:\Windows\System32\Drivers\etchosts dosyasını açın.

6. Konak dosyanıza aşağıdaki girdiyi ekleyin:<device IP address> <Blob service endpoint>

7. Başvuru için aşağıdaki görüntüyü kullanın. Hosts dosyasını kaydedin.

   

Bağlantıyı doğrulama ve iş ortağı yazılımını yapılandırma

İstemciye bağlanmak için iş ortağı yazılımını yapılandırın. İş ortağı yazılımına bağlanmak için genellikle önceki adımda yerel web kullanıcı arabiriminin Bağlan ve kopyala sayfasından topladığınız aşağıdaki bilgilere (farklılık gösterebilir) ihtiyacınız vardır:

• Depolama hesabı adı
• Erişim anahtarı
• Blob hizmeti uç noktası

Bağlantının başarıyla kurulduğunu doğrulamak için dış depolama hesabına eklemek için Depolama Gezgini kullanın. Depolama Gezgini yoksa indirmeniz ve yüklemeniz gerekir.

Depolama Gezgini ilk kez kullandığınızda aşağıdaki adımları gerçekleştirmeniz gerekir:

1. Üst komut çubuğundan Hedef Azure Stack'i Düzenle'ye > gidin.

   

2. Değişikliklerin geçerli olması için Depolama Gezgini yeniden başlatın.

   

Depolama hesabına bağlanmak ve bağlantıyı doğrulamak için bu adımları izleyin.

1. Depolama Gezgini Azure Depolama'ya bağlan iletişim kutusunu açın. Azure Depolama'ya Bağlan iletişim kutusunda Depolama hesabı adı ve anahtarı kullan'ı seçin.

   

2. Hesap adınızı ve Hesap anahtarınızı (yerel web kullanıcı arabirimindeki Bağlan ve kopyala sayfasından anahtar 1 değeri) yapıştırın. Depolama uç noktaları etki alanını Diğer olarak seçin (aşağıya girin) ve ardından aşağıda gösterildiği gibi blob hizmet uç noktasını sağlayın. Yalnızca http üzerinden aktarılıyorsa HTTP kullan seçeneğini işaretleyin. https kullanıyorsanız seçeneği işaretsiz bırakın. İleri'yi seçin.

   

3. Bağlantı Özeti iletişim kutusunda sağlanan bilgileri gözden geçirin. Bağlan'ı seçin.

   

4. Başarıyla eklediğiniz hesap, Depolama Gezgini sol bölmesinde adının sonuna (Dış, Diğer) eklenmiş olarak görüntülenir. Kapsayıcıyı görüntülemek için Blob Kapsayıcıları'na tıklayın.

   

https üzerinden bağlanma

Https üzerinden Azure Blob depolama REST API'lerine bağlantı aşağıdaki adımları gerektirir:

• Sertifikayı Azure portalından indirin. Bu sertifika, web kullanıcı arabirimine ve Azure Blob depolama REST API'lerine bağlanmak için kullanılır.
• Sertifikayı istemciye veya uzak ana bilgisayara aktarın.
• Cihaz IP'sini ve blob hizmet uç noktasını istemciye veya uzak ana bilgisayara ekleyin.
• İş ortağı yazılımını yapılandırın ve bağlantıyı doğrulayın.

Bu adımların her biri aşağıdaki bölümlerde açıklanmıştır.

Sertifikayı indirme

Sertifikayı indirmek için Azure portalını kullanın.

1. Azure portal oturum açın.

2. Data Box siparişinize gidin ve Genel > Cihaz ayrıntıları'na gidin.

3. Cihaz kimlik bilgileri'nin altında cihaza API erişimi'ne gidin. İndir'i seçin. Bu eylem sipariş <adınızı>.cer sertifika dosyasını indirir. Bu dosyayı kaydedin ve cihaza bağlanmak için kullandığınız istemci veya konak bilgisayara yükleyin.

   

Sertifikayı içeri aktarma

HTTPS üzerinden Data Box Blob depolamaya erişmek için cihaz için bir TLS/SSL sertifikası gerekir. Bu sertifikanın istemci uygulamasının kullanımına sunulma şekli, uygulamadan uygulamaya ve işletim sistemleri ile dağıtımlar arasında farklılık gösterir. Bazı uygulamalar, sistemin sertifika deposuna aktarıldıktan sonra sertifikaya erişebilirken, diğer uygulamalar bu mekanizmayı kullanmaz.

Bazı uygulamalar için belirli bilgiler bu bölümde belirtilmiştir. Diğer uygulamalar hakkında daha fazla bilgi için uygulamanın ve kullanılan işletim sisteminin belgelerine bakın.

Dosyayı bir Windows veya Linux istemcisinin kök deposuna aktarmak .cer için bu adımları izleyin. Bir Windows sisteminde, sertifikayı içeri aktarmak ve sisteminize yüklemek için Windows PowerShell veya Windows Server kullanıcı arabirimini kullanabilirsiniz.

Windows PowerShell kullanma

1. Yönetici olarak bir Windows PowerShell oturumu başlatın.

2. Komut istemine şunu yazın:

   Import-Certificate -FilePath C:\temp\localuihttps.cer -CertStoreLocation Cert:\LocalMachine\Root
   

Windows Server kullanıcı arabirimini kullanma

1. Dosyaya sağ tıklayın ve Sertifika yükle'yi .cer seçin. Bu eylem Sertifika İçeri Aktarma Sihirbazı'nı başlatır.

2. Mağaza konumu için Yerel Makine'yi ve ardından İleri'yi seçin.

   

3. Tüm sertifikaları aşağıdaki depoya yerleştir'i ve ardından Gözat'ı seçin. Uzak ana bilgisayarınızın kök deposuna gidin ve İleri'yi seçin.

   

4. Bitir'i seçin. İçeri aktarma işleminin başarılı olduğunu belirten bir ileti görüntülenir.

   

Linux sistemi kullanma

Sertifikayı içeri aktarma yöntemi dağıtıma göre değişir.

Ubuntu ve Debian gibi birkaçı update-ca-certificates komutunu kullanır.

• Base64 kodlu sertifika dosyasını bir .crt uzantıya sahip olacak şekilde yeniden adlandırın ve dosyasına /usr/local/share/ca-certificates directorykopyalayın.
• update-ca-certificates komutunu çalıştırın.

RHEL, Fedora ve CentOS'un son sürümleri komutunu kullanır update-ca-trust .

• Sertifika dosyasını dizinine /etc/pki/ca-trust/source/anchors kopyalayın.
• update-ca-trust'i çalıştırın.

Ayrıntılar için dağıtımınıza özgü belgelere bakın.

Cihaz IP adresi ve blob hizmet uç noktası ekleme

Http üzerinden bağlanırken cihaz IP adresi ve blob hizmet uç noktası eklemek için aynı adımları izleyin.

İş ortağı yazılımını yapılandırma ve bağlantıyı doğrulama

http üzerinden bağlanırken kullandığınız iş ortağı yazılımını yapılandırma adımlarını izleyin. Tek fark, Http kullan seçeneğini işaretsiz bırakmanız gerektiğidir.

Blok blobları için uygun erişim katmanlarını belirleme

Önemli

Bu bölümde yer alan bilgiler 1^{Nisan 2024'e kadar} verilen siparişler için geçerlidir.

Azure Depolama, blok blobu verilerini aynı depolama hesabı içinde birden çok erişim katmanında depolamanıza olanak tanır. Bu özellik, verilerin erişim sıklıklarına göre daha verimli bir şekilde düzenlenmesini ve depolanmasını sağlar. Aşağıdaki tabloda Azure Depolama erişim katmanları hakkında bilgi ve öneriler yer alır.

Katman	Öneri	En iyi uygulama
Hareketli	Sık erişilen veya değiştirilen çevrimiçi veriler için kullanışlıdır. Bu katman en yüksek depolama maliyetlerine, ancak en düşük erişim maliyetlerine sahiptir.	Bu katmandaki veriler düzenli ve etkin kullanımda olmalıdır.
Seyrek Erişimli	Seyrek erişilen veya değiştirilen çevrimiçi veriler için kullanışlıdır. Bu katmanın depolama maliyetleri ve erişim maliyetleri sık erişim katmanından daha yüksektir.	Bu katmandaki veriler en az 30 gün boyunca depolanmalıdır.
Durgun	Nadiren erişilen veya değiştirilen ancak yine de hızlı alma gerektiren çevrimiçi veriler için kullanışlıdır. Bu katmanın depolama maliyetleri ve erişim maliyetleri seyrek erişim katmanından daha yüksektir.	Bu katmandaki veriler en az 90 gün boyunca depolanmalıdır.
Arşiv	Nadiren erişilen ve daha düşük gecikme süresi gereksinimlerine sahip çevrimdışı veriler için kullanışlıdır.	Bu katmandaki veriler en az 180 gün boyunca depolanmalıdır. Arşiv katmanından 180 gün içinde kaldırılan veriler erken silme ücretine tabidir.

Blob erişim katmanları hakkında daha fazla bilgi için bkz . Blob verileri için erişim katmanları. Daha ayrıntılı en iyi yöntemler için bkz . Blob erişim katmanlarını kullanmaya yönelik en iyi yöntemler.

Blok blobu verilerinizi Data Box içindeki ilgili klasöre kopyalayarak uygun erişim katmanına aktarabilirsiniz. Bu işlem, Verileri Azure Data Box'a kopyalama bölümünde daha ayrıntılı olarak ele alınmıştı.

Data Box'a veri kopyalama

Bir veya daha fazla Data Box paylaşımına bağlandıktan sonra, sonraki adım verileri kopyalamaktır. Veri kopyalamaya başlamadan önce aşağıdaki sınırlamaları göz önünde bulundurun:

• Veri kopyalama sırasında veri boyutunun Azure depolama ve Data Box sınırları içinde belirtilen boyut sınırlarına uygun olduğundan emin olun.
• Data Box ve Data Box olmayan başka bir uygulama tarafından aynı anda karşıya yüklemeler, karşıya yükleme işi hatalarına ve veri bozulmasına neden olabilir.

Önemli

Verilerinizin Azure Depolama'ya kopyalandığını onaylayana kadar kaynak verilerin bir kopyasını koruduğunuzdan emin olun.

Bu öğreticide AzCopy, Data Box Blob depolama alanına veri kopyalamak için kullanılır. GUI tabanlı bir aracı tercih ediyorsanız, verileri kopyalamak için Azure Depolama Gezgini veya diğer iş ortağı yazılımlarını da kullanabilirsiniz.

Kopyalama yordamı aşağıdaki adımları içerir:

• Kapsayıcı oluşturma
• Bir klasörün içeriğini Data Box Blob depolama alanına yükleme
• Değiştirilmiş dosyaları Data Box Blob depolama alanına yükleme

Bu adımların her biri aşağıdaki bölümlerde ayrıntılı olarak açıklanmıştır.

Kapsayıcı oluşturma

Bloblar her zaman bir kapsayıcıya yüklendiği için ilk adım kapsayıcı oluşturmaktır. Kapsayıcılar, blob gruplarını, dosyaları bilgisayarınızdaki klasörlerde düzenlediğiniz gibi düzenler. Blob kapsayıcısı oluşturmak için bu adımları izleyin.

1. Depolama Gezgini'ni açın.

2. Sol bölmede, blob kapsayıcısını oluşturmak istediğiniz depolama hesabını genişletin.

3. Blob Kapsayıcıları'na sağ tıklayın ve bağlam menüsünden Blob Kapsayıcısı Oluştur'u seçin.

   

4. Blob Kapsayıcıları klasörünün altında bir metin kutusu görüntülenir. Blob kapsayıcınızın adını girin. Blob kapsayıcılarını adlandırma kuralları ve kısıtlamaları hakkında bilgi için bkz. Kapsayıcı oluşturma ve izinleri ayarlama.

5. Blob kapsayıcısını oluşturmak için bitirdiğinizde Enter tuşuna veya iptal etmek için Esc tuşuna basın. Blob kapsayıcısı başarıyla oluşturulduktan sonra, seçilen depolama hesabının Blob Kapsayıcıları klasörünün altında görüntülenir.

   

Bir klasörün içeriğini Data Box Blob depolama alanına yükleme

Bir klasördeki tüm dosyaları Windows veya Linux'ta Blob depolamaya yüklemek için AzCopy'yi kullanın. Bir klasördeki tüm blobları karşıya yüklemek için aşağıdaki AzCopy komutunu girin:

Linux

azcopy \
    --source /mnt/myfolder \
    --destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ \
    --dest-key <key> \
    --recursive

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ /DestKey:<key> /S

değerini hesap anahtarınız ile değiştirin <key> . Depolama hesabınıza giderek Azure portalında hesap anahtarınızı alabilirsiniz. Ayarlar > Erişim anahtarları'nı seçin, bir anahtar seçin, ardından değeri kopyalayıp AzCopy komutuna yapıştırın.

Belirtilen hedef kapsayıcı yoksa, AzCopy bunu oluşturur ve dosyayı bu kapsayıcıya yükler. Veri dizininizin kaynak yolunu güncelleştirin ve hedef URL'deki değerini Data Box'ınız ile ilişkilendirilmiş depolama hesabının adıyla değiştirin data-box-storage-account-name .

Belirtilen dizinin içeriğini Blob depolamaya yinelemeli olarak yüklemek için Linux seçeneğini veya /S Windows seçeneğini belirtin--recursive. AzCopy komutunu şu seçeneklerden biriyle çalıştırdığınızda tüm alt klasörler ve bu klasörlerin dosyaları da karşıya yüklenir.

Değiştirilmiş dosyaları Data Box Blob depolama alanına yükleme

Dosyaları son değiştirme saatlerine göre karşıya yüklemek için AzCopy'yi de kullanabilirsiniz. Yalnızca güncelleştirilmiş veya yeni dosyaları karşıya yüklemek için Linux parametresini --exclude-older veya /XO Windows parametresi parametresini AzCopy komutuna ekleyin.

Yalnızca yerel kaynağınızdaki hedefte mevcut olmayan kaynakları kopyalamak istiyorsanız, AzCopy komutunda Linux için ve --exclude-newer parametrelerini veya /XO Windows için ve /XN parametrelerini belirtin--exclude-older. AzCopy, zaman damgası tarafından belirlenen yalnızca güncelleştirilmiş verileri karşıya yükler.

Linux

azcopy \
--source /mnt/myfolder \
--destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ \
--dest-key <key> \
--recursive \
--exclude-older

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ /DestKey:<key> /S /XO

Bağlanma veya kopyalama işlemi sırasında herhangi bir hata varsa bkz . Data Box Blob depolama ile ilgili sorunları giderme.

Sonraki adım, cihazınızı göndermeye hazırlamaktır.

Sonraki adımlar

Bu öğreticide aşağıdaki Azure Data Box konularını öğrendiniz:

• REST API'lerini kullanarak Azure Data Box Blob depolamaya veri kopyalama önkoşulları
• Http veya https üzerinden Data Box Blob depolamaya bağlanma
• Blok blobları için uygun erişim katmanlarını belirleme
• Data Box'a veri kopyalama

Data Box'ı Microsoft’a geri gönderme hakkında bilgi edinmek için sonraki öğreticiye geçin.

Azure Data Box verilerinizi Microsoft'a gönderme