名称 描述 Groups.member.GroupName IAM用户组名。 Groups.member.GroupId IAM用户组ID。 Groups.member.Arn IAM用户组的资源名称。 Groups.member.CreateDate IAM用户组创建的时间。 IsTruncated 用户组是否已经都返回： true：有未返回的用户组。 false：已经返回所有的用户组。 Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。

本节主要介绍UpdateAccessKey。 此操作用来更新指定访问密钥（AK）的状态，从Active到Inactive，或者从Inactive到Active。 说明 如果请求中未携带IAM用户名，则更新请求者的密钥状态。 此操作可以管理根用户的密钥。 请求参数 名称 描述 是否必须 ::: Action UpdateAccessKey。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 UserName 指定需要更新密钥状态用户的用户名。 类型：字符串 取值：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 否 AccessKeyId 需要更新的访问密钥ID。 类型：字符 是 Status 访问密钥的状态。 类型：字符串 Active：密钥启用，可以使用该密钥调用API。 Inactive：密钥禁用，不可以使用该密钥调用API。 是 请求示例 将IAM用户test的AccessKey（AccessKeyId5cd1fb5a7ecb095b242b）状态修改为Inactive。 POST / HTTP/1.1 Authorization: signatureValue xamzdate: 20260519T013010Z xamzcontentsha256: UNSIGNEDPAYLOAD ContentType: application/octetstream ContentLength: 104 Host: ooscniam.ctyunapi.cn ActionUpdateAccessKey&Version20100508&UserNametest&AccessKeyId5cd1fb5a7ecb095b242b&StatusInactive

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

本节主要介绍StopLogging。 此操作用来停止跟踪功能。 请求参数 名称 描述 是否必须 ::: Name 跟踪的名称。 类型：字符串 取值：3~128字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 请求示例 停止名为testcloudtrail的跟踪。 POST / HTTP/1.1 Authorization: signatureValue xamzdate: 20260514T100835Z xamzcontentsha256: UNSIGNEDPAYLOAD XAmzTarget: cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.StopLogging ContentType: application/json ContentLength: 36 Host: ooscncloudtrail.ctyunapi.cn { "Name": "testcloudtrail" } 响应示例 HTTP/1.1 200 OK xamzrequestid: 8a5fabd5c77d4f50 Date: Thu, 14 May 2026 10:08:35 GMT ContentType: application/json;charsetUTF8 ContentLength: 0 Server:CTYUN

本节主要介绍CreateUser。 此操作用来创建新的IAM用户。 请求参数 名称 描述 是否必须 ::: Action CreateUser。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 UserName 创建IAM用户的用户名，用户名在账户中必须唯一。 类型：字符串 取值：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 Tags.member.N.Key&Tags.member.N.Value 附加到新创建IAM用户的标签列表。标签包括标签键和值。Tags.member.N.Key为标签键，Tags.member.N.Value为标签值。 类型：字符串 取值：Tags.member.N.Key由1~128位字符串组成，字符串符合表达式[p{L}p{Z}p{N}.:/+@]+；Tags.member.N.Value由0~256位字符串组成，字符串符合表达式[p{L}p{Z}p{N}.:/+@]。 注意 最多包含10个标签。如果任何一个标签无效或者如果超过每个用户允许的标签数，则整个请求将失败，并且不会创建用户。 否 响应结果 名称 描述 :: Arn IAM用户的资源名称。 UserName IAM用户的名称。 UserId IAM用户ID。 Tags.member.Key IAM用户标签键。 Tags.member.Value IAM用户标签值。 CreateDate IAM用户创建时间。

名称 描述 是否必须 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}.:/+@]。 是

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

名称 描述 Events 根据查询条件，返回的管理事件。 NextToken 分页标识。如果没有返回该值，则说明已经返回所有的查询结果。

响应示例 HTTP/1.1 200 OK xamzrequestid: 4cda730e201549bf ContentType: application/json;charsetUTF8 ContentLength: 414 Date: Thu, 14 May 2026 07:29:09 GMT Server: CTYUN { "trailList": [ { "S3KeyPrefix": "auditlog", "S3BucketName": "examplebucket", "Name": "testcloudtrail", "TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/testcloudtrail" }, { "S3BucketName": "examplebucket", "Name": "test1", "TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/test1" }, { "S3KeyPrefix": "test2", "S3BucketName": "examplebucket", "Name": "test2", "TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/test2" } ] }

本节主要介绍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 Authorization: signatureValue xamzdate: 20260514T091836Z xamzcontentsha256: UNSIGNEDPAYLOAD XAmzTarget: cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.GetEventSelectors ContentType: application/json ContentLength: 41 Host: ooscncloudtrail.ctyunapi.cn { "TrailName": "testcloudtrail" } 响应示例 HTTP/1.1 200 OK xamzrequestid: 35b715d5a8954c4a ContentType: application/json;charsetUTF8 ContentLength: 122 Date: Thu, 14 May 2026 09:18:37 GMT Server: CTYUN { "EventSelectors": [ { "ReadWriteType": "WriteOnly" } ], "TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/testcloudtrail" }

本节主要介绍UpdateTrail。 此操作用来更新跟踪设置参数，包括跟踪日志数据保存的OOS Bucket、跟踪日志前缀等。 说明 更新跟踪时，无需暂停跟踪。 如果S3BucketName和S3KeyPrefix都未指定，该操作不起作用，但是不报错，返回200 OK。 请求参数 名称 描述 是否必须 ::: Name 跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 S3BucketName OOS Bucket名称。 否 S3KeyPrefix 指定跟踪日志的名称前缀。 类型：字符串 取值：0~200个字符。 否 响应结果 名称 描述 Name 跟踪的名称。 S3BucketName OOS Bucket名称。 S3KeyPrefix 跟踪日志的名称前缀。 TrailARN 跟踪的ARN。 请求示例 更新名为testcloudtrail的跟踪信息，将跟踪日志前缀更新为 auditLog2 。 POST / HTTP/1.1 Authorization: signatureValue xamzdate: 20260514T095155Z xamzcontentsha256: UNSIGNEDPAYLOAD XAmzTarget: cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.UpdateTrail ContentType: application/json ContentLength: 41 Host: ooscncloudtrail.ctyunapi.cn { "Name": "testcloudtrail", "S3KeyPrefix": "auditLog2" }

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

名称 描述 EventSelectors.ReadWriteType 管理事件的读写类型： ReadOnly：只读。 WriteOnly：只写。 All：所有管理事件。 TrailARN 跟踪的ARN。

名称 描述 是否必须 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个字符。 否

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

请求示例 按天（byDay）查询Bucket为examplebucket、数据位置为ZhengZhou、20260511至20260512的所有标准存储数据请求次数。 plaintext GET /?ActionGetRequests&FreqbyDay&Bucketexamplebucket&BeginDate20260511&EndDate20260512 HTTP/1.1 xamzcontentsha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 xamzdate: 20260522T065430Z Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn Connection: keepalive 响应示例 plaintext HTTP/1.1 200 OK Date: Fri, 22 May 2026 06:54:30 GMT xamzrequestid: ae854779a9a44204 ContentType: application/xml; charsetutf8 ContentLength: 1301 Server: CTYUN test@ctyun.cn root STANDARD UTC +0800 all all byDay examplebucket 20260511 4 0 0 0 0 0 0 0 0 0 0 0 4 20260512 0 0 0 0 0 0 0 0 0 0 0 0 0

本节主要介绍GetReturnCode。 此操作用来查询用户请求返回码次数。 请求参数 名称 描述 是否必须 Action GetReturnCode。 是 BeginDate 指定查询返回码次数的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询返回码统计次数的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值: ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 默认值为STANDARD。 否 Bucket 指定查询返回码的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有的Bucket的请求返回码次数之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询返回码的数据位置。如果不指定数据位置名称，则查询账户名下所有数据位置的请求返回码次数之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 香港节点：HongKong。 否 InternetType 指定返回码的网络类型互联网/非互联网。 类型：字符串 取值： all：指定返回互联网返回码和非互联网返回码。 internet：指定返回互联网的返回码。 noninternet：指定返回非互联网的返回码。 默认值为all。 否 RequestsType 指定返回返回码次数的请求类型，可以指定一个或多个返回码的请求类型，当申请多个RequestsType时，用“+”将类型分开。 类型：字符串 取值： all：指定返回所有请求类型的返回码次数。 get：指定返回get类型的返回码次数。 head：指定返回head类型的返回码次数。 put：指定返回put类型的返回码次数。 post：指定返回post类型的返回码次数。 delete：指定返回delete类型的返回码次数。 others：指定返回除上述外的其他类型的返回码次数。 默认值为all。 否 ResponseType 指定返回的返回码类型，可以指定一个或多个返回码的请求类型，当申请多个ResponseType时，用“+”将类型分开。 类型：字符串 取值： all：指定返回所有类型的返回码次数。 Response200。 Response204：仅delete支持Response204。Response206：仅get和head支持Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

本节主要介绍GetRestoreCapacity。 此操作用来查询数据取回量。用户可以根据需求，查询指定存储桶、指定存储类型的数据取回量。 请求参数 名称 描述 是否必须 Action GetRestoreCapacity。 是 BeginDate 指定查询数据取回量的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询数据取回量的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值： ALL：所有存储类型。 STANDARADIA：低频访问类型。 默认值为ALL。 否 Bucket 指定查询数据取回量的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的数据取回量之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询数据取回量的数据位置。如果不指定数据位置名称，则表示查询账户下所有数据位置的数据取回量之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 香港节点：HongKong。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 存储类型： ALL：所有存储。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 TimeZone 返回数据的时区，统一为UTC +0800。 Freq 统计数据的采样粒度： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 BucketName Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 RegionName 数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 Statistics.Date 返回结果对应的时间： 当请求参数Freq为by5min或byHour时，返回格式为yyyyMMdd HH:mm。 当请求参数Freq为byDay时，返回格式为yyyyMMdd。 Statistics.Data.MaxCapacity 标准存储数据的容量峰值，单位是Byte。 如果Freq值为by5min，该字段值显示为空 Statistics.Data.AverageCapacity 标准存储数据的容量平均值，单位是Byte。 如果Freq值为by5min，该字段值显示为空。 Statistics.Data.SampleCapacity 标准存储数据的实时容量值，单位是Byte。 Statistics.Standardia.MaxCapacity 低频访问存储数据的容量峰值，单位是Byte。 如果Freq值为by5min，该字段值显示为空。 Statistics.Standardia.AverageCapacity 低频访问存储数据的容量平均值，单位是Byte。 如果Freq值为by5min，该字段值显示为空。 Statistics.Standardia.SampleCapacity 低频访问存储数据的实时容量值，单位是Byte。

本节主要介绍GetBilledStorageUsage。 此操作用来查询收费容量。用户可以根据需求，查询指定存储桶、指定数据位置、指定存储类型的容量。 请求参数 名称 描述 是否必须 Action GetBilledStorageUsage。 是 BeginDate 指定查询容量的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询容量的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值： ALL：所有存储类型。 STANDARAD：标准类型。 STANDARADIA：低频访问类型。 默认值为ALL。 否 Bucket 指定查询收费容量的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的收费容量之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询收费容量的数据位置。如果不指定数据位置名称，则表示查询账户下所有数据位置的收费容量之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1、、ShangHai7、TianJin6。 香港节点：HongKong。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

名称 描述 是否必须 Action GetTraffics。 是 BeginDate 指定查询流量的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询流量的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值: ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 默认值为STANDARD。 否 Bucket 指定查询流量的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的流量之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询流量的数据位置。如果不指定数据位置，则查询账户名下所有数据位置的流量之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 香港节点：HongKong。 否 InOutType 指定返回的流量类型上行/下行。 类型：字符串 取值： all：指定返回上行流量和下行流量。 inbound：指定返回上行流量。 outbound：指定返回所下行流量。 默认值为all。 否 InternetType 指定返回的流量类型互联网/非互联网。 类型：字符串 取值： all：指定返回互联网流量和非互联网流量。 internet：指定返回互联网流量。 noninternet：指定返回非互联网流量。 默认值为all。 否 TrafficsType 指定返回的流量类型直接/漫游。 类型：字符串 取值： all：指定返回直接流量和漫游流量。 direct：指定返回直接流量。 roam：指定返回漫游流量。 默认值为all。 否 NetType 指定返回的网络类型精品网（CN2）/普通网（163）。仅香港节点支持本参数。 类型：字符串 取值： all：指定返回精品网和普通网的流量。 highqualitynet：指定返回精品网的流量。 normalqualitynet：指定返回普通网的流量。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

名称 描述 IsTruncated 与用户关联的策略是否都已经返回： true：有未返回的与用户关联的策略。 false：已经返回所有与用户关联的策略。 Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。 AttachedPolicies.member.PolicyArn 策略的资源名称。 AttachedPolicies.member.PolicyName 策略名称。 AttachedPolicies.member.Scope 策略类型： Local：用户自定义策略。 OOS：系统策略。 AttachedPolicies.member.Description 策略描述。

响应示例 HTTP/1.1 200 OK xamzrequestid:25999d8abffa4dbe ContentType:text/xml;charsetUTF8 ContentLength:218 Date:Fri, 22 Mar 2019 02:45:59 GMT Server: CTYUN 25999d8abffa4dbe

本节主要介绍DeleteAccessKey。 此操作用来删除指定IAM用户关联的AccessKey。 说明 如果未指定用户名，IAM将根据签名请求的OOS AccessKeyID确定用户名。 此操作也可以用来删除根用户的AccessKey。 请求参数 名称 描述 是否必须 ::: Action DeleteAccessKey。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 指定删除密钥的用户名。 类型 ：字符串 取值 ：1~64位字符串组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 否 AccessKeyId 需要删除的访问密钥ID。 类型 ：字符串 是 请求示例 删除AccessKeyId535d97103885f22be7a1对应用户的AccessKey。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190202T011219Z ContentType: application/octetstream ActionDeleteAccessKey&Version20100508&AccessKeyId535d97103885f22be7a1 响应示例 HTTP/1.1 200 OK xamzrequestid:66375df54d24461d ContentType:text/xml;charsetUTF8 ContentLength:210 Date:Sat, 02 Feb 2019 01:12:20 GMT Server: CTYUN 66375df54d24461d

类型 数据名称 数据说明 计算方法 集群 CPU总量 当前时刻整个集群中所有节点的CPU总量。 所有节点CPU核心数总和。 集群 CPU实时申请量 当前时刻整个集群中所有pod的CPU申请量总和。 所有pod CPU申请量总和。 集群 CPU使用量 当前时刻整个集群中所有pod的CPU使用量总和。 所有pod CPU使用量总和。 集群 CPU闲置量 当前时刻整个集群中所有节点的CPU总闲置量。 CPU总量CPU总使用量。 集群 CPU实时利用率 当前时刻整个集群中CPU的利用率。 CPU使用量 / CPU申请量 100% 集群 CPU利用率峰值 过去24h整个集群中CPU利用率的最大值。 过去24h中，Max(CPU使用量 / CPU申请量 100%)。 集群 CPU利用率均值 过去24h整个集群中CPU利用率的平均值。 过去24h中，Avg(CPU使用量 / CPU申请量 100%)。 集群 单core成本趋势 集群中各节点每core CPU成本的平均值。 Avg(∑节点每core CPU成本)。 集群 单内存成本趋势 集群中各节点每G内存成本的平均值。 Avg(∑节点每G内存成本)。 节点池和节点 节点池Top 5 在本月截止当前时刻整个集群中，至今成本最高的前5个节点池。 在本月截止当前时刻整个集群中，至今成本最高的前5个节点池。 节点池和节点 至今成本 在本月截止当前时刻，所选节点池中所有节点的总物理IaaS资源成本，包含Ecs节点和挂载的云硬盘。 所选节点池中，∑节点费用+∑节点挂载的云硬盘费用。 节点池和节点 已用成本 在本月截止当前时刻，运行在所选节点池中所有节点上的pod总估算成本。 所选节点池下所有节点上的pod估算成本总和。 命名空间 至今成本 按命名空间估算成本占集群总估算成本的比例，对集群至今成本进行分摊，把IaaS物理资源成本按比例分摊到命名空间上。 集群至今成本 (所选命名空间已用成本 / 集群已用成本)。 命名空间 已用成本 所选命名空间下所有pod估算成本。 ∑(命名空间下pod估算成本)。 工作负载 至今成本 按工作负载估算成本占集群总估算成本的比例，对集群至今成本进行分摊，把IaaS物理资源成本按比例分摊到工作负载上 集群至今成本 (所选工作负载已用成本 / 集群已用成本)。 工作负载 已用成本 所选工作负载下所有pod估算成本总和。 ∑(工作负载下pod估算成本)。 工作负载 pod成本 根据pod的CPU/内存资源的使用量和申请量，结合pod所在节点的CPU/内存资源单价，估算单个pod的成本。 pod成本Max(CPU申请量， CPU使用量) 所在节点CPU单价 + Max(内存申请量， 内存使用量) 所在节点内存单价。 节点CPU单价 节点单价 / 2 / 节点CPU核数。 节点内存单价 节点单价 / 2 / 节点内存GiB数。

查询单集群维度成本 1. 登录云容器引擎控制台。 2. 进入集群列表页面。 3. 选择目标集群，进入集群详情页。 4. 左侧菜单栏点击成本分析。 5. 单集群中支持集群、节点池和节点、命名空间、工作负载维度查看不同资源的成本，可通过切换tab页面查看。 6. 重点数据和计算方法如下： 类型 数据名称 数据说明 计算方法 集群 CPU总量 当前时刻整个集群中所有节点的CPU总量。 所有节点CPU核心数总和。 集群 CPU实时申请量 当前时刻整个集群中所有pod的CPU申请量总和。 所有pod CPU申请量总和。 集群 CPU使用量 当前时刻整个集群中所有pod的CPU使用量总和。 所有pod CPU使用量总和。 集群 CPU闲置量 当前时刻整个集群中所有节点的CPU总闲置量。 CPU总量CPU总使用量。 集群 CPU实时利用率 当前时刻整个集群中CPU的利用率。 CPU使用量 / CPU申请量 100% 集群 CPU利用率峰值 过去24h整个集群中CPU利用率的最大值。 过去24h中，Max(CPU使用量 / CPU申请量 100%)。 集群 CPU利用率均值 过去24h整个集群中CPU利用率的平均值。 过去24h中，Avg(CPU使用量 / CPU申请量 100%)。 集群 单core成本趋势 集群中各节点每core CPU成本的平均值。 Avg(∑节点每core CPU成本)。 集群 单内存成本趋势 集群中各节点每G内存成本的平均值。 Avg(∑节点每G内存成本)。 节点池和节点 节点池Top 5 在本月截止当前时刻整个集群中，至今成本最高的前5个节点池。 在本月截止当前时刻整个集群中，至今成本最高的前5个节点池。 节点池和节点 至今成本 在本月截止当前时刻，所选节点池中所有节点的总物理IaaS资源成本，包含Ecs节点和挂载的云硬盘。 所选节点池中，∑节点费用+∑节点挂载的云硬盘费用。 节点池和节点 已用成本 在本月截止当前时刻，运行在所选节点池中所有节点上的pod总估算成本。 所选节点池下所有节点上的pod估算成本总和。 命名空间 至今成本 按命名空间估算成本占集群总估算成本的比例，对集群至今成本进行分摊，把IaaS物理资源成本按比例分摊到命名空间上。 集群至今成本 (所选命名空间已用成本 / 集群已用成本)。 命名空间 已用成本 所选命名空间下所有pod估算成本。 ∑(命名空间下pod估算成本)。 工作负载 至今成本 按工作负载估算成本占集群总估算成本的比例，对集群至今成本进行分摊，把IaaS物理资源成本按比例分摊到工作负载上 集群至今成本 (所选工作负载已用成本 / 集群已用成本)。 工作负载 已用成本 所选工作负载下所有pod估算成本总和。 ∑(工作负载下pod估算成本)。 工作负载 pod成本 根据pod的CPU/内存资源的使用量和申请量，结合pod所在节点的CPU/内存资源单价，估算单个pod的成本。 pod成本Max(CPU申请量， CPU使用量) 所在节点CPU单价 + Max(内存申请量， 内存使用量) 所在节点内存单价。 节点CPU单价 节点单价 / 2 / 节点CPU核数。 节点内存单价 节点单价 / 2 / 节点内存GiB数。

本节介绍了MySQL主备复制原理简介的内容。 RDS for MySQL的默认备库、只读实例、自建从库、DRS链路灾备实例均采用MySQL的Binlog复制技术，也称为MySQL主备复制或主从复制技术。本章节介绍MySQL的主从复制原理。 主备复制流程 主节点（Master）中有数据更新时，会按照Binlog格式，将更新的操作以event形式写入到主节点的Binlog中。event有多种类型：INSERT、DELETE、UPDATE、QUERY等。 从节点（Slave）连接主节点时，有多少个从节点就会创建多少个Binlog dump线程。 当主节点的Binlog发生变化时，Binlog dump线程会通知所有从节点，并将相应Binlog内容推给从节点。 从节点的I/O thread收到Binlog内容后，会将内容写到本地relay log（中继日志）。 从节点的SQL thread会读取I/O thread写入的relay log，并且根据relay log中的event，回放对应的操作（DML、DDL等）。 SecondsBehindMaster计算方式 SecondsBehindMaster即主备复制时延，通过show slave status查询获取。SecondsBehindMaster计算的伪代码实现如下： plaintext if (SQL thread is running) //如果SQL线程启动 { if (SQL thread processed all the available relay log) //IO thread拉取主库Binlog的位置和sql thread应用的relay log相对于主库Binlog的位置相等 { if (IO thread is running) //如果IO线程启动，设置延迟为0 print 0; else //如果IO线程未启动，设置延迟为null print NULL; } else //如果SQL线程没有应用完所有的IO线程写入的event，那么需要计算SecondsBehindMaster 按公式计算SecondsBehindMaster的值; } else //如果SQL线程也没有启动，则设置为空值 print NULL; 上述伪代码中，SecondsBehindMaster的计算公式为： SecondsBehindMaster time(0) lastmastertimestamp clockdiffwithmaster 相关变量含义如下： 1. time(0)：当前从节点服务器的系统时间。 2. clockdiffwithmaster：从节点的系统时间和主节点服务器系统时间的差值，一般为0。如果主从节点系统时间不一致，那么计算出的从节点复制时延会不准确。 3. lastmastertimestamp：从节点在回放relay log中event过程中计算和更新，该变量在并行复制（MTS）和非并行复制方式下，更新的时机是不同的，默认全部开启并行复制： − 并行复制：可以简单理解为，从节点的SQL线程在每个事务执行完成后，更新lastmastertimestamp值，其更新是以事务为单位。所以大事务、DDL容易导致主备延迟大。 − 非并行复制：从节点的SQL线程读取了relay log中的事务后，事务未执行前便会更新lastmastertimestamp，其更新是以事务为单位。 综上所述，SecondsBehindMaster的计算公式可以理解为： SecondsBehindMaster 当前从节点服务器的系统时间 从节点SQL线程处理中事务在主节点的执行时间 从节点的系统时间和主节点服务器系统时间的差值。

本节介绍了主备复制时延瞬间飚高回落的相关内容。 场景描述 只读实例的CES监控上，出现只读复制时延会在某个瞬间升高并回落，如下图： 原因分析 此类问题与复制时延（SecondsBehindMaster）的计算方式相关，关于复制时延的计算方式，详见MySQL主备复制原理简介。 出现复制时延尖峰是因为：只读节点IO线程刚好接收到了一个新的Binlog文件，而其SQL线程还没开始回放新的Binlog。导致计算复制时延的lastmastertimestamp值还停留在上一个Binlog事务在主机的执行时间，与当前只读节点系统时间time(0)存在时间差，从而出现复制时延尖峰。当SQL线程开始解析新的Binlog时，复制时延立刻回落。 此类问题为偶现现象，不影响实际业务。 下载复制时延飚高回落时间段的Binlog，会发现如下现象： 新的Binlog的第一个事务执行时间与上一个Binlog最后一个事务的结束时间刚好与突增回落的时间差匹配。 解决方案 无需解决。该场景为RDS for MySQL主备复制机制中的正常行为，为偶现现象。

响应结果 名称 描述 InitiateMultipartUploadResult 包含所有返回元素的容器。 类型：容器。 子节点：Bucket，Key，UploadId。 Bucket 分片上传对应的Bucket的名称。 类型：字符串。 父节点：InitiateMultipartUploadResult。 Key 分片上传对应的文件名称。 类型：字符串。 父节点：InitiateMultipartUploadResult。 UploadId 分片上传ID。 类型：字符串。 父节点：InitiateMultipartUploadResult。 请求示例 初始化一个名为“exampleobject”文件的分片上传操作。 plaintext POST /exampleobject?uploads HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Mon, 1 Nov 2010 20:34:56 GMT Authorization: SignatureValue 响应示例 plaintext HTTP/1.1 200 OK xamzrequestid: 656c76696e672773207265717565737415ecaced5ddd5d7dda Date: Mon, 1 Nov 2010 20:34:56 GMT ContentLength: 197 Server: CTYUN examplebucket exampleobject 1638428231343309398

名称 描述 是否必须 Action GetConcurrentConnection。 是 BeginDate 指定查询并发连接数的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询并发连接数的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 EndDate与BeginDate的间隔小于1天。 是 Bucket 指定查询并发连接数Bucket的名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的并发连接数之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询并发连接数的数据位置。如果不指定数据位置名称，则查询账户名下所有数据位置的并发连接数之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 香港节点：HongKong。 否 InternetType 指定返回并发连接数的网络类型互联网/非互联网。 类型：字符串 取值： all：指定返回互联网并发连接数和非互联网并发连接数。 internet：指定返回互联网的并发连接数。 noninternet：指定返回非互联网的并发连接数。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值：by5min：统计数据的采样粒度为5分钟。 默认值为by5min。 否

其他地域 除对象存储网络、对象存储网络2和香港节点外，其他地域的Endpoint列表如下。 地区 OOS API Endpoint 江苏 oosjs.ctyunapi.cn

变量 描述 xamzexpiration 如果文件被配置了到期时间，那么OOS返回此响应头。这个响应头包含键值对expirydate和ruleid。ruleid的值是URL编码的。 xamzstorageclass 文件的存储类型。如果存储类型为STANDARD，不返回此项。 类型：字符串。 取值：STANDARDIA：低频访问存储。 xctyunmetadatalocation 文件的索引位置。 注意 香港节点不会返回此项。 类型：枚举。 取值： 对于对象存储网络，取值为：ChengDu、FuZhou、GuiYang、HangZhou、LaSa、LanZhou、QingDao、ShenYang、ShenZhen、WuHan、WuHu、WuLuMuQi、ZhengZhou、SH2、SuZhou。 对于对象存储网络2，取值为：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 xctyundatalocation 文件的数据位置。 注意 香港节点不会返回此项。 类型：枚举。 取值： 对于对象存储网络，取值为：ChengDu、GuiYang、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 对于对象存储网络2，取值为：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 xamzmeta 以该前缀开头的用户定义的元数据响应头。每一个都作为一组键值对存储和返回。OOS不验证或解释用户定义的元数据。 类型：字符串。 xctyunlastaccesstime Object的最后一次访问时间。 如果为Object开启了匹配最后一次访问时间的生命周期规则，会返回该响应头，否则不返回该响应头。 注意 对于一天内多次访问同一个Object（GET操作），仅记录该Object的该天最早一次访问时间。