日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

SubmitSnapshotJob - 提交截圖作業

提交截圖作業。調用本接口之后媒體處理MPS會對輸入文件進行截圖和拼圖。

接口說明

  • 輸入單個文件大小最大支持 100 GB,超過可能導致執行失敗。

  • 請確認文件已成功上傳至 OSS 后再提交截圖作業,否則會導致執行失敗。您可通過配置 OSS 回調消息確認文件上傳狀態。

  • 截圖作業分為同步和異步模式。

    • 同步模式僅支持單張截圖,會在接口返回時生成圖片。
    • 異步模式不保證時效性,在提交截圖作業后,任務會添加到管道中排隊,被調度執行。所以在接口返回時,不保證截圖已經生成。執行完成后需要調用查詢截圖作業結果接口輪詢執行結果,或通過為管道綁定 MNS 消息接收執行結果,具體請參見接收消息通知
    • 只要設置了 IntervalNum 中的任何一個參數,就表示使用異步模式。
  • 目前僅支持生成 JPG 格式圖片。

  • 更多截圖常見問題,請參見截圖常見問題

QPS 限制

本接口的單用戶 QPS 限制為 50 次/秒。超過限制,API 調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見 QPS 限制

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
mts:SubmitSnapshotJobcreate
  • 全部資源
    *

請求參數

名稱類型必填描述示例值
Inputstring

作業輸入。詳細說明請參見 Input 詳情

說明
  • 在媒體處理 API 中,Object 必須經過URL Encoding(基于 UTF-8 編碼)后使用。
    • OSS 的地域需要與當前 MPS 所在地域保持一致。
    {"Bucket":"example-bucket","Location":"example-location","Object":"example%2Ftest.flv"}
    SnapshotConfigstring

    截圖配置。詳細說明,請參見 SnapshotConfig 參數詳情

    {"OutputFile":{"Bucket":"example-001","Location":"example-location","Object":"{Count}.jpg"},"Time":"5","Num":"10","Interval":"20"}
    UserDatastring

    用戶自定義數據。支持中英文、數字、短劃線(-),不能以特殊字符開頭,最大長度 1024 個字節。

    testid-001
    PipelineIdstring

    管道 ID,詳細說明,請參見基本概念

    • 可選值:可以通過 MPS 控制臺 > 全局設置 > 管道查詢和創建管道。
    • 如果需要異步通知,請為管道綁定 MNS 消息,具體請參見接收消息通知
    dd3dae411e704030b921e52698e5****

    返回參數

    名稱類型描述示例值
    object

    返回參數。

    RequestIdstring

    請求 ID。

    19B6D8C5-A5DD-467A-B435-29D393C71E2D
    SnapshotJobobject

    截圖作業。

    CreationTimestring

    任務創建時間。

    2021-05-19T03:11:48Z
    SnapshotConfigobject

    截圖配置。

    Timestring

    截圖開始時間。單位:毫秒。

    5
    TileOutobject

    拼圖配置。

    Paddingstring

    圖片間距。

    • 默認:0

    • 單位:px。

    0
    Colorstring

    背景顏色。

    • 默認:black
    • 可取值范圍:顏色關鍵字random
    說明 其中顏色關鍵字支持三種格式,比如黑色,支持 Black,black,#000000。
    black
    CellSelStepstring

    選取單圖片步長。

    3
    CellHeightstring

    單圖片高度。默認截圖輸出分辨率高度。

    100
    CellWidthstring

    單圖片寬度。默認截圖輸出分辨率寬度。

    100
    Marginstring

    外框寬度。

    • 默認:0

    • 單位:px。

    5
    Columnsstring

    圖片拼合列數。默認:10

    10
    IsKeepCellPicstring

    是否保留單圖片。可取值:

    • true:保留。

    • false:不保留。

    • 默認:true

    false
    Linesstring

    圖片拼合行數。默認:10

    10
    Intervalstring

    截圖間隔時間。

    • 若指定則表示序列截圖,且值大于 0。
    • 單位:秒。
    • 默認值:10
    20
    FrameTypestring

    截圖類型。默認值:normal。可取值:

    • normal:普通幀。
    • intra:I 幀(關鍵幀)。
    說明 如果請求參數中將 FrameType 參數設置為 I 幀(關鍵幀),將只截取關鍵幀。如果指定的時間節點為非關鍵幀,則就近選取關鍵幀。在同等截圖規則下,關鍵幀截圖比普通幀截圖速度快。
    intra
    Widthstring

    截圖輸出圖片寬度。

    8
    Heightstring

    截圖輸出圖片高度。

    8
    OutputFileobject

    截圖輸出 OSS 配置。

    RoleArnstring

    指定角色的 ARN。格式:acs:ram::$accountID:role/$roleName。

    acs:ram::1:role/testrole
    Objectstring

    截圖輸出文件(OSS Object)。

    test.png
    Locationstring

    截圖輸出 OSS Bucket 所在數據中心(OSS Location)。

    example-location
    Bucketstring

    截圖輸出文件所在 OSS Bucket。

    example
    Numstring

    截圖數量。若指定則表示序列截圖。

    10
    TileOutputFileobject

    拼圖任務大圖的輸出 OSS 配置。

    RoleArnstring

    指定角色的 ARN。格式:acs:ram::$accountID:role/$roleName。

    acs:ram::1:role/testrole
    Objectstring

    輸出文件 (OSS Object)。

    example.png
    Locationstring

    輸出 OSS Bucket 所在數據中心(OSS Location)。

    example-location
    Bucketstring

    輸出文件所在 OSS Bucket。

    example
    TimeArrayarray

    指定時間點數組。

    TimePointListlong

    指定時間點數組。單位毫秒,浮點數,保留 2 位小數,可重復,可無序提交,由 MPS 排序。最多 100 個時間點。指定該參數時,Num、Time、Interval 均不指定。如指定則提示參數指定錯誤 InvalidParameter.Ambiguity。

    [10050, 50000, 110000, 1000500, 1100500]
    Statestring

    截圖狀態。取值:

    • Submitted:已提交。

    • Snapshoting:截圖中。

    • Success:截圖成功。

    • Fail:截圖失敗。

    Snapshoting
    Messagestring

    分析失敗時錯誤信息。若成功則不返回此參數。

    The resource operated InputFile is bad
    MNSMessageResultobject

    MNS 通知用戶作業完成的結果。

    MessageIdstring

    成功時消息 ID。若失敗則不返回此參數。

    799454621135656C7F815F198A76****
    ErrorMessagestring

    失敗時錯誤信息。若成功則不返回此參數。

    The resource operated InputFile is bad
    ErrorCodestring

    失敗時錯誤碼。若成功則不返回此參數。

    InvalidParameter
    Inputobject

    作業輸入。

    RoleArnstring

    指定角色的 ARN。格式:acs:ram::$accountID:role/$roleName。

    acs:ram::1:role/testrole
    Objectstring

    輸入文件(OSS Object)。

    example.flv
    Locationstring

    輸入 OSS Bucket 所在數據中心(OSS Location)。

    example-location'
    Bucketstring

    輸入文件所在 OSS Bucket。

    example
    Countstring

    截取圖片的數量。

    1
    TileCountstring

    拼圖圖片數量。

    5
    UserDatastring

    用戶自定義數據。

    testid-001
    Codestring

    分析失敗時錯誤碼。若成功則不返回此參數。

    ResourceContentBad
    PipelineIdstring

    管道 ID。

    dd3dae411e704030b921e52698e5****
    Idstring

    截圖作業 ID。

    f4e3b9ba9f3840c39d6e288056f0****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "19B6D8C5-A5DD-467A-B435-29D393C71E2D",
      "SnapshotJob": {
        "CreationTime": "2021-05-19T03:11:48Z",
        "SnapshotConfig": {
          "Time": "5",
          "TileOut": {
            "Padding": "0",
            "Color": "black",
            "CellSelStep": "3",
            "CellHeight": "100",
            "CellWidth": "100",
            "Margin": "5",
            "Columns": "10",
            "IsKeepCellPic": "false",
            "Lines": "10"
          },
          "Interval": "20",
          "FrameType": "intra",
          "Width": "8",
          "Height": "8",
          "OutputFile": {
            "RoleArn": "acs:ram::1:role/testrole",
            "Object": "test.png",
            "Location": "example-location",
            "Bucket": "example"
          },
          "Num": "10",
          "TileOutputFile": {
            "RoleArn": "acs:ram::1:role/testrole",
            "Object": "example.png",
            "Location": "example-location",
            "Bucket": "example"
          },
          "TimeArray": {
            "TimePointList": [
              0
            ]
          }
        },
        "State": "Snapshoting",
        "Message": "The resource operated InputFile is bad",
        "MNSMessageResult": {
          "MessageId": "799454621135656C7F815F198A76****",
          "ErrorMessage": "The resource operated InputFile is bad",
          "ErrorCode": "InvalidParameter"
        },
        "Input": {
          "RoleArn": "acs:ram::1:role/testrole",
          "Object": "example.flv",
          "Location": "example-location'",
          "Bucket": "example"
        },
        "Count": "1",
        "TileCount": "5",
        "UserData": "testid-001",
        "Code": "ResourceContentBad",
        "PipelineId": "dd3dae411e704030b921e52698e5****",
        "Id": "f4e3b9ba9f3840c39d6e288056f0****"
      }
    }

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    變更時間變更內容概要操作
    2024-04-24OpenAPI 返回結構發生變更查看變更詳情
    2024-04-10API 內部配置變更,不影響調用查看變更詳情