AWS cli: ECS update-service: document Service Connect proxy containerConfigurations/logLevel
Summary
Adds the same `containerConfigurations` (tagged union with `logLevel`) documentation to the update-service reference, including a JSON syntax example (`"containerConfigurations": [ { "logLevel": "debug"|"info" } ]`), the min/max constraints, and the note that settings apply only to tasks launched after the update. Also bumps the AWS CLI version footer from 2.38.1 to 2.38.2.
Security assessment
Documentation-only addition of a new Service Connect proxy log-level parameter and its JSON syntax for the update-service API; no permissions, credentials, encryption, or exposure semantics are changed and no CVE/advisory is cited. Only tangential security relevance via log verbosity, hence low severity.
Evidence
+>>>> The log level of the Service Connect proxy container. Set the log level to `debug` to collect more detailed proxy logs when you troubleshoot connectivity issues between services, and set it back to `info` when you finish. Debug logging increases the volume of logs that the proxy container writes. If you don’t specify a log level, the default is `info` .
Diff
diff --git a/cli/latest/reference/ecs/update-service.md b/cli/latest/reference/ecs/update-service.md index 1766eef..9a3da3f 100644 --- a//cli/latest/reference/ecs/update-service.md +++ b//cli/latest/reference/ecs/update-service.md @@ -15 +15 @@ - * [AWS CLI 2.38.1 Command Reference](../../index.html) » + * [AWS CLI 2.38.2 Command Reference](../../index.html) » @@ -1526,0 +1527,32 @@ JSON Syntax: +> +> containerConfigurations -> (list) +> +>> The settings for the Service Connect proxy container that Amazon ECS adds to each task in this service. Each object in the list sets exactly one setting, and each setting can appear only once in the list. +>> +>> Your changes to these settings apply only to tasks that Amazon ECS launches after you update the service. Your running tasks keep their existing settings until Amazon ECS replaces them. If you update the `serviceConnectConfiguration` of your service and don’t include `containerConfigurations` , the proxy container settings return to their defaults. +>> +>> Constraints: +>> +>> * min: `0` +>> * max: `10` +>> + +>> +>> (tagged union structure) +>> +>>> Contains a configuration setting for the Service Connect proxy container, such as the log level. Specify exactly one member in each object. +>>> +>>> ### Note +>>> +>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `logLevel`. +>>> +>>> logLevel -> (string) +>>> +>>>> The log level of the Service Connect proxy container. Set the log level to `debug` to collect more detailed proxy logs when you troubleshoot connectivity issues between services, and set it back to `info` when you finish. Debug logging increases the volume of logs that the proxy container writes. If you don’t specify a log level, the default is `info` . +>>>> +>>>> Possible values: +>>>> +>>>> * `debug` +>>>> * `info` +>>>> + @@ -1582,0 +1615,4 @@ JSON Syntax: + }, + "containerConfigurations": [ + { + "logLevel": "debug"|"info" @@ -1583,0 +1620,2 @@ JSON Syntax: + ... + ] @@ -4434,0 +4473,32 @@ service -> (structure) +>>>> +>>>> containerConfigurations -> (list) +>>>> +>>>>> The settings for the Service Connect proxy container that Amazon ECS adds to each task in this service. Each object in the list sets exactly one setting, and each setting can appear only once in the list. +>>>>> +>>>>> Your changes to these settings apply only to tasks that Amazon ECS launches after you update the service. Your running tasks keep their existing settings until Amazon ECS replaces them. If you update the `serviceConnectConfiguration` of your service and don’t include `containerConfigurations` , the proxy container settings return to their defaults. +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `0` +>>>>> * max: `10` +>>>>> + +>>>>> +>>>>> (tagged union structure) +>>>>> +>>>>>> Contains a configuration setting for the Service Connect proxy container, such as the log level. Specify exactly one member in each object. +>>>>>> +>>>>>> ### Note +>>>>>> +>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `logLevel`. +>>>>>> +>>>>>> logLevel -> (string) +>>>>>> +>>>>>>> The log level of the Service Connect proxy container. Set the log level to `debug` to collect more detailed proxy logs when you troubleshoot connectivity issues between services, and set it back to `info` when you finish. Debug logging increases the volume of logs that the proxy container writes. If you don’t specify a log level, the default is `info` . +>>>>>>> +>>>>>>> Possible values: +>>>>>>> +>>>>>>> * `debug` +>>>>>>> * `info` +>>>>>>> + @@ -5052 +5122 @@ service -> (structure) - * [AWS CLI 2.38.1 Command Reference](../../index.html) » + * [AWS CLI 2.38.2 Command Reference](../../index.html) »