| <html><body> |
| <style> |
| |
| body, h1, h2, h3, div, span, p, pre, a { |
| margin: 0; |
| padding: 0; |
| border: 0; |
| font-weight: inherit; |
| font-style: inherit; |
| font-size: 100%; |
| font-family: inherit; |
| vertical-align: baseline; |
| } |
| |
| body { |
| font-size: 13px; |
| padding: 1em; |
| } |
| |
| h1 { |
| font-size: 26px; |
| margin-bottom: 1em; |
| } |
| |
| h2 { |
| font-size: 24px; |
| margin-bottom: 1em; |
| } |
| |
| h3 { |
| font-size: 20px; |
| margin-bottom: 1em; |
| margin-top: 1em; |
| } |
| |
| pre, code { |
| line-height: 1.5; |
| font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| } |
| |
| pre { |
| margin-top: 0.5em; |
| } |
| |
| h1, h2, h3, p { |
| font-family: Arial, sans serif; |
| } |
| |
| h1, h2, h3 { |
| border-bottom: solid #CCC 1px; |
| } |
| |
| .toc_element { |
| margin-top: 0.5em; |
| } |
| |
| .firstline { |
| margin-left: 2 em; |
| } |
| |
| .method { |
| margin-top: 1em; |
| border: solid 1px #CCC; |
| padding: 1em; |
| background: #EEE; |
| } |
| |
| .details { |
| font-weight: bold; |
| font-size: 14px; |
| } |
| |
| </style> |
| |
| <h1><a href="run_v1alpha1.html">Cloud Run API</a> . <a href="run_v1alpha1.projects.html">projects</a> . <a href="run_v1alpha1.projects.locations.html">locations</a> . <a href="run_v1alpha1.projects.locations.triggers.html">triggers</a></h1> |
| <h2>Instance Methods</h2> |
| <p class="toc_element"> |
| <code><a href="#create">create(parent, body, x__xgafv=None)</a></code></p> |
| <p class="firstline">Creates a new trigger.</p> |
| <p class="toc_element"> |
| <code><a href="#delete">delete(name, kind=None, propagationPolicy=None, apiVersion=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Rpc to delete a trigger.</p> |
| <p class="toc_element"> |
| <code><a href="#get">get(name, x__xgafv=None)</a></code></p> |
| <p class="firstline">Rpc to get information about a trigger.</p> |
| <p class="toc_element"> |
| <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> |
| <p class="firstline">Rpc to list triggers.</p> |
| <p class="toc_element"> |
| <code><a href="#replaceTrigger">replaceTrigger(name, body, x__xgafv=None)</a></code></p> |
| <p class="firstline">Rpc to replace a trigger.</p> |
| <h3>Method Details</h3> |
| <div class="method"> |
| <code class="details" id="create">create(parent, body, x__xgafv=None)</code> |
| <pre>Creates a new trigger. |
| |
| Args: |
| parent: string, The project ID or project number in which this trigger should |
| be created. (required) |
| body: object, The request body. (required) |
| The object takes the form of: |
| |
| { |
| "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of |
| # date. |
| # +optional |
| "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that |
| # was last processed by the controller. |
| "conditions": [ # Array of observed TriggerConditions, indicating the current state |
| # of the Trigger. |
| { # TriggerCondition contains state information for an Trigger. |
| "status": "A String", # Status of the condition, one of True, False, Unknown. |
| "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info |
| # +optional |
| "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. |
| # +optional |
| "reason": "A String", # One-word CamelCase reason for the condition's current status. |
| # +optional |
| "message": "A String", # Human readable message indicating details about the current status. |
| # +optional |
| "type": "A String", # Type of Trigger condition. |
| }, |
| ], |
| "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. |
| }, |
| "kind": "A String", # The kind of resource, in this case "Trigger". |
| "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. |
| "filter": { # Filter is the filter to apply against all events from the Broker. Only |
| # events that pass this filter will be sent to the Subscriber. If not |
| # specified, will default to allowing all events. |
| # |
| # This must be specified in Cloud Run. |
| "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud |
| # event's type and source attributes. Only exact matches will pass the filter. |
| "source": "A String", |
| "type": "A String", |
| }, |
| }, |
| "subscriber": { # Subscriber is the addressable that receives events from the Broker that |
| # pass the Filter. It is required. |
| # |
| # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or |
| # /namespaces/my-project/services/my-service. |
| "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target |
| # endpoint, which should implement the Addressable duck type. |
| # For example, this could be a reference to a Route resource |
| # or a Knative Service resource. |
| # referred object. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| # +optional |
| "uid": "A String", # UID of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
| # +optional |
| "namespace": "A String", # Namespace of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
| # +optional |
| "apiVersion": "A String", # API version of the referent. |
| # +optional |
| "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this |
| # string should contain a valid JSON/Go field access statement, such as |
| # desiredState.manifest.containers[2]. For example, if the object reference |
| # is to a container within a pod, this would take on a value like: |
| # "spec.containers{name}" (where "name" refers to the name of the container |
| # that triggered the event) or if no container name is specified |
| # "spec.containers[2]" (container with index 2 in this pod). This syntax is |
| # chosen only to have some well-defined way of referencing a part of an |
| # object. |
| "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
| # +optional |
| }, |
| "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. |
| # http://k8s-service for example |
| # http://myexternalhandler.example.com/foo/bar |
| }, |
| "broker": "A String", # Broker is the broker that this trigger receives events from. If not |
| # specified, will default to 'default'. |
| # |
| # Not currently supported by Cloud Run. |
| }, |
| "apiVersion": "A String", # The API version for this call such as "v1alpha1". |
| "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. |
| # all objects users must create. |
| "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have |
| # been deleted, this object will be garbage collected. |
| # +optional |
| { # OwnerReference contains enough information to let you identify an owning |
| # object. Currently, an owning object must be in the same namespace, so there |
| # is no namespace field. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| "uid": "A String", # UID of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| "apiVersion": "A String", # API version of the referent. |
| "controller": True or False, # If true, this reference points to the managing controller. |
| # +optional |
| "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then |
| # the owner cannot be deleted from the key-value store until this |
| # reference is removed. |
| # Defaults to false. |
| # To set this field, a user needs "delete" permission of the owner, |
| # otherwise 422 (Unprocessable Entity) will be returned. |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| }, |
| ], |
| "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. |
| # Is required when creating |
| # resources, although some resources may allow a client to request the |
| # generation of an appropriate name automatically. Name is primarily intended |
| # for creation idempotence and configuration definition. Cannot be updated. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| # +optional |
| "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be |
| # deleted. This field is set by the server when a graceful deletion is |
| # requested by the user, and is not directly settable by a client. The |
| # resource is expected to be deleted (no longer visible from resource lists, |
| # and not reachable by name) after the time in this field, once the |
| # finalizers list is empty. As long as the finalizers list contains items, |
| # deletion is blocked. Once the deletionTimestamp is set, this value may not |
| # be unset or be set further into the future, although it may be shortened or |
| # the resource may be deleted prior to this time. For example, a user may |
| # request that a pod is deleted in 30 seconds. The Kubelet will react by |
| # sending a graceful termination signal to the containers in the pod. After |
| # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) |
| # to the container and after cleanup, remove the pod from the API. In the |
| # presence of network partitions, this object may still exist after this |
| # timestamp, until an administrator or automated process can determine the |
| # resource is fully terminated. |
| # If not set, graceful deletion of the object has not been requested. |
| # |
| # Populated by the system when a graceful deletion is requested. |
| # Read-only. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "clusterName": "A String", # Not currently supported by Cloud Run. |
| # |
| # The name of the cluster which the object belongs to. |
| # This is used to distinguish resources with same name and namespace in |
| # different clusters. This field is not set anywhere right now and apiserver |
| # is going to ignore it if set in create or update request. +optional |
| "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. |
| # |
| # Number of seconds allowed for this object to gracefully terminate before |
| # it will be removed from the system. Only set when deletionTimestamp is also |
| # set. May only be shortened. Read-only. +optional |
| "labels": { # Map of string keys and values that can be used to organize and categorize |
| # (scope and select) objects. May match selectors of replication controllers |
| # and routes. |
| # More info: http://kubernetes.io/docs/user-guide/labels |
| # +optional |
| "a_key": "A String", |
| }, |
| "namespace": "A String", # Namespace defines the space within each name must be unique, within a |
| # Cloud Run region. In Cloud Run the namespace must be equal to either the |
| # project ID or project number. |
| "generation": 42, # A sequence number representing a specific generation of the desired state. |
| # Populated by the system. Read-only. |
| # +optional |
| "finalizers": [ # Not currently supported by Cloud Run. |
| # |
| # Must be empty before the object is deleted from the registry. Each entry |
| # is an identifier for the responsible component that will remove the entry |
| # from the list. If the deletionTimestamp of the object is non-nil, entries |
| # in this list can only be removed. |
| # +optional |
| # +patchStrategy=merge |
| "A String", |
| ], |
| "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. |
| # |
| # An initializer is a controller which enforces some system invariant at |
| # object creation time. This field is a list of initializers that have not |
| # yet acted on this object. If nil or empty, this object has been completely |
| # initialized. Otherwise, the object is considered uninitialized and is |
| # hidden (in list/watch and get calls) from clients that haven't explicitly |
| # asked to observe uninitialized objects. |
| # |
| # When an object is created, the system will populate this list with the |
| # current set of initializers. Only privileged users may set or modify this |
| # list. Once it is empty, it may not be modified further by any user. |
| "pending": [ # Pending is a list of initializers that must execute in order before this |
| # object is visible. When the last pending initializer is removed, and no |
| # failing result is set, the initializers struct will be set to nil and the |
| # object is considered as initialized and visible to all clients. |
| # +patchMergeKey=name |
| # +patchStrategy=merge |
| { # Initializer is information about an initializer that has not yet completed. |
| "name": "A String", # name of the process that is responsible for initializing this object. |
| }, |
| ], |
| }, |
| "resourceVersion": "A String", # An opaque value that represents the internal version of this object that |
| # can be used by clients to determine when objects have changed. May be used |
| # for optimistic concurrency, change detection, and the watch operation on a |
| # resource or set of resources. Clients must treat these values as opaque and |
| # passed unmodified back to the server. They may only be valid for a |
| # particular resource or set of resources. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Value must be treated as opaque by clients and . |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "generateName": "A String", # Not currently supported by Cloud Run. |
| # |
| # GenerateName is an optional prefix, used by the server, to generate a |
| # unique name ONLY IF the Name field has not been provided. If this field is |
| # used, the name returned to the client will be different than the name |
| # passed. This value will also be combined with a unique suffix. The provided |
| # value has the same validation rules as the Name field, and may be truncated |
| # by the length of the suffix required to make the value unique on the |
| # server. |
| # |
| # If this field is specified and the generated name exists, the server will |
| # NOT return a 409 - instead, it will either return 201 Created or 500 with |
| # Reason ServerTimeout indicating a unique name could not be found in the |
| # time allotted, and the client should retry (optionally after the time |
| # indicated in the Retry-After header). |
| # |
| # Applied only if Name is not specified. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency |
| # +optional |
| # string generateName = 2; |
| "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this |
| # object was created. It is not guaranteed to be set in happens-before order |
| # across separate operations. Clients may not set this value. It is |
| # represented in RFC3339 form and is in UTC. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Null for lists. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "annotations": { # Annotations is an unstructured key value map stored with a resource that |
| # may be set by external tools to store and retrieve arbitrary metadata. They |
| # are not queryable and should be preserved when modifying objects. More |
| # info: http://kubernetes.io/docs/user-guide/annotations +optional |
| "a_key": "A String", |
| }, |
| "selfLink": "A String", # SelfLink is a URL representing this object. |
| # Populated by the system. |
| # Read-only. |
| # +optional |
| # string selfLink = 4; |
| "uid": "A String", # UID is the unique in time and space value for this object. It is typically |
| # generated by the server on successful creation of a resource and is not |
| # allowed to change on PUT operations. |
| # |
| # Populated by the system. |
| # Read-only. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| # +optional |
| }, |
| } |
| |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of |
| # date. |
| # +optional |
| "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that |
| # was last processed by the controller. |
| "conditions": [ # Array of observed TriggerConditions, indicating the current state |
| # of the Trigger. |
| { # TriggerCondition contains state information for an Trigger. |
| "status": "A String", # Status of the condition, one of True, False, Unknown. |
| "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info |
| # +optional |
| "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. |
| # +optional |
| "reason": "A String", # One-word CamelCase reason for the condition's current status. |
| # +optional |
| "message": "A String", # Human readable message indicating details about the current status. |
| # +optional |
| "type": "A String", # Type of Trigger condition. |
| }, |
| ], |
| "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. |
| }, |
| "kind": "A String", # The kind of resource, in this case "Trigger". |
| "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. |
| "filter": { # Filter is the filter to apply against all events from the Broker. Only |
| # events that pass this filter will be sent to the Subscriber. If not |
| # specified, will default to allowing all events. |
| # |
| # This must be specified in Cloud Run. |
| "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud |
| # event's type and source attributes. Only exact matches will pass the filter. |
| "source": "A String", |
| "type": "A String", |
| }, |
| }, |
| "subscriber": { # Subscriber is the addressable that receives events from the Broker that |
| # pass the Filter. It is required. |
| # |
| # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or |
| # /namespaces/my-project/services/my-service. |
| "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target |
| # endpoint, which should implement the Addressable duck type. |
| # For example, this could be a reference to a Route resource |
| # or a Knative Service resource. |
| # referred object. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| # +optional |
| "uid": "A String", # UID of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
| # +optional |
| "namespace": "A String", # Namespace of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
| # +optional |
| "apiVersion": "A String", # API version of the referent. |
| # +optional |
| "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this |
| # string should contain a valid JSON/Go field access statement, such as |
| # desiredState.manifest.containers[2]. For example, if the object reference |
| # is to a container within a pod, this would take on a value like: |
| # "spec.containers{name}" (where "name" refers to the name of the container |
| # that triggered the event) or if no container name is specified |
| # "spec.containers[2]" (container with index 2 in this pod). This syntax is |
| # chosen only to have some well-defined way of referencing a part of an |
| # object. |
| "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
| # +optional |
| }, |
| "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. |
| # http://k8s-service for example |
| # http://myexternalhandler.example.com/foo/bar |
| }, |
| "broker": "A String", # Broker is the broker that this trigger receives events from. If not |
| # specified, will default to 'default'. |
| # |
| # Not currently supported by Cloud Run. |
| }, |
| "apiVersion": "A String", # The API version for this call such as "v1alpha1". |
| "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. |
| # all objects users must create. |
| "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have |
| # been deleted, this object will be garbage collected. |
| # +optional |
| { # OwnerReference contains enough information to let you identify an owning |
| # object. Currently, an owning object must be in the same namespace, so there |
| # is no namespace field. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| "uid": "A String", # UID of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| "apiVersion": "A String", # API version of the referent. |
| "controller": True or False, # If true, this reference points to the managing controller. |
| # +optional |
| "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then |
| # the owner cannot be deleted from the key-value store until this |
| # reference is removed. |
| # Defaults to false. |
| # To set this field, a user needs "delete" permission of the owner, |
| # otherwise 422 (Unprocessable Entity) will be returned. |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| }, |
| ], |
| "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. |
| # Is required when creating |
| # resources, although some resources may allow a client to request the |
| # generation of an appropriate name automatically. Name is primarily intended |
| # for creation idempotence and configuration definition. Cannot be updated. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| # +optional |
| "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be |
| # deleted. This field is set by the server when a graceful deletion is |
| # requested by the user, and is not directly settable by a client. The |
| # resource is expected to be deleted (no longer visible from resource lists, |
| # and not reachable by name) after the time in this field, once the |
| # finalizers list is empty. As long as the finalizers list contains items, |
| # deletion is blocked. Once the deletionTimestamp is set, this value may not |
| # be unset or be set further into the future, although it may be shortened or |
| # the resource may be deleted prior to this time. For example, a user may |
| # request that a pod is deleted in 30 seconds. The Kubelet will react by |
| # sending a graceful termination signal to the containers in the pod. After |
| # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) |
| # to the container and after cleanup, remove the pod from the API. In the |
| # presence of network partitions, this object may still exist after this |
| # timestamp, until an administrator or automated process can determine the |
| # resource is fully terminated. |
| # If not set, graceful deletion of the object has not been requested. |
| # |
| # Populated by the system when a graceful deletion is requested. |
| # Read-only. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "clusterName": "A String", # Not currently supported by Cloud Run. |
| # |
| # The name of the cluster which the object belongs to. |
| # This is used to distinguish resources with same name and namespace in |
| # different clusters. This field is not set anywhere right now and apiserver |
| # is going to ignore it if set in create or update request. +optional |
| "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. |
| # |
| # Number of seconds allowed for this object to gracefully terminate before |
| # it will be removed from the system. Only set when deletionTimestamp is also |
| # set. May only be shortened. Read-only. +optional |
| "labels": { # Map of string keys and values that can be used to organize and categorize |
| # (scope and select) objects. May match selectors of replication controllers |
| # and routes. |
| # More info: http://kubernetes.io/docs/user-guide/labels |
| # +optional |
| "a_key": "A String", |
| }, |
| "namespace": "A String", # Namespace defines the space within each name must be unique, within a |
| # Cloud Run region. In Cloud Run the namespace must be equal to either the |
| # project ID or project number. |
| "generation": 42, # A sequence number representing a specific generation of the desired state. |
| # Populated by the system. Read-only. |
| # +optional |
| "finalizers": [ # Not currently supported by Cloud Run. |
| # |
| # Must be empty before the object is deleted from the registry. Each entry |
| # is an identifier for the responsible component that will remove the entry |
| # from the list. If the deletionTimestamp of the object is non-nil, entries |
| # in this list can only be removed. |
| # +optional |
| # +patchStrategy=merge |
| "A String", |
| ], |
| "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. |
| # |
| # An initializer is a controller which enforces some system invariant at |
| # object creation time. This field is a list of initializers that have not |
| # yet acted on this object. If nil or empty, this object has been completely |
| # initialized. Otherwise, the object is considered uninitialized and is |
| # hidden (in list/watch and get calls) from clients that haven't explicitly |
| # asked to observe uninitialized objects. |
| # |
| # When an object is created, the system will populate this list with the |
| # current set of initializers. Only privileged users may set or modify this |
| # list. Once it is empty, it may not be modified further by any user. |
| "pending": [ # Pending is a list of initializers that must execute in order before this |
| # object is visible. When the last pending initializer is removed, and no |
| # failing result is set, the initializers struct will be set to nil and the |
| # object is considered as initialized and visible to all clients. |
| # +patchMergeKey=name |
| # +patchStrategy=merge |
| { # Initializer is information about an initializer that has not yet completed. |
| "name": "A String", # name of the process that is responsible for initializing this object. |
| }, |
| ], |
| }, |
| "resourceVersion": "A String", # An opaque value that represents the internal version of this object that |
| # can be used by clients to determine when objects have changed. May be used |
| # for optimistic concurrency, change detection, and the watch operation on a |
| # resource or set of resources. Clients must treat these values as opaque and |
| # passed unmodified back to the server. They may only be valid for a |
| # particular resource or set of resources. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Value must be treated as opaque by clients and . |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "generateName": "A String", # Not currently supported by Cloud Run. |
| # |
| # GenerateName is an optional prefix, used by the server, to generate a |
| # unique name ONLY IF the Name field has not been provided. If this field is |
| # used, the name returned to the client will be different than the name |
| # passed. This value will also be combined with a unique suffix. The provided |
| # value has the same validation rules as the Name field, and may be truncated |
| # by the length of the suffix required to make the value unique on the |
| # server. |
| # |
| # If this field is specified and the generated name exists, the server will |
| # NOT return a 409 - instead, it will either return 201 Created or 500 with |
| # Reason ServerTimeout indicating a unique name could not be found in the |
| # time allotted, and the client should retry (optionally after the time |
| # indicated in the Retry-After header). |
| # |
| # Applied only if Name is not specified. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency |
| # +optional |
| # string generateName = 2; |
| "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this |
| # object was created. It is not guaranteed to be set in happens-before order |
| # across separate operations. Clients may not set this value. It is |
| # represented in RFC3339 form and is in UTC. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Null for lists. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "annotations": { # Annotations is an unstructured key value map stored with a resource that |
| # may be set by external tools to store and retrieve arbitrary metadata. They |
| # are not queryable and should be preserved when modifying objects. More |
| # info: http://kubernetes.io/docs/user-guide/annotations +optional |
| "a_key": "A String", |
| }, |
| "selfLink": "A String", # SelfLink is a URL representing this object. |
| # Populated by the system. |
| # Read-only. |
| # +optional |
| # string selfLink = 4; |
| "uid": "A String", # UID is the unique in time and space value for this object. It is typically |
| # generated by the server on successful creation of a resource and is not |
| # allowed to change on PUT operations. |
| # |
| # Populated by the system. |
| # Read-only. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| # +optional |
| }, |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="delete">delete(name, kind=None, propagationPolicy=None, apiVersion=None, x__xgafv=None)</code> |
| <pre>Rpc to delete a trigger. |
| |
| Args: |
| name: string, The name of the trigger being deleted. If needed, replace |
| {namespace_id} with the project ID. (required) |
| kind: string, Cloud Run currently ignores this parameter. |
| propagationPolicy: string, Specifies the propagation policy of delete. Cloud Run currently ignores |
| this setting, and deletes in the background. Please see |
| kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for |
| more information. |
| apiVersion: string, Cloud Run currently ignores this parameter. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # A generic empty message that you can re-use to avoid defining duplicated |
| # empty messages in your APIs. A typical example is to use it as the request |
| # or the response type of an API method. For instance: |
| # |
| # service Foo { |
| # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); |
| # } |
| # |
| # The JSON representation for `Empty` is empty JSON object `{}`. |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="get">get(name, x__xgafv=None)</code> |
| <pre>Rpc to get information about a trigger. |
| |
| Args: |
| name: string, The name of the trigger being retrieved. If needed, replace |
| {namespace_id} with the project ID. (required) |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of |
| # date. |
| # +optional |
| "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that |
| # was last processed by the controller. |
| "conditions": [ # Array of observed TriggerConditions, indicating the current state |
| # of the Trigger. |
| { # TriggerCondition contains state information for an Trigger. |
| "status": "A String", # Status of the condition, one of True, False, Unknown. |
| "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info |
| # +optional |
| "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. |
| # +optional |
| "reason": "A String", # One-word CamelCase reason for the condition's current status. |
| # +optional |
| "message": "A String", # Human readable message indicating details about the current status. |
| # +optional |
| "type": "A String", # Type of Trigger condition. |
| }, |
| ], |
| "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. |
| }, |
| "kind": "A String", # The kind of resource, in this case "Trigger". |
| "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. |
| "filter": { # Filter is the filter to apply against all events from the Broker. Only |
| # events that pass this filter will be sent to the Subscriber. If not |
| # specified, will default to allowing all events. |
| # |
| # This must be specified in Cloud Run. |
| "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud |
| # event's type and source attributes. Only exact matches will pass the filter. |
| "source": "A String", |
| "type": "A String", |
| }, |
| }, |
| "subscriber": { # Subscriber is the addressable that receives events from the Broker that |
| # pass the Filter. It is required. |
| # |
| # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or |
| # /namespaces/my-project/services/my-service. |
| "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target |
| # endpoint, which should implement the Addressable duck type. |
| # For example, this could be a reference to a Route resource |
| # or a Knative Service resource. |
| # referred object. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| # +optional |
| "uid": "A String", # UID of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
| # +optional |
| "namespace": "A String", # Namespace of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
| # +optional |
| "apiVersion": "A String", # API version of the referent. |
| # +optional |
| "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this |
| # string should contain a valid JSON/Go field access statement, such as |
| # desiredState.manifest.containers[2]. For example, if the object reference |
| # is to a container within a pod, this would take on a value like: |
| # "spec.containers{name}" (where "name" refers to the name of the container |
| # that triggered the event) or if no container name is specified |
| # "spec.containers[2]" (container with index 2 in this pod). This syntax is |
| # chosen only to have some well-defined way of referencing a part of an |
| # object. |
| "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
| # +optional |
| }, |
| "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. |
| # http://k8s-service for example |
| # http://myexternalhandler.example.com/foo/bar |
| }, |
| "broker": "A String", # Broker is the broker that this trigger receives events from. If not |
| # specified, will default to 'default'. |
| # |
| # Not currently supported by Cloud Run. |
| }, |
| "apiVersion": "A String", # The API version for this call such as "v1alpha1". |
| "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. |
| # all objects users must create. |
| "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have |
| # been deleted, this object will be garbage collected. |
| # +optional |
| { # OwnerReference contains enough information to let you identify an owning |
| # object. Currently, an owning object must be in the same namespace, so there |
| # is no namespace field. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| "uid": "A String", # UID of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| "apiVersion": "A String", # API version of the referent. |
| "controller": True or False, # If true, this reference points to the managing controller. |
| # +optional |
| "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then |
| # the owner cannot be deleted from the key-value store until this |
| # reference is removed. |
| # Defaults to false. |
| # To set this field, a user needs "delete" permission of the owner, |
| # otherwise 422 (Unprocessable Entity) will be returned. |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| }, |
| ], |
| "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. |
| # Is required when creating |
| # resources, although some resources may allow a client to request the |
| # generation of an appropriate name automatically. Name is primarily intended |
| # for creation idempotence and configuration definition. Cannot be updated. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| # +optional |
| "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be |
| # deleted. This field is set by the server when a graceful deletion is |
| # requested by the user, and is not directly settable by a client. The |
| # resource is expected to be deleted (no longer visible from resource lists, |
| # and not reachable by name) after the time in this field, once the |
| # finalizers list is empty. As long as the finalizers list contains items, |
| # deletion is blocked. Once the deletionTimestamp is set, this value may not |
| # be unset or be set further into the future, although it may be shortened or |
| # the resource may be deleted prior to this time. For example, a user may |
| # request that a pod is deleted in 30 seconds. The Kubelet will react by |
| # sending a graceful termination signal to the containers in the pod. After |
| # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) |
| # to the container and after cleanup, remove the pod from the API. In the |
| # presence of network partitions, this object may still exist after this |
| # timestamp, until an administrator or automated process can determine the |
| # resource is fully terminated. |
| # If not set, graceful deletion of the object has not been requested. |
| # |
| # Populated by the system when a graceful deletion is requested. |
| # Read-only. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "clusterName": "A String", # Not currently supported by Cloud Run. |
| # |
| # The name of the cluster which the object belongs to. |
| # This is used to distinguish resources with same name and namespace in |
| # different clusters. This field is not set anywhere right now and apiserver |
| # is going to ignore it if set in create or update request. +optional |
| "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. |
| # |
| # Number of seconds allowed for this object to gracefully terminate before |
| # it will be removed from the system. Only set when deletionTimestamp is also |
| # set. May only be shortened. Read-only. +optional |
| "labels": { # Map of string keys and values that can be used to organize and categorize |
| # (scope and select) objects. May match selectors of replication controllers |
| # and routes. |
| # More info: http://kubernetes.io/docs/user-guide/labels |
| # +optional |
| "a_key": "A String", |
| }, |
| "namespace": "A String", # Namespace defines the space within each name must be unique, within a |
| # Cloud Run region. In Cloud Run the namespace must be equal to either the |
| # project ID or project number. |
| "generation": 42, # A sequence number representing a specific generation of the desired state. |
| # Populated by the system. Read-only. |
| # +optional |
| "finalizers": [ # Not currently supported by Cloud Run. |
| # |
| # Must be empty before the object is deleted from the registry. Each entry |
| # is an identifier for the responsible component that will remove the entry |
| # from the list. If the deletionTimestamp of the object is non-nil, entries |
| # in this list can only be removed. |
| # +optional |
| # +patchStrategy=merge |
| "A String", |
| ], |
| "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. |
| # |
| # An initializer is a controller which enforces some system invariant at |
| # object creation time. This field is a list of initializers that have not |
| # yet acted on this object. If nil or empty, this object has been completely |
| # initialized. Otherwise, the object is considered uninitialized and is |
| # hidden (in list/watch and get calls) from clients that haven't explicitly |
| # asked to observe uninitialized objects. |
| # |
| # When an object is created, the system will populate this list with the |
| # current set of initializers. Only privileged users may set or modify this |
| # list. Once it is empty, it may not be modified further by any user. |
| "pending": [ # Pending is a list of initializers that must execute in order before this |
| # object is visible. When the last pending initializer is removed, and no |
| # failing result is set, the initializers struct will be set to nil and the |
| # object is considered as initialized and visible to all clients. |
| # +patchMergeKey=name |
| # +patchStrategy=merge |
| { # Initializer is information about an initializer that has not yet completed. |
| "name": "A String", # name of the process that is responsible for initializing this object. |
| }, |
| ], |
| }, |
| "resourceVersion": "A String", # An opaque value that represents the internal version of this object that |
| # can be used by clients to determine when objects have changed. May be used |
| # for optimistic concurrency, change detection, and the watch operation on a |
| # resource or set of resources. Clients must treat these values as opaque and |
| # passed unmodified back to the server. They may only be valid for a |
| # particular resource or set of resources. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Value must be treated as opaque by clients and . |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "generateName": "A String", # Not currently supported by Cloud Run. |
| # |
| # GenerateName is an optional prefix, used by the server, to generate a |
| # unique name ONLY IF the Name field has not been provided. If this field is |
| # used, the name returned to the client will be different than the name |
| # passed. This value will also be combined with a unique suffix. The provided |
| # value has the same validation rules as the Name field, and may be truncated |
| # by the length of the suffix required to make the value unique on the |
| # server. |
| # |
| # If this field is specified and the generated name exists, the server will |
| # NOT return a 409 - instead, it will either return 201 Created or 500 with |
| # Reason ServerTimeout indicating a unique name could not be found in the |
| # time allotted, and the client should retry (optionally after the time |
| # indicated in the Retry-After header). |
| # |
| # Applied only if Name is not specified. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency |
| # +optional |
| # string generateName = 2; |
| "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this |
| # object was created. It is not guaranteed to be set in happens-before order |
| # across separate operations. Clients may not set this value. It is |
| # represented in RFC3339 form and is in UTC. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Null for lists. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "annotations": { # Annotations is an unstructured key value map stored with a resource that |
| # may be set by external tools to store and retrieve arbitrary metadata. They |
| # are not queryable and should be preserved when modifying objects. More |
| # info: http://kubernetes.io/docs/user-guide/annotations +optional |
| "a_key": "A String", |
| }, |
| "selfLink": "A String", # SelfLink is a URL representing this object. |
| # Populated by the system. |
| # Read-only. |
| # +optional |
| # string selfLink = 4; |
| "uid": "A String", # UID is the unique in time and space value for this object. It is typically |
| # generated by the server on successful creation of a resource and is not |
| # allowed to change on PUT operations. |
| # |
| # Populated by the system. |
| # Read-only. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| # +optional |
| }, |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <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> |
| <pre>Rpc to list triggers. |
| |
| Args: |
| parent: string, The project ID or project number from which the triggers should |
| be listed. (required) |
| labelSelector: string, Allows to filter resources based on a label. Supported operations are |
| =, !=, exists, in, and notIn. |
| includeUninitialized: boolean, Not currently used by Cloud Run. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| resourceVersion: string, The baseline resource version from which the list or watch operation should |
| start. Not currently used by Cloud Run. |
| limit: integer, The maximum number of records that should be returned. |
| watch: boolean, Flag that indicates that the client expects to watch this resource as well. |
| Not currently used by Cloud Run. |
| continue: string, Optional encoded string to continue paging. |
| fieldSelector: string, Allows to filter resources based on a specific value for a field name. |
| Send this in a query string format. i.e. 'metadata.name%3Dlorem'. |
| Not currently used by Cloud Run. |
| |
| Returns: |
| An object of the form: |
| |
| { # ListTriggersResponse is a list of Trigger resources. |
| "unreachable": [ # Locations that could not be reached. |
| "A String", |
| ], |
| "kind": "A String", # The kind of this resource, in this case "TriggerList". |
| "items": [ # List of Triggers. |
| { |
| "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of |
| # date. |
| # +optional |
| "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that |
| # was last processed by the controller. |
| "conditions": [ # Array of observed TriggerConditions, indicating the current state |
| # of the Trigger. |
| { # TriggerCondition contains state information for an Trigger. |
| "status": "A String", # Status of the condition, one of True, False, Unknown. |
| "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info |
| # +optional |
| "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. |
| # +optional |
| "reason": "A String", # One-word CamelCase reason for the condition's current status. |
| # +optional |
| "message": "A String", # Human readable message indicating details about the current status. |
| # +optional |
| "type": "A String", # Type of Trigger condition. |
| }, |
| ], |
| "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. |
| }, |
| "kind": "A String", # The kind of resource, in this case "Trigger". |
| "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. |
| "filter": { # Filter is the filter to apply against all events from the Broker. Only |
| # events that pass this filter will be sent to the Subscriber. If not |
| # specified, will default to allowing all events. |
| # |
| # This must be specified in Cloud Run. |
| "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud |
| # event's type and source attributes. Only exact matches will pass the filter. |
| "source": "A String", |
| "type": "A String", |
| }, |
| }, |
| "subscriber": { # Subscriber is the addressable that receives events from the Broker that |
| # pass the Filter. It is required. |
| # |
| # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or |
| # /namespaces/my-project/services/my-service. |
| "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target |
| # endpoint, which should implement the Addressable duck type. |
| # For example, this could be a reference to a Route resource |
| # or a Knative Service resource. |
| # referred object. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| # +optional |
| "uid": "A String", # UID of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
| # +optional |
| "namespace": "A String", # Namespace of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
| # +optional |
| "apiVersion": "A String", # API version of the referent. |
| # +optional |
| "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this |
| # string should contain a valid JSON/Go field access statement, such as |
| # desiredState.manifest.containers[2]. For example, if the object reference |
| # is to a container within a pod, this would take on a value like: |
| # "spec.containers{name}" (where "name" refers to the name of the container |
| # that triggered the event) or if no container name is specified |
| # "spec.containers[2]" (container with index 2 in this pod). This syntax is |
| # chosen only to have some well-defined way of referencing a part of an |
| # object. |
| "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
| # +optional |
| }, |
| "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. |
| # http://k8s-service for example |
| # http://myexternalhandler.example.com/foo/bar |
| }, |
| "broker": "A String", # Broker is the broker that this trigger receives events from. If not |
| # specified, will default to 'default'. |
| # |
| # Not currently supported by Cloud Run. |
| }, |
| "apiVersion": "A String", # The API version for this call such as "v1alpha1". |
| "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. |
| # all objects users must create. |
| "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have |
| # been deleted, this object will be garbage collected. |
| # +optional |
| { # OwnerReference contains enough information to let you identify an owning |
| # object. Currently, an owning object must be in the same namespace, so there |
| # is no namespace field. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| "uid": "A String", # UID of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| "apiVersion": "A String", # API version of the referent. |
| "controller": True or False, # If true, this reference points to the managing controller. |
| # +optional |
| "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then |
| # the owner cannot be deleted from the key-value store until this |
| # reference is removed. |
| # Defaults to false. |
| # To set this field, a user needs "delete" permission of the owner, |
| # otherwise 422 (Unprocessable Entity) will be returned. |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| }, |
| ], |
| "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. |
| # Is required when creating |
| # resources, although some resources may allow a client to request the |
| # generation of an appropriate name automatically. Name is primarily intended |
| # for creation idempotence and configuration definition. Cannot be updated. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| # +optional |
| "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be |
| # deleted. This field is set by the server when a graceful deletion is |
| # requested by the user, and is not directly settable by a client. The |
| # resource is expected to be deleted (no longer visible from resource lists, |
| # and not reachable by name) after the time in this field, once the |
| # finalizers list is empty. As long as the finalizers list contains items, |
| # deletion is blocked. Once the deletionTimestamp is set, this value may not |
| # be unset or be set further into the future, although it may be shortened or |
| # the resource may be deleted prior to this time. For example, a user may |
| # request that a pod is deleted in 30 seconds. The Kubelet will react by |
| # sending a graceful termination signal to the containers in the pod. After |
| # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) |
| # to the container and after cleanup, remove the pod from the API. In the |
| # presence of network partitions, this object may still exist after this |
| # timestamp, until an administrator or automated process can determine the |
| # resource is fully terminated. |
| # If not set, graceful deletion of the object has not been requested. |
| # |
| # Populated by the system when a graceful deletion is requested. |
| # Read-only. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "clusterName": "A String", # Not currently supported by Cloud Run. |
| # |
| # The name of the cluster which the object belongs to. |
| # This is used to distinguish resources with same name and namespace in |
| # different clusters. This field is not set anywhere right now and apiserver |
| # is going to ignore it if set in create or update request. +optional |
| "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. |
| # |
| # Number of seconds allowed for this object to gracefully terminate before |
| # it will be removed from the system. Only set when deletionTimestamp is also |
| # set. May only be shortened. Read-only. +optional |
| "labels": { # Map of string keys and values that can be used to organize and categorize |
| # (scope and select) objects. May match selectors of replication controllers |
| # and routes. |
| # More info: http://kubernetes.io/docs/user-guide/labels |
| # +optional |
| "a_key": "A String", |
| }, |
| "namespace": "A String", # Namespace defines the space within each name must be unique, within a |
| # Cloud Run region. In Cloud Run the namespace must be equal to either the |
| # project ID or project number. |
| "generation": 42, # A sequence number representing a specific generation of the desired state. |
| # Populated by the system. Read-only. |
| # +optional |
| "finalizers": [ # Not currently supported by Cloud Run. |
| # |
| # Must be empty before the object is deleted from the registry. Each entry |
| # is an identifier for the responsible component that will remove the entry |
| # from the list. If the deletionTimestamp of the object is non-nil, entries |
| # in this list can only be removed. |
| # +optional |
| # +patchStrategy=merge |
| "A String", |
| ], |
| "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. |
| # |
| # An initializer is a controller which enforces some system invariant at |
| # object creation time. This field is a list of initializers that have not |
| # yet acted on this object. If nil or empty, this object has been completely |
| # initialized. Otherwise, the object is considered uninitialized and is |
| # hidden (in list/watch and get calls) from clients that haven't explicitly |
| # asked to observe uninitialized objects. |
| # |
| # When an object is created, the system will populate this list with the |
| # current set of initializers. Only privileged users may set or modify this |
| # list. Once it is empty, it may not be modified further by any user. |
| "pending": [ # Pending is a list of initializers that must execute in order before this |
| # object is visible. When the last pending initializer is removed, and no |
| # failing result is set, the initializers struct will be set to nil and the |
| # object is considered as initialized and visible to all clients. |
| # +patchMergeKey=name |
| # +patchStrategy=merge |
| { # Initializer is information about an initializer that has not yet completed. |
| "name": "A String", # name of the process that is responsible for initializing this object. |
| }, |
| ], |
| }, |
| "resourceVersion": "A String", # An opaque value that represents the internal version of this object that |
| # can be used by clients to determine when objects have changed. May be used |
| # for optimistic concurrency, change detection, and the watch operation on a |
| # resource or set of resources. Clients must treat these values as opaque and |
| # passed unmodified back to the server. They may only be valid for a |
| # particular resource or set of resources. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Value must be treated as opaque by clients and . |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "generateName": "A String", # Not currently supported by Cloud Run. |
| # |
| # GenerateName is an optional prefix, used by the server, to generate a |
| # unique name ONLY IF the Name field has not been provided. If this field is |
| # used, the name returned to the client will be different than the name |
| # passed. This value will also be combined with a unique suffix. The provided |
| # value has the same validation rules as the Name field, and may be truncated |
| # by the length of the suffix required to make the value unique on the |
| # server. |
| # |
| # If this field is specified and the generated name exists, the server will |
| # NOT return a 409 - instead, it will either return 201 Created or 500 with |
| # Reason ServerTimeout indicating a unique name could not be found in the |
| # time allotted, and the client should retry (optionally after the time |
| # indicated in the Retry-After header). |
| # |
| # Applied only if Name is not specified. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency |
| # +optional |
| # string generateName = 2; |
| "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this |
| # object was created. It is not guaranteed to be set in happens-before order |
| # across separate operations. Clients may not set this value. It is |
| # represented in RFC3339 form and is in UTC. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Null for lists. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "annotations": { # Annotations is an unstructured key value map stored with a resource that |
| # may be set by external tools to store and retrieve arbitrary metadata. They |
| # are not queryable and should be preserved when modifying objects. More |
| # info: http://kubernetes.io/docs/user-guide/annotations +optional |
| "a_key": "A String", |
| }, |
| "selfLink": "A String", # SelfLink is a URL representing this object. |
| # Populated by the system. |
| # Read-only. |
| # +optional |
| # string selfLink = 4; |
| "uid": "A String", # UID is the unique in time and space value for this object. It is typically |
| # generated by the server on successful creation of a resource and is not |
| # allowed to change on PUT operations. |
| # |
| # Populated by the system. |
| # Read-only. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| # +optional |
| }, |
| }, |
| ], |
| "apiVersion": "A String", # The API version for this call such as "v1alpha1". |
| "metadata": { # ListMeta describes metadata that synthetic resources must have, including # Metadata associated with this Trigger list. |
| # lists and various status objects. A resource may have only one of |
| # {ObjectMeta, ListMeta}. |
| "continue": "A String", # continue may be set if the user set a limit on the number of items |
| # returned, and indicates that the server has more data available. The value |
| # is opaque and may be used to issue another request to the endpoint that |
| # served this list to retrieve the next set of available objects. Continuing |
| # a list may not be possible if the server configuration has changed or more |
| # than a few minutes have passed. The resourceVersion field returned when |
| # using this continue value will be identical to the value in the first |
| # response. |
| "selfLink": "A String", # SelfLink is a URL representing this object. |
| # Populated by the system. |
| # Read-only. |
| # +optional |
| "resourceVersion": "A String", # String that identifies the server's internal version of this object that |
| # can be used by clients to determine when objects have changed. Value must |
| # be treated as opaque by clients and passed unmodified back to the server. |
| # Populated by the system. |
| # Read-only. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| }, |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="replaceTrigger">replaceTrigger(name, body, x__xgafv=None)</code> |
| <pre>Rpc to replace a trigger. |
| |
| Only the spec and metadata labels and annotations are modifiable. After |
| the Update request, Cloud Run will work to make the 'status' |
| match the requested 'spec'. |
| |
| May provide metadata.resourceVersion to enforce update from last read for |
| optimistic concurrency control. |
| |
| Args: |
| name: string, The name of the trigger being retrieved. If needed, replace |
| {namespace_id} with the project ID. (required) |
| body: object, The request body. (required) |
| The object takes the form of: |
| |
| { |
| "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of |
| # date. |
| # +optional |
| "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that |
| # was last processed by the controller. |
| "conditions": [ # Array of observed TriggerConditions, indicating the current state |
| # of the Trigger. |
| { # TriggerCondition contains state information for an Trigger. |
| "status": "A String", # Status of the condition, one of True, False, Unknown. |
| "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info |
| # +optional |
| "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. |
| # +optional |
| "reason": "A String", # One-word CamelCase reason for the condition's current status. |
| # +optional |
| "message": "A String", # Human readable message indicating details about the current status. |
| # +optional |
| "type": "A String", # Type of Trigger condition. |
| }, |
| ], |
| "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. |
| }, |
| "kind": "A String", # The kind of resource, in this case "Trigger". |
| "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. |
| "filter": { # Filter is the filter to apply against all events from the Broker. Only |
| # events that pass this filter will be sent to the Subscriber. If not |
| # specified, will default to allowing all events. |
| # |
| # This must be specified in Cloud Run. |
| "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud |
| # event's type and source attributes. Only exact matches will pass the filter. |
| "source": "A String", |
| "type": "A String", |
| }, |
| }, |
| "subscriber": { # Subscriber is the addressable that receives events from the Broker that |
| # pass the Filter. It is required. |
| # |
| # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or |
| # /namespaces/my-project/services/my-service. |
| "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target |
| # endpoint, which should implement the Addressable duck type. |
| # For example, this could be a reference to a Route resource |
| # or a Knative Service resource. |
| # referred object. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| # +optional |
| "uid": "A String", # UID of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
| # +optional |
| "namespace": "A String", # Namespace of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
| # +optional |
| "apiVersion": "A String", # API version of the referent. |
| # +optional |
| "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this |
| # string should contain a valid JSON/Go field access statement, such as |
| # desiredState.manifest.containers[2]. For example, if the object reference |
| # is to a container within a pod, this would take on a value like: |
| # "spec.containers{name}" (where "name" refers to the name of the container |
| # that triggered the event) or if no container name is specified |
| # "spec.containers[2]" (container with index 2 in this pod). This syntax is |
| # chosen only to have some well-defined way of referencing a part of an |
| # object. |
| "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
| # +optional |
| }, |
| "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. |
| # http://k8s-service for example |
| # http://myexternalhandler.example.com/foo/bar |
| }, |
| "broker": "A String", # Broker is the broker that this trigger receives events from. If not |
| # specified, will default to 'default'. |
| # |
| # Not currently supported by Cloud Run. |
| }, |
| "apiVersion": "A String", # The API version for this call such as "v1alpha1". |
| "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. |
| # all objects users must create. |
| "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have |
| # been deleted, this object will be garbage collected. |
| # +optional |
| { # OwnerReference contains enough information to let you identify an owning |
| # object. Currently, an owning object must be in the same namespace, so there |
| # is no namespace field. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| "uid": "A String", # UID of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| "apiVersion": "A String", # API version of the referent. |
| "controller": True or False, # If true, this reference points to the managing controller. |
| # +optional |
| "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then |
| # the owner cannot be deleted from the key-value store until this |
| # reference is removed. |
| # Defaults to false. |
| # To set this field, a user needs "delete" permission of the owner, |
| # otherwise 422 (Unprocessable Entity) will be returned. |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| }, |
| ], |
| "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. |
| # Is required when creating |
| # resources, although some resources may allow a client to request the |
| # generation of an appropriate name automatically. Name is primarily intended |
| # for creation idempotence and configuration definition. Cannot be updated. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| # +optional |
| "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be |
| # deleted. This field is set by the server when a graceful deletion is |
| # requested by the user, and is not directly settable by a client. The |
| # resource is expected to be deleted (no longer visible from resource lists, |
| # and not reachable by name) after the time in this field, once the |
| # finalizers list is empty. As long as the finalizers list contains items, |
| # deletion is blocked. Once the deletionTimestamp is set, this value may not |
| # be unset or be set further into the future, although it may be shortened or |
| # the resource may be deleted prior to this time. For example, a user may |
| # request that a pod is deleted in 30 seconds. The Kubelet will react by |
| # sending a graceful termination signal to the containers in the pod. After |
| # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) |
| # to the container and after cleanup, remove the pod from the API. In the |
| # presence of network partitions, this object may still exist after this |
| # timestamp, until an administrator or automated process can determine the |
| # resource is fully terminated. |
| # If not set, graceful deletion of the object has not been requested. |
| # |
| # Populated by the system when a graceful deletion is requested. |
| # Read-only. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "clusterName": "A String", # Not currently supported by Cloud Run. |
| # |
| # The name of the cluster which the object belongs to. |
| # This is used to distinguish resources with same name and namespace in |
| # different clusters. This field is not set anywhere right now and apiserver |
| # is going to ignore it if set in create or update request. +optional |
| "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. |
| # |
| # Number of seconds allowed for this object to gracefully terminate before |
| # it will be removed from the system. Only set when deletionTimestamp is also |
| # set. May only be shortened. Read-only. +optional |
| "labels": { # Map of string keys and values that can be used to organize and categorize |
| # (scope and select) objects. May match selectors of replication controllers |
| # and routes. |
| # More info: http://kubernetes.io/docs/user-guide/labels |
| # +optional |
| "a_key": "A String", |
| }, |
| "namespace": "A String", # Namespace defines the space within each name must be unique, within a |
| # Cloud Run region. In Cloud Run the namespace must be equal to either the |
| # project ID or project number. |
| "generation": 42, # A sequence number representing a specific generation of the desired state. |
| # Populated by the system. Read-only. |
| # +optional |
| "finalizers": [ # Not currently supported by Cloud Run. |
| # |
| # Must be empty before the object is deleted from the registry. Each entry |
| # is an identifier for the responsible component that will remove the entry |
| # from the list. If the deletionTimestamp of the object is non-nil, entries |
| # in this list can only be removed. |
| # +optional |
| # +patchStrategy=merge |
| "A String", |
| ], |
| "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. |
| # |
| # An initializer is a controller which enforces some system invariant at |
| # object creation time. This field is a list of initializers that have not |
| # yet acted on this object. If nil or empty, this object has been completely |
| # initialized. Otherwise, the object is considered uninitialized and is |
| # hidden (in list/watch and get calls) from clients that haven't explicitly |
| # asked to observe uninitialized objects. |
| # |
| # When an object is created, the system will populate this list with the |
| # current set of initializers. Only privileged users may set or modify this |
| # list. Once it is empty, it may not be modified further by any user. |
| "pending": [ # Pending is a list of initializers that must execute in order before this |
| # object is visible. When the last pending initializer is removed, and no |
| # failing result is set, the initializers struct will be set to nil and the |
| # object is considered as initialized and visible to all clients. |
| # +patchMergeKey=name |
| # +patchStrategy=merge |
| { # Initializer is information about an initializer that has not yet completed. |
| "name": "A String", # name of the process that is responsible for initializing this object. |
| }, |
| ], |
| }, |
| "resourceVersion": "A String", # An opaque value that represents the internal version of this object that |
| # can be used by clients to determine when objects have changed. May be used |
| # for optimistic concurrency, change detection, and the watch operation on a |
| # resource or set of resources. Clients must treat these values as opaque and |
| # passed unmodified back to the server. They may only be valid for a |
| # particular resource or set of resources. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Value must be treated as opaque by clients and . |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "generateName": "A String", # Not currently supported by Cloud Run. |
| # |
| # GenerateName is an optional prefix, used by the server, to generate a |
| # unique name ONLY IF the Name field has not been provided. If this field is |
| # used, the name returned to the client will be different than the name |
| # passed. This value will also be combined with a unique suffix. The provided |
| # value has the same validation rules as the Name field, and may be truncated |
| # by the length of the suffix required to make the value unique on the |
| # server. |
| # |
| # If this field is specified and the generated name exists, the server will |
| # NOT return a 409 - instead, it will either return 201 Created or 500 with |
| # Reason ServerTimeout indicating a unique name could not be found in the |
| # time allotted, and the client should retry (optionally after the time |
| # indicated in the Retry-After header). |
| # |
| # Applied only if Name is not specified. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency |
| # +optional |
| # string generateName = 2; |
| "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this |
| # object was created. It is not guaranteed to be set in happens-before order |
| # across separate operations. Clients may not set this value. It is |
| # represented in RFC3339 form and is in UTC. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Null for lists. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "annotations": { # Annotations is an unstructured key value map stored with a resource that |
| # may be set by external tools to store and retrieve arbitrary metadata. They |
| # are not queryable and should be preserved when modifying objects. More |
| # info: http://kubernetes.io/docs/user-guide/annotations +optional |
| "a_key": "A String", |
| }, |
| "selfLink": "A String", # SelfLink is a URL representing this object. |
| # Populated by the system. |
| # Read-only. |
| # +optional |
| # string selfLink = 4; |
| "uid": "A String", # UID is the unique in time and space value for this object. It is typically |
| # generated by the server on successful creation of a resource and is not |
| # allowed to change on PUT operations. |
| # |
| # Populated by the system. |
| # Read-only. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| # +optional |
| }, |
| } |
| |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of |
| # date. |
| # +optional |
| "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that |
| # was last processed by the controller. |
| "conditions": [ # Array of observed TriggerConditions, indicating the current state |
| # of the Trigger. |
| { # TriggerCondition contains state information for an Trigger. |
| "status": "A String", # Status of the condition, one of True, False, Unknown. |
| "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info |
| # +optional |
| "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another. |
| # +optional |
| "reason": "A String", # One-word CamelCase reason for the condition's current status. |
| # +optional |
| "message": "A String", # Human readable message indicating details about the current status. |
| # +optional |
| "type": "A String", # Type of Trigger condition. |
| }, |
| ], |
| "subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger. |
| }, |
| "kind": "A String", # The kind of resource, in this case "Trigger". |
| "spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger. |
| "filter": { # Filter is the filter to apply against all events from the Broker. Only |
| # events that pass this filter will be sent to the Subscriber. If not |
| # specified, will default to allowing all events. |
| # |
| # This must be specified in Cloud Run. |
| "sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud |
| # event's type and source attributes. Only exact matches will pass the filter. |
| "source": "A String", |
| "type": "A String", |
| }, |
| }, |
| "subscriber": { # Subscriber is the addressable that receives events from the Broker that |
| # pass the Filter. It is required. |
| # |
| # E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or |
| # /namespaces/my-project/services/my-service. |
| "ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target |
| # endpoint, which should implement the Addressable duck type. |
| # For example, this could be a reference to a Route resource |
| # or a Knative Service resource. |
| # referred object. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| # +optional |
| "uid": "A String", # UID of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
| # +optional |
| "namespace": "A String", # Namespace of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
| # +optional |
| "apiVersion": "A String", # API version of the referent. |
| # +optional |
| "fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this |
| # string should contain a valid JSON/Go field access statement, such as |
| # desiredState.manifest.containers[2]. For example, if the object reference |
| # is to a container within a pod, this would take on a value like: |
| # "spec.containers{name}" (where "name" refers to the name of the container |
| # that triggered the event) or if no container name is specified |
| # "spec.containers[2]" (container with index 2 in this pod). This syntax is |
| # chosen only to have some well-defined way of referencing a part of an |
| # object. |
| "resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: |
| # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
| # +optional |
| }, |
| "uri": "A String", # Reference to a 'known' endpoint where no resolving is done. |
| # http://k8s-service for example |
| # http://myexternalhandler.example.com/foo/bar |
| }, |
| "broker": "A String", # Broker is the broker that this trigger receives events from. If not |
| # specified, will default to 'default'. |
| # |
| # Not currently supported by Cloud Run. |
| }, |
| "apiVersion": "A String", # The API version for this call such as "v1alpha1". |
| "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger. |
| # all objects users must create. |
| "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have |
| # been deleted, this object will be garbage collected. |
| # +optional |
| { # OwnerReference contains enough information to let you identify an owning |
| # object. Currently, an owning object must be in the same namespace, so there |
| # is no namespace field. |
| "kind": "A String", # Kind of the referent. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds |
| "uid": "A String", # UID of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| "apiVersion": "A String", # API version of the referent. |
| "controller": True or False, # If true, this reference points to the managing controller. |
| # +optional |
| "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then |
| # the owner cannot be deleted from the key-value store until this |
| # reference is removed. |
| # Defaults to false. |
| # To set this field, a user needs "delete" permission of the owner, |
| # otherwise 422 (Unprocessable Entity) will be returned. |
| # +optional |
| "name": "A String", # Name of the referent. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| }, |
| ], |
| "name": "A String", # Name must be unique within a namespace, within a Cloud Run region. |
| # Is required when creating |
| # resources, although some resources may allow a client to request the |
| # generation of an appropriate name automatically. Name is primarily intended |
| # for creation idempotence and configuration definition. Cannot be updated. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#names |
| # +optional |
| "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be |
| # deleted. This field is set by the server when a graceful deletion is |
| # requested by the user, and is not directly settable by a client. The |
| # resource is expected to be deleted (no longer visible from resource lists, |
| # and not reachable by name) after the time in this field, once the |
| # finalizers list is empty. As long as the finalizers list contains items, |
| # deletion is blocked. Once the deletionTimestamp is set, this value may not |
| # be unset or be set further into the future, although it may be shortened or |
| # the resource may be deleted prior to this time. For example, a user may |
| # request that a pod is deleted in 30 seconds. The Kubelet will react by |
| # sending a graceful termination signal to the containers in the pod. After |
| # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) |
| # to the container and after cleanup, remove the pod from the API. In the |
| # presence of network partitions, this object may still exist after this |
| # timestamp, until an administrator or automated process can determine the |
| # resource is fully terminated. |
| # If not set, graceful deletion of the object has not been requested. |
| # |
| # Populated by the system when a graceful deletion is requested. |
| # Read-only. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "clusterName": "A String", # Not currently supported by Cloud Run. |
| # |
| # The name of the cluster which the object belongs to. |
| # This is used to distinguish resources with same name and namespace in |
| # different clusters. This field is not set anywhere right now and apiserver |
| # is going to ignore it if set in create or update request. +optional |
| "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run. |
| # |
| # Number of seconds allowed for this object to gracefully terminate before |
| # it will be removed from the system. Only set when deletionTimestamp is also |
| # set. May only be shortened. Read-only. +optional |
| "labels": { # Map of string keys and values that can be used to organize and categorize |
| # (scope and select) objects. May match selectors of replication controllers |
| # and routes. |
| # More info: http://kubernetes.io/docs/user-guide/labels |
| # +optional |
| "a_key": "A String", |
| }, |
| "namespace": "A String", # Namespace defines the space within each name must be unique, within a |
| # Cloud Run region. In Cloud Run the namespace must be equal to either the |
| # project ID or project number. |
| "generation": 42, # A sequence number representing a specific generation of the desired state. |
| # Populated by the system. Read-only. |
| # +optional |
| "finalizers": [ # Not currently supported by Cloud Run. |
| # |
| # Must be empty before the object is deleted from the registry. Each entry |
| # is an identifier for the responsible component that will remove the entry |
| # from the list. If the deletionTimestamp of the object is non-nil, entries |
| # in this list can only be removed. |
| # +optional |
| # +patchStrategy=merge |
| "A String", |
| ], |
| "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run. |
| # |
| # An initializer is a controller which enforces some system invariant at |
| # object creation time. This field is a list of initializers that have not |
| # yet acted on this object. If nil or empty, this object has been completely |
| # initialized. Otherwise, the object is considered uninitialized and is |
| # hidden (in list/watch and get calls) from clients that haven't explicitly |
| # asked to observe uninitialized objects. |
| # |
| # When an object is created, the system will populate this list with the |
| # current set of initializers. Only privileged users may set or modify this |
| # list. Once it is empty, it may not be modified further by any user. |
| "pending": [ # Pending is a list of initializers that must execute in order before this |
| # object is visible. When the last pending initializer is removed, and no |
| # failing result is set, the initializers struct will be set to nil and the |
| # object is considered as initialized and visible to all clients. |
| # +patchMergeKey=name |
| # +patchStrategy=merge |
| { # Initializer is information about an initializer that has not yet completed. |
| "name": "A String", # name of the process that is responsible for initializing this object. |
| }, |
| ], |
| }, |
| "resourceVersion": "A String", # An opaque value that represents the internal version of this object that |
| # can be used by clients to determine when objects have changed. May be used |
| # for optimistic concurrency, change detection, and the watch operation on a |
| # resource or set of resources. Clients must treat these values as opaque and |
| # passed unmodified back to the server. They may only be valid for a |
| # particular resource or set of resources. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Value must be treated as opaque by clients and . |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency |
| # +optional |
| "generateName": "A String", # Not currently supported by Cloud Run. |
| # |
| # GenerateName is an optional prefix, used by the server, to generate a |
| # unique name ONLY IF the Name field has not been provided. If this field is |
| # used, the name returned to the client will be different than the name |
| # passed. This value will also be combined with a unique suffix. The provided |
| # value has the same validation rules as the Name field, and may be truncated |
| # by the length of the suffix required to make the value unique on the |
| # server. |
| # |
| # If this field is specified and the generated name exists, the server will |
| # NOT return a 409 - instead, it will either return 201 Created or 500 with |
| # Reason ServerTimeout indicating a unique name could not be found in the |
| # time allotted, and the client should retry (optionally after the time |
| # indicated in the Retry-After header). |
| # |
| # Applied only if Name is not specified. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency |
| # +optional |
| # string generateName = 2; |
| "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this |
| # object was created. It is not guaranteed to be set in happens-before order |
| # across separate operations. Clients may not set this value. It is |
| # represented in RFC3339 form and is in UTC. |
| # |
| # Populated by the system. |
| # Read-only. |
| # Null for lists. |
| # More info: |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata |
| # +optional |
| "annotations": { # Annotations is an unstructured key value map stored with a resource that |
| # may be set by external tools to store and retrieve arbitrary metadata. They |
| # are not queryable and should be preserved when modifying objects. More |
| # info: http://kubernetes.io/docs/user-guide/annotations +optional |
| "a_key": "A String", |
| }, |
| "selfLink": "A String", # SelfLink is a URL representing this object. |
| # Populated by the system. |
| # Read-only. |
| # +optional |
| # string selfLink = 4; |
| "uid": "A String", # UID is the unique in time and space value for this object. It is typically |
| # generated by the server on successful creation of a resource and is not |
| # allowed to change on PUT operations. |
| # |
| # Populated by the system. |
| # Read-only. |
| # More info: http://kubernetes.io/docs/user-guide/identifiers#uids |
| # +optional |
| }, |
| }</pre> |
| </div> |
| |
| </body></html> |