AWS Greengrass Update: This release includes the ability to set run-time configuration for a Greengrass core. The Telemetry feature, also included in this release, can be configured via run-time configuration per core.

Author: AWS

.changes/next-release/feature-AWSGreengrass-0be42da.json

@@ -0,0 +1,5 @@
+{
+    "type": "feature",
+    "category": "AWS Greengrass",
+    "description": "This release includes the ability to set run-time configuration for a Greengrass core. The Telemetry feature, also included in this release, can be configured via run-time configuration per core."
+}

services/greengrass/src/main/resources/codegen-resources/service-2.json

@@ -1096,6 +1096,29 @@
       } ],
       "documentation" : "Retrieves information about a subscription definition version."
     },
+    "GetThingRuntimeConfiguration" : {
+      "name" : "GetThingRuntimeConfiguration",
+      "http" : {
+        "method" : "GET",
+        "requestUri" : "/greengrass/things/{ThingName}/runtimeconfig",
+        "responseCode" : 200
+      },
+      "input" : {
+        "shape" : "GetThingRuntimeConfigurationRequest"
+      },
+      "output" : {
+        "shape" : "GetThingRuntimeConfigurationResponse",
+        "documentation" : "Success. The response contains the runtime configuration for the given thing."
+      },
+      "errors" : [ {
+        "shape" : "BadRequestException",
+        "documentation" : "invalid request"
+      }, {
+        "shape" : "InternalServerErrorException",
+        "documentation" : "server error"
+      } ],
+      "documentation" : "Get the runtime configuration of a thing."
+    },
     "ListBulkDeploymentDetailedReports" : {
       "name" : "ListBulkDeploymentDetailedReports",
       "http" : {
@@ -1781,6 +1804,29 @@
         "documentation" : "invalid request"
       } ],
       "documentation" : "Updates a subscription definition."
+    },
+    "UpdateThingRuntimeConfiguration" : {
+      "name" : "UpdateThingRuntimeConfiguration",
+      "http" : {
+        "method" : "PUT",
+        "requestUri" : "/greengrass/things/{ThingName}/runtimeconfig",
+        "responseCode" : 200
+      },
+      "input" : {
+        "shape" : "UpdateThingRuntimeConfigurationRequest"
+      },
+      "output" : {
+        "shape" : "UpdateThingRuntimeConfigurationResponse",
+        "documentation" : "success"
+      },
+      "errors" : [ {
+        "shape" : "BadRequestException",
+        "documentation" : "invalid request"
+      }, {
+        "shape" : "InternalServerErrorException",
+        "documentation" : "server error"
+      } ],
+      "documentation" : "Updates the runtime configuration of a thing."
     }
   },
   "shapes" : {
@@ -1937,6 +1983,10 @@
         "shape" : "BulkDeployment"
       }
     },
+    "ConfigurationSyncStatus" : {
+      "type" : "string",
+      "enum" : [ "InSync", "OutOfSync" ]
+    },
     "ConnectivityInfo" : {
       "type" : "structure",
       "members" : {
@@ -4418,6 +4468,27 @@
         }
       }
     },
+    "GetThingRuntimeConfigurationRequest" : {
+      "type" : "structure",
+      "members" : {
+        "ThingName" : {
+          "shape" : "__string",
+          "location" : "uri",
+          "locationName" : "ThingName",
+          "documentation" : "The thing name."
+        }
+      },
+      "required" : [ "ThingName" ]
+    },
+    "GetThingRuntimeConfigurationResponse" : {
+      "type" : "structure",
+      "members" : {
+        "RuntimeConfiguration" : {
+          "shape" : "RuntimeConfiguration",
+          "documentation" : "Runtime configuration for a thing."
+        }
+      }
+    },
     "GroupCertificateAuthorityProperties" : {
       "type" : "structure",
       "members" : {
@@ -5466,6 +5537,26 @@
       "documentation" : "The owner setting for downloaded machine learning resources.",
       "required" : [ "GroupOwner", "GroupPermission" ]
     },
+    "RuntimeConfiguration" : {
+      "type" : "structure",
+      "members" : {
+        "TelemetryConfiguration" : {
+          "shape" : "TelemetryConfiguration",
+          "documentation" : "Configuration for telemetry service."
+        }
+      },
+      "documentation" : "Runtime configuration for a thing."
+    },
+    "RuntimeConfigurationUpdate" : {
+      "type" : "structure",
+      "members" : {
+        "TelemetryConfiguration" : {
+          "shape" : "TelemetryConfigurationUpdate",
+          "documentation" : "Configuration for telemetry service."
+        }
+      },
+      "documentation" : "Runtime configuration for a thing."
+    },
     "S3MachineLearningModelResourceData" : {
       "type" : "structure",
       "members" : {
@@ -5635,6 +5726,36 @@
         "shape" : "__string"
       }
     },
+    "Telemetry" : {
+      "type" : "string",
+      "enum" : [ "On", "Off" ]
+    },
+    "TelemetryConfiguration" : {
+      "type" : "structure",
+      "members" : {
+        "ConfigurationSyncStatus" : {
+          "shape" : "ConfigurationSyncStatus",
+          "documentation" : "Synchronization status of the device reported configuration with the desired configuration."
+        },
+        "Telemetry" : {
+          "shape" : "Telemetry",
+          "documentation" : "Configure telemetry to be on or off."
+        }
+      },
+      "documentation" : "Configuration settings for running telemetry.",
+      "required" : [ "Telemetry" ]
+    },
+    "TelemetryConfigurationUpdate" : {
+      "type" : "structure",
+      "members" : {
+        "Telemetry" : {
+          "shape" : "Telemetry",
+          "documentation" : "Configure telemetry to be on or off."
+        }
+      },
+      "documentation" : "Configuration settings for running telemetry.",
+      "required" : [ "Telemetry" ]
+    },
     "UntagResourceRequest" : {
       "type" : "structure",
       "members" : {
@@ -5899,6 +6020,26 @@
       "documentation" : "The operating system of the cores which are the targets of an update.",
       "enum" : [ "ubuntu", "raspbian", "amazon_linux", "openwrt" ]
     },
+    "UpdateThingRuntimeConfigurationRequest" : {
+      "type" : "structure",
+      "members" : {
+        "TelemetryConfiguration" : {
+          "shape" : "TelemetryConfigurationUpdate",
+          "documentation" : "Configuration for telemetry service."
+        },
+        "ThingName" : {
+          "shape" : "__string",
+          "location" : "uri",
+          "locationName" : "ThingName",
+          "documentation" : "The thing name."
+        }
+      },
+      "required" : [ "ThingName" ]
+    },
+    "UpdateThingRuntimeConfigurationResponse" : {
+      "type" : "structure",
+      "members" : { }
+    },
     "VersionInformation" : {
       "type" : "structure",
       "members" : {