build.bazel.remote.logstream.v1.LogStreamOrBuilder Maven / Gradle / Ivy
// Generated by the protocol buffer compiler. DO NOT EDIT!
// source: build/bazel/remote/logstream/v1/remote_logstream.proto
// Protobuf Java Version: 3.25.3
package build.bazel.remote.logstream.v1;
public interface LogStreamOrBuilder extends
// @@protoc_insertion_point(interface_extends:build.bazel.remote.logstream.v1.LogStream)
com.google.protobuf.MessageOrBuilder {
/**
*
* Structured name of the resource in the format:
* {parent=**}/logstreams/{logstream_id}
* Example: projects/123/logstreams/456-def
* Attempting to call the Byte Stream API's `Write` RPC with a LogStream's
* `name` as the value for `ByteStream.Write.resource_name` is an error.
*
*
* string name = 1;
* @return The name.
*/
java.lang.String getName();
/**
*
* Structured name of the resource in the format:
* {parent=**}/logstreams/{logstream_id}
* Example: projects/123/logstreams/456-def
* Attempting to call the Byte Stream API's `Write` RPC with a LogStream's
* `name` as the value for `ByteStream.Write.resource_name` is an error.
*
*
* string name = 1;
* @return The bytes for name.
*/
com.google.protobuf.ByteString
getNameBytes();
/**
*
* Resource name to pass to `ByteStream.Write` in the format:
* {parent=**}/logstreams/{logstream_id}/{write_token}
* Example: projects/123/logstreams/456-def/789-ghi
* Attempting to call the Byte Stream API's `Read` RPC with a LogStream's
* `write_resource_name` as the value for `ByteStream.Write.resource_name`
* is an error.
*
* `write_resource_name` is separate from `name` to ensure that only the
* intended writers can write to a given LogStream. Writers must address write
* operations to the `write_resource_name`, not the `name`, and must have
* permission to write LogStreams. `write_resource_name` embeds a secret token
* and should be protected accordingly; a mishandled `write_resource_name` can
* result in unintended writers corrupting the LogStream. Therefore, the field
* should be excluded from calls to any calls which retrieve LogStream
* metadata (i.e.: `GetLogStream`).
*
* Bytes written to this resource must to be readable when `ByteStream.Read`
* is called with the `name` resource.
* Reading a write_resource_name must return an INVALID_ARGUMENT error.
*
*
* string write_resource_name = 2;
* @return The writeResourceName.
*/
java.lang.String getWriteResourceName();
/**
*
* Resource name to pass to `ByteStream.Write` in the format:
* {parent=**}/logstreams/{logstream_id}/{write_token}
* Example: projects/123/logstreams/456-def/789-ghi
* Attempting to call the Byte Stream API's `Read` RPC with a LogStream's
* `write_resource_name` as the value for `ByteStream.Write.resource_name`
* is an error.
*
* `write_resource_name` is separate from `name` to ensure that only the
* intended writers can write to a given LogStream. Writers must address write
* operations to the `write_resource_name`, not the `name`, and must have
* permission to write LogStreams. `write_resource_name` embeds a secret token
* and should be protected accordingly; a mishandled `write_resource_name` can
* result in unintended writers corrupting the LogStream. Therefore, the field
* should be excluded from calls to any calls which retrieve LogStream
* metadata (i.e.: `GetLogStream`).
*
* Bytes written to this resource must to be readable when `ByteStream.Read`
* is called with the `name` resource.
* Reading a write_resource_name must return an INVALID_ARGUMENT error.
*
*
* string write_resource_name = 2;
* @return The bytes for writeResourceName.
*/
com.google.protobuf.ByteString
getWriteResourceNameBytes();
}