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.
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 |
|
-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:
|
|
--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 /myconfigconfig 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
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.
NotYalnızca ossutil V1.7.15 ve sonraki sürümler Default seçeneğini destekler.