Struct FullName 

pub struct FullName { /* private fields */ }

A full resource name: //, the global host of the service that owns the resource, / and its relative name.

Built only by FullName::parse (the full form) or FullName::from_relative (a service and a relative name), both of which refuse anything but the one canonical spelling, so two names are equal exactly when they name the same resource. Display, FromStr and serde use the full form, and only it.

Implementations

impl FullName

pub fn parse(name: &str) -> Result<FullName, FullNameError>

Parses the full form, //{host}/{relative}, and nothing else.

Refused: a URN, a URL (any scheme), a relative name, a bare id, a host that isn’t the global host of one of RESOURCE_SERVICES (a regional or zonal one included), an API version as the first segment, a trailing /, and an empty, ., .. or otherwise invalid segment.

pub fn from_relative( service: &str, relative: &str, ) -> Result<FullName, FullNameError>

The full name of the resource relative (its name) of service, a short code such as pvs: //{service}.origincloudapis.eu/ + relative.

Refused: a service that isn’t one of RESOURCE_SERVICES, a full name given as the relative one, an API version as the first segment, a trailing /, and an empty, ., .. or otherwise invalid segment.

pub fn service(&self) -> &str

The short code of the service that owns the resource (pvs).

pub fn host(&self) -> &str

The service’s host (pvs.origincloudapis.eu).

pub fn relative(&self) -> &str

The relative name, the resource’s name: the full name without //{host}/.

pub fn as_str(&self) -> &str

The full form, as Display writes it.

pub fn url(&self, version: &str) -> Result<String, FullNameError>

The URL that calls the resource, https://{host}/{version}/{relative}, for an API version such as v1beta1.

pub fn principal(&self) -> Option<Principal<'_>>

The principal the name is, if it is one: a user, a service account, a service agent or an internal platform service, each an iam name.

pub fn role(&self) -> Option<&str>

The role’s id if the name is a role, //iam.origincloudapis.eu/roles/{role}: iam.editor. A role’s id writes its parts with dots; roles/iam/editor is no role.

pub fn of_role(role: &str) -> Result<FullName, FullNameError>

The full name of the role role, such as iam.editor: //iam.origincloudapis.eu/roles/iam.editor.

Trait Implementations

impl AsRef<str> for FullName

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for FullName

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FullName

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FullName

A string in the full form; anything FullName::parse refuses is an error.

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for FullName

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

Formats the value using the given formatter.

impl Eq for FullName

impl From<FullName> for String

fn from(name: FullName) -> String

Converts to this type from the input type.

impl FromStr for FullName

type Err = FullNameError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for FullName

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for FullName

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for FullName

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for FullName

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for FullName

The full form, as a string.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FullName