Skip to content

CloudWatchServiceResource#

Index > CloudWatch > CloudWatchServiceResource

Auto-generated documentation for CloudWatch type annotations stubs module types-boto3-cloudwatch.

CloudWatchServiceResource#

Type annotations and code completion for boto3.resource("cloudwatch"), included resources and collections. boto3 documentation

# CloudWatchServiceResource usage example

from types_boto3_cloudwatch.service_resource import CloudWatchServiceResource

def get_cloudwatch_resource() -> CloudWatchServiceResource:
    return boto3.resource("cloudwatch")

Attributes#

  • meta: CloudWatchResourceMeta

  • alarms: ServiceResourceAlarmsCollection

  • metrics: ServiceResourceMetricsCollection

Collections#

ServiceResourceAlarmsCollection#

Provides access to Alarm resource.

Type annotations and code completion for boto3.resource("cloudwatch").alarms collection. boto3 documentation

# ServiceResourceAlarmsCollection usage example

from types_boto3_cloudwatch.service_resource import ServiceResourceAlarmsCollection

def get_collection() -> ServiceResourceAlarmsCollection:
    return boto3.resource("cloudwatch").alarms

ServiceResourceMetricsCollection#

Provides access to Metric resource.

Type annotations and code completion for boto3.resource("cloudwatch").metrics collection. boto3 documentation

# ServiceResourceMetricsCollection usage example

from types_boto3_cloudwatch.service_resource import ServiceResourceMetricsCollection

def get_collection() -> ServiceResourceMetricsCollection:
    return boto3.resource("cloudwatch").metrics

Methods#

CloudWatchServiceResource.get_available_subresources method#

Returns a list of all the available sub-resources for this resource.

Type annotations and code completion for boto3.resource("cloudwatch").get_available_subresources method. boto3 documentation

# get_available_subresources method definition

def get_available_subresources(
    self,
) -> Sequence[str]:
    ...

CloudWatchServiceResource.Alarm method#

Creates a Alarm resource.

Type annotations and code completion for boto3.resource("cloudwatch").Alarm method. boto3 documentation

# Alarm method definition

def Alarm(
    self,
    name: str,
) -> _Alarm:
    ...

CloudWatchServiceResource.Metric method#

Creates a Metric resource.

Type annotations and code completion for boto3.resource("cloudwatch").Metric method. boto3 documentation

# Metric method definition

def Metric(
    self,
    namespace: str,
    name: str,
) -> _Metric:
    ...

Alarm#

Type annotations and code completion for boto3.resource("cloudwatch").Alarm class. boto3 documentation

# Alarm usage example

from types_boto3_cloudwatch.service_resource import Alarm

def get_resource() -> Alarm:
    return boto3.resource("cloudwatch").Alarm(...)

Alarm attributes#

  • name: str
  • metric: Metric
  • alarm_name: str
  • alarm_arn: str
  • alarm_description: str
  • alarm_configuration_updated_timestamp: datetime
  • actions_enabled: bool
  • ok_actions: list[str]
  • alarm_actions: list[str]
  • insufficient_data_actions: list[str]
  • state_value: StateValueType
  • state_reason: str
  • state_reason_data: str
  • state_updated_timestamp: datetime
  • metric_name: str
  • namespace: str
  • statistic: StatisticType
  • extended_statistic: str
  • dimensions: list[DimensionTypeDef]
  • period: int
  • unit: StandardUnitType
  • evaluation_periods: int
  • datapoints_to_alarm: int
  • threshold: float
  • comparison_operator: ComparisonOperatorType
  • treat_missing_data: str
  • evaluate_low_sample_count_percentile: str
  • metrics: list[MetricDataQueryAlarmTypeDef]
  • threshold_metric_id: str
  • evaluation_state: Literal['PARTIAL_DATA'] (see EvaluationStateType)
  • state_transitioned_timestamp: datetime
  • meta: CloudWatchResourceMeta

Alarm methods#

Alarm.get_available_subresources method#

Returns a list of all the available sub-resources for this Alarm.

Type annotations and code completion for boto3.resource("cloudwatch").get_available_subresources method. boto3 documentation

# get_available_subresources method definition

def get_available_subresources(
    self,
) -> Sequence[str]:
    ...

Alarm.delete method#

Deletes the specified alarms.

Type annotations and code completion for boto3.resource("cloudwatch").delete method. boto3 documentation

# delete method definition

def delete(
    self,
) -> None:
    ...

Alarm.describe_history method#

Retrieves the history for the specified alarm.

Type annotations and code completion for boto3.resource("cloudwatch").describe_history method. boto3 documentation

# describe_history method definition

def describe_history(
    self,
    *,
    AlarmTypes: Sequence[AlarmTypeType] = ...,  # (1)
    HistoryItemType: HistoryItemTypeType = ...,  # (2)
    StartDate: TimestampTypeDef = ...,
    EndDate: TimestampTypeDef = ...,
    MaxRecords: int = ...,
    NextToken: str = ...,
    ScanBy: ScanByType = ...,  # (3)
) -> DescribeAlarmHistoryOutputTypeDef:  # (4)
    ...
  1. See AlarmTypeType
  2. See HistoryItemTypeType
  3. See ScanByType
  4. See DescribeAlarmHistoryOutputTypeDef 
# describe_history method usage example with argument unpacking

kwargs: DescribeAlarmHistoryInputAlarmDescribeHistoryTypeDef = {  # (1)
    "AlarmTypes": ...,
}

parent.describe_history(**kwargs)
  1. See DescribeAlarmHistoryInputAlarmDescribeHistoryTypeDef

Alarm.disable_actions method#

Disables the actions for the specified alarms.

Type annotations and code completion for boto3.resource("cloudwatch").disable_actions method. boto3 documentation

# disable_actions method definition

def disable_actions(
    self,
) -> None:
    ...

Alarm.enable_actions method#

Enables the actions for the specified alarms.

Type annotations and code completion for boto3.resource("cloudwatch").enable_actions method. boto3 documentation

# enable_actions method definition

def enable_actions(
    self,
) -> None:
    ...

Alarm.set_state method#

Temporarily sets the state of an alarm for testing purposes.

Type annotations and code completion for boto3.resource("cloudwatch").set_state method. boto3 documentation

# set_state method definition

def set_state(
    self,
    *,
    StateValue: StateValueType,  # (1)
    StateReason: str,
    StateReasonData: str = ...,
) -> None:
    ...
  1. See StateValueType 
# set_state method usage example with argument unpacking

kwargs: SetAlarmStateInputAlarmSetStateTypeDef = {  # (1)
    "StateValue": ...,
    "StateReason": ...,
}

parent.set_state(**kwargs)
  1. See SetAlarmStateInputAlarmSetStateTypeDef

Alarm.load method#

Type annotations and code completion for boto3.resource("cloudwatch").load method. boto3 documentation

# load method definition

def load(
    self,
) -> None:
    ...

Alarm.reload method#

Type annotations and code completion for boto3.resource("cloudwatch").reload method. boto3 documentation

# reload method definition

def reload(
    self,
) -> None:
    ...

Metric#

Type annotations and code completion for boto3.resource("cloudwatch").Metric class. boto3 documentation

# Metric usage example

from types_boto3_cloudwatch.service_resource import Metric

def get_resource() -> Metric:
    return boto3.resource("cloudwatch").Metric(...)

Metric attributes#

  • namespace: str
  • name: str
  • alarms: MetricAlarmsCollection
  • metric_name: str
  • dimensions: list[DimensionTypeDef]
  • meta: CloudWatchResourceMeta

Metric collections#

Metric.alarms#

Provides access to Alarm resource.

Type annotations and code completion for boto3.resource("cloudwatch").Metric(...).alarms collection. boto3 documentation

# MetricAlarmsCollection usage example

from types_boto3_cloudwatch.service_resource import MetricAlarmsCollection

def get_collection() -> MetricAlarmsCollection:
    resource = boto3.resource("cloudwatch").Metric(...)
    return resource.alarms

Metric methods#

Metric.get_available_subresources method#

Returns a list of all the available sub-resources for this Metric.

Type annotations and code completion for boto3.resource("cloudwatch").get_available_subresources method. boto3 documentation

# get_available_subresources method definition

def get_available_subresources(
    self,
) -> Sequence[str]:
    ...

Metric.get_statistics method#

Gets statistics for the specified metric.

Type annotations and code completion for boto3.resource("cloudwatch").get_statistics method. boto3 documentation

# get_statistics method definition

def get_statistics(
    self,
    *,
    StartTime: TimestampTypeDef,
    EndTime: TimestampTypeDef,
    Period: int,
    Dimensions: Sequence[DimensionTypeDef] = ...,  # (1)
    Statistics: Sequence[StatisticType] = ...,  # (2)
    ExtendedStatistics: Sequence[str] = ...,
    Unit: StandardUnitType = ...,  # (3)
) -> GetMetricStatisticsOutputTypeDef:  # (4)
    ...
  1. See DimensionTypeDef
  2. See StatisticType
  3. See StandardUnitType
  4. See GetMetricStatisticsOutputTypeDef 
# get_statistics method usage example with argument unpacking

kwargs: GetMetricStatisticsInputMetricGetStatisticsTypeDef = {  # (1)
    "StartTime": ...,
    "EndTime": ...,
    "Period": ...,
}

parent.get_statistics(**kwargs)
  1. See GetMetricStatisticsInputMetricGetStatisticsTypeDef

Metric.put_alarm method#

Creates or updates an alarm and associates it with the specified metric, metric math expression, anomaly detection model, or Metrics Insights query.

Type annotations and code completion for boto3.resource("cloudwatch").put_alarm method. boto3 documentation

# put_alarm method definition

def put_alarm(
    self,
    *,
    AlarmName: str,
    EvaluationPeriods: int,
    ComparisonOperator: ComparisonOperatorType,  # (1)
    AlarmDescription: str = ...,
    ActionsEnabled: bool = ...,
    OKActions: Sequence[str] = ...,
    AlarmActions: Sequence[str] = ...,
    InsufficientDataActions: Sequence[str] = ...,
    Statistic: StatisticType = ...,  # (2)
    ExtendedStatistic: str = ...,
    Dimensions: Sequence[DimensionTypeDef] = ...,  # (3)
    Period: int = ...,
    Unit: StandardUnitType = ...,  # (4)
    DatapointsToAlarm: int = ...,
    Threshold: float = ...,
    TreatMissingData: str = ...,
    EvaluateLowSampleCountPercentile: str = ...,
    Metrics: Sequence[MetricDataQueryTypeDef] = ...,  # (5)
    Tags: Sequence[TagTypeDef] = ...,  # (6)
    ThresholdMetricId: str = ...,
) -> _Alarm:
    ...
  1. See ComparisonOperatorType
  2. See StatisticType
  3. See DimensionTypeDef
  4. See StandardUnitType
  5. See MetricDataQueryTypeDef
  6. See TagTypeDef 
# put_alarm method usage example with argument unpacking

kwargs: PutMetricAlarmInputMetricPutAlarmTypeDef = {  # (1)
    "AlarmName": ...,
    "EvaluationPeriods": ...,
    "ComparisonOperator": ...,
}

parent.put_alarm(**kwargs)
  1. See PutMetricAlarmInputMetricPutAlarmTypeDef

Metric.put_data method#

Publishes metric data to Amazon CloudWatch.

Type annotations and code completion for boto3.resource("cloudwatch").put_data method. boto3 documentation

# put_data method definition

def put_data(
    self,
    *,
    EntityMetricData: Sequence[EntityMetricDataTypeDef] = ...,  # (1)
    StrictEntityValidation: bool = ...,
) -> None:
    ...
  1. See EntityMetricDataTypeDef 
# put_data method usage example with argument unpacking

kwargs: PutMetricDataInputMetricPutDataTypeDef = {  # (1)
    "EntityMetricData": ...,
}

parent.put_data(**kwargs)
  1. See PutMetricDataInputMetricPutDataTypeDef

Metric.load method#

Type annotations and code completion for boto3.resource("cloudwatch").load method. boto3 documentation

# load method definition

def load(
    self,
) -> None:
    ...

Metric.reload method#

Type annotations and code completion for boto3.resource("cloudwatch").reload method. boto3 documentation

# reload method definition

def reload(
    self,
) -> None:
    ...