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="run_v1alpha1.html">Cloud Run API</a> . <a href="run_v1alpha1.namespaces.html">namespaces</a> . <a href="run_v1alpha1.namespaces.triggers.html">triggers</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#create">create(parent, body, x__xgafv=None)</a></code></p> 79<p class="firstline">Creates a new trigger.</p> 80<p class="toc_element"> 81 <code><a href="#delete">delete(name, kind=None, propagationPolicy=None, apiVersion=None, x__xgafv=None)</a></code></p> 82<p class="firstline">Rpc to delete a trigger.</p> 83<p class="toc_element"> 84 <code><a href="#get">get(name, x__xgafv=None)</a></code></p> 85<p class="firstline">Rpc to get information about a trigger.</p> 86<p class="toc_element"> 87 <code><a href="#list">list(parent, labelSelector=None, includeUninitialized=None, x__xgafv=None, resourceVersion=None, limit=None, watch=None, continue=None, fieldSelector=None)</a></code></p> 88<p class="firstline">Rpc to list triggers.</p> 89<p class="toc_element"> 90 <code><a href="#replaceTrigger">replaceTrigger(name, body, x__xgafv=None)</a></code></p> 91<p class="firstline">Rpc to replace a trigger.</p> 92<h3>Method Details</h3> 93<div class="method"> 94 <code class="details" id="create">create(parent, body, x__xgafv=None)</code> 95 <pre>Creates a new trigger. 96 97Args: 98 parent: string, The project ID or project number in which this trigger should 99be created. (required) 100 body: object, The request body. (required) 101 The object takes the form of: 102 103{ 104 "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of 105 # date. 106 # +optional 107 "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that 108 # was last processed by the controller. 109 "conditions": [ # Array of observed TriggerConditions, indicating the current state 110 # of the Trigger. 111 { # TriggerCondition contains state information for an Trigger. 112 "status": "A String", # Status of the condition, one of True, False, Unknown. 113 "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info 114 # +optional 115 "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. 116 # +optional 117 "reason": "A String", # One-word CamelCase reason for the condition's current status. 118 # +optional 119 "message": "A String", # Human readable message indicating details about the current status. 120 # +optional 121 "type": "A String", # Type of Trigger condition. 122 }, 123 ], 124 "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. 125 }, 126 "kind": "A String", # The kind of resource, in this case "Trigger". 127 "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. 128 "filter": { # Filter is the filter to apply against all events from the Broker. Only 129 # events that pass this filter will be sent to the Subscriber. If not 130 # specified, will default to allowing all events. 131 # 132 # This must be specified in Cloud Run. 133 "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud 134 # event's type and source attributes. Only exact matches will pass the filter. 135 "source": "A String", 136 "type": "A String", 137 }, 138 }, 139 "subscriber": { # Subscriber is the addressable that receives events from the Broker that 140 # pass the Filter. It is required. 141 # 142 # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or 143 # /namespaces/my-project/services/my-service. 144 "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target 145 # endpoint, which should implement the Addressable duck type. 146 # For example, this could be a reference to a Route resource 147 # or a Knative Service resource. 148 # referred object. 149 "kind": "A String", # Kind of the referent. 150 # More info: 151 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 152 # +optional 153 "uid": "A String", # UID of the referent. 154 # More info: 155 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids 156 # +optional 157 "namespace": "A String", # Namespace of the referent. 158 # More info: 159 # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ 160 # +optional 161 "apiVersion": "A String", # API version of the referent. 162 # +optional 163 "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this 164 # string should contain a valid JSON/Go field access statement, such as 165 # desiredState.manifest.containers[2]. For example, if the object reference 166 # is to a container within a pod, this would take on a value like: 167 # "spec.containers{name}" (where "name" refers to the name of the container 168 # that triggered the event) or if no container name is specified 169 # "spec.containers[2]" (container with index 2 in this pod). This syntax is 170 # chosen only to have some well-defined way of referencing a part of an 171 # object. 172 "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. 173 # More info: 174 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 175 # +optional 176 "name": "A String", # Name of the referent. 177 # More info: 178 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names 179 # +optional 180 }, 181 "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. 182 # http://k8s-service for example 183 # http://myexternalhandler.example.com/foo/bar 184 }, 185 "broker": "A String", # Broker is the broker that this trigger receives events from. If not 186 # specified, will default to 'default'. 187 # 188 # Not currently supported by Cloud Run. 189 }, 190 "apiVersion": "A String", # The API version for this call such as "v1alpha1". 191 "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. 192 # all objects users must create. 193 "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have 194 # been deleted, this object will be garbage collected. 195 # +optional 196 { # OwnerReference contains enough information to let you identify an owning 197 # object. Currently, an owning object must be in the same namespace, so there 198 # is no namespace field. 199 "kind": "A String", # Kind of the referent. 200 # More info: 201 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 202 "uid": "A String", # UID of the referent. 203 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 204 "apiVersion": "A String", # API version of the referent. 205 "controller": True or False, # If true, this reference points to the managing controller. 206 # +optional 207 "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then 208 # the owner cannot be deleted from the key-value store until this 209 # reference is removed. 210 # Defaults to false. 211 # To set this field, a user needs "delete" permission of the owner, 212 # otherwise 422 (Unprocessable Entity) will be returned. 213 # +optional 214 "name": "A String", # Name of the referent. 215 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 216 }, 217 ], 218 "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. 219 # Is required when creating 220 # resources, although some resources may allow a client to request the 221 # generation of an appropriate name automatically. Name is primarily intended 222 # for creation idempotence and configuration definition. Cannot be updated. 223 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 224 # +optional 225 "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be 226 # deleted. This field is set by the server when a graceful deletion is 227 # requested by the user, and is not directly settable by a client. The 228 # resource is expected to be deleted (no longer visible from resource lists, 229 # and not reachable by name) after the time in this field, once the 230 # finalizers list is empty. As long as the finalizers list contains items, 231 # deletion is blocked. Once the deletionTimestamp is set, this value may not 232 # be unset or be set further into the future, although it may be shortened or 233 # the resource may be deleted prior to this time. For example, a user may 234 # request that a pod is deleted in 30 seconds. The Kubelet will react by 235 # sending a graceful termination signal to the containers in the pod. After 236 # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) 237 # to the container and after cleanup, remove the pod from the API. In the 238 # presence of network partitions, this object may still exist after this 239 # timestamp, until an administrator or automated process can determine the 240 # resource is fully terminated. 241 # If not set, graceful deletion of the object has not been requested. 242 # 243 # Populated by the system when a graceful deletion is requested. 244 # Read-only. 245 # More info: 246 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 247 # +optional 248 "clusterName": "A String", # Not currently supported by Cloud Run. 249 # 250 # The name of the cluster which the object belongs to. 251 # This is used to distinguish resources with same name and namespace in 252 # different clusters. This field is not set anywhere right now and apiserver 253 # is going to ignore it if set in create or update request. +optional 254 "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. 255 # 256 # Number of seconds allowed for this object to gracefully terminate before 257 # it will be removed from the system. Only set when deletionTimestamp is also 258 # set. May only be shortened. Read-only. +optional 259 "labels": { # Map of string keys and values that can be used to organize and categorize 260 # (scope and select) objects. May match selectors of replication controllers 261 # and routes. 262 # More info: http://kubernetes.io/docs/user-guide/labels 263 # +optional 264 "a_key": "A String", 265 }, 266 "namespace": "A String", # Namespace defines the space within each name must be unique, within a 267 # Cloud Run region. In Cloud Run the namespace must be equal to either the 268 # project ID or project number. 269 "generation": 42, # A sequence number representing a specific generation of the desired state. 270 # Populated by the system. Read-only. 271 # +optional 272 "finalizers": [ # Not currently supported by Cloud Run. 273 # 274 # Must be empty before the object is deleted from the registry. Each entry 275 # is an identifier for the responsible component that will remove the entry 276 # from the list. If the deletionTimestamp of the object is non-nil, entries 277 # in this list can only be removed. 278 # +optional 279 # +patchStrategy=merge 280 "A String", 281 ], 282 "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. 283 # 284 # An initializer is a controller which enforces some system invariant at 285 # object creation time. This field is a list of initializers that have not 286 # yet acted on this object. If nil or empty, this object has been completely 287 # initialized. Otherwise, the object is considered uninitialized and is 288 # hidden (in list/watch and get calls) from clients that haven't explicitly 289 # asked to observe uninitialized objects. 290 # 291 # When an object is created, the system will populate this list with the 292 # current set of initializers. Only privileged users may set or modify this 293 # list. Once it is empty, it may not be modified further by any user. 294 "pending": [ # Pending is a list of initializers that must execute in order before this 295 # object is visible. When the last pending initializer is removed, and no 296 # failing result is set, the initializers struct will be set to nil and the 297 # object is considered as initialized and visible to all clients. 298 # +patchMergeKey=name 299 # +patchStrategy=merge 300 { # Initializer is information about an initializer that has not yet completed. 301 "name": "A String", # name of the process that is responsible for initializing this object. 302 }, 303 ], 304 }, 305 "resourceVersion": "A String", # An opaque value that represents the internal version of this object that 306 # can be used by clients to determine when objects have changed. May be used 307 # for optimistic concurrency, change detection, and the watch operation on a 308 # resource or set of resources. Clients must treat these values as opaque and 309 # passed unmodified back to the server. They may only be valid for a 310 # particular resource or set of resources. 311 # 312 # Populated by the system. 313 # Read-only. 314 # Value must be treated as opaque by clients and . 315 # More info: 316 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 317 # +optional 318 "generateName": "A String", # Not currently supported by Cloud Run. 319 # 320 # GenerateName is an optional prefix, used by the server, to generate a 321 # unique name ONLY IF the Name field has not been provided. If this field is 322 # used, the name returned to the client will be different than the name 323 # passed. This value will also be combined with a unique suffix. The provided 324 # value has the same validation rules as the Name field, and may be truncated 325 # by the length of the suffix required to make the value unique on the 326 # server. 327 # 328 # If this field is specified and the generated name exists, the server will 329 # NOT return a 409 - instead, it will either return 201 Created or 500 with 330 # Reason ServerTimeout indicating a unique name could not be found in the 331 # time allotted, and the client should retry (optionally after the time 332 # indicated in the Retry-After header). 333 # 334 # Applied only if Name is not specified. 335 # More info: 336 # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency 337 # +optional 338 # string generateName = 2; 339 "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this 340 # object was created. It is not guaranteed to be set in happens-before order 341 # across separate operations. Clients may not set this value. It is 342 # represented in RFC3339 form and is in UTC. 343 # 344 # Populated by the system. 345 # Read-only. 346 # Null for lists. 347 # More info: 348 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 349 # +optional 350 "annotations": { # Annotations is an unstructured key value map stored with a resource that 351 # may be set by external tools to store and retrieve arbitrary metadata. They 352 # are not queryable and should be preserved when modifying objects. More 353 # info: http://kubernetes.io/docs/user-guide/annotations +optional 354 "a_key": "A String", 355 }, 356 "selfLink": "A String", # SelfLink is a URL representing this object. 357 # Populated by the system. 358 # Read-only. 359 # +optional 360 # string selfLink = 4; 361 "uid": "A String", # UID is the unique in time and space value for this object. It is typically 362 # generated by the server on successful creation of a resource and is not 363 # allowed to change on PUT operations. 364 # 365 # Populated by the system. 366 # Read-only. 367 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 368 # +optional 369 }, 370 } 371 372 x__xgafv: string, V1 error format. 373 Allowed values 374 1 - v1 error format 375 2 - v2 error format 376 377Returns: 378 An object of the form: 379 380 { 381 "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of 382 # date. 383 # +optional 384 "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that 385 # was last processed by the controller. 386 "conditions": [ # Array of observed TriggerConditions, indicating the current state 387 # of the Trigger. 388 { # TriggerCondition contains state information for an Trigger. 389 "status": "A String", # Status of the condition, one of True, False, Unknown. 390 "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info 391 # +optional 392 "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. 393 # +optional 394 "reason": "A String", # One-word CamelCase reason for the condition's current status. 395 # +optional 396 "message": "A String", # Human readable message indicating details about the current status. 397 # +optional 398 "type": "A String", # Type of Trigger condition. 399 }, 400 ], 401 "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. 402 }, 403 "kind": "A String", # The kind of resource, in this case "Trigger". 404 "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. 405 "filter": { # Filter is the filter to apply against all events from the Broker. Only 406 # events that pass this filter will be sent to the Subscriber. If not 407 # specified, will default to allowing all events. 408 # 409 # This must be specified in Cloud Run. 410 "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud 411 # event's type and source attributes. Only exact matches will pass the filter. 412 "source": "A String", 413 "type": "A String", 414 }, 415 }, 416 "subscriber": { # Subscriber is the addressable that receives events from the Broker that 417 # pass the Filter. It is required. 418 # 419 # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or 420 # /namespaces/my-project/services/my-service. 421 "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target 422 # endpoint, which should implement the Addressable duck type. 423 # For example, this could be a reference to a Route resource 424 # or a Knative Service resource. 425 # referred object. 426 "kind": "A String", # Kind of the referent. 427 # More info: 428 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 429 # +optional 430 "uid": "A String", # UID of the referent. 431 # More info: 432 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids 433 # +optional 434 "namespace": "A String", # Namespace of the referent. 435 # More info: 436 # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ 437 # +optional 438 "apiVersion": "A String", # API version of the referent. 439 # +optional 440 "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this 441 # string should contain a valid JSON/Go field access statement, such as 442 # desiredState.manifest.containers[2]. For example, if the object reference 443 # is to a container within a pod, this would take on a value like: 444 # "spec.containers{name}" (where "name" refers to the name of the container 445 # that triggered the event) or if no container name is specified 446 # "spec.containers[2]" (container with index 2 in this pod). This syntax is 447 # chosen only to have some well-defined way of referencing a part of an 448 # object. 449 "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. 450 # More info: 451 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 452 # +optional 453 "name": "A String", # Name of the referent. 454 # More info: 455 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names 456 # +optional 457 }, 458 "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. 459 # http://k8s-service for example 460 # http://myexternalhandler.example.com/foo/bar 461 }, 462 "broker": "A String", # Broker is the broker that this trigger receives events from. If not 463 # specified, will default to 'default'. 464 # 465 # Not currently supported by Cloud Run. 466 }, 467 "apiVersion": "A String", # The API version for this call such as "v1alpha1". 468 "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. 469 # all objects users must create. 470 "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have 471 # been deleted, this object will be garbage collected. 472 # +optional 473 { # OwnerReference contains enough information to let you identify an owning 474 # object. Currently, an owning object must be in the same namespace, so there 475 # is no namespace field. 476 "kind": "A String", # Kind of the referent. 477 # More info: 478 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 479 "uid": "A String", # UID of the referent. 480 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 481 "apiVersion": "A String", # API version of the referent. 482 "controller": True or False, # If true, this reference points to the managing controller. 483 # +optional 484 "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then 485 # the owner cannot be deleted from the key-value store until this 486 # reference is removed. 487 # Defaults to false. 488 # To set this field, a user needs "delete" permission of the owner, 489 # otherwise 422 (Unprocessable Entity) will be returned. 490 # +optional 491 "name": "A String", # Name of the referent. 492 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 493 }, 494 ], 495 "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. 496 # Is required when creating 497 # resources, although some resources may allow a client to request the 498 # generation of an appropriate name automatically. Name is primarily intended 499 # for creation idempotence and configuration definition. Cannot be updated. 500 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 501 # +optional 502 "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be 503 # deleted. This field is set by the server when a graceful deletion is 504 # requested by the user, and is not directly settable by a client. The 505 # resource is expected to be deleted (no longer visible from resource lists, 506 # and not reachable by name) after the time in this field, once the 507 # finalizers list is empty. As long as the finalizers list contains items, 508 # deletion is blocked. Once the deletionTimestamp is set, this value may not 509 # be unset or be set further into the future, although it may be shortened or 510 # the resource may be deleted prior to this time. For example, a user may 511 # request that a pod is deleted in 30 seconds. The Kubelet will react by 512 # sending a graceful termination signal to the containers in the pod. After 513 # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) 514 # to the container and after cleanup, remove the pod from the API. In the 515 # presence of network partitions, this object may still exist after this 516 # timestamp, until an administrator or automated process can determine the 517 # resource is fully terminated. 518 # If not set, graceful deletion of the object has not been requested. 519 # 520 # Populated by the system when a graceful deletion is requested. 521 # Read-only. 522 # More info: 523 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 524 # +optional 525 "clusterName": "A String", # Not currently supported by Cloud Run. 526 # 527 # The name of the cluster which the object belongs to. 528 # This is used to distinguish resources with same name and namespace in 529 # different clusters. This field is not set anywhere right now and apiserver 530 # is going to ignore it if set in create or update request. +optional 531 "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. 532 # 533 # Number of seconds allowed for this object to gracefully terminate before 534 # it will be removed from the system. Only set when deletionTimestamp is also 535 # set. May only be shortened. Read-only. +optional 536 "labels": { # Map of string keys and values that can be used to organize and categorize 537 # (scope and select) objects. May match selectors of replication controllers 538 # and routes. 539 # More info: http://kubernetes.io/docs/user-guide/labels 540 # +optional 541 "a_key": "A String", 542 }, 543 "namespace": "A String", # Namespace defines the space within each name must be unique, within a 544 # Cloud Run region. In Cloud Run the namespace must be equal to either the 545 # project ID or project number. 546 "generation": 42, # A sequence number representing a specific generation of the desired state. 547 # Populated by the system. Read-only. 548 # +optional 549 "finalizers": [ # Not currently supported by Cloud Run. 550 # 551 # Must be empty before the object is deleted from the registry. Each entry 552 # is an identifier for the responsible component that will remove the entry 553 # from the list. If the deletionTimestamp of the object is non-nil, entries 554 # in this list can only be removed. 555 # +optional 556 # +patchStrategy=merge 557 "A String", 558 ], 559 "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. 560 # 561 # An initializer is a controller which enforces some system invariant at 562 # object creation time. This field is a list of initializers that have not 563 # yet acted on this object. If nil or empty, this object has been completely 564 # initialized. Otherwise, the object is considered uninitialized and is 565 # hidden (in list/watch and get calls) from clients that haven't explicitly 566 # asked to observe uninitialized objects. 567 # 568 # When an object is created, the system will populate this list with the 569 # current set of initializers. Only privileged users may set or modify this 570 # list. Once it is empty, it may not be modified further by any user. 571 "pending": [ # Pending is a list of initializers that must execute in order before this 572 # object is visible. When the last pending initializer is removed, and no 573 # failing result is set, the initializers struct will be set to nil and the 574 # object is considered as initialized and visible to all clients. 575 # +patchMergeKey=name 576 # +patchStrategy=merge 577 { # Initializer is information about an initializer that has not yet completed. 578 "name": "A String", # name of the process that is responsible for initializing this object. 579 }, 580 ], 581 }, 582 "resourceVersion": "A String", # An opaque value that represents the internal version of this object that 583 # can be used by clients to determine when objects have changed. May be used 584 # for optimistic concurrency, change detection, and the watch operation on a 585 # resource or set of resources. Clients must treat these values as opaque and 586 # passed unmodified back to the server. They may only be valid for a 587 # particular resource or set of resources. 588 # 589 # Populated by the system. 590 # Read-only. 591 # Value must be treated as opaque by clients and . 592 # More info: 593 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 594 # +optional 595 "generateName": "A String", # Not currently supported by Cloud Run. 596 # 597 # GenerateName is an optional prefix, used by the server, to generate a 598 # unique name ONLY IF the Name field has not been provided. If this field is 599 # used, the name returned to the client will be different than the name 600 # passed. This value will also be combined with a unique suffix. The provided 601 # value has the same validation rules as the Name field, and may be truncated 602 # by the length of the suffix required to make the value unique on the 603 # server. 604 # 605 # If this field is specified and the generated name exists, the server will 606 # NOT return a 409 - instead, it will either return 201 Created or 500 with 607 # Reason ServerTimeout indicating a unique name could not be found in the 608 # time allotted, and the client should retry (optionally after the time 609 # indicated in the Retry-After header). 610 # 611 # Applied only if Name is not specified. 612 # More info: 613 # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency 614 # +optional 615 # string generateName = 2; 616 "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this 617 # object was created. It is not guaranteed to be set in happens-before order 618 # across separate operations. Clients may not set this value. It is 619 # represented in RFC3339 form and is in UTC. 620 # 621 # Populated by the system. 622 # Read-only. 623 # Null for lists. 624 # More info: 625 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 626 # +optional 627 "annotations": { # Annotations is an unstructured key value map stored with a resource that 628 # may be set by external tools to store and retrieve arbitrary metadata. They 629 # are not queryable and should be preserved when modifying objects. More 630 # info: http://kubernetes.io/docs/user-guide/annotations +optional 631 "a_key": "A String", 632 }, 633 "selfLink": "A String", # SelfLink is a URL representing this object. 634 # Populated by the system. 635 # Read-only. 636 # +optional 637 # string selfLink = 4; 638 "uid": "A String", # UID is the unique in time and space value for this object. It is typically 639 # generated by the server on successful creation of a resource and is not 640 # allowed to change on PUT operations. 641 # 642 # Populated by the system. 643 # Read-only. 644 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 645 # +optional 646 }, 647 }</pre> 648</div> 649 650<div class="method"> 651 <code class="details" id="delete">delete(name, kind=None, propagationPolicy=None, apiVersion=None, x__xgafv=None)</code> 652 <pre>Rpc to delete a trigger. 653 654Args: 655 name: string, The name of the trigger being deleted. If needed, replace 656{namespace_id} with the project ID. (required) 657 kind: string, Cloud Run currently ignores this parameter. 658 propagationPolicy: string, Specifies the propagation policy of delete. Cloud Run currently ignores 659this setting, and deletes in the background. Please see 660kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for 661more information. 662 apiVersion: string, Cloud Run currently ignores this parameter. 663 x__xgafv: string, V1 error format. 664 Allowed values 665 1 - v1 error format 666 2 - v2 error format 667 668Returns: 669 An object of the form: 670 671 { # A generic empty message that you can re-use to avoid defining duplicated 672 # empty messages in your APIs. A typical example is to use it as the request 673 # or the response type of an API method. For instance: 674 # 675 # service Foo { 676 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); 677 # } 678 # 679 # The JSON representation for `Empty` is empty JSON object `{}`. 680 }</pre> 681</div> 682 683<div class="method"> 684 <code class="details" id="get">get(name, x__xgafv=None)</code> 685 <pre>Rpc to get information about a trigger. 686 687Args: 688 name: string, The name of the trigger being retrieved. If needed, replace 689{namespace_id} with the project ID. (required) 690 x__xgafv: string, V1 error format. 691 Allowed values 692 1 - v1 error format 693 2 - v2 error format 694 695Returns: 696 An object of the form: 697 698 { 699 "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of 700 # date. 701 # +optional 702 "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that 703 # was last processed by the controller. 704 "conditions": [ # Array of observed TriggerConditions, indicating the current state 705 # of the Trigger. 706 { # TriggerCondition contains state information for an Trigger. 707 "status": "A String", # Status of the condition, one of True, False, Unknown. 708 "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info 709 # +optional 710 "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. 711 # +optional 712 "reason": "A String", # One-word CamelCase reason for the condition's current status. 713 # +optional 714 "message": "A String", # Human readable message indicating details about the current status. 715 # +optional 716 "type": "A String", # Type of Trigger condition. 717 }, 718 ], 719 "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. 720 }, 721 "kind": "A String", # The kind of resource, in this case "Trigger". 722 "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. 723 "filter": { # Filter is the filter to apply against all events from the Broker. Only 724 # events that pass this filter will be sent to the Subscriber. If not 725 # specified, will default to allowing all events. 726 # 727 # This must be specified in Cloud Run. 728 "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud 729 # event's type and source attributes. Only exact matches will pass the filter. 730 "source": "A String", 731 "type": "A String", 732 }, 733 }, 734 "subscriber": { # Subscriber is the addressable that receives events from the Broker that 735 # pass the Filter. It is required. 736 # 737 # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or 738 # /namespaces/my-project/services/my-service. 739 "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target 740 # endpoint, which should implement the Addressable duck type. 741 # For example, this could be a reference to a Route resource 742 # or a Knative Service resource. 743 # referred object. 744 "kind": "A String", # Kind of the referent. 745 # More info: 746 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 747 # +optional 748 "uid": "A String", # UID of the referent. 749 # More info: 750 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids 751 # +optional 752 "namespace": "A String", # Namespace of the referent. 753 # More info: 754 # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ 755 # +optional 756 "apiVersion": "A String", # API version of the referent. 757 # +optional 758 "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this 759 # string should contain a valid JSON/Go field access statement, such as 760 # desiredState.manifest.containers[2]. For example, if the object reference 761 # is to a container within a pod, this would take on a value like: 762 # "spec.containers{name}" (where "name" refers to the name of the container 763 # that triggered the event) or if no container name is specified 764 # "spec.containers[2]" (container with index 2 in this pod). This syntax is 765 # chosen only to have some well-defined way of referencing a part of an 766 # object. 767 "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. 768 # More info: 769 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 770 # +optional 771 "name": "A String", # Name of the referent. 772 # More info: 773 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names 774 # +optional 775 }, 776 "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. 777 # http://k8s-service for example 778 # http://myexternalhandler.example.com/foo/bar 779 }, 780 "broker": "A String", # Broker is the broker that this trigger receives events from. If not 781 # specified, will default to 'default'. 782 # 783 # Not currently supported by Cloud Run. 784 }, 785 "apiVersion": "A String", # The API version for this call such as "v1alpha1". 786 "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. 787 # all objects users must create. 788 "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have 789 # been deleted, this object will be garbage collected. 790 # +optional 791 { # OwnerReference contains enough information to let you identify an owning 792 # object. Currently, an owning object must be in the same namespace, so there 793 # is no namespace field. 794 "kind": "A String", # Kind of the referent. 795 # More info: 796 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 797 "uid": "A String", # UID of the referent. 798 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 799 "apiVersion": "A String", # API version of the referent. 800 "controller": True or False, # If true, this reference points to the managing controller. 801 # +optional 802 "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then 803 # the owner cannot be deleted from the key-value store until this 804 # reference is removed. 805 # Defaults to false. 806 # To set this field, a user needs "delete" permission of the owner, 807 # otherwise 422 (Unprocessable Entity) will be returned. 808 # +optional 809 "name": "A String", # Name of the referent. 810 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 811 }, 812 ], 813 "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. 814 # Is required when creating 815 # resources, although some resources may allow a client to request the 816 # generation of an appropriate name automatically. Name is primarily intended 817 # for creation idempotence and configuration definition. Cannot be updated. 818 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 819 # +optional 820 "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be 821 # deleted. This field is set by the server when a graceful deletion is 822 # requested by the user, and is not directly settable by a client. The 823 # resource is expected to be deleted (no longer visible from resource lists, 824 # and not reachable by name) after the time in this field, once the 825 # finalizers list is empty. As long as the finalizers list contains items, 826 # deletion is blocked. Once the deletionTimestamp is set, this value may not 827 # be unset or be set further into the future, although it may be shortened or 828 # the resource may be deleted prior to this time. For example, a user may 829 # request that a pod is deleted in 30 seconds. The Kubelet will react by 830 # sending a graceful termination signal to the containers in the pod. After 831 # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) 832 # to the container and after cleanup, remove the pod from the API. In the 833 # presence of network partitions, this object may still exist after this 834 # timestamp, until an administrator or automated process can determine the 835 # resource is fully terminated. 836 # If not set, graceful deletion of the object has not been requested. 837 # 838 # Populated by the system when a graceful deletion is requested. 839 # Read-only. 840 # More info: 841 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 842 # +optional 843 "clusterName": "A String", # Not currently supported by Cloud Run. 844 # 845 # The name of the cluster which the object belongs to. 846 # This is used to distinguish resources with same name and namespace in 847 # different clusters. This field is not set anywhere right now and apiserver 848 # is going to ignore it if set in create or update request. +optional 849 "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. 850 # 851 # Number of seconds allowed for this object to gracefully terminate before 852 # it will be removed from the system. Only set when deletionTimestamp is also 853 # set. May only be shortened. Read-only. +optional 854 "labels": { # Map of string keys and values that can be used to organize and categorize 855 # (scope and select) objects. May match selectors of replication controllers 856 # and routes. 857 # More info: http://kubernetes.io/docs/user-guide/labels 858 # +optional 859 "a_key": "A String", 860 }, 861 "namespace": "A String", # Namespace defines the space within each name must be unique, within a 862 # Cloud Run region. In Cloud Run the namespace must be equal to either the 863 # project ID or project number. 864 "generation": 42, # A sequence number representing a specific generation of the desired state. 865 # Populated by the system. Read-only. 866 # +optional 867 "finalizers": [ # Not currently supported by Cloud Run. 868 # 869 # Must be empty before the object is deleted from the registry. Each entry 870 # is an identifier for the responsible component that will remove the entry 871 # from the list. If the deletionTimestamp of the object is non-nil, entries 872 # in this list can only be removed. 873 # +optional 874 # +patchStrategy=merge 875 "A String", 876 ], 877 "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. 878 # 879 # An initializer is a controller which enforces some system invariant at 880 # object creation time. This field is a list of initializers that have not 881 # yet acted on this object. If nil or empty, this object has been completely 882 # initialized. Otherwise, the object is considered uninitialized and is 883 # hidden (in list/watch and get calls) from clients that haven't explicitly 884 # asked to observe uninitialized objects. 885 # 886 # When an object is created, the system will populate this list with the 887 # current set of initializers. Only privileged users may set or modify this 888 # list. Once it is empty, it may not be modified further by any user. 889 "pending": [ # Pending is a list of initializers that must execute in order before this 890 # object is visible. When the last pending initializer is removed, and no 891 # failing result is set, the initializers struct will be set to nil and the 892 # object is considered as initialized and visible to all clients. 893 # +patchMergeKey=name 894 # +patchStrategy=merge 895 { # Initializer is information about an initializer that has not yet completed. 896 "name": "A String", # name of the process that is responsible for initializing this object. 897 }, 898 ], 899 }, 900 "resourceVersion": "A String", # An opaque value that represents the internal version of this object that 901 # can be used by clients to determine when objects have changed. May be used 902 # for optimistic concurrency, change detection, and the watch operation on a 903 # resource or set of resources. Clients must treat these values as opaque and 904 # passed unmodified back to the server. They may only be valid for a 905 # particular resource or set of resources. 906 # 907 # Populated by the system. 908 # Read-only. 909 # Value must be treated as opaque by clients and . 910 # More info: 911 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 912 # +optional 913 "generateName": "A String", # Not currently supported by Cloud Run. 914 # 915 # GenerateName is an optional prefix, used by the server, to generate a 916 # unique name ONLY IF the Name field has not been provided. If this field is 917 # used, the name returned to the client will be different than the name 918 # passed. This value will also be combined with a unique suffix. The provided 919 # value has the same validation rules as the Name field, and may be truncated 920 # by the length of the suffix required to make the value unique on the 921 # server. 922 # 923 # If this field is specified and the generated name exists, the server will 924 # NOT return a 409 - instead, it will either return 201 Created or 500 with 925 # Reason ServerTimeout indicating a unique name could not be found in the 926 # time allotted, and the client should retry (optionally after the time 927 # indicated in the Retry-After header). 928 # 929 # Applied only if Name is not specified. 930 # More info: 931 # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency 932 # +optional 933 # string generateName = 2; 934 "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this 935 # object was created. It is not guaranteed to be set in happens-before order 936 # across separate operations. Clients may not set this value. It is 937 # represented in RFC3339 form and is in UTC. 938 # 939 # Populated by the system. 940 # Read-only. 941 # Null for lists. 942 # More info: 943 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 944 # +optional 945 "annotations": { # Annotations is an unstructured key value map stored with a resource that 946 # may be set by external tools to store and retrieve arbitrary metadata. They 947 # are not queryable and should be preserved when modifying objects. More 948 # info: http://kubernetes.io/docs/user-guide/annotations +optional 949 "a_key": "A String", 950 }, 951 "selfLink": "A String", # SelfLink is a URL representing this object. 952 # Populated by the system. 953 # Read-only. 954 # +optional 955 # string selfLink = 4; 956 "uid": "A String", # UID is the unique in time and space value for this object. It is typically 957 # generated by the server on successful creation of a resource and is not 958 # allowed to change on PUT operations. 959 # 960 # Populated by the system. 961 # Read-only. 962 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 963 # +optional 964 }, 965 }</pre> 966</div> 967 968<div class="method"> 969 <code class="details" id="list">list(parent, labelSelector=None, includeUninitialized=None, x__xgafv=None, resourceVersion=None, limit=None, watch=None, continue=None, fieldSelector=None)</code> 970 <pre>Rpc to list triggers. 971 972Args: 973 parent: string, The project ID or project number from which the triggers should 974be listed. (required) 975 labelSelector: string, Allows to filter resources based on a label. Supported operations are 976=, !=, exists, in, and notIn. 977 includeUninitialized: boolean, Not currently used by Cloud Run. 978 x__xgafv: string, V1 error format. 979 Allowed values 980 1 - v1 error format 981 2 - v2 error format 982 resourceVersion: string, The baseline resource version from which the list or watch operation should 983start. Not currently used by Cloud Run. 984 limit: integer, The maximum number of records that should be returned. 985 watch: boolean, Flag that indicates that the client expects to watch this resource as well. 986Not currently used by Cloud Run. 987 continue: string, Optional encoded string to continue paging. 988 fieldSelector: string, Allows to filter resources based on a specific value for a field name. 989Send this in a query string format. i.e. 'metadata.name%3Dlorem'. 990Not currently used by Cloud Run. 991 992Returns: 993 An object of the form: 994 995 { # ListTriggersResponse is a list of Trigger resources. 996 "unreachable": [ # Locations that could not be reached. 997 "A String", 998 ], 999 "kind": "A String", # The kind of this resource, in this case "TriggerList". 1000 "items": [ # List of Triggers. 1001 { 1002 "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of 1003 # date. 1004 # +optional 1005 "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that 1006 # was last processed by the controller. 1007 "conditions": [ # Array of observed TriggerConditions, indicating the current state 1008 # of the Trigger. 1009 { # TriggerCondition contains state information for an Trigger. 1010 "status": "A String", # Status of the condition, one of True, False, Unknown. 1011 "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info 1012 # +optional 1013 "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. 1014 # +optional 1015 "reason": "A String", # One-word CamelCase reason for the condition's current status. 1016 # +optional 1017 "message": "A String", # Human readable message indicating details about the current status. 1018 # +optional 1019 "type": "A String", # Type of Trigger condition. 1020 }, 1021 ], 1022 "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. 1023 }, 1024 "kind": "A String", # The kind of resource, in this case "Trigger". 1025 "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. 1026 "filter": { # Filter is the filter to apply against all events from the Broker. Only 1027 # events that pass this filter will be sent to the Subscriber. If not 1028 # specified, will default to allowing all events. 1029 # 1030 # This must be specified in Cloud Run. 1031 "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud 1032 # event's type and source attributes. Only exact matches will pass the filter. 1033 "source": "A String", 1034 "type": "A String", 1035 }, 1036 }, 1037 "subscriber": { # Subscriber is the addressable that receives events from the Broker that 1038 # pass the Filter. It is required. 1039 # 1040 # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or 1041 # /namespaces/my-project/services/my-service. 1042 "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target 1043 # endpoint, which should implement the Addressable duck type. 1044 # For example, this could be a reference to a Route resource 1045 # or a Knative Service resource. 1046 # referred object. 1047 "kind": "A String", # Kind of the referent. 1048 # More info: 1049 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 1050 # +optional 1051 "uid": "A String", # UID of the referent. 1052 # More info: 1053 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids 1054 # +optional 1055 "namespace": "A String", # Namespace of the referent. 1056 # More info: 1057 # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ 1058 # +optional 1059 "apiVersion": "A String", # API version of the referent. 1060 # +optional 1061 "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this 1062 # string should contain a valid JSON/Go field access statement, such as 1063 # desiredState.manifest.containers[2]. For example, if the object reference 1064 # is to a container within a pod, this would take on a value like: 1065 # "spec.containers{name}" (where "name" refers to the name of the container 1066 # that triggered the event) or if no container name is specified 1067 # "spec.containers[2]" (container with index 2 in this pod). This syntax is 1068 # chosen only to have some well-defined way of referencing a part of an 1069 # object. 1070 "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. 1071 # More info: 1072 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 1073 # +optional 1074 "name": "A String", # Name of the referent. 1075 # More info: 1076 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names 1077 # +optional 1078 }, 1079 "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. 1080 # http://k8s-service for example 1081 # http://myexternalhandler.example.com/foo/bar 1082 }, 1083 "broker": "A String", # Broker is the broker that this trigger receives events from. If not 1084 # specified, will default to 'default'. 1085 # 1086 # Not currently supported by Cloud Run. 1087 }, 1088 "apiVersion": "A String", # The API version for this call such as "v1alpha1". 1089 "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. 1090 # all objects users must create. 1091 "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have 1092 # been deleted, this object will be garbage collected. 1093 # +optional 1094 { # OwnerReference contains enough information to let you identify an owning 1095 # object. Currently, an owning object must be in the same namespace, so there 1096 # is no namespace field. 1097 "kind": "A String", # Kind of the referent. 1098 # More info: 1099 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 1100 "uid": "A String", # UID of the referent. 1101 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 1102 "apiVersion": "A String", # API version of the referent. 1103 "controller": True or False, # If true, this reference points to the managing controller. 1104 # +optional 1105 "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then 1106 # the owner cannot be deleted from the key-value store until this 1107 # reference is removed. 1108 # Defaults to false. 1109 # To set this field, a user needs "delete" permission of the owner, 1110 # otherwise 422 (Unprocessable Entity) will be returned. 1111 # +optional 1112 "name": "A String", # Name of the referent. 1113 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 1114 }, 1115 ], 1116 "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. 1117 # Is required when creating 1118 # resources, although some resources may allow a client to request the 1119 # generation of an appropriate name automatically. Name is primarily intended 1120 # for creation idempotence and configuration definition. Cannot be updated. 1121 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 1122 # +optional 1123 "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be 1124 # deleted. This field is set by the server when a graceful deletion is 1125 # requested by the user, and is not directly settable by a client. The 1126 # resource is expected to be deleted (no longer visible from resource lists, 1127 # and not reachable by name) after the time in this field, once the 1128 # finalizers list is empty. As long as the finalizers list contains items, 1129 # deletion is blocked. Once the deletionTimestamp is set, this value may not 1130 # be unset or be set further into the future, although it may be shortened or 1131 # the resource may be deleted prior to this time. For example, a user may 1132 # request that a pod is deleted in 30 seconds. The Kubelet will react by 1133 # sending a graceful termination signal to the containers in the pod. After 1134 # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) 1135 # to the container and after cleanup, remove the pod from the API. In the 1136 # presence of network partitions, this object may still exist after this 1137 # timestamp, until an administrator or automated process can determine the 1138 # resource is fully terminated. 1139 # If not set, graceful deletion of the object has not been requested. 1140 # 1141 # Populated by the system when a graceful deletion is requested. 1142 # Read-only. 1143 # More info: 1144 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 1145 # +optional 1146 "clusterName": "A String", # Not currently supported by Cloud Run. 1147 # 1148 # The name of the cluster which the object belongs to. 1149 # This is used to distinguish resources with same name and namespace in 1150 # different clusters. This field is not set anywhere right now and apiserver 1151 # is going to ignore it if set in create or update request. +optional 1152 "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. 1153 # 1154 # Number of seconds allowed for this object to gracefully terminate before 1155 # it will be removed from the system. Only set when deletionTimestamp is also 1156 # set. May only be shortened. Read-only. +optional 1157 "labels": { # Map of string keys and values that can be used to organize and categorize 1158 # (scope and select) objects. May match selectors of replication controllers 1159 # and routes. 1160 # More info: http://kubernetes.io/docs/user-guide/labels 1161 # +optional 1162 "a_key": "A String", 1163 }, 1164 "namespace": "A String", # Namespace defines the space within each name must be unique, within a 1165 # Cloud Run region. In Cloud Run the namespace must be equal to either the 1166 # project ID or project number. 1167 "generation": 42, # A sequence number representing a specific generation of the desired state. 1168 # Populated by the system. Read-only. 1169 # +optional 1170 "finalizers": [ # Not currently supported by Cloud Run. 1171 # 1172 # Must be empty before the object is deleted from the registry. Each entry 1173 # is an identifier for the responsible component that will remove the entry 1174 # from the list. If the deletionTimestamp of the object is non-nil, entries 1175 # in this list can only be removed. 1176 # +optional 1177 # +patchStrategy=merge 1178 "A String", 1179 ], 1180 "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. 1181 # 1182 # An initializer is a controller which enforces some system invariant at 1183 # object creation time. This field is a list of initializers that have not 1184 # yet acted on this object. If nil or empty, this object has been completely 1185 # initialized. Otherwise, the object is considered uninitialized and is 1186 # hidden (in list/watch and get calls) from clients that haven't explicitly 1187 # asked to observe uninitialized objects. 1188 # 1189 # When an object is created, the system will populate this list with the 1190 # current set of initializers. Only privileged users may set or modify this 1191 # list. Once it is empty, it may not be modified further by any user. 1192 "pending": [ # Pending is a list of initializers that must execute in order before this 1193 # object is visible. When the last pending initializer is removed, and no 1194 # failing result is set, the initializers struct will be set to nil and the 1195 # object is considered as initialized and visible to all clients. 1196 # +patchMergeKey=name 1197 # +patchStrategy=merge 1198 { # Initializer is information about an initializer that has not yet completed. 1199 "name": "A String", # name of the process that is responsible for initializing this object. 1200 }, 1201 ], 1202 }, 1203 "resourceVersion": "A String", # An opaque value that represents the internal version of this object that 1204 # can be used by clients to determine when objects have changed. May be used 1205 # for optimistic concurrency, change detection, and the watch operation on a 1206 # resource or set of resources. Clients must treat these values as opaque and 1207 # passed unmodified back to the server. They may only be valid for a 1208 # particular resource or set of resources. 1209 # 1210 # Populated by the system. 1211 # Read-only. 1212 # Value must be treated as opaque by clients and . 1213 # More info: 1214 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 1215 # +optional 1216 "generateName": "A String", # Not currently supported by Cloud Run. 1217 # 1218 # GenerateName is an optional prefix, used by the server, to generate a 1219 # unique name ONLY IF the Name field has not been provided. If this field is 1220 # used, the name returned to the client will be different than the name 1221 # passed. This value will also be combined with a unique suffix. The provided 1222 # value has the same validation rules as the Name field, and may be truncated 1223 # by the length of the suffix required to make the value unique on the 1224 # server. 1225 # 1226 # If this field is specified and the generated name exists, the server will 1227 # NOT return a 409 - instead, it will either return 201 Created or 500 with 1228 # Reason ServerTimeout indicating a unique name could not be found in the 1229 # time allotted, and the client should retry (optionally after the time 1230 # indicated in the Retry-After header). 1231 # 1232 # Applied only if Name is not specified. 1233 # More info: 1234 # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency 1235 # +optional 1236 # string generateName = 2; 1237 "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this 1238 # object was created. It is not guaranteed to be set in happens-before order 1239 # across separate operations. Clients may not set this value. It is 1240 # represented in RFC3339 form and is in UTC. 1241 # 1242 # Populated by the system. 1243 # Read-only. 1244 # Null for lists. 1245 # More info: 1246 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 1247 # +optional 1248 "annotations": { # Annotations is an unstructured key value map stored with a resource that 1249 # may be set by external tools to store and retrieve arbitrary metadata. They 1250 # are not queryable and should be preserved when modifying objects. More 1251 # info: http://kubernetes.io/docs/user-guide/annotations +optional 1252 "a_key": "A String", 1253 }, 1254 "selfLink": "A String", # SelfLink is a URL representing this object. 1255 # Populated by the system. 1256 # Read-only. 1257 # +optional 1258 # string selfLink = 4; 1259 "uid": "A String", # UID is the unique in time and space value for this object. It is typically 1260 # generated by the server on successful creation of a resource and is not 1261 # allowed to change on PUT operations. 1262 # 1263 # Populated by the system. 1264 # Read-only. 1265 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 1266 # +optional 1267 }, 1268 }, 1269 ], 1270 "apiVersion": "A String", # The API version for this call such as "v1alpha1". 1271 "metadata": { # ListMeta describes metadata that synthetic resources must have, including # Metadata associated with this Trigger list. 1272 # lists and various status objects. A resource may have only one of 1273 # {ObjectMeta, ListMeta}. 1274 "continue": "A String", # continue may be set if the user set a limit on the number of items 1275 # returned, and indicates that the server has more data available. The value 1276 # is opaque and may be used to issue another request to the endpoint that 1277 # served this list to retrieve the next set of available objects. Continuing 1278 # a list may not be possible if the server configuration has changed or more 1279 # than a few minutes have passed. The resourceVersion field returned when 1280 # using this continue value will be identical to the value in the first 1281 # response. 1282 "selfLink": "A String", # SelfLink is a URL representing this object. 1283 # Populated by the system. 1284 # Read-only. 1285 # +optional 1286 "resourceVersion": "A String", # String that identifies the server's internal version of this object that 1287 # can be used by clients to determine when objects have changed. Value must 1288 # be treated as opaque by clients and passed unmodified back to the server. 1289 # Populated by the system. 1290 # Read-only. 1291 # More info: 1292 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 1293 # +optional 1294 }, 1295 }</pre> 1296</div> 1297 1298<div class="method"> 1299 <code class="details" id="replaceTrigger">replaceTrigger(name, body, x__xgafv=None)</code> 1300 <pre>Rpc to replace a trigger. 1301 1302Only the spec and metadata labels and annotations are modifiable. After 1303the Update request, Cloud Run will work to make the 'status' 1304match the requested 'spec'. 1305 1306May provide metadata.resourceVersion to enforce update from last read for 1307optimistic concurrency control. 1308 1309Args: 1310 name: string, The name of the trigger being retrieved. If needed, replace 1311{namespace_id} with the project ID. (required) 1312 body: object, The request body. (required) 1313 The object takes the form of: 1314 1315{ 1316 "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of 1317 # date. 1318 # +optional 1319 "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that 1320 # was last processed by the controller. 1321 "conditions": [ # Array of observed TriggerConditions, indicating the current state 1322 # of the Trigger. 1323 { # TriggerCondition contains state information for an Trigger. 1324 "status": "A String", # Status of the condition, one of True, False, Unknown. 1325 "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info 1326 # +optional 1327 "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. 1328 # +optional 1329 "reason": "A String", # One-word CamelCase reason for the condition's current status. 1330 # +optional 1331 "message": "A String", # Human readable message indicating details about the current status. 1332 # +optional 1333 "type": "A String", # Type of Trigger condition. 1334 }, 1335 ], 1336 "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. 1337 }, 1338 "kind": "A String", # The kind of resource, in this case "Trigger". 1339 "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. 1340 "filter": { # Filter is the filter to apply against all events from the Broker. Only 1341 # events that pass this filter will be sent to the Subscriber. If not 1342 # specified, will default to allowing all events. 1343 # 1344 # This must be specified in Cloud Run. 1345 "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud 1346 # event's type and source attributes. Only exact matches will pass the filter. 1347 "source": "A String", 1348 "type": "A String", 1349 }, 1350 }, 1351 "subscriber": { # Subscriber is the addressable that receives events from the Broker that 1352 # pass the Filter. It is required. 1353 # 1354 # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or 1355 # /namespaces/my-project/services/my-service. 1356 "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target 1357 # endpoint, which should implement the Addressable duck type. 1358 # For example, this could be a reference to a Route resource 1359 # or a Knative Service resource. 1360 # referred object. 1361 "kind": "A String", # Kind of the referent. 1362 # More info: 1363 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 1364 # +optional 1365 "uid": "A String", # UID of the referent. 1366 # More info: 1367 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids 1368 # +optional 1369 "namespace": "A String", # Namespace of the referent. 1370 # More info: 1371 # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ 1372 # +optional 1373 "apiVersion": "A String", # API version of the referent. 1374 # +optional 1375 "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this 1376 # string should contain a valid JSON/Go field access statement, such as 1377 # desiredState.manifest.containers[2]. For example, if the object reference 1378 # is to a container within a pod, this would take on a value like: 1379 # "spec.containers{name}" (where "name" refers to the name of the container 1380 # that triggered the event) or if no container name is specified 1381 # "spec.containers[2]" (container with index 2 in this pod). This syntax is 1382 # chosen only to have some well-defined way of referencing a part of an 1383 # object. 1384 "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. 1385 # More info: 1386 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 1387 # +optional 1388 "name": "A String", # Name of the referent. 1389 # More info: 1390 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names 1391 # +optional 1392 }, 1393 "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. 1394 # http://k8s-service for example 1395 # http://myexternalhandler.example.com/foo/bar 1396 }, 1397 "broker": "A String", # Broker is the broker that this trigger receives events from. If not 1398 # specified, will default to 'default'. 1399 # 1400 # Not currently supported by Cloud Run. 1401 }, 1402 "apiVersion": "A String", # The API version for this call such as "v1alpha1". 1403 "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. 1404 # all objects users must create. 1405 "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have 1406 # been deleted, this object will be garbage collected. 1407 # +optional 1408 { # OwnerReference contains enough information to let you identify an owning 1409 # object. Currently, an owning object must be in the same namespace, so there 1410 # is no namespace field. 1411 "kind": "A String", # Kind of the referent. 1412 # More info: 1413 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 1414 "uid": "A String", # UID of the referent. 1415 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 1416 "apiVersion": "A String", # API version of the referent. 1417 "controller": True or False, # If true, this reference points to the managing controller. 1418 # +optional 1419 "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then 1420 # the owner cannot be deleted from the key-value store until this 1421 # reference is removed. 1422 # Defaults to false. 1423 # To set this field, a user needs "delete" permission of the owner, 1424 # otherwise 422 (Unprocessable Entity) will be returned. 1425 # +optional 1426 "name": "A String", # Name of the referent. 1427 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 1428 }, 1429 ], 1430 "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. 1431 # Is required when creating 1432 # resources, although some resources may allow a client to request the 1433 # generation of an appropriate name automatically. Name is primarily intended 1434 # for creation idempotence and configuration definition. Cannot be updated. 1435 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 1436 # +optional 1437 "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be 1438 # deleted. This field is set by the server when a graceful deletion is 1439 # requested by the user, and is not directly settable by a client. The 1440 # resource is expected to be deleted (no longer visible from resource lists, 1441 # and not reachable by name) after the time in this field, once the 1442 # finalizers list is empty. As long as the finalizers list contains items, 1443 # deletion is blocked. Once the deletionTimestamp is set, this value may not 1444 # be unset or be set further into the future, although it may be shortened or 1445 # the resource may be deleted prior to this time. For example, a user may 1446 # request that a pod is deleted in 30 seconds. The Kubelet will react by 1447 # sending a graceful termination signal to the containers in the pod. After 1448 # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) 1449 # to the container and after cleanup, remove the pod from the API. In the 1450 # presence of network partitions, this object may still exist after this 1451 # timestamp, until an administrator or automated process can determine the 1452 # resource is fully terminated. 1453 # If not set, graceful deletion of the object has not been requested. 1454 # 1455 # Populated by the system when a graceful deletion is requested. 1456 # Read-only. 1457 # More info: 1458 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 1459 # +optional 1460 "clusterName": "A String", # Not currently supported by Cloud Run. 1461 # 1462 # The name of the cluster which the object belongs to. 1463 # This is used to distinguish resources with same name and namespace in 1464 # different clusters. This field is not set anywhere right now and apiserver 1465 # is going to ignore it if set in create or update request. +optional 1466 "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. 1467 # 1468 # Number of seconds allowed for this object to gracefully terminate before 1469 # it will be removed from the system. Only set when deletionTimestamp is also 1470 # set. May only be shortened. Read-only. +optional 1471 "labels": { # Map of string keys and values that can be used to organize and categorize 1472 # (scope and select) objects. May match selectors of replication controllers 1473 # and routes. 1474 # More info: http://kubernetes.io/docs/user-guide/labels 1475 # +optional 1476 "a_key": "A String", 1477 }, 1478 "namespace": "A String", # Namespace defines the space within each name must be unique, within a 1479 # Cloud Run region. In Cloud Run the namespace must be equal to either the 1480 # project ID or project number. 1481 "generation": 42, # A sequence number representing a specific generation of the desired state. 1482 # Populated by the system. Read-only. 1483 # +optional 1484 "finalizers": [ # Not currently supported by Cloud Run. 1485 # 1486 # Must be empty before the object is deleted from the registry. Each entry 1487 # is an identifier for the responsible component that will remove the entry 1488 # from the list. If the deletionTimestamp of the object is non-nil, entries 1489 # in this list can only be removed. 1490 # +optional 1491 # +patchStrategy=merge 1492 "A String", 1493 ], 1494 "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. 1495 # 1496 # An initializer is a controller which enforces some system invariant at 1497 # object creation time. This field is a list of initializers that have not 1498 # yet acted on this object. If nil or empty, this object has been completely 1499 # initialized. Otherwise, the object is considered uninitialized and is 1500 # hidden (in list/watch and get calls) from clients that haven't explicitly 1501 # asked to observe uninitialized objects. 1502 # 1503 # When an object is created, the system will populate this list with the 1504 # current set of initializers. Only privileged users may set or modify this 1505 # list. Once it is empty, it may not be modified further by any user. 1506 "pending": [ # Pending is a list of initializers that must execute in order before this 1507 # object is visible. When the last pending initializer is removed, and no 1508 # failing result is set, the initializers struct will be set to nil and the 1509 # object is considered as initialized and visible to all clients. 1510 # +patchMergeKey=name 1511 # +patchStrategy=merge 1512 { # Initializer is information about an initializer that has not yet completed. 1513 "name": "A String", # name of the process that is responsible for initializing this object. 1514 }, 1515 ], 1516 }, 1517 "resourceVersion": "A String", # An opaque value that represents the internal version of this object that 1518 # can be used by clients to determine when objects have changed. May be used 1519 # for optimistic concurrency, change detection, and the watch operation on a 1520 # resource or set of resources. Clients must treat these values as opaque and 1521 # passed unmodified back to the server. They may only be valid for a 1522 # particular resource or set of resources. 1523 # 1524 # Populated by the system. 1525 # Read-only. 1526 # Value must be treated as opaque by clients and . 1527 # More info: 1528 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 1529 # +optional 1530 "generateName": "A String", # Not currently supported by Cloud Run. 1531 # 1532 # GenerateName is an optional prefix, used by the server, to generate a 1533 # unique name ONLY IF the Name field has not been provided. If this field is 1534 # used, the name returned to the client will be different than the name 1535 # passed. This value will also be combined with a unique suffix. The provided 1536 # value has the same validation rules as the Name field, and may be truncated 1537 # by the length of the suffix required to make the value unique on the 1538 # server. 1539 # 1540 # If this field is specified and the generated name exists, the server will 1541 # NOT return a 409 - instead, it will either return 201 Created or 500 with 1542 # Reason ServerTimeout indicating a unique name could not be found in the 1543 # time allotted, and the client should retry (optionally after the time 1544 # indicated in the Retry-After header). 1545 # 1546 # Applied only if Name is not specified. 1547 # More info: 1548 # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency 1549 # +optional 1550 # string generateName = 2; 1551 "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this 1552 # object was created. It is not guaranteed to be set in happens-before order 1553 # across separate operations. Clients may not set this value. It is 1554 # represented in RFC3339 form and is in UTC. 1555 # 1556 # Populated by the system. 1557 # Read-only. 1558 # Null for lists. 1559 # More info: 1560 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 1561 # +optional 1562 "annotations": { # Annotations is an unstructured key value map stored with a resource that 1563 # may be set by external tools to store and retrieve arbitrary metadata. They 1564 # are not queryable and should be preserved when modifying objects. More 1565 # info: http://kubernetes.io/docs/user-guide/annotations +optional 1566 "a_key": "A String", 1567 }, 1568 "selfLink": "A String", # SelfLink is a URL representing this object. 1569 # Populated by the system. 1570 # Read-only. 1571 # +optional 1572 # string selfLink = 4; 1573 "uid": "A String", # UID is the unique in time and space value for this object. It is typically 1574 # generated by the server on successful creation of a resource and is not 1575 # allowed to change on PUT operations. 1576 # 1577 # Populated by the system. 1578 # Read-only. 1579 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 1580 # +optional 1581 }, 1582 } 1583 1584 x__xgafv: string, V1 error format. 1585 Allowed values 1586 1 - v1 error format 1587 2 - v2 error format 1588 1589Returns: 1590 An object of the form: 1591 1592 { 1593 "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of 1594 # date. 1595 # +optional 1596 "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that 1597 # was last processed by the controller. 1598 "conditions": [ # Array of observed TriggerConditions, indicating the current state 1599 # of the Trigger. 1600 { # TriggerCondition contains state information for an Trigger. 1601 "status": "A String", # Status of the condition, one of True, False, Unknown. 1602 "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info 1603 # +optional 1604 "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. 1605 # +optional 1606 "reason": "A String", # One-word CamelCase reason for the condition's current status. 1607 # +optional 1608 "message": "A String", # Human readable message indicating details about the current status. 1609 # +optional 1610 "type": "A String", # Type of Trigger condition. 1611 }, 1612 ], 1613 "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. 1614 }, 1615 "kind": "A String", # The kind of resource, in this case "Trigger". 1616 "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. 1617 "filter": { # Filter is the filter to apply against all events from the Broker. Only 1618 # events that pass this filter will be sent to the Subscriber. If not 1619 # specified, will default to allowing all events. 1620 # 1621 # This must be specified in Cloud Run. 1622 "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud 1623 # event's type and source attributes. Only exact matches will pass the filter. 1624 "source": "A String", 1625 "type": "A String", 1626 }, 1627 }, 1628 "subscriber": { # Subscriber is the addressable that receives events from the Broker that 1629 # pass the Filter. It is required. 1630 # 1631 # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or 1632 # /namespaces/my-project/services/my-service. 1633 "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target 1634 # endpoint, which should implement the Addressable duck type. 1635 # For example, this could be a reference to a Route resource 1636 # or a Knative Service resource. 1637 # referred object. 1638 "kind": "A String", # Kind of the referent. 1639 # More info: 1640 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 1641 # +optional 1642 "uid": "A String", # UID of the referent. 1643 # More info: 1644 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids 1645 # +optional 1646 "namespace": "A String", # Namespace of the referent. 1647 # More info: 1648 # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ 1649 # +optional 1650 "apiVersion": "A String", # API version of the referent. 1651 # +optional 1652 "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this 1653 # string should contain a valid JSON/Go field access statement, such as 1654 # desiredState.manifest.containers[2]. For example, if the object reference 1655 # is to a container within a pod, this would take on a value like: 1656 # "spec.containers{name}" (where "name" refers to the name of the container 1657 # that triggered the event) or if no container name is specified 1658 # "spec.containers[2]" (container with index 2 in this pod). This syntax is 1659 # chosen only to have some well-defined way of referencing a part of an 1660 # object. 1661 "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. 1662 # More info: 1663 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 1664 # +optional 1665 "name": "A String", # Name of the referent. 1666 # More info: 1667 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names 1668 # +optional 1669 }, 1670 "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. 1671 # http://k8s-service for example 1672 # http://myexternalhandler.example.com/foo/bar 1673 }, 1674 "broker": "A String", # Broker is the broker that this trigger receives events from. If not 1675 # specified, will default to 'default'. 1676 # 1677 # Not currently supported by Cloud Run. 1678 }, 1679 "apiVersion": "A String", # The API version for this call such as "v1alpha1". 1680 "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. 1681 # all objects users must create. 1682 "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have 1683 # been deleted, this object will be garbage collected. 1684 # +optional 1685 { # OwnerReference contains enough information to let you identify an owning 1686 # object. Currently, an owning object must be in the same namespace, so there 1687 # is no namespace field. 1688 "kind": "A String", # Kind of the referent. 1689 # More info: 1690 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds 1691 "uid": "A String", # UID of the referent. 1692 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 1693 "apiVersion": "A String", # API version of the referent. 1694 "controller": True or False, # If true, this reference points to the managing controller. 1695 # +optional 1696 "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then 1697 # the owner cannot be deleted from the key-value store until this 1698 # reference is removed. 1699 # Defaults to false. 1700 # To set this field, a user needs "delete" permission of the owner, 1701 # otherwise 422 (Unprocessable Entity) will be returned. 1702 # +optional 1703 "name": "A String", # Name of the referent. 1704 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 1705 }, 1706 ], 1707 "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. 1708 # Is required when creating 1709 # resources, although some resources may allow a client to request the 1710 # generation of an appropriate name automatically. Name is primarily intended 1711 # for creation idempotence and configuration definition. Cannot be updated. 1712 # More info: http://kubernetes.io/docs/user-guide/identifiers#names 1713 # +optional 1714 "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be 1715 # deleted. This field is set by the server when a graceful deletion is 1716 # requested by the user, and is not directly settable by a client. The 1717 # resource is expected to be deleted (no longer visible from resource lists, 1718 # and not reachable by name) after the time in this field, once the 1719 # finalizers list is empty. As long as the finalizers list contains items, 1720 # deletion is blocked. Once the deletionTimestamp is set, this value may not 1721 # be unset or be set further into the future, although it may be shortened or 1722 # the resource may be deleted prior to this time. For example, a user may 1723 # request that a pod is deleted in 30 seconds. The Kubelet will react by 1724 # sending a graceful termination signal to the containers in the pod. After 1725 # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) 1726 # to the container and after cleanup, remove the pod from the API. In the 1727 # presence of network partitions, this object may still exist after this 1728 # timestamp, until an administrator or automated process can determine the 1729 # resource is fully terminated. 1730 # If not set, graceful deletion of the object has not been requested. 1731 # 1732 # Populated by the system when a graceful deletion is requested. 1733 # Read-only. 1734 # More info: 1735 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 1736 # +optional 1737 "clusterName": "A String", # Not currently supported by Cloud Run. 1738 # 1739 # The name of the cluster which the object belongs to. 1740 # This is used to distinguish resources with same name and namespace in 1741 # different clusters. This field is not set anywhere right now and apiserver 1742 # is going to ignore it if set in create or update request. +optional 1743 "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. 1744 # 1745 # Number of seconds allowed for this object to gracefully terminate before 1746 # it will be removed from the system. Only set when deletionTimestamp is also 1747 # set. May only be shortened. Read-only. +optional 1748 "labels": { # Map of string keys and values that can be used to organize and categorize 1749 # (scope and select) objects. May match selectors of replication controllers 1750 # and routes. 1751 # More info: http://kubernetes.io/docs/user-guide/labels 1752 # +optional 1753 "a_key": "A String", 1754 }, 1755 "namespace": "A String", # Namespace defines the space within each name must be unique, within a 1756 # Cloud Run region. In Cloud Run the namespace must be equal to either the 1757 # project ID or project number. 1758 "generation": 42, # A sequence number representing a specific generation of the desired state. 1759 # Populated by the system. Read-only. 1760 # +optional 1761 "finalizers": [ # Not currently supported by Cloud Run. 1762 # 1763 # Must be empty before the object is deleted from the registry. Each entry 1764 # is an identifier for the responsible component that will remove the entry 1765 # from the list. If the deletionTimestamp of the object is non-nil, entries 1766 # in this list can only be removed. 1767 # +optional 1768 # +patchStrategy=merge 1769 "A String", 1770 ], 1771 "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. 1772 # 1773 # An initializer is a controller which enforces some system invariant at 1774 # object creation time. This field is a list of initializers that have not 1775 # yet acted on this object. If nil or empty, this object has been completely 1776 # initialized. Otherwise, the object is considered uninitialized and is 1777 # hidden (in list/watch and get calls) from clients that haven't explicitly 1778 # asked to observe uninitialized objects. 1779 # 1780 # When an object is created, the system will populate this list with the 1781 # current set of initializers. Only privileged users may set or modify this 1782 # list. Once it is empty, it may not be modified further by any user. 1783 "pending": [ # Pending is a list of initializers that must execute in order before this 1784 # object is visible. When the last pending initializer is removed, and no 1785 # failing result is set, the initializers struct will be set to nil and the 1786 # object is considered as initialized and visible to all clients. 1787 # +patchMergeKey=name 1788 # +patchStrategy=merge 1789 { # Initializer is information about an initializer that has not yet completed. 1790 "name": "A String", # name of the process that is responsible for initializing this object. 1791 }, 1792 ], 1793 }, 1794 "resourceVersion": "A String", # An opaque value that represents the internal version of this object that 1795 # can be used by clients to determine when objects have changed. May be used 1796 # for optimistic concurrency, change detection, and the watch operation on a 1797 # resource or set of resources. Clients must treat these values as opaque and 1798 # passed unmodified back to the server. They may only be valid for a 1799 # particular resource or set of resources. 1800 # 1801 # Populated by the system. 1802 # Read-only. 1803 # Value must be treated as opaque by clients and . 1804 # More info: 1805 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency 1806 # +optional 1807 "generateName": "A String", # Not currently supported by Cloud Run. 1808 # 1809 # GenerateName is an optional prefix, used by the server, to generate a 1810 # unique name ONLY IF the Name field has not been provided. If this field is 1811 # used, the name returned to the client will be different than the name 1812 # passed. This value will also be combined with a unique suffix. The provided 1813 # value has the same validation rules as the Name field, and may be truncated 1814 # by the length of the suffix required to make the value unique on the 1815 # server. 1816 # 1817 # If this field is specified and the generated name exists, the server will 1818 # NOT return a 409 - instead, it will either return 201 Created or 500 with 1819 # Reason ServerTimeout indicating a unique name could not be found in the 1820 # time allotted, and the client should retry (optionally after the time 1821 # indicated in the Retry-After header). 1822 # 1823 # Applied only if Name is not specified. 1824 # More info: 1825 # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency 1826 # +optional 1827 # string generateName = 2; 1828 "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this 1829 # object was created. It is not guaranteed to be set in happens-before order 1830 # across separate operations. Clients may not set this value. It is 1831 # represented in RFC3339 form and is in UTC. 1832 # 1833 # Populated by the system. 1834 # Read-only. 1835 # Null for lists. 1836 # More info: 1837 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata 1838 # +optional 1839 "annotations": { # Annotations is an unstructured key value map stored with a resource that 1840 # may be set by external tools to store and retrieve arbitrary metadata. They 1841 # are not queryable and should be preserved when modifying objects. More 1842 # info: http://kubernetes.io/docs/user-guide/annotations +optional 1843 "a_key": "A String", 1844 }, 1845 "selfLink": "A String", # SelfLink is a URL representing this object. 1846 # Populated by the system. 1847 # Read-only. 1848 # +optional 1849 # string selfLink = 4; 1850 "uid": "A String", # UID is the unique in time and space value for this object. It is typically 1851 # generated by the server on successful creation of a resource and is not 1852 # allowed to change on PUT operations. 1853 # 1854 # Populated by the system. 1855 # Read-only. 1856 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids 1857 # +optional 1858 }, 1859 }</pre> 1860</div> 1861 1862</body></html>