Struct openapiv3::Link [−][src]
pub struct Link {
pub description: Option<String>,
pub operation: LinkOperation,
pub request_body: Option<Value>,
pub parameters: IndexMap<String, Value>,
pub server: Option<Server>,
pub extensions: IndexMap<String, Value>,
}
Expand description
The Link object represents a possible design-time link for a response. The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.
Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.
For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.
Fields
description: Option<String>
A description of the link. CommonMark syntax MAY be used for rich text representation.
operation: LinkOperation
Either a operationRef or operationId
request_body: Option<Value>
A literal value or {expression} to use as a request body when calling the target operation.
parameters: IndexMap<String, Value>
A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
server: Option<Server>
A server object to be used by the target operation.
extensions: IndexMap<String, Value>
Inline extensions to this object.
Trait Implementations
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
__D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
Auto Trait Implementations
impl RefUnwindSafe for Link
impl UnwindSafe for Link
Blanket Implementations
Mutably borrows from an owned value. Read more