aws-sdk-greengrassv2 1.17.0 → 1.18.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7451710fe8937a410be44de1a2da21d56e9907a7ff88c472fba4f66cea5a545b
4
- data.tar.gz: e381a3edc711a47cd2d17751567d2d1cd98494d6299eaabfdb4979eadf71fe2f
3
+ metadata.gz: 2a20b98f0c1a619ea993ac0938897b731febaa493eb18bf54db65fa903ef6e03
4
+ data.tar.gz: 7549d80ce88d8a1d05543ed3b35f5d76574c0cb3d655e1ac7edfd578a96dccfb
5
5
  SHA512:
6
- metadata.gz: 7cbe3cf2c2cd67a3eb6e87219bd9aa269dbaa18ed9305599a7b4b6507a1ecdbce9e3e40f813a350e5c9527585ebb59479826cff35961097596d7e420a6d2a66c
7
- data.tar.gz: f4f8874876057537c5c4787539e5037101a673f6a0399ee1190ab65a1efce79b32862758db98751c65c90b89113a03aa1a91956f224a496754c1751f86853943
6
+ metadata.gz: 3732f4a9405968d2cdda986c1e8130f33e8bb9e968942d111966a47fa0e14d9f02ecc4b2776719a3962a28fdd30baa00c2ce6e98771ab21602b14be79501c0ac
7
+ data.tar.gz: e5d93c0346d6ee0f2e736f754807b6bdc598be2670bd73defe6fa7d0d721bbc02e1494ab175fbda3ee44056eaa30a34df9bea036b191bde3532e7cafe2e26380
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.18.0 (2022-05-18)
5
+ ------------------
6
+
7
+ * Feature - This release adds the new DeleteDeployment API operation that you can use to delete deployment resources. This release also adds support for discontinued AWS-provided components, so AWS can communicate when a component has any issues that you should consider before you deploy it.
8
+
4
9
  1.17.0 (2022-03-03)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.17.0
1
+ 1.18.0
@@ -559,12 +559,18 @@ module Aws::GreengrassV2
559
559
  #
560
560
  # * Python 3.8 – `python3.8`
561
561
  #
562
+ # * Python 3.9 – `python3.9`
563
+ #
562
564
  # * Java 8 – `java8`
563
565
  #
566
+ # * Java 11 – `java11`
567
+ #
564
568
  # * Node.js 10 – `nodejs10.x`
565
569
  #
566
570
  # * Node.js 12 – `nodejs12.x`
567
571
  #
572
+ # * Node.js 14 – `nodejs14.x`
573
+ #
568
574
  # To create a component from a Lambda function, specify
569
575
  # `lambdaFunction` when you call this operation.
570
576
  #
@@ -699,6 +705,8 @@ module Aws::GreengrassV2
699
705
  # resp.status.message #=> String
700
706
  # resp.status.errors #=> Hash
701
707
  # resp.status.errors["NonEmptyString"] #=> String
708
+ # resp.status.vendor_guidance #=> String, one of "ACTIVE", "DISCONTINUED", "DELETED"
709
+ # resp.status.vendor_guidance_message #=> String
702
710
  #
703
711
  # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/CreateComponentVersion AWS API Documentation
704
712
  #
@@ -925,6 +933,38 @@ module Aws::GreengrassV2
925
933
  req.send_request(options)
926
934
  end
927
935
 
936
+ # Deletes a deployment. To delete an active deployment, you must first
937
+ # cancel it. For more information, see [CancelDeployment][1].
938
+ #
939
+ # Deleting a deployment doesn't affect core devices that run that
940
+ # deployment, because core devices store the deployment's configuration
941
+ # on the device. Additionally, core devices can roll back to a previous
942
+ # deployment that has been deleted.
943
+ #
944
+ #
945
+ #
946
+ # [1]: https://docs.aws.amazon.com/iot/latest/apireference/API_CancelDeployment.html
947
+ #
948
+ # @option params [required, String] :deployment_id
949
+ # The ID of the deployment.
950
+ #
951
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
952
+ #
953
+ # @example Request syntax with placeholder values
954
+ #
955
+ # resp = client.delete_deployment({
956
+ # deployment_id: "NonEmptyString", # required
957
+ # })
958
+ #
959
+ # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/DeleteDeployment AWS API Documentation
960
+ #
961
+ # @overload delete_deployment(params = {})
962
+ # @param [Hash] params ({})
963
+ def delete_deployment(params = {}, options = {})
964
+ req = build_request(:delete_deployment, params)
965
+ req.send_request(options)
966
+ end
967
+
928
968
  # Retrieves metadata for a version of a component.
929
969
  #
930
970
  # @option params [required, String] :arn
@@ -964,6 +1004,8 @@ module Aws::GreengrassV2
964
1004
  # resp.status.message #=> String
965
1005
  # resp.status.errors #=> Hash
966
1006
  # resp.status.errors["NonEmptyString"] #=> String
1007
+ # resp.status.vendor_guidance #=> String, one of "ACTIVE", "DISCONTINUED", "DELETED"
1008
+ # resp.status.vendor_guidance_message #=> String
967
1009
  # resp.platforms #=> Array
968
1010
  # resp.platforms[0].name #=> String
969
1011
  # resp.platforms[0].attributes #=> Hash
@@ -1051,13 +1093,13 @@ module Aws::GreengrassV2
1051
1093
  req.send_request(options)
1052
1094
  end
1053
1095
 
1054
- # Gets the pre-signed URL to download a public component artifact. Core
1055
- # devices call this operation to identify the URL that they can use to
1056
- # download an artifact to install.
1096
+ # Gets the pre-signed URL to download a public or a Lambda component
1097
+ # artifact. Core devices call this operation to identify the URL that
1098
+ # they can use to download an artifact to install.
1057
1099
  #
1058
1100
  # @option params [required, String] :arn
1059
- # The [ARN][1] of the component version. Specify the ARN of a public
1060
- # component version.
1101
+ # The [ARN][1] of the component version. Specify the ARN of a public or
1102
+ # a Lambda component version.
1061
1103
  #
1062
1104
  #
1063
1105
  #
@@ -1149,6 +1191,31 @@ module Aws::GreengrassV2
1149
1191
 
1150
1192
  # Retrieves metadata for a Greengrass core device.
1151
1193
  #
1194
+ # <note markdown="1"> IoT Greengrass relies on individual devices to send status updates to
1195
+ # the Amazon Web Services Cloud. If the IoT Greengrass Core software
1196
+ # isn't running on the device, or if device isn't connected to the
1197
+ # Amazon Web Services Cloud, then the reported status of that device
1198
+ # might not reflect its current status. The status timestamp indicates
1199
+ # when the device status was last updated.
1200
+ #
1201
+ # Core devices send status updates at the following times:
1202
+ #
1203
+ # * When the IoT Greengrass Core software starts
1204
+ #
1205
+ # * When the core device receives a deployment from the Amazon Web
1206
+ # Services Cloud
1207
+ #
1208
+ # * When the status of any component on the core device becomes `BROKEN`
1209
+ #
1210
+ # * At a [regular interval that you can configure][1], which defaults to
1211
+ # 24 hours
1212
+ #
1213
+ # </note>
1214
+ #
1215
+ #
1216
+ #
1217
+ # [1]: https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration-fss
1218
+ #
1152
1219
  # @option params [required, String] :core_device_thing_name
1153
1220
  # The name of the core device. This is also the name of the IoT thing.
1154
1221
  #
@@ -1340,7 +1407,7 @@ module Aws::GreengrassV2
1340
1407
  # versions are listed first.
1341
1408
  #
1342
1409
  # @option params [required, String] :arn
1343
- # The [ARN][1] of the component version.
1410
+ # The [ARN][1] of the component.
1344
1411
  #
1345
1412
  #
1346
1413
  #
@@ -1440,10 +1507,37 @@ module Aws::GreengrassV2
1440
1507
 
1441
1508
  # Retrieves a paginated list of Greengrass core devices.
1442
1509
  #
1510
+ # <note markdown="1"> IoT Greengrass relies on individual devices to send status updates to
1511
+ # the Amazon Web Services Cloud. If the IoT Greengrass Core software
1512
+ # isn't running on the device, or if device isn't connected to the
1513
+ # Amazon Web Services Cloud, then the reported status of that device
1514
+ # might not reflect its current status. The status timestamp indicates
1515
+ # when the device status was last updated.
1516
+ #
1517
+ # Core devices send status updates at the following times:
1518
+ #
1519
+ # * When the IoT Greengrass Core software starts
1520
+ #
1521
+ # * When the core device receives a deployment from the Amazon Web
1522
+ # Services Cloud
1523
+ #
1524
+ # * When the status of any component on the core device becomes `BROKEN`
1525
+ #
1526
+ # * At a [regular interval that you can configure][1], which defaults to
1527
+ # 24 hours
1528
+ #
1529
+ # </note>
1530
+ #
1531
+ #
1532
+ #
1533
+ # [1]: https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration-fss
1534
+ #
1443
1535
  # @option params [String] :thing_group_arn
1444
1536
  # The [ARN][1] of the IoT thing group by which to filter. If you specify
1445
- # this parameter, the list includes only core devices that are members
1446
- # of this thing group.
1537
+ # this parameter, the list includes only core devices that have
1538
+ # successfully deployed a deployment that targets the thing group. When
1539
+ # you remove a core device from a thing group, the list continues to
1540
+ # include that core device.
1447
1541
  #
1448
1542
  #
1449
1543
  #
@@ -1614,7 +1708,34 @@ module Aws::GreengrassV2
1614
1708
  end
1615
1709
 
1616
1710
  # Retrieves a paginated list of the components that a Greengrass core
1617
- # device runs.
1711
+ # device runs. This list doesn't include components that are deployed
1712
+ # from local deployments or components that are deployed as dependencies
1713
+ # of other components.
1714
+ #
1715
+ # <note markdown="1"> IoT Greengrass relies on individual devices to send status updates to
1716
+ # the Amazon Web Services Cloud. If the IoT Greengrass Core software
1717
+ # isn't running on the device, or if device isn't connected to the
1718
+ # Amazon Web Services Cloud, then the reported status of that device
1719
+ # might not reflect its current status. The status timestamp indicates
1720
+ # when the device status was last updated.
1721
+ #
1722
+ # Core devices send status updates at the following times:
1723
+ #
1724
+ # * When the IoT Greengrass Core software starts
1725
+ #
1726
+ # * When the core device receives a deployment from the Amazon Web
1727
+ # Services Cloud
1728
+ #
1729
+ # * When the status of any component on the core device becomes `BROKEN`
1730
+ #
1731
+ # * At a [regular interval that you can configure][1], which defaults to
1732
+ # 24 hours
1733
+ #
1734
+ # </note>
1735
+ #
1736
+ #
1737
+ #
1738
+ # [1]: https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration-fss
1618
1739
  #
1619
1740
  # @option params [required, String] :core_device_thing_name
1620
1741
  # The name of the core device. This is also the name of the IoT thing.
@@ -1717,10 +1838,10 @@ module Aws::GreengrassV2
1717
1838
  #
1718
1839
  # [1]: https://docs.aws.amazon.com/general/latest/gr/greengrass.html
1719
1840
  #
1720
- # @option params [required, Types::ComponentPlatform] :platform
1841
+ # @option params [Types::ComponentPlatform] :platform
1721
1842
  # The platform to use to resolve compatible components.
1722
1843
  #
1723
- # @option params [required, Array<Types::ComponentCandidate>] :component_candidates
1844
+ # @option params [Array<Types::ComponentCandidate>] :component_candidates
1724
1845
  # The list of components to resolve.
1725
1846
  #
1726
1847
  # @return [Types::ResolveComponentCandidatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1730,13 +1851,13 @@ module Aws::GreengrassV2
1730
1851
  # @example Request syntax with placeholder values
1731
1852
  #
1732
1853
  # resp = client.resolve_component_candidates({
1733
- # platform: { # required
1854
+ # platform: {
1734
1855
  # name: "NonEmptyString",
1735
1856
  # attributes: {
1736
1857
  # "NonEmptyString" => "NonEmptyString",
1737
1858
  # },
1738
1859
  # },
1739
- # component_candidates: [ # required
1860
+ # component_candidates: [
1740
1861
  # {
1741
1862
  # component_name: "ComponentNameString",
1742
1863
  # component_version: "ComponentVersionString",
@@ -1754,6 +1875,8 @@ module Aws::GreengrassV2
1754
1875
  # resp.resolved_component_versions[0].component_name #=> String
1755
1876
  # resp.resolved_component_versions[0].component_version #=> String
1756
1877
  # resp.resolved_component_versions[0].recipe #=> String
1878
+ # resp.resolved_component_versions[0].vendor_guidance #=> String, one of "ACTIVE", "DISCONTINUED", "DELETED"
1879
+ # resp.resolved_component_versions[0].message #=> String
1757
1880
  #
1758
1881
  # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ResolveComponentCandidates AWS API Documentation
1759
1882
  #
@@ -1900,7 +2023,7 @@ module Aws::GreengrassV2
1900
2023
  params: params,
1901
2024
  config: config)
1902
2025
  context[:gem_name] = 'aws-sdk-greengrassv2'
1903
- context[:gem_version] = '1.17.0'
2026
+ context[:gem_version] = '1.18.0'
1904
2027
  Seahorse::Client::Request.new(handlers, context)
1905
2028
  end
1906
2029
 
@@ -72,6 +72,7 @@ module Aws::GreengrassV2
72
72
  DefaultMaxResults = Shapes::IntegerShape.new(name: 'DefaultMaxResults')
73
73
  DeleteComponentRequest = Shapes::StructureShape.new(name: 'DeleteComponentRequest')
74
74
  DeleteCoreDeviceRequest = Shapes::StructureShape.new(name: 'DeleteCoreDeviceRequest')
75
+ DeleteDeploymentRequest = Shapes::StructureShape.new(name: 'DeleteDeploymentRequest')
75
76
  Deployment = Shapes::StructureShape.new(name: 'Deployment')
76
77
  DeploymentComponentUpdatePolicy = Shapes::StructureShape.new(name: 'DeploymentComponentUpdatePolicy')
77
78
  DeploymentComponentUpdatePolicyAction = Shapes::StringShape.new(name: 'DeploymentComponentUpdatePolicyAction')
@@ -214,6 +215,7 @@ module Aws::GreengrassV2
214
215
  ValidationExceptionField = Shapes::StructureShape.new(name: 'ValidationExceptionField')
215
216
  ValidationExceptionFieldList = Shapes::ListShape.new(name: 'ValidationExceptionFieldList')
216
217
  ValidationExceptionReason = Shapes::StringShape.new(name: 'ValidationExceptionReason')
218
+ VendorGuidance = Shapes::StringShape.new(name: 'VendorGuidance')
217
219
  connectivityInfoList = Shapes::ListShape.new(name: 'connectivityInfoList')
218
220
 
219
221
  AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -266,6 +268,8 @@ module Aws::GreengrassV2
266
268
  CloudComponentStatus.add_member(:component_state, Shapes::ShapeRef.new(shape: CloudComponentState, location_name: "componentState"))
267
269
  CloudComponentStatus.add_member(:message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "message"))
268
270
  CloudComponentStatus.add_member(:errors, Shapes::ShapeRef.new(shape: StringMap, location_name: "errors"))
271
+ CloudComponentStatus.add_member(:vendor_guidance, Shapes::ShapeRef.new(shape: VendorGuidance, location_name: "vendorGuidance"))
272
+ CloudComponentStatus.add_member(:vendor_guidance_message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "vendorGuidanceMessage"))
269
273
  CloudComponentStatus.struct_class = Types::CloudComponentStatus
270
274
 
271
275
  Component.add_member(:arn, Shapes::ShapeRef.new(shape: ComponentARN, location_name: "arn"))
@@ -383,6 +387,9 @@ module Aws::GreengrassV2
383
387
  DeleteCoreDeviceRequest.add_member(:core_device_thing_name, Shapes::ShapeRef.new(shape: CoreDeviceThingName, required: true, location: "uri", location_name: "coreDeviceThingName"))
384
388
  DeleteCoreDeviceRequest.struct_class = Types::DeleteCoreDeviceRequest
385
389
 
390
+ DeleteDeploymentRequest.add_member(:deployment_id, Shapes::ShapeRef.new(shape: NonEmptyString, required: true, location: "uri", location_name: "deploymentId"))
391
+ DeleteDeploymentRequest.struct_class = Types::DeleteDeploymentRequest
392
+
386
393
  Deployment.add_member(:target_arn, Shapes::ShapeRef.new(shape: TargetARN, location_name: "targetArn"))
387
394
  Deployment.add_member(:revision_id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "revisionId"))
388
395
  Deployment.add_member(:deployment_id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "deploymentId"))
@@ -689,8 +696,8 @@ module Aws::GreengrassV2
689
696
  RequestAlreadyInProgressException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
690
697
  RequestAlreadyInProgressException.struct_class = Types::RequestAlreadyInProgressException
691
698
 
692
- ResolveComponentCandidatesRequest.add_member(:platform, Shapes::ShapeRef.new(shape: ComponentPlatform, required: true, location_name: "platform"))
693
- ResolveComponentCandidatesRequest.add_member(:component_candidates, Shapes::ShapeRef.new(shape: ComponentCandidateList, required: true, location_name: "componentCandidates"))
699
+ ResolveComponentCandidatesRequest.add_member(:platform, Shapes::ShapeRef.new(shape: ComponentPlatform, location_name: "platform"))
700
+ ResolveComponentCandidatesRequest.add_member(:component_candidates, Shapes::ShapeRef.new(shape: ComponentCandidateList, location_name: "componentCandidates"))
694
701
  ResolveComponentCandidatesRequest.struct_class = Types::ResolveComponentCandidatesRequest
695
702
 
696
703
  ResolveComponentCandidatesResponse.add_member(:resolved_component_versions, Shapes::ShapeRef.new(shape: ResolvedComponentVersionsList, location_name: "resolvedComponentVersions"))
@@ -700,6 +707,8 @@ module Aws::GreengrassV2
700
707
  ResolvedComponentVersion.add_member(:component_name, Shapes::ShapeRef.new(shape: ComponentNameString, location_name: "componentName"))
701
708
  ResolvedComponentVersion.add_member(:component_version, Shapes::ShapeRef.new(shape: ComponentVersionString, location_name: "componentVersion"))
702
709
  ResolvedComponentVersion.add_member(:recipe, Shapes::ShapeRef.new(shape: RecipeBlob, location_name: "recipe"))
710
+ ResolvedComponentVersion.add_member(:vendor_guidance, Shapes::ShapeRef.new(shape: VendorGuidance, location_name: "vendorGuidance"))
711
+ ResolvedComponentVersion.add_member(:message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "message"))
703
712
  ResolvedComponentVersion.struct_class = Types::ResolvedComponentVersion
704
713
 
705
714
  ResolvedComponentVersionsList.member = Shapes::ShapeRef.new(shape: ResolvedComponentVersion)
@@ -860,6 +869,7 @@ module Aws::GreengrassV2
860
869
  o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
861
870
  o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
862
871
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
872
+ o.errors << Shapes::ShapeRef.new(shape: ConflictException)
863
873
  o.errors << Shapes::ShapeRef.new(shape: RequestAlreadyInProgressException)
864
874
  end)
865
875
 
@@ -891,6 +901,20 @@ module Aws::GreengrassV2
891
901
  o.errors << Shapes::ShapeRef.new(shape: ConflictException)
892
902
  end)
893
903
 
904
+ api.add_operation(:delete_deployment, Seahorse::Model::Operation.new.tap do |o|
905
+ o.name = "DeleteDeployment"
906
+ o.http_method = "DELETE"
907
+ o.http_request_uri = "/greengrass/v2/deployments/{deploymentId}"
908
+ o.input = Shapes::ShapeRef.new(shape: DeleteDeploymentRequest)
909
+ o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
910
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
911
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
912
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
913
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
914
+ o.errors << Shapes::ShapeRef.new(shape: ConflictException)
915
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
916
+ end)
917
+
894
918
  api.add_operation(:describe_component, Seahorse::Model::Operation.new.tap do |o|
895
919
  o.name = "DescribeComponent"
896
920
  o.http_method = "GET"
@@ -1030,6 +1054,7 @@ module Aws::GreengrassV2
1030
1054
  o.output = Shapes::ShapeRef.new(shape: ListComponentsResponse)
1031
1055
  o.errors << Shapes::ShapeRef.new(shape: ValidationException)
1032
1056
  o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
1057
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1033
1058
  o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
1034
1059
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1035
1060
  o[:pager] = Aws::Pager.new(
@@ -1134,9 +1159,9 @@ module Aws::GreengrassV2
1134
1159
  o.errors << Shapes::ShapeRef.new(shape: ValidationException)
1135
1160
  o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
1136
1161
  o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1162
+ o.errors << Shapes::ShapeRef.new(shape: ConflictException)
1137
1163
  o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
1138
1164
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1139
- o.errors << Shapes::ShapeRef.new(shape: ConflictException)
1140
1165
  end)
1141
1166
 
1142
1167
  api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|
@@ -255,30 +255,59 @@ module Aws::GreengrassV2
255
255
  include Aws::Structure
256
256
  end
257
257
 
258
- # Contains the status of a component in the IoT Greengrass service.
258
+ # Contains the status of a component version in the IoT Greengrass
259
+ # service.
259
260
  #
260
261
  # @!attribute [rw] component_state
261
- # The state of the component.
262
+ # The state of the component version.
262
263
  # @return [String]
263
264
  #
264
265
  # @!attribute [rw] message
265
266
  # A message that communicates details, such as errors, about the
266
- # status of the component.
267
+ # status of the component version.
267
268
  # @return [String]
268
269
  #
269
270
  # @!attribute [rw] errors
270
- # A dictionary of errors that communicate why the component is in an
271
- # error state. For example, if IoT Greengrass can't access an
272
- # artifact for the component, then `errors` contains the artifact's
273
- # URI as a key, and the error message as the value for that key.
271
+ # A dictionary of errors that communicate why the component version is
272
+ # in an error state. For example, if IoT Greengrass can't access an
273
+ # artifact for the component version, then `errors` contains the
274
+ # artifact's URI as a key, and the error message as the value for
275
+ # that key.
274
276
  # @return [Hash<String,String>]
275
277
  #
278
+ # @!attribute [rw] vendor_guidance
279
+ # The vendor guidance state for the component version. This state
280
+ # indicates whether the component version has any issues that you
281
+ # should consider before you deploy it. The vendor guidance state can
282
+ # be:
283
+ #
284
+ # * `ACTIVE` – This component version is available and recommended for
285
+ # use.
286
+ #
287
+ # * `DISCONTINUED` – This component version has been discontinued by
288
+ # its publisher. You can deploy this component version, but we
289
+ # recommend that you use a different version of this component.
290
+ #
291
+ # * `DELETED` – This component version has been deleted by its
292
+ # publisher, so you can't deploy it. If you have any existing
293
+ # deployments that specify this component version, those deployments
294
+ # will fail.
295
+ # @return [String]
296
+ #
297
+ # @!attribute [rw] vendor_guidance_message
298
+ # A message that communicates details about the vendor guidance state
299
+ # of the component version. This message communicates why a component
300
+ # version is discontinued or deleted.
301
+ # @return [String]
302
+ #
276
303
  # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/CloudComponentStatus AWS API Documentation
277
304
  #
278
305
  class CloudComponentStatus < Struct.new(
279
306
  :component_state,
280
307
  :message,
281
- :errors)
308
+ :errors,
309
+ :vendor_guidance,
310
+ :vendor_guidance_message)
282
311
  SENSITIVE = []
283
312
  include Aws::Structure
284
313
  end
@@ -1173,6 +1202,25 @@ module Aws::GreengrassV2
1173
1202
  include Aws::Structure
1174
1203
  end
1175
1204
 
1205
+ # @note When making an API call, you may pass DeleteDeploymentRequest
1206
+ # data as a hash:
1207
+ #
1208
+ # {
1209
+ # deployment_id: "NonEmptyString", # required
1210
+ # }
1211
+ #
1212
+ # @!attribute [rw] deployment_id
1213
+ # The ID of the deployment.
1214
+ # @return [String]
1215
+ #
1216
+ # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/DeleteDeploymentRequest AWS API Documentation
1217
+ #
1218
+ class DeleteDeploymentRequest < Struct.new(
1219
+ :deployment_id)
1220
+ SENSITIVE = []
1221
+ include Aws::Structure
1222
+ end
1223
+
1176
1224
  # Contains information about a deployment.
1177
1225
  #
1178
1226
  # @!attribute [rw] target_arn
@@ -1727,7 +1775,7 @@ module Aws::GreengrassV2
1727
1775
  #
1728
1776
  # @!attribute [rw] arn
1729
1777
  # The [ARN][1] of the component version. Specify the ARN of a public
1730
- # component version.
1778
+ # or a Lambda component version.
1731
1779
  #
1732
1780
  #
1733
1781
  #
@@ -2845,7 +2893,7 @@ module Aws::GreengrassV2
2845
2893
  # }
2846
2894
  #
2847
2895
  # @!attribute [rw] arn
2848
- # The [ARN][1] of the component version.
2896
+ # The [ARN][1] of the component.
2849
2897
  #
2850
2898
  #
2851
2899
  #
@@ -2951,8 +2999,10 @@ module Aws::GreengrassV2
2951
2999
  #
2952
3000
  # @!attribute [rw] thing_group_arn
2953
3001
  # The [ARN][1] of the IoT thing group by which to filter. If you
2954
- # specify this parameter, the list includes only core devices that are
2955
- # members of this thing group.
3002
+ # specify this parameter, the list includes only core devices that
3003
+ # have successfully deployed a deployment that targets the thing
3004
+ # group. When you remove a core device from a thing group, the list
3005
+ # continues to include that core device.
2956
3006
  #
2957
3007
  #
2958
3008
  #
@@ -3233,13 +3283,13 @@ module Aws::GreengrassV2
3233
3283
  # data as a hash:
3234
3284
  #
3235
3285
  # {
3236
- # platform: { # required
3286
+ # platform: {
3237
3287
  # name: "NonEmptyString",
3238
3288
  # attributes: {
3239
3289
  # "NonEmptyString" => "NonEmptyString",
3240
3290
  # },
3241
3291
  # },
3242
- # component_candidates: [ # required
3292
+ # component_candidates: [
3243
3293
  # {
3244
3294
  # component_name: "ComponentNameString",
3245
3295
  # component_version: "ComponentVersionString",
@@ -3304,13 +3354,40 @@ module Aws::GreengrassV2
3304
3354
  # The recipe of the component version.
3305
3355
  # @return [String]
3306
3356
  #
3357
+ # @!attribute [rw] vendor_guidance
3358
+ # The vendor guidance state for the component version. This state
3359
+ # indicates whether the component version has any issues that you
3360
+ # should consider before you deploy it. The vendor guidance state can
3361
+ # be:
3362
+ #
3363
+ # * `ACTIVE` – This component version is available and recommended for
3364
+ # use.
3365
+ #
3366
+ # * `DISCONTINUED` – This component version has been discontinued by
3367
+ # its publisher. You can deploy this component version, but we
3368
+ # recommend that you use a different version of this component.
3369
+ #
3370
+ # * `DELETED` – This component version has been deleted by its
3371
+ # publisher, so you can't deploy it. If you have any existing
3372
+ # deployments that specify this component version, those deployments
3373
+ # will fail.
3374
+ # @return [String]
3375
+ #
3376
+ # @!attribute [rw] message
3377
+ # A message that communicates details about the vendor guidance state
3378
+ # of the component version. This message communicates why a component
3379
+ # version is discontinued or deleted.
3380
+ # @return [String]
3381
+ #
3307
3382
  # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ResolvedComponentVersion AWS API Documentation
3308
3383
  #
3309
3384
  class ResolvedComponentVersion < Struct.new(
3310
3385
  :arn,
3311
3386
  :component_name,
3312
3387
  :component_version,
3313
- :recipe)
3388
+ :recipe,
3389
+ :vendor_guidance,
3390
+ :message)
3314
3391
  SENSITIVE = []
3315
3392
  include Aws::Structure
3316
3393
  end
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-greengrassv2/customizations'
48
48
  # @!group service
49
49
  module Aws::GreengrassV2
50
50
 
51
- GEM_VERSION = '1.17.0'
51
+ GEM_VERSION = '1.18.0'
52
52
 
53
53
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-greengrassv2
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.17.0
4
+ version: 1.18.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-03-03 00:00:00.000000000 Z
11
+ date: 2022-05-18 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core