final case class LookupSubjectsRequest(consistency: Option[Consistency] = _root_.scala.None, resource: Option[ObjectReference] = _root_.scala.None, permission: String = "", subjectObjectType: String = "", optionalSubjectRelation: String = "", context: Option[Struct] = _root_.scala.None, optionalConcreteLimit: Int = 0, optionalCursor: Option[Cursor] = _root_.scala.None, wildcardOption: WildcardOption = com.authzed.api.v1.permission_service.LookupSubjectsRequest.WildcardOption.WILDCARD_OPTION_UNSPECIFIED, unknownFields: UnknownFieldSet = _root_.scalapb.UnknownFieldSet.empty) extends GeneratedMessage with Updatable[LookupSubjectsRequest] with Product with Serializable
LookupSubjectsRequest performs a lookup of all subjects of a particular kind for which the subject has the specified permission or the relation in which the subject exists, streaming back the IDs of those subjects.
- resource
resource is the resource for which all matching subjects for the permission or relation will be returned.
- permission
permission is the name of the permission (or relation) for which to find the subjects.
- subjectObjectType
subject_object_type is the type of subject object for which the IDs will be returned.
- optionalSubjectRelation
optional_subject_relation is the optional relation for the subject.
- context
context consists of named values that are injected into the caveat evaluation context
- optionalConcreteLimit
optional_concrete_limit, if non-zero, specifies the limit on the number of *concrete* (non-wildcard) subjects to return before the stream is closed on the server side. With the default value of zero, the stream will continue resolving concrete subjects until exhausted or the stream is closed due to the client or a network issue. NOTE: Wildcard subjects ("*") have special treatment when cursors and limits are used. Because wildcards can apply to *any* concrete subjects, if a wildcard subject is found within the dataset, a wildcard subject can be returned for *all* LookupSubjects calls, regardless of the cursor or limit. For example, if wildcards are requested, a wildcard subject exists, there is a specified limit of 10 concrete subjects, and at least 10 concrete subjects exist, the API will return 11 subjects in total: the 10 concrete + the wildcard Furthermore, if a wildcard has a set of exclusions generated by the dataset, the exclusions *will respect the cursor* and only a *partial* set of exclusions will be returned for each invocation of the API. ***IT IS UP TO THE CALLER IN THIS CASE TO COMBINE THE EXCLUSIONS IF DESIRED***
- optionalCursor
optional_cursor, if specified, indicates the cursor after which results should resume being returned. The cursor can be found on the LookupSubjectsResponse object. NOTE: See above for notes about how cursors interact with wildcard subjects.
- wildcardOption
wildcard_option specifies whether wildcards should be returned by LookupSubjects. For backwards compatibility, defaults to WILDCARD_OPTION_INCLUDE_WILDCARDS if unspecified.
- Annotations
- @SerialVersionUID()
- Source
- LookupSubjectsRequest.scala
- Alphabetic
- By Inheritance
- LookupSubjectsRequest
- Updatable
- GeneratedMessage
- Serializable
- Product
- Equals
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Instance Constructors
- new LookupSubjectsRequest(consistency: Option[Consistency] = _root_.scala.None, resource: Option[ObjectReference] = _root_.scala.None, permission: String = "", subjectObjectType: String = "", optionalSubjectRelation: String = "", context: Option[Struct] = _root_.scala.None, optionalConcreteLimit: Int = 0, optionalCursor: Option[Cursor] = _root_.scala.None, wildcardOption: WildcardOption = com.authzed.api.v1.permission_service.LookupSubjectsRequest.WildcardOption.WILDCARD_OPTION_UNSPECIFIED, unknownFields: UnknownFieldSet = _root_.scalapb.UnknownFieldSet.empty)
- resource
resource is the resource for which all matching subjects for the permission or relation will be returned.
- permission
permission is the name of the permission (or relation) for which to find the subjects.
- subjectObjectType
subject_object_type is the type of subject object for which the IDs will be returned.
- optionalSubjectRelation
optional_subject_relation is the optional relation for the subject.
- context
context consists of named values that are injected into the caveat evaluation context
- optionalConcreteLimit
optional_concrete_limit, if non-zero, specifies the limit on the number of *concrete* (non-wildcard) subjects to return before the stream is closed on the server side. With the default value of zero, the stream will continue resolving concrete subjects until exhausted or the stream is closed due to the client or a network issue. NOTE: Wildcard subjects ("*") have special treatment when cursors and limits are used. Because wildcards can apply to *any* concrete subjects, if a wildcard subject is found within the dataset, a wildcard subject can be returned for *all* LookupSubjects calls, regardless of the cursor or limit. For example, if wildcards are requested, a wildcard subject exists, there is a specified limit of 10 concrete subjects, and at least 10 concrete subjects exist, the API will return 11 subjects in total: the 10 concrete + the wildcard Furthermore, if a wildcard has a set of exclusions generated by the dataset, the exclusions *will respect the cursor* and only a *partial* set of exclusions will be returned for each invocation of the API. ***IT IS UP TO THE CALLER IN THIS CASE TO COMBINE THE EXCLUSIONS IF DESIRED***
- optionalCursor
optional_cursor, if specified, indicates the cursor after which results should resume being returned. The cursor can be found on the LookupSubjectsResponse object. NOTE: See above for notes about how cursors interact with wildcard subjects.
- wildcardOption
wildcard_option specifies whether wildcards should be returned by LookupSubjects. For backwards compatibility, defaults to WILDCARD_OPTION_INCLUDE_WILDCARDS if unspecified.
Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clearConsistency: LookupSubjectsRequest
- def clearContext: LookupSubjectsRequest
- def clearOptionalCursor: LookupSubjectsRequest
- def clearResource: LookupSubjectsRequest
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native()
- def companion: LookupSubjectsRequest.type
- Definition Classes
- LookupSubjectsRequest → GeneratedMessage
- val consistency: Option[Consistency]
- val context: Option[Struct]
- def discardUnknownFields: LookupSubjectsRequest
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable])
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- def getConsistency: Consistency
- def getContext: Struct
- def getField(__field: FieldDescriptor): PValue
- Definition Classes
- LookupSubjectsRequest → GeneratedMessage
- def getFieldByNumber(__fieldNumber: Int): Any
- Definition Classes
- LookupSubjectsRequest → GeneratedMessage
- def getOptionalCursor: Cursor
- def getResource: ObjectReference
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- val optionalConcreteLimit: Int
- val optionalCursor: Option[Cursor]
- val optionalSubjectRelation: String
- val permission: String
- def productElementNames: Iterator[String]
- Definition Classes
- Product
- val resource: Option[ObjectReference]
- def serializedSize: Int
- Definition Classes
- LookupSubjectsRequest → GeneratedMessage
- val subjectObjectType: String
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- final def toByteArray: Array[Byte]
- Definition Classes
- GeneratedMessage
- final def toByteString: ByteString
- Definition Classes
- GeneratedMessage
- final def toPMessage: PMessage
- Definition Classes
- GeneratedMessage
- def toProtoString: String
- Definition Classes
- LookupSubjectsRequest → GeneratedMessage
- val unknownFields: UnknownFieldSet
- def update(ms: (Lens[LookupSubjectsRequest, LookupSubjectsRequest]) => Mutation[LookupSubjectsRequest]*): LookupSubjectsRequest
- Definition Classes
- Updatable
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()
- val wildcardOption: WildcardOption
- def withConsistency(__v: Consistency): LookupSubjectsRequest
- def withContext(__v: Struct): LookupSubjectsRequest
- def withOptionalConcreteLimit(__v: Int): LookupSubjectsRequest
- def withOptionalCursor(__v: Cursor): LookupSubjectsRequest
- def withOptionalSubjectRelation(__v: String): LookupSubjectsRequest
- def withPermission(__v: String): LookupSubjectsRequest
- def withResource(__v: ObjectReference): LookupSubjectsRequest
- def withSubjectObjectType(__v: String): LookupSubjectsRequest
- def withUnknownFields(__v: UnknownFieldSet): LookupSubjectsRequest
- def withWildcardOption(__v: WildcardOption): LookupSubjectsRequest
- final def writeDelimitedTo(output: OutputStream): Unit
- Definition Classes
- GeneratedMessage
- def writeTo(_output__: CodedOutputStream): Unit
- Definition Classes
- LookupSubjectsRequest → GeneratedMessage
- final def writeTo(output: OutputStream): Unit
- Definition Classes
- GeneratedMessage