aws-sdk-greengrassv2 1.16.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac3cca4df5f89147e0dbb52238f9c9531c21de47f2c353184cba011ab4fe9188
-  data.tar.gz: 89e7fa02fd54e6a82acc91156157a7775bf09f4209957ef648719350a4e0f61b
+  metadata.gz: 77a7d6316272826d8cd4f92ee7df041ea0faed036d47095134f04ecf90b98dfc
+  data.tar.gz: 74b760c485f5a81768e024a229a27311407e0e98f5b40ba24388f64474d4a3c1
 SHA512:
-  metadata.gz: bf2e308e18264fb40eb1f1bf2290b1f237db2ab274096b3a0feb51a1571b9dab657af950bd757009a7b5cd148eb954c82856442f40618e6c9d5f19f6f491ac45
-  data.tar.gz: 17b325a888eb3e729a335d8798ebdb200a4b56ad89a640a7d47b34e723bcc98da77fd491f3b25ac47757fb33f4553f96a1adc0eab15e016b910c0d6d30b19bc0
+  metadata.gz: 2c39c85779db816c1d9649dc879fe6b479cf391ec7355e5cc0e40cba4329609bb44c783127956a9bc112caf2fba3a755b8b636806b16b8caee69717ed0855fab
+  data.tar.gz: 25638e619b299500a33f8b6e169f6787ab6281902a7985607fc40487943d22340f77f450cf20aa8a9a20b339445cb80b0a1ba839ea29623fc76f668e7022076b

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 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)
+------------------
+
+* 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.
+
+1.17.0 (2022-03-03)
+------------------
+
+* Feature - Doc only update that clarifies Create Deployment section.
+
 1.16.0 (2022-02-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.16.0
+1.19.0

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

@@ -559,12 +559,18 @@ module Aws::GreengrassV2
     #
     #   * Python 3.8 – `python3.8`
     #
+    #   * Python 3.9 – `python3.9`
+    #
     #   * Java 8 – `java8`
     #
+    #   * Java 11 – `java11`
+    #
     #   * Node.js 10 – `nodejs10.x`
     #
     #   * Node.js 12 – `nodejs12.x`
     #
+    #   * Node.js 14 – `nodejs14.x`
+    #
     #   To create a component from a Lambda function, specify
     #   `lambdaFunction` when you call this operation.
     #
@@ -624,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: [
@@ -699,6 +705,8 @@ module Aws::GreengrassV2
     #   resp.status.message #=> String
     #   resp.status.errors #=> Hash
     #   resp.status.errors["NonEmptyString"] #=> String
+    #   resp.status.vendor_guidance #=> String, one of "ACTIVE", "DISCONTINUED", "DELETED"
+    #   resp.status.vendor_guidance_message #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/CreateComponentVersion AWS API Documentation
     #
@@ -721,8 +729,7 @@ module Aws::GreengrassV2
     #
     # Every deployment has a revision number that indicates how many
     # deployment revisions you define for a target. Use this operation to
-    # create a new revision of an existing deployment. This operation
-    # returns the revision number of the new deployment when you create it.
+    # create a new revision of an existing deployment.
     #
     # For more information, see the [Create deployments][1] in the *IoT
     # Greengrass V2 Developer Guide*.
@@ -787,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",
@@ -926,6 +933,38 @@ module Aws::GreengrassV2
       req.send_request(options)
     end
 
+    # Deletes a deployment. To delete an active deployment, you must first
+    # cancel it. For more information, see [CancelDeployment][1].
+    #
+    # Deleting a deployment doesn't affect core devices that run that
+    # deployment, because core devices store the deployment's configuration
+    # on the device. Additionally, core devices can roll back to a previous
+    # deployment that has been deleted.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot/latest/apireference/API_CancelDeployment.html
+    #
+    # @option params [required, String] :deployment_id
+    #   The ID of the deployment.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_deployment({
+    #     deployment_id: "NonEmptyString", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/DeleteDeployment AWS API Documentation
+    #
+    # @overload delete_deployment(params = {})
+    # @param [Hash] params ({})
+    def delete_deployment(params = {}, options = {})
+      req = build_request(:delete_deployment, params)
+      req.send_request(options)
+    end
+
     # Retrieves metadata for a version of a component.
     #
     # @option params [required, String] :arn
@@ -965,6 +1004,8 @@ module Aws::GreengrassV2
     #   resp.status.message #=> String
     #   resp.status.errors #=> Hash
     #   resp.status.errors["NonEmptyString"] #=> String
+    #   resp.status.vendor_guidance #=> String, one of "ACTIVE", "DISCONTINUED", "DELETED"
+    #   resp.status.vendor_guidance_message #=> String
     #   resp.platforms #=> Array
     #   resp.platforms[0].name #=> String
     #   resp.platforms[0].attributes #=> Hash
@@ -1009,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.
@@ -1052,13 +1091,13 @@ module Aws::GreengrassV2
       req.send_request(options)
     end
 
-    # Gets the pre-signed URL to download a public component artifact. Core
-    # devices call this operation to identify the URL that they can use to
-    # download an artifact to install.
+    # Gets the pre-signed URL to download a public or a Lambda component
+    # artifact. Core devices call this operation to identify the URL that
+    # they can use to download an artifact to install.
     #
     # @option params [required, String] :arn
-    #   The [ARN][1] of the component version. Specify the ARN of a public
-    #   component version.
+    #   The [ARN][1] of the component version. Specify the ARN of a public or
+    #   a Lambda component version.
     #
     #
     #
@@ -1105,11 +1144,11 @@ module Aws::GreengrassV2
     #
     # Connectivity information includes endpoints and ports where client
     # devices can connect to an MQTT broker on the core device. When a
-    # client device calls the [Greengrass discovery API][1], IoT Greengrass
-    # returns connectivity information for all of the core devices where the
-    # client device can connect. For more information, see [Connect client
-    # devices to core devices][2] in the *IoT Greengrass Version 2 Developer
-    # Guide*.
+    # client device calls the [IoT Greengrass discovery API][1], IoT
+    # Greengrass returns connectivity information for all of the core
+    # devices where the client device can connect. For more information, see
+    # [Connect client devices to core devices][2] in the *IoT Greengrass
+    # Version 2 Developer Guide*.
     #
     #
     #
@@ -1150,6 +1189,34 @@ module Aws::GreengrassV2
 
     # Retrieves metadata for a Greengrass core device.
     #
+    # <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
+    # isn't running on the device, or if device isn't connected to the
+    # Amazon Web Services Cloud, then the reported status of that device
+    # might not reflect its current status. The status timestamp indicates
+    # when the device status was last updated.
+    #
+    #  Core devices send status updates at the following times:
+    #
+    #  * When the IoT Greengrass Core software starts
+    #
+    # * When the core device receives a deployment from the Amazon Web
+    #   Services Cloud
+    #
+    # * When the status of any component on the core device becomes `BROKEN`
+    #
+    # * 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>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration-fss
+    #
     # @option params [required, String] :core_device_thing_name
     #   The name of the core device. This is also the name of the IoT thing.
     #
@@ -1341,7 +1408,7 @@ module Aws::GreengrassV2
     # versions are listed first.
     #
     # @option params [required, String] :arn
-    #   The [ARN][1] of the component version.
+    #   The [ARN][1] of the component.
     #
     #
     #
@@ -1441,10 +1508,40 @@ module Aws::GreengrassV2
 
     # Retrieves a paginated list of Greengrass core devices.
     #
+    # <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
+    # isn't running on the device, or if device isn't connected to the
+    # Amazon Web Services Cloud, then the reported status of that device
+    # might not reflect its current status. The status timestamp indicates
+    # when the device status was last updated.
+    #
+    #  Core devices send status updates at the following times:
+    #
+    #  * When the IoT Greengrass Core software starts
+    #
+    # * When the core device receives a deployment from the Amazon Web
+    #   Services Cloud
+    #
+    # * When the status of any component on the core device becomes `BROKEN`
+    #
+    # * 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>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration-fss
+    #
     # @option params [String] :thing_group_arn
     #   The [ARN][1] of the IoT thing group by which to filter. If you specify
-    #   this parameter, the list includes only core devices that are members
-    #   of this thing group.
+    #   this parameter, the list includes only core devices that have
+    #   successfully deployed a deployment that targets the thing group. When
+    #   you remove a core device from a thing group, the list continues to
+    #   include that core device.
     #
     #
     #
@@ -1615,7 +1712,38 @@ module Aws::GreengrassV2
     end
 
     # Retrieves a paginated list of the components that a Greengrass core
-    # device runs.
+    # 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
+    # isn't running on the device, or if device isn't connected to the
+    # Amazon Web Services Cloud, then the reported status of that device
+    # might not reflect its current status. The status timestamp indicates
+    # when the device status was last updated.
+    #
+    #  Core devices send status updates at the following times:
+    #
+    #  * When the IoT Greengrass Core software starts
+    #
+    # * When the core device receives a deployment from the Amazon Web
+    #   Services Cloud
+    #
+    # * When the status of any component on the core device becomes `BROKEN`
+    #
+    # * 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>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration-fss
     #
     # @option params [required, String] :core_device_thing_name
     #   The name of the core device. This is also the name of the IoT thing.
@@ -1626,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;
@@ -1639,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
@@ -1649,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
@@ -1718,10 +1862,10 @@ module Aws::GreengrassV2
     #
     # [1]: https://docs.aws.amazon.com/general/latest/gr/greengrass.html
     #
-    # @option params [required, Types::ComponentPlatform] :platform
+    # @option params [Types::ComponentPlatform] :platform
     #   The platform to use to resolve compatible components.
     #
-    # @option params [required, Array<Types::ComponentCandidate>] :component_candidates
+    # @option params [Array<Types::ComponentCandidate>] :component_candidates
     #   The list of components to resolve.
     #
     # @return [Types::ResolveComponentCandidatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1731,13 +1875,13 @@ module Aws::GreengrassV2
     # @example Request syntax with placeholder values
     #
     #   resp = client.resolve_component_candidates({
-    #     platform: { # required
+    #     platform: {
     #       name: "NonEmptyString",
     #       attributes: {
     #         "NonEmptyString" => "NonEmptyString",
     #       },
     #     },
-    #     component_candidates: [ # required
+    #     component_candidates: [
     #       {
     #         component_name: "ComponentNameString",
     #         component_version: "ComponentVersionString",
@@ -1755,6 +1899,8 @@ module Aws::GreengrassV2
     #   resp.resolved_component_versions[0].component_name #=> String
     #   resp.resolved_component_versions[0].component_version #=> String
     #   resp.resolved_component_versions[0].recipe #=> String
+    #   resp.resolved_component_versions[0].vendor_guidance #=> String, one of "ACTIVE", "DISCONTINUED", "DELETED"
+    #   resp.resolved_component_versions[0].message #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ResolveComponentCandidates AWS API Documentation
     #
@@ -1838,11 +1984,11 @@ module Aws::GreengrassV2
     #
     # Connectivity information includes endpoints and ports where client
     # devices can connect to an MQTT broker on the core device. When a
-    # client device calls the [Greengrass discovery API][1], IoT Greengrass
-    # returns connectivity information for all of the core devices where the
-    # client device can connect. For more information, see [Connect client
-    # devices to core devices][2] in the *IoT Greengrass Version 2 Developer
-    # Guide*.
+    # client device calls the [IoT Greengrass discovery API][1], IoT
+    # Greengrass returns connectivity information for all of the core
+    # devices where the client device can connect. For more information, see
+    # [Connect client devices to core devices][2] in the *IoT Greengrass
+    # Version 2 Developer Guide*.
     #
     #
     #
@@ -1901,7 +2047,7 @@ module Aws::GreengrassV2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-greengrassv2'
-      context[:gem_version] = '1.16.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -72,6 +72,7 @@ module Aws::GreengrassV2
     DefaultMaxResults = Shapes::IntegerShape.new(name: 'DefaultMaxResults')
     DeleteComponentRequest = Shapes::StructureShape.new(name: 'DeleteComponentRequest')
     DeleteCoreDeviceRequest = Shapes::StructureShape.new(name: 'DeleteCoreDeviceRequest')
+    DeleteDeploymentRequest = Shapes::StructureShape.new(name: 'DeleteDeploymentRequest')
     Deployment = Shapes::StructureShape.new(name: 'Deployment')
     DeploymentComponentUpdatePolicy = Shapes::StructureShape.new(name: 'DeploymentComponentUpdatePolicy')
     DeploymentComponentUpdatePolicyAction = Shapes::StringShape.new(name: 'DeploymentComponentUpdatePolicyAction')
@@ -82,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')
@@ -115,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')
@@ -148,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')
@@ -214,6 +216,7 @@ module Aws::GreengrassV2
     ValidationExceptionField = Shapes::StructureShape.new(name: 'ValidationExceptionField')
     ValidationExceptionFieldList = Shapes::ListShape.new(name: 'ValidationExceptionFieldList')
     ValidationExceptionReason = Shapes::StringShape.new(name: 'ValidationExceptionReason')
+    VendorGuidance = Shapes::StringShape.new(name: 'VendorGuidance')
     connectivityInfoList = Shapes::ListShape.new(name: 'connectivityInfoList')
 
     AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -266,6 +269,8 @@ module Aws::GreengrassV2
     CloudComponentStatus.add_member(:component_state, Shapes::ShapeRef.new(shape: CloudComponentState, location_name: "componentState"))
     CloudComponentStatus.add_member(:message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "message"))
     CloudComponentStatus.add_member(:errors, Shapes::ShapeRef.new(shape: StringMap, location_name: "errors"))
+    CloudComponentStatus.add_member(:vendor_guidance, Shapes::ShapeRef.new(shape: VendorGuidance, location_name: "vendorGuidance"))
+    CloudComponentStatus.add_member(:vendor_guidance_message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "vendorGuidanceMessage"))
     CloudComponentStatus.struct_class = Types::CloudComponentStatus
 
     Component.add_member(:arn, Shapes::ShapeRef.new(shape: ComponentARN, location_name: "arn"))
@@ -364,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"))
@@ -383,6 +388,9 @@ module Aws::GreengrassV2
     DeleteCoreDeviceRequest.add_member(:core_device_thing_name, Shapes::ShapeRef.new(shape: CoreDeviceThingName, required: true, location: "uri", location_name: "coreDeviceThingName"))
     DeleteCoreDeviceRequest.struct_class = Types::DeleteCoreDeviceRequest
 
+    DeleteDeploymentRequest.add_member(:deployment_id, Shapes::ShapeRef.new(shape: NonEmptyString, required: true, location: "uri", location_name: "deploymentId"))
+    DeleteDeploymentRequest.struct_class = Types::DeleteDeploymentRequest
+
     Deployment.add_member(:target_arn, Shapes::ShapeRef.new(shape: TargetARN, location_name: "targetArn"))
     Deployment.add_member(:revision_id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "revisionId"))
     Deployment.add_member(:deployment_id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "deploymentId"))
@@ -520,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)
@@ -592,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"))
@@ -671,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"))
@@ -689,8 +699,8 @@ module Aws::GreengrassV2
     RequestAlreadyInProgressException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     RequestAlreadyInProgressException.struct_class = Types::RequestAlreadyInProgressException
 
-    ResolveComponentCandidatesRequest.add_member(:platform, Shapes::ShapeRef.new(shape: ComponentPlatform, required: true, location_name: "platform"))
-    ResolveComponentCandidatesRequest.add_member(:component_candidates, Shapes::ShapeRef.new(shape: ComponentCandidateList, required: true, location_name: "componentCandidates"))
+    ResolveComponentCandidatesRequest.add_member(:platform, Shapes::ShapeRef.new(shape: ComponentPlatform, location_name: "platform"))
+    ResolveComponentCandidatesRequest.add_member(:component_candidates, Shapes::ShapeRef.new(shape: ComponentCandidateList, location_name: "componentCandidates"))
     ResolveComponentCandidatesRequest.struct_class = Types::ResolveComponentCandidatesRequest
 
     ResolveComponentCandidatesResponse.add_member(:resolved_component_versions, Shapes::ShapeRef.new(shape: ResolvedComponentVersionsList, location_name: "resolvedComponentVersions"))
@@ -700,6 +710,8 @@ module Aws::GreengrassV2
     ResolvedComponentVersion.add_member(:component_name, Shapes::ShapeRef.new(shape: ComponentNameString, location_name: "componentName"))
     ResolvedComponentVersion.add_member(:component_version, Shapes::ShapeRef.new(shape: ComponentVersionString, location_name: "componentVersion"))
     ResolvedComponentVersion.add_member(:recipe, Shapes::ShapeRef.new(shape: RecipeBlob, location_name: "recipe"))
+    ResolvedComponentVersion.add_member(:vendor_guidance, Shapes::ShapeRef.new(shape: VendorGuidance, location_name: "vendorGuidance"))
+    ResolvedComponentVersion.add_member(:message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "message"))
     ResolvedComponentVersion.struct_class = Types::ResolvedComponentVersion
 
     ResolvedComponentVersionsList.member = Shapes::ShapeRef.new(shape: ResolvedComponentVersion)
@@ -860,6 +872,7 @@ module Aws::GreengrassV2
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
         o.errors << Shapes::ShapeRef.new(shape: RequestAlreadyInProgressException)
       end)
 
@@ -891,6 +904,20 @@ module Aws::GreengrassV2
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)
       end)
 
+      api.add_operation(:delete_deployment, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DeleteDeployment"
+        o.http_method = "DELETE"
+        o.http_request_uri = "/greengrass/v2/deployments/{deploymentId}"
+        o.input = Shapes::ShapeRef.new(shape: DeleteDeploymentRequest)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+      end)
+
       api.add_operation(:describe_component, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeComponent"
         o.http_method = "GET"
@@ -1030,6 +1057,7 @@ module Aws::GreengrassV2
         o.output = Shapes::ShapeRef.new(shape: ListComponentsResponse)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
         o[:pager] = Aws::Pager.new(
@@ -1134,9 +1162,9 @@ module Aws::GreengrassV2
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
-        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
       end)
 
       api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|

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

@@ -255,30 +255,59 @@ module Aws::GreengrassV2
       include Aws::Structure
     end
 
-    # Contains the status of a component in the IoT Greengrass service.
+    # Contains the status of a component version in the IoT Greengrass
+    # service.
     #
     # @!attribute [rw] component_state
-    #   The state of the component.
+    #   The state of the component version.
     #   @return [String]
     #
     # @!attribute [rw] message
     #   A message that communicates details, such as errors, about the
-    #   status of the component.
+    #   status of the component version.
     #   @return [String]
     #
     # @!attribute [rw] errors
-    #   A dictionary of errors that communicate why the component is in an
-    #   error state. For example, if IoT Greengrass can't access an
-    #   artifact for the component, then `errors` contains the artifact's
-    #   URI as a key, and the error message as the value for that key.
+    #   A dictionary of errors that communicate why the component version is
+    #   in an error state. For example, if IoT Greengrass can't access an
+    #   artifact for the component version, then `errors` contains the
+    #   artifact's URI as a key, and the error message as the value for
+    #   that key.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] vendor_guidance
+    #   The vendor guidance state for the component version. This state
+    #   indicates whether the component version has any issues that you
+    #   should consider before you deploy it. The vendor guidance state can
+    #   be:
+    #
+    #   * `ACTIVE` – This component version is available and recommended for
+    #     use.
+    #
+    #   * `DISCONTINUED` – This component version has been discontinued by
+    #     its publisher. You can deploy this component version, but we
+    #     recommend that you use a different version of this component.
+    #
+    #   * `DELETED` – This component version has been deleted by its
+    #     publisher, so you can't deploy it. If you have any existing
+    #     deployments that specify this component version, those deployments
+    #     will fail.
+    #   @return [String]
+    #
+    # @!attribute [rw] vendor_guidance_message
+    #   A message that communicates details about the vendor guidance state
+    #   of the component version. This message communicates why a component
+    #   version is discontinued or deleted.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/CloudComponentStatus AWS API Documentation
     #
     class CloudComponentStatus < Struct.new(
       :component_state,
       :message,
-      :errors)
+      :errors,
+      :vendor_guidance,
+      :vendor_guidance_message)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -583,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*.
     #
     #
@@ -819,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: [
@@ -977,7 +1006,7 @@ module Aws::GreengrassV2
     #
     #       {
     #         target_arn: "TargetARN", # required
-    #         deployment_name: "NonEmptyString",
+    #         deployment_name: "DeploymentNameString",
     #         components: {
     #           "NonEmptyString" => {
     #             component_version: "ComponentVersionString",
@@ -1173,6 +1202,25 @@ module Aws::GreengrassV2
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DeleteDeploymentRequest
+    #   data as a hash:
+    #
+    #       {
+    #         deployment_id: "NonEmptyString", # required
+    #       }
+    #
+    # @!attribute [rw] deployment_id
+    #   The ID of the deployment.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/DeleteDeploymentRequest AWS API Documentation
+    #
+    class DeleteDeploymentRequest < Struct.new(
+      :deployment_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information about a deployment.
     #
     # @!attribute [rw] target_arn
@@ -1727,7 +1775,7 @@ module Aws::GreengrassV2
     #
     # @!attribute [rw] arn
     #   The [ARN][1] of the component version. Specify the ARN of a public
-    #   component version.
+    #   or a Lambda component version.
     #
     #
     #
@@ -2048,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(
@@ -2055,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
@@ -2575,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: [
@@ -2845,7 +2903,7 @@ module Aws::GreengrassV2
     #       }
     #
     # @!attribute [rw] arn
-    #   The [ARN][1] of the component version.
+    #   The [ARN][1] of the component.
     #
     #
     #
@@ -2951,8 +3009,10 @@ module Aws::GreengrassV2
     #
     # @!attribute [rw] thing_group_arn
     #   The [ARN][1] of the IoT thing group by which to filter. If you
-    #   specify this parameter, the list includes only core devices that are
-    #   members of this thing group.
+    #   specify this parameter, the list includes only core devices that
+    #   have successfully deployed a deployment that targets the thing
+    #   group. When you remove a core device from a thing group, the list
+    #   continues to include that core device.
     #
     #
     #
@@ -3131,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
@@ -3145,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
@@ -3233,13 +3316,13 @@ module Aws::GreengrassV2
     #   data as a hash:
     #
     #       {
-    #         platform: { # required
+    #         platform: {
     #           name: "NonEmptyString",
     #           attributes: {
     #             "NonEmptyString" => "NonEmptyString",
     #           },
     #         },
-    #         component_candidates: [ # required
+    #         component_candidates: [
     #           {
     #             component_name: "ComponentNameString",
     #             component_version: "ComponentVersionString",
@@ -3304,13 +3387,40 @@ module Aws::GreengrassV2
     #   The recipe of the component version.
     #   @return [String]
     #
+    # @!attribute [rw] vendor_guidance
+    #   The vendor guidance state for the component version. This state
+    #   indicates whether the component version has any issues that you
+    #   should consider before you deploy it. The vendor guidance state can
+    #   be:
+    #
+    #   * `ACTIVE` – This component version is available and recommended for
+    #     use.
+    #
+    #   * `DISCONTINUED` – This component version has been discontinued by
+    #     its publisher. You can deploy this component version, but we
+    #     recommend that you use a different version of this component.
+    #
+    #   * `DELETED` – This component version has been deleted by its
+    #     publisher, so you can't deploy it. If you have any existing
+    #     deployments that specify this component version, those deployments
+    #     will fail.
+    #   @return [String]
+    #
+    # @!attribute [rw] message
+    #   A message that communicates details about the vendor guidance state
+    #   of the component version. This message communicates why a component
+    #   version is discontinued or deleted.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ResolvedComponentVersion AWS API Documentation
     #
     class ResolvedComponentVersion < Struct.new(
       :arn,
       :component_name,
       :component_version,
-      :recipe)
+      :recipe,
+      :vendor_guidance,
+      :message)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-greengrassv2.rb

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