1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="monitoring_v3.html">Stackdriver Monitoring API</a> . <a href="monitoring_v3.projects.html">projects</a> . <a href="monitoring_v3.projects.notificationChannels.html">notificationChannels</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#create">create(name, body, x__xgafv=None)</a></code></p> 79<p class="firstline">Creates a new notification channel, representing a single notification endpoint such as an email address, SMS number, or PagerDuty service.</p> 80<p class="toc_element"> 81 <code><a href="#delete">delete(name, force=None, x__xgafv=None)</a></code></p> 82<p class="firstline">Deletes a notification channel.</p> 83<p class="toc_element"> 84 <code><a href="#get">get(name, x__xgafv=None)</a></code></p> 85<p class="firstline">Gets a single notification channel. The channel includes the relevant configuration details with which the channel was created. However, the response may truncate or omit passwords, API keys, or other private key matter and thus the response may not be 100% identical to the information that was supplied in the call to the create method.</p> 86<p class="toc_element"> 87 <code><a href="#getVerificationCode">getVerificationCode(name, body, x__xgafv=None)</a></code></p> 88<p class="firstline">Requests a verification code for an already verified channel that can then be used in a call to VerifyNotificationChannel() on a different channel with an equivalent identity in the same or in a different project. This makes it possible to copy a channel between projects without requiring manual reverification of the channel. If the channel is not in the verified state, this method will fail (in other words, this may only be used if the SendNotificationChannelVerificationCode and VerifyNotificationChannel paths have already been used to put the given channel into the verified state).There is no guarantee that the verification codes returned by this method will be of a similar structure or form as the ones that are delivered to the channel via SendNotificationChannelVerificationCode; while VerifyNotificationChannel() will recognize both the codes delivered via SendNotificationChannelVerificationCode() and returned from GetNotificationChannelVerificationCode(), it is typically the case that the verification codes delivered via SendNotificationChannelVerificationCode() will be shorter and also have a shorter expiration (e.g. codes such as "G-123456") whereas GetVerificationCode() will typically return a much longer, websafe base 64 encoded string that has a longer expiration time.</p> 89<p class="toc_element"> 90 <code><a href="#list">list(name, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None, filter=None)</a></code></p> 91<p class="firstline">Lists the notification channels that have been created for the project.</p> 92<p class="toc_element"> 93 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 94<p class="firstline">Retrieves the next page of results.</p> 95<p class="toc_element"> 96 <code><a href="#patch">patch(name, body, updateMask=None, x__xgafv=None)</a></code></p> 97<p class="firstline">Updates a notification channel. Fields not specified in the field mask remain unchanged.</p> 98<p class="toc_element"> 99 <code><a href="#sendVerificationCode">sendVerificationCode(name, body=None, x__xgafv=None)</a></code></p> 100<p class="firstline">Causes a verification code to be delivered to the channel. The code can then be supplied in VerifyNotificationChannel to verify the channel.</p> 101<p class="toc_element"> 102 <code><a href="#verify">verify(name, body, x__xgafv=None)</a></code></p> 103<p class="firstline">Verifies a NotificationChannel by proving receipt of the code delivered to the channel as a result of calling SendNotificationChannelVerificationCode.</p> 104<h3>Method Details</h3> 105<div class="method"> 106 <code class="details" id="create">create(name, body, x__xgafv=None)</code> 107 <pre>Creates a new notification channel, representing a single notification endpoint such as an email address, SMS number, or PagerDuty service. 108 109Args: 110 name: string, The project on which to execute the request. The format is: 111projects/[PROJECT_ID] 112Note that this names the container into which the channel will be written. This does not name the newly created channel. The resulting channel's name will have a normalized version of this field as a prefix, but will add /notificationChannels/[CHANNEL_ID] to identify the channel. (required) 113 body: object, The request body. (required) 114 The object takes the form of: 115 116{ # A NotificationChannel is a medium through which an alert is delivered when a policy violation is detected. Examples of channels include email, SMS, and third-party messaging applications. Fields containing sensitive information like authentication tokens or contact info are only partially populated on retrieval. 117 "displayName": "A String", # An optional human-readable name for this notification channel. It is recommended that you specify a non-empty and unique name in order to make it easier to identify the channels in your project, though this is not enforced. The display name is limited to 512 Unicode characters. 118 "description": "A String", # An optional human-readable description of this notification channel. This description may provide additional details, beyond the display name, for the channel. This may not exceed 1024 Unicode characters. 119 "labels": { # Configuration fields that define the channel and its behavior. The permissible and required labels are specified in the NotificationChannelDescriptor.labels of the NotificationChannelDescriptor corresponding to the type field. 120 "a_key": "A String", 121 }, 122 "enabled": True or False, # Whether notifications are forwarded to the described channel. This makes it possible to disable delivery of notifications to a particular channel without removing the channel from all alerting policies that reference the channel. This is a more convenient approach when the change is temporary and you want to receive notifications from the same set of alerting policies on the channel at some point in the future. 123 "userLabels": { # User-supplied key/value data that does not need to conform to the corresponding NotificationChannelDescriptor's schema, unlike the labels field. This field is intended to be used for organizing and identifying the NotificationChannel 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. 124 "a_key": "A String", 125 }, 126 "type": "A String", # The type of the notification channel. This field matches the value of the NotificationChannelDescriptor.type field. 127 "verificationStatus": "A String", # Indicates whether this channel has been verified or not. On a ListNotificationChannels or GetNotificationChannel operation, this field is expected to be populated.If the value is UNVERIFIED, then it indicates that the channel is non-functioning (it both requires verification and lacks verification); otherwise, it is assumed that the channel works.If the channel is neither VERIFIED nor UNVERIFIED, it implies that the channel is of a type that does not require verification or that this specific channel has been exempted from verification because it was created prior to verification being required for channels of this type.This field cannot be modified using a standard UpdateNotificationChannel operation. To change the value of this field, you must call VerifyNotificationChannel. 128 "name": "A String", # The full REST resource name for this channel. The syntax is: 129 # projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID] 130 # The [CHANNEL_ID] is automatically assigned by the server on creation. 131} 132 133 x__xgafv: string, V1 error format. 134 Allowed values 135 1 - v1 error format 136 2 - v2 error format 137 138Returns: 139 An object of the form: 140 141 { # A NotificationChannel is a medium through which an alert is delivered when a policy violation is detected. Examples of channels include email, SMS, and third-party messaging applications. Fields containing sensitive information like authentication tokens or contact info are only partially populated on retrieval. 142 "displayName": "A String", # An optional human-readable name for this notification channel. It is recommended that you specify a non-empty and unique name in order to make it easier to identify the channels in your project, though this is not enforced. The display name is limited to 512 Unicode characters. 143 "description": "A String", # An optional human-readable description of this notification channel. This description may provide additional details, beyond the display name, for the channel. This may not exceed 1024 Unicode characters. 144 "labels": { # Configuration fields that define the channel and its behavior. The permissible and required labels are specified in the NotificationChannelDescriptor.labels of the NotificationChannelDescriptor corresponding to the type field. 145 "a_key": "A String", 146 }, 147 "enabled": True or False, # Whether notifications are forwarded to the described channel. This makes it possible to disable delivery of notifications to a particular channel without removing the channel from all alerting policies that reference the channel. This is a more convenient approach when the change is temporary and you want to receive notifications from the same set of alerting policies on the channel at some point in the future. 148 "userLabels": { # User-supplied key/value data that does not need to conform to the corresponding NotificationChannelDescriptor's schema, unlike the labels field. This field is intended to be used for organizing and identifying the NotificationChannel 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. 149 "a_key": "A String", 150 }, 151 "type": "A String", # The type of the notification channel. This field matches the value of the NotificationChannelDescriptor.type field. 152 "verificationStatus": "A String", # Indicates whether this channel has been verified or not. On a ListNotificationChannels or GetNotificationChannel operation, this field is expected to be populated.If the value is UNVERIFIED, then it indicates that the channel is non-functioning (it both requires verification and lacks verification); otherwise, it is assumed that the channel works.If the channel is neither VERIFIED nor UNVERIFIED, it implies that the channel is of a type that does not require verification or that this specific channel has been exempted from verification because it was created prior to verification being required for channels of this type.This field cannot be modified using a standard UpdateNotificationChannel operation. To change the value of this field, you must call VerifyNotificationChannel. 153 "name": "A String", # The full REST resource name for this channel. The syntax is: 154 # projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID] 155 # The [CHANNEL_ID] is automatically assigned by the server on creation. 156 }</pre> 157</div> 158 159<div class="method"> 160 <code class="details" id="delete">delete(name, force=None, x__xgafv=None)</code> 161 <pre>Deletes a notification channel. 162 163Args: 164 name: string, The channel for which to execute the request. The format is projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]. (required) 165 force: boolean, If true, the notification channel will be deleted regardless of its use in alert policies (the policies will be updated to remove the channel). If false, channels that are still referenced by an existing alerting policy will fail to be deleted in a delete operation. 166 x__xgafv: string, V1 error format. 167 Allowed values 168 1 - v1 error format 169 2 - v2 error format 170 171Returns: 172 An object of the form: 173 174 { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: 175 # service Foo { 176 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); 177 # } 178 # The JSON representation for Empty is empty JSON object {}. 179 }</pre> 180</div> 181 182<div class="method"> 183 <code class="details" id="get">get(name, x__xgafv=None)</code> 184 <pre>Gets a single notification channel. The channel includes the relevant configuration details with which the channel was created. However, the response may truncate or omit passwords, API keys, or other private key matter and thus the response may not be 100% identical to the information that was supplied in the call to the create method. 185 186Args: 187 name: string, The channel for which to execute the request. The format is projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]. (required) 188 x__xgafv: string, V1 error format. 189 Allowed values 190 1 - v1 error format 191 2 - v2 error format 192 193Returns: 194 An object of the form: 195 196 { # A NotificationChannel is a medium through which an alert is delivered when a policy violation is detected. Examples of channels include email, SMS, and third-party messaging applications. Fields containing sensitive information like authentication tokens or contact info are only partially populated on retrieval. 197 "displayName": "A String", # An optional human-readable name for this notification channel. It is recommended that you specify a non-empty and unique name in order to make it easier to identify the channels in your project, though this is not enforced. The display name is limited to 512 Unicode characters. 198 "description": "A String", # An optional human-readable description of this notification channel. This description may provide additional details, beyond the display name, for the channel. This may not exceed 1024 Unicode characters. 199 "labels": { # Configuration fields that define the channel and its behavior. The permissible and required labels are specified in the NotificationChannelDescriptor.labels of the NotificationChannelDescriptor corresponding to the type field. 200 "a_key": "A String", 201 }, 202 "enabled": True or False, # Whether notifications are forwarded to the described channel. This makes it possible to disable delivery of notifications to a particular channel without removing the channel from all alerting policies that reference the channel. This is a more convenient approach when the change is temporary and you want to receive notifications from the same set of alerting policies on the channel at some point in the future. 203 "userLabels": { # User-supplied key/value data that does not need to conform to the corresponding NotificationChannelDescriptor's schema, unlike the labels field. This field is intended to be used for organizing and identifying the NotificationChannel 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. 204 "a_key": "A String", 205 }, 206 "type": "A String", # The type of the notification channel. This field matches the value of the NotificationChannelDescriptor.type field. 207 "verificationStatus": "A String", # Indicates whether this channel has been verified or not. On a ListNotificationChannels or GetNotificationChannel operation, this field is expected to be populated.If the value is UNVERIFIED, then it indicates that the channel is non-functioning (it both requires verification and lacks verification); otherwise, it is assumed that the channel works.If the channel is neither VERIFIED nor UNVERIFIED, it implies that the channel is of a type that does not require verification or that this specific channel has been exempted from verification because it was created prior to verification being required for channels of this type.This field cannot be modified using a standard UpdateNotificationChannel operation. To change the value of this field, you must call VerifyNotificationChannel. 208 "name": "A String", # The full REST resource name for this channel. The syntax is: 209 # projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID] 210 # The [CHANNEL_ID] is automatically assigned by the server on creation. 211 }</pre> 212</div> 213 214<div class="method"> 215 <code class="details" id="getVerificationCode">getVerificationCode(name, body, x__xgafv=None)</code> 216 <pre>Requests a verification code for an already verified channel that can then be used in a call to VerifyNotificationChannel() on a different channel with an equivalent identity in the same or in a different project. This makes it possible to copy a channel between projects without requiring manual reverification of the channel. If the channel is not in the verified state, this method will fail (in other words, this may only be used if the SendNotificationChannelVerificationCode and VerifyNotificationChannel paths have already been used to put the given channel into the verified state).There is no guarantee that the verification codes returned by this method will be of a similar structure or form as the ones that are delivered to the channel via SendNotificationChannelVerificationCode; while VerifyNotificationChannel() will recognize both the codes delivered via SendNotificationChannelVerificationCode() and returned from GetNotificationChannelVerificationCode(), it is typically the case that the verification codes delivered via SendNotificationChannelVerificationCode() will be shorter and also have a shorter expiration (e.g. codes such as "G-123456") whereas GetVerificationCode() will typically return a much longer, websafe base 64 encoded string that has a longer expiration time. 217 218Args: 219 name: string, The notification channel for which a verification code is to be generated and retrieved. This must name a channel that is already verified; if the specified channel is not verified, the request will fail. (required) 220 body: object, The request body. (required) 221 The object takes the form of: 222 223{ # The GetNotificationChannelVerificationCode request. 224 "expireTime": "A String", # The desired expiration time. If specified, the API will guarantee that the returned code will not be valid after the specified timestamp; however, the API cannot guarantee that the returned code will be valid for at least as long as the requested time (the API puts an upper bound on the amount of time for which a code may be valid). If omitted, a default expiration will be used, which may be less than the max permissible expiration (so specifying an expiration may extend the code's lifetime over omitting an expiration, even though the API does impose an upper limit on the maximum expiration that is permitted). 225 } 226 227 x__xgafv: string, V1 error format. 228 Allowed values 229 1 - v1 error format 230 2 - v2 error format 231 232Returns: 233 An object of the form: 234 235 { # The GetNotificationChannelVerificationCode request. 236 "expireTime": "A String", # The expiration time associated with the code that was returned. If an expiration was provided in the request, this is the minimum of the requested expiration in the request and the max permitted expiration. 237 "code": "A String", # The verification code, which may be used to verify other channels that have an equivalent identity (i.e. other channels of the same type with the same fingerprint such as other email channels with the same email address or other sms channels with the same number). 238 }</pre> 239</div> 240 241<div class="method"> 242 <code class="details" id="list">list(name, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None, filter=None)</code> 243 <pre>Lists the notification channels that have been created for the project. 244 245Args: 246 name: string, The project on which to execute the request. The format is projects/[PROJECT_ID]. That is, this names the container in which to look for the notification channels; it does not name a specific channel. To query a specific channel by REST resource name, use the GetNotificationChannel operation. (required) 247 orderBy: string, A comma-separated list of fields by which to sort the result. Supports the same set of fields as in filter. Entries can be prefixed with a minus sign to sort in descending rather than ascending order.For more details, see sorting and filtering. 248 pageSize: integer, The maximum number of results to return in a single response. If not set to a positive number, a reasonable value will be chosen by the service. 249 pageToken: string, If non-empty, page_token must contain a value returned as the next_page_token in a previous response to request the next set of results. 250 x__xgafv: string, V1 error format. 251 Allowed values 252 1 - v1 error format 253 2 - v2 error format 254 filter: string, If provided, this field specifies the criteria that must be met by notification channels to be included in the response.For more details, see sorting and filtering. 255 256Returns: 257 An object of the form: 258 259 { # The ListNotificationChannels response. 260 "nextPageToken": "A String", # If not empty, indicates that there may be more results that match the request. Use the value in the page_token field in a subsequent request to fetch the next set of results. If empty, all results have been returned. 261 "notificationChannels": [ # The notification channels defined for the specified project. 262 { # A NotificationChannel is a medium through which an alert is delivered when a policy violation is detected. Examples of channels include email, SMS, and third-party messaging applications. Fields containing sensitive information like authentication tokens or contact info are only partially populated on retrieval. 263 "displayName": "A String", # An optional human-readable name for this notification channel. It is recommended that you specify a non-empty and unique name in order to make it easier to identify the channels in your project, though this is not enforced. The display name is limited to 512 Unicode characters. 264 "description": "A String", # An optional human-readable description of this notification channel. This description may provide additional details, beyond the display name, for the channel. This may not exceed 1024 Unicode characters. 265 "labels": { # Configuration fields that define the channel and its behavior. The permissible and required labels are specified in the NotificationChannelDescriptor.labels of the NotificationChannelDescriptor corresponding to the type field. 266 "a_key": "A String", 267 }, 268 "enabled": True or False, # Whether notifications are forwarded to the described channel. This makes it possible to disable delivery of notifications to a particular channel without removing the channel from all alerting policies that reference the channel. This is a more convenient approach when the change is temporary and you want to receive notifications from the same set of alerting policies on the channel at some point in the future. 269 "userLabels": { # User-supplied key/value data that does not need to conform to the corresponding NotificationChannelDescriptor's schema, unlike the labels field. This field is intended to be used for organizing and identifying the NotificationChannel 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. 270 "a_key": "A String", 271 }, 272 "type": "A String", # The type of the notification channel. This field matches the value of the NotificationChannelDescriptor.type field. 273 "verificationStatus": "A String", # Indicates whether this channel has been verified or not. On a ListNotificationChannels or GetNotificationChannel operation, this field is expected to be populated.If the value is UNVERIFIED, then it indicates that the channel is non-functioning (it both requires verification and lacks verification); otherwise, it is assumed that the channel works.If the channel is neither VERIFIED nor UNVERIFIED, it implies that the channel is of a type that does not require verification or that this specific channel has been exempted from verification because it was created prior to verification being required for channels of this type.This field cannot be modified using a standard UpdateNotificationChannel operation. To change the value of this field, you must call VerifyNotificationChannel. 274 "name": "A String", # The full REST resource name for this channel. The syntax is: 275 # projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID] 276 # The [CHANNEL_ID] is automatically assigned by the server on creation. 277 }, 278 ], 279 }</pre> 280</div> 281 282<div class="method"> 283 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 284 <pre>Retrieves the next page of results. 285 286Args: 287 previous_request: The request for the previous page. (required) 288 previous_response: The response from the request for the previous page. (required) 289 290Returns: 291 A request object that you can call 'execute()' on to request the next 292 page. Returns None if there are no more items in the collection. 293 </pre> 294</div> 295 296<div class="method"> 297 <code class="details" id="patch">patch(name, body, updateMask=None, x__xgafv=None)</code> 298 <pre>Updates a notification channel. Fields not specified in the field mask remain unchanged. 299 300Args: 301 name: string, The full REST resource name for this channel. The syntax is: 302projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID] 303The [CHANNEL_ID] is automatically assigned by the server on creation. (required) 304 body: object, The request body. (required) 305 The object takes the form of: 306 307{ # A NotificationChannel is a medium through which an alert is delivered when a policy violation is detected. Examples of channels include email, SMS, and third-party messaging applications. Fields containing sensitive information like authentication tokens or contact info are only partially populated on retrieval. 308 "displayName": "A String", # An optional human-readable name for this notification channel. It is recommended that you specify a non-empty and unique name in order to make it easier to identify the channels in your project, though this is not enforced. The display name is limited to 512 Unicode characters. 309 "description": "A String", # An optional human-readable description of this notification channel. This description may provide additional details, beyond the display name, for the channel. This may not exceed 1024 Unicode characters. 310 "labels": { # Configuration fields that define the channel and its behavior. The permissible and required labels are specified in the NotificationChannelDescriptor.labels of the NotificationChannelDescriptor corresponding to the type field. 311 "a_key": "A String", 312 }, 313 "enabled": True or False, # Whether notifications are forwarded to the described channel. This makes it possible to disable delivery of notifications to a particular channel without removing the channel from all alerting policies that reference the channel. This is a more convenient approach when the change is temporary and you want to receive notifications from the same set of alerting policies on the channel at some point in the future. 314 "userLabels": { # User-supplied key/value data that does not need to conform to the corresponding NotificationChannelDescriptor's schema, unlike the labels field. This field is intended to be used for organizing and identifying the NotificationChannel 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. 315 "a_key": "A String", 316 }, 317 "type": "A String", # The type of the notification channel. This field matches the value of the NotificationChannelDescriptor.type field. 318 "verificationStatus": "A String", # Indicates whether this channel has been verified or not. On a ListNotificationChannels or GetNotificationChannel operation, this field is expected to be populated.If the value is UNVERIFIED, then it indicates that the channel is non-functioning (it both requires verification and lacks verification); otherwise, it is assumed that the channel works.If the channel is neither VERIFIED nor UNVERIFIED, it implies that the channel is of a type that does not require verification or that this specific channel has been exempted from verification because it was created prior to verification being required for channels of this type.This field cannot be modified using a standard UpdateNotificationChannel operation. To change the value of this field, you must call VerifyNotificationChannel. 319 "name": "A String", # The full REST resource name for this channel. The syntax is: 320 # projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID] 321 # The [CHANNEL_ID] is automatically assigned by the server on creation. 322} 323 324 updateMask: string, The fields to update. 325 x__xgafv: string, V1 error format. 326 Allowed values 327 1 - v1 error format 328 2 - v2 error format 329 330Returns: 331 An object of the form: 332 333 { # A NotificationChannel is a medium through which an alert is delivered when a policy violation is detected. Examples of channels include email, SMS, and third-party messaging applications. Fields containing sensitive information like authentication tokens or contact info are only partially populated on retrieval. 334 "displayName": "A String", # An optional human-readable name for this notification channel. It is recommended that you specify a non-empty and unique name in order to make it easier to identify the channels in your project, though this is not enforced. The display name is limited to 512 Unicode characters. 335 "description": "A String", # An optional human-readable description of this notification channel. This description may provide additional details, beyond the display name, for the channel. This may not exceed 1024 Unicode characters. 336 "labels": { # Configuration fields that define the channel and its behavior. The permissible and required labels are specified in the NotificationChannelDescriptor.labels of the NotificationChannelDescriptor corresponding to the type field. 337 "a_key": "A String", 338 }, 339 "enabled": True or False, # Whether notifications are forwarded to the described channel. This makes it possible to disable delivery of notifications to a particular channel without removing the channel from all alerting policies that reference the channel. This is a more convenient approach when the change is temporary and you want to receive notifications from the same set of alerting policies on the channel at some point in the future. 340 "userLabels": { # User-supplied key/value data that does not need to conform to the corresponding NotificationChannelDescriptor's schema, unlike the labels field. This field is intended to be used for organizing and identifying the NotificationChannel 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. 341 "a_key": "A String", 342 }, 343 "type": "A String", # The type of the notification channel. This field matches the value of the NotificationChannelDescriptor.type field. 344 "verificationStatus": "A String", # Indicates whether this channel has been verified or not. On a ListNotificationChannels or GetNotificationChannel operation, this field is expected to be populated.If the value is UNVERIFIED, then it indicates that the channel is non-functioning (it both requires verification and lacks verification); otherwise, it is assumed that the channel works.If the channel is neither VERIFIED nor UNVERIFIED, it implies that the channel is of a type that does not require verification or that this specific channel has been exempted from verification because it was created prior to verification being required for channels of this type.This field cannot be modified using a standard UpdateNotificationChannel operation. To change the value of this field, you must call VerifyNotificationChannel. 345 "name": "A String", # The full REST resource name for this channel. The syntax is: 346 # projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID] 347 # The [CHANNEL_ID] is automatically assigned by the server on creation. 348 }</pre> 349</div> 350 351<div class="method"> 352 <code class="details" id="sendVerificationCode">sendVerificationCode(name, body=None, x__xgafv=None)</code> 353 <pre>Causes a verification code to be delivered to the channel. The code can then be supplied in VerifyNotificationChannel to verify the channel. 354 355Args: 356 name: string, The notification channel to which to send a verification code. (required) 357 body: object, The request body. 358 The object takes the form of: 359 360{ # The SendNotificationChannelVerificationCode request. 361 } 362 363 x__xgafv: string, V1 error format. 364 Allowed values 365 1 - v1 error format 366 2 - v2 error format 367 368Returns: 369 An object of the form: 370 371 { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: 372 # service Foo { 373 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); 374 # } 375 # The JSON representation for Empty is empty JSON object {}. 376 }</pre> 377</div> 378 379<div class="method"> 380 <code class="details" id="verify">verify(name, body, x__xgafv=None)</code> 381 <pre>Verifies a NotificationChannel by proving receipt of the code delivered to the channel as a result of calling SendNotificationChannelVerificationCode. 382 383Args: 384 name: string, The notification channel to verify. (required) 385 body: object, The request body. (required) 386 The object takes the form of: 387 388{ # The VerifyNotificationChannel request. 389 "code": "A String", # The verification code that was delivered to the channel as a result of invoking the SendNotificationChannelVerificationCode API method or that was retrieved from a verified channel via GetNotificationChannelVerificationCode. For example, one might have "G-123456" or "TKNZGhhd2EyN3I1MnRnMjRv" (in general, one is only guaranteed that the code is valid UTF-8; one should not make any assumptions regarding the structure or format of the code). 390 } 391 392 x__xgafv: string, V1 error format. 393 Allowed values 394 1 - v1 error format 395 2 - v2 error format 396 397Returns: 398 An object of the form: 399 400 { # A NotificationChannel is a medium through which an alert is delivered when a policy violation is detected. Examples of channels include email, SMS, and third-party messaging applications. Fields containing sensitive information like authentication tokens or contact info are only partially populated on retrieval. 401 "displayName": "A String", # An optional human-readable name for this notification channel. It is recommended that you specify a non-empty and unique name in order to make it easier to identify the channels in your project, though this is not enforced. The display name is limited to 512 Unicode characters. 402 "description": "A String", # An optional human-readable description of this notification channel. This description may provide additional details, beyond the display name, for the channel. This may not exceed 1024 Unicode characters. 403 "labels": { # Configuration fields that define the channel and its behavior. The permissible and required labels are specified in the NotificationChannelDescriptor.labels of the NotificationChannelDescriptor corresponding to the type field. 404 "a_key": "A String", 405 }, 406 "enabled": True or False, # Whether notifications are forwarded to the described channel. This makes it possible to disable delivery of notifications to a particular channel without removing the channel from all alerting policies that reference the channel. This is a more convenient approach when the change is temporary and you want to receive notifications from the same set of alerting policies on the channel at some point in the future. 407 "userLabels": { # User-supplied key/value data that does not need to conform to the corresponding NotificationChannelDescriptor's schema, unlike the labels field. This field is intended to be used for organizing and identifying the NotificationChannel 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. 408 "a_key": "A String", 409 }, 410 "type": "A String", # The type of the notification channel. This field matches the value of the NotificationChannelDescriptor.type field. 411 "verificationStatus": "A String", # Indicates whether this channel has been verified or not. On a ListNotificationChannels or GetNotificationChannel operation, this field is expected to be populated.If the value is UNVERIFIED, then it indicates that the channel is non-functioning (it both requires verification and lacks verification); otherwise, it is assumed that the channel works.If the channel is neither VERIFIED nor UNVERIFIED, it implies that the channel is of a type that does not require verification or that this specific channel has been exempted from verification because it was created prior to verification being required for channels of this type.This field cannot be modified using a standard UpdateNotificationChannel operation. To change the value of this field, you must call VerifyNotificationChannel. 412 "name": "A String", # The full REST resource name for this channel. The syntax is: 413 # projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID] 414 # The [CHANNEL_ID] is automatically assigned by the server on creation. 415 }</pre> 416</div> 417 418</body></html>