华为云用户手册

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 GSL.00010004 Parameter error 参数错误 请检查请求的参数是否符合API文档的要求。 400 GSL.00011001 The SIM card does not exist or you do not have the permission to access the SIM card. sim卡不存在或没有SIM卡的访问权限！ 请检查ICCID以及该卡是否属于当前账号。 400 GSL.00011010 The number of iccids exceeds the upper limit. iccid 超过个数限制。 请减少ICCID 个数。 400 GSL.00011011 The iccid:[898604031020702XXXX] does not exist. iccid:[898604031020702XXXX] 不存在 请检查SIM卡ICCID。 400 GSL.00011016 Unsupported rate limit 不支持的限制速率 请检查限制速率是否符合API文档的要求。 400 GSL.00011063 Target carrier type that does not supported. 不支持切换的目标运营商 不支持切换的目标运营商 400 GSL.00012002 The package ID is invalid. The package does not exist. 传入的套餐ID无效，套餐不存在。 请检查套餐ID。 400 GSL.00012016 SIM card file does not exist, please cheak! SIM卡文件不存在，请检查！ 请输入有效的临时文件。 400 GSL.00013012 The SIM card corresponding to the order does not exist and cannot be renewed. Please check. 您操作的订单对应的SIM卡不存在，不能续费，请检查！ 请检查操作的订单是否存在该SIM卡。 400 GSL.00015028 Policy does not exist. 策略不存在！ 策略不存在！ 400 GSL.00015032 The preferred carrier cannot be the same as the least preferred carrier. 优先使用运营商和最不优先使用运营商不能相同！ 优先使用运营商和最不优先使用运营商不能相同！ 400 GSL.00015033 Either the weak signal switchover policy or the connection delay switchover policy must be set. 弱信号切换策略、连接延时切换策略必须设置其中一种！ 弱信号切换策略、连接延时切换策略必须设置其中一种！ 400 GSL.00015034 Policy name already exists. Please check. 策略名称已经存在，请检查！ 策略名称已经存在，请检查！ 400 GSL.00015035 You can create up to 50 policies. 登录用户最多可以创建50个策略。 登录用户最多可以创建50个策略。 400 GSL.00015039 Switch order has incorrect format. Please check. 切卡顺序格式错误，请检查！ 切卡顺序格式错误，请检查！ 400 GSL.00016051 The number of SIM cards list exceeds the limit （1-500）, please check! SIM卡数量必须介于1和500之间，请重新输入！ 请检查输入的SIM卡列表数量。 400 GSL.00016052 The number of tags list exceeds the limit （0-10）, please check! 标签数量必须介于0-10之间，请重新输入！！ 请检查输入的标签列表的数量。 400 GSL.00016053 Below {0} does not exist or no permission, please check! {0} : {1} 以下{0}不存在或没有操作权限，请重新输入！{0} : {1} 请检查相应的simCardId/tagId。 400 GSL.00016054 Below {0} duplicate, please check! {0} : {1} 以下{0}重复，请重新输入！{0} : {1} 请检查相应的simCardId/tagId。 400 GSL.00022001 Tag name illegal, please enter another name! 标签名称不合法，请检查！ 请重新输入标签。 400 GSL.00022002 Tag name already exists, please enter another name! 标签名称已存在，请重新输入！ 请重新输入标签。 400 GSL.00022003 A user can create up to 200 Tags. 登录用户最多可以创建200个标签。 请检查已有标签数量。 400 GSL.00022004 The login user does not have the permission to access the tag. 登录用户没有标签的访问权限。 请检查输入标签是否有效。 400 GSL.00027001 Invalid custom attribute name, please check! 自定义属性名称不合法，请检查！ 请输入其他自定义属性名称，仅支持中文、大小写英文、数字、或者特殊符号'-'和'_'。 400 GSL.00027002 Custom attribute name already exists, please enter another name! 自定义属性名称已存在，请重新输入！ 请输入其他自定义属性名称。 400 GSL.00027003 Custom attribute name cannot be same with SIM cards list column names, please enter another name! 自定义属性名称和SIM卡管理列字段重复，请重新输入！ 请检查输入的自定义属性名称，不能与已有SIM卡管理列字段重复。 400 GSL.00027004 A user can create up to 6 custom attributes. 登录用户最多可以创建6个自定义属性。 创建的自定义属性名不能超过6个。 400 GSL.00027005 The login user does not have the permission to access the custom attribute. 登录用户没有对应自定义属性的访问权限。 请检查输入的自定义属性是否有效。 403 GSL.00010001 The token carried in the request is invalid. 请求携带的token无效。 请检查携带的Token是否有效。 403 GSL.00010002 The user has been frozen and cannot invoke the API. 用户已被冻结，无法调用API。 请检查是否欠费。 403 GSL.00011004 Invalid bill cycle. Please check. 账期不合法，请检查！ 请检查账期格式和账期范围 403 GSL.00011005 The name already exists. Please enter another name. 名称已存在，请重新输入！ 名称已存在，请输入一个新的名称。 403 GSL.00011007 A query service has been delivered. Please try again later. 当前已有查询业务下发，请稍后重试！ 当前已有查询业务下发，请稍后重试！ 403 GSL.00011012 The order you are operating is in the unfinished state and cannot be renewed. Please check. 您操作的订单处于未完成状态，不能续费，请检查！ 未完成状态的订单不能续费。 403 GSL.00011015 The current SIM card does not support the operation. 当前SIM卡不支持操作 受运营商限制，不允许当前操作 403 GSL.00011019 The task_type of the export task is incorrect. 导出任务task_type不对！ 导出任务task_type不对！ 403 GSL.00012003 You do not have the permission to operate the test package. 您没有权限操作测试套餐。 您没有权限操作测试套餐。 403 GSL.00013011 The order you operate has unfinished renewal orders and cannot be renewed. Please check. 您操作的订单仍有未完成的续费订单，不能续费，请检查！ 操作的订单仍有未完成的续费订单，不能续费。 403 GSL.00014003 The traffic pool you want to operate does not exist. Please check. 您操作的流量池不存在，请检查！ 请检查所操作的流量池是否存在。 403 GSL.00016009 The card you operate has unfinished resumption orders. Do not perform the operation again. 您操作的卡仍有未完成的复机受理单，请勿重复操作。 您操作的卡仍有未完成的复机受理单，请等待受理完毕。 403 GSL.00016010 The card you operate has pending suspension orders. Do not perform the operation again. 您操作的卡仍有未完成的停机受理单，请勿重复操作。 您操作的卡仍有未完成的停机受理单，请等待受理完毕。 403 GSL.00016012 The card you operate is suspended due to excessive traffic and cannot be resumed. 您操作的卡，超流量停机，无法发起复机操作。 请购买流量叠加包或联系工作人员处理 403 GSL.00016014 Failed to activate the card because the card status is {0}. 您操作的卡状态已为{0}，无法发起激活操作。 当前卡不支持激活操作。 403 GSL.00016015 The card you operate has pending activation orders. Do not perform the operation again. 您操作的卡仍有未完成的激活受理单，请勿重复操作。 您操作的卡仍有未完成的激活受理单，请等待受理完毕。 403 GSL.00016016 Repeated operations are not allowed within 5 minutes. Please wait. 5分钟内不允许重复操作，请稍作等待。 5分钟内不允许重复操作，请稍作等待。 403 GSL.00016019 You cannot resume the card because the card is not in the disabled state. 您操作的卡状态非停用，无法发起复机操作。 只有停用状态的卡，才能发起复机操作。 403 GSL.00016020 The card you are operating is not in use and cannot initiate this operation 您操作的卡状态非在用，无法发起该操作。 只有在用状态的卡，才能发起停机操作。 500 GSL.00010003 The system is busy. Please try again later. 系统繁忙，请稍后重试！ 系统繁忙，请稍后重试！ 500 GSL.00010005 Service operation failed. 业务操作失败 业务操作失败，请稍后重试！ 500 GSL.00011009 File not exists. 上传文件不存在。 上传文件不存在。 500 GSL.00016005 Unsupported business handling order 不支持的业务受理单 请检查当前业务受理类型

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 URI-scheme：表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint：指定承载REST服务端点的服务器 域名 或IP，不同服务不同区域的Endpoint不同。例如 IAM 服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”， 全球SIM联接 服务在“华北-北京四”区域的Endpoint为“gsl.cn-north-4.myhuaweicloud.com”。 resource-path：资源路径，也即API访问路径。从具体API的URI模块获取，例如“查询SIM卡列表”API的resource-path为“/v1/sim-cards”。 query-string：查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要查询SIM卡列表，则需使用“华北-北京四”区域的Endpoint（gsl.cn-north-4.myhuaweicloud.com），并在查询SIM卡列表的URI部分找到resource-path（/v1/sim-cards），拼接起来如下所示。 https://gsl.cn-north-4.myhuaweicloud.com/v1/sim-cards 为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 GET：请求服务器返回指定资源。 PUT：请求服务器更新指定资源。 POST：请求服务器新增资源或执行特殊操作。 DELETE：请求服务器删除指定资源，如删除对象等。 在查询SIM卡列表的URI部分，您可以看到其请求方法为“GET”，则其请求为： GET https://gsl.cn-north-4.myhuaweicloud.com/v1/sim-cards

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type：消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 X-Auth-Token：用户Token，当使用Token方式认证时，必须填充该字段。用户Token也就是调用获取用户Token接口的响应值，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 对于查询SIM卡列表接口，由于需要认证，所以需要添加“Content-Type”和“X-Auth-Token”到头域，添加消息头后的请求如下所示。 GET https://gsl.cn-north-4.myhuaweicloud.com/v1/sim-cardsContent-Type: application/jsonX-Auth-Token：******

请求示例 使用sim卡标识按月查询SIM卡的日用量 POST https://{endpoint}/v1/sim-cards/batch-daily-flow{ "month" : "202408", "sim_card_ids" : [ 5702790861709056, 5702790861709057 ]} 使用容器ID按天查询SIM卡的日用量 POST https://{endpoint}/v1/sim-cards/batch-daily-flow{ "date" : 20240821, "iccids" : [ "898600xxxxxxxxxx", "898601xxxxxxxxxx" ]}

响应示例 状态码： 200 OK [ { "date" : "20240801", "sim_flow" : [ { "flow" : 0.98, "iccid" : "898600xxxxxxxxxx", "sim_card_id" : 5702790861709056 }, { "flow" : 1.0, "iccid" : "898601xxxxxxxxxx", "sim_card_id" : 5702790861709057 } ]}, { "date" : "20240802", "sim_flow" : [ { "flow" : 0.98, "iccid" : "898600xxxxxxxxxx", "sim_card_id" : 5702790861709056 }, { "flow" : 1.0, "iccid" : "898601xxxxxxxxxx", "sim_card_id" : 5702790861709057 } ]} ] 状态码： 400 Bad Request { "error_code" : "GSL.00010004", "error_msg" : "参数异常"} 状态码： 500 Internal Server Error { "error_code" : "GSL.00010003", "error_msg" : "系统繁忙，请稍后重试。"}

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 sim_card_ids 否 Array of longs SIM卡标识列表，最多支持传入100个SIM卡标识；不支持与容器ID列表（iccids）同时传递。 最大长度：100 iccids 否 Array of strings 容器ID列表，最多支持传入100个容器ID；不支持与SIM卡标识列表（sim_card_ids）同时传递。 最大长度：100 month 否 String 月份，格式YYYYMM；支持传入上月及当月月份，不支持与日期（date）同时传递。 最小长度：6 最大长度：6 date 否 String 日期，格式YYYYMMDD；支持传入上月第一天至当前时间前一天范围内的日期，不支持与月份（month）同时传递。 最小长度：8 最大长度：8

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 [数组元素] Array of SimCardFlowPerDayRsp objects OK 表3 SimCardFlowPerDayRsp 参数 参数类型 描述 date String 日期 sim_flow Array of SimCardFlowItem objects 卡日用量列表 表4 SimCardFlowItem 参数 参数类型 描述 sim_card_id Long sim卡标识 iccid String 容器ID flow Double 流量，单位MB 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 file_temp_id 否 Long 临时文件ID sim_card_ids 否 Array of longs SIM卡id列表，最多500.sim_card_ids与iccids不能同时为空，sim_card_ids参数为空则根据iccids参数处理 最小值：0 数组长度：0 - 500 iccids 否 Array of strings iccid列表，最多支持传入500个iccid。sim_card_ids与iccids不能同时为空，sim_card_ids参数为空则根据iccids参数处理 最小长度：19 最大长度：20 数组长度：0 - 500 tag_ids 否 Array of longs 绑定的标签id列表，最多10 最小值：0 数组长度：0 - 10

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 - Boolean OK 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512

请求示例 批量设置/取消设置标签。指定SIM卡ID“123456”和“234567”绑定标签“123”。 POST https://{endpoint}/v1/sim-tags/batch-set{ "sim_card_ids" : [ 123456, 234567 ], "tag_ids" : [ 123 ]} 批量设置/取消标签。当参数sim_card_ids不传或长度为0时，指定SIM卡iccid“898606xxxxxxxxxxxx”和“898601xxxxxxxxxxxx”绑定标签“123”。 POST https://{endpoint}/v1/sim-tags/batch-set{ "sim_card_ids" : [ ], "iccids" : [ "898606xxxxxxxxxxxx", "898601xxxxxxxxxxxx" ], "tag_ids" : [ 123 ]}

响应示例 状态码： 400 Parameter Invalid { "error_code" : "GSL.00010001", "error_msg" : "参数异常"} 状态码： 403 Forbidden { "error_code" : "GSL.00010002", "error_msg" : "请求的内容不存在"} 状态码： 500 Internal Server Error { "error_code" : "GSL.00010004", "error_msg" : "系统繁忙，请稍后重试。"}

响应示例 状态码： 400 Parameter Invalid 示例 1 { "error_code" : "GSL.00010001", "error_msg" : "请求携带的token无效。"} 示例 2 { "error_code" : "GSL.00012016", "error_msg" : "SIM卡文件不存在，请检查！"} 示例 3 { "error_code" : "GSL.000160051", "error_msg" : "SIM卡数量必须介于1和500之间，请重新输入！"} 示例 4 { "error_code" : "GSL.000160052", "error_msg" : "标签数量必须介于0-10之间，请重新输入！"} 示例 5 { "error_code" : "GSL.000160053", "error_msg" : "以下simCardId/tagId不存在或没有操作权限，请重新输入！simCardId/tagId : [-3333, 111, 656565465]"} 示例 6 { "error_code" : "GSL.000160054", "error_msg" : "以下simCardId/tagId重复，请重新输入！simCardId/tagId : [2, 3]"} 状态码： 500 Internal Server Error { "error_code" : "GSL.00010003", "error_msg" : "系统繁忙，请稍后重试。"}

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 - Boolean OK 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 403 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 policy_name 否 String 策略名称 最大长度：32 preferred_carrier 否 Integer 仅对SDK版本生效。最优选运营商,1:移动、2:电信、3:联通、4:上次使用的运营商 最小值：1 最大值：4 缺省值：3 least_preferred_carrier 否 Integer 仅对SDK版本生效。最不优选运营商,1:移动、2:电信、3:联通 最小值：1 最大值：3 缺省值：2 optimal_signal 否 Boolean 仅对SDK版本生效。最优信号选取策略是否开启,true:开启,false:不开启 缺省值：false auto_switch 否 Boolean 仅对SDK版本生效。自动切卡是否开启,true:开启,false:不开启 缺省值：false weak_signal_switch 否 Boolean 仅对SDK版本生效。弱信号切换策略是否开启,true:开启,false:不开启 connect_ip 否 String 仅对SDK版本生效。连接延时切换策略，连接延时时需要ping的ip地址 最大长度：64 version 是 Integer 版本枚举,1:SDK版，2:无SDK版 switch_order 否 String 仅对无SDK版本生效。切卡顺序，运营商以英文逗号分隔，1:移动，2:电信，3:联通 最大长度：10 blacklist 否 Integer 仅对无SDK版本生效。黑名单，只支持单个运营商，1:移动，2:电信，3:联通 最小值：0 最大值：3

请求示例 新增无SDK版本三网卡策略 POST https://{endpoint}/v1/network-switch-policies{ "policy_name" : "testaa", "version" : 2, "blacklist" : 1, "switch_order" : "3,1,2"} 新增SDK版本三网卡策略 POST https://{endpoint}/v1/network-switch-policies{ "policy_name" : "test_sdk", "version" : 1, "preferred_carrier" : 3, "least_preferred_carrier" : 2, "blacklist" : 0, "optimal_signal" : true, "auto_switch" : true, "weak_signal_switch" : true, "connect_ip" : "www.example.com"}

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 limit Long 每页的记录数 最小值：10 最大值：500 offset Long 页码，最小值是1，最大值为1000000。默认值是1. 最小值：1 最大值：1000000 count Long 记录总数 最小值：0 network_switch_policy_list Array of NetworkSwitchPolicyVO objects 网络切换策略实例列表 表3 NetworkSwitchPolicyVO 参数 参数类型 描述 id Long 策略主键id policy_name String 策略名称 最大长度：32 preferred_carrier Integer SDK版本特有字段。最优选运营商,1:移动、2:电信、3:联通、4:上次使用的运营商 最小值：1 最大值：4 缺省值：3 least_preferred_carrier Integer SDK版本特有字段。最不优选运营商,1:移动、2:电信、3:联通 最小值：1 最大值：3 缺省值：2 optimal_signal Boolean SDK版本特有字段。最优信号选取策略是否开启,true:开启,false:不开启 缺省值：false auto_switch Boolean SDK版本特有字段。自动切卡是否开启,true:开启,false:不开启 缺省值：false weak_signal_switch Boolean SDK版本特有字段。弱信号切换策略是否开启,true:开启,false:不开启 connect_ip String SDK版本特有字段。连接延时切换策略，连接延时时需要ping的ip地址 最大长度：64 create_time String 创建时间 modify_time String 修改时间 status Integer 状态,1:启用、0:禁用 type Integer 策略类型,0:系统策略,1:私有策略 used Boolean 策略是否已被使用过，即是否已被执行过策略切换，false：未被使用过，true：已被使用过 缺省值：false version Integer 版本枚举，1:SDK版 2:无SDK版 switch_order String 无SDK版本特有字段。切卡顺序，运营商以英文逗号分隔，1:移动，2:电信，3:联通 最大长度：10 blacklist Integer 无SDK版本特有字段。黑名单，只支持单个运营商，1:移动，2:电信，3:联通 最小值：0 最大值：3 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512

URI GET /v1/network-switch-policies 表1 Query参数 参数 是否必选 参数类型 描述 policy_name 否 String 策略名称 最大长度：32 version 否 Integer 三网卡版本信息，1:SDK版，2:无SDK版 最小值：1 最大值：2 limit 否 Long 分页查询时每页显示的记录数，默认值为10，取值范围为10-500的整数 最小值：10 最大值：500 缺省值：10 offset 否 Long 分页查询时的页码数，默认值为1，取值范围为1-1000000的整数 最小值：1 最大值：1000000 缺省值：1

响应示例 状态码： 200 OK 示例 1 { "limit" : 10, "offset" : 1, "count" : 1, "network_switch_policy_list" : [ { "id" : 1111111111111111, "policy_name" : "默认策略无SDK版", "preferred_carrier" : null, "least_preferred_carrier" : null, "optimal_signal" : false, "auto_switch" : false, "weak_signal_switch" : null, "connect_ip" : null, "create_time" : "2023-11-01T08:00:00.000+00:00", "modify_time" : "2023-11-01T08:00:00.000+00:00", "status" : 1, "type" : 0, "used" : true, "version" : 2, "switch_order" : "3,1,2", "blacklist" : 0 } ]} 示例 2 { "limit" : 10, "offset" : 1, "count" : 1, "network_switch_policy_list" : [ { "id" : 1000000000000000, "policy_name" : "默认策略", "preferred_carrier" : 3, "least_preferred_carrier" : 2, "optimal_signal" : false, "auto_switch" : true, "weak_signal_switch" : true, "connect_ip" : null, "create_time" : "2023-11-01T08:00:00.000+00:00", "modify_time" : "2023-11-01T08:00:00.000+00:00", "status" : 1, "type" : 0, "used" : true, "version" : 1, "switch_order" : null, "blacklist" : 0 } ]} 状态码： 400 Parameter Invalid { "code" : "GSL.00010004", "message" : "参数异常"} 状态码： 500 Internal Server Error { "code" : "GSL.00010003", "message" : "系统繁忙，请稍后重试。"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 work_order_id Long 业务受理单号 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求示例 切换目标网络为移动 POST https://{endpoint}/v1/sim-cards-multiply/{sim_card_id}/switch-network{ "carrier_type" : 1} 使用cid切换目标网络为移动 POST https://{endpoint}/v1/sim-cards-multiply/0/switch-network{ "carrier_type" : 1, "cid" : "88888888888881"}

响应示例 状态码： 200 OK { "work_order_id" : 1000001} 状态码： 400 Parameter Invalid { "error_code" : "GSL.00010004", "error_msg" : "参数异常"} 状态码： 500 Internal Server Error { "error_code" : "GSL.00010003", "error_msg" : "系统繁忙，请稍后重试。"}

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 - Boolean OK 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512

响应示例 状态码： 400 Bad Request 示例 1 { "error_code" : "GSL.00020004", "error_msg" : "参数异常"} 示例 2 { "error_code" : "GSL.00027005", "error_msg" : "登录用户没有自定义属性的访问权限。"} 状态码： 500 Internal Server Error { "error_code" : "GSL.00020003", "error_msg" : "系统繁忙，请稍后重试。"}

SIM卡管理 API 说明 查询SIM卡列表 查询公有云租户下的SIM卡列表。 SIM卡单卡停机 创建停机申请，返回业务受理单号。1~2个工作日完成停机操作。 SIM卡单卡复机 创建复机申请，返回业务受理单号。1~2个工作日完成复机操作。 月用量统计 查看历史月流量，可以查看最多6个月的月用量。 查询SIM卡详情 查询SIM卡的详情信息。 激活实体卡 创建激活实体卡申请，返回业务受理单号。1~2个工作日完成激活操作。 查询SIM卡实名认证信息 实时查询SIM卡实名认证信息，接口仅支持查询中国大陆运营商卡片的实名认证信息。 SIM卡申请断网恢复在用 SIM卡申请断网/恢复在用，仅支持电信卡调用接口。 SIM卡达量断网/取消达量断网 SIM卡达量断网/取消达量断网，仅支持中国电信的卡和中国联通、中国移动的组池卡调用接口。 SIM卡机卡重绑 支持固定机卡重绑（需要上传IMEI，将SIM卡绑定到指定IMEI的设备）和普通机卡重绑（会清除之前绑定的设备，将SIM卡绑定到正在使用的设备），接口仅支持中国电信卡和中国移动卡调用，中国电信卡单卡每月只允许重绑 2 次, 中国移动卡仅支持普通机卡重绑。 清除实名认证信息 清除实名认证信息，接口仅支持中国电信卡调用。 实体卡限速 实体卡限速接口，仅支持中国电信和中国联通实体卡调用接口。中国联通卡需要个人实名认证后才能使用限速功能。 批量查询SIM卡日用量 批量查询SIM卡日用量接口，支持按天或按月查询。SIM卡标识和容器ID只能选一个参数，天和月也只能选一个参数。

响应示例 状态码： 400 Bad Request 示例 1 { "error_code" : "GSL.00020004", "error_msg" : "参数异常"} 示例 2 { "error_code" : "GSL.00022004", "error_msg" : "登录用户没有标签的访问权限。"} 状态码： 500 Internal Server Error { "error_code" : "GSL.00020003", "error_msg" : "系统繁忙，请稍后重试。"}

响应示例 状态码： 400 Bad Request 示例 1 { "error_code" : "GSL.00020004", "error_msg" : "参数异常"} 示例 2 { "error_code" : "GSL.00022001", "error_msg" : "标签名称不合法，请检查！"} 示例 3 { "error_code" : "GSL.00022002", "error_msg" : "标签名称已存在，请重新输入！"} 示例 4 { "error_code" : "GSL.00022003", "error_msg" : "登录用户最多可以创建10000个标签。"} 示例 5 { "error_code" : "GSL.00022004", "error_msg" : "登录用户没有标签的访问权限。"} 状态码： 500 Internal Server Error { "error_code" : "GSL.00020003", "error_msg" : "系统繁忙，请稍后重试。"}

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 - Boolean OK 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 id Long 标签标识 tag_name String 标签名称 最大长度：100 status Integer 标签状态，0未使用，1使用中。 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512

URI GET /v1/attributes 表1 Query参数 参数 是否必选 参数类型 描述 cust_attr_name 否 String 自定义属性名称 最大长度：32 limit 否 Long 分页查询时每页显示的记录数，默认值为10，取值范围为10-500的整数 最小值：10 最大值：500 缺省值：10 offset 否 Long 分页查询时的页码数，默认值为1，取值范围为1-1000000的整数 最小值：1 最大值：1000000 缺省值：1 status 否 Integer 自定义属性状态：0 未启用，1 已启用。 最小值：0 最大值：1