aws-sdk-lookoutforvision 1.7.0 → 1.11.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
30
31
  require 'aws-sdk-core/plugins/signature_v4.rb'
31
32
  require 'aws-sdk-core/plugins/protocols/rest_json.rb'
32
33
 
@@ -73,6 +74,7 @@ module Aws::LookoutforVision
73
74
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
74
75
  add_plugin(Aws::Plugins::TransferEncoding)
75
76
  add_plugin(Aws::Plugins::HttpChecksum)
77
+ add_plugin(Aws::Plugins::DefaultsMode)
76
78
  add_plugin(Aws::Plugins::SignatureV4)
77
79
  add_plugin(Aws::Plugins::Protocols::RestJson)
78
80
 
@@ -119,7 +121,9 @@ module Aws::LookoutforVision
119
121
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
122
  # are very aggressive. Construct and pass an instance of
121
123
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
- # enable retries and extended timeouts.
124
+ # enable retries and extended timeouts. Instance profile credential
125
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
126
+ # to true.
123
127
  #
124
128
  # @option options [required, String] :region
125
129
  # The AWS region to connect to. The configured `:region` is
@@ -173,6 +177,10 @@ module Aws::LookoutforVision
173
177
  # Used only in `standard` and adaptive retry modes. Specifies whether to apply
174
178
  # a clock skew correction and retry requests with skewed client clocks.
175
179
  #
180
+ # @option options [String] :defaults_mode ("legacy")
181
+ # See {Aws::DefaultsModeConfiguration} for a list of the
182
+ # accepted modes and the configuration defaults that are included.
183
+ #
176
184
  # @option options [Boolean] :disable_host_prefix_injection (false)
177
185
  # Set to true to disable SDK automatically adding host prefix
178
186
  # to default service endpoint when available.
@@ -275,6 +283,15 @@ module Aws::LookoutforVision
275
283
  # ** Please note ** When response stubbing is enabled, no HTTP
276
284
  # requests are made, and retries are disabled.
277
285
  #
286
+ # @option options [Boolean] :use_dualstack_endpoint
287
+ # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
288
+ # will be used if available.
289
+ #
290
+ # @option options [Boolean] :use_fips_endpoint
291
+ # When set to `true`, fips compatible endpoints will be used if available.
292
+ # When a `fips` region is used, the region is normalized and this config
293
+ # is set to `true`.
294
+ #
278
295
  # @option options [Boolean] :validate_params (true)
279
296
  # When `true`, request parameters are validated before
280
297
  # sending the request.
@@ -286,7 +303,7 @@ module Aws::LookoutforVision
286
303
  # seconds to wait when opening a HTTP session before raising a
287
304
  # `Timeout::Error`.
288
305
  #
289
- # @option options [Integer] :http_read_timeout (60) The default
306
+ # @option options [Float] :http_read_timeout (60) The default
290
307
  # number of seconds to wait for response data. This value can
291
308
  # safely be set per-request on the session.
292
309
  #
@@ -302,6 +319,9 @@ module Aws::LookoutforVision
302
319
  # disables this behaviour. This value can safely be set per
303
320
  # request on the session.
304
321
  #
322
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
323
+ # in seconds.
324
+ #
305
325
  # @option options [Boolean] :http_wire_trace (false) When `true`,
306
326
  # HTTP debug output will be sent to the `:logger`.
307
327
  #
@@ -366,11 +386,17 @@ module Aws::LookoutforVision
366
386
  # @option params [String] :client_token
367
387
  # ClientToken is an idempotency token that ensures a call to
368
388
  # `CreateDataset` completes only once. You choose the value to pass. For
369
- # example, An issue, such as an network outage, might prevent you from
370
- # getting a response from `CreateDataset`. In this case, safely retry
371
- # your call to `CreateDataset` by using the same `ClientToken` parameter
372
- # value. An error occurs if the other input parameters are not the same
373
- # as in the first request. Using a different value for `ClientToken` is
389
+ # example, An issue might prevent you from getting a response from
390
+ # `CreateDataset`. In this case, safely retry your call to
391
+ # `CreateDataset` by using the same `ClientToken` parameter value.
392
+ #
393
+ # If you don't supply a value for `ClientToken`, the AWS SDK you are
394
+ # using inserts a value for you. This prevents retries after a network
395
+ # error from making multiple dataset creation requests. You'll need to
396
+ # provide your own value for other use cases.
397
+ #
398
+ # An error occurs if the other input parameters are not the same as in
399
+ # the first request. Using a different value for `ClientToken` is
374
400
  # considered a new call to `CreateDataset`. An idempotency token is
375
401
  # active for 8 hours.
376
402
  #
@@ -444,9 +470,15 @@ module Aws::LookoutforVision
444
470
  # @option params [String] :client_token
445
471
  # ClientToken is an idempotency token that ensures a call to
446
472
  # `CreateModel` completes only once. You choose the value to pass. For
447
- # example, An issue, such as an network outage, might prevent you from
448
- # getting a response from `CreateModel`. In this case, safely retry your
449
- # call to `CreateModel` by using the same `ClientToken` parameter value.
473
+ # example, An issue might prevent you from getting a response from
474
+ # `CreateModel`. In this case, safely retry your call to `CreateModel`
475
+ # by using the same `ClientToken` parameter value.
476
+ #
477
+ # If you don't supply a value for `ClientToken`, the AWS SDK you are
478
+ # using inserts a value for you. This prevents retries after a network
479
+ # error from starting multiple training jobs. You'll need to provide
480
+ # your own value for other use cases.
481
+ #
450
482
  # An error occurs if the other input parameters are not the same as in
451
483
  # the first request. Using a different value for `ClientToken` is
452
484
  # considered a new call to `CreateModel`. An idempotency token is active
@@ -460,11 +492,10 @@ module Aws::LookoutforVision
460
492
  # results.
461
493
  #
462
494
  # @option params [String] :kms_key_id
463
- # The identifier for your AWS Key Management Service (AWS KMS) customer
464
- # master key (CMK). The key is used to encrypt training and test images
465
- # copied into the service for model training. Your source images are
466
- # unaffected. If this parameter is not specified, the copied images are
467
- # encrypted by a key that AWS owns and manages.
495
+ # The identifier for your AWS KMS key. The key is used to encrypt
496
+ # training and test images copied into the service for model training.
497
+ # Your source images are unaffected. If this parameter is not specified,
498
+ # the copied images are encrypted by a key that AWS owns and manages.
468
499
  #
469
500
  # @option params [Array<Types::Tag>] :tags
470
501
  # A set of tags (key-value pairs) that you want to attach to the model.
@@ -527,11 +558,17 @@ module Aws::LookoutforVision
527
558
  # @option params [String] :client_token
528
559
  # ClientToken is an idempotency token that ensures a call to
529
560
  # `CreateProject` completes only once. You choose the value to pass. For
530
- # example, An issue, such as an network outage, might prevent you from
531
- # getting a response from `CreateProject`. In this case, safely retry
532
- # your call to `CreateProject` by using the same `ClientToken` parameter
533
- # value. An error occurs if the other input parameters are not the same
534
- # as in the first request. Using a different value for `ClientToken` is
561
+ # example, An issue might prevent you from getting a response from
562
+ # `CreateProject`. In this case, safely retry your call to
563
+ # `CreateProject` by using the same `ClientToken` parameter value.
564
+ #
565
+ # If you don't supply a value for `ClientToken`, the AWS SDK you are
566
+ # using inserts a value for you. This prevents retries after a network
567
+ # error from making multiple project creation requests. You'll need to
568
+ # provide your own value for other use cases.
569
+ #
570
+ # An error occurs if the other input parameters are not the same as in
571
+ # the first request. Using a different value for `ClientToken` is
535
572
  # considered a new call to `CreateProject`. An idempotency token is
536
573
  # active for 8 hours.
537
574
  #
@@ -595,11 +632,17 @@ module Aws::LookoutforVision
595
632
  # @option params [String] :client_token
596
633
  # ClientToken is an idempotency token that ensures a call to
597
634
  # `DeleteDataset` completes only once. You choose the value to pass. For
598
- # example, An issue, such as an network outage, might prevent you from
599
- # getting a response from `DeleteDataset`. In this case, safely retry
600
- # your call to `DeleteDataset` by using the same `ClientToken` parameter
601
- # value. An error occurs if the other input parameters are not the same
602
- # as in the first request. Using a different value for `ClientToken` is
635
+ # example, An issue might prevent you from getting a response from
636
+ # `DeleteDataset`. In this case, safely retry your call to
637
+ # `DeleteDataset` by using the same `ClientToken` parameter value.
638
+ #
639
+ # If you don't supply a value for `ClientToken`, the AWS SDK you are
640
+ # using inserts a value for you. This prevents retries after a network
641
+ # error from making multiple deletetion requests. You'll need to
642
+ # provide your own value for other use cases.
643
+ #
644
+ # An error occurs if the other input parameters are not the same as in
645
+ # the first request. Using a different value for `ClientToken` is
603
646
  # considered a new call to `DeleteDataset`. An idempotency token is
604
647
  # active for 8 hours.
605
648
  #
@@ -629,9 +672,11 @@ module Aws::LookoutforVision
629
672
  # running model. To stop a running model, use the StopModel operation.
630
673
  #
631
674
  # It might take a few seconds to delete a model. To determine if a model
632
- # has been deleted, call ListProjects and check if the version of the
675
+ # has been deleted, call ListModels and check if the version of the
633
676
  # model (`ModelVersion`) is in the `Models` array.
634
677
  #
678
+ #
679
+ #
635
680
  # This operation requires permissions to perform the
636
681
  # `lookoutvision:DeleteModel` operation.
637
682
  #
@@ -645,9 +690,15 @@ module Aws::LookoutforVision
645
690
  # @option params [String] :client_token
646
691
  # ClientToken is an idempotency token that ensures a call to
647
692
  # `DeleteModel` completes only once. You choose the value to pass. For
648
- # example, An issue, such as an network outage, might prevent you from
649
- # getting a response from `DeleteModel`. In this case, safely retry your
650
- # call to `DeleteModel` by using the same `ClientToken` parameter value.
693
+ # example, an issue might prevent you from getting a response from
694
+ # `DeleteModel`. In this case, safely retry your call to `DeleteModel`
695
+ # by using the same `ClientToken` parameter value.
696
+ #
697
+ # If you don't supply a value for ClientToken, the AWS SDK you are
698
+ # using inserts a value for you. This prevents retries after a network
699
+ # error from making multiple model deletion requests. You'll need to
700
+ # provide your own value for other use cases.
701
+ #
651
702
  # An error occurs if the other input parameters are not the same as in
652
703
  # the first request. Using a different value for `ClientToken` is
653
704
  # considered a new call to `DeleteModel`. An idempotency token is active
@@ -664,7 +715,7 @@ module Aws::LookoutforVision
664
715
  #
665
716
  # resp = client.delete_model({
666
717
  # project_name: "ProjectName", # required
667
- # model_version: "ModelVersion", # required
718
+ # model_version: "ModelVersionNoLatest", # required
668
719
  # client_token: "ClientToken",
669
720
  # })
670
721
  #
@@ -700,11 +751,17 @@ module Aws::LookoutforVision
700
751
  # @option params [String] :client_token
701
752
  # ClientToken is an idempotency token that ensures a call to
702
753
  # `DeleteProject` completes only once. You choose the value to pass. For
703
- # example, An issue, such as an network outage, might prevent you from
704
- # getting a response from `DeleteProject`. In this case, safely retry
705
- # your call to `DeleteProject` by using the same `ClientToken` parameter
706
- # value. An error occurs if the other input parameters are not the same
707
- # as in the first request. Using a different value for `ClientToken` is
754
+ # example, An issue might prevent you from getting a response from
755
+ # `DeleteProject`. In this case, safely retry your call to
756
+ # `DeleteProject` by using the same `ClientToken` parameter value.
757
+ #
758
+ # If you don't supply a value for `ClientToken`, the AWS SDK you are
759
+ # using inserts a value for you. This prevents retries after a network
760
+ # error from making multiple project deletion requests. You'll need to
761
+ # provide your own value for other use cases.
762
+ #
763
+ # An error occurs if the other input parameters are not the same as in
764
+ # the first request. Using a different value for `ClientToken` is
708
765
  # considered a new call to `DeleteProject`. An idempotency token is
709
766
  # active for 8 hours.
710
767
  #
@@ -834,6 +891,69 @@ module Aws::LookoutforVision
834
891
  req.send_request(options)
835
892
  end
836
893
 
894
+ # Describes an Amazon Lookout for Vision model packaging job.
895
+ #
896
+ # This operation requires permissions to perform the
897
+ # `lookoutvision:DescribeModelPackagingJob` operation.
898
+ #
899
+ # For more information, see *Using your Amazon Lookout for Vision model
900
+ # on an edge device* in the Amazon Lookout for Vision Developer Guide.
901
+ #
902
+ # @option params [required, String] :project_name
903
+ # The name of the project that contains the model packaging job that you
904
+ # want to describe.
905
+ #
906
+ # @option params [required, String] :job_name
907
+ # The job name for the model packaging job.
908
+ #
909
+ # @return [Types::DescribeModelPackagingJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
910
+ #
911
+ # * {Types::DescribeModelPackagingJobResponse#model_packaging_description #model_packaging_description} => Types::ModelPackagingDescription
912
+ #
913
+ # @example Request syntax with placeholder values
914
+ #
915
+ # resp = client.describe_model_packaging_job({
916
+ # project_name: "ProjectName", # required
917
+ # job_name: "ModelPackagingJobName", # required
918
+ # })
919
+ #
920
+ # @example Response structure
921
+ #
922
+ # resp.model_packaging_description.job_name #=> String
923
+ # resp.model_packaging_description.project_name #=> String
924
+ # resp.model_packaging_description.model_version #=> String
925
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.compiler_options #=> String
926
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.target_device #=> String, one of "jetson_xavier"
927
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.target_platform.os #=> String, one of "LINUX"
928
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.target_platform.arch #=> String, one of "ARM64", "X86_64"
929
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.target_platform.accelerator #=> String, one of "NVIDIA"
930
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.s3_output_location.bucket #=> String
931
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.s3_output_location.prefix #=> String
932
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.component_name #=> String
933
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.component_version #=> String
934
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.component_description #=> String
935
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.tags #=> Array
936
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.tags[0].key #=> String
937
+ # resp.model_packaging_description.model_packaging_configuration.greengrass.tags[0].value #=> String
938
+ # resp.model_packaging_description.model_packaging_job_description #=> String
939
+ # resp.model_packaging_description.model_packaging_method #=> String
940
+ # resp.model_packaging_description.model_packaging_output_details.greengrass.component_version_arn #=> String
941
+ # resp.model_packaging_description.model_packaging_output_details.greengrass.component_name #=> String
942
+ # resp.model_packaging_description.model_packaging_output_details.greengrass.component_version #=> String
943
+ # resp.model_packaging_description.status #=> String, one of "CREATED", "RUNNING", "SUCCEEDED", "FAILED"
944
+ # resp.model_packaging_description.status_message #=> String
945
+ # resp.model_packaging_description.creation_timestamp #=> Time
946
+ # resp.model_packaging_description.last_updated_timestamp #=> Time
947
+ #
948
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lookoutvision-2020-11-20/DescribeModelPackagingJob AWS API Documentation
949
+ #
950
+ # @overload describe_model_packaging_job(params = {})
951
+ # @param [Hash] params ({})
952
+ def describe_model_packaging_job(params = {}, options = {})
953
+ req = build_request(:describe_model_packaging_job, params)
954
+ req.send_request(options)
955
+ end
956
+
837
957
  # Describes an Amazon Lookout for Vision project.
838
958
  #
839
959
  # This operation requires permissions to perform the
@@ -1017,8 +1137,75 @@ module Aws::LookoutforVision
1017
1137
  req.send_request(options)
1018
1138
  end
1019
1139
 
1140
+ # Lists the model packaging jobs created for an Amazon Lookout for
1141
+ # Vision project.
1142
+ #
1143
+ # This operation requires permissions to perform the
1144
+ # `lookoutvision:ListModelPackagingJobs` operation.
1145
+ #
1146
+ # For more information, see *Using your Amazon Lookout for Vision model
1147
+ # on an edge device* in the Amazon Lookout for Vision Developer Guide.
1148
+ #
1149
+ # @option params [required, String] :project_name
1150
+ # The name of the project for which you want to list the model packaging
1151
+ # jobs.
1152
+ #
1153
+ # @option params [String] :next_token
1154
+ # If the previous response was incomplete (because there is more results
1155
+ # to retrieve), Amazon Lookout for Vision returns a pagination token in
1156
+ # the response. You can use this pagination token to retrieve the next
1157
+ # set of results.
1158
+ #
1159
+ # @option params [Integer] :max_results
1160
+ # The maximum number of results to return per paginated call. The
1161
+ # largest value you can specify is 100. If you specify a value greater
1162
+ # than 100, a ValidationException error occurs. The default value is
1163
+ # 100.
1164
+ #
1165
+ # @return [Types::ListModelPackagingJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1166
+ #
1167
+ # * {Types::ListModelPackagingJobsResponse#model_packaging_jobs #model_packaging_jobs} => Array&lt;Types::ModelPackagingJobMetadata&gt;
1168
+ # * {Types::ListModelPackagingJobsResponse#next_token #next_token} => String
1169
+ #
1170
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1171
+ #
1172
+ # @example Request syntax with placeholder values
1173
+ #
1174
+ # resp = client.list_model_packaging_jobs({
1175
+ # project_name: "ProjectName", # required
1176
+ # next_token: "PaginationToken",
1177
+ # max_results: 1,
1178
+ # })
1179
+ #
1180
+ # @example Response structure
1181
+ #
1182
+ # resp.model_packaging_jobs #=> Array
1183
+ # resp.model_packaging_jobs[0].job_name #=> String
1184
+ # resp.model_packaging_jobs[0].project_name #=> String
1185
+ # resp.model_packaging_jobs[0].model_version #=> String
1186
+ # resp.model_packaging_jobs[0].model_packaging_job_description #=> String
1187
+ # resp.model_packaging_jobs[0].model_packaging_method #=> String
1188
+ # resp.model_packaging_jobs[0].status #=> String, one of "CREATED", "RUNNING", "SUCCEEDED", "FAILED"
1189
+ # resp.model_packaging_jobs[0].status_message #=> String
1190
+ # resp.model_packaging_jobs[0].creation_timestamp #=> Time
1191
+ # resp.model_packaging_jobs[0].last_updated_timestamp #=> Time
1192
+ # resp.next_token #=> String
1193
+ #
1194
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lookoutvision-2020-11-20/ListModelPackagingJobs AWS API Documentation
1195
+ #
1196
+ # @overload list_model_packaging_jobs(params = {})
1197
+ # @param [Hash] params ({})
1198
+ def list_model_packaging_jobs(params = {}, options = {})
1199
+ req = build_request(:list_model_packaging_jobs, params)
1200
+ req.send_request(options)
1201
+ end
1202
+
1020
1203
  # Lists the versions of a model in an Amazon Lookout for Vision project.
1021
1204
  #
1205
+ # The `ListModels` operation is eventually consistent. Recent calls to
1206
+ # `CreateModel` might take a while to appear in the response from
1207
+ # `ListProjects`.
1208
+ #
1022
1209
  # This operation requires permissions to perform the
1023
1210
  # `lookoutvision:ListModels` operation.
1024
1211
  #
@@ -1078,6 +1265,10 @@ module Aws::LookoutforVision
1078
1265
 
1079
1266
  # Lists the Amazon Lookout for Vision projects in your AWS account.
1080
1267
  #
1268
+ # The `ListProjects` operation is eventually consistent. Recent calls to
1269
+ # `CreateProject` and `DeleteProject` might take a while to appear in
1270
+ # the response from `ListProjects`.
1271
+ #
1081
1272
  # This operation requires permissions to perform the
1082
1273
  # `lookoutvision:ListProjects` operation.
1083
1274
  #
@@ -1185,17 +1376,22 @@ module Aws::LookoutforVision
1185
1376
  #
1186
1377
  # @option params [required, Integer] :min_inference_units
1187
1378
  # The minimum number of inference units to use. A single inference unit
1188
- # represents 1 hour of processing and can support up to 5 Transaction
1189
- # Pers Second (TPS). Use a higher number to increase the TPS throughput
1190
- # of your model. You are charged for the number of inference units that
1191
- # you use.
1379
+ # represents 1 hour of processing. Use a higher number to increase the
1380
+ # TPS throughput of your model. You are charged for the number of
1381
+ # inference units that you use.
1192
1382
  #
1193
1383
  # @option params [String] :client_token
1194
1384
  # ClientToken is an idempotency token that ensures a call to
1195
1385
  # `StartModel` completes only once. You choose the value to pass. For
1196
- # example, An issue, such as an network outage, might prevent you from
1197
- # getting a response from `StartModel`. In this case, safely retry your
1198
- # call to `StartModel` by using the same `ClientToken` parameter value.
1386
+ # example, An issue might prevent you from getting a response from
1387
+ # `StartModel`. In this case, safely retry your call to `StartModel` by
1388
+ # using the same `ClientToken` parameter value.
1389
+ #
1390
+ # If you don't supply a value for `ClientToken`, the AWS SDK you are
1391
+ # using inserts a value for you. This prevents retries after a network
1392
+ # error from making multiple start requests. You'll need to provide
1393
+ # your own value for other use cases.
1394
+ #
1199
1395
  # An error occurs if the other input parameters are not the same as in
1200
1396
  # the first request. Using a different value for `ClientToken` is
1201
1397
  # considered a new call to `StartModel`. An idempotency token is active
@@ -1230,6 +1426,130 @@ module Aws::LookoutforVision
1230
1426
  req.send_request(options)
1231
1427
  end
1232
1428
 
1429
+ # Starts an Amazon Lookout for Vision model packaging job. A model
1430
+ # packaging job creates an AWS IoT Greengrass component for a Lookout
1431
+ # for Vision model. You can use the component to deploy your model to an
1432
+ # edge device managed by Greengrass.
1433
+ #
1434
+ # Use the DescribeModelPackagingJob API to determine the current status
1435
+ # of the job. The model packaging job is complete if the value of
1436
+ # `Status` is `SUCCEEDED`.
1437
+ #
1438
+ # To deploy the component to the target device, use the component name
1439
+ # and component version with the AWS IoT Greengrass
1440
+ # [CreateDeployment][1] API.
1441
+ #
1442
+ # This operation requires the following permissions:
1443
+ #
1444
+ # * `lookoutvision:StartModelPackagingJobs`
1445
+ #
1446
+ # * `s3:PutObject`
1447
+ #
1448
+ # * `s3:GetBucketLocation`
1449
+ #
1450
+ # * `greengrass:CreateComponentVersion`
1451
+ #
1452
+ # * `greengrass:DescribeComponent`
1453
+ #
1454
+ # * (Optional) `greengrass:TagResource`. Only required if you want to
1455
+ # tag the component.
1456
+ #
1457
+ # For more information, see *Using your Amazon Lookout for Vision model
1458
+ # on an edge device* in the Amazon Lookout for Vision Developer Guide.
1459
+ #
1460
+ #
1461
+ #
1462
+ # [1]: https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateDeployment.html
1463
+ #
1464
+ # @option params [required, String] :project_name
1465
+ # The name of the project which contains the version of the model that
1466
+ # you want to package.
1467
+ #
1468
+ # @option params [required, String] :model_version
1469
+ # The version of the model within the project that you want to package.
1470
+ #
1471
+ # @option params [String] :job_name
1472
+ # A name for the model packaging job. If you don't supply a value, the
1473
+ # service creates a job name for you.
1474
+ #
1475
+ # @option params [required, Types::ModelPackagingConfiguration] :configuration
1476
+ # The configuration for the model packaging job.
1477
+ #
1478
+ # @option params [String] :description
1479
+ # A description for the model packaging job.
1480
+ #
1481
+ # @option params [String] :client_token
1482
+ # ClientToken is an idempotency token that ensures a call to
1483
+ # `StartModelPackagingJob` completes only once. You choose the value to
1484
+ # pass. For example, An issue might prevent you from getting a response
1485
+ # from `StartModelPackagingJob`. In this case, safely retry your call to
1486
+ # `StartModelPackagingJob` by using the same `ClientToken` parameter
1487
+ # value.
1488
+ #
1489
+ # If you don't supply a value for `ClientToken`, the AWS SDK you are
1490
+ # using inserts a value for you. This prevents retries after a network
1491
+ # error from making multiple dataset creation requests. You'll need to
1492
+ # provide your own value for other use cases.
1493
+ #
1494
+ # An error occurs if the other input parameters are not the same as in
1495
+ # the first request. Using a different value for `ClientToken` is
1496
+ # considered a new call to `StartModelPackagingJob`. An idempotency
1497
+ # token is active for 8 hours.
1498
+ #
1499
+ # **A suitable default value is auto-generated.** You should normally
1500
+ # not need to pass this option.**
1501
+ #
1502
+ # @return [Types::StartModelPackagingJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1503
+ #
1504
+ # * {Types::StartModelPackagingJobResponse#job_name #job_name} => String
1505
+ #
1506
+ # @example Request syntax with placeholder values
1507
+ #
1508
+ # resp = client.start_model_packaging_job({
1509
+ # project_name: "ProjectName", # required
1510
+ # model_version: "ModelVersion", # required
1511
+ # job_name: "ModelPackagingJobName",
1512
+ # configuration: { # required
1513
+ # greengrass: { # required
1514
+ # compiler_options: "CompilerOptions", # required
1515
+ # target_device: "jetson_xavier", # accepts jetson_xavier
1516
+ # target_platform: {
1517
+ # os: "LINUX", # required, accepts LINUX
1518
+ # arch: "ARM64", # required, accepts ARM64, X86_64
1519
+ # accelerator: "NVIDIA", # required, accepts NVIDIA
1520
+ # },
1521
+ # s3_output_location: { # required
1522
+ # bucket: "S3BucketName", # required
1523
+ # prefix: "S3KeyPrefix",
1524
+ # },
1525
+ # component_name: "ComponentName", # required
1526
+ # component_version: "ComponentVersion",
1527
+ # component_description: "ComponentDescription",
1528
+ # tags: [
1529
+ # {
1530
+ # key: "TagKey", # required
1531
+ # value: "TagValue", # required
1532
+ # },
1533
+ # ],
1534
+ # },
1535
+ # },
1536
+ # description: "ModelPackagingJobDescription",
1537
+ # client_token: "ClientToken",
1538
+ # })
1539
+ #
1540
+ # @example Response structure
1541
+ #
1542
+ # resp.job_name #=> String
1543
+ #
1544
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lookoutvision-2020-11-20/StartModelPackagingJob AWS API Documentation
1545
+ #
1546
+ # @overload start_model_packaging_job(params = {})
1547
+ # @param [Hash] params ({})
1548
+ def start_model_packaging_job(params = {}, options = {})
1549
+ req = build_request(:start_model_packaging_job, params)
1550
+ req.send_request(options)
1551
+ end
1552
+
1233
1553
  # Stops the hosting of a running model. The operation might take a while
1234
1554
  # to complete. To check the current status, call DescribeModel.
1235
1555
  #
@@ -1247,12 +1567,19 @@ module Aws::LookoutforVision
1247
1567
  # @option params [String] :client_token
1248
1568
  # ClientToken is an idempotency token that ensures a call to `StopModel`
1249
1569
  # completes only once. You choose the value to pass. For example, An
1250
- # issue, such as an network outage, might prevent you from getting a
1251
- # response from `StopModel`. In this case, safely retry your call to
1252
- # `StopModel` by using the same `ClientToken` parameter value. An error
1253
- # occurs if the other input parameters are not the same as in the first
1254
- # request. Using a different value for `ClientToken` is considered a new
1255
- # call to `StopModel`. An idempotency token is active for 8 hours.
1570
+ # issue might prevent you from getting a response from `StopModel`. In
1571
+ # this case, safely retry your call to `StopModel` by using the same
1572
+ # `ClientToken` parameter value.
1573
+ #
1574
+ # If you don't supply a value for `ClientToken`, the AWS SDK you are
1575
+ # using inserts a value for you. This prevents retries after a network
1576
+ # error from making multiple stop requests. You'll need to provide your
1577
+ # own value for other use cases.
1578
+ #
1579
+ # An error occurs if the other input parameters are not the same as in
1580
+ # the first request. Using a different value for `ClientToken` is
1581
+ # considered a new call to `StopModel`. An idempotency token is active
1582
+ # for 8 hours.
1256
1583
  #
1257
1584
  # **A suitable default value is auto-generated.** You should normally
1258
1585
  # not need to pass this option.**
@@ -1350,9 +1677,22 @@ module Aws::LookoutforVision
1350
1677
  req.send_request(options)
1351
1678
  end
1352
1679
 
1353
- # Adds one or more JSON Line entries to a dataset. A JSON Line includes
1354
- # information about an image used for training or testing an Amazon
1355
- # Lookout for Vision model. The following is an example JSON Line.
1680
+ # Adds or updates one or more JSON Line entries in a dataset. A JSON
1681
+ # Line includes information about an image used for training or testing
1682
+ # an Amazon Lookout for Vision model.
1683
+ #
1684
+ # To update an existing JSON Line, use the `source-ref` field to
1685
+ # identify the JSON Line. The JSON line that you supply replaces the
1686
+ # existing JSON line. Any existing annotations that are not in the new
1687
+ # JSON line are removed from the dataset.
1688
+ #
1689
+ # For more information, see *Defining JSON lines for anomaly
1690
+ # classification* in the Amazon Lookout for Vision Developer Guide.
1691
+ #
1692
+ # <note markdown="1"> The images you reference in the `source-ref` field of a JSON line,
1693
+ # must be in the same S3 bucket as the existing images in the dataset.
1694
+ #
1695
+ # </note>
1356
1696
  #
1357
1697
  # Updating a dataset might take a while to complete. To check the
1358
1698
  # current status, call DescribeDataset and check the `Status` field in
@@ -1376,13 +1716,20 @@ module Aws::LookoutforVision
1376
1716
  # @option params [String] :client_token
1377
1717
  # ClientToken is an idempotency token that ensures a call to
1378
1718
  # `UpdateDatasetEntries` completes only once. You choose the value to
1379
- # pass. For example, An issue, such as an network outage, might prevent
1380
- # you from getting a response from `UpdateDatasetEntries`. In this case,
1381
- # safely retry your call to `UpdateDatasetEntries` by using the same
1382
- # `ClientToken` parameter value. An error occurs if the other input
1383
- # parameters are not the same as in the first request. Using a different
1384
- # value for `ClientToken` is considered a new call to
1385
- # `UpdateDatasetEntries`. An idempotency token is active for 8 hours.
1719
+ # pass. For example, An issue might prevent you from getting a response
1720
+ # from `UpdateDatasetEntries`. In this case, safely retry your call to
1721
+ # `UpdateDatasetEntries` by using the same `ClientToken` parameter
1722
+ # value.
1723
+ #
1724
+ # If you don't supply a value for `ClientToken`, the AWS SDK you are
1725
+ # using inserts a value for you. This prevents retries after a network
1726
+ # error from making multiple updates with the same dataset entries.
1727
+ # You'll need to provide your own value for other use cases.
1728
+ #
1729
+ # An error occurs if the other input parameters are not the same as in
1730
+ # the first request. Using a different value for `ClientToken` is
1731
+ # considered a new call to `UpdateDatasetEntries`. An idempotency token
1732
+ # is active for 8 hours.
1386
1733
  #
1387
1734
  # **A suitable default value is auto-generated.** You should normally
1388
1735
  # not need to pass this option.**
@@ -1426,7 +1773,7 @@ module Aws::LookoutforVision
1426
1773
  params: params,
1427
1774
  config: config)
1428
1775
  context[:gem_name] = 'aws-sdk-lookoutforvision'
1429
- context[:gem_version] = '1.7.0'
1776
+ context[:gem_version] = '1.11.0'
1430
1777
  Seahorse::Client::Request.new(handlers, context)
1431
1778
  end
1432
1779