AllocateDirectConnection - 申請叢集執行個體的直連地址 - Tair (Redis® OSS-Compatible)

申請雲資料庫 Tair（相容 Redis）叢集執行個體的直連地址。

介面說明

用戶端可通過直連地址繞過代理，像串連原生 Redis 叢集一樣串連叢集執行個體，從而降低鏈路開銷，進一步提升雲資料庫 Tair（相容 Redis）服務的響應速度。

調用本介面的執行個體需滿足下述條件：

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作

存取層級

資源類型

條件關鍵字

關聯操作

kvstore:AllocateDirectConnection

create

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

無

名稱	類型	必填	描述	樣本值
InstanceId	string	是	執行個體 ID。	r-bp1zxszhcgatnx****
ConnectionString	string	否	直連地址的首碼，由小寫英文字母或數字組成，以小寫字母開頭，長度為 8~40 字元。預設為執行個體 ID+`-direct`，例如執行個體 ID 為 r-8vbwsicr5d5gse**，則該參數預設為`r-8vbwsicr5d5gse**-direct`。	redisdirect123
Port	string	否	連接埠號碼，取值範圍為 1024~65535，預設值為 6379。	6379

正常返回樣本

JSON格式

{
  "RequestId": "5D622714-AEDD-4609-9167-F5DDD3D1****"
}

HTTP status code	錯誤碼	錯誤資訊	描述
400	NetTypeExists	Specified net type already existed
400	InvalidConnType	Specified DB instance conn type is not valid.
400	TaskHasExist	The task already exists.
400	ConnectionStringAlreadyExists	Specified connection string already exists in the Aliyun RDS.
400	InvalidConnectionString.Format	Specified connection string is not valid.	串連串非法，請選用新的
400	DirectConnectionAlreadyExists	Specified instance direct connection already exists.
400	InvalidVPCParamGroup	Specified vpc param group is not valid.
400	InvalidConnectionString	ConnectionString is invalid, valid regex: ^\w+$	串連地址首碼非法，由小寫英文字母或數字組成，以小寫字母開頭，長度為8~40字元。
403	UnsupportedEngineVersion	Current engine version does not support operations.
403	IncorrectMinorVersion	Current engine minor version does not support operations.
403	InstanceStatus.NotSupport	Instance status does not support this operation.
404	InvalidDbInstanceId.NotFound	Specified instance does not exist.

訪問錯誤中心查看更多錯誤碼。

更多資訊，參考變更詳情。