您可以通過config命令創建配置文件,用于存儲OSS訪問信息。您可以在使用其他命令時添加-c選項,ossutil將通過指定的配置來訪問OSS。
從ossutil 1.6.16版本開始,命令行中Binary名稱支持直接使用ossutil,您無需根據系統刷新Binary名稱。如果您的ossutil版本低于1.6.16,則需要根據系統刷新Binary名稱。更多信息,請參見命令行工具ossutil命令參考。
命令格式
該命令有交互式和非交互式兩種用法。交互式用法允許您在使用命令前,通過配置文件完成相關配置項。命令使用過程中,ossutil將直接讀取配置文件中的配置。而非交互式用法則需要您在使用命令時,通過選項來指定需要的配置項。相比非交互式用法,交互式用法具有更高的安全性。
該命令的非交互式用法的命令格式如下:
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>]
各選項說明如下:
選項 | 說明 |
-e,--endpoint | 填寫Bucket所在地域的域名信息,詳情請參見訪問域名和數據中心。您也可以增加 |
-i,--access-key-id | 指定配置文件中Credentials選項下的AccessKey ID。有關如何查看AccessKey ID信息的具體步驟,請參見獲取AccessKey。 |
-k,--access-key-secret | 指定配置文件中Credentials選項下的AccessKey Secret。有關如何查看AccessKey Secret信息的具體步驟,請參見獲取AccessKey。 |
-t,--sts-token | 訪問OSS使用的STSToken,僅在使用STS臨時授權方式訪問OSS時需要配置此項。關于如何生成STSToken的具體步驟,請參見使用STS臨時訪問憑證訪問OSS。 |
--ram-role-arn | RamRoleArn鑒權模式下的RAM角色ARN。僅在使用RAM用戶的AssumeRole的方式訪問時需要配置此項。 |
-L language | 設置ossutil工具的語言。取值如下:
|
--output-dir | 指定輸出文件所在的目錄,輸出文件目前包含cp命令批量拷貝文件出錯時所產生的report文件。 默認值:當前目錄下的ossutil_output目錄。 |
-c,--config-file | ossutil工具的配置文件路徑,ossutil啟動時將從配置文件讀取配置。 |
使用示例
交互式配置
ossutil config 請輸入配置文件名,文件名可以帶路徑(默認為:/home/user/.ossutilconfig,回車將使用默認路徑。 如果用戶設置為其它路徑,在使用命令時需要將--config-file選項設置為該路徑): 未輸入配置文件路徑,將使用默認配置文件:/home/user/.ossutilconfig。 對于下述配置,回車將跳過相關配置項的設置,配置項的具體含義,請使用"help config"命令查看。 請輸入endpoint:https://oss-cn-shenzhen.aliyuncs.com 請輸入accessKeyID:yourAccessKeyID 請輸入accessKeySecret:yourAccessKeySecret 請輸入stsToken:yourStsToken
非交互式配置
ossutil config -e oss-cn-beijing.aliyuncs.com -i LTAIbZcdVCmQ**** -k D26oqKBudxDRBg8Wuh2EWDBrM0**** -L CH -c /myconfig
如果您使用命令時輸入了除-L language和-c,--config-file以外的任意選項,則進入非交互式模式,所有的配置項需使用選項來指定。
編輯配置文件
在新版本中,ossutil取消了交互式配置中關于Bucket-Endpoint和Bucket-Cname項的配置。您可以在配置文件中對每個Bucket單獨指定Endpoint或CNAME。
ossutil支持通過不同方式指定Endpoint,Endpoint生效優先級為--endpoint(命令選項) > Bucket-Cname > Bucket-Endpoint > endpoint(Credentials項) 。
對于已經生成的配置文件,您也可以通過直接編輯配置文件來修改OSS訪問信息。ossutil工具的配置文件格式如下:
[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:為每個指定的Bucket單獨配置Endpoint。
Bucket-Cname:為每個指定的Bucket單獨配置CNAME域名。關于CNAME域名的更多信息,請參見綁定自定義域名。
AkService:當您希望使用ECS實例綁定的RAM角色操作OSS時,需配置此項。配置時僅需將EcsRamRoleTesting改為ECS實例綁定的角色名稱即可。配置此項后,AccessKey ID、AccessKey Secret、STSToken可不配置。如果配置了AccessKey ID,則AkService的配置將不會生效,而是以配置的AccessKey ID、AccessKey Secret、STSToken進行身份校驗。ECS實例綁定RAM角色請參見通過ECS實例RAM角色授權ECS訪問其他云服務。
Default:當您需要修改通用參數的默認值時,可以配置此項。關于選項的更多說明,請參見查看選項。
說明僅1.7.15及以上版本支持配置Default。