Kom igång med AzCopy

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 data.

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 läser du avsnittet Använd den tidigare versionen av AzCopy i den här artikeln.

Ladda ned AzCopy

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

Dessa filer komprimeras som en zip-fil (Windows och Mac) eller en tar-fil (Linux). Information om hur du laddar ned och expanderar tar-filen i Linux finns i dokumentationen för din Linux-distribution.

Detaljerad information om AzCopy-versioner finns på azcopy-versionssidan.

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 skriva azcopy 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 kataloger till platsen för den körbara AzCopy-filen och skriva azcopy eller .\azcopy i Windows PowerShell 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 av Azure Active Directory (AD) eller med hjälp av en SAS-token (Signatur för delad åtkomst).

Använd den här tabellen som guide:

Lagringstyp Auktoriseringsmetod som stöds för närvarande
Blob Storage & Azure AD SAS
Bloblagring (hierarkiskt namnområde) & Azure AD SAS
File Storage Endast SAS

Alternativ 1: Använda Azure Active Directory

Det här alternativet är endast tillgängligt för Blob Storage. Genom att använda 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.

Alternativ 2: Använd en SAS-token

Du kan lägga till en SAS-token till varje käll- eller mål-URL som används 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 containerns URL.

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 TLS (Transport Layer Security). Den här inställningen är aktiverad som standard.

Överföra data

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

Information om hur du hittar 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 Storage Ö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.

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

Infogad 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 prestandamått genom att ladda upp eller ladda 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 AzCopys beteende.
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 för det angivna jobb-ID:t.
azcopy lista Visar entiteterna i en viss resurs.
azcopy inloggning Loggar in på Azure Active Directory för att få åtkomst till Azure Storage-resurser.
azcopy-inloggningsstatus Visar entiteterna i en viss resurs.
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 sync 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.

För att undvika dessa problem hämtar du en statisk (oförändrad) 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 (PowerShell Core 7) (Invoke-WebRequest https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue -SkipHttpErrorCheck).headers.location[0]
Windows (PowerShell 5.1) (Invoke-WebRequest https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue ).headers.location

Anteckning

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

URL:en visas i utdata från det här kommandot. Skriptet kan sedan ladda ned AzCopy med hjälp av den 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 sina 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 på Storage Explorer behöver du inte ange ytterligare autentiseringsuppgifter för auktorisering.

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 läsa någon av följande länkar:

Nästa steg

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