文档简介：
GetReturnCode
此操作用来查询用户请求返回码次数。
l 请求参数
|
名称 |
描述 |
是否必填 |
|
Action |
GetReturnCode。 |
是 |
|
BeginDate |
指定查询返回码次数的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time。 取值：格式为yyyy-MM-dd。 |
是 |
|
EndDate |
指定查询返回码统计次数的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time。 取值：格式为yyyy-MM-dd。EndDate不能早于BeginDate。 说明： l Freq=by5min，EndDate与BeginDate的间隔不大于1天； l Freq=byHour，EndDate与BeginDate的间隔不大于7天； l Freq=byDay，EndDate与BeginDate的间隔不大于30天。 |
是 |
|
StorageClass |
指定查询的存储类型。 类型：Enum 取值: l ALL：所有存储类型； l STANDARD：标准存储； l STANDARD_IA：低频访问存储。 默认值为STANDARD。 |
否 |
|
Bucket |
指定查询返回码的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有的Bucket的请求返回码次数之和。 类型：字符串。 取值：3~63位字符串，只能由小写字母、数字、短横线（-）和点（.）组成。 |
否 |
|
Region |
指定查询返回码的数据位置。如果不指定数据位置名称，则查询账户名下所有数据位置的请求返回码次数之和。 类型：字符串。 取值：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、LaSa、WuHu、WuHan、ShenZhen、SH2、SuZhou。 |
否 |
|
InternetType |
指定返回码的网络类型-互联网/非互联网。 类型：字符串。 取值： l all：指定返回互联网返回码和非互联网返回码； l internet：指定返回互联网的返回码； l noninternet：指定返回非互联网的返回码。 默认值为all。 |
否 |
|
RequestsType |
指定返回返回码次数的请求类型，可以指定一个或多个返回码的请求类型，当申请多个RequestsType时，用“+”将类型分开。 类型：字符串。 取值： l all：指定返回所有请求类型的返回码次数； l get：指定返回get类型的返回码次数； l head：指定返回head类型的返回码次数； l put：指定返回put类型的返回码次数； l post：指定返回post类型的返回码次数； l delete：指定返回delete类型的返回码次数； l others：指定返回除上述外的其他类型的返回码次数。 默认值为all。 |
否 |
|
ResponseType |
指定返回的返回码类型，可以指定一个或多个返回码的请求类型，当申请多个ResponseType时，用“+”将类型分开。 类型：字符串。 取值： l all：指定返回所有类型的返回码次数。 l Response200； l Response204：仅delete支持Response204； l Response206：仅get和head支持Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 默认值为all。 |
否 |
|
Freq |
指定返回统计数据的采样粒度。 类型：Enum。 取值： l by5min：统计数据的采样粒度为5分钟； l byHour：统计数据的采样粒度为1小时； l byDay：统计数据的采样粒度为1天。 默认值为byHour。 |
否 |
l 响应结果
|
名称 |
描述 |
|
Account |
发出请求的账户名。 |
|
UserName |
发出请求的用户名。如果根用户发送的该请求，则UserName为root。 |
|
StorageClass |
指定查询的存储类型： l ALL：所有存储类型； l STANDARD：标准存储； l STANDARD_IA：低频访问存储。 |
|
TimeZone |
返回数据的时区，统一为UTC +0800。 |
|
InternetType |
返回的返回码类型-互联网/非互联网: l all:互联网返回码和非互联网返回码； l internet：互联网返回码； l noninternet：非互联网返回码。 |
|
RequestsType |
返回码次数的请求类型，当返回多个时，用分隔符“+”连接： l all：所有请求类型的返回码次数； l get：get类型的返回码次数； l head：head类型的返回码次数； l put：put类型的返回码次数； l post：post类型的返回码次数； l delete：delete类型的返回码次数； l others：除上述外的其他类型的返回码次数。 |
|
ResponseType |
返回的返回码类型，当返回多个时，用分隔符“+”连接： l all：所有类型的返回码。 l Response200； l Response204； l Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Freq |
返回统计数据的采样粒度： l by5min：统计数据的采样粒度为5分钟； l byHour：统计数据的采样粒度为1小时； l byDay：统计数据的采样粒度为1天。 |
|
BucketName |
请求的Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 |
|
RegionName |
数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 |
|
Statistics.Date |
返回结果对应的时间： l 当请求参数Freq为by5min或byHour时，返回格式为yyyy-MM-dd HH:mm； l 当请求参数Freq为byDay时，返回格式为yyyy-MM-dd。 |
|
Statistics.Data.Internet.Get |
标准存储数据互联网Get类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.Internet.Head |
标准存储数据互联网Head类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.Internet.Put |
标准存储数据互联网Put类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.Internet.Post |
标准存储数据互联网Post类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.Internet.Delete |
标准存储数据互联网Delete类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response204； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.Internet.Others |
标准存储数据互联网Others类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.NonInternet.Get |
标准存储数据非互联网Get类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.NonInternet.Head |
标准存储数据非互联网Head类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.NonInternet.Put |
标准存储数据非互联网Put类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.NonInternet.Post |
标准存储数据非互联网Post类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.NonInternet.Delete |
标准存储数据非互联网Delete类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response204； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Data.NonInternet.Others |
标准存储数据非互联网Others类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.Internet.Get |
低频访问存储数据互联网Get类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.Internet.Head |
低频访问存储数据互联网Head类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.Internet.Put |
低频访问存储数据互联网Put类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.Internet.Post |
低频访问存储数据互联网Post类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Res ponse503。 |
|
Statistics.Standard_ia.Internet.Delete |
低频访问存储数据互联网Delete类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response204； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.Internet.Others |
低频访问存储数据互联网Others类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.NonInternet.Get |
低频访问存储数据非互联网Get类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.NonInternet.Head |
低频访问存储数据非互联网Head类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response206； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.NonInternet.Put |
低频访问存储数据非互联网Put类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.NonInternet.Post |
低频访问存储数据非互联网Post类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.NonInternet.Delete |
低频访问存储数据非互联网Delete类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response204； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
|
Statistics.Standard_ia.NonInternet.Others |
低频访问存储数据非互联网Others类型请求码的次数。可以具体到下列请求类的次数： l Response200； l Response403； l Response404； l Response4xx； l Response500； l Response503。 |
l 请求示例
按天（byDay）查询Bucket为lt-bucket1、数据位置为ZhengZhou、2019-10-15至2019-10-16标准存储数据的返回码次数。
|
GET /?Action=GetReturnCode&BeginDate=2019-10-15&EndDate=2019-10-16&StorageClass=STANDARD&Bucket=lt-bucket1&Freq=byDay&Region=ZhengZhou&RequestsType=get%2Bput&ResponseType=Response200 HTTP/1.1 Date: Wed, 16 Oct 2019 07:03:54 GMT Authorization: AWS 7799e793ce4624ee7e5a:BnaA3pDsSImzdnPtN4eN2VcKh8g= Host: oos-cn-mg.ctyunapi.cn |
l 返回示例
|
HTTP/1.1 200 OK Date: Wed, 16 Oct 2019 07:03:54 GMT x-amz-request-id: a79028c963e4d3a Content-Length: 1114 Content-Type: application/xml; charset=utf-8 Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?> <GetReturnCodeReponse> <Account>test@oos.cn</Account> <UserName>user_test1</UserName> <StorageClass>STANDARD</StorageClass> <TimeZone>UTC +0800</TimeZone> <InternetType>all</InternetType> <RequestsType>get+put</RequestsType> <ResponseType>Response200 </ResponseType> <Freq>byDay</Freq> <BucketName>lt-bucket1</BucketName> <RegionName>ZhengZhou</RegionName> <Statistics> <Date>2019-10-15</Date> <Data> <Internet> <Get> <Response200>1</Response200> </Get> <Put> <Response200>11</Response200> </Put> </Internet> <NonInternet> <Get> <Response200>61</Response200> </Get> <Put> <Response200>71</Response200> </Put> </NonInternet> </Data> </Statistics> <Statistics> ... </Statistics> </GetReturnCodeReponse> |
