调用GetDataServicePublishedApi获取数据服务API发布状态-大数据开发治理平台 DataWorks-阿里云

调用GetDataServicePublishedApi查询数据服务API的发布态信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
ProjectId	long	是	工作空间的 ID。	10002
TenantId	long	否	租户 ID。您可登录 DataWorks 控制台，进入数据开发（DataStudio）页面，单击右上方当前登录用户名称，选择菜单 > 用户信息，获取租户 ID。	10003
ApiId	long	是	API 的 ID。	10001

返回参数

名称	类型	描述	示例值
	object
HttpStatusCode	integer	HTTP 状态码。	200
RequestId	string	请求 ID，一次请求的唯一标识。	0000-ABCD-EFG****
ErrorMessage	string	错误信息。	The connection does not exist.
Success	boolean	调用是否成功。	true
ErrorCode	string	错误码。	Invalid.Tenant.ConnectionNotExists
Data	object	API 的最新发布态信息。
Timeout	integer	超时时间，单位为毫秒（ms）。	10000
Status	integer	API 的状态，可选枚举值包括 0（未发布）和 1（已发布）。	1
ApiId	long	数据服务 API 的 ID。	10000
ApiMode	integer	API 的类型，可选枚举值包括 0（向导 API）、1（脚本 API）和 2（注册 API）。	0
ProjectId	long	工作空间的 ID。	10001
ResponseContentType	integer	API 的返回数据类型，可选枚举值包括 0（JSON）和 1（XML）。向导和脚本 API 支持 JSON，注册 API 支持 JSON 和 XML。	0
CreatorId	string	创建人的阿里云 ID。	1234567
VisibleRange	integer	可见范围，可选枚举值包括 0（工作空间）和 1（私有）。	0
ModifiedTime	string	最新修改时间。	2020-06-23T00:21:01+0800
OperatorId	string	最新编辑人的阿里云 ID。	2345678
GroupId	string	分组 ID。	ab12**
Description	string	描述信息。	测试API描述
RequestMethod	integer	API 的请求方式，可选枚举值包括 0（GET）、1（POST）、2（PUT）和 3（DELTE）。向导和脚本 API 支持 GET 和 POST。注册 API 支持 GET、POST、PUT 和 DELETE。	0
CreatedTime	string	创建时间。	2020-06-23T00:21:01+0800
ApiName	string	API 的名称。	测试API名称
TenantId	long	租户 ID。	10001
ApiPath	string	API 的路径。	/test/1
Protocols	array	API 协议，多值列表，可选枚举值包括 0（HTTP）和 1（HTTPS）。
Protocol	integer	API 协议，多值列表，可选枚举值包括 0（HTTP）和 1（HTTPS）。	0
RegistrationDetails	object	注册 API 详情，只有注册 API 返回。
ServiceHost	string	后端服务地址。	http://www.abc.com
ServiceContentType	integer	API 的返回数据类型，可选枚举值包括 0（JSON）和 1（XML）。向导和脚本 API 支持 JSON，注册 API 支持 JSON 和 XML。	0
ServicePath	string	后端服务路径。	/index
SuccessfulResultSample	string	正常返回示例。	{"success": true}
FailedResultSample	string	错误返回示例。	{"success": false}
ServiceRequestBodyDescription	string	后端请求 body 内容的描述。	{"abc":1}
RegistrationErrorCodes	array<object>	注册 API 的错误码列表。
RegistrationErrorCode	object
ErrorMessage	string	错误信息。	The connection does not exist.
ErrorCode	string	错误码。	Invalid.Tenant.ConnectionNotExists
ErrorSolution	string	错误解决方案。	retry
RegistrationRequestParameters	array<object>	注册 API 的请求参数列表。
RegistrationRequestParameter	object
ParameterName	string	参数的名称。	name1
ParameterPosition	integer	参数的位置，可选枚举值包括 0（Path）、1（Query）、2（Head）和 3（Body）。向导和脚本 API 仅支持 Query。注册 API 中的 GET、DELETE 方法支持 Query、Head，PUT、POST 方法支持 Query、Head 和 Body。	0
ParameterDescription	string	描述信息。	description1
DefaultValue	string	默认值。	default1
ParameterOperator	integer	运算符，可选枚举值包括 0（Equal）、1（Like）、2（Const）和 3（In）。向导模式 API 支持 Equal、Like 和 In，脚本模式 API 支持 Equal，注册 API 支持 Equal 和 Const。	0
ExampleValue	string	示例值。	example1
ParameterDataType	integer	数据类型，可选枚举值： 0：String 1：Int 2：Long 3：Float 4：Double 5：Boolean 6：StringList 7：IntList 8：LongList 9：FloatList 10：DoubleList 11：BooleanList	0
IsRequiredParameter	boolean	是否必填。	true
ScriptDetails	object	脚本 API 详情，只有脚本 API 返回。
IsPagedResponse	boolean	返回是否分页。	true
SuccessfulResultSample	string	正常返回示例。	{"success": true}
FailedResultSample	string	错误返回示例。	{"success": false}
Script	string	SQL 脚本。	select a from t
ScriptErrorCodes	array<object>	脚本 API 的错误码列表。
ScriptErrorCode	object
ErrorMessage	string	错误信息	fail to call
ErrorCode	string	错误码	1001
ErrorSolution	string	错误解决方案	retry
ScriptRequestParameters	array<object>	脚本 API 的请求参数列表。
ScriptRequestParameter	object
ParameterName	string	参数名称	param1
ParameterPosition	integer	参数位置，可选枚举值有： 0：Path 1：Query 2：Head 3：Body 向导和脚本 API，只支持 Query；注册 API，GET、DELETE 方法支持 Query、Head，PUT、POST 方法支持 Query、Head、Body。	0
ParameterDescription	string	描述	description1
DefaultValue	string	默认值	default1
ParameterOperator	integer	运算符，可选枚举值有： 0：Equal 1：Like 2：Const 3：In 向导 API 支持 Equal、Like、In；脚本 API 支持 Equal；注册 API 支持 Equal、Const。	0
ExampleValue	string	示例值	example1
ParameterDataType	integer	数据类型，可选枚举值： 0：String 1：Int 2：Long 3：Float 4：Double 5：Boolean 6：StringList 7：IntList 8：LongList 9：FloatList 10：DoubleList 11：BooleanList	0
IsRequiredParameter	boolean	是否必填	true
ScriptResponseParameters	array<object>	脚本 API 的返回参数列表。
ScriptResponseParameter	object
ParameterDescription	string	描述信息。	description2
ParameterName	string	参数的名称。	param2
ExampleValue	string	示例值。	example2
ParameterDataType	integer	数据类型，可选枚举值： 0：String 1：Int 2：Long 3：Float 4：Double 5：Boolean 6：StringList 7：IntList 8：LongList 9：FloatList 10：DoubleList 11：BooleanList	0
ScriptConnection	object	脚本 API 的数据源信息。
TableName	string	数据源的表名称。	t
ConnectionId	long	数据源的 ID。	123
WizardDetails	object	向导 API 详情，只有向导 API 返回。
IsPagedResponse	boolean	返回是否分页。	true
SuccessfulResultSample	string	正常返回示例。	{"success": true}
FailedResultSample	string	错误返回示例。	{"success": false}
WizardErrorCodes	array<object>	向导 API 的错误码列表。
WizardErrorCode	object
ErrorMessage	string	错误信息。	fail to call
ErrorCode	string	错误码。	1001
ErrorSolution	string	错误解决方案。	retry
WizardRequestParameters	array<object>	向导 API 的请求参数列表。
WizardRequestParameter	object
ParameterName	string	参数的名称。	param1
ParameterPosition	integer	参数的位置，可选枚举值包括 0（Path）、1（Query）、2（Head）和 3（Body）。向导和脚本 API 仅支持 Query。注册 API 中的 GET、DELETE 方法支持 Query、Head，PUT、POST 方法支持 Query、Head 和 Body。	0
ParameterDescription	string	描述信息。	description1
DefaultValue	string	默认值。	default1
ParameterOperator	integer	运算符，可选枚举值包括 0（Equal）、1（Like）、2（Const）和 3（In）。向导模式 API 支持 Equal、Like 和 In，脚本模式 API 支持 Equal，注册 API 支持 Equal 和 Const。	0
ExampleValue	string	示例值。	example1
ParameterDataType	integer	数据类型，可选枚举值： 0：String 1：Int 2：Long 3：Float 4：Double 5：Boolean 6：StringList 7：IntList 8：LongList 9：FloatList 10：DoubleList 11：BooleanList	0
IsRequiredParameter	boolean	是否必填。	true
WizardResponseParameters	array<object>	向导 API 的返回参数列表。
WizardResponseParameter	object	向导模式的返回参数列表。
ParameterDescription	string	描述信息。	description2
ParameterName	string	参数的名称。	param2
ExampleValue	string	示例值。	example2
ParameterDataType	integer	数据类型，可选枚举值： 0：String 1：Int 2：Long 3：Float 4：Double 5：Boolean 6：StringList 7：IntList 8：LongList 9：FloatList 10：DoubleList 11：BooleanList	0
WizardConnection	object	向导 API 的数据源信息。
TableName	string	数据源的表名称。	t
ConnectionId	long	数据源的 ID。	123
SqlMode	integer	SQL 模式，0：基础 SQL；1：高级 SQL	0

不同类型 API 的详情信息通过不同字段返回。向导 API 使用 WizardDetails 字段，脚本 API 使用 ScriptDetails 字段，注册 API 使用 RegistrationDetails 字段。

示例

正常返回示例

JSON格式

{
  "HttpStatusCode": 200,
  "RequestId": "0000-ABCD-EFG****",
  "ErrorMessage": "The connection does not exist.",
  "Success": true,
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Data": {
    "Timeout": 10000,
    "Status": 1,
    "ApiId": 10000,
    "ApiMode": 0,
    "ProjectId": 10001,
    "ResponseContentType": 0,
    "CreatorId": 1234567,
    "VisibleRange": 0,
    "ModifiedTime": "2020-06-23T00:21:01+0800",
    "OperatorId": 2345678,
    "GroupId": "ab12**",
    "Description": "测试API描述",
    "RequestMethod": 0,
    "CreatedTime": "2020-06-23T00:21:01+0800",
    "ApiName": "测试API名称",
    "TenantId": 10001,
    "ApiPath": "/test/1",
    "Protocols": [
      0
    ],
    "RegistrationDetails": {
      "ServiceHost": "http://www.abc.com",
      "ServiceContentType": 0,
      "ServicePath": "/index",
      "SuccessfulResultSample": {
        "success": true
      },
      "FailedResultSample": {
        "success": false
      },
      "ServiceRequestBodyDescription": {
        "abc": 1
      },
      "RegistrationErrorCodes": [
        {
          "ErrorMessage": "The connection does not exist.",
          "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
          "ErrorSolution": "retry"
        }
      ],
      "RegistrationRequestParameters": [
        {
          "ParameterName": "name1",
          "ParameterPosition": 0,
          "ParameterDescription": "description1",
          "DefaultValue": "default1",
          "ParameterOperator": 0,
          "ExampleValue": "example1",
          "ParameterDataType": 0,
          "IsRequiredParameter": true
        }
      ]
    },
    "ScriptDetails": {
      "IsPagedResponse": true,
      "SuccessfulResultSample": {
        "success": true
      },
      "FailedResultSample": {
        "success": false
      },
      "Script": "select a from t",
      "ScriptErrorCodes": [
        {
          "ErrorMessage": "fail to call",
          "ErrorCode": 1001,
          "ErrorSolution": "retry"
        }
      ],
      "ScriptRequestParameters": [
        {
          "ParameterName": "param1",
          "ParameterPosition": 0,
          "ParameterDescription": "description1",
          "DefaultValue": "default1",
          "ParameterOperator": 0,
          "ExampleValue": "example1",
          "ParameterDataType": 0,
          "IsRequiredParameter": true
        }
      ],
      "ScriptResponseParameters": [
        {
          "ParameterDescription": "description2",
          "ParameterName": "param2",
          "ExampleValue": "example2",
          "ParameterDataType": 0
        }
      ],
      "ScriptConnection": {
        "TableName": "t",
        "ConnectionId": 123
      }
    },
    "WizardDetails": {
      "IsPagedResponse": true,
      "SuccessfulResultSample": {
        "success": true
      },
      "FailedResultSample": {
        "success": false
      },
      "WizardErrorCodes": [
        {
          "ErrorMessage": "fail to call",
          "ErrorCode": 1001,
          "ErrorSolution": "retry"
        }
      ],
      "WizardRequestParameters": [
        {
          "ParameterName": "param1",
          "ParameterPosition": 0,
          "ParameterDescription": "description1",
          "DefaultValue": "default1",
          "ParameterOperator": 0,
          "ExampleValue": "example1",
          "ParameterDataType": 0,
          "IsRequiredParameter": true
        }
      ],
      "WizardResponseParameters": [
        {
          "ParameterDescription": "description2",
          "ParameterName": "param2",
          "ExampleValue": "example2",
          "ParameterDataType": 0
        }
      ],
      "WizardConnection": {
        "TableName": "t",
        "ConnectionId": 123
      }
    },
    "SqlMode": 0
  }
}

错误码

HTTP status code	错误码	错误信息	描述
403	Forbidden.Access	Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.	没有权限，请授权
429	Throttling.Api	The request for this resource has exceeded your available limit.	对该资源的请求已超过您的可用上限。
429	Throttling.System	The DataWorks system is busy. Try again later.	DataWorks系统繁忙，请稍后再试。
429	Throttling.User	Your request is too frequent. Try again later.	您的请求过于频繁，请尝试放缓请求速度。
500	InternalError.System	An internal system error occurred. Try again later.	系统内部错误，请稍后再试。
500	InternalError.UserId.Missing	An internal system error occurred. Try again later.	系统内部错误，请稍后再试。

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2023-10-10	OpenAPI 错误码发生变更	查看变更详情