Virtru policy.registeredresources.RegisteredResourcesService API

Registered Resources

OpenAPI Specification

virtru-policy-registeredresources-registeredresourcesservice-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: authorization authorization.AuthorizationService policy.registeredresources.RegisteredResourcesService API
  description: Registered Resources
security: []
tags:
- name: policy.registeredresources.RegisteredResourcesService
  description: Registered Resources
paths:
  /policy.registeredresources.RegisteredResourcesService/CreateRegisteredResource:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: CreateRegisteredResource
      operationId: policy.registeredresources.RegisteredResourcesService.CreateRegisteredResource
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.CreateRegisteredResourceRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.CreateRegisteredResourceResponse'
  /policy.registeredresources.RegisteredResourcesService/GetRegisteredResource:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: GetRegisteredResource
      operationId: policy.registeredresources.RegisteredResourcesService.GetRegisteredResource
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.GetRegisteredResourceRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.GetRegisteredResourceResponse'
  /policy.registeredresources.RegisteredResourcesService/ListRegisteredResources:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: ListRegisteredResources
      operationId: policy.registeredresources.RegisteredResourcesService.ListRegisteredResources
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.ListRegisteredResourcesRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.ListRegisteredResourcesResponse'
  /policy.registeredresources.RegisteredResourcesService/UpdateRegisteredResource:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: UpdateRegisteredResource
      operationId: policy.registeredresources.RegisteredResourcesService.UpdateRegisteredResource
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.UpdateRegisteredResourceRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.UpdateRegisteredResourceResponse'
  /policy.registeredresources.RegisteredResourcesService/DeleteRegisteredResource:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: DeleteRegisteredResource
      operationId: policy.registeredresources.RegisteredResourcesService.DeleteRegisteredResource
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.DeleteRegisteredResourceRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.DeleteRegisteredResourceResponse'
  /policy.registeredresources.RegisteredResourcesService/CreateRegisteredResourceValue:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: CreateRegisteredResourceValue
      operationId: policy.registeredresources.RegisteredResourcesService.CreateRegisteredResourceValue
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.CreateRegisteredResourceValueRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.CreateRegisteredResourceValueResponse'
  /policy.registeredresources.RegisteredResourcesService/GetRegisteredResourceValue:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: GetRegisteredResourceValue
      operationId: policy.registeredresources.RegisteredResourcesService.GetRegisteredResourceValue
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.GetRegisteredResourceValueRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.GetRegisteredResourceValueResponse'
  /policy.registeredresources.RegisteredResourcesService/GetRegisteredResourceValuesByFQNs:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: GetRegisteredResourceValuesByFQNs
      operationId: policy.registeredresources.RegisteredResourcesService.GetRegisteredResourceValuesByFQNs
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.GetRegisteredResourceValuesByFQNsRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.GetRegisteredResourceValuesByFQNsResponse'
  /policy.registeredresources.RegisteredResourcesService/ListRegisteredResourceValues:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: ListRegisteredResourceValues
      operationId: policy.registeredresources.RegisteredResourcesService.ListRegisteredResourceValues
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.ListRegisteredResourceValuesRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.ListRegisteredResourceValuesResponse'
  /policy.registeredresources.RegisteredResourcesService/UpdateRegisteredResourceValue:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: UpdateRegisteredResourceValue
      operationId: policy.registeredresources.RegisteredResourcesService.UpdateRegisteredResourceValue
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.UpdateRegisteredResourceValueRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.UpdateRegisteredResourceValueResponse'
  /policy.registeredresources.RegisteredResourcesService/DeleteRegisteredResourceValue:
    post:
      tags:
      - policy.registeredresources.RegisteredResourcesService
      summary: DeleteRegisteredResourceValue
      operationId: policy.registeredresources.RegisteredResourcesService.DeleteRegisteredResourceValue
      parameters:
      - name: Connect-Protocol-Version
        in: header
        required: true
        schema:
          $ref: '#/components/schemas/connect-protocol-version'
      - name: Connect-Timeout-Ms
        in: header
        schema:
          $ref: '#/components/schemas/connect-timeout-header'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/policy.registeredresources.DeleteRegisteredResourceValueRequest'
        required: true
      responses:
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/connect.error'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/policy.registeredresources.DeleteRegisteredResourceValueResponse'
components:
  schemas:
    policy.PublicKey:
      type: object
      oneOf:
      - properties:
          cached:
            title: cached
            description: public key with additional information. Current preferred version
            $ref: '#/components/schemas/policy.KasPublicKeySet'
        title: cached
        required:
        - cached
      - properties:
          remote:
            type: string
            title: remote
            description: 'kas public key url - optional since can also be retrieved via public key

              URI must be a valid URL (e.g., ''https://demo.com/'') followed by additional segments. Each segment must start and end with an alphanumeric character, can contain hyphens, alphanumeric characters, and slashes.:

              ```

              this.matches(''^https://[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*(/.*)?$'')

              ```


              '
        title: remote
        required:
        - remote
      title: PublicKey
      additionalProperties: false
      description: Deprecated
    policy.Algorithm:
      type: string
      title: Algorithm
      enum:
      - ALGORITHM_UNSPECIFIED
      - ALGORITHM_RSA_2048
      - ALGORITHM_RSA_4096
      - ALGORITHM_EC_P256
      - ALGORITHM_EC_P384
      - ALGORITHM_EC_P521
      - ALGORITHM_HPQT_XWING
      - ALGORITHM_HPQT_SECP256R1_MLKEM768
      - ALGORITHM_HPQT_SECP384R1_MLKEM1024
      - ALGORITHM_MLKEM_768
      - ALGORITHM_MLKEM_1024
      description: Supported key algorithms.
    policy.SourceType:
      type: string
      title: SourceType
      enum:
      - SOURCE_TYPE_UNSPECIFIED
      - SOURCE_TYPE_INTERNAL
      - SOURCE_TYPE_EXTERNAL
      description: "Describes whether this kas is managed by the organization or if they imported\n the kas information from an external party. These two modes are necessary in order\n to encrypt a tdf dek with an external parties kas public key."
    policy.registeredresources.ListRegisteredResourcesResponse:
      type: object
      properties:
        resources:
          type: array
          items:
            $ref: '#/components/schemas/policy.RegisteredResource'
          title: resources
        pagination:
          title: pagination
          $ref: '#/components/schemas/policy.PageResponse'
      title: ListRegisteredResourcesResponse
      additionalProperties: false
    policy.registeredresources.DeleteRegisteredResourceResponse:
      type: object
      properties:
        resource:
          title: resource
          $ref: '#/components/schemas/policy.RegisteredResource'
      title: DeleteRegisteredResourceResponse
      additionalProperties: false
    policy.SubjectMapping:
      type: object
      properties:
        id:
          type: string
          title: id
        attributeValue:
          title: attribute_value
          description: 'the Attribute Value mapped to; aka: "The Entity Entitlement Attribute"'
          $ref: '#/components/schemas/policy.Value'
        subjectConditionSet:
          title: subject_condition_set
          description: the reusable SubjectConditionSet mapped to the given Attribute Value
          $ref: '#/components/schemas/policy.SubjectConditionSet'
        actions:
          type: array
          items:
            $ref: '#/components/schemas/policy.Action'
          title: actions
          description: The actions permitted by subjects in this mapping
        namespace:
          title: namespace
          description: "the namespace containing this subject mapping\n possible this is empty. If so that means\n the Subject Mapping has not been migrated to a namespace."
          $ref: '#/components/schemas/policy.Namespace'
        metadata:
          title: metadata
          $ref: '#/components/schemas/common.Metadata'
      title: SubjectMapping
      additionalProperties: false
      description: 'Subject Mapping: A Policy assigning Subject Set(s) to a permitted attribute

        value + action(s) combination'
    policy.registeredresources.UpdateRegisteredResourceValueRequest:
      type: object
      properties:
        id:
          type: string
          title: id
          format: uuid
          description: Required
        value:
          type: string
          title: value
          maxLength: 253
          description: 'Optional

            Registered Resource Value must be an alphanumeric string, allowing hyphens and underscores but not as the first or last character. The stored value will be normalized to lower case.:

            ```

            size(this) > 0 ? this.matches(''^[a-zA-Z0-9](?:[a-zA-Z0-9_-]*[a-zA-Z0-9])?$'') : true

            ```


            '
        actionAttributeValues:
          type: array
          items:
            $ref: '#/components/schemas/policy.registeredresources.ActionAttributeValue'
          title: action_attribute_values
          description: "Optional\n Action Attribute Values provided here will replace all existing records in the database. To delete all action attribute values, set this field to an empty list."
        metadata:
          title: metadata
          description: "Optional\n Common metadata"
          $ref: '#/components/schemas/common.MetadataMutable'
        metadataUpdateBehavior:
          title: metadata_update_behavior
          $ref: '#/components/schemas/common.MetadataUpdateEnum'
      title: UpdateRegisteredResourceValueRequest
      additionalProperties: false
    policy.RegisteredResource:
      type: object
      properties:
        id:
          type: string
          title: id
        name:
          type: string
          title: name
        values:
          type: array
          items:
            $ref: '#/components/schemas/policy.RegisteredResourceValue'
          title: values
        namespace:
          title: namespace
          $ref: '#/components/schemas/policy.Namespace'
        metadata:
          title: metadata
          description: Common metadata
          $ref: '#/components/schemas/common.Metadata'
      title: RegisteredResource
      additionalProperties: false
    policy.ObligationTrigger:
      type: object
      properties:
        id:
          type: string
          title: id
        obligationValue:
          title: obligation_value
          $ref: '#/components/schemas/policy.ObligationValue'
        action:
          title: action
          $ref: '#/components/schemas/policy.Action'
        attributeValue:
          title: attribute_value
          $ref: '#/components/schemas/policy.Value'
        context:
          type: array
          items:
            $ref: '#/components/schemas/policy.RequestContext'
          title: context
        namespace:
          title: namespace
          description: The source namespace for this trigger, derived from the attribute value and action.
          $ref: '#/components/schemas/policy.Namespace'
        metadata:
          title: metadata
          $ref: '#/components/schemas/common.Metadata'
      title: ObligationTrigger
      additionalProperties: false
    policy.registeredresources.GetRegisteredResourceRequest:
      type: object
      oneOf:
      - properties:
          id:
            type: string
            title: id
            format: uuid
        title: id
        required:
        - id
      - properties:
          name:
            type: string
            title: name
            maxLength: 253
            description: 'Registered Resource Name must be an alphanumeric string, allowing hyphens and underscores but not as the first or last character. The stored name will be normalized to lower case.:

              ```

              size(this) > 0 ? this.matches(''^[a-zA-Z0-9](?:[a-zA-Z0-9_-]*[a-zA-Z0-9])?$'') : true

              ```


              '
        title: name
        required:
        - name
      properties:
        namespaceFqn:
          type: string
          title: namespace_fqn
          minLength: 1
          format: uri
        namespaceId:
          type: string
          title: namespace_id
          format: uuid
      title: GetRegisteredResourceRequest
      additionalProperties: false
    common.Metadata:
      type: object
      properties:
        createdAt:
          title: created_at
          description: created_at set by server (entity who created will recorded in an audit event)
          $ref: '#/components/schemas/google.protobuf.Timestamp'
        updatedAt:
          title: updated_at
          description: updated_at set by server (entity who updated will recorded in an audit event)
          $ref: '#/components/schemas/google.protobuf.Timestamp'
        labels:
          type: object
          title: labels
          additionalProperties:
            type: string
            title: value
          description: optional short description
      title: Metadata
      additionalProperties: false
      description: Struct to uniquely identify a resource with optional additional metadata
    policy.registeredresources.CreateRegisteredResourceResponse:
      type: object
      properties:
        resource:
          title: resource
          $ref: '#/components/schemas/policy.RegisteredResource'
      title: CreateRegisteredResourceResponse
      additionalProperties: false
    connect-protocol-version:
      type: number
      title: Connect-Protocol-Version
      enum:
      - 1
      description: Define the version of the Connect protocol
      const: 1
    policy.ResourceMappingGroup:
      type: object
      properties:
        id:
          type: string
          title: id
        namespaceId:
          type: string
          title: namespace_id
          description: the namespace containing the group of resource mappings
        name:
          type: string
          title: name
          description: "the common name for the group of resource mappings, which must be unique\n per namespace"
        fqn:
          type: string
          title: fqn
          description: the fully qualified name of the resource mapping group
        metadata:
          title: metadata
          description: Common metadata
          $ref: '#/components/schemas/common.Metadata'
      title: ResourceMappingGroup
      required:
      - namespaceId
      - name
      additionalProperties: false
      description: 'Resource Mapping Groups are namespaced collections of Resource Mappings

        associated under a common group name.'
    google.protobuf.Any:
      type: object
      properties:
        type:
          type: string
        value:
          type: string
          format: binary
        debug:
          type: object
          additionalProperties: true
      additionalProperties: true
      description: Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.
    policy.PolicyEnforcementPoint:
      type: object
      properties:
        clientId:
          type: string
          title: client_id
          minLength: 1
      title: PolicyEnforcementPoint
      additionalProperties: false
    policy.KasPublicKey:
      type: object
      properties:
        pem:
          type: string
          title: pem
          maxLength: 8192
          minLength: 1
          description: x509 ASN.1 content in PEM envelope, usually
        kid:
          type: string
          title: kid
          maxLength: 32
          minLength: 1
          description: A unique string identifier for this key
        alg:
          not:
            enum:
            - 0
          title: alg
          description: "A known algorithm type with any additional parameters encoded.\n To start, these may be `rsa:2048` for RSA-based wrapping and\n `ec:secp256r1` for EC-based wrapping, but more formats may be added as needed."
          $ref: '#/components/schemas/policy.KasPublicKeyAlgEnum'
      title: KasPublicKey
      additionalProperties: false
      description: "Deprecated\n A KAS public key and some associated metadata for further identifcation"
    policy.KeyAccessServer:
      type: object
      properties:
        id:
          type: string
          title: id
        uri:
          type: string
          title: uri
          description: 'Address of a KAS instance

            URI must be a valid URL (e.g., ''https://demo.com/'') followed by additional segments. Each segment must start and end with an alphanumeric character, can contain hyphens, alphanumeric characters, and slashes.:

            ```

            this.matches(''^https?://[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*(:[0-9]+)?(/.*)?$'')

            ```


            '
        publicKey:
          title: public_key
          description: 'Deprecated: KAS can have multiple key pairs'
          $ref: '#/components/schemas/policy.PublicKey'
        sourceType:
          title: source_type
          description: 'The source of the KAS: (INTERNAL, EXTERNAL)'
          $ref: '#/components/schemas/policy.SourceType'
        kasKeys:
          type: array
          items:
            $ref: '#/components/schemas/policy.SimpleKasKey'
          title: kas_keys
          description: Kas keys associated with this KAS
        name:
          type: string
          title: name
          description: "Optional\n Unique name of the KAS instance"
        metadata:
          title: metadata
          description: Common metadata
          $ref: '#/components/schemas/common.Metadata'
      title: KeyAccessServer
      additionalProperties: false
      description: Key Access Server Registry
    policy.registeredresources.DeleteRegisteredResourceValueResponse:
      type: object
      properties:
        value:
          title: value
          $ref: '#/components/schemas/policy.RegisteredResourceValue'
      title: DeleteRegisteredResourceValueResponse
      additionalProperties: false
    policy.registeredresources.CreateRegisteredResourceValueResponse:
      type: object
      properties:
        value:
          title: value
          $ref: '#/components/schemas/policy.RegisteredResourceValue'
      title: CreateRegisteredResourceValueResponse
      additionalProperties: false
    policy.registeredresources.ListRegisteredResourceValuesResponse:
      type: object
      properties:
        values:
          type: array
          items:
            $ref: '#/components/schemas/policy.RegisteredResourceValue'
          title: values
        pagination:
          title: pagination
          $ref: '#/components/schemas/policy.PageResponse'
      title: ListRegisteredResourceValuesResponse
      additionalProperties: false
    policy.registeredresources.GetRegisteredResourceValuesByFQNsRequest:
      type: object
      properties:
        fqns:
          type: array
          items:
            type: string
            minLength: 1
            format: uri
            minItems: 1
            uniqueItems: true
          title: fqns
          minItems: 1
          uniqueItems: true
          description: Required
      title: GetRegisteredResourceValuesByFQNsRequest
      additionalProperties: false
    google.protobuf.Timestamp:
      type: string
      examples:
      - 1s
      - 1.000340012s
      format: date-time
      description: "A Timestamp represents a point in time independent of any time zone or local\n calendar, encoded as a count of seconds and fractions of seconds at\n nanosecond resolution. The count is relative to an epoch at UTC midnight on\n January 1, 1970, in the proleptic Gregorian calendar which extends the\n Gregorian calendar backwards to year one.\n\n All minutes are 60 seconds long. Leap seconds are \"smeared\" so that no leap\n second table is needed for interpretation, using a [24-hour linear\n smear](https://developers.google.com/time/smear).\n\n The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By\n restricting to that range, we ensure that we can convert to and from [RFC\n 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.\n\n # Examples\n\n Example 1: Compute Timestamp from POSIX `time()`.\n\n     Timestamp timestamp;\n     timestamp.set_seconds(time(NULL));\n     timestamp.set_nanos(0);\n\n Example 2: Compute Timestamp from POSIX `gettimeofday()`.\n\n     struct timeval tv;\n     gettimeofday(&tv, NULL);\n\n     Timestamp timestamp;\n     timestamp.set_seconds(tv.tv_sec);\n     timestamp.set_nanos(tv.tv_usec * 1000);\n\n Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.\n\n     FILETIME ft;\n     GetSystemTimeAsFileTime(&ft);\n     UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;\n\n     // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z\n     // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.\n     Timestamp timestamp;\n     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));\n     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));\n\n Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.\n\n     long millis = System.currentTimeMillis();\n\n     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)\n         .setNanos((int) ((millis % 1000) * 1000000)).build();\n\n Example 5: Compute Timestamp from Java `Instant.now()`.\n\n     Instant now = Instant.now();\n\n     Timestamp timestamp =\n         Timestamp.newBuilder().setSeconds(now.getEpochSecond())\n             .setNanos(now.getNano()).build();\n\n Example 6: Compute Timestamp from current time in Python.\n\n     timestamp = Timestamp()\n     timestamp.GetCurrentTime()\n\n # JSON Mapping\n\n In JSON format, the Timestamp type is encoded as a string in the\n [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the\n format is \"{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z\"\n where {year} is always expressed using four digits while {month}, {day},\n {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional\n seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),\n are optional. The \"Z\" suffix indicates the timezone (\"UTC\"); the timezone\n is required. A proto3 JSON serializer should always use UTC (as indicated by\n \"Z\") when printing the Timestamp type and a proto3 JSON parser should be\n able to accept both UTC and other timezones (as indicated by an offset).\n\n For example, \"2017-01-15T01:30:15.01Z\" encodes 15.01 seconds past\n 01:30 UTC on January 15, 2017.\n\n In JavaScript, one can convert a Date object to this format using the\n standard\n [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)\n method. 

# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/virtru/refs/heads/main/openapi/virtru-policy-registeredresources-registeredresourcesservice-api-openapi.yml