Object Storage Service：bantuan

Perintah bantuan terintegrasi

Anda dapat menambahkan opsi -h atau --help pada akhir perintah untuk mendapatkan informasi bantuan terkait perintah tersebut. Gunakan ossutil [topik] untuk mendapatkan dokumentasi bantuan untuk topik yang ditentukan. Tabel berikut menyediakan contoh perintah bantuan.

ossutil -h

ossutil cp -h

ossutil api -h

ossutil api put-bucket-cors -h

ossutil filter

Informasi bantuan perintah

Perintah dibagi menjadi dua kategori: perintah induk dan subperintah. Perintah induk mencakup subperintah, sedangkan subperintah tidak mencakup perintah lainnya.

Perintah induk

Informasi bantuan tentang perintah induk mencakup lima aspek: deskripsi, penggunaan, daftar subperintah, topik bantuan tambahan, dan informasi bantuan lainnya.

ossutil adalah alat untuk mengelola data OSS (Object Storage Service).

Penggunaan: ossutil [perintah]

Perintah yang Tersedia:
  api         Perintah tingkat API
  append      Menambahkan konten ke objek yang dapat ditambahkan
  cat         Menggabungkan objek ke output standar
  config      Membuat file konfigurasi dan menyimpan pengaturan konfigurasi serta kredensial
  cp          Unggah, Unduh, atau Salin Objek
  du          Dapatkan ukuran penyimpanan bucket atau prefix(directory) yang ditentukan
  hash        Dapatkan nilai hash dari file
  help        Bantuan tentang perintah apa pun
  ls          Daftar bucket atau objek
  mb          Membuat bucket
  mkdir       Buat objek dengan akhiran nama '/'
  presign     Hasilkan URL pra-tandatangan untuk objek
  probe       Perintah deteksi
  rb          Hapus bucket
  restore     Pulihkan objek dalam status beku ke status siap dibaca
  revert      Kembalikan objek yang dihapus ke status versi terbaru
  rm          Menghapus objek
  set-props   Tetapkan properti objek
  stat        Tampilkan informasi meta tentang bucket atau objek
  sync        Sinkronkan direktori file lokal atau objek dari sumber ke tujuan
  update      Perbarui ossutil
  version     Tampilkan versi

Topik bantuan tambahan:
  filter      Informasi lebih lanjut tentang flag filter, dan bagaimana menggunakannya dalam perintah

Gunakan "ossutil [perintah] --help" untuk informasi lebih lanjut tentang perintah.
Gunakan "ossutil [topik]" untuk informasi lebih lanjut tentang topik.

Subperintah

Informasi bantuan tentang subperintah mencakup enam aspek: deskripsi, penggunaan, alias opsional, contoh, flag lokal (opsi), dan flag global (opsi).

ossutil cat -h --language en
Menggabungkan objek ke output standar.
Untuk menjalankan perintah ini, Anda harus memiliki izin oss:GetObject.

Penggunaan: ossutil cat oss://bucket/object [flags]

Contoh:

1) Lihat isi objek example.txt di bucket examplebucket. 
  ossutil cat oss://examplebucket/example.txt

2) Lihat isi objek example.txt dengan ID versi CAEQARiBgID8rumR2h*** di examplebucket.
  ossutil cat oss://examplebucket/example.txt --version-id CAEQARiBgID8rumR2h***

3) Tentukan rentang dan lihat isi objek example.txt di bucket examplebucket.
  Cetak hanya 10 karakter pertama
  ossutil cat oss://examplebucket/example.txt --head 10

  Cetak hanya 10 karakter terakhir
  ossutil cat oss://examplebucket/example.txt --tail 10

  Cetak semua karakter mulai dari offset 10
  ossutil cat oss://examplebucket/example.txt --offset 10

  Cetak 20 karakter dari offset 10
  ossutil cat oss://examplebucket/example.txt --offset 10 --count 20

Flags:
      --count int              Cetak hanya N karakter (default -1)
      --encoding-type string   Jenis pengkodean nama objek atau nama file yang dimasukkan oleh pengguna, nilai valid: "url"
      --head int               Cetak hanya N karakter pertama
      --offset int             Mulai mencetak pada offset N
      --request-payer string   Pembayar permintaan. atur nilai ini jika Anda ingin membayar untuk peminta, nilai valid: "requester"
      --tail int               Cetak hanya N karakter terakhir
      --version-id string      Menentukan ID versi objek

Global Flags:
  -i, --access-key-id string        AccessKeyID saat mengakses oss
  -k, --access-key-secret string    AccessKeySecret saat mengakses oss
      --addressing-style string     Gaya dalam menangani titik akhir (default "virtual"), nilai valid: "virtual","path","cname"
  -c, --config-file string          jalur file konfigurasi (default "~\\.ossutilconfig")
      --connect-timeout int         waktu habis koneksi klien, satuannya: d. (default 10)
  -n, --dry-run                     lakukan uji coba tanpa perubahan permanen
  -e, --endpoint string             nama domain yang dapat digunakan layanan lain untuk mengakses OSS.
  -h, --help                        bantuan untuk perintah
      --language string             Bahasa teks tampilan
      --loglevel string             tingkat pesan debug (default "off"), nilai valid: "off","info","debug"
      --mode string                 Menentukan mode otentikasi, nilai valid: "AK","StsToken","EcsRamRole","Anonymous"
      --output-format string        gaya format untuk keluaran perintah (default "raw")
      --output-properties strings   properti format keluaran
      --output-query string         query JMESPath untuk digunakan dalam memfilter data respons
      --profile string              Profil spesifik dari file konfigurasi Anda.
      --read-timeout int            waktu habis pembacaan klien, satuannya: d. (default 20)
      --region string               wilayah tempat bucket berada.
      --retry-times int             jumlah percobaan ulang saat gagal (default 10)
      --sign-version string         Versi algoritma tanda tangan (default "v4"), nilai valid: "v1","v4"
      --skip-verify-cert            menentukan bahwa file sertifikat digital server oss tidak akan diverifikasi
  -t, --sts-token string            STSToken saat mengakses oss

Contoh 2: put-bucket-cosr

ossutil api put-bucket-cors -h --language en

Mengonfigurasi aturan Berbagi Sumber Daya Lintas Domain (CORS) untuk sebuah bucket.
*   Untuk memanggil operasi ini, Anda harus memiliki izin oss:PutBucketCors.
*   Desain dinonaktifkan secara default
    Secara default, CORS dinonaktifkan untuk bucket. Semua permintaan lintas domain tidak diizinkan.

*   Semantik penimpaan
    Jika Anda memanggil operasi PutBucketCors untuk mengonfigurasi aturan CORS baru untuk bucket yang sudah dikonfigurasi dengan aturan CORS, aturan yang ada akan ditimpa.

*   Penggunaan CORS dalam aplikasi
    Sebelum Anda dapat menggunakan CORS dalam aplikasi, Anda harus memanggil operasi PutBucketCors untuk mengonfigurasi aturan CORS untuk mengaktifkan CORS.
    Misalnya, Anda harus memanggil operasi PutBucketCors untuk mengonfigurasi aturan CORS untuk mengakses aplikasi Object Storage Service (OSS) dari example.com menggunakan fitur XMLHttpRequest browser. Anda harus mengonfigurasi aturan CORS dalam format XML.

*   Pencocokan aturan CORS
    Saat OSS menerima permintaan lintas wilayah atau permintaan OPTIONS, OSS membaca aturan CORS yang dikonfigurasi untuk bucket yang sesuai dan melakukan pemeriksaan izin. OSS memeriksa aturan secara bergantian. Jika OSS menemukan kecocokan pertama, header yang sesuai dikembalikan dalam respons. Jika permintaan gagal cocok dengan aturan CORS, header terkait CORS tidak dikembalikan dalam respons.
    OSS menganggap bahwa permintaan lintas domain atau permintaan OPTIONS cocok dengan aturan CORS hanya ketika permintaan memenuhi kondisi berikut:

    *   Asal dari mana permintaan lintas domain dikirim cocok dengan salah satu nilai AllowedOrigin dalam aturan CORS.
    *   Metode permintaan lintas domain seperti GET atau PUT atau metode yang sesuai dengan Access-Control-Request-Method dalam permintaan OPTIONS cocok dengan salah satu nilai AllowedMethod dalam aturan CORS.
    *   Setiap header yang disertakan dalam Access-Control-Request-Headers dalam permintaan OPTIONS cocok dengan salah satu nilai AllowedHeader dalam aturan CORS.

Deskripsi lebih lanjut tentang api ini, lihat juga: https://www.alibabacloud.com/help/en/oss/developer-reference/putbucketcors

Penggunaan: ossutil api put-bucket-cors --bucket value --cors-configuration value [flags]

Contoh:

--cors-configuration mendukung sintaks XML dan JSON,
dan ketika nilai opsi berisi awalan file://, itu berarti bahwa konfigurasi dibaca dari file.

Sintaks XML: 
<CORSConfiguration>
  <CORSRule>
    <AllowedOrigin>string</AllowedOrigin>
    ...
    <AllowedMethod>string</AllowedMethod>
    ...
    <AllowedHeader>string</AllowedHeader>
    <ExposeHeader>string</ExposeHeader>
    ...
    <MaxAgeSeconds>integer</MaxAgeSeconds>
  </CORSRule>
  ...
  <ResponseVary>boolean</ResponseVary>
</CORSConfiguration>

Sintaks JSON: 
{
  "CORSRule": [
    {
      "AllowedOrigin": ["string", ...],
      "AllowedMethod": ["string", ...],
      "AllowedHeader": "string",
      "ExposeHeader": ["string", ...],
      "MaxAgeSeconds": integer
    },
    ...
  ],
  "ResponseVary": boolean
}

1) Mengizinkan permintaan lintas domain PUT dan GET dari www.aliyun.com, dan menentukan bahwa browser menyimpan respons selama 10.000 detik.

Menggunakan file konfigurasi xml, cors-configuration.xml sebagai berikut:
<CORSConfiguration>
  <CORSRule>
    <AllowedOrigin>www.aliyun.com</AllowedOrigin>
    <AllowedMethod>PUT</AllowedMethod>
    <AllowedMethod>GET</AllowedMethod>
    <MaxAgeSeconds>10000</MaxAgeSeconds>
  </CORSRule>
</CORSConfiguration>

ossutil api put-bucket-cors --bucket examplebucket --cors-configuration file://cors-configuration.xml

Menggunakan file konfigurasi json, cors-configuration.json sebagai berikut:
{
  "CORSRule": {
    "AllowedOrigin": ["www.aliyun.com"],
    "AllowedMethod": ["PUT","GET"],
    "MaxAgeSeconds": 10000
  }
}
ossutil api put-bucket-cors --bucket examplebucket --cors-configuration file://cors-configuration.json

Menggunakan string json di baris perintah:
ossutil api put-bucket-cors --bucket examplebucket --cors-configuration  "{\"CORSRule\":{\"AllowedOrigin\":[\"www.aliyun.com\"],\"AllowedMethod\":[\"PUT\",\"GET\"],\"MaxAgeSeconds\":10000}}"


Flags:
      --bucket string               Nama bucket
      --cors-configuration string   Wadah yang menyimpan informasi tentang aturan CORS bucket

Global Flags:
  -i, --access-key-id string        AccessKeyID saat mengakses oss
  -k, --access-key-secret string    AccessKeySecret saat mengakses oss
      --addressing-style string     Gaya dalam menangani titik akhir (default "virtual"), nilai valid: "virtual","path","cname"
  -c, --config-file string          jalur file konfigurasi (default "~\\.ossutilconfig")
      --connect-timeout int         waktu habis koneksi klien, satuannya: d. (default 10)
  -n, --dry-run                     lakukan uji coba tanpa perubahan permanen
  -e, --endpoint string             nama domain yang dapat digunakan layanan lain untuk mengakses OSS.
  -h, --help                        bantuan untuk perintah
      --language string             Bahasa teks tampilan
      --loglevel string             tingkat pesan debug (default "off"), nilai valid: "off","info","debug"
      --mode string                 Menentukan mode otentikasi, nilai valid: "AK","StsToken","EcsRamRole","Anonymous"
      --output-format string        gaya format untuk keluaran perintah (default "raw")
      --output-properties strings   properti format keluaran
      --output-query string         query JMESPath untuk digunakan dalam memfilter data respons
      --profile string              Profil spesifik dari file konfigurasi Anda.
      --read-timeout int            waktu habis pembacaan klien, satuannya: d. (default 20)
      --region string               wilayah tempat bucket berada.
      --retry-times int             jumlah percobaan ulang saat gagal (default 10)
      --sign-version string         Versi algoritma tanda tangan (default "v4"), nilai valid: "v1","v4"
      --skip-verify-cert            menentukan bahwa file sertifikat digital server oss tidak akan diverifikasi
  -t, --sts-token string            STSToken saat mengakses oss

Informasi tentang setiap opsi untuk subperintah mencakup tipe data, nama opsi, dan deskripsi.