

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 SageMaker API 创建流式标签 Job
<a name="sms-streaming-create-labeling-job-api"></a>

以下是一个 [Amazon Python SDK (Boto3) 请求示例](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_labeling_job)，您可以使用该请求在美国东部（弗吉尼亚州北部）区域为内置任务类型启动流式标注作业。有关以下每个参数的更多详细信息，请参阅 [https://docs.amazonaws.cn/sagemaker/latest/APIReference/API_CreateLabelingJob.html](https://docs.amazonaws.cn/sagemaker/latest/APIReference/API_CreateLabelingJob.html)。要了解如何使用此 API 和相关语言创建标签任务 SDKs，请参阅[创建标签作业 (API)](https://docs.amazonaws.cn/sagemaker/latest/dg/sms-create-labeling-job-api.html)。

在此示例中，请注意以下参数：
+ `SnsDataSource` – 此参数出现在 `InputConfig` 和 `OutputConfig` 中，分别用于标识输入和输出 Amazon SNS 主题。要创建流式标注作业，您需要提供 Amazon SNS 输入主题。您还可以选择提供 Amazon SNS 输出主题。
+ `S3DataSource` – 此参数为可选参数。如果您想在标注作业开始后立即包括要标注的数据对象的输入清单文件，请使用此参数。
+ [https://docs.amazonaws.cn/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-StoppingConditions](https://docs.amazonaws.cn/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-StoppingConditions) – 创建流式标注作业时，将忽略此参数。要了解有关停止流式标注作业的更多信息，请参阅[停止流式标注作业](sms-streaming-stop-labeling-job.md)。
+ 流式标注作业不支持自动数据标注。不要包括 `LabelingJobAlgorithmsConfig` 参数。

```
response = client.create_labeling_job(
    LabelingJobName= '{{example-labeling-job}}',
    LabelAttributeName='label',
    InputConfig={
        'DataSource': {
            'S3DataSource': {
                'ManifestS3Uri': '{{s3://bucket/path/manifest-with-input-data.json}}'
            },
            'SnsDataSource': {
                'SnsTopicArn': '{{arn:aws:sns:us-east-1:123456789012:your-sns-input-topic}}'
            }
        },
        'DataAttributes': {
            'ContentClassifiers': [
                'FreeOfPersonallyIdentifiableInformation'|'FreeOfAdultContent',
            ]
        }
    },
    OutputConfig={
        'S3OutputPath': '{{s3://bucket/path/file-to-store-output-data}}',
        'KmsKeyId': 'string',
        'SnsTopicArn': '{{arn:aws:sns:us-east-1:123456789012:your-sns-output-topic}}'
    },
    RoleArn='{{arn:aws:iam::*:role/*}}',
    LabelCategoryConfigS3Uri='{{s3://bucket/path/label-categories.json}}',
    HumanTaskConfig={
        'WorkteamArn': '{{arn:aws:sagemaker:us-east-1:*:workteam/private-crowd/*}}',
        'UiConfig': {
            'UiTemplateS3Uri': '{{s3://bucket/path/custom-worker-task-template.html}}'
        },
        'PreHumanTaskLambdaArn': 'arn:aws:lambda:us-east-1:432418664414:function:PRE-{{tasktype}}',
        'TaskKeywords': [
            '{{Example key word}}',
        ],
        'TaskTitle': '{{Multi-label image classification task}}',
        'TaskDescription': '{{Select all labels that apply to the images shown}}',
        'NumberOfHumanWorkersPerDataObject': {{123}},
        'TaskTimeLimitInSeconds': {{123}},
        'TaskAvailabilityLifetimeInSeconds': {{123}},
        'MaxConcurrentTaskCount': {{123}},
        'AnnotationConsolidationConfig': {
            'AnnotationConsolidationLambdaArn': 'arn:aws:lambda:us-east-1:432418664414:function:ACS-{{tasktype}}'
            }
        },
    Tags=[
        {
            'Key': '{{string'}},
            'Value': '{{string}}'
        },
    ]
)
```