-
Notifications
You must be signed in to change notification settings - Fork 623
/
api_op_StartImportLabelsTaskRun.go
159 lines (133 loc) · 5.49 KB
/
api_op_StartImportLabelsTaskRun.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
package glue
import (
"context"
"github.com/aws/aws-sdk-go-v2/aws"
"github.com/aws/aws-sdk-go-v2/internal/awsutil"
)
type StartImportLabelsTaskRunInput struct {
_ struct{} `type:"structure"`
// The Amazon Simple Storage Service (Amazon S3) path from where you import
// the labels.
//
// InputS3Path is a required field
InputS3Path *string `type:"string" required:"true"`
// Indicates whether to overwrite your existing labels.
ReplaceAllLabels *bool `type:"boolean"`
// The unique identifier of the machine learning transform.
//
// TransformId is a required field
TransformId *string `min:"1" type:"string" required:"true"`
}
// String returns the string representation
func (s StartImportLabelsTaskRunInput) String() string {
return awsutil.Prettify(s)
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *StartImportLabelsTaskRunInput) Validate() error {
invalidParams := aws.ErrInvalidParams{Context: "StartImportLabelsTaskRunInput"}
if s.InputS3Path == nil {
invalidParams.Add(aws.NewErrParamRequired("InputS3Path"))
}
if s.TransformId == nil {
invalidParams.Add(aws.NewErrParamRequired("TransformId"))
}
if s.TransformId != nil && len(*s.TransformId) < 1 {
invalidParams.Add(aws.NewErrParamMinLen("TransformId", 1))
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
type StartImportLabelsTaskRunOutput struct {
_ struct{} `type:"structure"`
// The unique identifier for the task run.
TaskRunId *string `min:"1" type:"string"`
}
// String returns the string representation
func (s StartImportLabelsTaskRunOutput) String() string {
return awsutil.Prettify(s)
}
const opStartImportLabelsTaskRun = "StartImportLabelsTaskRun"
// StartImportLabelsTaskRunRequest returns a request value for making API operation for
// AWS Glue.
//
// Enables you to provide additional labels (examples of truth) to be used to
// teach the machine learning transform and improve its quality. This API operation
// is generally used as part of the active learning workflow that starts with
// the StartMLLabelingSetGenerationTaskRun call and that ultimately results
// in improving the quality of your machine learning transform.
//
// After the StartMLLabelingSetGenerationTaskRun finishes, AWS Glue machine
// learning will have generated a series of questions for humans to answer.
// (Answering these questions is often called 'labeling' in the machine learning
// workflows). In the case of the FindMatches transform, these questions are
// of the form, “What is the correct way to group these rows together into
// groups composed entirely of matching records?” After the labeling process
// is finished, users upload their answers/labels with a call to StartImportLabelsTaskRun.
// After StartImportLabelsTaskRun finishes, all future runs of the machine learning
// transform use the new and improved labels and perform a higher-quality transformation.
//
// By default, StartMLLabelingSetGenerationTaskRun continually learns from and
// combines all labels that you upload unless you set Replace to true. If you
// set Replace to true, StartImportLabelsTaskRun deletes and forgets all previously
// uploaded labels and learns only from the exact set that you upload. Replacing
// labels can be helpful if you realize that you previously uploaded incorrect
// labels, and you believe that they are having a negative effect on your transform
// quality.
//
// You can check on the status of your task run by calling the GetMLTaskRun
// operation.
//
// // Example sending a request using StartImportLabelsTaskRunRequest.
// req := client.StartImportLabelsTaskRunRequest(params)
// resp, err := req.Send(context.TODO())
// if err == nil {
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/StartImportLabelsTaskRun
func (c *Client) StartImportLabelsTaskRunRequest(input *StartImportLabelsTaskRunInput) StartImportLabelsTaskRunRequest {
op := &aws.Operation{
Name: opStartImportLabelsTaskRun,
HTTPMethod: "POST",
HTTPPath: "/",
}
if input == nil {
input = &StartImportLabelsTaskRunInput{}
}
req := c.newRequest(op, input, &StartImportLabelsTaskRunOutput{})
return StartImportLabelsTaskRunRequest{Request: req, Input: input, Copy: c.StartImportLabelsTaskRunRequest}
}
// StartImportLabelsTaskRunRequest is the request type for the
// StartImportLabelsTaskRun API operation.
type StartImportLabelsTaskRunRequest struct {
*aws.Request
Input *StartImportLabelsTaskRunInput
Copy func(*StartImportLabelsTaskRunInput) StartImportLabelsTaskRunRequest
}
// Send marshals and sends the StartImportLabelsTaskRun API request.
func (r StartImportLabelsTaskRunRequest) Send(ctx context.Context) (*StartImportLabelsTaskRunResponse, error) {
r.Request.SetContext(ctx)
err := r.Request.Send()
if err != nil {
return nil, err
}
resp := &StartImportLabelsTaskRunResponse{
StartImportLabelsTaskRunOutput: r.Request.Data.(*StartImportLabelsTaskRunOutput),
response: &aws.Response{Request: r.Request},
}
return resp, nil
}
// StartImportLabelsTaskRunResponse is the response type for the
// StartImportLabelsTaskRun API operation.
type StartImportLabelsTaskRunResponse struct {
*StartImportLabelsTaskRunOutput
response *aws.Response
}
// SDKResponseMetdata returns the response metadata for the
// StartImportLabelsTaskRun request.
func (r *StartImportLabelsTaskRunResponse) SDKResponseMetdata() *aws.Response {
return r.response
}