# Cloud Run API . namespaces . domainmappings

## Instance Methods

Creates a new domain mapping.

Rpc to delete a domain mapping.

Rpc to get information about a domain mapping.

Rpc to list domain mappings.

### Method Details

`create(parent, body=None, x__xgafv=None)`

    Creates a new domain mapping.

    Args:
      parent: string, The project ID or project number in which this domain mapping should be
    created. (required)
      body: object, The request body.
        The object takes the form of:

    { # Resource to hold the state and status of a user's domain mapping.
      "status": { # The current state of the Domain Mapping. # The current status of the DomainMapping.
        "mappedRouteName": "A String", # The name of the route that the mapping currently points to.
        "conditions": [ # Array of observed DomainMappingConditions, indicating the current state
            # of the DomainMapping.
          { # DomainMappingCondition contains state information for a DomainMapping.
            "message": "A String", # Human readable message indicating details about the current status.
                # +optional
            "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.
                # +optional
            "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
            "reason": "A String", # One-word CamelCase reason for the condition's current status.
                # +optional
            "type": "A String", # Type of domain mapping condition.
          },
        ],
        "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the DomainMapping that
            # was last processed by the controller.
            #
            # Clients polling for completed reconciliation should poll until
            # observedGeneration = metadata.generation and the Ready condition's status
            # is True or False.
        "resourceRecords": [ # The resource records required to configure this domain mapping. These
            # records must be added to the domain's DNS configuration in order to
            # serve the application via this domain mapping.
          { # A DNS resource record.
            "name": "A String", # Relative name of the object affected by this record. Only applicable for
                # `CNAME` records. Example: 'www'.
            "type": "A String", # Resource record type. Example: `AAAA`.
            "rrdata": "A String", # Data for this record. Values vary by record type, as defined in RFC 1035
                # (section 5) and RFC 1034 (section 3.6.1).
          },
        ],
      },
      "apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1alpha1".
      "spec": { # The desired state of the Domain Mapping. # The spec for this DomainMapping.
        "forceOverride": True or False, # If set, the mapping will override any mapping set before this spec was set.
            # It is recommended that the user leaves this empty to receive an error
            # warning about a potential conflict and only set it once the respective UI
            # has given such a warning.
        "routeName": "A String", # The name of the Knative Route that this DomainMapping applies to.
            # The route must exist.
        "certificateMode": "A String", # The mode of the certificate.
      },
      "kind": "A String", # The kind of resource, in this case "DomainMapping".
      "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this BuildTemplate.
          # all objects users must create.
        "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;
        "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, # 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
        "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",
        ],
        "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
        "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.
            "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", # 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
        "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",
        },
        "generation": 42, # A sequence number representing a specific generation of the desired state.
            # Populated by the system. Read-only.
            # +optional
        "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
        "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
        "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",
        },
      },
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Resource to hold the state and status of a user's domain mapping.
        "status": { # The current state of the Domain Mapping. # The current status of the DomainMapping.
          "mappedRouteName": "A String", # The name of the route that the mapping currently points to.
          "conditions": [ # Array of observed DomainMappingConditions, indicating the current state
              # of the DomainMapping.
            { # DomainMappingCondition contains state information for a DomainMapping.
              "message": "A String", # Human readable message indicating details about the current status.
                  # +optional
              "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.
                  # +optional
              "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
              "reason": "A String", # One-word CamelCase reason for the condition's current status.
                  # +optional
              "type": "A String", # Type of domain mapping condition.
            },
          ],
          "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the DomainMapping that
              # was last processed by the controller.
              #
              # Clients polling for completed reconciliation should poll until
              # observedGeneration = metadata.generation and the Ready condition's status
              # is True or False.
          "resourceRecords": [ # The resource records required to configure this domain mapping. These
              # records must be added to the domain's DNS configuration in order to
              # serve the application via this domain mapping.
            { # A DNS resource record.
              "name": "A String", # Relative name of the object affected by this record. Only applicable for
                  # `CNAME` records. Example: 'www'.
              "type": "A String", # Resource record type. Example: `AAAA`.
              "rrdata": "A String", # Data for this record. Values vary by record type, as defined in RFC 1035
                  # (section 5) and RFC 1034 (section 3.6.1).
            },
          ],
        },
        "apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1alpha1".
        "spec": { # The desired state of the Domain Mapping. # The spec for this DomainMapping.
          "forceOverride": True or False, # If set, the mapping will override any mapping set before this spec was set.
              # It is recommended that the user leaves this empty to receive an error
              # warning about a potential conflict and only set it once the respective UI
              # has given such a warning.
          "routeName": "A String", # The name of the Knative Route that this DomainMapping applies to.
              # The route must exist.
          "certificateMode": "A String", # The mode of the certificate.
        },
        "kind": "A String", # The kind of resource, in this case "DomainMapping".
        "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this BuildTemplate.
            # all objects users must create.
          "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;
          "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, # 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
          "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",
          ],
          "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
          "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.
              "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", # 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
          "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",
          },
          "generation": 42, # A sequence number representing a specific generation of the desired state.
              # Populated by the system. Read-only.
              # +optional
          "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
          "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
          "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",
          },
        },
      }

`delete(name, apiVersion=None, propagationPolicy=None, kind=None, orphanDependents=None, x__xgafv=None)`

    Rpc to delete a domain mapping.

    Args:
      name: string, The name of the domain mapping being deleted. If needed, replace
    {namespace_id} with the project ID. (required)
      apiVersion: string, Cloud Run currently ignores this parameter.
      propagationPolicy: string, Specifies the propagation policy of delete. Cloud Run currently ignores
    this setting, and deletes in the background. Please see
    kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for
    more information.
      kind: string, Cloud Run currently ignores this parameter.
      orphanDependents: boolean, Deprecated.
    Specifies the cascade behavior on delete.
    Cloud Run only supports cascading behavior, so this must be false.
    This attribute is deprecated, and is now replaced with PropagationPolicy
    See https://github.com/kubernetes/kubernetes/issues/46659 for more info.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated
          # empty messages in your APIs. A typical example is to use it as the request
          # or the response type of an API method. For instance:
          #
          #     service Foo {
          #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
          #     }
          #
          # The JSON representation for `Empty` is empty JSON object `{}`.
      }

`get(name, x__xgafv=None)`

    Rpc to get information about a domain mapping.

    Args:
      name: string, The name of the domain mapping 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:

        { # Resource to hold the state and status of a user's domain mapping.
        "status": { # The current state of the Domain Mapping. # The current status of the DomainMapping.
          "mappedRouteName": "A String", # The name of the route that the mapping currently points to.
          "conditions": [ # Array of observed DomainMappingConditions, indicating the current state
              # of the DomainMapping.
            { # DomainMappingCondition contains state information for a DomainMapping.
              "message": "A String", # Human readable message indicating details about the current status.
                  # +optional
              "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.
                  # +optional
              "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
              "reason": "A String", # One-word CamelCase reason for the condition's current status.
                  # +optional
              "type": "A String", # Type of domain mapping condition.
            },
          ],
          "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the DomainMapping that
              # was last processed by the controller.
              #
              # Clients polling for completed reconciliation should poll until
              # observedGeneration = metadata.generation and the Ready condition's status
              # is True or False.
          "resourceRecords": [ # The resource records required to configure this domain mapping. These
              # records must be added to the domain's DNS configuration in order to
              # serve the application via this domain mapping.
            { # A DNS resource record.
              "name": "A String", # Relative name of the object affected by this record. Only applicable for
                  # `CNAME` records. Example: 'www'.
              "type": "A String", # Resource record type. Example: `AAAA`.
              "rrdata": "A String", # Data for this record. Values vary by record type, as defined in RFC 1035
                  # (section 5) and RFC 1034 (section 3.6.1).
            },
          ],
        },
        "apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1alpha1".
        "spec": { # The desired state of the Domain Mapping. # The spec for this DomainMapping.
          "forceOverride": True or False, # If set, the mapping will override any mapping set before this spec was set.
              # It is recommended that the user leaves this empty to receive an error
              # warning about a potential conflict and only set it once the respective UI
              # has given such a warning.
          "routeName": "A String", # The name of the Knative Route that this DomainMapping applies to.
              # The route must exist.
          "certificateMode": "A String", # The mode of the certificate.
        },
        "kind": "A String", # The kind of resource, in this case "DomainMapping".
        "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this BuildTemplate.
            # all objects users must create.
          "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;
          "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, # 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
          "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",
          ],
          "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
          "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.
              "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", # 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
          "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",
          },
          "generation": 42, # A sequence number representing a specific generation of the desired state.
              # Populated by the system. Read-only.
              # +optional
          "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
          "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
          "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",
          },
        },
      }

`list(parent, labelSelector=None, fieldSelector=None, includeUninitialized=None, resourceVersion=None, continue=None, limit=None, watch=None, x__xgafv=None)`

    Rpc to list domain mappings.

    Args:
      parent: string, The project ID or project number from which the domain mappings should be
    listed. (required)
      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.
    Send this in a query string format. i.e. 'metadata.name%3Dlorem'.
    Not currently used by Cloud Run.
      includeUninitialized: boolean, Not currently used by Cloud Run.
      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
          2 - v2 error format

    Returns:
      An object of the form:

        { # ListDomainMappingsResponse is a list of DomainMapping resources.
        "apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1alpha1".
        "kind": "A String", # The kind of this resource, in this case "DomainMappingList".
        "unreachable": [ # Locations that could not be reached.
          "A String",
        ],
        "metadata": { # ListMeta describes metadata that synthetic resources must have, including # Metadata associated with this DomainMapping list.
            # lists and various status objects. A resource may have only one of
            # {ObjectMeta, ListMeta}.
          "resourceVersion": "A String", # String that identifies the server's internal version of this object that
              # can be used by clients to determine when objects have changed. Value must
              # be treated as opaque by clients and passed unmodified back to the server.
              # Populated by the system.
              # Read-only.
              # More info:
              # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
              # +optional
          "continue": "A String", # continue may be set if the user set a limit on the number of items
              # returned, and indicates that the server has more data available. The value
              # is opaque and may be used to issue another request to the endpoint that
              # served this list to retrieve the next set of available objects. Continuing
              # a list may not be possible if the server configuration has changed or more
              # than a few minutes have passed. The resourceVersion field returned when
              # using this continue value will be identical to the value in the first
              # response.
          "selfLink": "A String", # SelfLink is a URL representing this object.
              # Populated by the system.
              # Read-only.
              # +optional
        },
        "items": [ # List of DomainMappings.
          { # Resource to hold the state and status of a user's domain mapping.
            "status": { # The current state of the Domain Mapping. # The current status of the DomainMapping.
              "mappedRouteName": "A String", # The name of the route that the mapping currently points to.
              "conditions": [ # Array of observed DomainMappingConditions, indicating the current state
                  # of the DomainMapping.
                { # DomainMappingCondition contains state information for a DomainMapping.
                  "message": "A String", # Human readable message indicating details about the current status.
                      # +optional
                  "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.
                      # +optional
                  "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
                  "reason": "A String", # One-word CamelCase reason for the condition's current status.
                      # +optional
                  "type": "A String", # Type of domain mapping condition.
                },
              ],
              "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the DomainMapping that
                  # was last processed by the controller.
                  #
                  # Clients polling for completed reconciliation should poll until
                  # observedGeneration = metadata.generation and the Ready condition's status
                  # is True or False.
              "resourceRecords": [ # The resource records required to configure this domain mapping. These
                  # records must be added to the domain's DNS configuration in order to
                  # serve the application via this domain mapping.
                { # A DNS resource record.
                  "name": "A String", # Relative name of the object affected by this record. Only applicable for
                      # `CNAME` records. Example: 'www'.
                  "type": "A String", # Resource record type. Example: `AAAA`.
                  "rrdata": "A String", # Data for this record. Values vary by record type, as defined in RFC 1035
                      # (section 5) and RFC 1034 (section 3.6.1).
                },
              ],
            },
            "apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1alpha1".
            "spec": { # The desired state of the Domain Mapping. # The spec for this DomainMapping.
              "forceOverride": True or False, # If set, the mapping will override any mapping set before this spec was set.
                  # It is recommended that the user leaves this empty to receive an error
                  # warning about a potential conflict and only set it once the respective UI
                  # has given such a warning.
              "routeName": "A String", # The name of the Knative Route that this DomainMapping applies to.
                  # The route must exist.
              "certificateMode": "A String", # The mode of the certificate.
            },
            "kind": "A String", # The kind of resource, in this case "DomainMapping".
            "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this BuildTemplate.
                # all objects users must create.
              "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;
              "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, # 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
              "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",
              ],
              "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
              "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.
                  "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", # 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
              "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",
              },
              "generation": 42, # A sequence number representing a specific generation of the desired state.
                  # Populated by the system. Read-only.
                  # +optional
              "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
              "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
              "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",
              },
            },
          },
        ],
      }