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

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

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ı kullanabilirsiniz ancak kopyalama hızları 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 sertifikayı sistemin sertifika deposuna aktardıktan sonra 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.

Data Box'a veri kopyalama

Bir veya daha fazla Data Box paylaşımı bağlandıktan sonra, sonraki adım verileri kopyalamaktır. Veri kopyalama işlemlerini başlatmadan ö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.

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. Başarıyla oluşturulduktan sonra blob kapsayıcısı seçili 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:

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