Queries the information about one or more node types, such as the code and name of a node type.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ListFileType |
The operation that you want to perform. Set the value to ListFileType. |
ProjectId | Long | No | 10000 |
The ID of the DataWorks workspace. You can log on to the DataWorks console and go to the Workspace Management page to obtain the workspace ID. You must configure either this parameter or the ProjectIdentifier parameter to determine the DataWorks workspace to which the operation is applied. |
ProjectIdentifier | String | No | dw_project |
The name of the DataWorks workspace. You can log on to the DataWorks console and go to the Workspace Management page to obtain the workspace name. You must configure either the ProjectId or ProjectIdentifier parameter to determine the DataWorks workspace to which the operation is applied. |
PageNumber | Integer | Yes | 1 |
The number of the page to return. |
PageSize | Integer | Yes | 50 |
The number of entries to return on each page. Maximum value: 100. |
Keyword | String | No | ODPS SQL |
The name of the node type. You can log on to the DataWorks console, go to the DataStudio page, and then view the name of a specific node type on the left side of the page. Take note of the following items when you use this parameter:
|
Locale | String | No | zh-CN |
The language that you use for the query. Valid values: zh-CN and en-US. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 0000-ABCD-EFG**** |
The ID of the request. You can use the ID to troubleshoot issues. |
NodeTypeInfoList | Object |
The information of the node types. |
|
PageNumber | Integer | 1 |
The page number of the returned page. |
PageSize | Integer | 50 |
The number of entries returned per page. |
TotalCount | Integer | 127 |
The total number of entries returned. |
NodeTypeInfo | Array of NodeTypeInfo |
The information of the node type. |
|
NodeTypeName | String | ODPS SQL |
The name of the node type. The codes and names of node types have the following mappings: 6 (Shell), 10 (ODPS SQL), 11 (ODPS MR), 23 (Data Integration), 24 (ODPS Script), 99 (zero load), 221 (PyODPS 2), 225 (ODPS Spark), 227 (EMR Hive), 228 (EMR Spark), 229 (EMR Spark SQL), 230 (EMR MR), 239 (OSS object inspection), 257 (EMR Shell), 258 (EMR Spark Shell), 259 (EMR Presto), 260 (EMR Impala), 900 (real-time synchronization), 1089 (cross-tenant collaboration), 1091 (Hologres development), 1093 (Hologres SQL), 1100 (assignment), and 1221 (PyODPS 3) |
NodeType | Integer | 10 |
The code of the node type. The codes and names of node types have the following mappings: 6 (Shell), 10 (ODPS SQL), 11 (ODPS MR), 23 (Data Integration), 24 (ODPS Script), 99 (zero load), 221 (PyODPS 2), 225 (ODPS Spark), 227 (EMR Hive), 228 (EMR Spark), 229 (EMR Spark SQL), 230 (EMR MR), 239 (OSS object inspection), 257 (EMR Shell), 258 (EMR Spark Shell), 259 (EMR Presto), 260 (EMR Impala), 900 (real-time synchronization), 1089 (cross-tenant collaboration), 1091 (Hologres development), 1093 (Hologres SQL), 1100 (assignment), and 1221 (PyODPS 3) |
Examples
Sample requests
http(s)://[Endpoint]/?Action=ListFileType
&ProjectId=10000
&ProjectIdentifier=dw_project
&PageNumber=1
&PageSize=50
&Keyword=ODPS SQL
&Locale=zh-CN
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<ListFileTypeResponse>
<RequestId>0000-ABCD-EFG****</RequestId>
<NodeTypeInfoList>
<PageNumber>1</PageNumber>
<PageSize>50</PageSize>
<TotalCount>127</TotalCount>
<NodeTypeInfo>
<NodeTypeName>ODPS SQL</NodeTypeName>
<NodeType>10</NodeType>
</NodeTypeInfo>
</NodeTypeInfoList>
</ListFileTypeResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "0000-ABCD-EFG****",
"NodeTypeInfoList" : {
"PageNumber" : 1,
"PageSize" : 50,
"TotalCount" : 127,
"NodeTypeInfo" : {
"NodeTypeName" : "ODPS SQL",
"NodeType" : 10
}
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
429 | Throttling.Api | The request for this resource has exceeded your available limit. | The error message returned because the number of requests for the resource has exceeded the upper limit. |
429 | Throttling.System | The DataWorks system is busy. Try again later. | The error message returned because the DataWorks system is busy. Try again later. |
429 | Throttling.User | Your request is too frequent. Try again later. | The error message returned because excessive requests have been submitted within a short period of time. Try again later. |
500 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | The error message returned because an internal error has occurred. Try again later. |
500 | InternalError.System | An internal system error occurred. Try again later. | The error message returned because an internal error has occurred. Try again later. |
For a list of error codes, see Service error codes.