CloudWatch Observability Admin Service Update: CloudWatch Observability Admin adds support for multi-region telemetry evaluation and telemetry enablement rules.

Author: AWS

.changes/next-release/feature-CloudWatchObservabilityAdminService-394fd72.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "CloudWatch Observability Admin Service",
+    "contributor": "",
+    "description": "CloudWatch Observability Admin adds support for multi-region telemetry evaluation and telemetry enablement rules."
+}

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

@@ -510,6 +510,7 @@
         "requestUri":"/StartTelemetryEvaluation",
         "responseCode":200
       },
+      "input":{"shape":"StartTelemetryEvaluationInput"},
       "errors":[
         {"shape":"AccessDeniedException"},
         {"shape":"InternalServerException"},
@@ -525,6 +526,7 @@
         "requestUri":"/StartTelemetryEvaluationForOrganization",
         "responseCode":200
       },
+      "input":{"shape":"StartTelemetryEvaluationForOrganizationInput"},
       "errors":[
         {"shape":"AccessDeniedException"},
         {"shape":"InternalServerException"},
@@ -832,6 +834,10 @@
       },
       "documentation":"<p> Defines criteria for selecting resources based on field values. </p>"
     },
+    "AllRegions":{
+      "type":"boolean",
+      "box":true
+    },
     "AwsResourceExplorerManagedViewArn":{
       "type":"string",
       "max":2048,
@@ -1517,6 +1523,14 @@
         "FailureReason":{
           "shape":"FailureReason",
           "documentation":"<p> This field describes the reason for the failure status. The field will only be populated if <code>Status</code> is <code>FAILED_START</code> or <code>FAILED_STOP</code>. </p>"
+        },
+        "HomeRegion":{
+          "shape":"Region",
+          "documentation":"<p> The Amazon Web Services Region that is designated as the home region for multi-region telemetry evaluation for the organization. The home region is the single management point for all multi-region operations on this organization. This field is only present when multi-region telemetry evaluation is active. </p>"
+        },
+        "RegionStatuses":{
+          "shape":"RegionStatuses",
+          "documentation":"<p> A list of per-region telemetry evaluation statuses for the organization. Each entry indicates the evaluation status for a specific spoke region included in the multi-region configuration. This field is only present when multi-region telemetry evaluation is active. </p>"
         }
       }
     },
@@ -1530,6 +1544,14 @@
         "FailureReason":{
           "shape":"FailureReason",
           "documentation":"<p> Describes the reason for the failure status. The field will only be populated if <code>Status</code> is <code>FAILED_START</code> or <code>FAILED_STOP</code>. </p>"
+        },
+        "HomeRegion":{
+          "shape":"Region",
+          "documentation":"<p> The Amazon Web Services Region that is designated as the home region for multi-region telemetry evaluation. The home region is the single management point for all multi-region operations on this account. This field is only present when multi-region telemetry evaluation is active. </p>"
+        },
+        "RegionStatuses":{
+          "shape":"RegionStatuses",
+          "documentation":"<p> A list of per-region telemetry evaluation statuses. Each entry indicates the evaluation status for a specific spoke region included in the multi-region configuration. This field is only present when multi-region telemetry evaluation is active. </p>"
         }
       }
     },
@@ -1584,6 +1606,18 @@
         "TelemetryRule":{
           "shape":"TelemetryRule",
           "documentation":"<p> The configuration details of the organization telemetry rule. </p>"
+        },
+        "HomeRegion":{
+          "shape":"Region",
+          "documentation":"<p> The Amazon Web Services Region where the organization telemetry rule was originally created. For replicated rules in spoke regions, this indicates the region that manages the rule. For rules created without multi-region scope, this field is not present. </p>"
+        },
+        "IsReplicated":{
+          "shape":"IsReplicated",
+          "documentation":"<p> Indicates whether this organization telemetry rule is a replica that was created in this region through multi-region fan-out from the home region. Replicated rules cannot be directly updated or deleted in the spoke region. To modify a replicated rule, make changes in the home region. </p>"
+        },
+        "RegionStatuses":{
+          "shape":"RegionStatuses",
+          "documentation":"<p> A list of per-region replication statuses for the organization telemetry rule. Each entry indicates the replication status of the rule in a specific spoke region. This field is only present for rules created with multi-region scope. </p>"
         }
       }
     },
@@ -1619,6 +1653,18 @@
         "TelemetryRule":{
           "shape":"TelemetryRule",
           "documentation":"<p> The configuration details of the telemetry rule. </p>"
+        },
+        "HomeRegion":{
+          "shape":"Region",
+          "documentation":"<p> The Amazon Web Services Region where the telemetry rule was originally created. For replicated rules in spoke regions, this indicates the region that manages the rule. For rules created without multi-region scope, this field is not present. </p>"
+        },
+        "IsReplicated":{
+          "shape":"IsReplicated",
+          "documentation":"<p> Indicates whether this telemetry rule is a replica that was created in this region through multi-region fan-out from the home region. Replicated rules cannot be directly updated or deleted in the spoke region. To modify a replicated rule, make changes in the home region. </p>"
+        },
+        "RegionStatuses":{
+          "shape":"RegionStatuses",
+          "documentation":"<p> A list of per-region replication statuses for the telemetry rule. Each entry indicates the replication status of the rule in a specific spoke region. This field is only present for rules created with multi-region scope. </p>"
         }
       }
     },
@@ -1685,6 +1731,10 @@
       },
       "exception":true
     },
+    "IsReplicated":{
+      "type":"boolean",
+      "box":true
+    },
     "LabelNameCondition":{
       "type":"structure",
       "members":{
@@ -2195,6 +2245,32 @@
       "type":"string",
       "min":1
     },
+    "RegionStatus":{
+      "type":"structure",
+      "members":{
+        "Region":{
+          "shape":"Region",
+          "documentation":"<p> The Amazon Web Services Region code (for example, <code>eu-west-1</code> or <code>us-west-2</code>) that this status applies to. </p>"
+        },
+        "Status":{
+          "shape":"String",
+          "documentation":"<p> The status of the operation in this region. For telemetry evaluation, valid values include <code>STARTING</code>, <code>RUNNING</code>, and <code>FAILED_START</code>. For telemetry rules, valid values include <code>PENDING</code>, <code>ACTIVE</code>, and <code>FAILED</code>. </p>"
+        },
+        "FailureReason":{
+          "shape":"String",
+          "documentation":"<p> The reason for a failure status in this region. This field is only populated when <code>Status</code> indicates a failure. </p>"
+        },
+        "RuleArn":{
+          "shape":"ResourceArn",
+          "documentation":"<p> The Amazon Resource Name (ARN) of the telemetry rule in this spoke region. This field is only present for telemetry rule region statuses and is populated when the rule has been successfully created in the spoke region (status is <code>ACTIVE</code>). </p>"
+        }
+      },
+      "documentation":"<p> Represents the status of a multi-region operation in a specific Amazon Web Services Region. This structure is used to report per-region progress for both telemetry evaluation and telemetry rule replication. </p>"
+    },
+    "RegionStatuses":{
+      "type":"list",
+      "member":{"shape":"RegionStatus"}
+    },
     "Regions":{
       "type":"list",
       "member":{"shape":"Region"},
@@ -2394,6 +2470,32 @@
         }
       }
     },
+    "StartTelemetryEvaluationForOrganizationInput":{
+      "type":"structure",
+      "members":{
+        "Regions":{
+          "shape":"Regions",
+          "documentation":"<p> An optional list of Amazon Web Services Regions to include in multi-region telemetry evaluation for the organization. The current region is always implicitly included and must not be specified in this list. When provided, telemetry evaluation starts in the current region and propagates to all specified regions for the organization. Mutually exclusive with <code>AllRegions</code>. If neither <code>Regions</code> nor <code>AllRegions</code> is provided, the operation applies only to the current region. </p>"
+        },
+        "AllRegions":{
+          "shape":"AllRegions",
+          "documentation":"<p> If set to <code>true</code>, telemetry evaluation for the organization starts in all Amazon Web Services Regions where Amazon CloudWatch Observability Admin is available in the current partition. The current region becomes the home region for managing multi-region evaluation for the organization. When new regions become available, evaluation automatically expands to include them. Mutually exclusive with <code>Regions</code>. </p>"
+        }
+      }
+    },
+    "StartTelemetryEvaluationInput":{
+      "type":"structure",
+      "members":{
+        "Regions":{
+          "shape":"Regions",
+          "documentation":"<p> An optional list of Amazon Web Services Regions to include in multi-region telemetry evaluation. The current region is always implicitly included and must not be specified in this list. When provided, telemetry evaluation starts in the current region and propagates to all specified regions. Mutually exclusive with <code>AllRegions</code>. If neither <code>Regions</code> nor <code>AllRegions</code> is provided, the operation applies only to the current region. </p>"
+        },
+        "AllRegions":{
+          "shape":"AllRegions",
+          "documentation":"<p> If set to <code>true</code>, telemetry evaluation starts in all Amazon Web Services Regions where Amazon CloudWatch Observability Admin is available in the current partition. The current region becomes the home region for managing multi-region evaluation. When new regions become available, evaluation automatically expands to include them. Mutually exclusive with <code>Regions</code>. </p>"
+        }
+      }
+    },
     "Status":{
       "type":"string",
       "enum":[
@@ -2704,6 +2806,14 @@
         "SelectionCriteria":{
           "shape":"String",
           "documentation":"<p> Criteria for selecting which resources the rule applies to, such as resource tags. </p>"
+        },
+        "Regions":{
+          "shape":"Regions",
+          "documentation":"<p> An optional list of Amazon Web Services Regions where this telemetry rule should be replicated. When specified, the rule is created in the home region and automatically replicated to all listed regions. Mutually exclusive with <code>AllRegions</code>. </p>"
+        },
+        "AllRegions":{
+          "shape":"AllRegions",
+          "documentation":"<p> If set to <code>true</code>, the telemetry rule is replicated to all Amazon Web Services Regions where Amazon CloudWatch Observability Admin is available in the current partition. When new regions become available, the rule automatically replicates to them. Mutually exclusive with <code>Regions</code>. </p>"
         }
       },
       "documentation":"<p> Defines how telemetry should be configured for specific Amazon Web Services resources. </p>"