响应示例 HTTP/1.1 200 OK xamzrequestid:b6dbab65e82e48a3 ContentType:text/xml;charsetUTF8 ContentLength:216 Date:Fri, 15 Mar 2019 02:47:07 GMT Server: CTYUN b6dbab65e82e48a3

名称 描述 是否必须 Action GetLoginProfile。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 需要查询的IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是

名称 描述 GetSessionTokenResult.Credentials.SessionToken 安全令牌。 GetSessionTokenResult.Credentials.AccessKeyId 临时访问AccessKeyId。 GetSessionTokenResult.Credentials.SecretAccessKey 临时访问SecretAccessKey。 GetSessionTokenResult.Credentials.Expiration 过期时间。 ResponseMetadata.RequestId 请求ID。

本节主要介绍怎么退订OOS资源包。 资源包退订的步骤： 1. 进入资源包退订页面。 2. 资源包退订。 进入资源包退订页面 进入资源包退订页面有两种方式： 方式1：通过官网管理中心 点击“管理中心”>“资源管理”>“资源包”>“OOS资源包”，选择需要退订的资源包，点击“操作”列的“退订”，即可跳转到退订页。 方式2：通过OOS控制台 登录OOS控制台，点击“资源包管理”按钮，即可看到已订购的资源包。选择需要退订的资源包，点击“操作”列的“退订”，即可跳转到退订页。 资源包退订 进入退订页后，核对需要退订的资源包，选择退订原因，并勾选“我已确认本次退订金额和相关费用”，点击“退订”。 点击“退订”后，弹出提示框，可以根据提示框，点击“查看订单”或者“返回列表”。

布尔值条件运算符 利用布尔值条件，用户可以通过与“正确”或“错误”的对比，来设置Condition元素。 条件运算符 描述 Bool 布尔值匹配。 例如，下列声明使用 Bool 条件运算符与 ctyun:SecureTransport 键来指定必须使用 SSL 发出请求。 { "Version": "20121017", "Statement": [ { "Effect": "Allow", "Principal":{ "CTYUN": [""] }, "Action": "oos:GetObject", "Resource": "arn:ctyun:oos:::examplebucket/", "Condition": {"Bool": {"ctyun:SecureTransport": "true"}} } ] } IP Address Conditions IP address conditions允许设置IP地址的匹配规则，与ctyun:SourceIp key配合使用。此项的值必须符合标准的CIDR格式（例如：10.52.176.0/24），参考RFC 4632。 Condition 描述 IpAddress IP地址或范围的白名单。 NotIpAddress IP地址或范围的黑名单。 条件键 条件键 描述 ctyun:Referer 与字符串运算符结合使用。用于检查请求中的Referer请求头。 ctyun:SecureTransport 与布尔值运算符结合使用。检查请求是否是使用SSL发送的。 ctyun:SourceIp 与IP地址运算符结合使用。用于检查请求者的IP地址。 ctyun:UserAgent 与字符串运算符结合使用。用于检查请求者的客户端应用程序。

本节主要介绍欠费问题。 欠费原因 未购买资源包，在按需计费的模式下帐号的余额不足。 已购买资源包，但使用量超出资源包额度，或者产生了与资源包属性不符的其他计费项金额，进而产生按需计费，同时帐号中的余额不足以抵扣产生的按需费用。 欠费说明 欠费后OOS服务会自动停止，您所占用的存储空间资源仍会继续扣费，因此欠费余额会累计。 如果您在15天内充值补足欠款，服务会自动启用。 当欠费超过15天，将视为您主动放弃该服务，您保存在OOS的全部数据将会被销毁，销毁后数据不可恢复。因此请您及时关注账户余额并及时续费以保证您的服务不受到影响。 若您不再继续使用OOS，为防止持续扣费导致帐号欠费，请将您帐号下所有资源（存储桶和文件）删除，同时请不要再使用您的帐号及帐号下的IAM用户访问您的OOS。 查看欠费资源 如果您想查询哪些资源的扣费导致帐户欠费，可以在“费用中心”>“账单管理”>“账单概览“查询在天翼云的消费概况。 续费说明 若是已购买资源包后欠费，请在15天内再次订购相应的资源包或保证帐号中的余额充足。 若是未购买资源包后欠费，请在15天内充值补足欠款并保证帐号中的余额充足。

名称 描述 是否必须 Action CreateAccessKey。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 否

请求示例 列出IAM用户名为testuser的标签。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190325T023158Z ContentType: application/octetstream ContentLength: 55 ActionListUserTags&Version20100508&UserNametestuser 响应示例 HTTP/1.1 200 OK xamzrequestid:bc3c8e298bf44f24 ContentType:text/xml ContentLength:404 Date:Mon, 25 Mar 2019 02:31:58 GMT Server: CTYUN false testvalue testtag bc3c8e298bf44f24

名称 描述 是否必须 Action ListUsers。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 Marker 分页标识。还有需要返回的用户时，上条响应结果中会返回该参数。查看未显示项时，请求参数中需要携带此参数。 类型 ：字符串 取值 ：与上条响应中返回的结果值相同。 否 MaxItems 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示需要再次发送请求查看未显示的项。查看未显示的项时，需要携带响应参数Marker的值。 类型 ：整型 取值 ：1~1000，默认值为100。 否 UserName 查询IAM用户的用户名，进行模糊匹配搜索。如果请求参数中同时出现UserName、AccessKeyId，查询的结果需要同时满足这两个条件。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 否 AccessKeyId 按指定的AccessKeyId，进行模糊匹配搜索。 UserName、AccessKeyId共用时，查询出同时满足多个查询条件的结果。 否

项目 描述 当前位置 文件上传的位置。 存储类型 文件的存储类型： 标准存储：访问时延低、吞吐量高，能够有效支持各种热点类型数据频繁访问。适用于各种音视频服务、图片服务、大型网站、大数据分析等应用的数据存储。标准存储是默认的存储类型。如果上传文件时未指定存储类型，OOS默认使用标准存储。 低频访问存储：适合长期保存不经常访问的数据。对于不经常访问但仍需要实时访问的数据，可以采用低频访问存储，例如各类移动应用、智能设备、企业数据的长期备份。 最短存储时间：低频访问存储的文件有最短存储时间，存储时间短于30天的文件被提前删除或变更时，会产生一定费用。 最小计费大小：低频访问存储文件有最小计费大小，即如果文件大小低于64KiB，会按照64KiB计算收费，文件大于等于64KiB按照实际存储收费。 数据取回：获取低频访问存储文件时会产生数据取回费用。 选择文件 可以通过将目录或文件拖到浮窗上传文件，也可以点击添加文件、添加文件夹按钮上传文件。 上传的文件中如果想移除的，可以勾选对应的文件，点击“移除”按钮，进行文件移除。 说明 在查找框中可以模糊匹配查找上传的文件。 元数据 用户可以编辑上传文件的文件元数据信息，具体元数据信息详见

本节主要介绍怎么在控制台进行文件预览。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以预览对象。 点击文件“操作”列的“预览”按钮，可以预览该文件。 注意 基于安全合规要求，禁止通过OOS默认域名预览后缀为apk、ipa的文件，在Header中包含签名或者通过自定义域名方式下载此类文件不受影响。 预览的文件为图片或网页时，会以附件的形式下载到本地。

名称 描述 是否必须 Action TagUser。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 UserName IAM用户名。 类型：字符串 取值：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 Tags.member.N.Key 用户标签键。 类型：字符串 取值：由1~128个字符组成，字符串符合表达式[p{L}p{Z}p{N}.:/+@]+。 注意 一个用户最多包含10个标签。如果标签总数超过10个，则本次请求失败。 如果新添加的标签键与原有标签重复，新添加的标签会覆盖原有标签值。 是 Tags.member.N.Value 用户标签值。 类型：字符串 取值：由0~256个字符组成。字符串符合表达式[p{L}p{Z}p{N}.:/+@]。 是

响应示例4 HTTP/1.1 200 OK xamzrequestid: bf925f41e4094d0cfc76786f71773638402c2e30323436383a Date:Tue, 13 Dec 2011 19:14:41 GMT Server: CTYUN 请求示例5 为前缀是test的文件设置生命周期规则：文件最后一次访问3天后转为低频访问存储。 PUT /?lifecycle HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD xamzdate: 20230821T092414Z ContentMD5: NH5mGrd4Be/Q0EWSuXpfYA Connection: keepalive ContentLength: 324 Authorization: SignatureValue testlifecycle1 test Enabled 3 true STANDARDIA 响应示例5 HTTP/1.1 200 OK Date: Mon, 21 Aug 2023 09:24:14 GMT xamzrequestid: cbc195a82f344b0b0b574e5f656265446771535558535c6849 ContentLength: 0 Server: CTYUN 请求示例6 在设置多个规则时，请注意各规则之间不要互相冲突。比如，下面的生命周期中配置了一个规则，指定所有以documents为前缀的文件在30天后过期。而另一个规则指定所有以documents/2011为前缀的文件在365天过期。在这种情况下，OOS将返回错误信息。 PUT /?lifecycle HTTP/1.1 Host: docs.ooscn.ctyunapi.cn Date: Tue, 13 Dec 2011 17:54:50 GMT ContentMD5: 8dYiLewFWZyGgV2Q5FNI4W ContentLength: 226 Authorization: SignatureValue 111 documents Enabled 30 222 documents/2011 Enabled 365

名称 描述 是否必须 WebsiteConfiguration 请求的容器。 类型：容器。 子节点：IndexDocument、ErrorDocument、RoutingRules或RedirectAllRequestsTo。 注意 IndexDocument和RedirectAllRequestsTo互斥。如果填写了RedirectAllRequestsTo，则IndexDocument、ErrorDocument、RoutingRules都不能填写。 是 IndexDocument Suffix元素的容器。 注意：如果未填写RedirectAllRequestsTo，则IndexDocument必填。 类型：容器。 父节点：WebsiteConfiguration。 子节点：Suffix。 否 Suffix 在请求website endpoint上的路径时，Suffix会被加在请求的后面。例如，如果suffix是Index.html，而你请求的是bucket/images/，那么返回的响应是名为images/index.html的Object。 类型：字符串。 父节点：IndexDocument。 是 ErrorDocument Key的容器。 类型：容器。 父节点：WebsiteConfiguration。 子节点：Key。 否 Key 如果出现4XX错误，会返回指定的Object。 类型：字符串。 有效值：长度为1~1024的字符串。 父节点：ErrorDocument。 是 RoutingRules 托管模式配置到当前Bucket的重定向规则容器。 注意 如果RoutingRules下有多个RoutingRule，各RoutingRule之间无影响，按照配置的先后顺序向下执行，当有一个满足条件时，就不再继续向后匹配。如果都没有匹配，就不使用重定向规则。 类型：容器。 父节点：WebsiteConfiguration。 子节点：RoutingRule。 否 RoutingRule 重定向规则的容器。一条重定向规则包含一个Condition和一个Redirect，当Condition匹配时，Redirect生效。容器中至少要有一个重定向规则。 注意 一个RoutingRule下，出现多个Condition和Redirect时，以最后一个为准。 类型：容器。 父节点：RoutingRules。 子节点：Condition、Redirect。 是 Condition 描述重定向规则匹配的条件的容器。如果重定向规则匹配的条件未配置，则重定向规则将应用于所有请求。 注意 该容器可以不配置，如果配置，则至少应该包含HttpErrorCodeReturnedEquals、KeyPrefixEquals中的一个。 类型：容器。 父节点：RoutingRule。 子节点：HttpErrorCodeReturnedEquals、KeyPrefixEquals。 否 HttpErrorCodeReturnedEquals 指定Redirect生效时的HTTP错误码。当发生错误时，如果错误码等于这个值，那么Redirect生效。 注意 ErrorCodeReturnedEquals和KeyPrefixEquals同时存在时，只有都匹配时，Redirect才生效。 类型：字符串。 有效值：[ 400, 417 ]，[ 500, 505]。 例如：当返回的http错误码为404时重定向到NotFound.html，可以将Condition中的HttpErrorCodeReturnedEquals设置为404，Redirect中的ReplaceKeyWith设置为NotFound.html。 父节点：Condition。 否 KeyPrefixEquals 重定向规则生效时的文件名的前缀。 注意 HttpErrorCodeReturnedEquals 和KeyPrefixEquals同时存在时，只有都匹配时，Redirect才生效。 类型：字符串。 取值：长度为01024的字符串。 父节点：Condition。 否 Redirect 重定信息容器。 注意 Redirect配置包含的元素可以为空，也可以包含以下元素:Protocol、HostName、ReplaceKeyPrefixWith、ReplaceKeyWith。当某一元素存在多条值时以最后一条为准。 类型：容器。 父节点：RoutingRule。 子节点：Protocol、HostName、ReplaceKeyPrefixWith、ReplaceKeyWith。 是 Protocol 重定向请求时使用的协议。 类型：字符串。 有效值：http、https，默认值为http。 父节点：Redirect或者RedirectAllRequestsTo。 否 HostName 重定向请求时使用的站点名。 如果父节点为RedirectAllRequestsTo，此项必须填写。 类型：字符串。 有效值：1~1024个字符，不能包含空格。父节点为Redirect，也不能包含斜杠(/)。 父节点：Redirect或者RedirectAllRequestsTo。 否 ReplaceKeyPrefixWith 重定向请求时使用的文件名前缀。 注意 ReplaceKeyPrefixWith与ReplaceKeyWith不能同时存在。 类型：字符串。 有效值：0~1024个字符。 父节点：Redirect。 否 ReplaceKeyWith 指定重定向请求时使用的文件名。 注意 ReplaceKeyPrefixWith与ReplaceKeyWith不能同时存在。 类型：字符串。 有效值：0~1024个字符。 父节点：Redirect。 否 RedirectAllRequestsTo 托管模式为重定向请求的容器。 注意 如果未填写IndexDocument，则RedirectAllRequestsTo必填。如果填写了RedirectAllRequestsTo，则IndexDocument、ErrorDocument、RoutingRules都不能填写。 父节点：WebsiteConfiguration。 子节点：HostName、Protocol。 否

请求示例 创建用户名为testuser，标签键为testkey，标签值为testvalue的IAM用户。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190131T012759Z ContentType: application/octetstream ContentLength: 129 ActionCreateUser&Version20100508&UserNametestuser&Tags.member.1.Keytestkey&Tags.member.1.Valuetestvalue 响应示例 HTTP/1.1 200 OK xamzrequestid:3dcc0919e80b422c ContentType:text/xml;charsetUTF8 ContentLength:489 Date:Thu, 31 Jan 2019 01:27:59 GMT Server: CTYUN arn:ctyun:iam::10rc2arpn6306:user/testuser testuser 623387e786314d3f973359c9de61a39d testvalue testkey 20190131T01:28:00Z 3dcc0919e80b422c

项目 描述 Date 统计时间。 StorageClass 存储类型： STANDARD：标准存储。 STANDARDIA：低频访问存储。 BilledStorageUsage 计费容量，单位是Byte。 SampleCapacity 实时值，单位是Byte。 MaxCapacity 峰值，单位是Byte。 AverageCapacity 平均值，单位是Byte。 RemainderChargeStorageUsage 补齐容量之和，包括时长补齐和大小补齐，单位是Byte。 RemainderChargeOfDuration 时长补齐容量，单位是Byte。 RemainderChargeOfSize 大小补齐容量，单位是Byte。

本节主要介绍请求次数的统计信息。 进入“统计”页面，点击“请求次数”，可以查看请求次数及对应返回码统计信息，包括标准存储和低频访问存储的请求次数。 请求次数和返回码次数统计信息描述 项目 描述 时间选择 请求次数和返回码次数查询的时间段，可以选择查看下列时间段的请求次数和返回码次数： 今日。 昨日。 近7日。 近30日。 根据日历按钮，选择查询任意90天请求次数和返回码次数。 时间粒度 请求次数和返回码次数查询的时间粒度，可以选择： 按五分钟查询：统计信息按每5分钟展示，可以选择查询今日、昨日或按日历选择任意1天的数据。 按小时查询：统计信息按每小时展示，可以查询今日、昨日、近7日或按日历选择任意7天内的数据。 按天查询：统计信息按天展示，可以查询今日、昨日、近7日、近30天或按日历按钮选择任意90天内的数据。 数据位置 请求次数和返回码次数查询数据位置，可以选择： 全部数据位置：展示所有数据位置的请求次数之和、返回码次数之和。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的请求次数和返回码次数。 存储桶 请求次数和返回码次数查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的请求次数之和、返回码次数和值。 具体存储桶：根据显示的存储桶，选择查看对应存储桶的请求次数和返回码次数。 请求类型 请求次数和返回码次数的请求类型： 全部请求。 GET。 HEAD。 PUT。 POST。 DELETE。 OTHERS。 存储类型 选择请求次数查询的存储类型： 全部存储类型：分别展示标准存储和低频访问存储的请求次数。 标准类型：标准存储的请求次数。 低频访问存储：低频访问存储的请求次数。 可以点击“下载”按钮，将请求次数和返回码次数的统计信息下载到本地查看。 项目 描述 Date 统计时间。 StorageClass 存储类型。 Requests 请求次数。 Response200 返回码200的次数。 Response204 返回码204的次数。 Response206 返回码206的次数。 Response403 返回码403的次数。 Response404 返回码为404的次数。 Response4XX 除返回码403和404外的其他返回码4xx的次数。

日志 出于分析或审计等目的，用户可以开启日志功能，用于把存储桶的各类访问请求记录成日志，并将生成的日志文件写入用户指定的桶中。 生成的日志文件会保存在指定的存储桶中，占用存储空间，因此会产生存储费用。默认情况下，OOS不会为用户的存储桶收集访问日志。 生命周期 生命周期管理支持通过配置指定的规则，定期将存储桶内的文件（Object）转储为指定存储类型，或者将过期的文件删除，从而节省存储费用。 注意 如果存储桶没有配置过生命周期规则，执行该操作将创建新的生命周期规则。 如果存储桶内的生命周期规则正在执行时被修改配置，则修改后的配置并不立即生效，需等原生命周期规则执行完成后才能生效。 每个存储桶最多创建1000条生命周期规则。 同一存储桶，同一类型（到期删除或者到期转成低频访问存储）的生命周期规则不能存在叠加前缀，例如已创建到期删除文件的生命周期规则的前缀是ABC，则无法再创建前缀为ABCD或AB或A的到期删除文件的生命周期规则。 当用户为存储桶设置了生命周期规则，这些规则将同时应用于已有文件和后续新创建的文件。例如，用户今天增加了一个生命周期，指定过期时间为30天，那么OOS将会将最后修改时间在30天前的文件都加入到待删除队列中。 跨域设置 跨域资源共享（Cross Origin Resource Sharing，CORS）是由W3C标准化组织提出的一种网络浏览器的规范机制，定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中，由于同源安全策略（Same Origin Policy，SOP，同协议、同域名或IP、以及同端口视为同源）的存在，不同域之间的网站脚本和内容是无法进行交互的。例如，当来自于A网站的页面中的JavaScript代码希望访问B网站的时候，浏览器会拒绝该访问，因为A、B两个网站是属于不同的域。 OOS支持配置CORS规范，定义了客户端Web应用程序在一个域中与另一个域中的资源进行交互的方式，允许跨域请求访问OOS中的资源。 注意 每个Bucket最多可以配置100条跨域规则。 当OOS收到一个跨域请求（或者OPTIONS请求）时，会读取Bucket对应的CORS规则，然后进行相应的权限检查。OOS会依次检查每一条规则，使用第一条匹配的规则来允许请求并返回对应的Header。如果所有规则都匹配失败，则不附加任何CORS相关的Header。

项目 名称 存储桶名称 存储桶的名称。 区域 存储桶所属的区域，包括对象存储网络、对象存储网络2、其他区域，详见 创建时间 存储桶创建的时间。 操作 可以查看修改存储桶的属性，对存储桶进行删除，清空存储桶。 存储桶的属性包括：存储桶属性、区域属性、安全策略、网站、日志、生命周期、跨域设置、合规保留、清单配置。

项目 描述 规则名称 生命周期规则名称。 文件转换策略 文件按生命周期规则转换的策略： 天数：生命周期规则在匹配文件最后一次修改时间或最后一次访问时间多少天后生效。 日期：生命周期规则生效日期，对于最后一次修改时间在此日期之前的文件执行生命周期规则。 适用范围 生命规则适用的范围： 按前缀匹配：输入生命周期规则匹配前缀，符合该前缀的文件执行生命周期规则。不符合的不执行生命周期规则。 整个存储桶：创建的生命周期规则适用该Bucket内的所有文件。 前缀 输入生命周期规则要匹配的文件名字的前缀。 前缀设置为example，表示匹配名字以example开头的所有文件，如example1.txt、example/test.png等。 前缀设置为example/，表示匹配名字以example/开头的所有文件，如example/test.png、example/abc/1.txt等。 转换到低频访问型文件 匹配生命周期规则的文件，到期后转换成低频访问型文件。 如果“文件转换策略”为“天数”，可以选择文件： 最后一次修改时间：指定在文件最后一次修改后多少天，根据生命周期规则，文件转为低频访问存储。 最后一次访问时间：指定在文件最后一次访问后多少天，根据生命周期规则，文件转为低频访问存储。 如果“文件转换策略”为“日期”，则在此日期之前修改的文件，将在此日期转换为低频访问存储。 删除文件 匹配生命周期规则的文件，到期后删除。 如果“文件转换策略”为“天数”，指定在文件最后一次修改后多少天，文件被删除。 如果“文件转换策略”为“日期”，则在此日期之前修改的文件，将在此日期被删除。

本节主要介绍DELETE Bucket Policy。 在DELETE操作的url中加上Policy，可以删除指定Bucket的Policy。只有根用户和拥有DELETE Bucket Policy权限的子用户才能执行此操作，否则会返回403 AccessDenied错误。如果Bucket配置了Policy，删除成功，返回200 OK。如果Bucket没有配置Policy，返回204 No Content。 请求语法 DELETE /?policy HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 请求示例 DELETE /?policy HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn ContentMD5: 1B2M2Y8AsgTpgAmY7PhCfg ContentType: application/octetstream XAmzContentSha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 Date: Sun, 28 Apr 2024 06:37:14 GMT Authorization: SignatureValue Connection: keepalive 响应示例 HTTP/1.1 204 No Content xamzrequestid: b10f8d28916049988bfef100f502040ac9cbd5bfc1c3c5c7c9 Date: Sun, 28 Apr 2024 06:37:14 GMT Server: CTYUN

本节主要介绍GetEventSelectors。 此操作用来查看管理事件筛选器的设置信息。 请求参数 名称 描述 是否必须 ::: TrailName 跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾；不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 响应结果 名称 描述 :: EventSelectors.ReadWriteType 管理事件的读写类型： ReadOnly：只读。 WriteOnly：只写。 All：所有管理事件。 TrailARN 跟踪的ARN。 请求示例 查看名称为testcloudtrail的跟踪管理事件筛选器信息。 POST / HTTP/1.1 Host:ooscncloudtrail.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190422T053340Z XAmzTarget:cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.GetEventSelectors ContentType:application/json {"TrailName":"testcloudtrail"} 响应示例 HTTP/1.1 200 OK xamzrequestid:a97ab880f40c4242 ContentType:application/json;charsetUTF8 ContentLength:231 Date:Mon, 22 Apr 2019 05:33:40 GMT Server:CTYUN {"EventSelectors":[{"ReadWriteType":"WriteOnly"}],"TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/testcloudtrail"}

名称 描述 是否必须 Name 跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（ ）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（ ）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 S3BucketName OOS Bucket名称。 否 S3KeyPrefix 指定跟踪日志的名称前缀。 类型：字符串 取值：0~200个字符。 否

本节主要介绍StartLogging。 此操作用来开启跟踪。 说明 使用CreateTrail创建跟踪后，跟踪默认是关闭状态，需要调用StartLogging开启跟踪。 请求参数 名称 描述 是否必须 ::: Name 跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。不能包含相邻句点（.）、下划线（）、短划线（）任意组合。 如不能包含类似点点（..）,点下划线（.）的组合。 是 请求示例 启动名为testcloudtrail的跟踪。 POST / HTTP/1.1 Host:ooscncloudtrail.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190422T054520Z XAmzTarget:cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.StartLogging ContentType:application/json {"Name":"testcloudtrail"} 响应示例 HTTP/1.1 200 OK xamzrequestid:e543b10f6249483c Date:Mon, 22 Apr 2019 05:45:20 GMT Server:CTYUN

响应示例 HTTP/1.1 200 OK xamzrequestid:771c9193addb4861 ContentType:application/json;charsetUTF8 ContentLength:231 Date:Mon, 22 Apr 2019 03:28:47 GMT Server:CTYUN {"EventSelectors":[{"ReadWriteType":"WriteOnly"}],"TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/testcloudtrail"}

项目 勾选用户自主管理密码 不勾选用户自主管理密码 限制用户登录，允许用户重置密码 任何时候，IAM用户都可以自己修改密码。 只能密码过期后，允许IAM修改一次密码。 限制用户登录，不允许用户重置密码 任何时候，控制台用户无法修改密码，可以通过API进行修改。 IAM用户任何时候都不能自行修改密码。

IfExists条件运算符 IfExists：如果请求的内容中存在关键字，则依照策略所述的条件来处理关键字。如果该关键字不存在，则条件元素的计算结果将为true。 目前仅Bool型和数字类型的运算符支持使用IfExists条件运算符，表达形式：运算符IfExists，例如BoolIfExists、NumericEqualsIfExists。对于…IfExists的使用见示例1和示例2。 示例1 拒绝没有使用MFA认证的控制台请求，不拒绝使用MFA认证的控制台请求和使用密钥的API请求。但如果允许使用MFA认证的控制台请求和使用密钥的API请求，需要再写显性允许语句。 "Effect" : "Deny", "Condition" : { "Bool" : { "ctyun:MultiFactorAuthPresent" : false } } 拒绝没有使用MFA认证的控制台请求及使用密钥的API请求，不拒绝MFA认证的控制台请求。但如果允许MFA认证的控制台请求，需要再写显性允许语句。 "Effect" : "Deny", "Condition" : { "BoolIfExists" : { "ctyun:MultiFactorAuthPresent" : false } } 示例2 允许使用MFA认证在1800秒内的请求及使用密钥的API请求。 "Effect" : "Allow", "Condition" : { " NumericLessThanEqualsIfExists" : { "ctyun:MultiFactorAuthAge " : 1800 } } 允许使用MFA认证在1800秒内的请求，但不允许MFA认证超过1800秒以上及没有使用MFA的请求（包括API请求）。 "Effect" : "Allow", "Condition" : { " NumericLessThanEquals" : { "ctyun:MultiFactorAuthAge " : 1800 } }

响应示例 HTTP/1.1 200 OK xamzrequestid:570a1b70a73f4b3c ContentType:application/json;charsetUTF8 ContentLength:325 Date:Fri, 19 Apr 2019 07:33:39 GMT Server:CTYUN {"trailList":[{"Name":"testcloudtrail","S3BucketName":"examplebucket","TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/testcloudtrail"}]}

本节主要介绍GetTrailStatus。 此操作用来获取跟踪状态信息。 请求参数 名称 描述 是否必须 ::: Name 指定跟踪的名称。 类型：字符串。 取值：3~128个字符。 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 响应结果 名称 描述 :: IsLogging 是否开启跟踪： true：已经开启跟踪。 false：未开启跟踪。 LatestDeliveryTime 跟踪最近一次向Bucket保存日志的时间。 说明 如果没有开启过跟踪，则不会返回此字段。 StartLoggingTime 最后一次跟踪的起始时间。unix时间戳（UTC），时间精确到毫秒。 说明 如果没有开启过跟踪，则不会返回此字段。 StopLoggingTime 最后一次跟踪的停止时间。unix时间戳（UTC），时间精确到毫秒。 说明 如果没有开启过跟踪，则不会返回此字段。 LatestDeliveryError 最近一次向Bucket保存日志时遇到的错误。如果没有错误，不返回此项。 当目标Bucket不存在时，返回：NoSuchBucket。 当目标Bucket已无权访问，返回：AccessDenied。

本节主要介绍统计的错误码。 响应码 错误码(code) 错误信息(message) 错误描述 :::: 403 AccessDenied User:user is not authorized to perform: action on resource:resource. 没有查询统计信息的权限。 405 MethodNotAllowed Method does not exist or is not attachable. 方法不被允许。 500 InternalError We encountered an internal error. Please try again. 发生内部错误。 400 InvalidArgument Invalid BeginDate or EndDate on querying by day 按天查询时，时间请求参数不合法。 400 InvalidArgument Invalid BeginDate or EndDate. 时间请求参数格式无效。 400 InvalidArgument Invalid BeginDate and EndDate. beginDate不早于endDate。 400 InvalidArgument Invalid EndDate. （旧接口）结束时间请求参数不合法，时间点不是整5分钟或EndDate晚于当前时刻。 400 InvalidArgument Invalid BeginDate. （旧接口）开始时间请求参数不合法，时间点不是整5分钟或BeginDate早于一个月前。 400 InvalidArgument Invalid BeginDate and EndDate. Too large time gap. beginDate和endDate之间时间间隔不能大于5分钟（旧api获取连接数）。 400 InvalidArgument Invalid Freq. 频率Freq请求参数格式不正确。 400 InvalidArgument Invalid NetType. 网络类型（精品网/普通网）请求参数不合法。 400 InvalidArgument Missing Freq. 没有输入参数Freq。

名称 描述 是否必须 Name 指定跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（ ）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（ ）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 S3BucketName 指定OOS Bucket名称。 是 S3KeyPrefix 指定跟踪日志的名称前缀。 指定日志前缀的存储路径为： BucketName /<日志的名称前缀>/OOSLogs/<账号ID>/CloudTrail/<年>/<月>/<日>/<日志数据文件>。 未指定日志前缀的存储路径为： BucketName /OOSLogs/<账号ID>/CloudTrail/<年>/<月>/<日>/<日志数据文件>。 类型：字符串 取值：0~200个字符。 否

签名过程 下图说明了签名计算过程。 下表描述了图中显示的功能。用户需要为这些功能实现代码。 功能 描述 :: Lowercase() 将字符串转换为小写。 Hex() 小写十六进制编码。 SHA256Hash() 安全散列算法（SHA）加密散列函数。 HMACSHA256() 使用提供的签名密钥的SHA256算法计算HMAC。这是最终的签名。 Trim() 删除任何前导或尾随空格。 UriEncode() URI编码每个字节。UriEncode（）必须强制执行以下规则： URI编码除了下面字符之外的每个字节：'A' 'Z'，'a' 'z'，'0' '9'，' '，'.'，''和'〜'。 空格字符是保留字符，必须编码为“％20”（而不是“+”）。 每个URI编码字节由'％'和两位十六进制值组成。 十六进制值中的字母必须为大写，例如“％1A”。 除了文件名之外，对正斜杠字符'/'进行编码。例如，如果文件名称为photos/Jan/sample.jpg，则不对键名称中的正斜杠进行编码。 说明 建议您编写自己的自定义UriEncode函数，以确保您的编码可以正常工作。 以下是Java中的示例UriEncode（）函数。 public static String UriEncode(CharSequence input, boolean encodeSlash) { StringBuilder result new StringBuilder(); for (int i 0; i 'A' && ch 'a' && ch '0' && ch < '9') ch '' ch '' ch '~' ch '.') { result.append(ch); } else if (ch '/') { result.append(encodeSlash ? "%2F" : ch); } else { result.append(toHexUTF8(ch)); } } return result.toString(); } 使用参数的签名过程与使用请求头的签名过程类似，如下所示： 由于创建预签名URL的时候，并不知道有效负载的内容，所以设置常量UNSIGNEDPAYLOAD。 规范查询字符串（Canonical Query String）必须包括除了XAmzSignature之外的所有上述查询字符串。 规范标头必须包括HTTP Host标头。如果用户想包含xamz请求头，这些标头都将参与签名计算。用户可以选择其他的请求头是否参与签名计算。安全起见，尽可能多的请求头参与签名计算。