Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:config

Son Güncelleme:Oct 01, 2026

Bu konu, Object Storage Service (OSS) erişim bilgilerini depolamak için kullanılan bir yapılandırma dosyası oluşturmak üzere config komutunun nasıl çalıştırılacağını açıklar. Diğer komutları çalıştırırken -c seçeneğini ekleyebilirsiniz. Bu sayede ossutil, OSS'ye erişmek için belirli bir yapılandırma dosyasındaki ayarları kullanır.

Önemli

ossutil 1.6.16 ve sonraki sürümlerde, komut satırında ikili dosya adı olarak doğrudan ossutil kullanabilirsiniz. İşletim sistemine göre ikili dosya adını güncellemeniz gerekmez. 1.6.16'dan önceki ossutil sürümlerinde ise işletim sistemine göre ikili dosya adını güncellemeniz gerekir. Daha fazla bilgi için bkz. ossutil komut referansı.

Komut sözdizimi

config komutunu etkileşimli veya etkileşimsiz modda çalıştırabilirsiniz. Etkileşimli modda, config komutunu çalıştırmadan önce ilgili yapılandırmaları bir yapılandırma dosyası kullanarak tamamlamanız gerekir. config komutunu çalıştırdığınızda ossutil, yapılandırmaları doğrudan yapılandırma dosyasından okur. Etkileşimsiz modda ise config komutunu çalıştırırken parametreleri belirtmeniz gerekir. Etkileşimsiz moda kıyasla etkileşimli mod daha güvenlidir.

Aşağıdaki komut sözdizimini kullanarak config komutunu etkileşimsiz modda çalıştırın:

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

Aşağıdaki tabloda önceki seçenekler açıklanmaktadır.

Seçenek

Açıklama

-e, --endpoint

Paketin bulunduğu bölgenin uç noktası. Daha fazla bilgi için bkz. Bölgeler ve uç noktalar. ossutil'in OSS'ye erişmek için kullandığı protokolü belirtmek üzere http:// veya https:// ekleyin. Varsayılan protokol HTTP'dir.

-i, --access-key-id

Yapılandırma dosyasının [Credentials] bölümündeki AccessKey ID. AccessKey ID'yi görüntüleme hakkında daha fazla bilgi için bkz. AccessKey çifti alma.

-k, --access-key-secret

Yapılandırma dosyasının [Credentials] bölümündeki AccessKey secret. AccessKey secret değerini görüntüleme hakkında daha fazla bilgi için bkz. AccessKey çifti alma.

-t, --sts-token

OSS'ye erişmek için kullanılan Security Token Service (STS) belirteci. Bu parametre yalnızca OSS'ye erişmek için STS geçici erişim kimlik bilgilerini kullanıyorsanız gereklidir. Bir STS belirteci oluşturma hakkında daha fazla bilgi için bkz. STS geçici kimlik bilgilerini kullanarak OSS'ye erişme.

--ram-role-arn

Kimlik doğrulama için RamRoleArn modundaki RAM rolünün Alibaba Cloud Resource Name (ARN) değeri. Bu parametreyi yalnızca bir RAM kullanıcısı olarak AssumeRole çağrısı yaparak OSS'ye erişiyorsanız yapılandırmanız gerekir.

-L language

ossutil tarafından kullanılan dil. Değerler:

  • CH: Çince. Bu parametreyi CH olarak ayarlarsanız sisteminizin UTF-8 kodlamasını desteklediğinden emin olun.

  • EN: İngilizce.

--output-dir

Çıktı nesnelerinin depolandığı dizin. Çıktı nesneleri arasında, birden çok nesneyi aynı anda kopyalamak için cp komutunu çalıştırırken oluşan hatalar nedeniyle oluşturulan rapor nesneleri bulunur.

Varsayılan olarak çıktı nesnelerini depolamak için kullanılan dizin, geçerli dizindeki ossutil_output dizinidir.

-c, --config-file

ossutil yapılandırma dosyasının yolu. ossutil başlatıldığında yolu yapılandırma dosyasından okur.

Örnekler

  • Etkileşimli modda bir yapılandırma dosyası oluşturun

    ossutil config
    Specify the name of the configuration file. The file name can contain the file path. The default file name is /home/user/.ossutilconfig. If you press the Enter key without specifying a file path, the configuration file is generated in the default path. 
    If you want to store the configuration file in another path, set the --config-file option to the file path. 
    If you do not specify the path of the configuration file, the default configuration file named /home/user/.ossutilconfig is used.  
    If you press the Enter key without specifying the following parameters, these parameters are ignored. For more information about the parameters, run the help config command.  
    Enter the endpoint: https://oss-cn-shenzhen.aliyuncs.com 
    Enter the AccessKey ID: yourAccessKeyID 
    Enter the AccessKey secret: yourAccessKeySecret
    Enter the STS token: yourStsToken
  • Etkileşimsiz modda bir yapılandırma dosyası oluşturun

    ossutil config -e oss-cn-beijing.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret -L CH -c /myconfig

    config komutunu çalıştırırken -L language ve -c, --config-file dışındaki parametreleri belirtirseniz etkileşimsiz mod kullanılır. Bu durumda tüm parametreleri belirtmeniz gerekir.

Yapılandırma dosyasını değiştirme

Önemli
  • ossutil V1.7.15 ve sonraki sürümlerde etkileşimli modu kullanıyorsanız Bucket-Endpoint veya Bucket-Cname belirtmeniz gerekmez. Yapılandırma dosyasında her paket için bir uç nokta veya CNAME belirtebilirsiniz.

  • ossutil, uç noktaları farklı yöntemlerle belirtmenize olanak tanır. Aşağıdaki uç nokta yapılandırmaları etki sırasına göre azalan şekilde uygulanır: komuttaki --endpoint seçeneğiyle belirtilen uç noktalar, [Bucket-Cname] bölümünde belirtilen uç noktalar, [Bucket-Endpoint] bölümünde belirtilen uç noktalar ve [Credentials] bölümünde belirtilen uç noktalar.

Oluşturulan yapılandırma dosyasını değiştirerek OSS erişim bilgilerini güncelleyebilirsiniz. ossutil yapılandırma dosyası aşağıdaki biçimdedir:

[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: Belirtilen her paket için bir uç nokta belirtin.

  • Bucket-Cname: Belirtilen her paket için bir CNAME belirtin. CNAME'ler hakkında daha fazla bilgi için bkz. Özel alan adı bağlama.

  • AkService: OSS üzerinde işlem yapmak için bir Elastic Compute Service (ECS) örneğine eklenmiş bir RAM rolü kullanmak istiyorsanız bu seçenek gereklidir. Bu seçeneği belirttiğinizde yalnızca EcsRamRoleTesting değerini ECS örneğine eklenen RAM rolünün adına ayarlamanız yeterlidir. Bu seçeneği belirttikten sonra AccessKey ID, AccessKey Secret ve STSToken parametrelerini belirtmeniz gerekmez. AccessKey ID belirtirseniz AkService yapılandırması etkili olmaz. AccessKey ID, AccessKey Secret ve STSToken yapılandırmaları kimliğinizi doğrulamak için kullanılır. Bir ECS örneğine RAM rolü ekleme hakkında daha fazla bilgi için bkz. Örnek RAM rolleri.

  • Default: Yaygın parametrelerin varsayılan değerlerini değiştirmek istiyorsanız bu seçeneği belirtebilirsiniz. Daha fazla bilgi için bkz. Seçenekleri görüntüleme.

    Not

    Yalnızca ossutil V1.7.15 ve sonraki sürümler Default seçeneğini destekler.