chore: regens API reference docs (#889)
diff --git a/docs/dyn/run_v1alpha1.projects.locations.triggers.html b/docs/dyn/run_v1alpha1.projects.locations.triggers.html
index 056b1f7..64cc709 100644
--- a/docs/dyn/run_v1alpha1.projects.locations.triggers.html
+++ b/docs/dyn/run_v1alpha1.projects.locations.triggers.html
@@ -75,7 +75,7 @@
<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>
+ <code><a href="#create">create(parent, body=None, 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>
@@ -86,38 +86,30 @@
<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>
+ <code class="details" id="create">create(parent, body=None, 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)
+ body: object, The request body.
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
+ "status": { # TriggerStatus represents the current state of a Trigger. # Optional. 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
+ "severity": "A String", # Optional. How to interpret failures of this condition, one of Error, Warning, Info
+ "lastTransitionTime": "A String", # Optional. Last time the condition transitioned from one status to another.
+ "reason": "A String", # Optional. One-word CamelCase reason for the condition's current status.
+ "message": "A String", # Optional. Human readable message indicating details about the current status.
"type": "A String", # Type of Trigger condition.
},
],
@@ -125,26 +117,25 @@
},
"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",
+ "filter": { # Optional. Filter is the filter to apply against all events from the Broker. Only
+ # events that pass this filter will be sent to the Subscriber.
+ # Note that filter is optional in knative and is only required in fully
+ # managed due to different broker implementation.
+ "attributes": { # Optional. Attributes filters events by exact match on event context attributes.
+ # Each key in the map is compared with the equivalent key in the event
+ # context. An event passes the filter if all values are equal to the
+ # specified values.
+ #
+ # Nested context attributes are not supported as keys.
+ # Only string values are supported.
+ # Note that this field is optional in knative. In fully managed, 'type'
+ # attribute is required due to different broker implementation.
+ "a_key": "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.
+ "subscriber": { # Sink is the addressable that will receive events.
+ "ref": { # ObjectReference contains enough information to let you inspect or modify the # ObjectReference points to an Addressable.
+ # + optional
# referred object.
"kind": "A String", # Kind of the referent.
# More info:
@@ -178,16 +169,17 @@
# 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
+ "uri": "A String", # URI is for direct URI Designations or used with the resulting URL from
+ # Addressable ObjectReference. If used with an ObjectReference, will be
+ # appended to the path of the resulting URL from the Addressable.
+ # + optional
},
"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".
+ "apiVersion": "A String", # The API version for this call such as "eventing.knative.dev/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
@@ -199,8 +191,8 @@
"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
+ "name": "A String", # Name of the referent.
+ # More info: http://kubernetes.io/docs/user-guide/identifiers#names
"apiVersion": "A String", # API version of the referent.
"controller": True or False, # If true, this reference points to the managing controller.
# +optional
@@ -211,8 +203,8 @@
# 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
+ "uid": "A String", # UID of the referent.
+ # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
},
],
"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.
@@ -279,29 +271,6 @@
# +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
@@ -378,23 +347,18 @@
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
+ "status": { # TriggerStatus represents the current state of a Trigger. # Optional. 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
+ "severity": "A String", # Optional. How to interpret failures of this condition, one of Error, Warning, Info
+ "lastTransitionTime": "A String", # Optional. Last time the condition transitioned from one status to another.
+ "reason": "A String", # Optional. One-word CamelCase reason for the condition's current status.
+ "message": "A String", # Optional. Human readable message indicating details about the current status.
"type": "A String", # Type of Trigger condition.
},
],
@@ -402,26 +366,25 @@
},
"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",
+ "filter": { # Optional. Filter is the filter to apply against all events from the Broker. Only
+ # events that pass this filter will be sent to the Subscriber.
+ # Note that filter is optional in knative and is only required in fully
+ # managed due to different broker implementation.
+ "attributes": { # Optional. Attributes filters events by exact match on event context attributes.
+ # Each key in the map is compared with the equivalent key in the event
+ # context. An event passes the filter if all values are equal to the
+ # specified values.
+ #
+ # Nested context attributes are not supported as keys.
+ # Only string values are supported.
+ # Note that this field is optional in knative. In fully managed, 'type'
+ # attribute is required due to different broker implementation.
+ "a_key": "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.
+ "subscriber": { # Sink is the addressable that will receive events.
+ "ref": { # ObjectReference contains enough information to let you inspect or modify the # ObjectReference points to an Addressable.
+ # + optional
# referred object.
"kind": "A String", # Kind of the referent.
# More info:
@@ -455,16 +418,17 @@
# 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
+ "uri": "A String", # URI is for direct URI Designations or used with the resulting URL from
+ # Addressable ObjectReference. If used with an ObjectReference, will be
+ # appended to the path of the resulting URL from the Addressable.
+ # + optional
},
"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".
+ "apiVersion": "A String", # The API version for this call such as "eventing.knative.dev/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
@@ -476,8 +440,8 @@
"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
+ "name": "A String", # Name of the referent.
+ # More info: http://kubernetes.io/docs/user-guide/identifiers#names
"apiVersion": "A String", # API version of the referent.
"controller": True or False, # If true, this reference points to the managing controller.
# +optional
@@ -488,8 +452,8 @@
# 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
+ "uid": "A String", # UID of the referent.
+ # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
},
],
"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.
@@ -556,29 +520,6 @@
# +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
@@ -696,23 +637,18 @@
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
+ "status": { # TriggerStatus represents the current state of a Trigger. # Optional. 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
+ "severity": "A String", # Optional. How to interpret failures of this condition, one of Error, Warning, Info
+ "lastTransitionTime": "A String", # Optional. Last time the condition transitioned from one status to another.
+ "reason": "A String", # Optional. One-word CamelCase reason for the condition's current status.
+ "message": "A String", # Optional. Human readable message indicating details about the current status.
"type": "A String", # Type of Trigger condition.
},
],
@@ -720,26 +656,25 @@
},
"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",
+ "filter": { # Optional. Filter is the filter to apply against all events from the Broker. Only
+ # events that pass this filter will be sent to the Subscriber.
+ # Note that filter is optional in knative and is only required in fully
+ # managed due to different broker implementation.
+ "attributes": { # Optional. Attributes filters events by exact match on event context attributes.
+ # Each key in the map is compared with the equivalent key in the event
+ # context. An event passes the filter if all values are equal to the
+ # specified values.
+ #
+ # Nested context attributes are not supported as keys.
+ # Only string values are supported.
+ # Note that this field is optional in knative. In fully managed, 'type'
+ # attribute is required due to different broker implementation.
+ "a_key": "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.
+ "subscriber": { # Sink is the addressable that will receive events.
+ "ref": { # ObjectReference contains enough information to let you inspect or modify the # ObjectReference points to an Addressable.
+ # + optional
# referred object.
"kind": "A String", # Kind of the referent.
# More info:
@@ -773,16 +708,17 @@
# 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
+ "uri": "A String", # URI is for direct URI Designations or used with the resulting URL from
+ # Addressable ObjectReference. If used with an ObjectReference, will be
+ # appended to the path of the resulting URL from the Addressable.
+ # + optional
},
"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".
+ "apiVersion": "A String", # The API version for this call such as "eventing.knative.dev/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
@@ -794,8 +730,8 @@
"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
+ "name": "A String", # Name of the referent.
+ # More info: http://kubernetes.io/docs/user-guide/identifiers#names
"apiVersion": "A String", # API version of the referent.
"controller": True or False, # If true, this reference points to the managing controller.
# +optional
@@ -806,8 +742,8 @@
# 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
+ "uid": "A String", # UID of the referent.
+ # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
},
],
"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.
@@ -874,29 +810,6 @@
# +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
@@ -984,7 +897,7 @@
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.
+ 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.
@@ -999,23 +912,18 @@
"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
+ "status": { # TriggerStatus represents the current state of a Trigger. # Optional. 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
+ "severity": "A String", # Optional. How to interpret failures of this condition, one of Error, Warning, Info
+ "lastTransitionTime": "A String", # Optional. Last time the condition transitioned from one status to another.
+ "reason": "A String", # Optional. One-word CamelCase reason for the condition's current status.
+ "message": "A String", # Optional. Human readable message indicating details about the current status.
"type": "A String", # Type of Trigger condition.
},
],
@@ -1023,26 +931,25 @@
},
"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",
+ "filter": { # Optional. Filter is the filter to apply against all events from the Broker. Only
+ # events that pass this filter will be sent to the Subscriber.
+ # Note that filter is optional in knative and is only required in fully
+ # managed due to different broker implementation.
+ "attributes": { # Optional. Attributes filters events by exact match on event context attributes.
+ # Each key in the map is compared with the equivalent key in the event
+ # context. An event passes the filter if all values are equal to the
+ # specified values.
+ #
+ # Nested context attributes are not supported as keys.
+ # Only string values are supported.
+ # Note that this field is optional in knative. In fully managed, 'type'
+ # attribute is required due to different broker implementation.
+ "a_key": "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.
+ "subscriber": { # Sink is the addressable that will receive events.
+ "ref": { # ObjectReference contains enough information to let you inspect or modify the # ObjectReference points to an Addressable.
+ # + optional
# referred object.
"kind": "A String", # Kind of the referent.
# More info:
@@ -1076,16 +983,17 @@
# 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
+ "uri": "A String", # URI is for direct URI Designations or used with the resulting URL from
+ # Addressable ObjectReference. If used with an ObjectReference, will be
+ # appended to the path of the resulting URL from the Addressable.
+ # + optional
},
"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".
+ "apiVersion": "A String", # The API version for this call such as "eventing.knative.dev/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
@@ -1097,8 +1005,8 @@
"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
+ "name": "A String", # Name of the referent.
+ # More info: http://kubernetes.io/docs/user-guide/identifiers#names
"apiVersion": "A String", # API version of the referent.
"controller": True or False, # If true, this reference points to the managing controller.
# +optional
@@ -1109,8 +1017,8 @@
# 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
+ "uid": "A String", # UID of the referent.
+ # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
},
],
"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.
@@ -1177,29 +1085,6 @@
# +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
@@ -1267,7 +1152,7 @@
},
},
],
- "apiVersion": "A String", # The API version for this call such as "v1alpha1".
+ "apiVersion": "A String", # The API version for this call such as "eventing.knative.dev/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}.
@@ -1295,568 +1180,4 @@
}</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>
\ No newline at end of file