s3cmd - En ligne dans le Cloud

PROGRAMME:

Nom

s3cmd - outil de gestion de l'espace de stockage Amazon S3 et de la diffusion de contenu Amazon CloudFront
réseau

SYNOPSIS

s3cmd [OPTIONS] COMMAND [PARAMETRES]

DESCRIPTION

s3cmd est un client de ligne de commande pour copier des fichiers vers/depuis Amazon S3 (Simple Storage
Service) et effectuer d'autres tâches connexes, par exemple créer et supprimer des buckets,
lister des objets, etc.

COMMANDES

s3cmd peut faire plusieurs actes spécifié par ce qui suit commandes.

s3cmd mb s3://SEAU
Faire un seau

s3cmd rb s3://SEAU
Supprimer le seau

s3cmd ls [s3://SEAU[/PREFIX]]
Répertorier des objets ou des buckets

s3cmd la
Lister tous les objets dans tous les buckets

s3cmd mettre DOSSIER [DÉPOSER...] s3://SEAU[/PREFIX]
Mettre le fichier dans le seau

s3cmd obtenez s3://SEAU/OBJET FICHIER_LOCAL
Obtenir le fichier du bucket

s3cmd de s3://SEAU/OBJET
Supprimer le fichier du bucket

s3cmd rm s3://SEAU/OBJET
Supprimer le fichier du bucket (alias pour del)

s3cmd restaurer s3://SEAU/OBJET
Restaurer le fichier depuis le stockage Glacier

s3cmd synchroniser LOCAL_DIR s3://SEAU[/PREFIX] or s3://SEAU[/PREFIX] LOCAL_DIR
Synchroniser une arborescence de répertoires avec S3 (vérifie la fraîcheur des fichiers en utilisant la taille et md5
somme de contrôle, à moins qu'elle ne soit remplacée par des options, voir ci-dessous)

s3cmd du [s3://SEAU[/PREFIX]]
Utilisation du disque par buckets

s3cmd d’informations. s3://SEAU[/OBJET]
Obtenir diverses informations sur les buckets ou les fichiers

s3cmd cp s3://SEAU1/OBJET1 s3://SEAU2[/OBJET2]
Copier l'objet

s3cmd modifier s3://BUCKET1/OBJET
Modifier les métadonnées de l'objet

s3cmd mv s3://SEAU1/OBJET1 s3://SEAU2[/OBJET2]
Déplacer l'objet

s3cmd setacl s3://SEAU[/OBJET]
Modifier la liste de contrôle d'accès pour le compartiment ou les fichiers

s3cmd définir la politique DOSSIER s3://SEAU
Modifier la stratégie de compartiment

s3cmd Delpolitique s3://SEAU
Supprimer la stratégie de compartiment

s3cmd décorateurs DOSSIER s3://SEAU
Modifier le seau CORS

s3cmd décors s3://SEAU
Supprimer le bucket CORS

s3cmd payeur s3://SEAU
Modifier la politique de paiement du demandeur de bucket

s3cmd en plusieurs parties s3://SEAU [Identifiant]
Afficher les téléchargements en plusieurs parties

s3cmd abandonnermp s3://SEAU/OBJET Id
Abandonner un téléchargement partitionné

s3cmd listemp s3://SEAU/OBJET Id
Répertorier les parties d'un téléchargement partitionné

s3cmd journal d'accès s3://SEAU
Activer/désactiver la journalisation des accès au bucket

s3cmd signer CHAÎNE À SIGNER
Signer une chaîne arbitraire à l'aide de la clé secrète

s3cmd url s3://SEAU/OBJET
Signez une URL S3 pour fournir un accès public limité avec expiration

s3cmd fixbucket s3://SEAU[/PREFIX]
Corriger les noms de fichiers non valides dans un bucket

s3cmd expirer s3://SEAU
Définir ou supprimer la règle d'expiration pour le bucket

s3cmd définir le cycle de vie DOSSIER s3://SEAU
Charger une politique de cycle de vie pour le bucket

s3cmd cycle de vie s3://SEAU
Supprimer une politique de cycle de vie pour le compartiment

Commandes pour la configuration des sites Web statiques

s3cmd ws-créer s3://SEAU
Créer un site Web à partir d'un bucket

s3cmd ws-supprimer s3://SEAU
Supprimer le site Web

s3cmd ws-info s3://SEAU
Informations sur le site Web

Commandes pour la gestion CloudFront

s3cmd clist
Répertorier les points de distribution CloudFront

s3cmd cfinfo [cf://DIST_ID]
Afficher les paramètres du point de distribution CloudFront

s3cmd cfcréer s3://SEAU
Créer un point de distribution CloudFront

s3cmd cfsupprimer cf://DIST_ID
Supprimer le point de distribution CloudFront

s3cmd cfmodifier cf://DIST_ID
Modifier les paramètres du point de distribution CloudFront

s3cmd cfinvalinfo cf://DIST_ID[/INVAL_ID]
Afficher l'état des demandes d'invalidation CloudFront

OPTIONS

Certaines des options spécifiées ci-dessous peuvent avoir leurs valeurs par défaut définies dans s3cmd fichier de configuration
(par défaut $HOME/.s3cmd). Comme il s'agit d'un simple fichier texte, n'hésitez pas à l'ouvrir avec votre
éditeur de texte préféré et apportez les modifications que vous souhaitez.

-h, --Aidez-moi
afficher ce message d'aide et quitter

--configurer
Invoquez l'outil de (re)configuration interactif. Utilisez éventuellement comme '--configurer
s3://some-bucket' pour tester l'accès à un compartiment spécifique au lieu d'essayer de répertorier
le centre commercial.

-c DÉPOSER, --config=FICHIER
Nom du fichier de configuration. La valeur par défaut est $HOME/.s3cfg

--dump-config
Videz la configuration actuelle après avoir analysé les fichiers de configuration et les options de ligne de commande et
Sortie.

--clé d'accès=ACCESS_KEY
Clé d'accès AWS

--clef secrète=CLÉ_SECRET
Clé secrète AWS

-n, - à sec
Affichez uniquement ce qui doit être chargé ou téléchargé, mais ne le faites pas réellement. Peut encore
effectuer des requêtes S3 pour obtenir des listes de compartiments et d'autres informations (uniquement pour
commandes de transfert de fichiers)

-s, --ssl
Utilisez la connexion HTTPS lors de la communication avec S3. (défaut)

--pas de SSL
N'utilisez pas HTTPS.

-e, --Crypter
Chiffrez les fichiers avant de les télécharger sur S3.

--pas de chiffrement
Ne cryptez pas les fichiers.

-f, --Obliger
Forcer l'écrasement et d'autres opérations dangereuses.

--Continuez
Continuez à obtenir un fichier partiellement téléchargé (uniquement pour la commande [get]).

--continuer-mettre
Continuez à télécharger des fichiers partiellement téléchargés ou des parties de téléchargement en plusieurs parties.
Redémarre/partie les fichiers qui n'ont pas la taille et le md5 correspondants. Ignore les fichiers/parties qui
faire. Remarque : les vérifications de la somme md5 ne sont pas toujours suffisantes pour vérifier l'égalité des fichiers (parties).
Activez cela à vos risques et périls.

--id-téléchargement=UPLOAD_ID
UploadId pour le téléchargement en plusieurs parties, au cas où vous souhaiteriez continuer un téléchargement existant
(équivalent à --Continuez- put) et il y a plusieurs téléchargements partiels. Utiliser s3cmd
multipart [URI] pour voir quels UploadIds sont associés à l'URI donné.

--sauter-existant
Ignorer les fichiers qui existent à la destination (uniquement pour les commandes [get] et [sync]).

-r, --recursive
Téléchargement, téléchargement ou suppression récursifs.

--check-md5
Vérifiez les sommes MD5 lors de la comparaison des fichiers pour [sync]. (défaut)

--no-check-md5
Ne vérifiez pas les sommes MD5 lors de la comparaison des fichiers pour [sync]. Seule la taille sera comparée.
Peut accélérer considérablement le transfert, mais peut également manquer certains fichiers modifiés.

-P, --acl-public
Stockez des objets avec ACL permettant la lecture pour n'importe qui.

--acl-privé
Stockez les objets avec une liste de contrôle d'accès par défaut autorisant l'accès pour vous uniquement.

--acl-subvention=PERMISSION : EMAIL ou USER_CANONICAL_ID
Accordez une autorisation déclarée à un utilisateur amazon donné. L'autorisation est l'une des suivantes : lire, écrire,
read_acp, write_acp, full_control, tous

--acl-révoquer=PERMISSION :USER_CANONICAL_ID
Révoquer l'autorisation déclarée pour un utilisateur amazon donné. L'autorisation est l'une des suivantes : lire,
écrire, read_acp, wr ite_acp, full_control, tous

-D NUM, --restauration-jours=NUM
Nombre de jours pour garder le fichier restauré disponible (uniquement pour la commande 'restaurer').

--delete-supprimé
Supprimer les objets distants sans fichier local correspondant [sync]

--no-delete-supprimé
Ne supprimez pas les objets distants.

--delete-après
Effectuer des suppressions après de nouveaux téléchargements [sync]

--delay-mises à jour
*OBSOLÈTE* Mettez tous les fichiers mis à jour en place à la fin [sync]

--max-supprimer=NUM
Ne supprimez pas plus de NUM fichiers. [supprimer] et [synchroniser]

--ajouter une destination=DESTINATIONS_ADDITIONNELLES
Destination supplémentaire pour les téléchargements parallèles, en plus du dernier argument. Peut-être
répété.

--delete-after-fetch
Supprimer les objets distants après la récupération dans le fichier local (uniquement pour [get] et [sync]
commandes).

-p, --préserver
Conserver les attributs du système de fichiers (mode, propriété, horodatage). Par défaut pour [sync]
commander.

--pas de conservation
Ne pas stocker les attributs FS

--exclure=GLOB
Les noms de fichiers et les chemins correspondant à GLOB seront exclus de la synchronisation

--exclure de=FICHIER
Lire --exclure les GLOBs de FILE

--exclure=EXPREG
Les noms de fichiers et les chemins correspondant à REGEXP (expression régulière) seront exclus de la synchronisation

--rexclude-de=FICHIER
Lire --rexclude les REGEXP de FILE

--comprendre=GLOB
Les noms de fichiers et les chemins correspondant à GLOB seront inclus même s'ils ont été précédemment exclus par
un --(r)exclure(-de) motifs

--include-de=FICHIER
Lire --include GLOBs à partir de FILE

--rinclure=EXPREG
Identique à --include mais utilise REGEXP (expression régulière) au lieu de GLOB

--rinclude-de=FICHIER
Lire --rinclude REGEXP à partir de FILE

--files-de=FICHIER
Lire la liste des noms de fichiers source à partir de FILE. Utilisez - pour lire à partir de stdin.

--Région=RÉGION, --bucket-emplacement=RÉGION
Région dans laquelle créer un bucket. Pour l'instant, les régions sont : us-east-1, us-west-1,
us-west-2, eu-west-1, eu-central-1, ap-northeast-1, ap-southeast-1, ap-
sud-est-2, sa-est-1

--hôte= NOM D'HTE
HOSTNAME : PORT pour le point de terminaison S3 (par défaut : s3.amazonaws.com, des alternatives telles que
s3-eu-west-1.amazonaws.com). Vous devez également définir --hôte- seau.

--host-bucket=HOST_BUCKET
Seau de style DNS + nom d'hôte : modèle de port pour accéder à un compartiment (par défaut :
%(seau)s.s3.amazonaws.com)

--redondance-réduite, --rr
Objet de stockage avec 'redondance réduite'. Prix ​​par Go inférieur. [mettre, cp, mv]

--pas de redondance réduite, --non-rr
Objet de stockage sans 'redondance réduite'. Prix ​​par Go plus élevé. [mettre, cp, mv]

--classe de stockage=CLASSE
Stockez l'objet avec la CLASSE spécifiée (STANDARD, STANDARD_IA ou REDUCED_REDUNDANCY).
Prix ​​par Go inférieur. [mettre, cp, mv]

--access-logging-target-prefix=LOG_TARGET_PREFIX
Préfixe cible pour les journaux d'accès (URI S3) (pour les commandes [cfmodify] et [accesslog])

--pas de journalisation d'accès
Désactiver la journalisation des accès (pour les commandes [cfmodify] et [accesslog])

--default-type-mime=DEFAULT_MIME_TYPE
Type MIME par défaut pour les objets stockés. La valeur par défaut de l'application est binaire/octet-stream.

-M, --deviner-type-mime
Devinez le type MIME des fichiers par leur extension ou leur magie mime. Revenir à défaut
Type MIME tel que spécifié par --default-type-mime option

--no-guess-mime-type
Ne devinez pas le type MIME et utilisez plutôt le type par défaut.

--pas de magie du mime
N'utilisez pas la magie mime pour deviner le type MIME.

-m MIME/TYPE, --type-mime=MIME/TYPE
Forcer le type MIME. Remplacer les deux --default-type-mime et --deviner-type-mime.

--add-en-tête=NOM:VALEUR
Ajoutez un en-tête HTTP donné à la demande de téléchargement. Peut être utilisé plusieurs fois. Pour
définissez les en-têtes « Expires » ou « Cache-Control » (ou les deux) à l'aide de cette option.

--remove-en-tête=NOM
Supprimer un en-tête HTTP donné. Peut être utilisé plusieurs fois. Par exemple, supprimez
Les en-têtes 'Expires' ou 'CacheControl' (ou les deux) en utilisant cette option. [modifier]

--cryptage côté serveur
Spécifie que le chiffrement côté serveur sera utilisé lors du placement des objets. [mettre,
synchroniser, cp, modifier]

--server-side-encryption-kms-id=KMS_CLÉ
Spécifie l'ID de clé utilisé pour le chiffrement côté serveur avec les clés gérées par AWS KMS
(SSE-KMS) lors de la mise en place d'objets. [mettre, synchroniser, cp, modifier]

--codage=ENCODAGE
Remplacez l'encodage du terminal et du système de fichiers détecté automatiquement (jeu de caractères).
Détecté automatiquement : UTF-8

--add-encoding-exts= EXTENSIONS
Ajoutez un encodage à ces extensions délimitées par des virgules, c'est-à-dire (css, js, html) lors du téléchargement
à S3)

--textuellement
Utilisez le nom S3 tel qu'il est indiqué sur la ligne de commande. Pas de pré-traitement, d'encodage, etc.
Utiliser avec précaution!

--disable-multipart
Désactiver le téléchargement partitionné sur les fichiers plus gros que --multipart-chunk-size-mb

--multipart-chunk-size-mb=TAILLE
Taille de chaque bloc d'un téléchargement en plusieurs parties. Les fichiers plus grands que SIZE sont automatiquement
téléchargés en tant que multithread-multipart, les fichiers plus petits sont téléchargés à l'aide du
méthode traditionnelle. SIZE est en méga-octets, la taille de bloc par défaut est de 15 Mo, minimum
la taille de bloc autorisée est de 5 Mo, le maximum est de 5 Go.

--list-md5
Incluez les sommes MD5 dans les listes de compartiments (uniquement pour la commande 'ls').

-H, --humain-lisible-tailles
Tailles d'impression sous une forme lisible par l'homme (par exemple 1 Ko au lieu de 1234).

--ws-index=INDEX_SITE WEB
Nom du document d'index (uniquement pour la commande [ws-create])

--ws-erreur=ERREUR_SITE WEB
Nom du document d'erreur (uniquement pour la commande [ws-create])

--date d'expiration=DATE_EXPIRATION
Indique quand la règle d'expiration prend effet. (uniquement pour la commande [expire])

--expiration-jours=EXPIRY_DAYS
Indique le nombre de jours après la création de l'objet que prend la règle d'expiration
effet. (uniquement pour la commande [expire])

--préfixe-d'expiration=EXPIRY_PREFIX
Identifier un ou plusieurs objets avec le préfixe auquel la règle d'expiration
s'applique. (uniquement pour la commande [expire])

--le progrès
Affichage du compteur de progression (par défaut sur TTY).

--pas de progrès
Ne pas afficher le compteur de progression (par défaut sur non-TTY).

--Statistiques
Donnez quelques statistiques de transfert de fichiers.

--permettre
Activer la distribution CloudFront donnée (uniquement pour la commande [cfmodify])

--désactiver
Activer la distribution CloudFront donnée (uniquement pour la commande [cfmodify])

--cf-invalider
Invalidez le fichier téléchargé dans CloudFront. Voir aussi la commande [cfinval].

--cf-invalidate-index-par-défaut
Lorsque vous utilisez Custom Origin et le site Web statique S3, invalidez le fichier d'index par défaut.

--cf-no-invalidate-default-index-root
Lorsque vous utilisez Custom Origin et le site Web statique S3, n'invalidez pas le chemin d'accès au
fichier d'index par défaut.

--cf-add-cname=CNOM
Ajouter un CNAME donné à une distribution CloudFront (uniquement pour [cfcreate] et [cfmodify]
commandes)

--cf-remove-cname=CNOM
Supprimer le CNAME donné d'une distribution CloudFront (uniquement pour la commande [cfmodify])

--cf-commentaire=COMMENTAIRE
Définissez COMMENT pour une distribution CloudFront donnée (uniquement pour [cfcreate] et [cfmodify]
commandes)

--cf-objet-racine-par défaut=DEFAULT_ROOT_OBJECT
Définissez l'objet racine par défaut à renvoyer lorsqu'aucun objet n'est spécifié dans l'URL. Utiliser un
chemin relatif, c'est-à-dire default/index.html au lieu de /default/index.html ou
s3://bucket/default/index.html (uniquement pour les commandes [cfcreate] et [cfmodify])

-v, --verbeux
Activer la sortie détaillée.

-d, --déboguer
Activer la sortie de débogage.

--version
Affichez la version s3cmd (1.6.1) et quittez.

-F, --follow-symlinks
Suivez les liens symboliques comme s'il s'agissait de fichiers normaux

--cache-fichier=FICHIER
Cache FILE contenant les valeurs MD5 de la source locale

-q, --silencieux
Sortie de silence sur stdout

--ca-certs=CA_CERTS_FILE
Chemin d'accès au certificat SSL CA FILE (au lieu de la valeur par défaut du système)

--check-certificat
Vérifier la validité du certificat SSL

- no-check-certificate
Ne pas vérifier la validité du certificat SSL

--check-nom d'hôte
Vérifier la validité du nom d'hôte du certificat SSL

--no-check-nom d'hôte
Ne pas vérifier la validité du nom d'hôte du certificat SSL

--signature-v2
Utilisez AWS Signature version 2 au lieu de méthodes de signature plus récentes. Utile pour S3-like
systèmes qui n'ont pas encore AWS Signature v4.

--taux-limite=TAUX LIMITE
Limitez la vitesse de chargement ou de téléchargement au nombre d'octets par seconde. Le montant peut être
exprimé en octets, kilo-octets avec le suffixe k ou mégaoctets avec le suffixe m

--demandeur-payeur
Définir le drapeau REQUESTER PAYS pour les opérations

-l, --long-liste
Produire une longue liste [ls]

--stop-sur-erreur
stop si erreur de transfert

--contenu-disposition=CONTENU_DISPOSITION
Fournissez une disposition de contenu pour les URL signées, par exemple, "inline; filename=myvideo.mp4"

--type-de-contenu=CONTENT_TYPE
Fournissez un type de contenu pour les URL signées, par exemple, "video/mp4"

EXEMPLES

L'une des commandes les plus puissantes de s3cmd is s3cmd synchroniser utilisé pour la synchronisation complète
arborescences de répertoires vers ou depuis le stockage S3 distant. Dans une certaine mesure s3cmd mettre et s3cmd obtenez share
un comportement similaire avec synchroniser.

L'utilisation de base courante dans les scénarios de sauvegarde est aussi simple que :
s3cmd sync /local/path/ s3://test-bucket/backup/

Cette commande trouvera tous les fichiers sous le répertoire /local/path et les copiera dans
chemins correspondants sous s3://test-bucket/backup du côté distant. Par exemple:
/local/chemin/fichier1.ext -> s3://bucket/backup/fichier1.ext
/local/chemin/dir123/fichier2.bin -> s3://bucket/backup/dir123/fichier2.bin

Cependant, si le chemin local ne se termine pas par une barre oblique, le dernier nom du répertoire est utilisé sur
le côté distant aussi. Comparez-les avec l'exemple précédent :
synchronisation s3cmd /local/chemin s3://test-bucket/backup/
synchronisera :
/locale/chemin/fichier1.ext -> s3://bucket/backup/chemin/fichier1.ext
/locale/chemin/rép123/fichier2.bin -> s3://bucket/backup/chemin/rép123/fichier2.bin

Pour récupérer les fichiers de S3, utilisez la syntaxe inversée :
synchronisation s3cmd s3://test-bucket/backup/ ~/restaurer/
qui téléchargera les fichiers :
s3://seau/sauvegarde/fichier1.ext -> ~/restaurer/fichier1.ext
s3://seau/sauvegarde/dir123/fichier2.bin -> ~/restaurer/dir123/fichier2.bin

Sans la barre oblique de fin sur la source, le comportement est similaire à ce qui a été
démontré avec le téléchargement :
synchronisation s3cmd s3://test-bucket/backup ~/restaurer/
téléchargera les fichiers en tant que :
s3://seau/sauvegarde/fichier1.ext -> ~/restaurer/sauvegarde/fichier1.ext
s3://seau/sauvegarde/rép123/file2.bin -> ~/restaurer/sauvegarde/rép123/file2.bin

Tous les noms de fichiers source, ceux en gras ci-dessus, sont comparés à exclure les règles et celles
cette correspondance est ensuite revérifiée par rapport de Swanson comprennent règles pour voir si elles doivent être
exclus ou conservés dans la liste des sources.

Dans le but de --exclure et --comprendre correspondant uniquement aux noms de fichiers en gras ci-dessus sont
utilisé. Par exemple seulement chemin/fichier1.ext est testé par rapport aux modèles, non
/locale/chemin/fichier1.ext

Le --exclure et --comprendre fonctionne avec des caractères génériques de style shell (alias GLOB). Pour une plus grande
flexibilité s3cmd fournit des versions d'expression régulière des deux options d'exclusion nommées
--exclure et --rinclure. Les options avec...-de suffixe (par exemple --rinclude-from) attend un
nom de fichier comme argument. Chaque ligne d'un tel fichier est traitée comme un motif.

Il n'y a qu'un seul ensemble de modèles construit à partir de tous --(r)exclure(-de) options et de même
pour inclure la variante. Tout fichier exclu avec par exemple --exclude peut être remis avec un motif
trouvé dans la liste --rinclude-from.

Exécutez s3cmd avec - à sec pour vérifier que vos règles fonctionnent comme prévu. Utiliser avec
--déboguer obtenir des informations détaillées sur la correspondance des noms de fichiers avec les exclusions et les inclusions
règles.

Par exemple pour exclure tous les fichiers avec l'extension ".jpg" loading="lazy" sauf ceux commençant par un
utilisation du nombre :

--exclude '*.jpg' --rinclude '[0-9].*.jpg'

Pour exclure tous les fichiers à l'exception de l'extension "*.jpg" loading="lazy", utilisez :

--exclude '*' --include '*.jpg'

Pour exclure le répertoire local « somedir », assurez-vous d'utiliser une barre oblique finale, en tant que telle :

--exclude 'somedir/'

Utiliser s3cmd en ligne à l'aide des services onworks.net