aws-sdk-applicationsignals 1.30.0 → 1.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f7e5943cda12c39031deff5c3d057a928e1b927cf975d9408bdb322dce1cc91
-  data.tar.gz: 445e4ba40576f2919be85cf39eaa4144446baeb17bba8b99bd7884000d087530
+  metadata.gz: 19f9fc9145deb4642fea3edc66f85dc888c31dbe8c3eb24bbdc5ce45106fd827
+  data.tar.gz: 4588f22b076f10fabced98a3b5e00fb1ef988cae43fde43da168a23673384555
 SHA512:
-  metadata.gz: 69a68246368f2b94efcf841437b73138cf1189f82b0dc2216281ac2da0597791dd31f26d3e42c4401bbe41ae27cc490c46207adca45601c50849ca784ef3d6df
-  data.tar.gz: ed83d71ab3752274bb6d2f7e6463b353ea74289337d6cea691395ed4d96de4e142631b8c1bd659be806052f590756d0e62f61e4dfeb935075d745d2ba11061ae
+  metadata.gz: 0f59fefbbab21b7d4defe187169fa63ff9ccb99c8c972a0c2af91c596d2e125f9f10f1dc58705edfce47b6d0d1495c03f117b02664317ae8e337c8c0117d70dd
+  data.tar.gz: 9bca175b85bb2394030f971157b921adbffd42d8e02d5bdc5c93ec9b494a080e670bffcbf471c19b4fcc4acf0f12e0396117bc689a15eabb7c27d2e2b001dd5c

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.31.0 (2025-10-28)
+------------------
+
+* Feature - Added support for CloudWatch Synthetics Canary resources in ListAuditFindings API. This enhancement allows customers to retrieve audit findings specifically for CloudWatch Synthetics canaries and enables service-canary correlation analysis.
+
 1.30.0 (2025-10-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.30.0
+1.31.0

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

@@ -1112,8 +1112,13 @@ module Aws::ApplicationSignals
       req.send_request(options)
     end
 
-    # Deletes the grouping configuration for this account. This removes all
-    # custom grouping attribute definitions that were previously configured.
+    # Deletes a grouping configuration that defines how services are grouped
+    # and organized in Application Signals. Once deleted, services will no
+    # longer be grouped according to the specified configuration rules.
+    #
+    # This operation is irreversible. After deletion, you must recreate the
+    # grouping configuration if you want to restore the same grouping
+    # behavior.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1370,72 +1375,41 @@ module Aws::ApplicationSignals
       req.send_request(options)
     end
 
-    # Returns a list of audit findings that provide automated analysis of
-    # service behavior and root cause analysis. These findings help identify
-    # the most significant observations about your services, including
-    # performance issues, anomalies, and potential problems. The findings
-    # are generated using heuristic algorithms based on established
-    # troubleshooting patterns.
+    # Retrieves a list of audit findings for Application Signals resources.
+    # Audit findings identify potential issues, misconfigurations, or
+    # compliance violations in your observability setup.
+    #
+    # You can filter findings by time range, auditor type, and target
+    # resources to focus on specific areas of concern. This operation
+    # supports pagination for large result sets.
     #
     # @option params [required, Time,DateTime,Date,Integer,String] :start_time
-    #   The start of the time period to retrieve audit findings for. When used
-    #   in a raw HTTP Query API, it is formatted as epoch time in seconds. For
-    #   example, `1698778057`
+    #   The start time for the audit findings query. Only findings created on
+    #   or after this time will be included in the results. Specify the time
+    #   as the number of milliseconds since January 1, 1970, 00:00:00 UTC.
     #
     # @option params [required, Time,DateTime,Date,Integer,String] :end_time
-    #   The end of the time period to retrieve audit findings for. When used
-    #   in a raw HTTP Query API, it is formatted as epoch time in seconds. For
-    #   example, `1698778057`
+    #   The end time for the audit findings query. Only findings created
+    #   before this time will be included in the results. Specify the time as
+    #   the number of milliseconds since January 1, 1970, 00:00:00 UTC.
     #
     # @option params [Array<String>] :auditors
-    #   A list of auditor names to filter the findings by. Only findings
-    #   generated by the specified auditors will be returned.
-    #
-    #   The following auditors are available for configuration:
-    #
-    #   * `slo` - SloAuditor: Identifies SLO violations and detects breached
-    #     thresholds during the Assessment phase.
-    #
-    #   * `operation_metric` - OperationMetricAuditor: Detects anomalies in
-    #     service operation metrics from Application Signals RED metrics
-    #     during the Assessment phase
-    #
-    #   * `service_quota` - ServiceQuotaAuditor: Monitors resource utilization
-    #     against service quotas during the Assessment phase
-    #
-    #   * `trace` - TraceAuditor: Performs deep-dive analysis of distributed
-    #     traces, correlating traces with breached SLOs or abnormal RED
-    #     metrics during the Analysis phase
-    #
-    #   * `dependency_metric` - CriticalPathAuditor: Analyzes service
-    #     dependency impacts and maps dependency relationships from
-    #     Application Signals RED metrics during the Analysis phase
-    #
-    #   * `top_contributor` - TopContributorAuditor: Identifies
-    #     infrastructure-level contributors to issues by analyzing EMF logs of
-    #     Application Signals RED metrics during the Analysis phase
-    #
-    #   * `log` - LogAuditor: Extracts insights from application logs,
-    #     categorizing error types and ranking severity by frequency during
-    #     the Analysis phase
-    #
-    #   <note markdown="1"> `InitAuditor` and `Summarizer` auditors are not configurable as they
-    #   are automatically triggered during the audit process.
-    #
-    #    </note>
+    #   An array of auditor names to filter the findings. Only findings
+    #   generated by the specified auditors will be returned. When not
+    #   specified, findings from all auditors are included except canary.
     #
     # @option params [required, Array<Types::AuditTarget>] :audit_targets
-    #   A list of audit targets to filter the findings by. You can specify
-    #   services, SLOs, or service operations to limit the audit findings to
-    #   specific entities.
+    #   An array of audit target specifications to filter the findings. Only
+    #   findings related to the specified targets (such as specific services,
+    #   SLOs, operations or canary) will be returned.
     #
     # @option params [String] :next_token
-    #   Include this value, if it was returned by the previous operation, to
-    #   get the next set of audit findings.
+    #   The token for the next set of results. Use this token to retrieve
+    #   additional pages of audit findings when the result set is large.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of audit findings to return in one operation. If
-    #   you omit this parameter, the default of 10 is used.
+    #   The maximum number of audit findings to return in a single request.
+    #   Valid range is 1 to 100. If not specified, defaults to 50.
     #
     # @return [Types::ListAuditFindingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1472,6 +1446,9 @@ module Aws::ApplicationSignals
     #             operation: "String",
     #             metric_type: "String",
     #           },
+    #           canary: {
+    #             canary_name: "String", # required
+    #           },
     #         },
     #       },
     #     ],
@@ -1532,15 +1509,17 @@ module Aws::ApplicationSignals
       req.send_request(options)
     end
 
-    # Returns the current grouping configuration for this account, including
-    # all custom grouping attribute definitions that have been configured.
-    # These definitions determine how services are logically grouped based
-    # on telemetry attributes, Amazon Web Services tags, or predefined
-    # mappings.
+    # Retrieves the available grouping attribute definitions that can be
+    # used to create grouping configurations. These definitions specify the
+    # attributes and rules available for organizing services.
+    #
+    # Use this operation to discover what grouping options are available
+    # before creating or updating grouping configurations.
     #
     # @option params [String] :next_token
-    #   Include this value, if it was returned by the previous operation, to
-    #   get the next set of grouping attribute definitions.
+    #   The token for the next set of results. Use this token to retrieve
+    #   additional pages of grouping attribute definitions when the result set
+    #   is large.
     #
     # @return [Types::ListGroupingAttributeDefinitionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2032,41 +2011,48 @@ module Aws::ApplicationSignals
       req.send_request(options)
     end
 
-    # Returns information about the last deployment and other change states
-    # of services. This API provides visibility into recent changes that may
-    # have affected service performance, helping with troubleshooting and
-    # change correlation.
+    # Retrieves the current state information for services monitored by
+    # Application Signals. Service states include health status, recent
+    # change events, and other operational metadata.
+    #
+    # You can filter results by time range, AWS account, and service
+    # attributes to focus on specific services or time periods. This
+    # operation supports pagination and can include data from linked
+    # accounts.
     #
     # @option params [required, Time,DateTime,Date,Integer,String] :start_time
-    #   The start of the time period to retrieve service state information
-    #   for. When used in a raw HTTP Query API, it is formatted as epoch time
-    #   in seconds. For example, `1698778057`.
+    #   The start time for the service states query. Only service states from
+    #   this time onward will be included. Specify the time as the number of
+    #   milliseconds since January 1, 1970, 00:00:00 UTC.
     #
     # @option params [required, Time,DateTime,Date,Integer,String] :end_time
-    #   The end of the time period to retrieve service state information for.
-    #   When used in a raw HTTP Query API, it is formatted as epoch time in
-    #   seconds. For example, `1698778057`.
+    #   The end time for the service states query. Only service states before
+    #   this time will be included. Specify the time as the number of
+    #   milliseconds since January 1, 1970, 00:00:00 UTC.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of service states to return in one operation. If
-    #   you omit this parameter, the default of 20 is used.
+    #   The maximum number of service states to return in a single request.
+    #   Valid range is 1 to 100. If not specified, defaults to 50.
     #
     # @option params [String] :next_token
-    #   Include this value, if it was returned by the previous operation, to
-    #   get the next set of service states.
+    #   The token for the next set of results. Use this token to retrieve
+    #   additional pages of service states when the result set is large.
     #
     # @option params [Boolean] :include_linked_accounts
-    #   If you are using this operation in a monitoring account, specify
-    #   `true` to include service states from source accounts in the returned
-    #   data.
+    #   Specifies whether to include service states from linked AWS accounts
+    #   in the results. Set to `true` to include linked accounts, or `false`
+    #   to only include the current account. Defaults to `false`.
     #
     # @option params [String] :aws_account_id
-    #   The Amazon Web Services account ID to filter service states by. Use
-    #   this to limit results to services from a specific account.
+    #   The AWS account ID to filter service states. If specified, only
+    #   service states from this account will be returned. If not specified,
+    #   service states from the current account (and linked accounts if
+    #   enabled) are returned.
     #
     # @option params [Array<Types::AttributeFilter>] :attribute_filters
-    #   A list of attribute filters to narrow down the services. You can
-    #   filter by platform, environment, or other service attributes.
+    #   An array of attribute filters to narrow down the service states
+    #   returned. Each filter specifies an attribute name and the values to
+    #   match against.
     #
     # @return [Types::ListServiceStatesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2256,17 +2242,19 @@ module Aws::ApplicationSignals
       req.send_request(options)
     end
 
-    # Creates or updates the grouping configuration for this account. This
-    # operation allows you to define custom grouping attributes that
-    # determine how services are logically grouped based on telemetry
-    # attributes, Amazon Web Services tags, or predefined mappings. These
-    # grouping attributes can then be used to organize and filter services
-    # in the Application Signals console and APIs.
+    # Creates or updates a grouping configuration that defines how services
+    # are organized and grouped in Application Signals dashboards and
+    # service maps.
+    #
+    # Grouping configurations allow you to logically organize services based
+    # on attributes such as environment, team ownership, or business
+    # function, making it easier to monitor and manage related services
+    # together.
     #
     # @option params [required, Array<Types::GroupingAttributeDefinition>] :grouping_attribute_definitions
     #   An array of grouping attribute definitions that specify how services
-    #   should be grouped. Each definition includes a friendly name, source
-    #   keys to derive the grouping value from, and an optional default value.
+    #   should be grouped. Each definition includes the grouping name, source
+    #   keys, and default values.
     #
     # @return [Types::PutGroupingConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2763,7 +2751,7 @@ module Aws::ApplicationSignals
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-applicationsignals'
-      context[:gem_version] = '1.30.0'
+      context[:gem_version] = '1.31.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -51,6 +51,7 @@ module Aws::ApplicationSignals
     BurnRateLookBackWindowMinutes = Shapes::IntegerShape.new(name: 'BurnRateLookBackWindowMinutes')
     CalendarInterval = Shapes::StructureShape.new(name: 'CalendarInterval')
     CalendarIntervalDuration = Shapes::IntegerShape.new(name: 'CalendarIntervalDuration')
+    CanaryEntity = Shapes::StructureShape.new(name: 'CanaryEntity')
     ChangeEvent = Shapes::StructureShape.new(name: 'ChangeEvent')
     ChangeEventType = Shapes::StringShape.new(name: 'ChangeEventType')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
@@ -264,10 +265,12 @@ module Aws::ApplicationSignals
     AuditTargetEntity.add_member(:service, Shapes::ShapeRef.new(shape: ServiceEntity, location_name: "Service"))
     AuditTargetEntity.add_member(:slo, Shapes::ShapeRef.new(shape: ServiceLevelObjectiveEntity, location_name: "Slo"))
     AuditTargetEntity.add_member(:service_operation, Shapes::ShapeRef.new(shape: ServiceOperationEntity, location_name: "ServiceOperation"))
+    AuditTargetEntity.add_member(:canary, Shapes::ShapeRef.new(shape: CanaryEntity, location_name: "Canary"))
     AuditTargetEntity.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     AuditTargetEntity.add_member_subclass(:service, Types::AuditTargetEntity::Service)
     AuditTargetEntity.add_member_subclass(:slo, Types::AuditTargetEntity::Slo)
     AuditTargetEntity.add_member_subclass(:service_operation, Types::AuditTargetEntity::ServiceOperation)
+    AuditTargetEntity.add_member_subclass(:canary, Types::AuditTargetEntity::Canary)
     AuditTargetEntity.add_member_subclass(:unknown, Types::AuditTargetEntity::Unknown)
     AuditTargetEntity.struct_class = Types::AuditTargetEntity
 
@@ -317,6 +320,9 @@ module Aws::ApplicationSignals
     CalendarInterval.add_member(:duration, Shapes::ShapeRef.new(shape: CalendarIntervalDuration, required: true, location_name: "Duration"))
     CalendarInterval.struct_class = Types::CalendarInterval
 
+    CanaryEntity.add_member(:canary_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "CanaryName"))
+    CanaryEntity.struct_class = Types::CanaryEntity
+
     ChangeEvent.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "Timestamp"))
     ChangeEvent.add_member(:account_id, Shapes::ShapeRef.new(shape: AwsAccountId, required: true, location_name: "AccountId"))
     ChangeEvent.add_member(:region, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Region"))