Class AlertPolicy.Builder (3.21.0)

public static final class AlertPolicy.Builder extends GeneratedMessageV3.Builder<AlertPolicy.Builder> implements AlertPolicyOrBuilder

A description of the conditions under which some aspect of your system is considered to be "unhealthy" and the ways to notify people or services about this state. For an overview of alert policies, see Introduction to Alerting.

Protobuf type google.monitoring.v3.AlertPolicy

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addAllConditions(Iterable<? extends AlertPolicy.Condition> values)

public AlertPolicy.Builder addAllConditions(Iterable<? extends AlertPolicy.Condition> values)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameter
NameDescription
valuesIterable<? extends com.google.monitoring.v3.AlertPolicy.Condition>
Returns
TypeDescription
AlertPolicy.Builder

addAllNotificationChannels(Iterable<String> values)

public AlertPolicy.Builder addAllNotificationChannels(Iterable<String> values)

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur on an already opened incident. Each element of this array corresponds to the name field in each of the NotificationChannel objects that are returned from the [ListNotificationChannels] [google.monitoring.v3.NotificationChannelService.ListNotificationChannels] method. The format of the entries in this field is:

 projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

repeated string notification_channels = 14;

Parameter
NameDescription
valuesIterable<String>

The notificationChannels to add.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

addConditions(AlertPolicy.Condition value)

public AlertPolicy.Builder addConditions(AlertPolicy.Condition value)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameter
NameDescription
valueAlertPolicy.Condition
Returns
TypeDescription
AlertPolicy.Builder

addConditions(AlertPolicy.Condition.Builder builderForValue)

public AlertPolicy.Builder addConditions(AlertPolicy.Condition.Builder builderForValue)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameter
NameDescription
builderForValueAlertPolicy.Condition.Builder
Returns
TypeDescription
AlertPolicy.Builder

addConditions(int index, AlertPolicy.Condition value)

public AlertPolicy.Builder addConditions(int index, AlertPolicy.Condition value)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameters
NameDescription
indexint
valueAlertPolicy.Condition
Returns
TypeDescription
AlertPolicy.Builder

addConditions(int index, AlertPolicy.Condition.Builder builderForValue)

public AlertPolicy.Builder addConditions(int index, AlertPolicy.Condition.Builder builderForValue)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameters
NameDescription
indexint
builderForValueAlertPolicy.Condition.Builder
Returns
TypeDescription
AlertPolicy.Builder

addConditionsBuilder()

public AlertPolicy.Condition.Builder addConditionsBuilder()

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Returns
TypeDescription
AlertPolicy.Condition.Builder

addConditionsBuilder(int index)

public AlertPolicy.Condition.Builder addConditionsBuilder(int index)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameter
NameDescription
indexint
Returns
TypeDescription
AlertPolicy.Condition.Builder

addNotificationChannels(String value)

public AlertPolicy.Builder addNotificationChannels(String value)

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur on an already opened incident. Each element of this array corresponds to the name field in each of the NotificationChannel objects that are returned from the [ListNotificationChannels] [google.monitoring.v3.NotificationChannelService.ListNotificationChannels] method. The format of the entries in this field is:

 projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

repeated string notification_channels = 14;

Parameter
NameDescription
valueString

The notificationChannels to add.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

addNotificationChannelsBytes(ByteString value)

public AlertPolicy.Builder addNotificationChannelsBytes(ByteString value)

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur on an already opened incident. Each element of this array corresponds to the name field in each of the NotificationChannel objects that are returned from the [ListNotificationChannels] [google.monitoring.v3.NotificationChannelService.ListNotificationChannels] method. The format of the entries in this field is:

 projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

repeated string notification_channels = 14;

Parameter
NameDescription
valueByteString

The bytes of the notificationChannels to add.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public AlertPolicy.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
AlertPolicy.Builder
Overrides

build()

public AlertPolicy build()
Returns
TypeDescription
AlertPolicy

buildPartial()

public AlertPolicy buildPartial()
Returns
TypeDescription
AlertPolicy

clear()

public AlertPolicy.Builder clear()
Returns
TypeDescription
AlertPolicy.Builder
Overrides

clearAlertStrategy()

public AlertPolicy.Builder clearAlertStrategy()

Control over how this alert policy's notification channels are notified.

.google.monitoring.v3.AlertPolicy.AlertStrategy alert_strategy = 21;

Returns
TypeDescription
AlertPolicy.Builder

clearCombiner()

public AlertPolicy.Builder clearCombiner()

How to combine the results of multiple conditions to determine if an incident should be opened. If condition_time_series_query_language is present, this must be COMBINE_UNSPECIFIED.

.google.monitoring.v3.AlertPolicy.ConditionCombinerType combiner = 6;

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

clearConditions()

public AlertPolicy.Builder clearConditions()

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Returns
TypeDescription
AlertPolicy.Builder

clearCreationRecord()

public AlertPolicy.Builder clearCreationRecord()

A read-only record of the creation of the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord creation_record = 10;

Returns
TypeDescription
AlertPolicy.Builder

clearDisplayName()

public AlertPolicy.Builder clearDisplayName()

A short name or phrase used to identify the policy in dashboards, notifications, and incidents. To avoid confusion, don't use the same display name for multiple policies in the same project. The name is limited to 512 Unicode characters.

string display_name = 2;

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

clearDocumentation()

public AlertPolicy.Builder clearDocumentation()

Documentation that is included with notifications and incidents related to this policy. Best practice is for the documentation to include information to help responders understand, mitigate, escalate, and correct the underlying problems detected by the alerting policy. Notification channels that have limited capacity might not show this documentation.

.google.monitoring.v3.AlertPolicy.Documentation documentation = 13;

Returns
TypeDescription
AlertPolicy.Builder

clearEnabled()

public AlertPolicy.Builder clearEnabled()

Whether or not the policy is enabled. On write, the default interpretation if unset is that the policy is enabled. On read, clients should not make any assumption about the state if it has not been populated. The field should always be populated on List and Get operations, unless a field projection has been specified that strips it out.

.google.protobuf.BoolValue enabled = 17;

Returns
TypeDescription
AlertPolicy.Builder

clearField(Descriptors.FieldDescriptor field)

public AlertPolicy.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
AlertPolicy.Builder
Overrides

clearMutationRecord()

public AlertPolicy.Builder clearMutationRecord()

A read-only record of the most recent change to the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord mutation_record = 11;

Returns
TypeDescription
AlertPolicy.Builder

clearName()

public AlertPolicy.Builder clearName()

Required if the policy exists. The resource name for this policy. The format is:

 projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

[ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is created. When calling the alertPolicies.create method, do not include the name field in the alerting policy passed as part of the request.

string name = 1;

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

clearNotificationChannels()

public AlertPolicy.Builder clearNotificationChannels()

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur on an already opened incident. Each element of this array corresponds to the name field in each of the NotificationChannel objects that are returned from the [ListNotificationChannels] [google.monitoring.v3.NotificationChannelService.ListNotificationChannels] method. The format of the entries in this field is:

 projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

repeated string notification_channels = 14;

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public AlertPolicy.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
AlertPolicy.Builder
Overrides

clearUserLabels()

public AlertPolicy.Builder clearUserLabels()
Returns
TypeDescription
AlertPolicy.Builder

clearValidity()

public AlertPolicy.Builder clearValidity()

Read-only description of how the alert policy is invalid. OK if the alert policy is valid. If not OK, the alert policy will not generate incidents.

.google.rpc.Status validity = 18;

Returns
TypeDescription
AlertPolicy.Builder

clone()

public AlertPolicy.Builder clone()
Returns
TypeDescription
AlertPolicy.Builder
Overrides

containsUserLabels(String key)

public boolean containsUserLabels(String key)

User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.

The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.

map<string, string> user_labels = 16;

Parameter
NameDescription
keyString
Returns
TypeDescription
boolean

getAlertStrategy()

public AlertPolicy.AlertStrategy getAlertStrategy()

Control over how this alert policy's notification channels are notified.

.google.monitoring.v3.AlertPolicy.AlertStrategy alert_strategy = 21;

Returns
TypeDescription
AlertPolicy.AlertStrategy

The alertStrategy.

getAlertStrategyBuilder()

public AlertPolicy.AlertStrategy.Builder getAlertStrategyBuilder()

Control over how this alert policy's notification channels are notified.

.google.monitoring.v3.AlertPolicy.AlertStrategy alert_strategy = 21;

Returns
TypeDescription
AlertPolicy.AlertStrategy.Builder

getAlertStrategyOrBuilder()

public AlertPolicy.AlertStrategyOrBuilder getAlertStrategyOrBuilder()

Control over how this alert policy's notification channels are notified.

.google.monitoring.v3.AlertPolicy.AlertStrategy alert_strategy = 21;

Returns
TypeDescription
AlertPolicy.AlertStrategyOrBuilder

getCombiner()

public AlertPolicy.ConditionCombinerType getCombiner()

How to combine the results of multiple conditions to determine if an incident should be opened. If condition_time_series_query_language is present, this must be COMBINE_UNSPECIFIED.

.google.monitoring.v3.AlertPolicy.ConditionCombinerType combiner = 6;

Returns
TypeDescription
AlertPolicy.ConditionCombinerType

The combiner.

getCombinerValue()

public int getCombinerValue()

How to combine the results of multiple conditions to determine if an incident should be opened. If condition_time_series_query_language is present, this must be COMBINE_UNSPECIFIED.

.google.monitoring.v3.AlertPolicy.ConditionCombinerType combiner = 6;

Returns
TypeDescription
int

The enum numeric value on the wire for combiner.

getConditions(int index)

public AlertPolicy.Condition getConditions(int index)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameter
NameDescription
indexint
Returns
TypeDescription
AlertPolicy.Condition

getConditionsBuilder(int index)

public AlertPolicy.Condition.Builder getConditionsBuilder(int index)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameter
NameDescription
indexint
Returns
TypeDescription
AlertPolicy.Condition.Builder

getConditionsBuilderList()

public List<AlertPolicy.Condition.Builder> getConditionsBuilderList()

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Returns
TypeDescription
List<Builder>

getConditionsCount()

public int getConditionsCount()

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Returns
TypeDescription
int

getConditionsList()

public List<AlertPolicy.Condition> getConditionsList()

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Returns
TypeDescription
List<Condition>

getConditionsOrBuilder(int index)

public AlertPolicy.ConditionOrBuilder getConditionsOrBuilder(int index)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameter
NameDescription
indexint
Returns
TypeDescription
AlertPolicy.ConditionOrBuilder

getConditionsOrBuilderList()

public List<? extends AlertPolicy.ConditionOrBuilder> getConditionsOrBuilderList()

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Returns
TypeDescription
List<? extends com.google.monitoring.v3.AlertPolicy.ConditionOrBuilder>

getCreationRecord()

public MutationRecord getCreationRecord()

A read-only record of the creation of the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord creation_record = 10;

Returns
TypeDescription
MutationRecord

The creationRecord.

getCreationRecordBuilder()

public MutationRecord.Builder getCreationRecordBuilder()

A read-only record of the creation of the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord creation_record = 10;

Returns
TypeDescription
MutationRecord.Builder

getCreationRecordOrBuilder()

public MutationRecordOrBuilder getCreationRecordOrBuilder()

A read-only record of the creation of the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord creation_record = 10;

Returns
TypeDescription
MutationRecordOrBuilder

getDefaultInstanceForType()

public AlertPolicy getDefaultInstanceForType()
Returns
TypeDescription
AlertPolicy

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getDisplayName()

public String getDisplayName()

A short name or phrase used to identify the policy in dashboards, notifications, and incidents. To avoid confusion, don't use the same display name for multiple policies in the same project. The name is limited to 512 Unicode characters.

string display_name = 2;

Returns
TypeDescription
String

The displayName.

getDisplayNameBytes()

public ByteString getDisplayNameBytes()

A short name or phrase used to identify the policy in dashboards, notifications, and incidents. To avoid confusion, don't use the same display name for multiple policies in the same project. The name is limited to 512 Unicode characters.

string display_name = 2;

Returns
TypeDescription
ByteString

The bytes for displayName.

getDocumentation()

public AlertPolicy.Documentation getDocumentation()

Documentation that is included with notifications and incidents related to this policy. Best practice is for the documentation to include information to help responders understand, mitigate, escalate, and correct the underlying problems detected by the alerting policy. Notification channels that have limited capacity might not show this documentation.

.google.monitoring.v3.AlertPolicy.Documentation documentation = 13;

Returns
TypeDescription
AlertPolicy.Documentation

The documentation.

getDocumentationBuilder()

public AlertPolicy.Documentation.Builder getDocumentationBuilder()

Documentation that is included with notifications and incidents related to this policy. Best practice is for the documentation to include information to help responders understand, mitigate, escalate, and correct the underlying problems detected by the alerting policy. Notification channels that have limited capacity might not show this documentation.

.google.monitoring.v3.AlertPolicy.Documentation documentation = 13;

Returns
TypeDescription
AlertPolicy.Documentation.Builder

getDocumentationOrBuilder()

public AlertPolicy.DocumentationOrBuilder getDocumentationOrBuilder()

Documentation that is included with notifications and incidents related to this policy. Best practice is for the documentation to include information to help responders understand, mitigate, escalate, and correct the underlying problems detected by the alerting policy. Notification channels that have limited capacity might not show this documentation.

.google.monitoring.v3.AlertPolicy.Documentation documentation = 13;

Returns
TypeDescription
AlertPolicy.DocumentationOrBuilder

getEnabled()

public BoolValue getEnabled()

Whether or not the policy is enabled. On write, the default interpretation if unset is that the policy is enabled. On read, clients should not make any assumption about the state if it has not been populated. The field should always be populated on List and Get operations, unless a field projection has been specified that strips it out.

.google.protobuf.BoolValue enabled = 17;

Returns
TypeDescription
BoolValue

The enabled.

getEnabledBuilder()

public BoolValue.Builder getEnabledBuilder()

Whether or not the policy is enabled. On write, the default interpretation if unset is that the policy is enabled. On read, clients should not make any assumption about the state if it has not been populated. The field should always be populated on List and Get operations, unless a field projection has been specified that strips it out.

.google.protobuf.BoolValue enabled = 17;

Returns
TypeDescription
Builder

getEnabledOrBuilder()

public BoolValueOrBuilder getEnabledOrBuilder()

Whether or not the policy is enabled. On write, the default interpretation if unset is that the policy is enabled. On read, clients should not make any assumption about the state if it has not been populated. The field should always be populated on List and Get operations, unless a field projection has been specified that strips it out.

.google.protobuf.BoolValue enabled = 17;

Returns
TypeDescription
BoolValueOrBuilder

getMutableUserLabels()

public Map<String,String> getMutableUserLabels()

Use alternate mutation accessors instead.

Returns
TypeDescription
Map<String,String>

getMutationRecord()

public MutationRecord getMutationRecord()

A read-only record of the most recent change to the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord mutation_record = 11;

Returns
TypeDescription
MutationRecord

The mutationRecord.

getMutationRecordBuilder()

public MutationRecord.Builder getMutationRecordBuilder()

A read-only record of the most recent change to the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord mutation_record = 11;

Returns
TypeDescription
MutationRecord.Builder

getMutationRecordOrBuilder()

public MutationRecordOrBuilder getMutationRecordOrBuilder()

A read-only record of the most recent change to the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord mutation_record = 11;

Returns
TypeDescription
MutationRecordOrBuilder

getName()

public String getName()

Required if the policy exists. The resource name for this policy. The format is:

 projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

[ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is created. When calling the alertPolicies.create method, do not include the name field in the alerting policy passed as part of the request.

string name = 1;

Returns
TypeDescription
String

The name.

getNameBytes()

public ByteString getNameBytes()

Required if the policy exists. The resource name for this policy. The format is:

 projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

[ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is created. When calling the alertPolicies.create method, do not include the name field in the alerting policy passed as part of the request.

string name = 1;

Returns
TypeDescription
ByteString

The bytes for name.

getNotificationChannels(int index)

public String getNotificationChannels(int index)

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur on an already opened incident. Each element of this array corresponds to the name field in each of the NotificationChannel objects that are returned from the [ListNotificationChannels] [google.monitoring.v3.NotificationChannelService.ListNotificationChannels] method. The format of the entries in this field is:

 projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

repeated string notification_channels = 14;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The notificationChannels at the given index.

getNotificationChannelsBytes(int index)

public ByteString getNotificationChannelsBytes(int index)

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur on an already opened incident. Each element of this array corresponds to the name field in each of the NotificationChannel objects that are returned from the [ListNotificationChannels] [google.monitoring.v3.NotificationChannelService.ListNotificationChannels] method. The format of the entries in this field is:

 projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

repeated string notification_channels = 14;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the notificationChannels at the given index.

getNotificationChannelsCount()

public int getNotificationChannelsCount()

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur on an already opened incident. Each element of this array corresponds to the name field in each of the NotificationChannel objects that are returned from the [ListNotificationChannels] [google.monitoring.v3.NotificationChannelService.ListNotificationChannels] method. The format of the entries in this field is:

 projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

repeated string notification_channels = 14;

Returns
TypeDescription
int

The count of notificationChannels.

getNotificationChannelsList()

public ProtocolStringList getNotificationChannelsList()

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur on an already opened incident. Each element of this array corresponds to the name field in each of the NotificationChannel objects that are returned from the [ListNotificationChannels] [google.monitoring.v3.NotificationChannelService.ListNotificationChannels] method. The format of the entries in this field is:

 projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

repeated string notification_channels = 14;

Returns
TypeDescription
ProtocolStringList

A list containing the notificationChannels.

getUserLabels()

public Map<String,String> getUserLabels()

Use #getUserLabelsMap() instead.

Returns
TypeDescription
Map<String,String>

getUserLabelsCount()

public int getUserLabelsCount()

User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.

The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.

map<string, string> user_labels = 16;

Returns
TypeDescription
int

getUserLabelsMap()

public Map<String,String> getUserLabelsMap()

User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.

The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.

map<string, string> user_labels = 16;

Returns
TypeDescription
Map<String,String>

getUserLabelsOrDefault(String key, String defaultValue)

public String getUserLabelsOrDefault(String key, String defaultValue)

User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.

The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.

map<string, string> user_labels = 16;

Parameters
NameDescription
keyString
defaultValueString
Returns
TypeDescription
String

getUserLabelsOrThrow(String key)

public String getUserLabelsOrThrow(String key)

User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.

The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.

map<string, string> user_labels = 16;

Parameter
NameDescription
keyString
Returns
TypeDescription
String

getValidity()

public Status getValidity()

Read-only description of how the alert policy is invalid. OK if the alert policy is valid. If not OK, the alert policy will not generate incidents.

.google.rpc.Status validity = 18;

Returns
TypeDescription
com.google.rpc.Status

The validity.

getValidityBuilder()

public Status.Builder getValidityBuilder()

Read-only description of how the alert policy is invalid. OK if the alert policy is valid. If not OK, the alert policy will not generate incidents.

.google.rpc.Status validity = 18;

Returns
TypeDescription
com.google.rpc.Status.Builder

getValidityOrBuilder()

public StatusOrBuilder getValidityOrBuilder()

Read-only description of how the alert policy is invalid. OK if the alert policy is valid. If not OK, the alert policy will not generate incidents.

.google.rpc.Status validity = 18;

Returns
TypeDescription
com.google.rpc.StatusOrBuilder

hasAlertStrategy()

public boolean hasAlertStrategy()

Control over how this alert policy's notification channels are notified.

.google.monitoring.v3.AlertPolicy.AlertStrategy alert_strategy = 21;

Returns
TypeDescription
boolean

Whether the alertStrategy field is set.

hasCreationRecord()

public boolean hasCreationRecord()

A read-only record of the creation of the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord creation_record = 10;

Returns
TypeDescription
boolean

Whether the creationRecord field is set.

hasDocumentation()

public boolean hasDocumentation()

Documentation that is included with notifications and incidents related to this policy. Best practice is for the documentation to include information to help responders understand, mitigate, escalate, and correct the underlying problems detected by the alerting policy. Notification channels that have limited capacity might not show this documentation.

.google.monitoring.v3.AlertPolicy.Documentation documentation = 13;

Returns
TypeDescription
boolean

Whether the documentation field is set.

hasEnabled()

public boolean hasEnabled()

Whether or not the policy is enabled. On write, the default interpretation if unset is that the policy is enabled. On read, clients should not make any assumption about the state if it has not been populated. The field should always be populated on List and Get operations, unless a field projection has been specified that strips it out.

.google.protobuf.BoolValue enabled = 17;

Returns
TypeDescription
boolean

Whether the enabled field is set.

hasMutationRecord()

public boolean hasMutationRecord()

A read-only record of the most recent change to the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord mutation_record = 11;

Returns
TypeDescription
boolean

Whether the mutationRecord field is set.

hasValidity()

public boolean hasValidity()

Read-only description of how the alert policy is invalid. OK if the alert policy is valid. If not OK, the alert policy will not generate incidents.

.google.rpc.Status validity = 18;

Returns
TypeDescription
boolean

Whether the validity field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

internalGetMapField(int number)

protected MapField internalGetMapField(int number)
Parameter
NameDescription
numberint
Returns
TypeDescription
MapField
Overrides

internalGetMutableMapField(int number)

protected MapField internalGetMutableMapField(int number)
Parameter
NameDescription
numberint
Returns
TypeDescription
MapField
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeAlertStrategy(AlertPolicy.AlertStrategy value)

public AlertPolicy.Builder mergeAlertStrategy(AlertPolicy.AlertStrategy value)

Control over how this alert policy's notification channels are notified.

.google.monitoring.v3.AlertPolicy.AlertStrategy alert_strategy = 21;

Parameter
NameDescription
valueAlertPolicy.AlertStrategy
Returns
TypeDescription
AlertPolicy.Builder

mergeCreationRecord(MutationRecord value)

public AlertPolicy.Builder mergeCreationRecord(MutationRecord value)

A read-only record of the creation of the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord creation_record = 10;

Parameter
NameDescription
valueMutationRecord
Returns
TypeDescription
AlertPolicy.Builder

mergeDocumentation(AlertPolicy.Documentation value)

public AlertPolicy.Builder mergeDocumentation(AlertPolicy.Documentation value)

Documentation that is included with notifications and incidents related to this policy. Best practice is for the documentation to include information to help responders understand, mitigate, escalate, and correct the underlying problems detected by the alerting policy. Notification channels that have limited capacity might not show this documentation.

.google.monitoring.v3.AlertPolicy.Documentation documentation = 13;

Parameter
NameDescription
valueAlertPolicy.Documentation
Returns
TypeDescription
AlertPolicy.Builder

mergeEnabled(BoolValue value)

public AlertPolicy.Builder mergeEnabled(BoolValue value)

Whether or not the policy is enabled. On write, the default interpretation if unset is that the policy is enabled. On read, clients should not make any assumption about the state if it has not been populated. The field should always be populated on List and Get operations, unless a field projection has been specified that strips it out.

.google.protobuf.BoolValue enabled = 17;

Parameter
NameDescription
valueBoolValue
Returns
TypeDescription
AlertPolicy.Builder

mergeFrom(AlertPolicy other)

public AlertPolicy.Builder mergeFrom(AlertPolicy other)
Parameter
NameDescription
otherAlertPolicy
Returns
TypeDescription
AlertPolicy.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public AlertPolicy.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
AlertPolicy.Builder
Overrides
Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public AlertPolicy.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
AlertPolicy.Builder
Overrides

mergeMutationRecord(MutationRecord value)

public AlertPolicy.Builder mergeMutationRecord(MutationRecord value)

A read-only record of the most recent change to the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord mutation_record = 11;

Parameter
NameDescription
valueMutationRecord
Returns
TypeDescription
AlertPolicy.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final AlertPolicy.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
AlertPolicy.Builder
Overrides

mergeValidity(Status value)

public AlertPolicy.Builder mergeValidity(Status value)

Read-only description of how the alert policy is invalid. OK if the alert policy is valid. If not OK, the alert policy will not generate incidents.

.google.rpc.Status validity = 18;

Parameter
NameDescription
valuecom.google.rpc.Status
Returns
TypeDescription
AlertPolicy.Builder

putAllUserLabels(Map<String,String> values)

public AlertPolicy.Builder putAllUserLabels(Map<String,String> values)

User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.

The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.

map<string, string> user_labels = 16;

Parameter
NameDescription
valuesMap<String,String>
Returns
TypeDescription
AlertPolicy.Builder

putUserLabels(String key, String value)

public AlertPolicy.Builder putUserLabels(String key, String value)

User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.

The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.

map<string, string> user_labels = 16;

Parameters
NameDescription
keyString
valueString
Returns
TypeDescription
AlertPolicy.Builder

removeConditions(int index)

public AlertPolicy.Builder removeConditions(int index)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameter
NameDescription
indexint
Returns
TypeDescription
AlertPolicy.Builder

removeUserLabels(String key)

public AlertPolicy.Builder removeUserLabels(String key)

User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.

The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.

map<string, string> user_labels = 16;

Parameter
NameDescription
keyString
Returns
TypeDescription
AlertPolicy.Builder

setAlertStrategy(AlertPolicy.AlertStrategy value)

public AlertPolicy.Builder setAlertStrategy(AlertPolicy.AlertStrategy value)

Control over how this alert policy's notification channels are notified.

.google.monitoring.v3.AlertPolicy.AlertStrategy alert_strategy = 21;

Parameter
NameDescription
valueAlertPolicy.AlertStrategy
Returns
TypeDescription
AlertPolicy.Builder

setAlertStrategy(AlertPolicy.AlertStrategy.Builder builderForValue)

public AlertPolicy.Builder setAlertStrategy(AlertPolicy.AlertStrategy.Builder builderForValue)

Control over how this alert policy's notification channels are notified.

.google.monitoring.v3.AlertPolicy.AlertStrategy alert_strategy = 21;

Parameter
NameDescription
builderForValueAlertPolicy.AlertStrategy.Builder
Returns
TypeDescription
AlertPolicy.Builder

setCombiner(AlertPolicy.ConditionCombinerType value)

public AlertPolicy.Builder setCombiner(AlertPolicy.ConditionCombinerType value)

How to combine the results of multiple conditions to determine if an incident should be opened. If condition_time_series_query_language is present, this must be COMBINE_UNSPECIFIED.

.google.monitoring.v3.AlertPolicy.ConditionCombinerType combiner = 6;

Parameter
NameDescription
valueAlertPolicy.ConditionCombinerType

The combiner to set.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

setCombinerValue(int value)

public AlertPolicy.Builder setCombinerValue(int value)

How to combine the results of multiple conditions to determine if an incident should be opened. If condition_time_series_query_language is present, this must be COMBINE_UNSPECIFIED.

.google.monitoring.v3.AlertPolicy.ConditionCombinerType combiner = 6;

Parameter
NameDescription
valueint

The enum numeric value on the wire for combiner to set.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

setConditions(int index, AlertPolicy.Condition value)

public AlertPolicy.Builder setConditions(int index, AlertPolicy.Condition value)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameters
NameDescription
indexint
valueAlertPolicy.Condition
Returns
TypeDescription
AlertPolicy.Builder

setConditions(int index, AlertPolicy.Condition.Builder builderForValue)

public AlertPolicy.Builder setConditions(int index, AlertPolicy.Condition.Builder builderForValue)

A list of conditions for the policy. The conditions are combined by AND or OR according to the combiner field. If the combined conditions evaluate to true, then an incident is created. A policy can have from one to six conditions. If condition_time_series_query_language is present, it must be the only condition.

repeated .google.monitoring.v3.AlertPolicy.Condition conditions = 12;

Parameters
NameDescription
indexint
builderForValueAlertPolicy.Condition.Builder
Returns
TypeDescription
AlertPolicy.Builder

setCreationRecord(MutationRecord value)

public AlertPolicy.Builder setCreationRecord(MutationRecord value)

A read-only record of the creation of the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord creation_record = 10;

Parameter
NameDescription
valueMutationRecord
Returns
TypeDescription
AlertPolicy.Builder

setCreationRecord(MutationRecord.Builder builderForValue)

public AlertPolicy.Builder setCreationRecord(MutationRecord.Builder builderForValue)

A read-only record of the creation of the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord creation_record = 10;

Parameter
NameDescription
builderForValueMutationRecord.Builder
Returns
TypeDescription
AlertPolicy.Builder

setDisplayName(String value)

public AlertPolicy.Builder setDisplayName(String value)

A short name or phrase used to identify the policy in dashboards, notifications, and incidents. To avoid confusion, don't use the same display name for multiple policies in the same project. The name is limited to 512 Unicode characters.

string display_name = 2;

Parameter
NameDescription
valueString

The displayName to set.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

setDisplayNameBytes(ByteString value)

public AlertPolicy.Builder setDisplayNameBytes(ByteString value)

A short name or phrase used to identify the policy in dashboards, notifications, and incidents. To avoid confusion, don't use the same display name for multiple policies in the same project. The name is limited to 512 Unicode characters.

string display_name = 2;

Parameter
NameDescription
valueByteString

The bytes for displayName to set.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

setDocumentation(AlertPolicy.Documentation value)

public AlertPolicy.Builder setDocumentation(AlertPolicy.Documentation value)

Documentation that is included with notifications and incidents related to this policy. Best practice is for the documentation to include information to help responders understand, mitigate, escalate, and correct the underlying problems detected by the alerting policy. Notification channels that have limited capacity might not show this documentation.

.google.monitoring.v3.AlertPolicy.Documentation documentation = 13;

Parameter
NameDescription
valueAlertPolicy.Documentation
Returns
TypeDescription
AlertPolicy.Builder

setDocumentation(AlertPolicy.Documentation.Builder builderForValue)

public AlertPolicy.Builder setDocumentation(AlertPolicy.Documentation.Builder builderForValue)

Documentation that is included with notifications and incidents related to this policy. Best practice is for the documentation to include information to help responders understand, mitigate, escalate, and correct the underlying problems detected by the alerting policy. Notification channels that have limited capacity might not show this documentation.

.google.monitoring.v3.AlertPolicy.Documentation documentation = 13;

Parameter
NameDescription
builderForValueAlertPolicy.Documentation.Builder
Returns
TypeDescription
AlertPolicy.Builder

setEnabled(BoolValue value)

public AlertPolicy.Builder setEnabled(BoolValue value)

Whether or not the policy is enabled. On write, the default interpretation if unset is that the policy is enabled. On read, clients should not make any assumption about the state if it has not been populated. The field should always be populated on List and Get operations, unless a field projection has been specified that strips it out.

.google.protobuf.BoolValue enabled = 17;

Parameter
NameDescription
valueBoolValue
Returns
TypeDescription
AlertPolicy.Builder

setEnabled(BoolValue.Builder builderForValue)

public AlertPolicy.Builder setEnabled(BoolValue.Builder builderForValue)

Whether or not the policy is enabled. On write, the default interpretation if unset is that the policy is enabled. On read, clients should not make any assumption about the state if it has not been populated. The field should always be populated on List and Get operations, unless a field projection has been specified that strips it out.

.google.protobuf.BoolValue enabled = 17;

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
AlertPolicy.Builder

setField(Descriptors.FieldDescriptor field, Object value)

public AlertPolicy.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
AlertPolicy.Builder
Overrides

setMutationRecord(MutationRecord value)

public AlertPolicy.Builder setMutationRecord(MutationRecord value)

A read-only record of the most recent change to the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord mutation_record = 11;

Parameter
NameDescription
valueMutationRecord
Returns
TypeDescription
AlertPolicy.Builder

setMutationRecord(MutationRecord.Builder builderForValue)

public AlertPolicy.Builder setMutationRecord(MutationRecord.Builder builderForValue)

A read-only record of the most recent change to the alerting policy. If provided in a call to create or update, this field will be ignored.

.google.monitoring.v3.MutationRecord mutation_record = 11;

Parameter
NameDescription
builderForValueMutationRecord.Builder
Returns
TypeDescription
AlertPolicy.Builder

setName(String value)

public AlertPolicy.Builder setName(String value)

Required if the policy exists. The resource name for this policy. The format is:

 projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

[ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is created. When calling the alertPolicies.create method, do not include the name field in the alerting policy passed as part of the request.

string name = 1;

Parameter
NameDescription
valueString

The name to set.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

setNameBytes(ByteString value)

public AlertPolicy.Builder setNameBytes(ByteString value)

Required if the policy exists. The resource name for this policy. The format is:

 projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

[ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is created. When calling the alertPolicies.create method, do not include the name field in the alerting policy passed as part of the request.

string name = 1;

Parameter
NameDescription
valueByteString

The bytes for name to set.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

setNotificationChannels(int index, String value)

public AlertPolicy.Builder setNotificationChannels(int index, String value)

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur on an already opened incident. Each element of this array corresponds to the name field in each of the NotificationChannel objects that are returned from the [ListNotificationChannels] [google.monitoring.v3.NotificationChannelService.ListNotificationChannels] method. The format of the entries in this field is:

 projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]

repeated string notification_channels = 14;

Parameters
NameDescription
indexint

The index to set the value at.

valueString

The notificationChannels to set.

Returns
TypeDescription
AlertPolicy.Builder

This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public AlertPolicy.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
AlertPolicy.Builder
Overrides

setUnknownFields(UnknownFieldSet unknownFields)

public final AlertPolicy.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
AlertPolicy.Builder
Overrides

setValidity(Status value)

public AlertPolicy.Builder setValidity(Status value)

Read-only description of how the alert policy is invalid. OK if the alert policy is valid. If not OK, the alert policy will not generate incidents.

.google.rpc.Status validity = 18;

Parameter
NameDescription
valuecom.google.rpc.Status
Returns
TypeDescription
AlertPolicy.Builder

setValidity(Status.Builder builderForValue)

public AlertPolicy.Builder setValidity(Status.Builder builderForValue)

Read-only description of how the alert policy is invalid. OK if the alert policy is valid. If not OK, the alert policy will not generate incidents.

.google.rpc.Status validity = 18;

Parameter
NameDescription
builderForValuecom.google.rpc.Status.Builder
Returns
TypeDescription
AlertPolicy.Builder