docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/run_v1alpha1.projects.locations.routes.html b/docs/dyn/run_v1alpha1.projects.locations.routes.html
index 1ea6712..f3d42b2 100644
--- a/docs/dyn/run_v1alpha1.projects.locations.routes.html
+++ b/docs/dyn/run_v1alpha1.projects.locations.routes.html
@@ -78,7 +78,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Rpc to get information about a route.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, labelSelector=None, fieldSelector=None, includeUninitialized=None, resourceVersion=None, continue=None, limit=None, watch=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, limit=None, watch=None, labelSelector=None, fieldSelector=None, includeUninitialized=None, resourceVersion=None, continue=None, x__xgafv=None)</a></code></p>
<p class="firstline">Rpc to list routes.</p>
<h3>Method Details</h3>
<div class="method">
@@ -108,6 +108,11 @@
# automatically deploy the "latest ready" Revision from that Configuration.
"status": { # RouteStatus communicates the observed state of the Route (from the # Status communicates the observed state of the Route (from the controller).
# controller).
+ "domain": "A String", # Deprecated - use url instead.
+ # Domain holds the top-level domain that will distribute traffic over the
+ # provided targets.
+ "domainInternal": "A String", # Deprecated - use address instead.
+ # For Cloud Run, identifical to domain.
"conditions": [ # Conditions communicates information about ongoing/complete
# reconciliation processes that bring the "spec" inline with the observed
# state of the world.
@@ -150,6 +155,17 @@
# When ConfigurationName appears in the spec, this will hold the
# LatestReadyRevisionName that we last observed.
{ # TrafficTarget holds a single entry of the routing table for a Route.
+ "tag": "A String", # Tag is optionally used to expose a dedicated url for referencing
+ # this target exclusively.
+ #
+ # Not currently supported in Cloud Run.
+ # +optional
+ "url": "A String", # Output only. URL displays the URL for accessing named traffic targets. URL
+ # is displayed in status, and is disallowed on spec. URL must contain a
+ # scheme (e.g. http://) and a hostname, but may not contain anything else
+ # (e.g. basic auth, url path, etc.
+ #
+ # Not currently supported in Cloud Run.
"name": "A String", # Name is optionally used to expose a dedicated hostname for referencing this
# target exclusively.
#
@@ -177,24 +193,8 @@
# target. When provided LatestRevision must be true if RevisionName is
# empty; it must be false when RevisionName is non-empty.
# +optional
- "tag": "A String", # Tag is optionally used to expose a dedicated url for referencing
- # this target exclusively.
- #
- # Not currently supported in Cloud Run.
- # +optional
- "url": "A String", # Output only. URL displays the URL for accessing named traffic targets. URL
- # is displayed in status, and is disallowed on spec. URL must contain a
- # scheme (e.g. http://) and a hostname, but may not contain anything else
- # (e.g. basic auth, url path, etc.
- #
- # Not currently supported in Cloud Run.
},
],
- "domain": "A String", # Deprecated - use url instead.
- # Domain holds the top-level domain that will distribute traffic over the
- # provided targets.
- "domainInternal": "A String", # Deprecated - use address instead.
- # For Cloud Run, identifical to domain.
},
"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1alpha1".
"spec": { # RouteSpec holds the desired state of the Route (from the client). # Spec holds the desired state of the Route (from the client).
@@ -202,6 +202,17 @@
# Revisions and Configurations.
# Cloud Run currently supports a single configurationName.
{ # TrafficTarget holds a single entry of the routing table for a Route.
+ "tag": "A String", # Tag is optionally used to expose a dedicated url for referencing
+ # this target exclusively.
+ #
+ # Not currently supported in Cloud Run.
+ # +optional
+ "url": "A String", # Output only. URL displays the URL for accessing named traffic targets. URL
+ # is displayed in status, and is disallowed on spec. URL must contain a
+ # scheme (e.g. http://) and a hostname, but may not contain anything else
+ # (e.g. basic auth, url path, etc.
+ #
+ # Not currently supported in Cloud Run.
"name": "A String", # Name is optionally used to expose a dedicated hostname for referencing this
# target exclusively.
#
@@ -229,17 +240,6 @@
# target. When provided LatestRevision must be true if RevisionName is
# empty; it must be false when RevisionName is non-empty.
# +optional
- "tag": "A String", # Tag is optionally used to expose a dedicated url for referencing
- # this target exclusively.
- #
- # Not currently supported in Cloud Run.
- # +optional
- "url": "A String", # Output only. URL displays the URL for accessing named traffic targets. URL
- # is displayed in status, and is disallowed on spec. URL must contain a
- # scheme (e.g. http://) and a hostname, but may not contain anything else
- # (e.g. basic auth, url path, etc.
- #
- # Not currently supported in Cloud Run.
},
],
"generation": 42, # Deprecated and not currently populated by Cloud Run. See
@@ -252,12 +252,6 @@
"metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Route, including name, namespace, labels,
# and annotations.
# all objects users must create.
- "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",
- },
"generateName": "A String", # Not currently supported by Cloud Run.
#
# GenerateName is an optional prefix, used by the server, to generate a
@@ -286,17 +280,17 @@
# for creation idempotence and configuration definition. Cannot be updated.
# More info: http://kubernetes.io/docs/user-guide/identifiers#names
# +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
"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
"finalizers": [ # Not currently supported by Cloud Run.
#
# Must be empty before the object is deleted from the registry. Each entry
@@ -336,11 +330,6 @@
{ # 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.
- "apiVersion": "A String", # API version of the referent.
- "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
"controller": True or False, # If true, this reference points to the managing controller.
# +optional
"kind": "A String", # Kind of the referent.
@@ -353,6 +342,11 @@
# To set this field, a user needs "delete" permission of the owner,
# otherwise 422 (Unprocessable Entity) will be returned.
# +optional
+ "apiVersion": "A String", # API version of the referent.
+ "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
},
],
"creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this
@@ -389,6 +383,11 @@
# More info:
# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
# +optional
+ "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.
@@ -397,24 +396,28 @@
# Read-only.
# More info: http://kubernetes.io/docs/user-guide/identifiers#uids
# +optional
- "selfLink": "A String", # SelfLink is a URL representing this object.
- # Populated by the system.
- # Read-only.
- # +optional
- # string selfLink = 4;
"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.
+ "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",
+ },
},
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, labelSelector=None, fieldSelector=None, includeUninitialized=None, resourceVersion=None, continue=None, limit=None, watch=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, limit=None, watch=None, labelSelector=None, fieldSelector=None, includeUninitialized=None, resourceVersion=None, continue=None, x__xgafv=None)</code>
<pre>Rpc to list routes.
Args:
parent: string, The project ID or project number from which the routes should be listed. (required)
+ 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.
labelSelector: string, Allows to filter resources based on a label. Supported operations are
=, !=, exists, in, and notIn.
fieldSelector: string, Allows to filter resources based on a specific value for a field name.
@@ -424,9 +427,6 @@
resourceVersion: string, The baseline resource version from which the list or watch operation should
start. Not currently used by Cloud Run.
continue: string, Optional encoded string to continue paging.
- 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.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -478,6 +478,11 @@
# automatically deploy the "latest ready" Revision from that Configuration.
"status": { # RouteStatus communicates the observed state of the Route (from the # Status communicates the observed state of the Route (from the controller).
# controller).
+ "domain": "A String", # Deprecated - use url instead.
+ # Domain holds the top-level domain that will distribute traffic over the
+ # provided targets.
+ "domainInternal": "A String", # Deprecated - use address instead.
+ # For Cloud Run, identifical to domain.
"conditions": [ # Conditions communicates information about ongoing/complete
# reconciliation processes that bring the "spec" inline with the observed
# state of the world.
@@ -520,6 +525,17 @@
# When ConfigurationName appears in the spec, this will hold the
# LatestReadyRevisionName that we last observed.
{ # TrafficTarget holds a single entry of the routing table for a Route.
+ "tag": "A String", # Tag is optionally used to expose a dedicated url for referencing
+ # this target exclusively.
+ #
+ # Not currently supported in Cloud Run.
+ # +optional
+ "url": "A String", # Output only. URL displays the URL for accessing named traffic targets. URL
+ # is displayed in status, and is disallowed on spec. URL must contain a
+ # scheme (e.g. http://) and a hostname, but may not contain anything else
+ # (e.g. basic auth, url path, etc.
+ #
+ # Not currently supported in Cloud Run.
"name": "A String", # Name is optionally used to expose a dedicated hostname for referencing this
# target exclusively.
#
@@ -547,24 +563,8 @@
# target. When provided LatestRevision must be true if RevisionName is
# empty; it must be false when RevisionName is non-empty.
# +optional
- "tag": "A String", # Tag is optionally used to expose a dedicated url for referencing
- # this target exclusively.
- #
- # Not currently supported in Cloud Run.
- # +optional
- "url": "A String", # Output only. URL displays the URL for accessing named traffic targets. URL
- # is displayed in status, and is disallowed on spec. URL must contain a
- # scheme (e.g. http://) and a hostname, but may not contain anything else
- # (e.g. basic auth, url path, etc.
- #
- # Not currently supported in Cloud Run.
},
],
- "domain": "A String", # Deprecated - use url instead.
- # Domain holds the top-level domain that will distribute traffic over the
- # provided targets.
- "domainInternal": "A String", # Deprecated - use address instead.
- # For Cloud Run, identifical to domain.
},
"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1alpha1".
"spec": { # RouteSpec holds the desired state of the Route (from the client). # Spec holds the desired state of the Route (from the client).
@@ -572,6 +572,17 @@
# Revisions and Configurations.
# Cloud Run currently supports a single configurationName.
{ # TrafficTarget holds a single entry of the routing table for a Route.
+ "tag": "A String", # Tag is optionally used to expose a dedicated url for referencing
+ # this target exclusively.
+ #
+ # Not currently supported in Cloud Run.
+ # +optional
+ "url": "A String", # Output only. URL displays the URL for accessing named traffic targets. URL
+ # is displayed in status, and is disallowed on spec. URL must contain a
+ # scheme (e.g. http://) and a hostname, but may not contain anything else
+ # (e.g. basic auth, url path, etc.
+ #
+ # Not currently supported in Cloud Run.
"name": "A String", # Name is optionally used to expose a dedicated hostname for referencing this
# target exclusively.
#
@@ -599,17 +610,6 @@
# target. When provided LatestRevision must be true if RevisionName is
# empty; it must be false when RevisionName is non-empty.
# +optional
- "tag": "A String", # Tag is optionally used to expose a dedicated url for referencing
- # this target exclusively.
- #
- # Not currently supported in Cloud Run.
- # +optional
- "url": "A String", # Output only. URL displays the URL for accessing named traffic targets. URL
- # is displayed in status, and is disallowed on spec. URL must contain a
- # scheme (e.g. http://) and a hostname, but may not contain anything else
- # (e.g. basic auth, url path, etc.
- #
- # Not currently supported in Cloud Run.
},
],
"generation": 42, # Deprecated and not currently populated by Cloud Run. See
@@ -622,12 +622,6 @@
"metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Route, including name, namespace, labels,
# and annotations.
# all objects users must create.
- "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",
- },
"generateName": "A String", # Not currently supported by Cloud Run.
#
# GenerateName is an optional prefix, used by the server, to generate a
@@ -656,17 +650,17 @@
# for creation idempotence and configuration definition. Cannot be updated.
# More info: http://kubernetes.io/docs/user-guide/identifiers#names
# +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
"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
"finalizers": [ # Not currently supported by Cloud Run.
#
# Must be empty before the object is deleted from the registry. Each entry
@@ -706,11 +700,6 @@
{ # 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.
- "apiVersion": "A String", # API version of the referent.
- "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
"controller": True or False, # If true, this reference points to the managing controller.
# +optional
"kind": "A String", # Kind of the referent.
@@ -723,6 +712,11 @@
# To set this field, a user needs "delete" permission of the owner,
# otherwise 422 (Unprocessable Entity) will be returned.
# +optional
+ "apiVersion": "A String", # API version of the referent.
+ "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
},
],
"creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this
@@ -759,6 +753,11 @@
# More info:
# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
# +optional
+ "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.
@@ -767,14 +766,15 @@
# Read-only.
# More info: http://kubernetes.io/docs/user-guide/identifiers#uids
# +optional
- "selfLink": "A String", # SelfLink is a URL representing this object.
- # Populated by the system.
- # Read-only.
- # +optional
- # string selfLink = 4;
"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.
+ "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",
+ },
},
},
],