aws-sdk-greengrassv2 1.18.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a20b98f0c1a619ea993ac0938897b731febaa493eb18bf54db65fa903ef6e03
-  data.tar.gz: 7549d80ce88d8a1d05543ed3b35f5d76574c0cb3d655e1ac7edfd578a96dccfb
+  metadata.gz: 77a7d6316272826d8cd4f92ee7df041ea0faed036d47095134f04ecf90b98dfc
+  data.tar.gz: 74b760c485f5a81768e024a229a27311407e0e98f5b40ba24388f64474d4a3c1
 SHA512:
-  metadata.gz: 3732f4a9405968d2cdda986c1e8130f33e8bb9e968942d111966a47fa0e14d9f02ecc4b2776719a3962a28fdd30baa00c2ce6e98771ab21602b14be79501c0ac
-  data.tar.gz: e5d93c0346d6ee0f2e736f754807b6bdc598be2670bd73defe6fa7d0d721bbc02e1494ab175fbda3ee44056eaa30a34df9bea036b191bde3532e7cafe2e26380
+  metadata.gz: 2c39c85779db816c1d9649dc879fe6b479cf391ec7355e5cc0e40cba4329609bb44c783127956a9bc112caf2fba3a755b8b636806b16b8caee69717ed0855fab
+  data.tar.gz: 25638e619b299500a33f8b6e169f6787ab6281902a7985607fc40487943d22340f77f450cf20aa8a9a20b339445cb80b0a1ba839ea29623fc76f668e7022076b

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.19.0 (2022-08-30)
+------------------
+
+* Feature - Adds topologyFilter to ListInstalledComponentsRequest which allows filtration of components by ROOT or ALL (including root and dependency components). Adds lastStatusChangeTimestamp to ListInstalledComponents response to show the last time a component changed state on a device.
+
 1.18.0 (2022-05-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.18.0
+1.19.0

data/lib/aws-sdk-greengrassv2/client.rb

@@ -630,7 +630,7 @@ module Aws::GreengrassV2
     #   resp = client.create_component_version({
     #     inline_recipe: "data",
     #     lambda_function: {
-    #       lambda_arn: "LambdaFunctionARNWithVersionNumber", # required
+    #       lambda_arn: "NonEmptyString", # required
     #       component_name: "ComponentNameString",
     #       component_version: "ComponentVersionString",
     #       component_platforms: [
@@ -794,7 +794,7 @@ module Aws::GreengrassV2
     #
     #   resp = client.create_deployment({
     #     target_arn: "TargetARN", # required
-    #     deployment_name: "NonEmptyString",
+    #     deployment_name: "DeploymentNameString",
     #     components: {
     #       "NonEmptyString" => {
     #         component_version: "ComponentVersionString",
@@ -1050,9 +1050,7 @@ module Aws::GreengrassV2
       req.send_request(options)
     end
 
-    # Gets the recipe for a version of a component. Core devices can call
-    # this operation to identify the artifacts and requirements to install a
-    # component.
+    # Gets the recipe for a version of a component.
     #
     # @option params [String] :recipe_output_format
     #   The format of the recipe.
@@ -1210,6 +1208,9 @@ module Aws::GreengrassV2
     # * At a [regular interval that you can configure][1], which defaults to
     #   24 hours
     #
+    # * For IoT Greengrass Core v2.7.0, the core device sends status updates
+    #   upon local deployment and cloud deployment
+    #
     #  </note>
     #
     #
@@ -1526,6 +1527,9 @@ module Aws::GreengrassV2
     # * At a [regular interval that you can configure][1], which defaults to
     #   24 hours
     #
+    # * For IoT Greengrass Core v2.7.0, the core device sends status updates
+    #   upon local deployment and cloud deployment
+    #
     #  </note>
     #
     #
@@ -1708,9 +1712,10 @@ module Aws::GreengrassV2
     end
 
     # Retrieves a paginated list of the components that a Greengrass core
-    # device runs. This list doesn't include components that are deployed
-    # from local deployments or components that are deployed as dependencies
-    # of other components.
+    # device runs. By default, this list doesn't include components that
+    # are deployed as dependencies of other components. To include
+    # dependencies in the response, set the `topologyFilter` parameter to
+    # `ALL`.
     #
     # <note markdown="1"> IoT Greengrass relies on individual devices to send status updates to
     # the Amazon Web Services Cloud. If the IoT Greengrass Core software
@@ -1731,6 +1736,9 @@ module Aws::GreengrassV2
     # * At a [regular interval that you can configure][1], which defaults to
     #   24 hours
     #
+    # * For IoT Greengrass Core v2.7.0, the core device sends status updates
+    #   upon local deployment and cloud deployment
+    #
     #  </note>
     #
     #
@@ -1746,6 +1754,20 @@ module Aws::GreengrassV2
     # @option params [String] :next_token
     #   The token to be used for the next set of paginated results.
     #
+    # @option params [String] :topology_filter
+    #   The filter for the list of components. Choose from the following
+    #   options:
+    #
+    #   * `ALL` – The list includes all components installed on the core
+    #     device.
+    #
+    #   * `ROOT` – The list includes only *root* components, which are
+    #     components that you specify in a deployment. When you choose this
+    #     option, the list doesn't include components that the core device
+    #     installs as dependencies of other components.
+    #
+    #   Default: `ROOT`
+    #
     # @return [Types::ListInstalledComponentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListInstalledComponentsResponse#installed_components #installed_components} => Array&lt;Types::InstalledComponent&gt;
@@ -1759,6 +1781,7 @@ module Aws::GreengrassV2
     #     core_device_thing_name: "CoreDeviceThingName", # required
     #     max_results: 1,
     #     next_token: "NextTokenString",
+    #     topology_filter: "ALL", # accepts ALL, ROOT
     #   })
     #
     # @example Response structure
@@ -1769,6 +1792,7 @@ module Aws::GreengrassV2
     #   resp.installed_components[0].lifecycle_state #=> String, one of "NEW", "INSTALLED", "STARTING", "RUNNING", "STOPPING", "ERRORED", "BROKEN", "FINISHED"
     #   resp.installed_components[0].lifecycle_state_details #=> String
     #   resp.installed_components[0].is_root #=> Boolean
+    #   resp.installed_components[0].last_status_change_timestamp #=> Time
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ListInstalledComponents AWS API Documentation
@@ -2023,7 +2047,7 @@ module Aws::GreengrassV2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-greengrassv2'
-      context[:gem_version] = '1.18.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-greengrassv2/client_api.rb

@@ -83,6 +83,7 @@ module Aws::GreengrassV2
     DeploymentIoTJobConfiguration = Shapes::StructureShape.new(name: 'DeploymentIoTJobConfiguration')
     DeploymentList = Shapes::ListShape.new(name: 'DeploymentList')
     DeploymentName = Shapes::StringShape.new(name: 'DeploymentName')
+    DeploymentNameString = Shapes::StringShape.new(name: 'DeploymentNameString')
     DeploymentPolicies = Shapes::StructureShape.new(name: 'DeploymentPolicies')
     DeploymentStatus = Shapes::StringShape.new(name: 'DeploymentStatus')
     DescribeComponentRequest = Shapes::StructureShape.new(name: 'DescribeComponentRequest')
@@ -116,6 +117,7 @@ module Aws::GreengrassV2
     InstalledComponent = Shapes::StructureShape.new(name: 'InstalledComponent')
     InstalledComponentLifecycleState = Shapes::StringShape.new(name: 'InstalledComponentLifecycleState')
     InstalledComponentList = Shapes::ListShape.new(name: 'InstalledComponentList')
+    InstalledComponentTopologyFilter = Shapes::StringShape.new(name: 'InstalledComponentTopologyFilter')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     IoTJobARN = Shapes::StringShape.new(name: 'IoTJobARN')
     IoTJobAbortAction = Shapes::StringShape.new(name: 'IoTJobAbortAction')
@@ -149,7 +151,6 @@ module Aws::GreengrassV2
     LambdaExecArgsList = Shapes::ListShape.new(name: 'LambdaExecArgsList')
     LambdaExecutionParameters = Shapes::StructureShape.new(name: 'LambdaExecutionParameters')
     LambdaFilesystemPermission = Shapes::StringShape.new(name: 'LambdaFilesystemPermission')
-    LambdaFunctionARNWithVersionNumber = Shapes::StringShape.new(name: 'LambdaFunctionARNWithVersionNumber')
     LambdaFunctionRecipeSource = Shapes::StructureShape.new(name: 'LambdaFunctionRecipeSource')
     LambdaInputPayloadEncodingType = Shapes::StringShape.new(name: 'LambdaInputPayloadEncodingType')
     LambdaIsolationMode = Shapes::StringShape.new(name: 'LambdaIsolationMode')
@@ -368,7 +369,7 @@ module Aws::GreengrassV2
     CreateComponentVersionResponse.struct_class = Types::CreateComponentVersionResponse
 
     CreateDeploymentRequest.add_member(:target_arn, Shapes::ShapeRef.new(shape: TargetARN, required: true, location_name: "targetArn"))
-    CreateDeploymentRequest.add_member(:deployment_name, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "deploymentName"))
+    CreateDeploymentRequest.add_member(:deployment_name, Shapes::ShapeRef.new(shape: DeploymentNameString, location_name: "deploymentName"))
     CreateDeploymentRequest.add_member(:components, Shapes::ShapeRef.new(shape: ComponentDeploymentSpecifications, location_name: "components"))
     CreateDeploymentRequest.add_member(:iot_job_configuration, Shapes::ShapeRef.new(shape: DeploymentIoTJobConfiguration, location_name: "iotJobConfiguration"))
     CreateDeploymentRequest.add_member(:deployment_policies, Shapes::ShapeRef.new(shape: DeploymentPolicies, location_name: "deploymentPolicies"))
@@ -527,6 +528,7 @@ module Aws::GreengrassV2
     InstalledComponent.add_member(:lifecycle_state, Shapes::ShapeRef.new(shape: InstalledComponentLifecycleState, location_name: "lifecycleState"))
     InstalledComponent.add_member(:lifecycle_state_details, Shapes::ShapeRef.new(shape: LifecycleStateDetails, location_name: "lifecycleStateDetails"))
     InstalledComponent.add_member(:is_root, Shapes::ShapeRef.new(shape: IsRoot, location_name: "isRoot"))
+    InstalledComponent.add_member(:last_status_change_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastStatusChangeTimestamp"))
     InstalledComponent.struct_class = Types::InstalledComponent
 
     InstalledComponentList.member = Shapes::ShapeRef.new(shape: InstalledComponent)
@@ -599,7 +601,7 @@ module Aws::GreengrassV2
     LambdaExecutionParameters.add_member(:linux_process_params, Shapes::ShapeRef.new(shape: LambdaLinuxProcessParams, location_name: "linuxProcessParams"))
     LambdaExecutionParameters.struct_class = Types::LambdaExecutionParameters
 
-    LambdaFunctionRecipeSource.add_member(:lambda_arn, Shapes::ShapeRef.new(shape: LambdaFunctionARNWithVersionNumber, required: true, location_name: "lambdaArn"))
+    LambdaFunctionRecipeSource.add_member(:lambda_arn, Shapes::ShapeRef.new(shape: NonEmptyString, required: true, location_name: "lambdaArn"))
     LambdaFunctionRecipeSource.add_member(:component_name, Shapes::ShapeRef.new(shape: ComponentNameString, location_name: "componentName"))
     LambdaFunctionRecipeSource.add_member(:component_version, Shapes::ShapeRef.new(shape: ComponentVersionString, location_name: "componentVersion"))
     LambdaFunctionRecipeSource.add_member(:component_platforms, Shapes::ShapeRef.new(shape: ComponentPlatformList, location_name: "componentPlatforms"))
@@ -678,6 +680,7 @@ module Aws::GreengrassV2
     ListInstalledComponentsRequest.add_member(:core_device_thing_name, Shapes::ShapeRef.new(shape: CoreDeviceThingName, required: true, location: "uri", location_name: "coreDeviceThingName"))
     ListInstalledComponentsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: DefaultMaxResults, location: "querystring", location_name: "maxResults", metadata: {"box"=>true}))
     ListInstalledComponentsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextTokenString, location: "querystring", location_name: "nextToken", metadata: {"box"=>true}))
+    ListInstalledComponentsRequest.add_member(:topology_filter, Shapes::ShapeRef.new(shape: InstalledComponentTopologyFilter, location: "querystring", location_name: "topologyFilter", metadata: {"box"=>true}))
     ListInstalledComponentsRequest.struct_class = Types::ListInstalledComponentsRequest
 
     ListInstalledComponentsResponse.add_member(:installed_components, Shapes::ShapeRef.new(shape: InstalledComponentList, location_name: "installedComponents"))

data/lib/aws-sdk-greengrassv2/types.rb

@@ -612,10 +612,10 @@ module Aws::GreengrassV2
     #
     # @!attribute [rw] attributes
     #   A dictionary of attributes for the platform. The IoT Greengrass Core
-    #   software defines the `os` and `platform` by default. You can specify
-    #   additional platform attributes for a core device when you deploy the
-    #   Greengrass nucleus component. For more information, see the
-    #   [Greengrass nucleus component][1] in the *IoT Greengrass V2
+    #   software defines the `os` and `architecture` by default. You can
+    #   specify additional platform attributes for a core device when you
+    #   deploy the Greengrass nucleus component. For more information, see
+    #   the [Greengrass nucleus component][1] in the *IoT Greengrass V2
     #   Developer Guide*.
     #
     #
@@ -848,7 +848,7 @@ module Aws::GreengrassV2
     #       {
     #         inline_recipe: "data",
     #         lambda_function: {
-    #           lambda_arn: "LambdaFunctionARNWithVersionNumber", # required
+    #           lambda_arn: "NonEmptyString", # required
     #           component_name: "ComponentNameString",
     #           component_version: "ComponentVersionString",
     #           component_platforms: [
@@ -1006,7 +1006,7 @@ module Aws::GreengrassV2
     #
     #       {
     #         target_arn: "TargetARN", # required
-    #         deployment_name: "NonEmptyString",
+    #         deployment_name: "DeploymentNameString",
     #         components: {
     #           "NonEmptyString" => {
     #             component_version: "ComponentVersionString",
@@ -2096,6 +2096,15 @@ module Aws::GreengrassV2
     #   Whether or not the component is a root component.
     #   @return [Boolean]
     #
+    # @!attribute [rw] last_status_change_timestamp
+    #   The status of how current the data is.
+    #
+    #   This response is based off of component state changes. The status
+    #   reflects component disruptions and deployments. If a component only
+    #   sees a configuration update during a deployment, it might not
+    #   undergo a state change and this status would not be updated.
+    #   @return [Time]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/InstalledComponent AWS API Documentation
     #
     class InstalledComponent < Struct.new(
@@ -2103,7 +2112,8 @@ module Aws::GreengrassV2
       :component_version,
       :lifecycle_state,
       :lifecycle_state_details,
-      :is_root)
+      :is_root,
+      :last_status_change_timestamp)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2623,7 +2633,7 @@ module Aws::GreengrassV2
     #   data as a hash:
     #
     #       {
-    #         lambda_arn: "LambdaFunctionARNWithVersionNumber", # required
+    #         lambda_arn: "NonEmptyString", # required
     #         component_name: "ComponentNameString",
     #         component_version: "ComponentVersionString",
     #         component_platforms: [
@@ -3181,6 +3191,7 @@ module Aws::GreengrassV2
     #         core_device_thing_name: "CoreDeviceThingName", # required
     #         max_results: 1,
     #         next_token: "NextTokenString",
+    #         topology_filter: "ALL", # accepts ALL, ROOT
     #       }
     #
     # @!attribute [rw] core_device_thing_name
@@ -3195,18 +3206,40 @@ module Aws::GreengrassV2
     #   The token to be used for the next set of paginated results.
     #   @return [String]
     #
+    # @!attribute [rw] topology_filter
+    #   The filter for the list of components. Choose from the following
+    #   options:
+    #
+    #   * `ALL` – The list includes all components installed on the core
+    #     device.
+    #
+    #   * `ROOT` – The list includes only *root* components, which are
+    #     components that you specify in a deployment. When you choose this
+    #     option, the list doesn't include components that the core device
+    #     installs as dependencies of other components.
+    #
+    #   Default: `ROOT`
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ListInstalledComponentsRequest AWS API Documentation
     #
     class ListInstalledComponentsRequest < Struct.new(
       :core_device_thing_name,
       :max_results,
-      :next_token)
+      :next_token,
+      :topology_filter)
       SENSITIVE = []
       include Aws::Structure
     end
 
     # @!attribute [rw] installed_components
     #   A list that summarizes each component on the core device.
+    #
+    #   <note markdown="1"> Accuracy of the `lastStatusChangeTimestamp` response depends on
+    #   Greengrass nucleus v2.7.0. It performs best on Greengrass nucleus
+    #   v2.7.0 and can be inaccurate on earlier versions.
+    #
+    #    </note>
     #   @return [Array<Types::InstalledComponent>]
     #
     # @!attribute [rw] next_token

data/lib/aws-sdk-greengrassv2.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-greengrassv2/customizations'
 # @!group service
 module Aws::GreengrassV2
 
-  GEM_VERSION = '1.18.0'
+  GEM_VERSION = '1.19.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-greengrassv2
 version: !ruby/object:Gem::Version
-  version: 1.18.0
+  version: 1.19.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-18 00:00:00.000000000 Z
+date: 2022-08-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core