Memulai Cepat - - 阿里云

Topik ini menjelaskan cara menggunakan alat osscmd.

Penting osscmd tidak tersedia sejak 31 Juli 2019. Alibaba Cloud tidak lagi memperbarui atau memelihara osscmd. Perintah operasi osscmd diintegrasikan ke dalam ossutil.

Menggunakan alat osscmd

Setelah mengunduh dan mengekstrak paket instalasi SDK, Anda dapat menggunakan alat osscmd.

Anda dapat memanggil Python osscmd untuk mendapatkan instruksi tentang cara menjalankan perintah yang didukung oleh alat osscmd. Gunakan salah satu metode berikut untuk menjalankan setiap perintah. Contoh berikut menunjukkan cara menjalankan perintah gs untuk mendapatkan bucket yang dibuat oleh pengguna tertentu:

Metode 1: Alat osscmd membaca ID AccessKey dan AccessKey Secret dari file default. Dalam hal ini, Anda tidak perlu menentukan ID AccessKey dan AccessKey Secret.
```
$ python osscmd gs
tidak dapat mendapatkan accessid/accesskey, atur dengan : config --id=accessid --key=accesskey
```
Catatan Jika keluaran serupa ditampilkan, ID AccessKey dan AccessKey Secret gagal dibaca. Untuk informasi lebih lanjut tentang cara menentukan ID AccessKey dan AccessKey Secret, lihat Metode 2.
Pastikan bahwa ID AccessKey dan AccessKey Secret valid. Setelah menentukan ID AccessKey dan AccessKey Secret, jalankan perintah berikut:
```
$ python osscmd gs
2013-07-19 08:11 test-oss-sample
Jumlah Bucket adalah: 1
```
Metode 2: Tentukan ID AccessKey dan AccessKey Secret di baris perintah. Alat osscmd membaca ID AccessKey dan AccessKey Secret dari baris perintah. Jika ID AccessKey dan AccessKey Secret valid, jalankan perintah berikut:
```
$ python osscmd gs --id=id_anda --key=kunci_anda --host=titik_akhir_anda
2013-07-19 08:11 test-oss-sample
Jumlah Bucket adalah: 1
```
Untuk mengonfigurasi ID AccessKey dan AccessKey Secret dan mengimpornya ke file default, jalankan perintah berikut. Nama domain default OSS adalah oss.aliyuncs.com.
```
$python osscmd config --id=id_anda --key=kunci_anda --host=titik_akhir_anda
```
Jika keluaran serupa Konfigurasi Anda disimpan ke dalam ditampilkan, ID AccessKey dan AccessKey Secret telah disimpan.

Operasi Dasar

Daftar bucket yang dibuat
```
$python osscmd getallbucket
```
Tidak ada bucket yang ditampilkan jika pengguna tidak memiliki bucket di OSS.
Buat sebuah bucket
Buat sebuah bucket bernama mybucketname.
```
$python osscmd createbucket mybucketname
```
Bucket mungkin gagal dibuat. Penyebabnya adalah nama bucket harus unik di OSS. Anda perlu menggunakan nama bucket lain. Misalnya, Anda dapat menambahkan tanggal tertentu ke nama bucket.
Periksa apakah sebuah bucket telah dibuat
```
$python osscmd getallbucket
```
Jika bucket gagal dibuat, periksa pesan kesalahan yang dikembalikan dari alat osscmd.
Lihat objek
Setelah bucket dibuat, Anda dapat melihat objek di dalam bucket tersebut.
```
$python osscmd list oss://mybucketname/
```
Jika tidak ada objek di dalam bucket, tidak ada objek yang ditampilkan.
Unggah sebuah file
Unggah file lokal ke bucket. Jika file lokal bernama local_existed_file, jalankan perintah berikut untuk menghitung nilai MD5 dari file dan mengunggah file lokal ke bucket:
```
$ md5sum local_existed_file 7625e1adc3a4b129763d580ca0a78e44 local_existed_file
$ python osscmd put local_existed_file oss://mybucketname/test_object
```
Catatan md5sum hanya berjalan di Linux.
Lihat objek lagi
Anda dapat melihat objek yang telah diunggah ke bucket.
```
$python osscmd list oss://mybucketname/
```
Unduh sebuah objek
Unduh objek dari bucket ke file lokal. Bandingkan nilai MD5 objek yang diunduh dengan nilai MD5 objek yang dihitung sebelum objek diunduh.
```
$ python osscmd get oss://mybucketname/test_object download_file
$ md5sum download_file 
7625e1adc3a4b129763d580ca0a78e44  download_file
```
Catatan md5sum hanya berjalan di Linux.
Hapus sebuah objek
$ python osscmd delete oss://mybucketname/test_object
Hapus sebuah bucket
Catatan Jika bucket berisi objek, bucket tidak dapat dihapus.
```
$ python osscmd deletebucket mybucketname
```

Gunakan siklus hidup

Buat file TXT dan simpan sebagai file XML. Gunakan file XML untuk mengonfigurasi aturan siklus hidup.
```
<LifecycleConfiguration>
    <Rule>
        <ID>1125</ID>
        <Prefix>log_backup/</Prefix>
        <Status>Enabled</Status>
        <Expiration>
            <Days>2</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>
```
Jika Anda menjalankan kode di atas, objek yang namanya diawali dengan log_backup/ dan yang disimpan selama dua hari sejak waktu modifikasi terakhirnya akan dihapus. Untuk informasi lebih lanjut tentang konfigurasi aturan siklus hidup, lihat Referensi API.

Tulis aturan siklus hidup.

python osscmd putlifecycle oss://mybucket lifecycle.xml
0.150(s) berlalu

Baca aturan siklus hidup.

python osscmd getlifecycle oss://mybucket
<? xml version="1.0" encoding="UTF-8"? >
<LifecycleConfiguration>
  <Rule>
    <ID>1125</ID>
    <Prefix>log_backup/</Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <Days>2</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>
0.027(s) berlalu

Hapus aturan siklus hidup.

python osscmd deletelifecycle oss://mybucket
0.139(s) berlalu

Baca aturan siklus hidup.

python osscmd getlifecycle oss://mybucket
Kesalahan Header:
[('content-length', '288'), ('server', 'AliyunOSS'), ('connection', 'close'), ('x-oss-request-id', '54C74FEE5D7F6B24E5042630'), ('date', 'Tue, 27 Jan 2015 08:44:30 GMT'), ('content-type', 'application/xml')]
Badan Kesalahan:
<? xml version="1.0" encoding="UTF-8"? >
<Error>
  <BucketName>mybucket</BucketName>
  <Code>NoSuchLifecycle</Code>
  <Message>Tidak ditemukan Baris di Tabel Siklus Hidup. </Message>
  <RequestId>54C74FEE5D7F6B24E5042630</RequestId>
  <HostId>mybucket.oss-maque-hz-a.alibaba.net</HostId>
</Error>
Status Kesalahan:
404
getlifecycle Gagal!

Konfigurasikan perlindungan hotlinking

Izinkan akses dari permintaan yang memiliki bidang Referer kosong.

$osscmd putreferer oss://test --allow_empty_referer=true
0.004(s) berlalu

Dapatkan daftar putih Referer.

$osscmd getreferer oss://test
<? xml version="1.0" encoding="UTF-8"? >
<RefererConfiguration>
  <AllowEmptyReferer>true</AllowEmptyReferer>
  <RefererList />
</RefererConfiguration>

Bidang Referer diperlukan. Hanya permintaan yang memiliki nilai bidang Referer www.example.com yang diizinkan.
```
$osscmd putreferer oss://test --allow_empty_referer=false --referer='www.example.com'
0.092(s) berlalu
```

Dapatkan daftar putih Referer.

$osscmd getreferer oss://test
<? xml version="1.0" encoding="UTF-8"? >
<RefererConfiguration>
  <AllowEmptyReferer>false</AllowEmptyReferer>
  <RefererList>
    <Referer>www.example.com</Referer>
  </RefererList>
</RefererConfiguration>

Bidang Referer diperlukan. Hanya permintaan yang memiliki nilai bidang Referer www.example.com atau www.example.org yang diizinkan.
```
$osscmd putreferer oss://test --allow_empty_referer=false --referer='www.example.com,www.example.org'
```

Dapatkan daftar putih Referer.

$osscmd getreferer oss://test
<? xml version="1.0" encoding="UTF-8"? >
<RefererConfiguration>
  <AllowEmptyReferer>false</AllowEmptyReferer>
  <RefererList>
    <Referer>www.example.com</Referer>
    <Referer>www.example.org</Referer>
  </RefererList>
</RefererConfiguration>

Gunakan logging

Konfigurasikan aturan logging

$osscmd putlogging oss://mybucket oss://myloggingbucket/mb

Dapatkan aturan logging yang dikonfigurasi untuk bucket
```
$osscmd getlogging oss://mybucket
```