Kom igång med AzCopy

  • Artikel
  • 6 minuter för att läsa

AzCopy är ett kommandoradsverktyg som du kan använda för att kopiera blobar eller filer till eller från ett lagringskonto. Den här artikeln hjälper dig att ladda ned AzCopy, ansluta till ditt lagringskonto och sedan överföra filer.

Anteckning

AzCopy V10 är den version av AzCopy som stöds för närvarande.

Om du behöver använda en tidigare version av AzCopy kan du läsa avsnittet Använda den tidigare versionen av AzCopy i den här artikeln.

Ladda ned AzCopy

Ladda först ned den körbara AzCopy V10-filen till valfri katalog på datorn. AzCopy V10 är bara en körbar fil, så det finns inget att installera.

De här filerna komprimeras som en zip-fil (Windows mac) eller en tar-fil (Linux). Om du vill ladda ned och dekomprimera tar-filen i Linux kan du läsa dokumentationen för din Linux-distribution.

Anteckning

Om du vill kopiera data till och från Azure Table Storage-tjänsten installerar du AzCopy version 7.3.

Köra AzCopy

Det blir enklare om du lägger till katalogplatsen för den körbara AzCopy-filen i din systemsökväg. På så sätt kan du azcopy skriva från valfri katalog i systemet.

Om du väljer att inte lägga till AzCopy-katalogen i sökvägen måste du ändra sökvägen till platsen för din körbara AzCopy-fil och skriva eller Windows PowerShell i azcopy .\azcopy kommandotolken.

Som ägare till ditt Azure Storage-konto tilldelas du inte automatiskt behörighet att komma åt data. Innan du kan göra något meningsfullt med AzCopy måste du bestämma hur du ska ange autentiseringsuppgifter för auktorisering till lagringstjänsten.

Auktorisera AzCopy

Du kan ange autentiseringsuppgifter för auktorisering med hjälp Azure Active Directory (AD) eller med hjälp av en SAS-token (signatur för delad åtkomst).

Använd den här tabellen som vägledning:

Lagringstyp Metod för auktorisering som stöds för närvarande
Blob Storage Azure AD och SAS
Blob Storage (hierarkisk namnrymd) Azure AD och SAS
File Storage Endast SAS

Alternativ 1: Använd Azure Active Directory

Det här alternativet är endast tillgängligt Storage bloblagring. Genom att Azure Active Directory kan du ange autentiseringsuppgifter en gång i stället för att behöva lägga till en SAS-token i varje kommando.

Anteckning

Om du planerar att kopiera blobar mellan lagringskonton i den aktuella versionen måste du lägga till en SAS-token till varje käll-URL. Du kan utelämna endast SAS-token från mål-URL:en. Exempel finns i Kopiera blobar mellan lagringskonton.

Information om hur du auktoriserar åtkomst med hjälp av Azure AD finns i Auktorisera åtkomst till blobar med AzCopy och Azure Active Directory (Azure AD).

Alternativ 2: Använda en SAS-token

Du kan lägga till en SAS-token till varje käll- eller mål-URL som använder i dina AzCopy-kommandon.

Det här exempelkommandot kopierar rekursivt data från en lokal katalog till en blobcontainer. En fiktiv SAS-token läggs till i slutet av container-URL:en.

azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

Mer information om SAS-token och hur du hämtar en finns i Använda signaturer för delad åtkomst (SAS).

Anteckning

Inställningen Säker överföring krävs för ett lagringskonto avgör om anslutningen till ett lagringskonto skyddas med Transport Layer Security (TLS). Den här inställningen är aktiverad som standard.

Överföra data

När du har auktoriserat din identitet eller fått en SAS-token kan du börja överföra data.

Exempelkommandon finns i någon av dessa artiklar.

Tjänst Artikel
Azure Blob Storage Ladda upp filer till Azure Blob Storage
Azure Blob Storage Ladda ned blobar från Azure Blob Storage
Azure Blob Storage Kopiera blobar mellan Azure-lagringskonton
Azure Blob Storage Synkronisera med Azure Blob Storage
Azure Files Överföra data med AzCopy och fillagring
Amazon S3 Kopiera data från Amazon S3 till Azure Storage
Google Cloud Storage Kopiera data från Google Cloud Storage till Azure Storage (förhandsversion)
Azure Stack lagring Överföra data med AzCopy och Azure Stack storage

Hämta kommandohjälp

Om du vill se en lista över kommandon skriver azcopy -h du och trycker sedan på RETUR-tangenten.

Om du vill veta mer om ett visst kommando tar du bara med namnet på kommandot (till exempel: azcopy list -h ).

Infogade hjälp

Lista över kommandon

I följande tabell visas alla AzCopy v10-kommandon. Varje kommando länkar till en referensartikel.

Kommando Beskrivning
azcopy bench Kör ett prestandatest genom att ladda upp eller ned testdata till eller från en angiven plats.
azcopy kopiera Kopierar källdata till en målplats
azcopy dok Genererar dokumentation för verktyget i Markdown-format.
azcopy miljö Visar de miljövariabler som kan konfigurera AzCopy-beteendet.
azcopy jobb Underkommandon som rör hantering av jobb.
azcopy jobs clean Ta bort alla logg- och planfiler för alla jobb.
azcopy jobblista Visar information om alla jobb.
azcopy jobs remove Ta bort alla filer som är associerade med det angivna jobb-ID:t.
azcopy jobb-CV Återupptar det befintliga jobbet med det angivna jobb-ID:t.
azcopy jobbvisning Visar detaljerad information om det angivna jobb-ID:t.
azcopy load Underkommandon som rör överföring av data i specifika format.
azcopy load clfs Överför lokala data till en container och lagrar dem i Microsofts CLFS-format (Avere Cloud FileSystem).
azcopy lista Visar entiteterna i en viss resurs.
azcopy inloggning Loggar in på Azure Active Directory åtkomst till Azure Storage resurser.
azcopy utloggning Loggar ut användaren och avslutar åtkomsten till Azure Storage resurser.
azcopy skapa Skapar en container eller filresurs.
azcopy ta bort Ta bort blobar eller filer från ett Azure Storage-konto.
azcopy synkronisering Replikerar källplatsen till målplatsen.

Anteckning

AzCopy har inget kommando för att byta namn på filer.

Använda i ett skript

Med tiden pekar Nedladdningslänken för AzCopy på nya versioner av AzCopy. Om skriptet laddar ned AzCopy kan skriptet sluta fungera om en nyare version av AzCopy ändrar funktioner som skriptet är beroende av.

Undvik dessa problem genom att hämta en statisk (oföränderelse) länk till den aktuella versionen av AzCopy. På så sätt laddar skriptet ned samma exakta version av AzCopy varje gång det körs.

Hämta länken genom att köra det här kommandot:

Operativsystem Kommando
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location
Windows (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location

Anteckning

För Linux tar kommandot bort mappen på den översta nivån som innehåller versionsnamnet och extraherar i stället den binära filen --strip-components=1 direkt till den aktuella tar mappen. Detta gör att skriptet kan uppdateras med en ny version av azcopy genom att endast uppdatera wget URL:en.

URL:en visas i kommandots utdata. Skriptet kan sedan ladda ned AzCopy med hjälp av url:en.

Operativsystem Kommando
Linux wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1
Windows Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>>

Escape-specialtecken i SAS-token

I batchfiler som har .cmd tillägget måste du undvika de tecken som visas i % SAS-token. Du kan göra det genom att lägga till ytterligare % ett tecken bredvid befintliga tecken i % SAS-tokensträngen.

Köra skript med Jenkins

Om du planerar att använda Jenkins för att köra skript ska du placera följande kommando i början av skriptet.

/usr/bin/keyctl new_session

Använd i Azure Storage Explorer

Storage Explorer använder AzCopy för att utföra alla dataöverföringsåtgärder. Du kan använda Storage Explorer om du vill utnyttja prestandafördelarna med AzCopy, men du föredrar att använda ett grafiskt användargränssnitt i stället för kommandoraden för att interagera med dina filer.

Storage Explorer använder din kontonyckel för att utföra åtgärder, så när du har loggat in Storage Explorer behöver du inte ange ytterligare autentiseringsuppgifter.

Konfigurera, optimera och åtgärda

Se någon av följande resurser:

Använda en tidigare version

Om du behöver använda den tidigare versionen av AzCopy kan du se någon av följande länkar:

Nästa steg

Om du har frågor, problem eller allmän feedback kan du skicka dem GitHub sidan.