az storage blob copy

Blob-kopieerbewerkingen beheren. Gebruik az storage blob show deze functie om de status van de blobs te controleren.

Opdracht

az storage blob copy cancel

Een doorlopende kopieerbewerking afbreken.

az storage blob copy start

Kopieer een blob asynchroon. Gebruik az storage blob show dit om de status van de blobs te controleren.

az storage blob copy start-batch

Kopieer meerdere blobs naar een blobcontainer. Gebruik az storage blob show dit om de status van de blobs te controleren.

az storage blob copy cancel

Een doorlopende kopieerbewerking afbreken.

Hiermee blijft een doel-blob met lengte nul en volledige metagegevens achter. Hiermee wordt een fout gegenereerd als de kopieerbewerking al is beëindigd.

az storage blob copy cancel --copy-id
                            --destination-blob
                            --destination-container
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--lease-id]
                            [--sas-token]
                            [--timeout]

Vereiste parameters

--copy-id

De kopieerbewerking die moet worden afgebroken. Dit kan een id-tekenreeks of een exemplaar van BlobProperties zijn.

--destination-blob -b

Naam van de doel-blob. Als deze bestaat, wordt deze overschreven.

--destination-container -c

De containernaam.

Optionele parameters

--account-key

Opslagaccountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount of het service-eindpunt. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met de sleutel van het opslagaccount of een SAS-token. Als er geen van beide aanwezig zijn, probeert de opdracht de sleutel van het opslagaccount op te vragen met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--auth-mode

De modus waarin de opdracht moet worden uitgevoerd. De aanmeldingsmodus gebruikt uw aanmeldingsreferenties rechtstreeks voor de verificatie. De verouderde sleutelmodus probeert een query uit te voeren op een accountsleutel als er geen verificatieparameters voor het account worden opgegeven. Omgevingsvariabele: AZURE_STORAGE_AUTH_MODE.

geaccepteerde waarden: key, login
--blob-endpoint

Service-eindpunt voor opslaggegevens. Moet worden gebruikt in combinatie met de sleutel van het opslagaccount of een SAS-token. U vindt elk primair service-eindpunt met az storage account show. Omgevingsvariabele: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Opslagaccount connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--lease-id

Vereist als de doel-blob een actieve oneindige lease heeft.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount of het service-eindpunt. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--timeout

Time-out van aanvraag in seconden. Van toepassing op elke aanroep naar de service.

az storage blob copy start

Kopieer asynchroon een blob. Gebruik az storage blob show deze functie om de status van de blobs te controleren.

az storage blob copy start --destination-blob
                           --destination-container
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--blob-endpoint]
                           [--connection-string]
                           [--destination-if-match]
                           [--destination-if-modified-since]
                           [--destination-if-none-match]
                           [--destination-if-unmodified-since]
                           [--destination-lease-id]
                           [--destination-tags-condition]
                           [--metadata]
                           [--rehydrate-priority]
                           [--requires-sync {false, true}]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-if-match]
                           [--source-if-modified-since]
                           [--source-if-none-match]
                           [--source-if-unmodified-since]
                           [--source-lease-id]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-tags-condition]
                           [--source-uri]
                           [--tags]
                           [--tier]
                           [--timeout]

Voorbeelden

Kopieer een blob asynchroon. Gebruik az storage blob show om de status van de blobs te controleren.

az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos

Kopieer een blob asynchroon. Gebruik az storage blob show om de status van de blobs te controleren.

az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos

Een blobspecifieke versie kopiëren

az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://my-account.blob.core.windows.net/my-container/my-blob?versionId=2022-03-21T18:28:44.4431011Z --auth-mode login

Vereiste parameters

--destination-blob -b

Naam van de doel-blob. Als deze bestaat, wordt deze overschreven.

--destination-container -c

De containernaam.

Optionele parameters

--account-key

Opslagaccountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount of het service-eindpunt. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met de sleutel van het opslagaccount of een SAS-token. Als er geen van beide aanwezig zijn, probeert de opdracht de sleutel van het opslagaccount op te vragen met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--auth-mode

De modus waarin de opdracht moet worden uitgevoerd. De aanmeldingsmodus gebruikt uw aanmeldingsreferenties rechtstreeks voor de verificatie. De verouderde sleutelmodus probeert een query uit te voeren op een accountsleutel als er geen verificatieparameters voor het account worden opgegeven. Omgevingsvariabele: AZURE_STORAGE_AUTH_MODE.

geaccepteerde waarden: key, login
--blob-endpoint

Service-eindpunt voor opslaggegevens. Moet worden gebruikt in combinatie met de sleutel van het opslagaccount of een SAS-token. U vindt elk primair service-eindpunt met az storage account show. Omgevingsvariabele: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Opslagaccount connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--destination-if-match

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

--destination-if-modified-since

Een datum/tijd-waarde. In Azure wordt verwacht dat de datumwaarde die is doorgegeven UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzonegegevens, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de doel-blob is gewijzigd sinds de opgegeven datum/tijd. Als de doel-blob niet is gewijzigd, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt).

--destination-if-none-match

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken (*) op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

--destination-if-unmodified-since

Een datum/tijd-waarde. In Azure wordt verwacht dat de datumwaarde die is doorgegeven UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzonegegevens, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de doel-blob niet is gewijzigd sinds de opgegeven datum/tijd. Als de doel-blob is gewijzigd, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt).

--destination-lease-id

De lease-id die voor deze header is opgegeven, moet overeenkomen met de lease-id van de estination-blob. Als de aanvraag de lease-id niet bevat of niet geldig is, mislukt de bewerking met statuscode 412 (Voorwaarde mislukt).

--destination-tags-condition

Geef een SQL-where-component op voor blobtags om alleen te werken op blobs met een overeenkomende waarde.

--metadata

Metagegevens in door spaties gescheiden sleutel-waardeparen. Hiermee worden alle bestaande metagegevens overschreven.

--rehydrate-priority -r

Geef de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd.

--requires-sync

Afdwingen dat de service geen antwoord retourneert totdat het kopiëren is voltooid.

geaccepteerde waarden: false, true
--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount of het service-eindpunt. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--source-account-key

De opslagaccountsleutel van de bron-blob.

--source-account-name

De naam van het opslagaccount van de bron-blob.

--source-blob

De blobnaam voor het bronopslagaccount.

--source-container

De containernaam voor het bronopslagaccount.

--source-if-match

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

--source-if-modified-since

Een datum/tijd-waarde. Azure verwacht dat de datumwaarde die is doorgegeven UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datum/tijdswaarden geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzonegegevens, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de bron-blob is gewijzigd sinds de opgegeven datum/tijd.

--source-if-none-match

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken (*) op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze bestaat.

--source-if-unmodified-since

Een datum/tijd-waarde. Azure verwacht dat de datumwaarde die is doorgegeven UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datum/tijdswaarden geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzonegegevens, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de bron-blob niet is gewijzigd sinds de opgegeven datum/tijd.

--source-lease-id

Geef dit op om de kopieer-blobbewerking alleen uit te voeren als de opgegeven lease-id overeenkomt met de actieve lease-id van de bron-blob.

--source-path

Het bestandspad voor het bronopslagaccount.

--source-sas

De handtekening voor gedeelde toegang voor het bronopslagaccount.

--source-share

De naam van de share voor het bronopslagaccount.

--source-snapshot

De blobmomentopname voor het bronopslagaccount.

--source-tags-condition

Geef een SQL-where-component op voor blobtags om alleen te werken op blobs met een overeenkomende waarde.

--source-uri -u

Een URL van maximaal 2 kB die een Azure-bestand of blob aangeeft. De waarde moet url-codering hebben, zoals deze wordt weergegeven in een aanvraag-URI. Als de bron zich in een ander account bevindt, moet de bron openbaar zijn of moeten worden geverifieerd via een handtekening voor gedeelde toegang. Als de bron openbaar is, is er geen verificatie vereist. Voorbeelden: https://myaccount.blob.core.windows.net/mycontainer/myblob, https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>, https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken.

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--tier

De waarde van de laag om de blob in te stellen op. Voor pagina-blob komt de laag overeen met de grootte van de blob en het aantal toegestane IOPS. Mogelijke waarden zijn P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 en dit is alleen van toepassing op pagina-blobs op Premium-opslagaccounts; Voor blok-blob zijn mogelijke waarden Archief, Statisch en Dynamisch. Dit is alleen van toepassing op blok-blobs op standaardopslagaccounts.

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

az storage blob copy start-batch

Kopieer meerdere blobs naar een blobcontainer. Gebruik az storage blob show deze functie om de status van de blobs te controleren.

az storage blob copy start-batch [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--blob-endpoint]
                                 [--connection-string]
                                 [--destination-container]
                                 [--destination-path]
                                 [--dryrun]
                                 [--pattern]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]

Voorbeelden

Kopieer meerdere blobs naar een blobcontainer. Gebruik az storage blob show om de status van de blobs te controleren. (automatisch gegenereerd)

az storage blob copy start-batch --account-key 00000000 --account-name MyAccount --destination-container MyDestinationContainer --source-account-key MySourceKey --source-account-name MySourceAccount --source-container MySourceContainer

Optionele parameters

--account-key

Opslagaccountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount of het service-eindpunt. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met de sleutel van het opslagaccount of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht de sleutel van het opslagaccount op te vragen met behulp van het geverifieerde Azure-account. Als er een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--auth-mode

De modus waarin de opdracht moet worden uitgevoerd. De aanmeldingsmodus gebruikt uw aanmeldingsreferenties rechtstreeks voor de verificatie. De verouderde 'sleutel'-modus probeert een query uit te voeren op een accountsleutel als er geen verificatieparameters voor het account worden opgegeven. Omgevingsvariabele: AZURE_STORAGE_AUTH_MODE.

geaccepteerde waarden: key, login
--blob-endpoint

Service-eindpunt voor opslaggegevens. Moet worden gebruikt in combinatie met de sleutel van het opslagaccount of een SAS-token. U vindt elk primair service-eindpunt met az storage account show. Omgevingsvariabele: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Opslagaccount connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--destination-container -c

De blobcontainer waarnaar de geselecteerde bronbestanden of blobs worden gekopieerd.

--destination-path

Het doelpad dat wordt voorbereid op de blobnaam.

--dryrun

Vermeld de bestanden of blobs die moeten worden geüpload. Er wordt geen werkelijke gegevensoverdracht uitgevoerd.

--pattern

Het patroon dat wordt gebruikt voor globbing-bestanden of blobs in de bron. De ondersteunde patronen zijn *, '?', '[seq]' en '[!seq]'. Raadpleeg https://docs.python.org/3.7/library/fnmatch.htmlvoor meer informatie.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount of het service-eindpunt. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--source-account-key

De accountsleutel voor het bronopslagaccount.

--source-account-name

Het bronopslagaccount waaruit de bestanden of blobs worden gekopieerd naar het doel. Als u dit weglaat, wordt het doelaccount gebruikt.

--source-container

De broncontainer waaruit blobs worden gekopieerd.

--source-sas

De handtekening voor gedeelde toegang voor het bronopslagaccount.

--source-share

De bronshare waaruit bestanden worden gekopieerd.

--source-uri

Een URI die een bestandsshare of blobcontainer opgeeft waaruit de bestanden of blobs worden gekopieerd.