Jalankan perintah config untuk membuat file konfigurasi - Object Storage Service

Topik ini menjelaskan cara menjalankan perintah config untuk membuat file konfigurasi yang digunakan menyimpan informasi akses Object Storage Service (OSS). Anda dapat menambahkan opsi -c saat menjalankan perintah lain. Dengan cara ini, ossutil menggunakan konfigurasi dalam file konfigurasi tertentu untuk mengakses OSS.

Penting

Untuk ossutil versi 1.6.16 dan lebih baru, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa memperbarui nama biner berdasarkan sistem operasi. Untuk ossutil sebelum versi 1.6.16, Anda harus memperbarui nama biner sesuai dengan sistem operasi. Untuk informasi lebih lanjut, lihat Referensi perintah ossutil.

Sintaks perintah

Anda dapat menjalankan perintah config dalam mode interaktif atau non-interaktif. Dalam mode interaktif, Anda harus menyelesaikan konfigurasi terkait menggunakan file konfigurasi sebelum menjalankan perintah config. Saat menjalankan perintah config, ossutil langsung membaca konfigurasi dari file konfigurasi. Dalam mode non-interaktif, Anda harus menentukan parameter saat menjalankan perintah config. Mode interaktif memberikan keamanan yang lebih tinggi dibandingkan dengan mode non-interaktif.

Gunakan sintaks berikut untuk menjalankan perintah config dalam mode non-interaktif:

ossutil config 
[-e, --endpoint <nilai>] 
[-i, --access-key-id <nilai>] 
[-k, --access-key-secret <nilai>] 
[-t, --sts-token <nilai>]
[--ram-role-arn <nilai>]
[-L bahasa <nilai>] 
[--output-dir <nilai>] 
[-c, --config-file <nilai>]

Tabel berikut menjelaskan opsi di atas.

Opsi	Deskripsi
-e, --endpoint	Titik akhir wilayah tempat bucket berada. Untuk informasi lebih lanjut, lihat Wilayah dan titik akhir. Untuk menentukan protokol yang digunakan ossutil untuk mengakses OSS, tambahkan `http://` atau `https://`. Protokol default adalah HTTP.
-i, --access-key-id	ID AccessKey di bagian [Credentials] file konfigurasi. Untuk informasi lebih lanjut tentang cara melihat ID AccessKey, lihat Dapatkan pasangan AccessKey.
-k, --access-key-secret	Rahasia AccessKey di bagian [Credentials] file konfigurasi. Untuk informasi lebih lanjut tentang cara melihat Rahasia AccessKey, lihat Dapatkan pasangan AccessKey.
-t, --sts-token	Token Layanan Keamanan (STS) yang digunakan untuk mengakses OSS. Parameter ini hanya diperlukan jika Anda menggunakan kredensial akses sementara STS untuk mengakses OSS. Untuk informasi lebih lanjut tentang cara menghasilkan token STS, lihat Gunakan kredensial akses sementara yang disediakan oleh STS untuk mengakses OSS.
--ram-role-arn	Nama ARN Alibaba Cloud dari peran RAM dalam mode RamRoleArn untuk otentikasi. Anda harus mengonfigurasi parameter ini hanya jika Anda memanggil AssumeRole untuk mengakses OSS sebagai pengguna RAM.
-L bahasa	Bahasa yang digunakan ossutil. Nilai: CH: Cina. Jika Anda mengatur parameter ini ke CH, pastikan bahwa sistem Anda mendukung pengkodean UTF-8. EN: Inggris.
--output-dir	Direktori tempat objek keluaran disimpan. Objek keluaran mencakup objek laporan yang dihasilkan karena kesalahan yang terjadi saat Anda menjalankan perintah cp untuk menyalin beberapa objek secara bersamaan. Secara default, direktori yang digunakan untuk menyimpan objek keluaran adalah ossutil_output di direktori saat ini.
-c, --config-file	Path file konfigurasi ossutil. Saat ossutil dimulai, ia membaca path dari file konfigurasi.

Contoh

Hasilkan file konfigurasi dalam mode interaktif

ossutil config
Tentukan nama file konfigurasi. Nama file dapat berisi path file. Nama file default adalah /home/user/.ossutilconfig. Jika Anda menekan tombol Enter tanpa menentukan path file, file konfigurasi dihasilkan di path default. 
Jika Anda ingin menyimpan file konfigurasi di path lain, atur opsi --config-file ke path file. 
Jika Anda tidak menentukan path file konfigurasi, file konfigurasi default bernama /home/user/.ossutilconfig digunakan.  
Jika Anda menekan tombol Enter tanpa menentukan parameter berikut, parameter tersebut akan diabaikan. Untuk informasi lebih lanjut tentang parameter, jalankan perintah help config.  
Masukkan endpoint: https://oss-cn-shenzhen.aliyuncs.com 
Masukkan AccessKey ID: yourAccessKeyID 
Masukkan AccessKey secret: yourAccessKeySecret
Masukkan STS token: yourStsToken

Hasilkan file konfigurasi dalam mode non-interaktif
```
ossutil config -e oss-cn-beijing.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret -L CH -c /myconfig
```
Jika Anda menentukan parameter selain -L bahasa dan -c, --config-file, saat menjalankan perintah config, mode non-interaktif digunakan. Dalam hal ini, Anda harus menentukan semua parameter.

Ubah file konfigurasi

Penting

Dalam ossutil versi 1.7.15 dan lebih baru, Anda tidak perlu menentukan Bucket-Endpoint atau Bucket-Cname jika menggunakan mode interaktif. Anda dapat menentukan endpoint atau CNAME untuk setiap bucket dalam file konfigurasi.
ossutil memungkinkan Anda menentukan endpoint menggunakan metode berbeda. Prioritas konfigurasi endpoint adalah sebagai berikut: endpoint yang ditentukan oleh opsi --endpoint dalam perintah, endpoint yang ditentukan di bagian [Bucket-Cname], endpoint yang ditentukan di bagian [Bucket-Endpoint], dan endpoint yang ditentukan di bagian [Credentials].

Anda dapat mengubah informasi akses OSS dengan mengedit file konfigurasi yang dihasilkan. Format file konfigurasi ossutil adalah sebagai berikut:

[Credentials]
        language = CH
        endpoint = oss.aliyuncs.com
        accessKeyID = your_accesskey_id
        accessKeySecret = your_accesskey_secret
        stsToken = your_sts_token
        outputDir = your_output_dir
        ramRoleArn = your_ram_role_arn
[Bucket-Endpoint]
        bucket1 = endpoint1
        bucket2 = endpoint2
        ...
[Bucket-Cname]
        bucket1 = cname1
        bucket2 = cname2
        ...
[AkService]
        ecsAk=http://100.100.100.200/latest/meta-data/ram/security-credentials/EcsRamRoleTesting
[Default]
        userAgent = user_agent
        loglevel = log_level
        proxyHost = proxy_host
        proxyUser = proxy_user
        proxyPwd = proxy_pwd
        readTimeOut = read_time_out
        connectTimeOut = connect_time_out
        retryTimes = retry_times

Bucket-Endpoint: Tentukan endpoint untuk setiap bucket yang ditentukan.
Bucket-Cname: Tentukan CNAME untuk setiap bucket yang ditentukan. Untuk informasi lebih lanjut tentang CNAME, lihat Peta Nama Domain Kustom.
AkService: Opsi ini diperlukan jika Anda ingin menggunakan peran RAM yang dilampirkan pada instance Elastic Compute Service (ECS) untuk melakukan operasi pada OSS. Saat menentukan opsi ini, cukup atur EcsRamRoleTesting ke nama peran RAM yang dilampirkan pada instance ECS. Setelah menentukan opsi ini, Anda tidak perlu menentukan parameter AccessKey ID, AccessKey Secret, dan STSToken. Jika Anda menentukan AccessKey ID, konfigurasi AkService tidak berlaku. Parameter AccessKey ID, AccessKey Secret, dan STSToken digunakan untuk memverifikasi identitas Anda. Untuk informasi lebih lanjut tentang cara melampirkan peran RAM ke instance ECS, lihat Peran RAM Instance.
Default: Anda dapat menentukan opsi ini jika ingin mengubah nilai default parameter umum. Untuk informasi lebih lanjut, lihat Lihat Opsi.
Catatan
Hanya ossutil versi 1.7.15 dan lebih baru yang mendukung opsi Default.