本文先容ossutil的一些成就操作巨屌 自慰，您不错通过本文了解若何更好地使用ossutil。

根据指示建筑成就文献旅途。

根据指示建筑用具的话语。

根据指示分离建筑Endpoint、AccessKey ID、AccessKey Secret和STSToken参数。使用STS临时授权账号探询OSS时需要成就STSToken，不然置空跳过即可。

参数证实如下：

参数

是否必填

证实

endpoint

是

填写Bucket地点地域的Endpoint。举例，使本示例使用华东1（杭州）外网Endpoint，建筑为https://oss-cn-hangzhou.aliyuncs.com。

若是您但愿通过与OSS同地域的其他阿里云产物探询OSS，请使用内网Endpoint，建筑为https://oss-cn-hangzhou-internal.aliyuncs.com。

对于各地域Endpoint的更多信息，请参见OSS地域和探询域名。

accessKeyID

是

填写账号的AccessKey，AccessKey的取得面貌，请参见创建AccessKey。

accessKeySecret

是

stsToken

否

使用STS临时授权账号探询OSS时需要成就该项，不然置空跳过即可。对于stsToken的生成面貌，请参见AssumeRole - 取得上演变装的临时身份左证。

若是在材干2建筑了成就文献的旅途，则每次使用呐喊时需增多-c选项指定成就文献。

呐喊成就文献

您不错将常用的左证信息和成就信息保存到成就文献里，以便捷使用。成就文献遴荐了INI体式结构，以节（section）和键（key）组成， 成就参数保存在指定的节里。常用的成就参数如下：

成就参数

证实

示例代码

language

建筑ossutil用具的话语。取值：

CH：汉文。

EN：英文。

[Credentials]
language = CH

endpoint

建筑Bucket地点地域的域名信息。

[Credentials]
endpoint  = oss-cn-hangzhou.aliyuncs.com

[Credentials]
endpoint  = https://oss-cn-hangzhou.aliyuncs.com

accessKeyID

探询密钥的一部分，用于象征用户身份，以对呐喊恳求进行身份考据。

[Credentials]
accessKeyID = your_accesskey_id

accessKeySecret

探询密钥的一部分，用于考据用户的密钥，以对呐喊恳求进行身份考据。

[Credentials]
accessKeySecret = your_accesskey_secret

stsToken

临时密钥的Token，以对呐喊恳求进行身份考据。

[Credentials]
stsToken = your_sts_token

mode

遴荐的鉴权方式，取值不错为AK、StsToken、RamRoleArn大要EcsRamRole。

[Credentials]
mode = RamRoleArn

ramRoleArn巨屌 自慰

鉴权方式下的RAM变装ARN。

[Credentials]
ramRoleArn = your_ram_role_arn

roleSessionName

鉴权方式下的会话称号，用于RamRoleArn方式。不建筑时，会生设立时值。

[Credentials]
roleSessionName = your_ram_role_seesion_name

tokenTimeout

示意Token的有用工夫，单元为秒，默许值为3600，用于RamRoleArn方式。

[Credentials]
tokenTimeout = your_token_timetout

ecsRoleName

EcsRamRole鉴权方式下的变装称号。

[Credentials]
ecsRoleName = your_ecs_role_name

更多呐喊成就参数，请参见裁剪成就文献。

呐喊行选项

除了通过呐喊成就文献外，您还不错使用呐喊行参数建筑关连的成就。呐喊行选项的优先级要高于呐喊成就文献。常用呐喊行选项如下：

选项

证实

示例代码

--loglevel

ossutil64 commandname options --loglevel debug

--connect-timeout

示意客户端聚会超时的工夫，单元为秒，默许值为120。

ossutil64 commandname options --connect-timeout 60

--read-timeout

示意客户端读超时的工夫，单元为秒，默许值为1200。

ossutil64 commandname options --read-timeout 60

--retry-times

当无剃头生时的重试次数，默许值为10。

影视大全网在线云点播

ossutil64 commandname options --retry-times 20

-e, --endpoint

恳求的域名。

ossutil64 commandname options -e oss-cn-hangzhou.aliyuncs.com

ossutil64 commandname options -e https://oss-cn-hangzhou.aliyuncs.com

-i, --access-key-id

探询OSS使用的探询左证。

ossutil64 commandname options -i your_access_key

-k, --access-key-secret

探询OSS使用的探询左证。

ossutil64 commandname options -k your_access_key_secrect

-t, --sts-token

探询OSS使用的STSToken。

ossutil64 commandname options -i your_sts_token_accesskey_id -k your_sts_token_accesskey_secret -t your_sts_token

--mode

示意鉴权方式，取值不错为AK、StsToken、RamRoleArn、EcsRamRole，默许值为空。

使用AK方式探询的示例代码如下：

ossutil64 commandname options -i your_accesskey_id -k your_accesskey_secret --mode AK

--ram-role-arn

鉴权方式下的RAM变装ARN。

ossutil64 commandname options --ram-role-arn your_ram_role_arn

--role-session-name

鉴权方式下的会话名字。

ossutil64 commandname options --role-session-name your_ram_session_name

--token-timeout

示意Token的有用工夫，单元为秒，默许值为3600。

ossutil64 commandname options --token-timeout 1800

--ecs-role-name

EcsRamRole鉴权方式下的变装称号。

ossutil64 commandname options --ecs-role-name your_ecs_role_name

更多选项成就，请参见通用选项。

成就探询左证

您不错使用多种面貌，通过成就文献大要呐喊行选项成就探询左证。

使用探询密钥探询

以杭州地域称号为example-bucket的Bucket为例进行证实。

通过成就文献

生成如下的成就文献，并保存在~/.myossutilconfig。

[Credentials]
endpoint = oss-cn-hangzhou.aliyuncs.com
accessKeyID = LTAI4Fw2NbDUCV8zYUzA****
accessKeySecret = 67DLVBkH7EamOjy2W5RVAHUY9H****

通过如下呐喊查询Bucket中的对象巨屌 自慰。

ossutil64 -c ~/.myossutilconfig ls oss://example-bucket

通过呐喊行选项

您也不错径直将探询密钥通过呐喊行参数传入，示例代码如下：

ossutil64 -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H**** ls oss://example-bucket

使用临时Token探询

以杭州地域称号为example-bucket的Bucket为例进行证实。

通过成就文献

生成如下的成就文献，并保存在~/.myossutilconfig。

[Credentials]
endpoint = oss-cn-hangzhou.aliyuncs.com
accessKeyID = STS.LTAI4Fw2NbDUCV8zYUzA****
accessKeySecret = 67DLVBkH7EamOjy2W5RVAHUY9H****
stsToken = yourSecurityToken

通过如下呐喊查询Bucket中的对象。

ossutil64 -c ~/.myossutilconfig ls oss://example-bucket

通过呐喊行选项

您也不错径直将探询密钥通过呐喊行参数传入，示例代码如下：

ossutil64 -e oss-cn-hangzhou.aliyuncs.com -i STS.LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H**** -t yourSecurityToken ls oss://example-bucket

使用RAM变装探询

以杭州地域称号为example-bucket的Bucket，需要上演的变装为ramRoleArnExample为例进行证实。

通过成就文献

生成如下的成就文献，并保存在~/.myossutilconfig。

[Credentials]
endpoint = oss-cn-hangzhou.aliyuncs.com
accessKeyID = LTAI4Fw2NbDUCV8zYUzA****
accessKeySecret = 67DLVBkH7EamOjy2W5RVAHUY9H****
mode = RamRoleArn
ramRoleArn = acs:ram::137918634953****:role/Alice
roleSessionName = session_name_example (不错不建筑)
tokenTimeout = 1800 (不错不建筑)

通过如下呐喊查询Bucket中的对象。

ossutil64 -c ~/.myossutilconfig ls oss://example-bucket

通过呐喊行选项

您也不错径直将探询密钥通过呐喊行参数传入，示例代码如下：

ossutil64 -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H**** --mode RamRoleArn --ram-role-arn acs:ram::137918634953****:role/Alice ls oss://example-bucket

使用实例RAM变装探询

在云功绩器ECS上，您还不错通过实例RAM变装的面貌来成就ossutil探询左证。实例RAM变装允许您将一个变装关联到云功绩器实例，在实例里面基于临时左证STS使用ossutil。临时左证由系统自动生成和更新，专揽圭臬不错使用指定的实例元数据URL取得临时左证，无需相等科罚。借助于RAM，一方面保证AccessKey安全，另一方面已毕权限的精良化结果和科罚。

使用前请先在ECS上创建实例RAM变装。更多信息，请参见创建实例RAM变装。

以杭州地域称号为example-bucket的Bucket、ECS上创建的变装称号为EcsRamRoleOss为例进行证实。

通过成就文献

生成如下的成就文献，并保存在~/.myossutilconfig。

[Credentials]
endpoint = oss-cn-hangzhou.aliyuncs.com
mode = EcsRamRole
ecsRoleName = EcsRamRoleOss

通过如下呐喊查询Bucket中的对象。

ossutil64 -c ~/.myossutilconfig ls oss://example-bucket

通过呐喊行选项

您也不错径直将探询密钥通过呐喊行参数传入，示例代码如下：

ossutil64 -e oss-cn-hangzhou.aliyuncs.com --mode EcsRamRole --ecs-role-name EcsRamRoleOss ls oss://example-bucket

为Bucket单独成就Endpoint

在使用ossutil的历程中，您需要科罚多个Bucket，此时需要对Bucket单独成就Endpoint。您不错通过如下两种面貌进行成就：

通过成就文献

在成就文献里，增多一个[Bucket-Endpoint]成就段，为每个指定的Bucket单独成就Endpoint，体式如下：

[Bucket-Endpoint]
bucket1 = endpoint1
bucket2 = endpoint2
...

以杭州地域Bucket（example-bucket-hz）、北京地域Bucket（example-bucket-bj）、上海地域Bucket（example-bucket-sh）为例进行证实。

生成如下的成就文献，并保存在~/.myossutilconfig。

[Credentials]
endpoint = oss-cn-hangzhou.aliyuncs.com
accessKeyID = LTAI4Fw2NbDUCV8zYUzA****
accessKeySecret = LTAI4Fw2NbDUCV8zYUzA****
[Bucket-Endpoint]
example-bucket-hz=oss-cn-hangzhou.aliyuncs.com
example-bucket-bj=oss-cn-beijing.aliyuncs.com
example-bucket-sh=oss-cn-shanghai.aliyuncs.com

通过如下呐喊查询Bucket中的对象。

ossutil64 -c ~/.myossutilconfig ls oss://example-bucket-hz
ossutil64 -c ~/.myossutilconfig ls oss://example-bucket-bj
ossutil64 -c ~/.myossutilconfig ls oss://example-bucket-sh

通过呐喊行选项

以杭州地域Bucket（example-bucket-hz）、北京地域Bucket（example-bucket-bj）、上海地域Bucket（example-bucket-sh）为例进行证实。

将账号信息成就在~/.myossutilconfig中。

[Credentials]
endpoint = oss-cn-hangzhou.aliyuncs.com
accessKeyID = LTAI4Fw2NbDUCV8zYUzA****
accessKeySecret = 67DLVBkH7EamOjy2W5RVAHUY9H****

通过-e参数指定Endpoint。

ossutil64 -c ~/.myossutilconfig ls oss://example-bucket-hz
ossutil64 -c ~/.myossutilconfig -e oss-cn-beijing.aliyuncs.com ls oss://example-bucket-bj
ossutil64 -c ~/.myossutilconfig -e oss-cn-shanghai.aliyuncs.com ls oss://example-bucket-sh

成就自界说域名

ossutil支撑通过自界说域名来探询OSS资源。在使用之前，需要通过成就文献建筑Bucket和自界说域名的映射关系。

在成就文献里，增多一个[Bucket-Cname]成就段，为每个指定的Bucket单独成就Endpoint，体式如下：

[Bucket-Cname]
bucket1 = cname1
bucket2 = cname2
...

以杭州地域称号为example-bucket的Bucket、通过cname.example-***.com自界说域名探询为例进行证实。

生成如下的成就文献，并保存在~/.myossutilconfig。

[Credentials]
accessKeyID = LTAI4Fw2NbDUCV8zYUzA****
accessKeySecret = 67DLVBkH7EamOjy2W5RVAHUY9H****
[Bucket-Cname]
example-bucket=cname.example-***.com

通过如下呐喊查询Bucket中的对象。

ossutil64 -c ~/.myossutilconfig ls oss://example-bucket