diff --git a/.doc_gen/metadata/cloudwatch_metadata.yaml b/.doc_gen/metadata/cloudwatch_metadata.yaml index faf0c9aa5d9..f819c059657 100644 --- a/.doc_gen/metadata/cloudwatch_metadata.yaml +++ b/.doc_gen/metadata/cloudwatch_metadata.yaml @@ -46,13 +46,13 @@ cloudwatch_DeleteAlarms: - cloudwatch.kotlin.scenario.del.alarm.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.DeleteAlarms + - CloudWatch.dotnetv4.DeleteAlarms Java: versions: - sdk_version: 2 @@ -137,13 +137,13 @@ cloudwatch_DeleteAnomalyDetector: - cloudwatch.java2.scenario.del.anomalydetector.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.DeleteAnomalyDetector + - CloudWatch.dotnetv4.DeleteAnomalyDetector services: cloudwatch: {DeleteAnomalyDetector} cloudwatch_DeleteDashboards: @@ -168,13 +168,13 @@ cloudwatch_DeleteDashboards: - cloudwatch.java2.scenario.del.dashboard.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.DeleteDashboards + - CloudWatch.dotnetv4.DeleteDashboards services: cloudwatch: {DeleteDashboards} cloudwatch_DescribeAlarmHistory: @@ -199,13 +199,13 @@ cloudwatch_DescribeAlarmHistory: - cloudwatch.java2.scenario.get.alarm.history.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.DescribeAlarmHistory + - CloudWatch.dotnetv4.DescribeAlarmHistory services: cloudwatch: {DescribeAlarmHistory} cloudwatch_DescribeAlarms: @@ -230,13 +230,13 @@ cloudwatch_DescribeAlarms: - cloudwatch.java2.describe_alarms.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.DescribeAlarms + - CloudWatch.dotnetv4.DescribeAlarms SAP ABAP: versions: - sdk_version: 1 @@ -260,13 +260,13 @@ cloudwatch_DescribeAlarmsForMetric: languages: .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.DescribeAlarmsForMetric + - CloudWatch.dotnetv4.DescribeAlarmsForMetric Kotlin: versions: - sdk_version: 1 @@ -361,13 +361,13 @@ cloudwatch_DescribeAnomalyDetectors: - cloudwatch.java2.scenario.describe.anomalydetector.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.DescribeAnomalyDetectors + - CloudWatch.dotnetv4.DescribeAnomalyDetectors services: cloudwatch: {DescribeAnomalyDetectors} cloudwatch_DisableAlarmActions: @@ -383,13 +383,13 @@ cloudwatch_DisableAlarmActions: - cloudwatch.kotlin.disable_alarm_actions.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.DisableAlarmActions + - CloudWatch.dotnetv4.DisableAlarmActions Java: versions: - sdk_version: 2 @@ -465,13 +465,13 @@ cloudwatch_EnableAlarmActions: languages: .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.EnableAlarmActions + - CloudWatch.dotnetv4.EnableAlarmActions Kotlin: versions: - sdk_version: 1 @@ -547,13 +547,13 @@ cloudwatch_GetDashboard: languages: .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.GetDashboard + - CloudWatch.dotnetv4.GetDashboard services: cloudwatch: {GetDashboard} cloudwatch_GetMetricData: @@ -578,13 +578,13 @@ cloudwatch_GetMetricData: - cloudwatch.java2.scenario.get.met.data.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.GetMetricData + - CloudWatch.dotnetv4.GetMetricData services: cloudwatch: {GetMetricData} cloudwatch_GetMetricStatistics: @@ -609,14 +609,14 @@ cloudwatch_GetMetricStatistics: - cloudwatch.java2.scenario.display.metrics.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.GetMetricStatisticsSetup - - CloudWatch.dotnetv3.GetMetricStatistics + - CloudWatch.dotnetv4.GetMetricStatisticsSetup + - CloudWatch.dotnetv4.GetMetricStatistics Python: versions: - sdk_version: 3 @@ -651,13 +651,13 @@ cloudwatch_GetMetricWidgetImage: - cloudwatch.java2.scenario.get.metric.image.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.GetMetricImage + - CloudWatch.dotnetv4.GetMetricImage services: cloudwatch: {GetMetricWidgetImage} cloudwatch_ListDashboards: @@ -682,13 +682,13 @@ cloudwatch_ListDashboards: - cloudwatch.java2.scenario.list.dashboard.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.ListDashboards + - CloudWatch.dotnetv4.ListDashboards services: cloudwatch: {ListDashboards} cloudwatch_ListMetrics: @@ -704,13 +704,13 @@ cloudwatch_ListMetrics: - cloudwatch.kotlin.scenario.list.metrics.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.ListMetrics + - CloudWatch.dotnetv4.ListMetrics Java: versions: - sdk_version: 2 @@ -804,13 +804,13 @@ cloudwatch_PutAnomalyDetector: - cloudwatch.java2.scenario.add.anomalydetector.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.PutAnomalyDetector + - CloudWatch.dotnetv4.PutAnomalyDetector services: cloudwatch: {PutAnomalyDetector} cloudwatch_PutDashboard: @@ -835,14 +835,14 @@ cloudwatch_PutDashboard: - cloudwatch.java2.scenario.create.dashboard.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.PutDashboardSetup - - CloudWatch.dotnetv3.PutDashboard + - CloudWatch.dotnetv4.PutDashboardSetup + - CloudWatch.dotnetv4.PutDashboard services: cloudwatch: {PutDashboard} cloudwatch_PutMetricAlarm: @@ -858,13 +858,13 @@ cloudwatch_PutMetricAlarm: - cloudwatch.java2.scenario.create.alarm.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.PutMetricAlarm + - CloudWatch.dotnetv4.PutMetricAlarm Kotlin: versions: - sdk_version: 1 @@ -940,14 +940,14 @@ cloudwatch_PutMetricData: languages: .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: snippet_tags: - - CloudWatch.dotnetv3.PutMetricDataSetup - - CloudWatch.dotnetv3.PutMetricData + - CloudWatch.dotnetv4.PutMetricDataSetup + - CloudWatch.dotnetv4.PutMetricData Kotlin: versions: - sdk_version: 1 @@ -1060,16 +1060,16 @@ cloudwatch_GetStartedMetricsDashboardsAlarms: - cloudwatch.java2.actions.main .NET: versions: - - sdk_version: 3 - github: dotnetv3/CloudWatch + - sdk_version: 4 + github: dotnetv4/CloudWatch sdkguide: excerpts: - description: Run an interactive scenario at a command prompt. snippet_tags: - - CloudWatch.dotnetv3.GettingStarted + - CloudWatch.dotnetv4.GettingStarted - description: Wrapper methods used by the scenario for &CW; actions. snippet_tags: - - CloudWatch.dotnetv3.CloudWatchWrapper + - CloudWatch.dotnetv4.CloudWatchWrapper services: cloudwatch: {ListMetrics, GetMetricStatistics, PutDashboard, PutMetricData, GetMetricData, PutMetricAlarm, DescribeAlarms, DescribeAlarmsForMetric, DescribeAlarmHistory, DeleteAlarms, PutAnomalyDetector, GetMetricWidgetImage, DescribeAnomalyDetectors, diff --git a/dotnetv3/CloudWatch/Actions/CloudWatchWrapper.cs b/dotnetv3/CloudWatch/Actions/CloudWatchWrapper.cs index ac7d9c24ef2..f1962b138bb 100644 --- a/dotnetv3/CloudWatch/Actions/CloudWatchWrapper.cs +++ b/dotnetv3/CloudWatch/Actions/CloudWatchWrapper.cs @@ -243,6 +243,8 @@ public async Task> GetMetricData(int minutesOfData, bool var startTimeUtc = endDateUtc.Value.AddMinutes(-minutesOfData); // The timezone string should be in the format +0000, so use the timezone offset to format it correctly. var timeZoneString = $"{timeZoneOffset.Hours:D2}{timeZoneOffset.Minutes:D2}"; + // Add the plus sign for positive offsets. + timeZoneString = timeZoneString.StartsWith('-') ? timeZoneString : "+" + timeZoneString; var paginatedMetricData = _amazonCloudWatch.Paginators.GetMetricData( new GetMetricDataRequest() { diff --git a/dotnetv3/CloudWatch/README.md b/dotnetv3/CloudWatch/README.md index ed59b50f624..91bf1a7293d 100644 --- a/dotnetv3/CloudWatch/README.md +++ b/dotnetv3/CloudWatch/README.md @@ -42,24 +42,24 @@ Code examples that show you how to perform the essential operations within a ser Code excerpts that show you how to call individual service functions. -- [DeleteAlarms](Actions/CloudWatchWrapper.cs#L396) -- [DeleteAnomalyDetector](Actions/CloudWatchWrapper.cs#L494) -- [DeleteDashboards](Actions/CloudWatchWrapper.cs#L512) -- [DescribeAlarmHistory](Actions/CloudWatchWrapper.cs#L369) -- [DescribeAlarms](Actions/CloudWatchWrapper.cs#L326) -- [DescribeAlarmsForMetric](Actions/CloudWatchWrapper.cs#L349) -- [DescribeAnomalyDetectors](Actions/CloudWatchWrapper.cs#L468) -- [DisableAlarmActions](Actions/CloudWatchWrapper.cs#L414) -- [EnableAlarmActions](Actions/CloudWatchWrapper.cs#L432) +- [DeleteAlarms](Actions/CloudWatchWrapper.cs#L398) +- [DeleteAnomalyDetector](Actions/CloudWatchWrapper.cs#L496) +- [DeleteDashboards](Actions/CloudWatchWrapper.cs#L514) +- [DescribeAlarmHistory](Actions/CloudWatchWrapper.cs#L371) +- [DescribeAlarms](Actions/CloudWatchWrapper.cs#L328) +- [DescribeAlarmsForMetric](Actions/CloudWatchWrapper.cs#L351) +- [DescribeAnomalyDetectors](Actions/CloudWatchWrapper.cs#L470) +- [DisableAlarmActions](Actions/CloudWatchWrapper.cs#L416) +- [EnableAlarmActions](Actions/CloudWatchWrapper.cs#L434) - [GetDashboard](Actions/CloudWatchWrapper.cs#L115) - [GetMetricData](Actions/CloudWatchWrapper.cs#L226) - [GetMetricStatistics](Actions/CloudWatchWrapper.cs#L61) - [GetMetricWidgetImage](Actions/CloudWatchWrapper.cs#L175) - [ListDashboards](Actions/CloudWatchWrapper.cs#L134) - [ListMetrics](Actions/CloudWatchWrapper.cs#L33) -- [PutAnomalyDetector](Actions/CloudWatchWrapper.cs#L450) +- [PutAnomalyDetector](Actions/CloudWatchWrapper.cs#L452) - [PutDashboard](Actions/CloudWatchWrapper.cs#L91) -- [PutMetricAlarm](Actions/CloudWatchWrapper.cs#L265) +- [PutMetricAlarm](Actions/CloudWatchWrapper.cs#L267) - [PutMetricData](Actions/CloudWatchWrapper.cs#L154) diff --git a/dotnetv4/CloudWatch/Actions/CloudWatchWrapper.cs b/dotnetv4/CloudWatch/Actions/CloudWatchWrapper.cs index f43659a4c6f..334568177c5 100644 --- a/dotnetv4/CloudWatch/Actions/CloudWatchWrapper.cs +++ b/dotnetv4/CloudWatch/Actions/CloudWatchWrapper.cs @@ -243,6 +243,8 @@ public async Task> GetMetricData(int minutesOfData, bool var startTimeUtc = endDateUtc.Value.AddMinutes(-minutesOfData); // The timezone string should be in the format +0000, so use the timezone offset to format it correctly. var timeZoneString = $"{timeZoneOffset.Hours:D2}{timeZoneOffset.Minutes:D2}"; + // Add the plus sign for positive offsets. + timeZoneString = timeZoneString.StartsWith('-') ? timeZoneString : "+" + timeZoneString; var paginatedMetricData = _amazonCloudWatch.Paginators.GetMetricData( new GetMetricDataRequest() { diff --git a/dotnetv4/CloudWatch/README.md b/dotnetv4/CloudWatch/README.md index f7e07658354..1cb91877a34 100644 --- a/dotnetv4/CloudWatch/README.md +++ b/dotnetv4/CloudWatch/README.md @@ -36,6 +36,38 @@ To enable billing metrics and statistics for these examples, make sure to - [Hello CloudWatch](Actions/HelloCloudWatch.cs#L4) (`ListMetrics`) +### Basics + +Code examples that show you how to perform the essential operations within a service. + +- [Learn the basics](Scenarios/CloudWatchScenario.cs) + + +### Single actions + +Code excerpts that show you how to call individual service functions. + +- [DeleteAlarms](Actions/CloudWatchWrapper.cs#L402) +- [DeleteAnomalyDetector](Actions/CloudWatchWrapper.cs#L500) +- [DeleteDashboards](Actions/CloudWatchWrapper.cs#L518) +- [DescribeAlarmHistory](Actions/CloudWatchWrapper.cs#L375) +- [DescribeAlarms](Actions/CloudWatchWrapper.cs#L332) +- [DescribeAlarmsForMetric](Actions/CloudWatchWrapper.cs#L355) +- [DescribeAnomalyDetectors](Actions/CloudWatchWrapper.cs#L474) +- [DisableAlarmActions](Actions/CloudWatchWrapper.cs#L420) +- [EnableAlarmActions](Actions/CloudWatchWrapper.cs#L438) +- [GetDashboard](Actions/CloudWatchWrapper.cs#L115) +- [GetMetricData](Actions/CloudWatchWrapper.cs#L226) +- [GetMetricStatistics](Actions/CloudWatchWrapper.cs#L61) +- [GetMetricWidgetImage](Actions/CloudWatchWrapper.cs#L175) +- [ListDashboards](Actions/CloudWatchWrapper.cs#L134) +- [ListMetrics](Actions/CloudWatchWrapper.cs#L33) +- [PutAnomalyDetector](Actions/CloudWatchWrapper.cs#L456) +- [PutDashboard](Actions/CloudWatchWrapper.cs#L91) +- [PutMetricAlarm](Actions/CloudWatchWrapper.cs#L271) +- [PutMetricData](Actions/CloudWatchWrapper.cs#L154) + + @@ -52,6 +84,25 @@ To enable billing metrics and statistics for these examples, make sure to This example shows you how to get started using CloudWatch. +#### Learn the basics + +This example shows you how to do the following: + +- List CloudWatch namespaces and metrics. +- Get statistics for a metric and for estimated billing. +- Create and update a dashboard. +- Create and add data to a metric. +- Create and trigger an alarm, then view alarm history. +- Add an anomaly detector. +- Get a metric image, then clean up resources. + + + + + + + + ### Tests