阿里云首页

更新绑定关系接口

调用UpdateSubscription更新绑定关系,通过本文您可以了解调用更新绑定关系接口的操作流程。

前提条件

  1. 注册阿里云账号并完成企业实名认证。具体操作请参见注册阿里云账号企业实名认证

  2. 获取阿里云访问密钥。具体操作,请参见获取AccessKey

下载对应的SDK和DEMO样例程序编写代码

请到SDK&DEMO下载页面获取相应的SDK和DEMO程序,参照代码样例进行接口开发和调试。

入参列表

参数名称

参数类型

必填与否

样例取值

参数说明

PoolKey

String

必须

FC12345

号池Key。

SubsId

String

必须

12345

创建绑定关系API接口所返回的订购关系ID。

PhoneNoX

String

必须

170****0000

创建绑定关系API接口所返回的X号码。

OperateType

String

必须

updateNoA

操作类型。

  • updateNoA:修改A号码。

  • updateNoB:修改B号码。

  • updateExpire:更新绑定关系有效期

  • updateCallRestrict:更新单通呼叫限制。

    • CONTROL_AX_DISABLE:控制A侧无法呼叫X。

    • CONTROL_BX_DISABLE:控制B侧无法呼叫X。

    • CONTROL_CLEAR_DISABLE:清除呼叫控制限制。

PhoneNoA

String

可选

170****0000

将该绑定关系中的A号码替换成所传递的值,OperateType=updateNoA时必填。

PhoneNoB

String

可选

170****0000

将该绑定关系中的B号码替换成所传递的值,OperateType=updateNoB时必填。

Expiration

Date

可选

2017-09-05 12:00:00

将该绑定关系的过期时间替换成所传递的值,OperateType=updateExpire时必填。

出参列表

出参名称

出参类型

样例取值

参数说明

RequestId

String

8906582E-6722

请求ID。

Code

String

OK

状态码。返回OK代表请求成功,其他错误码详见错误码列表。

Message

String

请求成功

状态码的描述。

技术对接步骤

  1. 下载SDK工具包。SDK&DEMO下载地址,请参见SDK&DEMO下载

  2. 编写样例程序。

     /**
         * 更新绑定关系
         *
         * @return stdClass
         * @throws ClientException
         */
        public static function updateSubscription() {
            //组装请求对象
            $request = new UpdateSubscriptionRequest();
            //必填:绑定关系对应的号池Key
            $request->setPoolKey("FC12345");
            //必填: 创建绑定关系API接口所返回的订购关系ID
            $request->setSubsId("123456");
            //必填: 创建绑定关系API接口所返回的X号码
            $request->setPhoneNoX("170000000");
            // todo 以下操作三选一, 目前支持三种类型: updateNoA(修改A号码)、updateNoB(修改B号码)、updateExpire(更新绑定关系有效期)
            // -------------------------------------------------------------------
            // 1. 修改A号码示例:
            // 必填: 操作类型
            $request->setOperateType("updateNoA");
            // OperateType为updateNoA时必选: 需要修改的A号码
            $request->setPhoneNoA("150000000");
            // -------------------------------------------------------------------
            // 2. 修改B号码示例:
            // 必填: 操作类型
            // $request->setOperateType("updateNoB");
            // OperateType为updateNoB时必选: 需要修改的B号码
            // $request->setPhoneNoB("150000000");
            // -------------------------------------------------------------------
            // 3. 更新绑定关系有效期示例:
            // 必填: 操作类型
            // $request->setOperateType("updateExpire");
            // OperateType为updateExpire时必选: 需要修改的绑定关系有效期
            // $request->setExpiration("2017-09-05 12:00:00");
            // -------------------------------------------------------------------
            // 此处可能会抛出异常,注意catch
            $response = static::getAcsClient()->getAcsResponse($request);
            return $response;
        }
                            

错误码列表

Code

描述

OK

请求成功。

isp.RAM_PERMISSION_DENY

RAM权限DENY。

isv.OUT_OF_SERVICE

业务停机。

isv.PRODUCT_UN_SUBSCRIPT

未开通云通信产品的阿里云客户。

isv.PRODUCT_UNSUBSCRIBE

产品未开通。

isv.ACCOUNT_NOT_EXISTS

账户不存在。

isv.ACCOUNT_ABNORMAL

账户异常。

isp.SYSTEM_ERROR

系统错误。

isp.UNKNOWN_ERR_CODE

运营商未知错误。

isv.PARTNER_NOT_EXIST

未知合作伙伴。

isv.NO_NOT_EXIST

号码不存在。

isv.ILLEGAL_ARGUMENT

参数非法。

isp.DAO_EXCEPTION

数据库异常。

isv.NO_AVAILABLE_NUMBER

无可用号码。

isp.VENDOR_UNAVAILABLE

运营商降级。

isv.FLOW_LIMIT

业务流控。

isv.PARTNER_IS_CLOSED

partner被关停。

isv.FORBIDDEN_ACTION

无权操作。

isv.NO_USED_BY_OTHERS

码被其他业务方占用。

isv.VENDOR_BIND_FAILED

运营商绑定失败。

isv.EXPIRE_DATE_ILLEGAL

过期时间非法。

isv.MOBILE_NUMBER_ILLEGAL

号码格式非法。

isv.BIND_CONFLICT

绑定冲突。

首页 更新绑定关系接口