aws-sdk-greengrassv2 1.17.0 → 1.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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