Självstudie: Använda REST-API:er för att kopiera data till Azure Data Box Blob Storage

Den här handledningen beskriver procedurer för att ansluta till Azure Data Box Blob-lagring via REST-API:er genom "http" eller "https". När anslutningen har upprättats beskrivs de steg som krävs för att kopiera data till Data Box Blob-lagring och förbereda Data Box för transport.

I den här handledningen lär du dig att:

Förutsättningar

Ansluta via http eller https

Du kan ansluta till Data Box Blob-lagring genom http eller https.

• Https är det säkra och rekommenderade sättet att ansluta till Data Box Blob Storage.
• http används när du ansluter via betrodda nätverk.

Stegen för att ansluta skiljer sig åt när du ansluter till Data Box Blob Storage via http eller https.

Ansluta via http

För anslutning till REST-API:er för Data Box Blob-lagring genom http krävs följande steg:

• Lägg till enhetens IP-adress och blob-tjänstslutpunkt på fjärrvärden
• Konfigurera partnerprogramvara och verifiera anslutningen

Vart och ett av dessa steg beskrivs i följande avsnitt.

Lägga till enhetens IP-adress och blobtjänstslutpunkt

1. Logga in på Data Box-enheten. Se till att den är upplåst.

   

2. Gå till Ställ in nätverksgränssnitt. Anteckna enhetens IP-adress för nätverksgränssnittet som används för att ansluta till klienten.

   

3. Gå till Anslut och kopiera och klicka på Vila.

   

4. Från dialogrutan Öppna lagringskonto och ladda upp data kopierar du Blob Service-slutpunkt.

   

5. Starta Anteckningsblock som administratör och öppna sedan hosts-filen på C:\Windows\System32\Drivers\etc.

6. Lägg till följande post i din hosts-fil: <device IP address> <Blob service endpoint>

7. Använd följande bild som referens. Spara hosts-filen.

   

Verifiera anslutningen och konfigurera partnerprogramvaran

Konfigurera partnerprogrammet så att det ansluter till klienten. För att ansluta till partnerprogramvaran behöver du vanligtvis följande information (kan variera) som du samlade in från sidan Anslut och kopiera i det lokala webbgränssnittet i föregående steg:

• Lagringskontonamn
• Åtkomstnyckel
• Blob-tjänstens slutpunkt

Verifiera att anslutningen har upprättats genom att ansluta till ett externt lagringskonto med Storage Explorer. Om du inte har Storage Explorer måste du ladda ned och installera.

Första gången du använder Storage Explorer måste du utföra följande steg:

1. I det översta kommandofältet går du till Redigera > Azure Stack för mål.

   

2. Starta om Storage Explorer så att ändringarna träder i kraft.

   

Anslut till lagringskontot och verifiera anslutningen på följande sätt.

1. Välj Anslut till Azure Storage i Storage Explorer. Välj Använd lagringskontonamn och nyckel i dialogrutan Anslut till Azure Storage.

   

2. Klistra in ditt kontonamn och din kontonyckel (nyckel 1-värdet från sidan Anslut och kopiera i det lokala webbanvändargränssnittet). Välj Annan (ange nedan) som domän för lagringsslutpunkter och ange den blobtjänstslutpunkt som visas nedan. Markera alternativet Använd HTTP endast om du över via http. Lämna alternativet omarkerat om du använder https. Välj Nästa.

   

3. Kontrollera informationen i dialogrutan Anslutningssammanfattning. Välj Anslut.

   

4. Det konto som du har lagt till visas i den vänstra rutan i Storage Explorer med (extern, övrigt) i slutet av namnet. Visa containern genom att klicka på Blobcontainer.

   

Ansluta via https

För anslutning till REST-API:er för Azure Blob-lagring genom https krävs följande steg:

• Ladda ned certifikatet från Azure Portal. Det här certifikatet används för att ansluta till webbgränssnittet och REST-API:er för Azure Blob Storage.
• Importera certifikatet på klienten eller fjärrvärden.
• Lägg till enhetens IP-adress och slutpunkt för blob-tjänst till klienten eller en fjärrvärd.
• Konfigurera partnerprogramvara och verifiera anslutningen.

Vart och ett av dessa steg beskrivs i följande avsnitt.

Ladda ned certifikat

Använda Azure-portalen för att ladda ned certifikatet.

1. Logga in på Azure-portalen.

2. Gå till din Data Box-beställning och gå till Allmän > enhetsinformation.

3. Under Autentiseringsuppgifter för enheten går du till API-åtkomst till enheten. Välj Hämta. Den här åtgärden laddar ned ett <beställningsnamn>.cer certifikatfil. Spara den här filen och installera den på den klient eller värddator som du använder för att ansluta till enheten.

   

Importcertifikat

För åtkomst till Data Box Blob Storage via HTTPS krävs ett TLS/SSL-certifikat för enheten. Hur det här certifikatet görs tillgängligt för klientprogrammet varierar från program till program och mellan operativsystem och distributioner. Vissa program kan komma åt certifikatet efter att ha importerat det till systemets certifikatarkiv, medan andra program inte använder den mekanismen.

Specifik information för vissa program nämns i det här avsnittet. Mer information om andra program finns i dokumentationen för programmet och det operativsystem som används.

Följ de här stegen för att importera .cer filen till rotarkivet för en Windows- eller Linux-klient. I ett Windows-system kan du använda Windows PowerShell eller Windows Server-användargränssnittet för att importera och installera certifikatet i systemet.

Använda Windows PowerShell

1. Starta en Windows PowerShell-session som administratör.

2. Skriv i kommandotolken:

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

Använda Windows Server-användargränssnittet

1. Högerklicka på .cer filen och välj Installera certifikat. Den här åtgärden startar guiden Importera certifikat.

2. För Store-plats väljer du Lokal dator och sedan Nästa.

   

3. Välj Placera alla certifikat i följande arkiv och välj sedan Bläddra. Gå till rotarkivet på din fjärrvärd och välj Nästa.

   

4. Välj Slutför. Ett meddelande visas där det står att importen lyckades.

   

Använda ett Linux-system

Metoden för att importera ett certifikat varierar beroende på distribution.

Flera, till exempel Ubuntu och Debian, använder update-ca-certificates kommandot.

• Byt namn på den Base64-kodade certifikatfilen till att ha ett .crt tillägg och kopiera det till /usr/local/share/ca-certificates directory.
• Kör kommandot update-ca-certificates.

De senaste versionerna av RHEL, Fedora och CentOS använder update-ca-trust kommandot .

• Kopiera certifikatfilen till /etc/pki/ca-trust/source/anchors katalogen.
• Kör update-ca-trust.

Mer information finns i dokumentationen som är specifik för din distribution.

Lägga till enhetens IP-adress och blobtjänstslutpunkt

Följ samma steg för att lägga till enhetens IP-adress och blobtjänstslutpunkt när du ansluter via http.

Konfigurera partnerprogramvara och verifiera anslutningen

Följ stegen för att konfigurera partnerprogramvara som du använde när du anslöt via http. Den enda skillnaden är att du låter alternativet Använd http vara avmarkerat.

Kopiera data till Data Box

När en eller flera Data Box-resurser har anslutits är nästa steg att kopiera data. Innan du påbörjar datakopieringsåtgärder bör du tänka på följande begränsningar:

• När du kopierar data ser du till att datastorleken överensstämmer med storleksbegränsningarna som beskrivs i avsnittet om Azure Storage- och Data Box-gränser.
• Samtidiga uppladdningar av Data Box och ett annat program som inte är Data Box kan potentiellt leda till fel i uppladdningsjobbet och skadade data.

I den här handledningen används AzCopy för att kopiera data till Data Box Blob-lagring. Om du föredrar ett GUI-baserat verktyg kan du även använda Azure Storage Explorer eller annan partnerprogramvara för att kopiera data.

Kopieringsproceduren omfattar följande steg:

• Skapa en container
• Ladda upp innehåll i en mapp till Data Box Blob-lagring
• Ladda upp ändrade filer till Data Box Blob-lagring

Vart och ett av dessa steg beskrivs ingående i följande avsnitt.

Skapa en container

Det första steget är att skapa en container, eftersom blobar alltid laddas upp till en container. Containrar organiserar grupper av blobar på samma sätt som du ordnar filer i mappar på datorn. Skapa en blob-container genom att följa de här stegen.

1. Öppna Storage Explorer.

2. I den vänstra fönsterrutan expanderar du det lagringskonto där du vill skapa blob-containern.

3. Högerklicka på Blob-containrar och välj Skapa blob-container på snabbmenyn.

   

4. En textruta visas nedanför mappen Blob Containers (Blob-containrar). Ange namnet på blob-containern. Information om regler och begränsningar vid namngivning av blob-containrar finns i Skapa containern och ange behörigheter.

5. Tryck på Retur när du är klar så att blob-containern skapas eller på Esc om du vill avbryta. När blobcontainern har skapats visas den under det valda lagringskontots blobcontainermapp .

   

Ladda upp innehållet i en mapp till Data Box Blob Storage

Använd AzCopy för att ladda upp alla filer i en mapp till Blob Storage i Windows eller Linux. Överför alla blobar i en mapp genom att ange följande AzCopy-kommando:

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

Ersätt <key> med din kontonyckel. Du kan hämta din kontonyckel i Azure Portal genom att gå till ditt lagringskonto. Välj Inställningar > Åtkomstnycklar, välj en nyckel och kopiera och klistra sedan in värdet i Kommandot AzCopy.

Om den angivna målcontainern inte finns skapar AzCopy den och laddar upp filen till den. Uppdatera källsökvägen till datakatalogen och ersätt data-box-storage-account-name i mål-URL:en med namnet på det lagringskontot som är associerat med din Data Box-enhet.

Om du vill ladda upp innehållet i den angivna katalogen till Blob Storage rekursivt anger du --recursive alternativet för Linux eller /S alternativet för Windows. När du kör AzCopy med något av följande alternativ, så överförs även alla undermappar och filer.

Ladda upp ändrade filer till Data Box Blob-lagring

Du kan också använda AzCopy för att ladda upp filer baserat på deras senaste ändringstid. Om du bara vill ladda upp uppdaterade eller nya filer lägger du till parametern --exclude-older för Linux eller parametern /XO för Windows-parametern i Kommandot AzCopy.

Om du bara vill kopiera de resurser i din lokala källa som inte finns inom målet anger du både parametrarna --exclude-older och --exclude-newer för Linux eller parametrarna /XO och /XN för Windows i Kommandot AzCopy. AzCopy laddar endast upp uppdaterade data, enligt tidsstämpeln.

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

Om det finns några fel under anslutnings- eller kopieringsåtgärden, se Felsöka problem med Data Box Blob Storage.

Nästa steg är att förbereda enheten för leverans.

Nästa steg

I den här kursen har du lärt dig om Azure Data Box-ämnen som att:

Gå vidare till nästa självstudie och lär dig hur du skickar tillbaka din Data Box-enhet till Microsoft.