Tüm Ürünler
Search
Belge Merkezi

Cloud Control API:Linux, macOS ve Windows üzerinde ortam değişkenlerini yapılandırın

Son Güncelleme:Oct 07, 2026

Ortam değişkenleri, işletim sistemi üzerinde çalışan uygulamalar için çalışma zamanı ayarları sağlayan, belirli adlara ve değerlere sahip işletim sistemi düzeyindeki parametrelerdir. Bu konu, uygulamalarınızın sabit kodlanmış kimlik bilgileri olmadan güvenli bir şekilde kimlik doğrulaması yapabilmesi için Linux, macOS ve Windows sistemlerinde Alibaba Cloud AccessKey çiftinin ortam değişkenlerine nasıl ayarlanacağını açıklar.

Bir Alibaba Cloud hesabı tam erişim izinlerine sahiptir ve yüksek güvenlik riski oluşturur. Daha iyi güvenlik sağlamak için erişim veya günlük bakım ve işlemler (O&M) amacıyla bir Resource Access Management (RAM) kullanıcısı oluşturun ve kullanın. API işlemlerini çağırmadan önce RAM kullanıcısına hedef kaynaklar üzerinde işlem yapması için gerekli izinleri atayın. Bir RAM kullanıcısı için AccessKey alma hakkında daha fazla bilgi için bkz. AccessKey oluşturma, RAM kullanıcı izinlerini yönetme ve RAM kullanıcısının AccessKey bilgilerini görüntüleme. Bir AccessKey kullanarak API çağrısı yaparken AccessKey'i kodunuzda düz metin olarak bulundurmayın. Bunun yerine, AccessKey'inizin açığa çıkmasını önlemek için ortam değişkenlerini yapılandırın veya başka bir güvenli yöntem kullanın.

Linux ve macOS üzerinde ortam değişkenlerinde bir Alibaba Cloud AccessKey ayarlama

Bu bölümde örnek olarak ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ortam değişkenleri kullanılmıştır. Değişken adlarını ihtiyaca göre değiştirebilirsiniz; örneğin OSS_ACCESS_KEY_ID ve OSS_ACCESS_KEY_SECRET.

Ortam değişkenlerini export komutunu kullanarak yapılandırın:

Önemli

Export komutu kullanılarak ayarlanan geçici ortam değişkeni yalnızca geçerli oturum için geçerlidir. Oturum sonlandığında değişken temizlenir. Uzun süreli saklama (LTR) için export komutunu işletim sisteminizin başlangıç yapılandırma dosyasına ekleyin.

  • AccessKey ID'yi yapılandırın ve Enter tuşuna basın.

    # Replace yourAccessKeyID with your AccessKey ID.
    export ALIBABA_CLOUD_ACCESS_KEY_ID=yourAccessKeyID
  • AccessKey secret'ı yapılandırın ve Enter tuşuna basın.

    # Replace yourAccessKeySecret with your AccessKey secret.
    export ALIBABA_CLOUD_ACCESS_KEY_SECRET=yourAccessKeySecret
  • Yapılandırmayı doğrulayın.

    echo $ALIBABA_CLOUD_ACCESS_KEY_ID komutunu çalıştırın. Komut doğru AccessKey ID'yi döndürürse yapılandırma başarılıdır.

Windows üzerinde ortam değişkenlerinde bir Alibaba Cloud AccessKey ayarlama

Bu bölümde örnek olarak ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ortam değişkenleri kullanılmıştır. Değişken adlarını ihtiyaca göre değiştirebilirsiniz; örneğin OSS_ACCESS_KEY_ID ve OSS_ACCESS_KEY_SECRET.

Grafik kullanıcı arabirimini (GUI) kullanma

  • Yordam

    Aşağıdaki adımlar, Windows 10'da GUI kullanarak ortam değişkenlerinin nasıl ayarlanacağını açıklar.

    Masaüstünüzde This PC öğesine sağ tıklayın ve Properties > Advanced system settings > Environment Variables > System variables veya User variables altında New seçeneklerini seçin. Ardından yapılandırmayı tamamlayın.

    Değişken

    Örnek değer

    AccessKey ID

    • Değişken adı: ALIBABA_CLOUD_ACCESS_KEY_ID

    • Değişken değeri: yourAccessKeyID

    AccessKey secret

    • Değişken adı: ALIBABA_CLOUD_ACCESS_KEY_SECRET

    • Değişken değeri: yourAccessKeySecret

  • Yapılandırmayı test etme

    Start öğesini tıklayın (veya Win+R klavye kısayolunu kullanın), Run öğesini tıklayın, cmd girin ve ardından komut istemini açmak için OK öğesini tıklayın (veya Enter tuşuna basın). echo %ALIBABA_CLOUD_ACCESS_KEY_ID% ve echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET% komutlarını çalıştırın. Komutlar doğru AccessKey'i döndürürse yapılandırma başarılıdır.

Komut istemini (CMD) kullanma

  • Yordam

    Komut istemini yönetici olarak açın ve sisteme yeni ortam değişkenleri eklemek için aşağıdaki komutları çalıştırın.

    setx ALIBABA_CLOUD_ACCESS_KEY_ID yourAccessKeyID /M
    setx ALIBABA_CLOUD_ACCESS_KEY_SECRET yourAccessKeySecret /M

    /M parametresi bir sistem ortam değişkenini belirtir. Kullanıcı ortam değişkeni ayarlarken bu parametreyi atlayabilirsiniz.

  • Yapılandırmayı test etme

    Start öğesini tıklayın (veya Win+R klavye kısayolunu kullanın), Run öğesini tıklayın, cmd girin ve ardından komut istemini açmak için OK öğesini tıklayın (veya Enter tuşuna basın). echo %ALIBABA_CLOUD_ACCESS_KEY_ID% ve echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET% komutlarını çalıştırın. Komutlar doğru AccessKey'i döndürürse yapılandırma başarılıdır.

Windows PowerShell kullanma

PowerShell'de tüm yeni oturumlar için geçerli olan yeni ortam değişkenleri ayarlayabilirsiniz:

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

Tüm kullanıcılar için ortam değişkenleri ayarlamak üzere yönetici izinlerine sahip olmanız gerekir:

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

Yalnızca geçerli oturum için geçerli olan geçici ortam değişkenleri ayarlayabilirsiniz:

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

PowerShell'de Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_ID ve Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET komutlarını çalıştırın. Komutlar doğru AccessKey'i döndürürse yapılandırma başarılıdır.

Önemli

Ortam değişkenlerini yapılandırdıktan sonra yeni ayarların etkili olması için entegre geliştirme ortamları (IDE'ler) gibi geliştirme araçlarınızı veya hizmetlerinizi yeniden başlatmanız gerekebilir.