Roles
The service class for roles.
Attributes
- Source
- Roles.scala
- Graph
-
- Supertypes
Members list
Type members
Inherited types
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Value members
Concrete methods
Get detailed information about the role specified by name and without a domain, assuming it exists.
Get detailed information about the role specified by name and without a domain, assuming it exists.
Value parameters
- name
-
the role name
Attributes
- Returns
-
the role matching the name and without a domain. If no such role exists F will contain an error.
- Source
- Roles.scala
An idempotent create. If the model that is to be created already exists then it will be updated, or simply returned if no modifications are necessary. The definition on what is considered already existing is left to the implementation as it is specific to the Model in question.
An idempotent create. If the model that is to be created already exists then it will be updated, or simply returned if no modifications are necessary. The definition on what is considered already existing is left to the implementation as it is specific to the Model in question.
Value parameters
- create
-
the values to use in the create.
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - keepExistingElements
-
the create operation can be interpreted with two possible meanings:
- Create a
Modelwith the settings inCreate. Extra settings that may already exist (when the model is being updated) will be preserved as much as possible. - Create a
Modelwith exactly the settings inCreate. Extra settings that may already exist are removed. This is done in a best effort approach, since its not achievable in the general case, as some settings are not updatable after creating the Model (the create and the update are asymmetric). SettingkeepExistingElementstotruewill follow the logic in point 1. Setting it tofalsewill follow the logic in point 2, thus making the update more stringent. In most cases removing extra settings will break things, so this flag is set totrueby default.
- Create a
- resolveConflict
-
the function used to resolve the conflict that will arise when the create is being performed on a model that already exists. By default it just invokes defaultResolveConflict.
Attributes
- Returns
-
the created role, or if it already exists the existing or updated model.
- Definition Classes
- Source
- Roles.scala
Default implementation to resolve the conflict that arises when implementing the createOrUpdate. In other words implements the idempotency logic of the create.
Default implementation to resolve the conflict that arises when implementing the createOrUpdate. In other words implements the idempotency logic of the create.
Value parameters
- create
-
the values to use in the create.
- existing
-
the existing role.
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - keepExistingElements
-
whether to keep existing elements. See
createOrUpdatefor a more detailed explanation.
Attributes
- Returns
-
the existing model if no modifications are required, otherwise the updated model.
- Definition Classes
- Source
- Roles.scala
Get detailed information about the role specified by name and without a domain.
Get detailed information about the role specified by name and without a domain.
Value parameters
- name
-
the role name
Attributes
- Returns
-
a Some(role) matching the name and without a domain if it exists. A None otherwise.
- Source
- Roles.scala
Value parameters
- domainId
-
filters the response by a domain ID.
- name
-
filters the response by a role name.
Attributes
- Returns
-
a stream of roles filtered by the various parameters.
- Source
- Roles.scala
Attributes
- Source
- Roles.scala
Attributes
- Source
- Roles.scala
Attributes
- Source
- Roles.scala
Attributes
- Source
- Roles.scala
Attributes
- Source
- Roles.scala
Attributes
- Source
- Roles.scala
Attributes
- Source
- Roles.scala
Allows performing role assignment operations on domain.
Allows performing role assignment operations on project.
Allows performing role assignment operations on system.
Allows performing role assignment operations on the domain with id
Allows performing role assignment operations on the project with id
Updates the role with the given id using the values in update.
Updates the role with the given id using the values in update.
Value parameters
- extraHeaders
-
extra headers to pass when making the request. The
authTokenheader is always added. - id
-
the id of the role to update.
- update
-
the values to use in the update.
Attributes
- Returns
-
the updated role.
- Definition Classes
- Source
- Roles.scala
Inherited methods
Get detailed information about the T specified by name and domainId, assuming it exists.
Get detailed information about the T specified by name and domainId, assuming it exists.
Value parameters
- domainId
-
the domain id
- name
-
the
Tname
Attributes
- Returns
-
the
Tmatching the name in a specific domain. If no suchTexists F will contain an error. - Inherited from:
- UniqueWithinDomain
- Source
- UniqueWithinDomain.scala
Gets the domainModel with the specified id, assuming it exists.
Gets the domainModel with the specified id, assuming it exists.
Value parameters
- extraHeaders
-
extra headers to pass when making the request. The
authTokenheader is always added. - id
-
the id of the domainModel to get. Usually a random UUID.
Attributes
- Returns
-
the domainModel with the given
id. If none exists F will contain an error. - Inherited from:
- ReadOperations
- Source
- ReadOperations.scala
Allows a simpler syntax to update domainModel(s). For example instead of:
Allows a simpler syntax to update domainModel(s). For example instead of:
cinder.quotas.update(project.id, Quota.Update(...))
We can do:
cinder.quotas(project.id, Quota.Update(...))
Attributes
- Inherited from:
- UpdateOperations
- Source
- UpdateOperations.scala
Allows a simpler syntax to create domainModel(s). For example instead of:
Allows a simpler syntax to create domainModel(s). For example instead of:
keystone.projects.create(Project.Create(name, domainId = Some(usersDomain.id)))
We can do:
keystone.projects(Project.Create(name, domainId = Some(usersDomain.id)))
Attributes
- Inherited from:
- CreateNonIdempotentOperations
- Source
- CreateNonIdempotentOperations.scala
Creates a new domainModel with the given create values.
Creates a new domainModel with the given create values.
Value parameters
- create
-
the values to use in the create.
- extraHeaders
-
extra headers to pass when making the request. The
authTokenheader is always added.
Attributes
- Returns
-
the created domainModel
- Inherited from:
- CreateNonIdempotentOperations
- Source
- CreateNonIdempotentOperations.scala
Creates a new domainModel with the given create values using uri. If a Conflict is returned execute onConflict to resolve it.
Creates a new domainModel with the given create values using uri. If a Conflict is returned execute onConflict to resolve it.
Value parameters
- create
-
the values to use in the create.
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - onConflict
-
the computation returning a domainModel to execute when a Conflict is returned in the create.
- uri
-
the uri to which the request will be made.
Attributes
- Returns
-
the created domainModel, or the updated domainModel by
onConflict. - Inherited from:
- CreateOperations
- Source
- CreateOperations.scala
Creates a new domainModel with the given create values using uri. If the create is not successful the response will be parsed to an E and the onConflict partial function will be called. If the function is defined for the given E the computation returned by it will be used to resolve the conflict. If the function is not defined F will contain the parsed E.
Creates a new domainModel with the given create values using uri. If the create is not successful the response will be parsed to an E and the onConflict partial function will be called. If the function is defined for the given E the computation returned by it will be used to resolve the conflict. If the function is not defined F will contain the parsed E.
Value parameters
- create
-
the values to use in the create.
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - onConflict
-
the computation returning a domainModel to execute when a Conflict is returned in the create.
- uri
-
the uri to which the request will be made.
Attributes
- Returns
-
the created domainModel, or the updated domainModel by
onConflict. - Inherited from:
- CreateOperations
- Source
- CreateOperations.scala
An idempotent create. If the model that is to be created already exists then it will be updated, or simply returned if no modifications are necessary. The definition on what is considered already existing is left to the implementation as it is specific to the Model in question. defaultResolveConflict will be invoked to resolve the conflict that will arise when the create is being performed on a model that already exists.
An idempotent create. If the model that is to be created already exists then it will be updated, or simply returned if no modifications are necessary. The definition on what is considered already existing is left to the implementation as it is specific to the Model in question. defaultResolveConflict will be invoked to resolve the conflict that will arise when the create is being performed on a model that already exists.
Value parameters
- create
-
the values to use in the create.
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - keepExistingElements
-
the create operation can be interpreted with two possible meanings:
- Create a
Modelwith the settings inCreate. Extra settings that may already exist (when the model is being updated) will be preserved as much as possible. - Create a
Modelwith exactly the settings inCreate. Extra settings that may already exist are removed. This is done in a best effort approach, since its not achievable in the general case, as some settings are not updatable after creating the Model (the create and the update are asymmetric). SettingkeepExistingElementstotruewill follow the logic in point 1. Setting it tofalsewill follow point 2, thus making the update more stringent.
- Create a
Attributes
- Returns
-
the created domainModel, or if it already exists the existing or updated model.
- Inherited from:
- CreateOperations
- Source
- CreateOperations.scala
An idempotent create. If the model that is to be created already exists then it will be updated, or simply returned if no modifications are necessary. The definition on what is considered already existing is left to the implementation as it is specific to the Model in question.
An idempotent create. If the model that is to be created already exists then it will be updated, or simply returned if no modifications are necessary. The definition on what is considered already existing is left to the implementation as it is specific to the Model in question.
This function simply calls the overloaded version passing in keepExistingElements set to true.
Value parameters
- create
-
the values to use in the create.
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added.
Attributes
- Returns
-
the created domainModel, or if it already exists the existing or updated model.
- Inherited from:
- CreateOperations
- Source
- CreateOperations.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Deletes the domainModel with the given id.
Deletes the domainModel with the given id.
Value parameters
- extraHeaders
-
extra headers to pass when making the request. The
authTokenheader is always added. - id
-
the id of the domainModel to delete. Usually a random UUID.
Attributes
- Inherited from:
- DeleteOperations
- Source
- DeleteOperations.scala
Deletes the given domainModel.
Deletes the given domainModel.
Value parameters
- extraHeaders
-
extra headers to pass when making the request. The
authTokenheader is always added. - model
-
the domainModel to delete.
Attributes
- Inherited from:
- DeleteOperations
- Source
- DeleteOperations.scala
An idempotent delete. If NotFound or Gone are returned this method will succeed.
An idempotent delete. If NotFound or Gone are returned this method will succeed.
Value parameters
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - uri
-
the uri to which the request will be made.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Invokes method on the specified uri without any body. The response will be parsed to an R.
Invokes method on the specified uri without any body. The response will be parsed to an R.
Value parameters
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - method
-
the method to use, eg: GET, POST, etc.
- uri
-
the uri to which the request will be made.
- wrappedAt
-
whether to decode
Rat the Json root, or at the fieldat.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Invokes method on the specified uri passing as body value. The response will be parsed to an R.
Invokes method on the specified uri passing as body value. The response will be parsed to an R.
Value parameters
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - method
-
the method to use, eg: GET, POST, etc.
- uri
-
the uri to which the request will be made.
- value
-
the value to send in the body. This value will be json encoded using
wrapped. - wrappedAt
-
whether to encode
Band decodeRat the Json root, or at the fieldat.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Invokes method on the specified uri without any body. The response will be parsed to an Option[R].
Invokes method on the specified uri without any body. The response will be parsed to an Option[R].
Value parameters
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - method
-
the method to use, eg: GET, POST, etc.
- uri
-
the uri to which the request will be made.
- wrappedAt
-
whether to decode
Rat the Json root, or at the fieldat.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Invokes method on the specified uri passing as body value. The response will be parsed to an Option[R].
Invokes method on the specified uri passing as body value. The response will be parsed to an Option[R].
Value parameters
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - method
-
the method to use, eg: GET, POST, etc.
- uri
-
the uri to which the request will be made.
- value
-
the value to send in the body. This value will be json encoded using
wrapped. - wrappedAt
-
whether to encode
Band decodeRat the Json root, or at the fieldat.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Submits request and decodes the response to a Option[R] on success.
Submits request and decodes the response to a Option[R] on success.
Value parameters
- request
-
the request to execute.
- wrappedAt
-
whether to decode
Rat the Json root, or at the fieldat.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Submits request and decodes the response to a R on success.
Submits request and decodes the response to a R on success.
Value parameters
- request
-
the request to execute.
- wrappedAt
-
whether to decode
Rat the Json root, or at the fieldat.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Get detailed information about the T specified by name and domainId.
Get detailed information about the T specified by name and domainId.
Value parameters
- domainId
-
the domain id
- name
-
the
Tname
Attributes
- Returns
-
a Some
Tmatching the name in a specific domain if it exists. A None otherwise. - Inherited from:
- UniqueWithinDomain
- Source
- UniqueWithinDomain.scala
Gets the domainModel with the specified id.
Gets the domainModel with the specified id.
Value parameters
- extraHeaders
-
extra headers to pass when making the request. The
authTokenheader is always added. - id
-
the id of the domainModel to get. Usually a random UUID.
Attributes
- Returns
-
a Some with the domainModel if it exists. A None otherwise.
- Inherited from:
- ReadOperations
- Source
- ReadOperations.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Lists all domainModel(s) using the specified query. If the response is paginated all elements will be returned, be careful as this might take a lot of time and memory.
Lists all domainModel(s) using the specified query. If the response is paginated all elements will be returned, be careful as this might take a lot of time and memory.
Value parameters
- extraHeaders
-
extra headers to pass when making the request. The
authTokenheader is always added. - query
-
the query to use when performing the request.
Attributes
- Inherited from:
- ListOperations
- Source
- ListOperations.scala
Lists all domainModel(s) using the specified pairs as the query params. If the response is paginated all elements will be returned, be careful as this might take a lot of time and memory.
Lists all domainModel(s) using the specified pairs as the query params. If the response is paginated all elements will be returned, be careful as this might take a lot of time and memory.
Value parameters
- pairs
-
the pairs of Strings that will be used as the query params.
Attributes
- Inherited from:
- ListOperations
- Source
- ListOperations.scala
Invokes a GET request on the specified uri, expecting to receive a list of elements. If the response is paginated all elements will be returned, be careful as this might take a lot of time and memory.
Invokes a GET request on the specified uri, expecting to receive a list of elements. If the response is paginated all elements will be returned, be careful as this might take a lot of time and memory.
Type parameters
- R
-
the type of the elements returned.
Value parameters
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - uri
-
the uri to which the request will be made. Query params related with pagination will be overwritten after the first request.
- wrappedAt
-
the Json object field where
Rwill be decoded from.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Lists Ts in the given domain.
Lists Ts in the given domain.
Value parameters
- domainId
-
the domain id of the domain.
Attributes
- Inherited from:
- UniqueWithinDomain
- Source
- UniqueWithinDomain.scala
Lists Ts with the given name.
Lists Ts with the given name.
Value parameters
- name
-
the name to search for.
Attributes
- Note
-
Since the
Tname must be unique within a domain, all the returnedTs will have different domains. - Inherited from:
- UniqueWithinDomain
- Source
- UniqueWithinDomain.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Streams domainModel(s) using the specified query. Automatically fetches more pages if more elements of the stream are consumed.
Streams domainModel(s) using the specified query. Automatically fetches more pages if more elements of the stream are consumed.
Value parameters
- extraHeaders
-
extra headers to pass when making the request. The
authTokenheader is always added. - query
-
the query to use when performing the request.
Attributes
- Inherited from:
- ListOperations
- Source
- ListOperations.scala
Streams domainModel(s) using the specified query. Automatically fetches more pages if more elements of the stream are consumed.
Streams domainModel(s) using the specified query. Automatically fetches more pages if more elements of the stream are consumed.
Value parameters
- pairs
-
the pairs of Strings that will be used as the query params.
Attributes
- Inherited from:
- ListOperations
- Source
- ListOperations.scala
Invokes a GET request on the specified uri, expecting the returned json to be paginated. Automatically fetches more pages if more elements of the stream are consumed.
Invokes a GET request on the specified uri, expecting the returned json to be paginated. Automatically fetches more pages if more elements of the stream are consumed.
Type parameters
- R
-
the type of the elements returned.
Value parameters
- extraHeaders
-
extra headers to be used. The
authTokenheader is always added. - uri
-
the uri to which the request will be made. Query params related with pagination will be overwritten after the first request.
- wrappedAt
-
the Json object field where
Rwill be decoded from.
Attributes
- Inherited from:
- { valnext:Option[Uri]=links.collectFirst[Uri](((x$1:Link)=>(x$1:@unchecked)match{ caseLink("next",uri)=> (`uri₂`:Uri) })) Tuple2.apply[List[Link],Option[Uri]](links,next) })).flatMap[DecodingFailure,Tuple2[Option[Uri],List[R]]](((`x$1₂`:Tuple2[List[Link],Option[Uri]])=>(`x$1₂`:@unchecked)match{ caseTuple2(links,next)=> c.downField(wrappedAt).as[List[R]](decodeList[R](evidence$24)).map[Tuple2[Option[Uri],List[R]]](((objectList:List[R])=>Tuple2.apply[Option[Uri],List[R]](`next₂`,objectList))) }))) Stream.unfoldChunkEval[F,Option[Uri],R](Some.apply[Uri](uri))(((`x$1₃`:Option[Uri])=>`x$1₃`match{ caseSome(uri)=> toFunctorOps[F,Tuple2[Option[Uri],List[R]]](client.expect[Tuple2[Option[Uri],List[R]]](Service.this.dsl.http4sClientSyntaxMethod(GET).apply(`uri₃`,extraHeaders.+:[ToRaw](Service.this.subjectTokenHeader):_*))(Service.this.jsonDecoder[Tuple2[Option[Uri],List[R]]](paginatedDecoder)))(F).map[Option[Tuple2[Chunk[R],Option[Uri]]]](((`x$1₄`:Tuple2[Option[Uri],List[R]])=>`x$1₄`match{ caseTuple2(next,entries)=> Some.apply[Tuple2[Chunk[R],Option[Uri]]](Tuple2.apply[Chunk[R],Option[Uri]](Chunk.iterable[R](entries),`next₃`)) })) caseNone=> F.pure[Option[Tuple2[Chunk[R],Option[Uri]]]](None) })) }">Service
- Source
- Service.scala
Creates a Decoder which will decode the response from Json. When at is None R will be decoded directly from the Json root (the normal implementation for most Json REST APIs). Example:
Creates a Decoder which will decode the response from Json. When at is None R will be decoded directly from the Json root (the normal implementation for most Json REST APIs). Example:
{
"id": "e4d02828-9cac-4765-bf7f-7e210dac7aba",
"zones": 500,
"zone_recordsets": 500
}
When at is a Some(x) R will be decoded from the Json object located in the field x. For R to be correctly parsed in this example at should be Some("quota"):
{
"quota": {
"id": "e4d02828-9cac-4765-bf7f-7e210dac7aba",
"zones": 500,
"zone_recordsets": 500
}
}
Value parameters
- at
-
whether to decode
Rat the Json root, or at the fieldat. - decoder
-
the circe decoder capable of converting Json to an R.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Creates an EntityEncoder which will encode R to a Json. When at is None R will be encoded directly (the normal implementation for most Json REST APIs). Example:
Creates an EntityEncoder which will encode R to a Json. When at is None R will be encoded directly (the normal implementation for most Json REST APIs). Example:
{
"id": "e4d02828-9cac-4765-bf7f-7e210dac7aba",
"zones": 500,
"zone_recordsets": 500
}
When at is a Some(x) R will be encoded inside a Json object with a single field named x. In this example at was set to Some("quota"):
{
"quota": {
"id": "e4d02828-9cac-4765-bf7f-7e210dac7aba",
"zones": 500,
"zone_recordsets": 500
}
}
Value parameters
- at
-
whether to encode
Rat the Json root, or at the fieldat. - encoder
-
the circe encoder capable of converting an R to Json.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Inherited fields
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
The baseUri with the pluraName appended as an extra path element.
The baseUri with the pluraName appended as an extra path element.
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Givens
Inherited givens
Attributes
- Inherited from:
- CrudService
- Source
- CrudService.scala
Attributes
- Inherited from:
- CrudService
- Source
- CrudService.scala
Attributes
- Inherited from:
- CrudService
- Source
- CrudService.scala
Implicits
Inherited implicits
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala
Attributes
- Inherited from:
- Service
- Source
- Service.scala