All Products
Search

This Product

    Ticket System API:GetAttachmentUploadUrl

    Document Center

    Ticket System API:GetAttachmentUploadUrl

    Last Updated:Mar 30, 2026

    Queries the Object Storage Service (OSS) URL that is used to upload attachments.

    Operation description

    Note

    Attachment upload

    • Use a presigned URL to upload the file. For more information, see the OSS documentation.

    After you obtain the temporary upload URL, you can upload the file as follows:

    Sample

    curl -X PUT -H "Content-Type:application/octet-stream" -H "x-oss-meta-author:aliy" -T /home/admin/file.png "https://xx.oss-cn-zhangjiakou.aliyuncs.com/xx/xx.png"

    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
    FileName

    string

    Yes

    Name of the uploaded file

    81A0D93D-54D7-4529-ABFA-633ED63223BA.jpg

    Response elements

    Element

    Type

    Description

    Example

    object

    Code

    integer

    The response code.

    0
    Message

    string

    The error message. If success is set to false, the message is returned.

    success
    RequestId

    string

    The request ID.

    ED195C2C-787F-511C-8204-714456781861
    Success

    boolean

    Indicates whether the call is successful. A value of true indicates that the call is normal.

    true
    Data

    object

    The data returned after the call succeeds.

    ObjectKey

    string

    Uploaded file identifier

    cdb5d174-c282-4b2d-9048-e74ea2223127.jpg
    PutSignedUrl

    string

    The signed URL used to upload the object to OSS.

    https://workorder.oss-cn-beijing.aliyuncs.com /20220314/cabb80c3-430b-4079-a9f2-d2a0d1c2a587.png?Expires=1647328689&OSSAccessKeyId=LTAI***************&Signature=AbSEh26G3oYrJ8ivr4B0xzF89zk%3D
    GetSignedUrl

    string

    Query the signed URL of an OSS object

    https://workorder.oss-cn-beijing.aliyuncs.com /20220314/cabb80c3-430b-4079-a9f2-d2a0d1c2a587.png?Expires=1647328689&OSSAccessKeyId=LTAI**************&Signature=AbSEh26G3oYrJ8ivr4B0xzF89zk%3D

    Examples

    Success response

    JSON format

    {
  "Code": 0,
  "Message": "success",
  "RequestId": "ED195C2C-787F-511C-8204-714456781861",
  "Success": true,
  "Data": {
    "ObjectKey": "cdb5d174-c282-4b2d-9048-e74ea2223127.jpg",
    "PutSignedUrl": "https://workorder.oss-cn-beijing.aliyuncs.com\n/20220314/cabb80c3-430b-4079-a9f2-d2a0d1c2a587.png?Expires=1647328689&OSSAccessKeyId=LTAI***************&Signature=AbSEh26G3oYrJ8ivr4B0xzF89zk%3D",
    "GetSignedUrl": "https://workorder.oss-cn-beijing.aliyuncs.com\n/20220314/cabb80c3-430b-4079-a9f2-d2a0d1c2a587.png?Expires=1647328689&OSSAccessKeyId=LTAI**************&Signature=AbSEh26G3oYrJ8ivr4B0xzF89zk%3D"
  }
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 param.illegal Params illegal.
    401 illegal.auth You are not authorized to perform the operation. You are not authorized to perform this operation.
    500 System.error An error occurred while processing your request. An error occurred while processing your request. Please try again.
    403 No permissions No permissions to access. RAM authentication does not have permission

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.