aws-sdk-greengrassv2 1.19.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77a7d6316272826d8cd4f92ee7df041ea0faed036d47095134f04ecf90b98dfc
-  data.tar.gz: 74b760c485f5a81768e024a229a27311407e0e98f5b40ba24388f64474d4a3c1
+  metadata.gz: e4be62bb05304634040b32dfe8e4e781d709bcb654df1c2c3c7972302a0f4f3e
+  data.tar.gz: a6ba7ad02ceb51c6a1374ba36d2e1cbd93445c7427616bd2babae9760b8d6f5d
 SHA512:
-  metadata.gz: 2c39c85779db816c1d9649dc879fe6b479cf391ec7355e5cc0e40cba4329609bb44c783127956a9bc112caf2fba3a755b8b636806b16b8caee69717ed0855fab
-  data.tar.gz: 25638e619b299500a33f8b6e169f6787ab6281902a7985607fc40487943d22340f77f450cf20aa8a9a20b339445cb80b0a1ba839ea29623fc76f668e7022076b
+  metadata.gz: e7cb044f1c79716a083e9f83e9c65833b68c69f69e947f24a3b4962e97d3f697166fba867fcc08cf0811efe59be264b7c9fcdd83a917e5750578dee12a73ea6b
+  data.tar.gz: d157bff3230b875f524ac958b45d2202991c6652f94d6669db71034e3f73d5f95afec1d7369d47e687327188f01a02cfd546db04ce8d6e0c9325fa850bdb44b2

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.19.0
+1.20.0

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

@@ -1700,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
@@ -1793,6 +1797,10 @@ module Aws::GreengrassV2
     #   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
@@ -2047,7 +2055,7 @@ module Aws::GreengrassV2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-greengrassv2'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.20.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -97,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')
@@ -116,6 +121,8 @@ 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')
@@ -460,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"))
@@ -529,8 +545,13 @@ module Aws::GreengrassV2
     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"))

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

@@ -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,7 +2127,8 @@ 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
@@ -2105,6 +2144,32 @@ module Aws::GreengrassV2
     #   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(
@@ -2113,7 +2178,10 @@ module Aws::GreengrassV2
       :lifecycle_state,
       :lifecycle_state_details,
       :is_root,
-      :last_status_change_timestamp)
+      :last_status_change_timestamp,
+      :last_reported_timestamp,
+      :last_installation_source,
+      :lifecycle_status_codes)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3235,9 +3303,16 @@ module Aws::GreengrassV2
     # @!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 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>]

data/lib/aws-sdk-greengrassv2.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-greengrassv2/customizations'
 # @!group service
 module Aws::GreengrassV2
 
-  GEM_VERSION = '1.19.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.19.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-08-30 00:00:00.000000000 Z
+date: 2022-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core