响应示例 HTTP/1.1 200 OK xamzrequestid: 91a8c988354446fd ContentType: text/xml ContentLength: 339 Date: Tue, 19 May 2026 03:23:20 GMT Server: CTYUN test11 false 20260519T03:23:20Z 91a8c988354446fd

本节主要介绍GetLoginProfile。 此操作用来获取IAM用户控制台登录密码创建的时间、及用户首次登录后是否需要修改密码。 请求参数 名称 描述 是否必须 ::: Action GetLoginProfile。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 需要查询的IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 响应结果 名称 描述 :: UserName IAM用户名。 PasswordResetRequired IAM用户使用初始密码登录控制台后是否需要重置密码： true：使用初始密码登录后，需要重置密码后才可以执行操作。 false：使用初始密码登录后，无需重置密码也可以执行操作。 CreateDate IAM用户控制台密码创建的时间。 请求示例 获取IAM用户test11控制台登录密码创建的时间、及用户首次登录后是否需要修改密码。 POST / HTTP/1.1 Authorization: signatureValue xamzdate: 20260519T054027Z xamzcontentsha256: UNSIGNEDPAYLOAD ContentType: application/octetstream ContentLength: 57 Host: ooscniam.ctyunapi.cn ActionGetLoginProfile&Version20100508&UserNametest11 响应示例 HTTP/1.1 200 OK xamzrequestid: 32726d6727fc4964 ContentType: text/xml;charsetUTF8 ContentLength: 327 Date: Tue, 19 May 2026 05:40:28 GMT Server: CTYUN test11 false 20260519T03:23:20Z 32726d6727fc4964

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

本节主要介绍ListUserTags。 此操作用来列出指定IAM用户的标签。 请求参数 名称 描述 是否必须 ::: Action ListUserTags。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 查询用户的用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 Marker 分页标识。还有需要返回的标签时，上条响应结果中会返回该参数。查看未显示标签时，请求参数中需要携带此参数。 类型 ：字符串 取值 ：与上条响应中返回的结果值相同。 否 MaxItems 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示需要再次发送请求查看未显示的项。查看未显示的项时，需要携带响应参数Marker的值。 类型 ：整型 取值 ：1~1000，默认值为100。 否 响应结果 名称 描述 :: IsTruncated 标签是否已经都返回： true：有未返回的标签。 false：已经返回所有的标签。 Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。 Tags.member.Key 标签键。 Tags.member.Value 标签值。

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

响应示例 HTTP/1.1 200 OK xamzrequestid: 9f62de7f44a24297 ContentType: text/xml ContentLength: 127 Date: Tue, 19 May 2026 01:30:10 GMT Server: CTYUN 9f62de7f44a24297

本节主要介绍DeleteUser。 此操作用来删除指定的IAM用户。 注意 被删除的IAM用户必须符合下列条件：没有控制台的登录密码，没有AK/SK，没有加入用户组，没有绑定MFA，没有绑定策略。 请求参数 名称 描述 是否必须 ::: Action DeleteUser。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 删除IAM用户的用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 请求示例 删除用户名为test14的IAM用户。 POST / HTTP/1.1 Authorization: signatureValue xamzdate: 20260515T085845Z xamzcontentsha256: UNSIGNEDPAYLOAD ContentType: application/octetstream ContentLength: 52 Host: ooscniam.ctyunapi.cn ActionDeleteUser&UserNametest14&Version20100508 响应示例 HTTP/1.1 200 OK xamzrequestid: d33772bb07444c4c ContentType: text/xml;charsetUTF8 ContentLength: 117 Date: Thu, Fri, 15 May 2026 08:58:46 GMT Server: CTYUN d33772bb07444c4c

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

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

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

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

响应结果 名称 描述 :: Events 根据查询条件，返回的管理事件。 NextToken 分页标识。如果没有返回该值，则说明已经返回所有的查询结果。 请求示例 查询账户中的只读事件。 POST / HTTP/1.1 Authorization: SignatureValue xamzdate: 20240725T092748Z xamzcontentsha256: UNSIGNEDPAYLOAD XAmzTarget: cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.LookupEvents ContentType: application/json ContentLength: 153 Host: ooscncloudtrail.ctyunapi.cn { "MaxResults": 2, "LookupAttributes": [ { "AttributeKey": "ReadOnly", "AttributeValue": "true" } ] } 响应示例 HTTP/1.1 200 OK xamzrequestid: f7d150a0f43b4681 Date: Thu, 25 Jul 2024 09:27:50 GMT ContentType: application/json; charsetutf8 ContentLength: 1498 Server:CTYUN { "NextToken": "18178542006710712117501472477088833290", "Events": [ { "CloudTrailEvent": { "eventId": "7501472382852511156", "eventVersion": "1.06", "eventSource": "ooscncloudtrail.ctyunapi.cn", "requestParameters": { "MaxResults": 2, "LookupAttributes": [ { "AttributeKey": "ReadOnly", "AttributeValue": "true" } ] }, "userAgent": "PostmanRuntime/7.6.0", "readOnly": true, "userIdentity": { "accessKeyId": "6c1ceb071a848d7d14d5", "accountId": "0dt7bj6yazfmz", "principalId": "0dt7bj6yazfmz", "type": "Root", "arn": "arn:ctyun:iam::0dt7bj6yazfmz:root" }, "eventType": "ApiCall", "serviceName": "CloudTrail", "sourceIp": "10.183.14.70", "requestId": "40a279e6142e4a3f", "requestURL": " "eventTime": "20240725T09:27:34Z", "eventName": "LookupEvents", "requestRegion": "cn", "managementEvent": true } }, { "CloudTrailEvent": { "eventId": "7501472428925466693", "eventVersion": "1.06", "eventSource": "ooscncloudtrail.ctyunapi.cn", "requestParameters": { "LookupAttributes": [ { "AttributeKey": "ReadOnly", "AttributeValue": "true", "MaxResults": 2 } ] }, "userAgent": "PostmanRuntime/7.6.0", "readOnly": true, "userIdentity": { "accessKeyId": "6c1ceb071a848d7d14d5", "accountId": "0dt7bj6yazfmz", "principalId": "0dt7bj6yazfmz", "type": "Root", "arn": "arn:ctyun:iam::0dt7bj6yazfmz:root" }, "eventType": "ApiCall", "serviceName": "CloudTrail", "sourceIp": "10.183.14.70", "requestId": "5730fff074354dd9", "requestURL": " "eventTime": "20240725T09:26:47Z", "eventName": "LookupEvents", "requestRegion": "cn", "managementEvent": true } } ] }

名称 描述 是否必须 TrailNameList 指定跟踪的名称列表。可以指定一个或多个跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（ ）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（ ）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 说明 如果名称列表为空{"TrailNameList":[]}，则返回所有跟踪。 如果指定的任一trail名称不存在，则不返回此trail。 如果指定的所有trail名称都不存在，则返回空列表，即{"trailList":[]}。 否

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

响应示例 HTTP/1.1 200 OK xamzRequestId: 9d064a6e98b14f9e ContentType: application/json;charsetUTF8 ContentLength: 157 Date: Thu, 14 May 2026 09:51:55 GMT Server: CTYUN { "S3KeyPrefix": "auditLog2", "S3BucketName": "examplebucket", "Name": "testcloudtrail", "TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/testcloudtrail" }

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

响应示例 HTTP/1.1 200 OK xamzrequestid: 5b7b8d59d1914354 ContentType: application/json;charsetUTF8 ContentLength: 116 Date: Thu, 14 May 2026 08:59:27 GMT Server: CTYUN { "EventSelectors": [ { "ReadWriteType": "WriteOnly" } ], "TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/testcloudtrail" }

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

本节主要介绍GetRequests。 此操作用来查询用户的请求次数。 请求参数 名称 描述 是否必须 Action GetRequests。 是 BeginDate 指定查询请求次数的起始时间，统计数据的起始时间（时区为：UTC+8）为开始日期的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 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 指定返回的请求类型。 类型：字符串 取值： all：指定返回所有类型的请求次数。 get：指定返回get类型的请求次数。 head：指定返回head类型的请求次数。 put：指定返回put类型的请求次数。 post：指定返回post类型的请求次数。 delete：指定返回delete类型的请求次数。 others：指定返回除上述外的其他类型的请求次数。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

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

响应结果 名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 存储类型： ALL：所有存储类型。 STANDARADIA：低频访问类型。 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.Standardia.RestoreCapacity 低频访问存储取回量，单位是Byte。 请求示例 按天（byDay）查询所有存储桶、所有地域20260519所有存储类型的数据取回量。 plaintext GET /?ActionGetRestoreCapacity&BeginDate20260519&EndDate20260519&StorageClassALL&FreqbyDay HTTP/1.1 xamzcontentsha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 xamzdate: 20260522T060639Z Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn Connection: keepalive 响应示例 plaintext HTTP/1.1 200 OK Date: Fri, 22 May 2026 06:06:39 GMT xamzrequestid: eaed7d17df5a4164 ContentType: application/xml; charsetutf8 ContentLength: 401 Server: CTYUN test@ctyun.cn root ALL UTC +0800 byDay 20260519 731920486

请求示例 按天（byDay）查询Bucket为examplebucket、数据位置为ZhengZhou、20260521至20260522标准存储数据的容量。 plaintext GET /?ActionGetCapacity&StorageClassSTANDARD&Bucketexamplebucket&FreqbyDay&RegionZhengZhou&BeginDate20260521&EndDate20260522 HTTP/1.1 xamzcontentsha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 xamzdate: 20260522T024300Z Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn Connection: keepalive 响应示例 plaintext HTTP/1.1 200 OK Date: Fri, 22 May 2026 02:43:00 GMT xamzrequestid: 153adcd5705d4a28 ContentType: application/xml; charsetutf8 ContentLength: 656 Server: CTYUN test@ctyun.cn usertest1 STANDARD UTC +0800 byDay examplebucket ZhengZhou 20260521 2687873 2687873 2687873 20260522 2687873 2687873 2687873

名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 存储类型： ALL：所有存储类型。 STANDARAD：标准类型。 STANDARADIA：低频访问类型。 TimeZone 返回数据的时区，统一为UTC +0800。 Freq 返回统计数据的采样粒度： byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 BucketName Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 RegionName 数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 Statistics.Date 返回结果对应的时间： 当请求参数Freq为byHour时，返回格式为yyyyMMdd HH:mm。 当请求参数Freq为byDay时，返回格式为yyyyMMdd。 Statistics.Standard.BilledStorage.BilledStorageUsage 标准存储数据收费容量，单位是Byte。 Statistics.Standard.BilledStorage.RemainderChargeStorageUsage 标准存储数据补齐容量（时长补齐和大小补齐容量的和值），值为0。 Statistics.Standard.BilledStorage.RemainderChargeOfDuration 标准存储数据存储时长补齐容量，值为0。 Statistics.Standard.BilledStorage.RemainderChargeOfSize 标准存储数据大小补齐容量，值为0。 Statistics.Standardia.BilledStorage.BilledStorageUsage 低频访问存储数据收费容量，单位是Byte。 Statistics.Standardia.BilledStorage.RemainderChargeStorageUsage 低频访问存储数据补齐容量（时长补齐和大小补齐容量的和值），单位是Byte。 Statistics.Standardia.BilledStorage.RemainderChargeOfDuration 低频访问存储数据时长补齐容量，单位是Byte。 Statistics.Standardia.BilledStorage.RemainderChargeOfSize 低频访问存储数据大小补齐容量，单位是Byte。

名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 存储类型: ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 TimeZone 返回数据的时区，统一为UTC +0800。 InOutType 流量类型上行/下行: all：上行流量和下行流量。 inbound：上行流量。 outbound：下行流量。 InternetType 流量类型互联网/非互联网: all：互联网流量和非互联网流量。 internet：互联网流量。 noninternet：非互联网流量。 TrafficsType 流量类型直接/漫游： all：直接流量和漫游流量。 direct：直接流量。 roam：漫游流量。 NetType 网络类型精品网（CN2）/普通网（163）： all：返回精品网和普通网的流量。 highqualitynet：返回精品网的流量。 normalqualitynet：返回普通网的流量。 注意 仅香港节点返回此项。 Freq 返回数据的频率： by5min：每5分钟统计1次。 byHour：每1小时统计1次。 byDay：每天统计1次。 BucketName Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 RegionName 数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 Statistics.Date 返回结果对应的时间： 当请求参数Freq为by5min或byHour时，返回格式为yyyyMMdd HH:mm。 当请求参数Freq为byDay时，返回格式为yyyyMMdd。 Statistics.Data.InternetDirectInbound 标准存储数据的互联网直接上行流量，单位是Byte。 Statistics.Data.InternetRoamInbound 标准存储数据的互联网漫游上行流量，单位是Byte。 Statistics.Data.NonInternetDirectInbound 标准存储数据的非互联网直接上行流量，单位是Byte。 Statistics.Data.NonInternetRoamInbound 标准存储数据的非互联网漫游上行流量，单位是Byte。 Statistics.Data.InternetDirectOutbound 标准存储数据的互联网直接下行流量，单位是Byte。 Statistics.Data.InternetRoamOutbound 标准存储数据的互联网漫游下行流量，单位是Byte。 Statistics.Data.NonInternetDirectOutbound 标准存储数据的非互联网直接下行流量，单位是Byte。 Statistics.Data.NonInternetRoamOutbound 标准存储数据的非互联网漫游下行流量，单位是Byte。 Statistics.Standardia.InternetDirectInbound 低频访问存储数据的互联网直接上行流量，单位是Byte。 Statistics.Standardia.InternetRoamInbound 低频访问存储数据的互联网漫游上行流量，单位是Byte。 Statistics.Standardia.NonInternetDirectInbound 低频访问存储数据的非互联网直接上行流量，单位是Byte。 Statistics.Standardia.NonInternetRoamInbound 低频访问存储数据的非互联网漫游上行流量，单位是Byte。 Statistics.Standardia.InternetDirectOutbound 低频访问存储数据的互联网直接下行流量，单位是Byte。 Statistics.Standardia.InternetRoamOutbound 低频访问存储数据的互联网漫游下行流量，单位是Byte。 Statistics.Standardia.NonInternetDirectOutbound 低频访问存储数据的非互联网直接下行流量，单位是Byte。 Statistics.Standardia.NonInternetRoamOutbound 低频访问存储数据的非互联网漫游下行流量，单位是Byte。

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

本节主要介绍DeactivateMFADevice。 此操作用来终止使用指定的MFA设备，并与用户解除关联。 请求参数 名称 描述 是否必须 ::: Action DeactivateMFADevice。 是 Version 请求版本。 取值 ：20100508，默认值为20100508。 否 UserName 指定与虚拟MFA解除关联的IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 SerialNumber 唯一标识虚拟MFA设备的序列号。虚拟MFA设备序列号是设备的ARN。 类型 ：字符串 取值 ：字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、右斜线（/）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）、at符号（@）和冒号（:）。 是 请求示例 解绑IAM用户testuser的虚拟MFA设备。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190322T024559Z ContentType: application/octetstream ContentLength: 125 ActionDeactivateMFADevice&Version20100508&UserNametestuser&SerialNumberarn%3Actyun%3Aiam%3A%3A10rc2arpn6306%3Amfa%2Fmfa1

本节介绍了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主备复制机制中的正常行为，为偶现现象。

本节主要介绍Initial Multipart Upload 本接口初始化一个分片上传（Multipart Upload）操作，并返回一个上传ID。此ID用来将此次分片上传操作中上传的所有片段合并成一个文件。用户在执行每一次子上传请求（见Upload Part）时都必须指定该ID。用户也可以在表示整个分片上传完成的合并分片的请求中指定该ID。或者在用户放弃该分片上传操作时指定该ID。 请求语法 plaintext POST /ObjectName?uploads HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求头 名称 描述 是否必须 CacheControl 可以用来指定请求或响应中的缓存操作。 类型：字符串。 否 ContentDisposition 指定文件的描述性信息。 类型：字符串。 否 ContentEncoding 指定文件的描述性信息采用何种编码方式以及在获取被ContentType头字段引用的mediatype时采用何种解码方式。 类型：字符串。 否 ContentType 用来描述文件数据格式的标准MIME类型。 类型：字符串。 取值：MIME类型，默认值为application/octetstream。 否 Expires 文件不再被缓存的时间。GMT时间格式。 类型：字符串。 否 xamzmeta 任何以xamzmeta为前缀的头都被当作用户元数据，它和文件一起存储，当用户获取该文件的时候作为响应的一部分被返回。 类型：字符串。 否 xamzstorageclass 文件的存储类型，针对那些在成功完成分片上传后被创建的文件。 类型：字符串。 取值： STANDARD：标准存储。 STANDARDIA：低频访问存储。 默认值为STANDARD。 否 xctyundatalocation 文件的数据位置。 注意 香港节点不支持此参数。 类型：keyvalue形式 取值： 格式为：typeLocal,scheduleStrategyscheduleStrategy 或者typeSpecified,locationlocation ,scheduleStrategyscheduleStrategy type：指定数据存储位置的类型，取值为Local或者Specified。Local表示就近写入，Specified表示指定位置。如果type取值为Specified，则需要指定具体的数据位置location，location可以填写多个，以逗号分隔： 对于对象存储网络，可取值为：ChengDu、GuiYang、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 对于对象存储网络2，可取值为：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 scheduleStrategy：调度策略，取值为： Allowed：允许OOS自动调度数据存储位置 NotAllowed：不允许OOS自动调度数据存储位置。

本节主要介绍GetConcurrentConnection。 此操作用来查询用户的并发连接数。 请求参数 名称 描述 是否必须 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。 否

地区 OOS API Endpoint 郑州 ooshazz.ctyunapi.cn 沈阳 ooslnsy.ctyunapi.cn 四川成都 oossccd.ctyunapi.cn 乌鲁木齐 oosxjwlmq.ctyunapi.cn 甘肃兰州 oosgslz.ctyunapi.cn 山东青岛 oossdqd.ctyunapi.cn 贵州贵阳 oosgzgy.ctyunapi.cn 湖北武汉 ooshbwh.ctyunapi.cn 安徽芜湖 oosahwh.ctyunapi.cn 广东深圳 oosgdsz.ctyunapi.cn 江苏苏州 oosjssz.ctyunapi.cn 上海2 oossh2.ctyunapi.cn