| <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_v1.html">Cloud Run API</a> . <a href="run_v1.api.html">api</a> . <a href="run_v1.api.v1.html">v1</a> . <a href="run_v1.api.v1.namespaces.html">namespaces</a></h1> | |
| <h2>Instance Methods</h2> | |
| <p class="toc_element"> | |
| <code><a href="run_v1.api.v1.namespaces.secrets.html">secrets()</a></code> | |
| </p> | |
| <p class="firstline">Returns the secrets Resource.</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 namespace.</p> | |
| <p class="toc_element"> | |
| <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p> | |
| <p class="firstline">Rpc to update a namespace.</p> | |
| <h3>Method Details</h3> | |
| <div class="method"> | |
| <code class="details" id="get">get(name, x__xgafv=None)</code> | |
| <pre>Rpc to get information about a namespace. | |
| Args: | |
| name: string, Required. The name of the namespace 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: | |
| { # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run on GKE: supported | |
| # | |
| # Namespace provides a scope for Names. | |
| # Use of multiple namespaces is optional. | |
| "metadata": { # k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta is metadata that all # Standard object's metadata. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata | |
| # persisted resources must have, which includes all objects users must create. | |
| "annotations": { # (Optional) | |
| # | |
| # 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 | |
| "a_key": "A String", | |
| }, | |
| "generateName": "A String", # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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 | |
| # string generateName = 2; | |
| "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 | |
| "deletionGracePeriodSeconds": 42, # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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. | |
| "clusterName": "A String", # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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. | |
| "finalizers": [ # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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. | |
| # +patchStrategy=merge | |
| "A String", | |
| ], | |
| "deletionTimestamp": "A String", # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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 | |
| "ownerReferences": [ # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # List of objects that own this object. If ALL objects in the list have | |
| # been deleted, this object will be garbage collected. | |
| { # 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. | |
| "controller": True or False, # If true, this reference points to the managing controller. | |
| # +optional | |
| "kind": "A String", # Kind of the referent. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds | |
| "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 | |
| "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", # (Optional) | |
| # | |
| # 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 | |
| "labels": { # (Optional) | |
| # | |
| # 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 | |
| "a_key": "A String", | |
| }, | |
| "generation": 42, # (Optional) | |
| # | |
| # A sequence number representing a specific generation of the desired state. | |
| # Populated by the system. Read-only. | |
| "resourceVersion": "A String", # (Optional) | |
| # | |
| # 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 | |
| "selfLink": "A String", # (Optional) | |
| # | |
| # SelfLink is a URL representing this object. | |
| # Populated by the system. | |
| # Read-only. | |
| # string selfLink = 4; | |
| "uid": "A String", # (Optional) | |
| # | |
| # 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 | |
| "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. | |
| }, | |
| "status": { # Cloud Run fully managed: not supported # Status describes the current status of a Namespace. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status | |
| # | |
| # Cloud Run on GKE: supported | |
| # | |
| # NamespaceStatus is information about the current status of a Namespace. | |
| "phase": "A String", # Phase is the current lifecycle phase of the namespace. | |
| # More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/ | |
| }, | |
| "spec": { # Cloud Run fully managed: not supported # Spec defines the behavior of the Namespace. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status | |
| # | |
| # Cloud Run on GKE: supported | |
| # | |
| # NamespaceSpec describes the attributes on a Namespace. | |
| "finalizers": [ # Finalizers is an opaque list of values that must be empty to permanently | |
| # remove object from storage. More info: | |
| # https://kubernetes.io/docs/tasks/administer-cluster/namespaces/ | |
| "A String", | |
| ], | |
| }, | |
| }</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code> | |
| <pre>Rpc to update a namespace. | |
| Args: | |
| name: string, Required. The name of the namespace being retrieved. If needed, replace | |
| {namespace_id} with the project ID. (required) | |
| body: object, The request body. | |
| The object takes the form of: | |
| { # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run on GKE: supported | |
| # | |
| # Namespace provides a scope for Names. | |
| # Use of multiple namespaces is optional. | |
| "metadata": { # k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta is metadata that all # Standard object's metadata. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata | |
| # persisted resources must have, which includes all objects users must create. | |
| "annotations": { # (Optional) | |
| # | |
| # 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 | |
| "a_key": "A String", | |
| }, | |
| "generateName": "A String", # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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 | |
| # string generateName = 2; | |
| "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 | |
| "deletionGracePeriodSeconds": 42, # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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. | |
| "clusterName": "A String", # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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. | |
| "finalizers": [ # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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. | |
| # +patchStrategy=merge | |
| "A String", | |
| ], | |
| "deletionTimestamp": "A String", # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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 | |
| "ownerReferences": [ # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # List of objects that own this object. If ALL objects in the list have | |
| # been deleted, this object will be garbage collected. | |
| { # 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. | |
| "controller": True or False, # If true, this reference points to the managing controller. | |
| # +optional | |
| "kind": "A String", # Kind of the referent. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds | |
| "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 | |
| "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", # (Optional) | |
| # | |
| # 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 | |
| "labels": { # (Optional) | |
| # | |
| # 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 | |
| "a_key": "A String", | |
| }, | |
| "generation": 42, # (Optional) | |
| # | |
| # A sequence number representing a specific generation of the desired state. | |
| # Populated by the system. Read-only. | |
| "resourceVersion": "A String", # (Optional) | |
| # | |
| # 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 | |
| "selfLink": "A String", # (Optional) | |
| # | |
| # SelfLink is a URL representing this object. | |
| # Populated by the system. | |
| # Read-only. | |
| # string selfLink = 4; | |
| "uid": "A String", # (Optional) | |
| # | |
| # 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 | |
| "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. | |
| }, | |
| "status": { # Cloud Run fully managed: not supported # Status describes the current status of a Namespace. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status | |
| # | |
| # Cloud Run on GKE: supported | |
| # | |
| # NamespaceStatus is information about the current status of a Namespace. | |
| "phase": "A String", # Phase is the current lifecycle phase of the namespace. | |
| # More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/ | |
| }, | |
| "spec": { # Cloud Run fully managed: not supported # Spec defines the behavior of the Namespace. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status | |
| # | |
| # Cloud Run on GKE: supported | |
| # | |
| # NamespaceSpec describes the attributes on a Namespace. | |
| "finalizers": [ # Finalizers is an opaque list of values that must be empty to permanently | |
| # remove object from storage. More info: | |
| # https://kubernetes.io/docs/tasks/administer-cluster/namespaces/ | |
| "A String", | |
| ], | |
| }, | |
| } | |
| updateMask: string, Required. Indicates which fields in the provided namespace to update. | |
| This field is currently unused. | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run on GKE: supported | |
| # | |
| # Namespace provides a scope for Names. | |
| # Use of multiple namespaces is optional. | |
| "metadata": { # k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta is metadata that all # Standard object's metadata. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata | |
| # persisted resources must have, which includes all objects users must create. | |
| "annotations": { # (Optional) | |
| # | |
| # 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 | |
| "a_key": "A String", | |
| }, | |
| "generateName": "A String", # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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 | |
| # string generateName = 2; | |
| "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 | |
| "deletionGracePeriodSeconds": 42, # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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. | |
| "clusterName": "A String", # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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. | |
| "finalizers": [ # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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. | |
| # +patchStrategy=merge | |
| "A String", | |
| ], | |
| "deletionTimestamp": "A String", # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # 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 | |
| "ownerReferences": [ # (Optional) | |
| # | |
| # Cloud Run fully managed: not supported | |
| # | |
| # Cloud Run for Anthos: supported | |
| # | |
| # List of objects that own this object. If ALL objects in the list have | |
| # been deleted, this object will be garbage collected. | |
| { # 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. | |
| "controller": True or False, # If true, this reference points to the managing controller. | |
| # +optional | |
| "kind": "A String", # Kind of the referent. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds | |
| "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 | |
| "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", # (Optional) | |
| # | |
| # 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 | |
| "labels": { # (Optional) | |
| # | |
| # 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 | |
| "a_key": "A String", | |
| }, | |
| "generation": 42, # (Optional) | |
| # | |
| # A sequence number representing a specific generation of the desired state. | |
| # Populated by the system. Read-only. | |
| "resourceVersion": "A String", # (Optional) | |
| # | |
| # 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 | |
| "selfLink": "A String", # (Optional) | |
| # | |
| # SelfLink is a URL representing this object. | |
| # Populated by the system. | |
| # Read-only. | |
| # string selfLink = 4; | |
| "uid": "A String", # (Optional) | |
| # | |
| # 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 | |
| "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. | |
| }, | |
| "status": { # Cloud Run fully managed: not supported # Status describes the current status of a Namespace. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status | |
| # | |
| # Cloud Run on GKE: supported | |
| # | |
| # NamespaceStatus is information about the current status of a Namespace. | |
| "phase": "A String", # Phase is the current lifecycle phase of the namespace. | |
| # More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/ | |
| }, | |
| "spec": { # Cloud Run fully managed: not supported # Spec defines the behavior of the Namespace. | |
| # More info: | |
| # https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status | |
| # | |
| # Cloud Run on GKE: supported | |
| # | |
| # NamespaceSpec describes the attributes on a Namespace. | |
| "finalizers": [ # Finalizers is an opaque list of values that must be empty to permanently | |
| # remove object from storage. More info: | |
| # https://kubernetes.io/docs/tasks/administer-cluster/namespaces/ | |
| "A String", | |
| ], | |
| }, | |
| }</pre> | |
| </div> | |
| </body></html> |