Struct Service 

#[non_exhaustive]
pub struct Service {
    pub name: String,
    pub annotations: HashMap<String, String>,
    pub endpoints: Vec<Endpoint>,
    pub uid: String,
    /* private fields */
}

An individual service. A service contains a name and optional metadata. A service must exist before endpoints can be added to it.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

Immutable. The resource name for the service in the format projects/*/locations/*/namespaces/*/services/*.

annotations: HashMap<String, String>

Optional. Annotations for the service. This data can be consumed by service clients.

Restrictions:

• The entire annotations dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected
• Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Annotations that fails to meet these requirements are rejected

Note: This field is equivalent to the metadata field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory.

endpoints: Vec<Endpoint>

Output only. Endpoints associated with this service. Returned on LookupService.ResolveService. Control plane clients should use RegistrationService.ListEndpoints.

uid: String

Output only. The globally unique identifier of the service in the UUID4 format.

Implementations

impl Service

pub fn new() -> Self

Creates a new default instance.

pub fn set_name<T: Into<String>>(self, v: T) -> Self

Sets the value of name.

Example

let x = Service::new().set_name(format!("projects/{project_id}/locations/{location_id}/namespaces/{namespace_id}/services/{service_id}"));

pub fn set_annotations<T, K, V>(self, v: T) -> Self

where T: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Sets the value of annotations.

Example

let x = Service::new().set_annotations([
    ("key0", "abc"),
    ("key1", "xyz"),
]);

pub fn set_endpoints<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<Endpoint>,

Sets the value of endpoints.

Example

use google_cloud_servicedirectory_v1::model::Endpoint;
let x = Service::new()
    .set_endpoints([
        Endpoint::default()/* use setters */,
        Endpoint::default()/* use (different) setters */,
    ]);

pub fn set_uid<T: Into<String>>(self, v: T) -> Self

Sets the value of uid.

Example

let x = Service::new().set_uid("example");

Trait Implementations

impl Clone for Service

fn clone(&self) -> Service

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Service

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Service

fn default() -> Service

Returns the “default value” for a type.

impl Message for Service

fn typename() -> &'static str

The typename of this message.

impl PartialEq for Service

fn eq(&self, other: &Service) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Service