Samza附录二 任务资源

该资源公开端点以支持任务范围内的操作。初始实现包括列出特定作业的所有任务的能力。这是“ 工作资源”的子资源，不能单独使用。

各个端点的响应将根据其功能和范围而有所不同。但是，所有任务的资源端点的错误消息将具有以下形式。

错误信息

每个错误响应将具有以下结构：

{
    "message": "Unrecognized status parameter: null"
}

message 是响应中唯一的字段，并包含对该问题的描述。 

获取所有任务

列出有关特定作业的所有任务的完整详细信息

请求

GET /v1/jobs/{jobName}/{jobId}/tasks

响应

状态：200 OK

[
{
   "preferredHost" : "samza-preferredHost",
   "taskName" : "Samza task",
   "containerId" : "0",
   "partitions" : [{
                      "system" : "kafka",
                      "stream" : "topic-name",
                      "partitionId" : "0"
                    }]
 }
 ]

响应码

{
    "message": "Invalid arguments for getTasks. jobName: SamzaJobName jobId: SamzaJobId."
}

{
    "message": "Timeout waiting for get all tasks."
}

设计

抽象

TasksResource 需要两个主要抽象，用户可以通过这些抽象来处理特定于其环境的任何细节。

1. TaskProxy：这个接口是与 Samza 任务交互的中心点。它暴露了一种方法来获得 Samza 工作的所有任务。
2. InstallationFinder：InstallationFinder 提供了一个通用接口，用于发现所有安装的作业，在作业包结构及其位置隐藏任何自定义。InstallationFinder 还解决了用于验证和识别作业的作业配置。

组态

应该在与 Samza REST 配置相同的文件中指定 TasksResource 属性。

org.apache.samza.rest.proxy.task.SamzaTaskProxy

SimpleInstallationRecord

org.apache.samza.config.factories.PropertiesConfigFactory