創(chuàng)建普通數(shù)據(jù)變更工單。
接口說(shuō)明
僅管控模式為安全協(xié)同的數(shù)據(jù)庫(kù)實(shí)例可調(diào)用此 API。
關(guān)于該功能的更多說(shuō)明,請(qǐng)參見普通數(shù)據(jù)變更。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語(yǔ)句的Action
元素中使用,用來(lái)給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問(wèn)級(jí)別:是指每個(gè)操作的訪問(wèn)級(jí)別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說(shuō)明如下:
- 對(duì)于必選的資源類型,用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問(wèn)級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
dms:CreateDataCorrectOrder | create | *全部資源 * |
| 無(wú) |
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Comment | string | 是 | 業(yè)務(wù)背景,以減少溝通成本。 | test |
RelatedUserList | array | 否 | 相關(guān)人列表。 | |
long | 否 | 變更相關(guān)人的用戶 ID,設(shè)置的相關(guān)人員可查看工單,并協(xié)同工作,非相關(guān)人員則不能查看工單(管理員、DBA 除外)。 | 51**** | |
Param | object | 是 | 工單參數(shù)。 | |
Classify | string | 否 | 數(shù)據(jù)變更原因。 | test |
EstimateAffectRows | long | 是 | 預(yù)估本次變更會(huì)影響的數(shù)據(jù)行數(shù)。 | 1 |
ExecSQL | string | 否 | 變更 SQL 語(yǔ)句。 說(shuō)明
| update base_user set id = 1 where id = 1; |
SqlType | string | 是 | 變更 SQL 的提交方式,取值如下:
說(shuō)明
如果您選擇文本方式,則 SQL 代碼大小不能超過(guò) 1 KB。如果 SQL 代碼超過(guò) 1 KB,建議您選擇上傳附件的方式。
| TEXT |
AttachmentName | string | 否 | 變更 SQL 附件 Key(AttachmentKey),可通過(guò)調(diào)用 GetUserUploadFileJob 接口獲取該參數(shù)的值。 說(shuō)明
如果 SqlType 為 ATTACHMENT,該參數(shù)必填。
| test.sql |
RollbackSQL | string | 否 | 回滾 SQL 語(yǔ)句。 說(shuō)明
如果 RollbackSqlType 為 TEXT,該參數(shù)必填。
| update base_user set id = 1 where id = 1; |
RollbackAttachmentName | string | 否 | 回滾 SQL 附件 Key(AttachmentKey),可通過(guò)調(diào)用 GetUserUploadFileJob 接口獲取該參數(shù)的值。 說(shuō)明
如果 RollbackSqlType 為 ATTACHMENT,該參數(shù)必填。
| test_rollback.sql |
RollbackSqlType | string | 否 | 回滾 SQL 的提交方式,取值如下:
| TEXT |
DbItemList | array<object> | 是 | 變更的數(shù)據(jù)庫(kù)列表。 | |
object | 否 | 數(shù)據(jù)庫(kù)信息。 | ||
DbId | long | 是 | 數(shù)據(jù)庫(kù) ID(DatabaseId),數(shù)據(jù)庫(kù)分為物理庫(kù)和邏輯庫(kù)兩種:
| 1860**** |
Logic | boolean | 是 | 是否為邏輯庫(kù),取值如下:
| false |
ExecMode | string | 否 | 工單執(zhí)行方式,取值如下:
| COMMITOR |
AttachmentKey | string | 否 | 工單附件 Key,補(bǔ)充當(dāng)前工單信息。可通過(guò)調(diào)用 GetUserUploadFileJob 接口獲取該參數(shù)的值。 | order_attachment.txt |
RealLoginUserUid | string | 否 | 實(shí)際調(diào)用 API 的用戶的阿里云賬號(hào) UID。更多信息,請(qǐng)參見指定 API 調(diào)用者。 | 21400447956867**** |
Tid | long | 否 | 租戶 ID,可通過(guò)調(diào)用接口 GetUserActiveTenant 或 ListUserTenants 獲取該參數(shù)的值。 | 3*** |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931",
"Success": true,
"ErrorMessage": "UnknownError",
"ErrorCode": "UnknownError",
"CreateOrderResult": [
0
]
}
錯(cuò)誤碼
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-07-11 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |