:Commands for operations on objects

ls(list)

Commande :

ls(list) oss://bucket/[prefix] [marker] [delimiter] [maxkeys]

Liste les objets d'un bucket. Spécifiez un préfixe pour lister tous les objets dont le nom commence par ce préfixe. Par exemple, si le préfixe est abc, la commande liste tous les objets dont le nom commence par abc.

Exemples :

• python osscmd ls oss://mybucket/folder1/folder2

• python osscmd ls oss://mybucket/folder1/folder2 marker1

• python osscmd ls oss://mybucket/folder1/folder2 marker1 /

• python osscmd ls oss://mybucket/

• python osscmd list oss://mybucket/ "" "" 100

Commande :

ls(list) oss://bucket/[prefix] --marker=xxx --delimiter=xxx --maxkeys=xxx
        --encoding_type=url

Liste les objets d'un bucket. Le paramètre encoding_type spécifie la méthode d'encodage des noms d'objets dans la réponse. Si vous définissez ce paramètre sur url, les objets contenant des caractères de contrôle dans leur nom s'affichent correctement.

Exemples :

• python osscmd ls oss://mybucket/folder1/folder2 --delimiter=/

• python osscmd ls oss://mybucket/folder1/folder2 --marker=a

• python osscmd ls oss://mybucket/folder1/folder2 --maxkeys=10

mkdir

Commande :

mkdir oss://bucket/dirname

Crée un dossier.

Exemple :

python osscmd mkdir oss://mybucket/folder

listallobject

Commande :

listallobject oss://bucket/[prefix]

Liste tous les objets d'un bucket. Spécifiez un préfixe pour ne lister que les objets dont le nom commence par ce préfixe.

Exemples :

• python osscmd listallobject oss://mybucket

• python osscmd listallobject oss://mybucket/testfolder/

deleteallobject

Commande :

deleteallobject oss://bucket/[prefix]

Supprime tous les objets d'un bucket. Spécifiez un préfixe pour ne supprimer que les objets dont le nom commence par ce préfixe.

Exemples :

• python osscmd deleteallobject oss://mybucket

• python osscmd deleteallobject oss://mybucket/testfolder/

downloadallobject

Commande :

downloadallobject oss://bucket/[prefix] localdir --replace=false
      --thread_num=5

Télécharge les objets d'un bucket vers un répertoire local en préservant la structure des répertoires. Spécifiez un préfixe pour ne télécharger que les objets dont le nom commence par ce préfixe. Si vous définissez --replace sur false, les fichiers locaux existants portant le même nom ne sont pas écrasés. Si vous le définissez sur true, ils sont écrasés. Vous pouvez également utiliser thread_num pour configurer le nombre de threads de téléchargement.

Exemples :

• python osscmd downloadallobject oss://mybucket /tmp/folder

• python osscmd downloadallobject oss://mybucket /tmp/folder
          –-replace=false

• python osscmd downloadallobject oss://mybucket /tmp/folder –-replace=true
            --thread_num=5

downloadtodir

Commande :

downloadtodir oss://bucket/[prefix] localdir --replace=false

Télécharge les objets d'un bucket vers un répertoire local en préservant la structure des répertoires. Spécifiez un préfixe pour ne télécharger que les objets dont le nom commence par ce préfixe. Si vous définissez --replace sur false, les fichiers locaux existants portant le même nom ne sont pas écrasés. Si vous le définissez sur true, ils sont écrasés. La commande downloadtodir fonctionne de la même manière que la commande downloadallobject.

Exemples :

• python osscmd downloadtodir oss://mybucket /tmp/folder

• python osscmd downloadtodir oss://mybucket /tmp/folder –-replace=false

• python osscmd downloadtodir oss://mybucket /tmp/folder
        –-replace=true

uploadfromdir

Commande :

uploadfromdir localdir oss://bucket/[prefix] --check_point=check_point_file --replace=false
        --check_md5=false --thread_num=5

Téléverse les fichiers d'un répertoire local vers un bucket.

Par exemple, si le répertoire local /tmp/ contient les fichiers a/b, a/c et a, les fichiers sont téléversés vers oss://bucket/a/b, oss://bucket/a/c et oss://bucket/a. Si vous spécifiez le préfixe mytest, les fichiers sont téléversés vers oss://bucket/mytest/a/b, oss://bucket/mytest/a/c et oss://bucket/mytest/a.

Le paramètre --check_point=check_point_file spécifie un fichier de point de contrôle. Après avoir spécifié le fichier, osscmd stocke les horodatages des fichiers locaux téléversés dans le fichier de point de contrôle. La commande uploadfromdir compare ensuite l'horodatage d'un fichier à téléverser avec l'horodatage enregistré dans le fichier de point de contrôle. Si l'horodatage a changé, le fichier est à nouveau téléversé. Sinon, le téléversement est ignoré. Par défaut, aucun fichier de point de contrôle n'est utilisé. Si vous définissez --replace sur false, les objets existants du bucket portant le même nom ne sont pas écrasés. Si vous le définissez sur true, ils sont écrasés. Si vous définissez --check_md5 sur false, l'en-tête de requête Content-MD5 n'est pas inclus et la vérification MD5 n'est pas effectuée. Si vous le définissez sur true, la vérification MD5 est effectuée.

Remarque : Le fichier de point de contrôle enregistre les informations sur tous les fichiers téléversés.

Exemples :

• python osscmd uploadfromdir /mytemp/folder oss://mybucket

• python osscmd uploadfromdir /mytemp/folder oss://mybucket
            --check_point_file=/tmp/mytemp_record.txt

• python osscmd uploadfromdir C:\Documents and Settings\User\My Documents\Downloads
            oss://mybucket --check_point_file=C:\cp.txt

put

Commande :

put localfile oss://bucket/object --content-type=[content_type]
        --headers="key1:value1#key2:value2" --check_md5=false

Téléverse un fichier local vers un bucket. Vous pouvez spécifier le content-type de l'objet ou des en-têtes personnalisés. Si vous définissez --check_md5 sur false, l'en-tête de requête Content-MD5 n'est pas inclus et la vérification MD5 n'est pas effectuée. Si vous le définissez sur true, la vérification MD5 est effectuée.

Exemples :

• python osscmd put myfile.txt oss://mybucket

• python osscmd put myfile.txt oss://mybucket/myobject.txt

• python osscmd put myfile.txt oss://mybucket/test.txt --content-type=plain/text
            --headers=“x-oss-meta-des:test#x-oss-meta-location:CN”

• python osscmd put myfile.txt oss://mybucket/test.txt
          --content-type=plain/text

upload

Commande :

upload localfile oss://bucket/object --content-type=[content_type]
      --check_md5=false

Vous pouvez téléverser un fichier local en tant que groupe d'objets. Cette opération n'est pas recommandée. --check_md5=false désactive la vérification de l'en-tête de requête Content-MD5 lors du téléversement d'un fichier. Si ce paramètre est défini sur true, l'en-tête est vérifié.

Exemple :

python osscmd upload myfile.txt oss://mybucket/test.txt
        --content-type=plain/text

get

Commande :

get oss://bucket/object localfile

Télécharge un objet vers un fichier local.

Exemple :

python osscmd get oss://mybucket/myobject /tmp/localfile

multiget(multi_get)

Commande :

multiget(multi_get) oss://bucket/object localfile --thread_num=5

Télécharge un objet vers un fichier local en utilisant plusieurs threads. Vous pouvez configurer le nombre de threads.

Exemples :

• python osscmd multiget oss://mybucket/myobject /tmp/localfile

• python osscmd multi_get oss://mybucket/myobject /tmp/localfile

cat

Description :

cat oss://bucket/object

Lit et affiche le contenu d'un objet. N'utilisez pas cette commande pour les objets volumineux.

Exemple :

python osscmd cat oss://mybucket/myobject

meta

Commande :

meta oss://bucket/object

Lit et affiche les métadonnées d'un objet. Les métadonnées incluent le content-type, la longueur du fichier et les métadonnées personnalisées.

Exemple :

python osscmd meta oss://mybucket/myobject

copy

Commande :

copy oss://source_bucket/source_object oss://target_bucket/target_object
        --headers="key1:value1#key2:value2"

Copie un objet source depuis un bucket source vers un objet cible dans un bucket cible.

Exemple :

python osscmd copy oss://bucket1/object1 oss://bucket2/object2

rm(delete,del)

Commande :

rm(delete,del) oss://bucket/object --encoding_type=url

Supprime un objet. Si vous définissez encoding-type sur url, le nom de l'objet doit également être encodé en URL.

Exemples :

• python osscmd rm oss://mybucket/myobject

• python osscmd delete oss://mybucket/myobject

• python osscmd del oss://mybucket/myobject

• python osscmd del oss://mybucket/my%01object --encoding_type=url

signurl(sign)

Commande :

signurl(sign) oss://bucket/object --timeout=[timeout_seconds]

Génère une URL signée avec une période d'expiration spécifiée. Cela s'avère utile pour accorder un accès temporaire à un objet spécifique dans un bucket privé.

Exemples :

• python osscmd sign oss://mybucket/myobject

• python osscmd signurl oss://mybucket/myobject