全部產品
Search
文件中心

Realtime Compute for Apache Flink:StartJobWithParams - 啟動工作執行個體

更新時間:May 28, 2026

啟動一個工作執行個體。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

stream:StartJobWithParams

none

*全部資源

*

請求文法

POST /api/v2/namespaces/{namespace}/jobs:start HTTP/1.1

路徑參數

名稱

類型

必填

描述

樣本值

namespace

string

專案空間名稱。

default-namespace

請求參數

名稱

類型

必填

描述

樣本值

workspace

string

工作空間 ID。

a14bd5d90a****

body JobStartParameters

工作執行個體啟動參數。

返回參數

名稱

類型

描述

樣本值

object

響應資料。

requestId

string

請求 ID。

CBC799F0-AS7S-1D30-8A4F-882ED4DD****

success

boolean

表示業務請求是否成功。

true

httpCode

integer

業務狀態代碼,統一為 200;使用 success 表示業務請求是否成功。

200

errorCode

string

當 success 為 false 時,該值不為空白,表示業務錯誤碼;當 success 為 true 時,該值為空白。

""

errorMessage

string

當 success 為 false 時,該值不為空白,表示業務錯誤資訊;當 success 為 true 時,該值為空白。

""

data Job

本資料結構代表已部署作業產生的執行個體詳情。

accessDeniedDetail

string

樣本

正常返回樣本

JSON格式

{
  "requestId": "CBC799F0-AS7S-1D30-8A4F-882ED4DD****\n",
  "success": true,
  "httpCode": 200,
  "errorCode": "\"\"",
  "errorMessage": "\"\"",
  "data": {
    "jobId": "354dde66-a3ae-463e-967a-0b4107fd****",
    "deploymentId": "354dde66-a3ae-463e-967a-0b4107fd****",
    "deploymentName": "flinktest",
    "namespace": "namespacetest",
    "executionMode": "BATCH",
    "creator": "27846363877456****",
    "creatorName": "****@streamcompute.onaliyun.com",
    "modifier": "27846363877456****",
    "modifierName": "****@streamcompute.onaliyun.com",
    "startTime": 1660190835,
    "endTime": 1660277235,
    "engineVersion": "vvr-4.0.14-flink-1.13",
    "flinkConf": {
      "test": "test",
      "test2": 1
    },
    "status": {
      "running": {
        "observedFlinkJobRestarts": 4,
        "observedFlinkJobStatus": "RUNNING"
      },
      "riskLevel": "",
      "failure": {
        "message": "Kubernetes deployment resource with name job-8b7db913-5b1f-4ac5-a332-8d50f342**** is not progressing.",
        "reason": "KubernetesDeploymentNotProgressing",
        "failedAt": 1660120062
      },
      "currentJobStatus": "RUNNING",
      "healthScore": 0
    },
    "metric": {
      "totalMemoryByte": 4096,
      "totalCpu": 2
    },
    "sessionClusterName": "null",
    "artifact": {
      "sqlArtifact": {
        "sqlScript": "CREATE TEMPORARY TABLE datagen_source(   name VARCHAR ) WITH (   'connector' = 'datagen' ); CREATE TEMPORARY TABLE blackhole_sink(   name  VARCHAR ) with (   'connector' = 'blackhole' ); INSERT INTO blackhole_sink SELECT name from datagen_source;",
        "additionalDependencies": [
          "https://oss/bucket/addition.jar"
        ]
      },
      "jarArtifact": {
        "jarUri": "https://oss/bucket/test.jar",
        "entryClass": "org.apapche.flink.test",
        "mainArgs": "start from main",
        "additionalDependencies": [
          "https://oss/bucket/addition.jar"
        ]
      },
      "pythonArtifact": {
        "pythonArtifactUri": "https://oss/bucket/test.py",
        "mainArgs": "start from main",
        "entryModule": "test.py",
        "additionalDependencies": [
          "https://oss/bucket/addition.py"
        ],
        "additionalPythonLibraries": [
          "https://oss/bucket/additionlib.py"
        ],
        "additionalPythonArchives": [
          "https://oss/bucket/additionArchives.zip"
        ]
      },
      "cdcYamlArtifact": {
        "cdcYaml": "",
        "additionalDependencies": [
          ""
        ]
      },
      "kind": "SQLSCRIPT"
    },
    "logging": {
      "loggingProfile": "default",
      "log4j2ConfigurationTemplate": "xml格式文本",
      "log4jLoggers": [
        {
          "loggerName": "StdOutErrConsoleAppender",
          "loggerLevel": "ERROR"
        }
      ],
      "logReservePolicy": {
        "openHistory": true,
        "expirationDays": 7
      }
    },
    "batchResourceSetting": {
      "maxSlot": 10,
      "basicResourceSetting": {
        "parallelism": 4,
        "jobmanagerResourceSettingSpec": {
          "cpu": 2,
          "memory": "4 GiB"
        },
        "taskmanagerResourceSettingSpec": {
          "cpu": 2,
          "memory": "4 GiB"
        }
      }
    },
    "streamingResourceSetting": {
      "resourceSettingMode": "EXPERT",
      "expertResourceSetting": {
        "jobmanagerResourceSettingSpec": {
          "cpu": 2,
          "memory": "4 GiB"
        },
        "resourcePlan": "{\\\"ssgProfiles\\\":[{\\\"name\\\":\\\"default\\\",\\\"cpu\\\":1.13,\\\"heap\\\":\\\"1 gb\\\",\\\"offHeap\\\":\\\"32 mb\\\",\\\"managed\\\":{},\\\"extended\\\":{}}],\\\"nodes\\\":[{\\\"id\\\":1,\\\"type\\\":\\\"StreamExecTableSourceScan\\\",\\\"desc\\\":\\\"Source: datagen_source[78]\\\",\\\"profile\\\":{\\\"group\\\":\\\"default\\\",\\\"parallelism\\\":1,\\\"maxParallelism\\\":32768,\\\"minParallelism\\\":1}},{\\\"id\\\":2,\\\"type\\\":\\\"StreamExecSink\\\",\\\"desc\\\":\\\"Sink: blackhole_sink[79]\\\",\\\"profile\\\":{\\\"group\\\":\\\"default\\\",\\\"parallelism\\\":1,\\\"maxParallelism\\\":32768,\\\"minParallelism\\\":1}}],\\\"edges\\\":[{\\\"source\\\":1,\\\"target\\\":2,\\\"mode\\\":\\\"PIPELINED\\\",\\\"strategy\\\":\\\"FORWARD\\\"}],\\\"vertices\\\":{\\\"717c7b8afebbfb7137f6f0f99beb2a94\\\":[1,2]}}"
      },
      "basicResourceSetting": {
        "parallelism": 4
      }
    },
    "restoreStrategy": {
      "kind": "LATEST_STATE",
      "allowNonRestoredState": true,
      "jobStartTimeInMs": 1660293803155,
      "savepointId": "354dde66-a3ae-463e-967a-0b4107fd****"
    },
    "userFlinkConf": {
      "taskmanager.numberOfTaskSlots": "1",
      "table.exec.state.ttl": "128000s"
    },
    "localVariables": [
      {
        "name": "test",
        "value": "datagen"
      }
    ],
    "workspace": "edcef******b4f",
    "createdAt": "1714058507",
    "modifiedAt": "1714058800"
  },
  "accessDeniedDetail": ""
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情