1、分布式關系型數(shù)據(jù)庫 DRDS開放API分布式關系型數(shù)據(jù)庫 DRDS/開放API PAGE 33開放API術語表術語全稱中文說明DRDSDistribute Relational Database Service分布式關系型數(shù)據(jù)庫服務基于rds，提供分庫分表、讀寫分離、平滑擴容、全局唯一id等服務DrdsInstanceDistribute Relational Database Instance分布式數(shù)據(jù)庫實例一組獨立占用物理資源的服務進程，可以有不同的規(guī)格，規(guī)格會決定該實例的性能（cpu數(shù)、內(nèi)存、qps/tps等）DrdsInstanceIdDistribute Relational Dat

2、abase Instance ID分布式數(shù)據(jù)庫實例名實例名可標識一個實例的名稱，全局唯一DrdsDBDistribute Relational Database分布式數(shù)據(jù)庫DrdsDB是在一個實例下創(chuàng)建的邏輯單元，一個實例可以創(chuàng)建多個數(shù)據(jù)庫，在實例內(nèi)數(shù)據(jù)庫命名唯一，所有數(shù)據(jù)庫都會共享該實例的資源DrdsDBNameDistribute Relational Database Name分布式數(shù)據(jù)庫名標識每個分布式DB的名稱，在一個實例范圍內(nèi)，數(shù)據(jù)庫名惟一DrdsDBAccountDistribute Relational Database Account分布式數(shù)據(jù)庫帳號帳號是標識數(shù)據(jù)庫的訪問權限

3、，目前一個數(shù)據(jù)庫對應一個帳號，一個帳號關聯(lián)一個數(shù)據(jù)庫請求結構服務地址DRDS API的服務接入地址為：。通信協(xié)議支持通過HTTP或HTTPS通道進行請求通信。為了獲得更高的安全性，推薦您使用HTTPS通道發(fā)送請求。請求方法支持HTTP GET方法發(fā)送請求，這種方式下請求參數(shù)需要包含在請求的URL中。請求參數(shù)每個請求都需要指定要執(zhí)行的操作，即Action參數(shù)，以及每個操作都需要包含的公共請求參數(shù)和指定操作所特 有的請求參數(shù)公共參數(shù)公共請求參數(shù)公共請求參數(shù)是指每個接口都需要使用到的請求參數(shù)名稱類型是否必須描述FormatString否返回值的類型，支持JSON與XMLActionString是調(diào)用

4、接口名稱VersionString是API版本號，為日期形式：YYYY-MM-DD，當前版本對應為2015-04-13AccessKeyIdString是阿里云頒發(fā)給用戶的訪問服務所用的密鑰IDSignatureMeth odstring是簽名方式，目前支 持 HMAC- SHA1TimestampString是請求的時間戳。日期格式按照ISO8601標準表示，并需要使用UTC時間。格式為：YYYY-MM-DDThh:mm:ssZ; 例如，2013-08- 15T12:00:00Z（為北京時間2013年1月10日20點0分0秒）SignatureVersio nString是簽名算法版本，目前

5、版本是1.0SignatureNonc eString是唯一隨機數(shù)，用于防止網(wǎng)絡重放攻擊。用戶在不同請求間要使用不同的隨機數(shù)值RegionIdString是DRDS所在的地域SignatureString是簽名結果串，關于簽名的計算方法，請參見簽名機制。公共返回參數(shù)用戶發(fā)送的每次接口調(diào)用請求，無論成功與否，系統(tǒng)都會返回一個唯一識別碼RequestId給用戶 示例 4C467B38-3910-447D-87BC-AC049166F216 返回結果調(diào)用API服務后返回數(shù)據(jù)采用統(tǒng)一格式，返回的HTTP狀態(tài)碼為2xx，代表調(diào)用成功；返回4xx或5xx的HTTP狀態(tài) 碼代表調(diào)用失敗。調(diào)用成功返回的數(shù)據(jù)格

6、式主要有XML和JSON兩種，外部系統(tǒng)可以在請求時傳入?yún)?shù)來制定 返回的數(shù)據(jù)格式，默認為XML格式。本文檔中的返回示例為了便于用戶查看，做了格式化處理，實際返回結果 是沒有進行換行、縮進等處理的成功結果結果包括請求是否成功信息和具體的業(yè)務數(shù)據(jù)。XML 4C467B38-3910-447D-87BC-AC049166F216 JSON： RequestId : 4C467B38-3910-447D-87BC-AC049166F216 , /* 返回結果數(shù)據(jù) */ 錯誤結果調(diào)用接口出錯后，將不會返回結果數(shù)據(jù)。調(diào)用方可根據(jù)附表 錯誤代碼表 來定位錯誤原因。當調(diào)用出錯時，HTTP請求返回一個4xx或5

7、xx的HTTP狀態(tài)碼。返回的消息體中是具體的錯誤代碼及錯誤信息。 另外還包含一個全局唯一的請求ID：RequestId和一個您該次請求訪問的站點ID：HostId。在調(diào)用方找不到錯 誤原因，可以聯(lián)系阿里云客服，并提供該HostId和RequestId，以便我們盡快幫您解決問題。XML 8906582E-6722-409A- A6C4-0E7863B733A5 UnsupportedOperation The specified action is not supported. JSON RequestId : 7463B73D-35CC-4D19-A010-6B8D65D242EF , Hos

8、tId : , Code : UnsupportedOperation , Message : The specified action is not supported. 簽名機制DRDS服務會對每個訪問的請求進行身份驗證，所以無論使用HTTP還是HTTPS協(xié)議提交請求，都需要在請求中 包含簽名（Signature）信息。DRDS通過使用Access Key ID和Access Key Secret進行對稱加密的方法來驗證請求的發(fā)送者身份。Access Key ID和Access Key Secret由阿里云官方頒發(fā)給訪問者（可以通過阿里云官方網(wǎng)站申請和管理），其中Access Key ID

9、用于標識訪問者的身份；Access Key Secret是用于加密簽名字符串和服務器端驗證簽名字符串的密鑰，必須嚴格保密，只有阿里云和用戶知道。 用戶在訪問時，按照下面的方法對請求進行簽名處理：使用請求參數(shù)構造規(guī)范化的請求字符串（Canonicalized Query String）a) 按照參數(shù)名稱的字典順序對請求中所有的請求參數(shù)（包括文檔中描述的公共請求參數(shù)和給定了的請求接口的自定義參數(shù)，但不能包括公共請求參數(shù)中提到Signature參數(shù)本身）進行排序。注：當使用GET方法提交請求 時，這些參數(shù)就是請求URI中的參數(shù)部分（即URI中?之后由&連接的部分）。b) 對每個請求參數(shù)的名稱和值進行

10、編碼。名稱和值要使用UTF-8字符集進行URL編碼，URL編碼的編碼規(guī)則是： i. 對于字符 A-Z、a-z、0-9以及字符-、_、.、不編碼； ii. 對于其他字符編碼成%XY的格式，其中XY是字符對應ASCII碼的16進制表示。比如英文的雙引號（）對應的編碼就是%22 iii. 對于擴展的UTF-8字符，編碼成%XY%ZA的格式； iv. 需要說明的是英文空格（ ）要被編碼是%20，而不是加號（+）。 注：一般支持URL編碼的庫（比如Java中的.URLEncoder）都是按照application/x-www-form-urlencoded的MIME類型的規(guī)則進行編碼的。實現(xiàn)時可以直接使

11、用這 類方式進行編碼，把編碼后的字符串中加號（+）替換成%20、星號（*）替換成%2A、%7E替換回 波浪號（），即可得到上述規(guī)則描述的編碼字符串。c) 對編碼后的參數(shù)名稱和值使用英文等號（=）進行連接。d) 再把英文等號連接得到的字符串按參數(shù)名稱的字典順序依次使用&符號連接，即得到規(guī)范化請求字符串。使用上一步構造的規(guī)范化字符串按照下面的規(guī)則構造用于計算簽名的字符串： StringToSign = HTTPMethod + & + percentEncode (/) + & + percentEncode ( CanonicalizedQueryString ) 其中HTTPMethod是提交

12、請求用的HTTP方法，比GET。percentEncode(/)是按照1.b中描述的 URL編碼規(guī)則對字符/進行編碼得到的值，即%2F。percentEncode(CanonicalizedQueryString)是對第1步中構造的規(guī)范化請求字符串按1.b中描述的URL編碼規(guī)則編碼后得到的字符串。按照RFC2104的定義，使用上面的用于簽名的字符串計算簽名HMAC值。注意：計算簽名時使用的Key就是用戶持有的Access Key Secret并加上一個&字符(ASCII:38)，使用的哈希算法是SHA1。按照Base64編碼規(guī)則把上面的HMAC值編碼成字符串，即得到簽名值（Signature）

13、。將得到的簽名值作為Signature參數(shù)添加到請求參數(shù)中，即完成對請求簽名的過程。注意：得到的簽名值在作為最后的請求參數(shù)值提交給DRDS服務器的時候，要和其他參數(shù)一樣，按照RFC3986的規(guī)則進行URL編碼）。以DescribeDrdsInstances為例，簽名前的請求參數(shù)字符串為： AccessKeyId = testid & Action = DescribeDrdsInstances & Format = XML & RegionId = cn - hangzhou & SignatureMethod = HMAC - SHA1 & SignatureNonce = ae5bdbeb

14、 - 9b44 - 40a1 - 8bb4 - b40784bff686 & SignatureVersion = 1.0 & Timestamp = 2016 - 01 - 20T14 % 3A26 % 3A15Z & Version = 2015 - 04 - 13 對這個字符串進行編碼，那么StringToSign就是： GET &% 2F & AccessKeyId % 3Dtestid % 26Action % 3DDescribeDrdsInstances % 26Format % 3DXML % 26RegionId % 3Dcn - hangzhou % 26Signature

15、Method % 3DHMAC - SHA1 % 26SignatureNonce % 3Dae5bdbeb - 9b44 - 40a1 - 8bb4 - b40784bff686 % 26SignatureVersion % 3D1.0 % 26Timestamp % 3D2016 - 01 - 20T14 % 253A26 % 253A15Z % 26Version % 3D2015 - 04 - 13 假如使用的Access Key Id是testid，Access Key Secret是testsecret，用于計算HMAC的Key就是testsecret&，則計算得到的簽名值是： h

16、 / ka / jNO + WZv8Tqgo4a75sp6eTs = 簽名后的請求URL為（注意增加了Signature參數(shù)）： HYPERLINK /?AccessKeyId=testid&Action=DescribeDrdsInstances&Format=XML&RegionId=cn- http : /?AccessKeyId=testid&Action=DescribeDrdsInstances&Format=XML&RegionId=cn- hangzhou&SignatureMethod=HMAC-SHA1&SignatureNonce=ae5bdbeb-9b44-40a1-8

17、bb4- b40784bff686&SignatureVersion=1.0&Timestamp=2016-01-20T14%3A26%3A15Z&Version=2015-04- 13&Signature=h%2Fka%2FjNO%2BWZv8Tqgo4a75sp6eTs%3D 調(diào)用接口DescribeDrdsInstances的Java示例如下： public static void drdsOpenAPI () throws NoSuchAlgorithmException , InvalidKeyException , IOException /ak與sk String accessK

18、ey = testid ; String accessSecret = testsecret ; /公共參數(shù) Map parameters = new TreeMap (); parameters . put ( Format , JSON ); parameters . put ( Action , DescribeDrdsInstances ); /調(diào)用DescribeDrdsInstances接口 parameters . put ( Version , 2015-04-13 ); parameters . put ( AccessKeyId , accessKey ); paramet

19、ers . put ( SignatureMethod , HMAC-SHA1 ); parameters . put ( Timestamp , getISO8601Time (); parameters . put ( SignatureVersion , 1.0 ); parameters . put ( SignatureNonce , UUID . randomUUID (). toString (); parameters . put ( RegionId , cn-hangzhou ); StringBuilder paramStr = new StringBuilder ();

20、 /拼接請求參數(shù) for ( Map . Entry entry : parameters . entrySet () paramStr . append ( percentEncode ( entry . getKey (). append ( = ). append ( percentEncode ( entry . getValue (). append ( & ); paramStr . deleteCharAt ( paramStr . length ()- 1 ); /計算簽名 StringBuilder stringToSign = new StringBuilder (); s

21、tringToSign . append ( GET ). append ( & ). append ( percentEncode ( / ) . append ( & ). append ( percentEncode ( paramStr . toString (); Mac mac = Mac . getInstance ( HmacSHA1 ); mac . init ( new SecretKeySpec ( accessSecret + & ). getBytes ( UTF-8 ), HmacSHA1 ); byte signData = mac . doFinal ( str

22、ingToSign . toString (). getBytes ( UTF-8 ); String signStr = Base64Helper . encode ( signData ); /拼接URL String requestUrl = HYPERLINK / /? + paramStr . toString () + &Signature= + percentEncode ( signStr ); /準備發(fā)送HTTP請求 URL url = new URL ( requestUrl ); HttpURLConnection httpConn = ( HttpURLConnecti

23、on ) url . openConnection (); httpConn . setRequestMethod ( GET ); httpConn . setDoOutput ( true ); httpConn . setDoInput ( true ); httpConn . setUseCaches ( false ); httpConn . connect (); InputStream content = httpConn . getInputStream (); ByteArrayOutputStream outputStream = new ByteArrayOutputSt

24、ream (); byte buff = new byte 1024 ; while ( true ) final int read = content . read ( buff ); if ( read = - 1 ) break ; outputStream . write ( buff , 0 , read ); System . out . println ( new String ( outputStream . toByteArray (); public static String percentEncode ( String value ) throws Unsupporte

25、dEncodingException return value != null ? URLEncoder . encode ( value , UTF-8 ). replace ( + , %20 ) . replace ( * , %2A ). replace ( %7E , ) : null ; static String getISO8601Time () SimpleDateFormat df = new SimpleDateFormat ( yyyy-MM-ddTHH:mm:ssZ ); df . setTimeZone ( new SimpleTimeZone ( 0 , GMT

26、); return df . format ( new Date (); 基于RAM的授權訪問(待發(fā)布)阿里云帳號和權限體系阿里云是三級帳號模型，最頂級是BID，整個阿里云有多個bid，每個業(yè)務都是一個bid。每個bid下面又有多個客戶帳號（主帳號），注意一個客戶帳號只能屬于一個BID。每個主帳號下又包含多個子帳號，注意一個子帳號 也只能屬于一個主帳號。阿里云的各種資源，包括rds實例等，都掛在主帳號下，子帳號不能擁有資源，只能通 過授權來訪問父帳號（客戶帳號）的資源。DRDS權限模型RAM的權限模型是resource和action，一個resouce上有多個action。Action就對應一

27、個具體的open api。客戶在ram上主動操作將資源的action授權給他的子帳號，然后就可以通過子帳號調(diào)用授予過權限的open api。DRDS可以在RAM中進行授權的資源類型僅一種：DrdsInstanceResource描述說明acs:drds:$regionid:$ownerid:i nstance/$drdsinstanceid指定的DrdsInstanceacs:drds:$regionid:$ownerid:i nstance/*指定region和指定ownerId的所有drds實例可以授權的action有以下這些：CreateDrdsInstance、DescribeDrds

28、Instance、ModifyDrdsInstanceDescription、DescribeDrdsInstances、RemoveDrdsInstance、CeateDrdsDB、DescribeDrdsDB、DeleteDrdsDB、ModifyDrdsDBPasswd、DescribeDrdsDBs、ModifyDrdsIpWhiteList、DescribeDrdsDBIpWhiteList、ModifyRdsReadWeight、DeleteFailedDrdsDB、DescribeShardDBs、DescribeRdsList、ModifyFullTableScan、Creat

29、eReadOnlyAccount、DescribeReadOnlyAccount、ModifyReadOnlyAccount、RemoveReadOnlyAccountAction描述說明drds:DescribeDrdsInstance對應查詢實例操作drds:ModifyDrdsInstanceDes cription對應修改實例描述操作drds:DescribeDrdsInstances對應查詢實例列表操作drds:*對應drds所有操作OpenAPI概述OPEN_API-DRDS實例提供CreateDrdsInstance、DescribeDrdsInstance、ModifyDrds

30、InstanceDescription、DescribeDrdsInstances, RemoveDrdsInstance。OPEN_API-DRDS數(shù)據(jù)庫 class=reference-linkOPEN_API-DRDS數(shù)據(jù)庫提供CeateDrdsDB、DescribeDrdsDB、DeleteDrdsDB、ModifyDrdsDBPasswd、DescribeDrdsDBs、ModifyDrdsIpWhiteList、DescribeDrdsDBIpWhiteList、ModifyRdsReadWeight、DeleteFailedDrdsDB、DescribeShardDBs、Desc

31、ribeRdsList、ModifyFullTableScan、CreateReadOnlyAccount、DescribeReadOnlyAccount、ModifyReadOnlyAccount、RemoveReadOnlyAccount。OpenAPI SDKDRDS OpenAPI的Java SDK已發(fā)布到Maven倉庫，對于maven工程可以直接依賴maven倉庫 com.aliyun aliyun-java-sdk-drds 2.0.1 該SDK依賴阿里云aliyun-java-sdk-core，添加阿里云API核心包依賴即可 com.aliyun aliyun-java-sdk-

32、core 2.2.1 如果需要其他語言的SDK正在緊急開發(fā)中.Drds實例相關接口 class=reference-linkDrds實例相關接口創(chuàng)建drds實例 class=reference-link創(chuàng)建drds實例參數(shù)名類型是否必須描述ActionString是系統(tǒng)規(guī)定參數(shù)，取值：CreateDrdsInstanc eDescriptionString是DRDS實例的描述。2-128個字符RegionIdString是區(qū)域TypeString是實例類型， 實例類型0 -共享實例 1-專享實例，此外該參數(shù)也可以傳遞PRIVATE和PUBLIC分別表示專享功能描述：創(chuàng)建drds實例請求參數(shù)：實

33、例和共享實例ZoneIdString是可用區(qū)，一個可用區(qū)屬于某個區(qū)域，如可用區(qū)杭 州 A（cn- hangzhou-a）屬于區(qū)域 杭 州 （cn- hangzhou）QuantityInteger是購買數(shù)量SpecificationString是實例規(guī)格，Drds實例分為四種規(guī)格, 詳見下表PayTypeString是付費類型，暫時只支持drdsPostVpcIdString否虛擬專用網(wǎng)絡ID，創(chuàng)建VPC網(wǎng)絡類型的Drds時必須VswitchIdString否虛擬交換機ID，創(chuàng)建VPC網(wǎng)絡類型的Drds時必須實例規(guī)格規(guī)格內(nèi)存與CPUdrds.small4核4Gdrds.standard8核8G

34、drds.large16核16Gdrds.xlarge32核32G返回值：參數(shù)名類型描述公共返回值DrdsInstanceIdList創(chuàng)建出來的實例標識OrderIdString訂單號錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼服務未開通ServiceUnabledrds service is not enable for you400參數(shù)錯誤ParameterErrorParameter error400權限錯誤ActionUnauthorizedThe specified action is not available for you400資源不足，無法創(chuàng)建OperationDeni

35、edThe resource is out of usage.400用戶的drds實例個數(shù)已經(jīng)達到上限QuotaExceeded.DRD SInstanceThe quota of create instance exceeds.400指定的地域不存在InvalidRegionId.Not FoundThe RegionId provided does not exist in our records.404參數(shù)description不合法InvalidDescription.M alFormedThe specified parameter description is not valid.

36、400與DRDS Server通信錯誤CommunicateWithM anager.ErrorInternal Error. Communicate with drds manager error400虛擬交換機ID錯誤InvalidVSwitchIdInvalid vswitchId400虛擬專用網(wǎng)絡IDInvalidVpcIdInvalid vpcId400可用區(qū)錯誤InvalidZoneId.Misma tchzone is illegal in this order400庫存不足LowInventory.Server Errorlow inventory error400該區(qū)域已存在

37、共享實例publicInstanceAlread Exist.ErrorA public Drds instance is exist400生成DRDS實例錯誤CreateDRDSInstance Id.Errorcreate Drds instance id error400已有相同任務在執(zhí)行中AnotherOrderExist.Er rorthere is another order400實例數(shù)量超過上限InstanceExceedLimit. Errorinstance number has exceeded400不能創(chuàng)建VPC網(wǎng)絡類型的共享實例InvalidDRDSInstance T

38、ype.ErrorCannot create Public Drds instance with vpcId or vswitch400Quantity參數(shù)錯誤InvalidParameter.Qu antityInvalid parameter of quantity400RegionId參數(shù)錯誤InvalidParameter.Re gionIdInvalid parameter of region id400zoneId(可用區(qū))參數(shù)錯誤InvalidParameter.Zo neIdInvalid parameter of zone id400付費類型錯誤InvalidParamete

39、r.Pay TypeInvalid parameter of pay type400規(guī)格錯誤InvalidParameter.Sp ectionInvalid parameter of specification400校驗VSwitchId失敗QueryVSwitchFailed. InvalidVpcIdOrServe rErrorQuery VSwitch failed, please check vpcId400該區(qū)域不支持創(chuàng)建VPC實例RegionNotSupportV PC.ErrorThis region does not support vpc instance400查詢drds

40、實例詳情 class=reference-link查詢drds實例詳情參數(shù)名類型是否必須描述ActionString是系統(tǒng)規(guī)定參數(shù)，取值：DescribeDrdsInsta nceDrdsInstanceIdString是drds實例id功能描述：查詢單個drds實例細節(jié)請求參數(shù)：返回值：參數(shù)名類型描述公共返回值DrdsInstanceIdString實例id,16位字符串Statusint實例狀態(tài) 0: 運行中 1: 創(chuàng)建中(不能管理,釋放) 2: 異常 3: 已過期(不能管理,釋放) 4: 釋放中(不能管理,釋放) 5: 已釋放(不能管理,釋放) 6：鎖定TypeString實例類型 0

41、-共享 1-專享RegionIdString區(qū)域descriptionString實例描述ZoneIdstring可用區(qū)CreateTimeLong創(chuàng)建時間VersionLong版本VipsListHost ，port 和類型等，具體參數(shù)名和類型如下表networkTypeString網(wǎng)絡類型：vpc和classicVips 取值參數(shù)名類型描述ipStringipportString端口typeString分為三種:internet,intranet,vpc錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼權限錯誤ActionUnauthorizedThe specified action i

42、s not available for you400指定的drds實例在用戶帳號下不存在InvalidDRDSInstance Id.NotFoundThe DrdsInstanceId provided does not exist in our records.404修改drds實例描述 class=reference-link修改drds實例描述參數(shù)名類型是否必須描述ActionString是系統(tǒng)規(guī)定參數(shù)，取值：ModifyDrdsInstan ceDescriptionDrdsInstanceIdString是drds實例idDescriptionString是DRDS實例描述。2-

43、128個字符功能描述：修改drds實例的描述信息請求參數(shù)：返回值：參數(shù)名類型說明公共返回值錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼指定的drds實例在用戶帳號下不存在InvalidDRDSInstance Id.NotFoundThe DrdsInstanceId provided does not exist in our records.404參數(shù)description不合InvalidDescription.MThe specified400法alFormedparameter description is not valid.實例描述不符合要求InvalidDescripti

44、on.M alFormedThe specified parameter description is not valid.400查詢drds實例列表參數(shù)名類型是否必須描述ActionString是系統(tǒng)規(guī)定參數(shù)，取值：DescribeDrdsInsta ncesRegionIdString是區(qū)域typeInteger否實例是專享還是共享專享為1 共享為0功能描述：查詢drds實例列表請求參數(shù)：返回值：參數(shù)名類型描述公共返回值ItemsList由DrdsInstance組成的數(shù)組DrdsInstance 組成如下:參數(shù)名類型描述DrdsInstanceIdString實例id,16位字符串Sta

45、tusint實例狀態(tài) 0: 運行中 1: 創(chuàng)建中(不能管理,釋放) 2: 異常 3: 已過期(不能管理,釋放) 4: 釋放中(不能管理,釋放) 5: 已釋放(不能管理,釋放) 6：鎖定Typeint實例類型 0 -共享 1-專享RegionIdString區(qū)域zoneIdString可用區(qū)CreateTimeLong創(chuàng)建時間VersionLong版本networkTypeString實例的網(wǎng)絡類型，分為vpc和classicVipsListHost ，port 和類型等，具體參數(shù)名和類型如下表節(jié)點規(guī)格Vips 取值參數(shù)名類型描述ipStringipportString端口typeString分

46、為三種:internet,intranet,vpc錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼指定的地域不存在InvalidRegionId.Not FoundThe RegionId provided does not exist in our records.404釋放實例參數(shù)名類型是否必須描述ActionString是系統(tǒng)規(guī)定參數(shù)，取值：RemoveDrdsInsta nceDrdsInstanceIdString是DRDS實例id功能描述：釋放DRDS實例請求參數(shù)：返回值：參數(shù)名類型描述公共返回值錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼指定的drds實例在用Invali

47、dDRDSInstanceThe DrdsInstanceId404戶帳號下不存在Id.NotFoundprovided does not exist in our records.刪除drds實例下的數(shù)據(jù)庫后才能刪除數(shù)據(jù)庫RemoveDrdsDBFirstThere are Drds DB exist in this instance. Please delete drds db first400DRDS數(shù)據(jù)庫相關接口 class=reference- linkDRDS數(shù)據(jù)庫相關接口創(chuàng)建DRDS數(shù)據(jù)庫 class=reference-link創(chuàng)建DRDS數(shù)據(jù)庫功能描述：創(chuàng)建drds數(shù)據(jù)庫，該

48、接口只是提交了建庫任務，分布式數(shù)據(jù)庫是否創(chuàng)建成功要 通過下一個數(shù)據(jù)庫的查詢接口來判斷。調(diào)用完創(chuàng)建數(shù)據(jù)庫接口并返回成功后，再調(diào)用DescribeDrdsDB接口，如果返回值里的Status屬性為1，則表示庫建成功， 可以使用了。要連接上這個數(shù)據(jù)庫需要 ip（drds實例的ip），port（drds實例的端口），dbname（你剛創(chuàng)建數(shù)據(jù)庫時提供的名字），username（目前默認創(chuàng)建了和dbname同名的帳號，暫不支持自主建帳號），password（你建數(shù)據(jù)庫時提供的密 碼）請求參數(shù)：參數(shù)名類型是否必須描述ActionString是系統(tǒng)規(guī)定參數(shù)，取值：CreateDrdsDBDrdsInstan

49、ceIdString是DRDS實例idDbNameString是分布式數(shù)據(jù)庫的名稱（小寫字母、數(shù)字、下劃線組成，字母開頭，不超過24字符）EncodeString是數(shù)據(jù)庫編碼（取值可以為utf8，gbk，latin1，u tf8mb4）PasswordString是分布式數(shù)據(jù)庫密碼（8- 30個字符。）RdsInstancesString是rds實例名列表（rds實例名就是rds那邊的DBInstanceId），字符串形式的json數(shù)組返回值：參數(shù)名類型描述公共返回值錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼指定的Rds實例和drds實例不屬于同一個用戶InvalidParameter

50、.Mis matchRDS instance and drds instance must belong to owner400用戶的drds數(shù)據(jù)庫個數(shù)已經(jīng)達到上限QuotaExceeded.Drds DBThe quota of create DrdsDB exceeds.400Dbname不合法InvalidDbname.MalF ormedThe specified parameter Dbname is not valid.400Encode不支持InvalidEncode. ValueNotSupportedThe specified parameter encode is not

51、valid.400Rds數(shù)據(jù)庫上的庫已經(jīng)存在OperationDenied.Rd sDbNameExistsThe operation is not permitted due to Rds DbName exist.400Rds上帳號已存在OperationDenied.Rd sAccoutExistsThe operation is not permitted due to Rds accout exist.400密碼不合法InvalidPassword.Mal FormedThe specified parameter password is not valid.400數(shù)據(jù)庫名不能以下劃

52、線(_)結尾InvalidParameter_Db prefixCannotEndWit hUnderlineDB prefix can not end up with underline.400Drds實例的版本不支持建庫DrdsVersionIsOldThis drds instance version too old.not allow create drds db400數(shù)據(jù)庫名重復InvalidDbprefixDupli cateddb name in this drds instance duplicate400Rds的區(qū)域與DRDS實例不匹配InvalidRds.RegionNo

53、tMatchThe rds region does not match Drds region400查詢DRDS數(shù)據(jù)庫 class=reference-link查詢DRDS數(shù)據(jù)庫功能描述：查詢drds數(shù)據(jù)庫詳情請求參數(shù)：參數(shù)名類型是否必須說明ActionString是系統(tǒng)規(guī)定參數(shù)，取值：DescribeDrdsDBDbNameString是分布式數(shù)據(jù)庫的名稱DrdsInstanceIdString是DRDS實例id返回值：參數(shù)名類型描述公共返回值DbNameStringStatusString0-建庫中 1-正常 2-建庫失敗 3- 刪除中 4-刪除失敗 5-遷移中 6- 遷移失敗Create

54、TimeStringMsgString狀態(tài)的詳情，如果是錯誤狀態(tài)，則包含錯誤信息ModeString運行模式錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼實例不存在InvalidDRDSInstance Id.NotFoundThe DrdsInstanceId provided does not exist in our records.404指定的實例上不存在指定的分布式數(shù)據(jù)庫InvalidDbName.NotF oundThe Drds DbName provided does not exist in our records.404刪除DRDS數(shù)據(jù)庫 class=reference

55、-link刪除DRDS數(shù)據(jù)庫功能描述：刪除drds數(shù)據(jù)庫。該接口只是提交了刪除數(shù)據(jù)庫的任務，分布式數(shù)據(jù)庫是否刪 除成功要通過數(shù)據(jù)庫的查詢接口來判斷。請求參數(shù)：參數(shù)名類型是否必須描述ActionString是系統(tǒng)規(guī)定參數(shù)，取值：DeleteDrdsDBDbNameString是分布式數(shù)據(jù)庫的名稱DrdsInstanceIdString是DRDS實例id返回值：參數(shù)名類型描述公共返回值錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼實例不存在InvalidDRDSInstance Id.NotFoundThe DrdsInstanceId provided does not exist in o

56、ur records.404指定的實例上不存在指定的分布式數(shù)據(jù)庫InvalidDbName.NotF oundThe Drds DbName provided does not exist in our records.404數(shù)據(jù)庫正在創(chuàng)建中DbIsCreatingThe specified db is in creating status400無效的數(shù)據(jù)庫名，正在刪除或者刪除失敗InvalidDbname.Delet eStatusOrFailedThe specified db is in deleting status or failed status400重置DRDS數(shù)據(jù)庫密碼 cla

57、ss=reference-link重置DRDS數(shù)據(jù)庫密碼參數(shù)名類型是否必須描述ActionString是系統(tǒng)規(guī)定參數(shù)，取值：ModifyDrdsDBPas swdDbNameString是分布式數(shù)據(jù)庫的名稱DrdsInstanceIdString是DRDS實例idNewPasswdString是新密碼功能描述：重置drds數(shù)據(jù)庫的密碼。請求參數(shù)：返回值：參數(shù)名類型描述公共返回值錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼實例不存在InvalidDRDSInstance Id.NotFoundThe DrdsInstanceId provided does not exist in our

58、 records.404指定的實例上不存在指定的分布式數(shù)據(jù)庫InvalidDbName.NotF oundThe Drds DbName provided does not exist in our records.404新密碼不符合規(guī)范InvalidNewPasswd. MalFormedThe specified parameter NewPasswd is not valid.400所指定的數(shù)據(jù)庫的用戶名不存在InvalidDbUserName. NotFoundThe Username of db is not valid.400更新數(shù)據(jù)庫密碼失敗UpdateDbUserPassw o

59、rdFailedupdate password failed400查看drds數(shù)據(jù)庫列表參數(shù)名類型是否必須說明ActionString是系統(tǒng)規(guī)定參數(shù)，取值：DescribeDrdsDBsDrdsInstanceIdString是DRDS實例id功能描述： 查看指定實例的db列表。請求參數(shù)：返回值：參數(shù)名類型描述公共返回值ItemsListDrdsDB的列表DrdsDB組成結構參數(shù)名類型描述DbNameStringStatusString0-建庫中 1-正常 2-建庫失敗 3- 刪除中 4-刪除失敗 5-遷移中 6-遷移失敗CreateTimeLongMsgString狀態(tài)的詳情，如果是錯誤狀態(tài)

60、，則包含錯誤信息ModeString運行模式錯誤碼：錯誤錯誤代碼描述http 狀態(tài)碼通用錯誤碼實例不存在InvalidDrdsInstanceI d.NotFoundThe DrdsInstanceId provided does not exist in our records.404修改DRDS數(shù)據(jù)庫的IP白名單參數(shù)名類型是否必須說明ActionString是系統(tǒng)規(guī)定參數(shù)，取值：ModifyDrdsIpWhit eListDrdsInstanceIdString是DRDS實例idDbNameString是數(shù)據(jù)庫名IpWhiteListString是ip列表，多個ip之間用逗號隔開ModeB