调用CreateSavepoint创建一个作业快照。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

名称 类型 是否必选 示例 描述
workspace String 是 a14bd5d90a****

工作空间ID。

请求语法

POST /api/v2/namespaces/{namespace}/savepoints HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
namespace String Path 是 default-namespace

项目空间名称。
Object Body 否

触发savepoint参数。
deploymentId String Body 是 58718c99-3b29-4c5e-93bb-c9fc4ec6****

作业ID。
description String Body 否 作业快照描述

savepoint描述信息。
nativeFormat Boolean Body 否 true

是否使用nativeFormat模式：

  • true：使用
  • false：不使用

返回数据

名称 类型 示例值 描述
requestId String CBC799F0-AS7S-1D30-8A4F-882ED4DD****

请求ID。
success Boolean true

表示业务请求是否成功。
httpCode Integer 200

固定值200。
errorCode String ""
  • 当success为false，返回业务错误码；
  • 当success为true，返回空值。
errorMessage String ""
  • 当success为false，返回业务错误信息；
  • 当success为true，返回空值。
data Savepoint
  • 当success为true，返回触发成功的savepoint信息；
  • 当success为false，返回空值。

示例

请求示例

POST /api/v2/namespaces/default-namespace/savepoints HTTP/1.1
Host:ververica.aliyuncs.com
workspace:a14bd5d90a****
Content-Type:application/json

{
  "deploymentId" : "58718c99-3b29-4c5e-93bb-c9fc4ec6****",
  "description" : "作业快照描述",
  "nativeFormat" : true
}

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateSavepointResponse>
    <requestId>CBC799F0-AS7S-1D30-8A4F-882ED4DD****</requestId>
    <success>true</success>
    <httpCode>200</httpCode>
    <errorCode>""</errorCode>
    <errorMessage>""</errorMessage>
    <data>
        <savepointId>354dde66-a3ae-463e-967a-0b4107fd****</savepointId>
        <deploymentId>1d716b22-6aad-4be2-85c2-50cfc757****</deploymentId>
        <jobId>5af678c0-7db0-4650-94c2-d2604f0a****</jobId>
        <namespace>namespacetest</namespace>
        <savepointOrigin>USER_REQUEST</savepointOrigin>
        <nativeFormat>true</nativeFormat>
        <stopWithDrainEnabled>true</stopWithDrainEnabled>
        <savepointLocation>https://oss/bucket/flink/flink-jobs/namespaces/vvp-team/deployments/5a19a71b-1c42-4f34-94fd-86cf6078****/checkpoints/sp-3285</savepointLocation>
        <status>
            <state>COMPLETED</state>
        </status>
        <createdAt>1659066711</createdAt>
        <modifiedAt>1659069473</modifiedAt>
    </data>
</CreateSavepointResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "requestId" : "CBC799F0-AS7S-1D30-8A4F-882ED4DD****",
  "success" : true,
  "httpCode" : 200,
  "errorCode" : "\"\"",
  "errorMessage" : "\"\"",
  "data" : {
    "savepointId" : "354dde66-a3ae-463e-967a-0b4107fd****",
    "deploymentId" : "1d716b22-6aad-4be2-85c2-50cfc757****",
    "jobId" : "5af678c0-7db0-4650-94c2-d2604f0a****",
    "namespace" : "namespacetest",
    "savepointOrigin" : "USER_REQUEST",
    "nativeFormat" : true,
    "stopWithDrainEnabled" : true,
    "savepointLocation" : "https://oss/bucket/flink/flink-jobs/namespaces/vvp-team/deployments/5a19a71b-1c42-4f34-94fd-86cf6078****/checkpoints/sp-3285",
    "status" : {
      "state" : "COMPLETED"
    },
    "createdAt" : 1659066711,
    "modifiedAt" : 1659069473
  }
}