全部产品
Search
文档中心

Alibaba Cloud SDK:Konfigurasikan variabel environment di Linux, macOS, dan Windows

更新时间:Dec 23, 2025

Variabel environment adalah parameter sistem yang spesifik untuk sistem operasi, dengan nama dan nilai tertentu. Variabel ini menyediakan pengaturan lingkungan runtime bagi aplikasi yang berjalan pada sistem operasi. Topik ini menjelaskan cara mengonfigurasi sepasang AccessKey dalam variabel environment di Linux, macOS, dan Windows.

Menggunakan akun Alibaba Cloud—yang memiliki izin akses ke semua resource—menimbulkan ancaman keamanan yang tinggi. Kami sangat menyarankan Anda membuat dan menggunakan pengguna Resource Access Management (RAM) untuk akses resource atau operasi dan maintenance (O&M) harian. Sebelum memanggil operasi API, berikan hanya izin yang diperlukan kepada pengguna RAM tersebut. Untuk informasi lebih lanjut tentang cara mendapatkan AccessKey pengguna RAM, lihat Create an AccessKey dan Manage permissions for a RAM user. Saat memanggil operasi API menggunakan AccessKey, jangan hardcode AccessKey dalam bentuk teks biasa di kode Anda. Sebagai gantinya, konfigurasikan variabel lingkungan atau gunakan metode aman lain yang tidak melibatkan penyimpanan AccessKey dalam teks biasa.

Konfigurasikan sepasang AccessKey dalam variabel environment Linux dan macOS

Bagian ini menggunakan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET sebagai contoh. Anda dapat mengganti nama variabel sesuai kebutuhan, misalnya OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET.

Anda dapat mengonfigurasi variabel lingkungan menggunakan perintah export:

Penting

Variabel lingkungan yang dikonfigurasi menggunakan perintah export bersifat sementara dan hanya berlaku untuk sesi saat ini. Untuk memastikan retensi jangka panjang (LTR), tambahkan perintah export ke file konfigurasi startup sistem operasi.

  • Konfigurasikan ID AccessKey dan tekan Enter.

    # Ganti yourAccessKeyID dengan ID AccessKey Anda.
    export ALIBABA_CLOUD_ACCESS_KEY_ID=yourAccessKeyID
  • Konfigurasikan Rahasia AccessKey dan tekan Enter.

    # Ganti yourAccessKeySecret dengan Rahasia AccessKey Anda.
    export ALIBABA_CLOUD_ACCESS_KEY_SECRET=yourAccessKeySecret
  • Periksa apakah konfigurasi berhasil.

    Jalankan perintah echo $ALIBABA_CLOUD_ACCESS_KEY_ID. Konfigurasi berhasil jika ID AccessKey yang benar dikembalikan.

Konfigurasikan sepasang AccessKey dalam variabel environment Windows

Bagian ini menggunakan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET sebagai contoh. Anda dapat mengganti nama variabel sesuai kebutuhan, misalnya OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET.

Gunakan GUI

  • Prosedur

    Untuk mengonfigurasi variabel environment di Windows 10 menggunakan GUI, ikuti langkah-langkah berikut:

    Di desktop Windows, klik kanan This PC dan pilih Properties. Di halaman yang muncul, klik Advanced system settings. Di kotak dialog System Properties, klik Environment Variables pada tab Advanced. Di kotak dialog Environment Variables, klik New di bagian User variables atau System variables. Lalu, konfigurasikan variabel yang dijelaskan dalam tabel berikut.

    Variabel

    Contoh

    ID AccessKey

    • Nama variabel: ALIBABA_CLOUD_ACCESS_KEY_ID

    • Nilai variabel: LTAI****************

    Rahasia AccessKey

    • Nama variabel: ALIBABA_CLOUD_ACCESS_KEY_SECRET

    • Nilai variabel: yourAccessKeySecret

  • Periksa apakah konfigurasi berhasil.

    Klik Start (atau gunakan pintasan keyboard Win+R), masukkan cmd di kotak dialog Run, lalu klik OK (atau tekan Enter) untuk membuka command prompt. Jalankan perintah echo %ALIBABA_CLOUD_ACCESS_KEY_ID% dan echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%. Konfigurasi berhasil jika AccessKey yang benar dikembalikan.

Gunakan CMD

  • Prosedur

    Buka jendela Command Prompt sebagai administrator dan jalankan perintah berikut untuk menambahkan variabel environment di sistem operasi:

    setx ALIBABA_CLOUD_ACCESS_KEY_ID yourAccessKeyID /M
    setx ALIBABA_CLOUD_ACCESS_KEY_SECRET XXXXXXX /M

    Parameter /M menunjukkan variabel sistem. Jika Anda menghilangkan parameter ini, maka yang disetel adalah variabel pengguna.

  • Periksa apakah konfigurasi berhasil.

    Klik Start (atau gunakan pintasan keyboard Win+R), masukkan cmd di kotak dialog Run, lalu klik OK (atau tekan Enter) untuk membuka command prompt. Jalankan perintah echo %ALIBABA_CLOUD_ACCESS_KEY_ID% dan echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%. Konfigurasi berhasil jika AccessKey yang benar dikembalikan.

Gunakan Windows PowerShell

Di PowerShell, konfigurasikan variabel environment baru. Variabel environment berlaku untuk semua sesi baru.

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'XXXXXXX', [System.EnvironmentVariableTarget]::User)

Konfigurasikan variabel environment untuk semua pengguna. Anda harus menjalankan perintah berikut sebagai administrator.

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'XXXXXXX', [System.EnvironmentVariableTarget]::Machine)

Setel variabel lingkungan sementara untuk sesi saat ini:

$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "yourAccessKeyID"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "XXXXXXX"

Di PowerShell, jalankan perintah Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_ID dan Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET. Konfigurasi berhasil jika AccessKey yang benar dikembalikan.

Penting

Setelah mengonfigurasi variabel lingkungan, Anda mungkin perlu merestart alat pengembangan Anda, seperti Integrated Development Environment (IDE), atau layanan terkait agar pengaturan baru berlaku.