aws-sdk-greengrassv2 1.18.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a20b98f0c1a619ea993ac0938897b731febaa493eb18bf54db65fa903ef6e03
-  data.tar.gz: 7549d80ce88d8a1d05543ed3b35f5d76574c0cb3d655e1ac7edfd578a96dccfb
+  metadata.gz: e4be62bb05304634040b32dfe8e4e781d709bcb654df1c2c3c7972302a0f4f3e
+  data.tar.gz: a6ba7ad02ceb51c6a1374ba36d2e1cbd93445c7427616bd2babae9760b8d6f5d
 SHA512:
-  metadata.gz: 3732f4a9405968d2cdda986c1e8130f33e8bb9e968942d111966a47fa0e14d9f02ecc4b2776719a3962a28fdd30baa00c2ce6e98771ab21602b14be79501c0ac
-  data.tar.gz: e5d93c0346d6ee0f2e736f754807b6bdc598be2670bd73defe6fa7d0d721bbc02e1494ab175fbda3ee44056eaa30a34df9bea036b191bde3532e7cafe2e26380
+  metadata.gz: e7cb044f1c79716a083e9f83e9c65833b68c69f69e947f24a3b4962e97d3f697166fba867fcc08cf0811efe59be264b7c9fcdd83a917e5750578dee12a73ea6b
+  data.tar.gz: d157bff3230b875f524ac958b45d2202991c6652f94d6669db71034e3f73d5f95afec1d7369d47e687327188f01a02cfd546db04ce8d6e0c9325fa850bdb44b2

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.20.0 (2022-10-07)
+------------------
+
+* Feature - This release adds error status details for deployments and components that failed on a device and adds features to improve visibility into component installation.
+
+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.20.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>
     #
     #
@@ -1696,6 +1700,10 @@ module Aws::GreengrassV2
     #   resp.effective_deployments[0].reason #=> String
     #   resp.effective_deployments[0].creation_timestamp #=> Time
     #   resp.effective_deployments[0].modified_timestamp #=> Time
+    #   resp.effective_deployments[0].status_details.error_stack #=> Array
+    #   resp.effective_deployments[0].status_details.error_stack[0] #=> String
+    #   resp.effective_deployments[0].status_details.error_types #=> Array
+    #   resp.effective_deployments[0].status_details.error_types[0] #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ListEffectiveDeployments AWS API Documentation
@@ -1708,9 +1716,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 +1740,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 +1758,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 +1785,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 +1796,11 @@ 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.installed_components[0].last_reported_timestamp #=> Time
+    #   resp.installed_components[0].last_installation_source #=> String
+    #   resp.installed_components[0].lifecycle_status_codes #=> Array
+    #   resp.installed_components[0].lifecycle_status_codes[0] #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ListInstalledComponents AWS API Documentation
@@ -2023,7 +2055,7 @@ module Aws::GreengrassV2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-greengrassv2'
-      context[:gem_version] = '1.18.0'
+      context[:gem_version] = '1.20.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')
@@ -96,7 +97,12 @@ module Aws::GreengrassV2
     DisassociateServiceRoleFromAccountRequest = Shapes::StructureShape.new(name: 'DisassociateServiceRoleFromAccountRequest')
     DisassociateServiceRoleFromAccountResponse = Shapes::StructureShape.new(name: 'DisassociateServiceRoleFromAccountResponse')
     EffectiveDeployment = Shapes::StructureShape.new(name: 'EffectiveDeployment')
+    EffectiveDeploymentErrorCode = Shapes::StringShape.new(name: 'EffectiveDeploymentErrorCode')
+    EffectiveDeploymentErrorStack = Shapes::ListShape.new(name: 'EffectiveDeploymentErrorStack')
+    EffectiveDeploymentErrorType = Shapes::StringShape.new(name: 'EffectiveDeploymentErrorType')
+    EffectiveDeploymentErrorTypeList = Shapes::ListShape.new(name: 'EffectiveDeploymentErrorTypeList')
     EffectiveDeploymentExecutionStatus = Shapes::StringShape.new(name: 'EffectiveDeploymentExecutionStatus')
+    EffectiveDeploymentStatusDetails = Shapes::StructureShape.new(name: 'EffectiveDeploymentStatusDetails')
     EffectiveDeploymentsList = Shapes::ListShape.new(name: 'EffectiveDeploymentsList')
     FileSystemPath = Shapes::StringShape.new(name: 'FileSystemPath')
     GGCVersion = Shapes::StringShape.new(name: 'GGCVersion')
@@ -115,7 +121,10 @@ module Aws::GreengrassV2
     GetServiceRoleForAccountResponse = Shapes::StructureShape.new(name: 'GetServiceRoleForAccountResponse')
     InstalledComponent = Shapes::StructureShape.new(name: 'InstalledComponent')
     InstalledComponentLifecycleState = Shapes::StringShape.new(name: 'InstalledComponentLifecycleState')
+    InstalledComponentLifecycleStatusCode = Shapes::StringShape.new(name: 'InstalledComponentLifecycleStatusCode')
+    InstalledComponentLifecycleStatusCodeList = Shapes::ListShape.new(name: 'InstalledComponentLifecycleStatusCodeList')
     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 +158,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 +376,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"))
@@ -459,8 +467,17 @@ module Aws::GreengrassV2
     EffectiveDeployment.add_member(:reason, Shapes::ShapeRef.new(shape: Reason, location_name: "reason"))
     EffectiveDeployment.add_member(:creation_timestamp, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "creationTimestamp"))
     EffectiveDeployment.add_member(:modified_timestamp, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "modifiedTimestamp"))
+    EffectiveDeployment.add_member(:status_details, Shapes::ShapeRef.new(shape: EffectiveDeploymentStatusDetails, location_name: "statusDetails"))
     EffectiveDeployment.struct_class = Types::EffectiveDeployment
 
+    EffectiveDeploymentErrorStack.member = Shapes::ShapeRef.new(shape: EffectiveDeploymentErrorCode)
+
+    EffectiveDeploymentErrorTypeList.member = Shapes::ShapeRef.new(shape: EffectiveDeploymentErrorType)
+
+    EffectiveDeploymentStatusDetails.add_member(:error_stack, Shapes::ShapeRef.new(shape: EffectiveDeploymentErrorStack, location_name: "errorStack"))
+    EffectiveDeploymentStatusDetails.add_member(:error_types, Shapes::ShapeRef.new(shape: EffectiveDeploymentErrorTypeList, location_name: "errorTypes"))
+    EffectiveDeploymentStatusDetails.struct_class = Types::EffectiveDeploymentStatusDetails
+
     EffectiveDeploymentsList.member = Shapes::ShapeRef.new(shape: EffectiveDeployment)
 
     GetComponentRequest.add_member(:recipe_output_format, Shapes::ShapeRef.new(shape: RecipeOutputFormat, location: "querystring", location_name: "recipeOutputFormat"))
@@ -527,8 +544,14 @@ 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.add_member(:last_reported_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastReportedTimestamp"))
+    InstalledComponent.add_member(:last_installation_source, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "lastInstallationSource"))
+    InstalledComponent.add_member(:lifecycle_status_codes, Shapes::ShapeRef.new(shape: InstalledComponentLifecycleStatusCodeList, location_name: "lifecycleStatusCodes"))
     InstalledComponent.struct_class = Types::InstalledComponent
 
+    InstalledComponentLifecycleStatusCodeList.member = Shapes::ShapeRef.new(shape: InstalledComponentLifecycleStatusCode)
+
     InstalledComponentList.member = Shapes::ShapeRef.new(shape: InstalledComponent)
 
     InternalServerException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -599,7 +622,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 +701,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",
@@ -1691,6 +1691,11 @@ module Aws::GreengrassV2
     #   ISO 8601 format.
     #   @return [Time]
     #
+    # @!attribute [rw] status_details
+    #   The status details that explain why a deployment has an error. This
+    #   response will be null if the deployment is in a success state.
+    #   @return [Types::EffectiveDeploymentStatusDetails]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/EffectiveDeployment AWS API Documentation
     #
     class EffectiveDeployment < Struct.new(
@@ -1703,7 +1708,40 @@ module Aws::GreengrassV2
       :core_device_execution_status,
       :reason,
       :creation_timestamp,
-      :modified_timestamp)
+      :modified_timestamp,
+      :status_details)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains all error-related information for the deployment record. The
+    # status details will be null if the deployment is in a success state.
+    #
+    # <note markdown="1"> Greengrass nucleus v2.8.0 or later is required to get an accurate
+    # `errorStack` and `errorTypes` response. This field will not be
+    # returned for earlier Greengrass nucleus versions.
+    #
+    #  </note>
+    #
+    # @!attribute [rw] error_stack
+    #   Contains an ordered list of short error codes that range from the
+    #   most generic error to the most specific one. The error codes
+    #   describe the reason for failure whenever the
+    #   `coreDeviceExecutionStatus` is in a failed state. The response will
+    #   be an empty list if there is no error.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] error_types
+    #   Contains tags which describe the error. You can use the error types
+    #   to classify errors to assist with remediating the failure. The
+    #   response will be an empty list if there is no error.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/EffectiveDeploymentStatusDetails AWS API Documentation
+    #
+    class EffectiveDeploymentStatusDetails < Struct.new(
+      :error_stack,
+      :error_types)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2089,13 +2127,49 @@ module Aws::GreengrassV2
     #   @return [String]
     #
     # @!attribute [rw] lifecycle_state_details
-    #   The details about the lifecycle state of the component.
+    #   A detailed response about the lifecycle state of the component that
+    #   explains the reason why a component has an error or is broken.
     #   @return [String]
     #
     # @!attribute [rw] is_root
     #   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]
+    #
+    # @!attribute [rw] last_reported_timestamp
+    #   The last time the Greengrass core device sent a message containing a
+    #   certain component to the Amazon Web Services Cloud.
+    #
+    #   A component does not need to see a state change for this field to
+    #   update.
+    #   @return [Time]
+    #
+    # @!attribute [rw] last_installation_source
+    #   The most recent deployment source that brought the component to the
+    #   Greengrass core device. For a thing group deployment or thing
+    #   deployment, the source will be the The ID of the deployment. and for
+    #   local deployments it will be `LOCAL`.
+    #   @return [String]
+    #
+    # @!attribute [rw] lifecycle_status_codes
+    #   The status codes that indicate the reason for failure whenever the
+    #   `lifecycleState` has an error or is in a broken state.
+    #
+    #   <note markdown="1"> Greengrass nucleus v2.8.0 or later is required to get an accurate
+    #   `lifecycleStatusCodes` response. This response can be inaccurate in
+    #   earlier Greengrass nucleus versions.
+    #
+    #    </note>
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/InstalledComponent AWS API Documentation
     #
     class InstalledComponent < Struct.new(
@@ -2103,7 +2177,11 @@ module Aws::GreengrassV2
       :component_version,
       :lifecycle_state,
       :lifecycle_state_details,
-      :is_root)
+      :is_root,
+      :last_status_change_timestamp,
+      :last_reported_timestamp,
+      :last_installation_source,
+      :lifecycle_status_codes)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2623,7 +2701,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 +3259,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 +3274,47 @@ 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"> Greengrass nucleus v2.7.0 or later is required to get an accurate
+    #   `lastStatusChangeTimestamp` response. This response can be
+    #   inaccurate in earlier Greengrass nucleus versions.
+    #
+    #    </note>
+    #
+    #   <note markdown="1"> Greengrass nucleus v2.8.0 or later is required to get an accurate
+    #   `lastInstallationSource` and `lastReportedTimestamp` response. This
+    #   response can be inaccurate or null in earlier Greengrass nucleus
+    #   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.20.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.20.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-18 00:00:00.000000000 Z
+date: 2022-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core