All Products
Search

This Product

    DataWorks:UpdateUdfFile

    Document Center

    DataWorks:UpdateUdfFile

    Last Updated:Jul 31, 2026

    Updates the file information of a function.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    FileFolderPath

    string

    No

    The path of the folder where the function file is stored.

    Business_process/First_Business_Process/function/string_processing_function
    ProjectId

    integer

    No

    The ID of the DataWorks workspace. You can click the small wrench icon in the upper-right corner of the page to go to the storage management page and view the ID.

    10000
    FunctionType

    string

    Yes

    The categorization of the function, which corresponds to the udf type field in the Create Function form. Valid values:

    • MATH: mathematical operation function.

    • AGGREGATE: aggregate functions.

    • STRING: character string processing function.

    • DATE: date processing function.

    • ANALYTIC: window function.

    • OTHER: other function.

    Valid values:

    • OTHER :

      Other function.

    • DATE :

      Date processing function.

    • AGGREGATE :

      Aggregate functions.

    • STRING :

      String processing function.

    • ANALYTIC :

      Window function.

    • MATH :

      Mathematical operation function.

    STRING
    ClassName

    string

    Yes

    The name of the class where the function is defined, which corresponds to the Class Name field in the Create Function form.

    com.alibaba.DataWorks.api.udf.StringConcat
    Resources

    string

    Yes

    The list of resource names referenced by the function, separated by commas (,). This corresponds to the resources field in the Create Function form.

    string-concat-1.0.0.jar,commons-lang-2.6.jar
    UdfDescription

    string

    No

    The description of the function purpose, which corresponds to the Description field in the Create Function form.

    Concatenate several strings to generate a new string
    CmdDescription

    string

    No

    The command format for calling the function, which corresponds to the Command Format field in the Create Function form.

    StringConcat(String... substrs)
    ParameterDescription

    string

    No

    The description of the function input parameters, which corresponds to the metric description field in the Create Function form.

    List of strings to be connected
    ReturnValue

    string

    No

    The description of the function return value, which corresponds to the Return Value field in the Create Function form.

    New strings generated by concatenating all strings before and after the input order
    Example

    string

    No

    The example of calling the function, which corresponds to the Example field in the Create Function form.

    StringConcat('a', 'b', 'c')
    ProjectIdentifier

    string

    No

    The unique identifier of the DataWorks workspace, which is the English identifier displayed in the workspace switcher at the top of the DataStudio page.

    You must specify either this parameter or the ProjectId parameter to determine the DataWorks workspace for this API call.

    dw_project
    FileId

    string

    Yes

    The ID of the file.

    1000000112

    Response elements

    Element

    Type

    Description

    Example

    object

    HttpStatusCode

    integer

    The HTTP status code.

    200
    ErrorMessage

    string

    The error message.

    The connection does not exist.
    RequestId

    string

    The unique ID of the request. You can use this ID to troubleshoot issues.

    0000-ABCD-EFG****
    ErrorCode

    string

    The error code.

    Invalid.Tenant.ConnectionNotExists
    Success

    boolean

    Indicates whether the call was successful.

    true

    Examples

    Success response

    JSON format

    {
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "0000-ABCD-EFG****",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    500 InternalError.System An internal system error occurred. Try again later.
    500 InternalError.UserId.Missing An internal system error occurred. Try again later.
    403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. No permission, please authorize
    429 Throttling.Api The request for this resource has exceeded your available limit.
    429 Throttling.System The DataWorks system is busy. Try again later.
    429 Throttling.User Your request is too frequent. Try again later.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.