api

package
v0.0.0-...-5519195 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 28, 2025 License: Apache-2.0 Imports: 16 Imported by: 55

Documentation

Overview

Package api contains CIPD backend API definitions.

Package api is a generated GoMock package.

Index

Constants

View Source 
const (
	Storage_GetObjectURL_FullMethodName = "/cipd.Storage/GetObjectURL"
	Storage_BeginUpload_FullMethodName  = "/cipd.Storage/BeginUpload"
	Storage_FinishUpload_FullMethodName = "/cipd.Storage/FinishUpload"
	Storage_CancelUpload_FullMethodName = "/cipd.Storage/CancelUpload"
)
View Source 
const (
	Repository_GetPrefixMetadata_FullMethodName          = "/cipd.Repository/GetPrefixMetadata"
	Repository_GetInheritedPrefixMetadata_FullMethodName = "/cipd.Repository/GetInheritedPrefixMetadata"
	Repository_UpdatePrefixMetadata_FullMethodName       = "/cipd.Repository/UpdatePrefixMetadata"
	Repository_GetRolesInPrefix_FullMethodName           = "/cipd.Repository/GetRolesInPrefix"
	Repository_GetRolesInPrefixOnBehalfOf_FullMethodName = "/cipd.Repository/GetRolesInPrefixOnBehalfOf"
	Repository_ListPrefix_FullMethodName                 = "/cipd.Repository/ListPrefix"
	Repository_HidePackage_FullMethodName                = "/cipd.Repository/HidePackage"
	Repository_UnhidePackage_FullMethodName              = "/cipd.Repository/UnhidePackage"
	Repository_DeletePackage_FullMethodName              = "/cipd.Repository/DeletePackage"
	Repository_RegisterInstance_FullMethodName           = "/cipd.Repository/RegisterInstance"
	Repository_ListInstances_FullMethodName              = "/cipd.Repository/ListInstances"
	Repository_SearchInstances_FullMethodName            = "/cipd.Repository/SearchInstances"
	Repository_CreateRef_FullMethodName                  = "/cipd.Repository/CreateRef"
	Repository_DeleteRef_FullMethodName                  = "/cipd.Repository/DeleteRef"
	Repository_ListRefs_FullMethodName                   = "/cipd.Repository/ListRefs"
	Repository_AttachTags_FullMethodName                 = "/cipd.Repository/AttachTags"
	Repository_DetachTags_FullMethodName                 = "/cipd.Repository/DetachTags"
	Repository_AttachMetadata_FullMethodName             = "/cipd.Repository/AttachMetadata"
	Repository_DetachMetadata_FullMethodName             = "/cipd.Repository/DetachMetadata"
	Repository_ListMetadata_FullMethodName               = "/cipd.Repository/ListMetadata"
	Repository_ResolveVersion_FullMethodName             = "/cipd.Repository/ResolveVersion"
	Repository_GetInstanceURL_FullMethodName             = "/cipd.Repository/GetInstanceURL"
	Repository_DescribeInstance_FullMethodName           = "/cipd.Repository/DescribeInstance"
	Repository_DescribeClient_FullMethodName             = "/cipd.Repository/DescribeClient"
	Repository_DescribeBootstrapBundle_FullMethodName    = "/cipd.Repository/DescribeBootstrapBundle"
)

Variables

View Source 
var (
	HashAlgo_name = map[int32]string{
		0: "HASH_ALGO_UNSPECIFIED",
		1: "SHA1",
		2: "SHA256",
	}
	HashAlgo_value = map[string]int32{
		"HASH_ALGO_UNSPECIFIED": 0,
		"SHA1":                  1,
		"SHA256":                2,
	}
)

Enum value maps for HashAlgo.

View Source 
var (
	UploadStatus_name = map[int32]string{
		0: "UPLOAD_STATUS_UNSPECIFIED",
		1: "UPLOADING",
		2: "VERIFYING",
		3: "PUBLISHED",
		4: "ERRORED",
		5: "CANCELED",
	}
	UploadStatus_value = map[string]int32{
		"UPLOAD_STATUS_UNSPECIFIED": 0,
		"UPLOADING":                 1,
		"VERIFYING":                 2,
		"PUBLISHED":                 3,
		"ERRORED":                   4,
		"CANCELED":                  5,
	}
)

Enum value maps for UploadStatus.

View Source 
var (
	EventKind_name = map[int32]string{
		0:   "EVENT_KIND_UNSPECIFIED",
		100: "PREFIX_ACL_CHANGED",
		200: "PACKAGE_CREATED",
		201: "PACKAGE_DELETED",
		202: "PACKAGE_HIDDEN",
		203: "PACKAGE_UNHIDDEN",
		300: "INSTANCE_CREATED",
		301: "INSTANCE_DELETED",
		302: "INSTANCE_REF_SET",
		303: "INSTANCE_REF_UNSET",
		304: "INSTANCE_TAG_ATTACHED",
		305: "INSTANCE_TAG_DETACHED",
		306: "INSTANCE_METADATA_ATTACHED",
		307: "INSTANCE_METADATA_DETACHED",
	}
	EventKind_value = map[string]int32{
		"EVENT_KIND_UNSPECIFIED":     0,
		"PREFIX_ACL_CHANGED":         100,
		"PACKAGE_CREATED":            200,
		"PACKAGE_DELETED":            201,
		"PACKAGE_HIDDEN":             202,
		"PACKAGE_UNHIDDEN":           203,
		"INSTANCE_CREATED":           300,
		"INSTANCE_DELETED":           301,
		"INSTANCE_REF_SET":           302,
		"INSTANCE_REF_UNSET":         303,
		"INSTANCE_TAG_ATTACHED":      304,
		"INSTANCE_TAG_DETACHED":      305,
		"INSTANCE_METADATA_ATTACHED": 306,
		"INSTANCE_METADATA_DETACHED": 307,
	}
)

Enum value maps for EventKind.

View Source 
var (
	Role_name = map[int32]string{
		0: "ROLE_UNSPECIFIED",
		1: "READER",
		2: "WRITER",
		3: "OWNER",
	}
	Role_value = map[string]int32{
		"ROLE_UNSPECIFIED": 0,
		"READER":           1,
		"WRITER":           2,
		"OWNER":            3,
	}
)

Enum value maps for Role.

View Source 
var (
	RegistrationStatus_name = map[int32]string{
		0: "REGISTRATION_STATUS_UNSPECIFIED",
		1: "REGISTERED",
		2: "ALREADY_REGISTERED",
		3: "NOT_UPLOADED",
	}
	RegistrationStatus_value = map[string]int32{
		"REGISTRATION_STATUS_UNSPECIFIED": 0,
		"REGISTERED":                      1,
		"ALREADY_REGISTERED":              2,
		"NOT_UPLOADED":                    3,
	}
)

Enum value maps for RegistrationStatus.

View Source 
var (
	Processor_State_name = map[int32]string{
		0: "STATE_UNSPECIFIED",
		1: "PENDING",
		2: "SUCCEEDED",
		3: "FAILED",
	}
	Processor_State_value = map[string]int32{
		"STATE_UNSPECIFIED": 0,
		"PENDING":           1,
		"SUCCEEDED":         2,
		"FAILED":            3,
	}
)

Enum value maps for Processor_State.

View Source 
var File_go_chromium_org_luci_cipd_api_cipd_v1_access_log_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_cipd_api_cipd_v1_cas_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_cipd_api_cipd_v1_events_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_cipd_api_cipd_v1_exported_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_cipd_api_cipd_v1_repo_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_cipd_api_cipd_v1_verification_log_proto protoreflect.FileDescriptor
View Source 
var Repository_ServiceDesc = grpc.ServiceDesc{
	ServiceName: "cipd.Repository",
	HandlerType: (*RepositoryServer)(nil),
	Methods: []grpc.MethodDesc{
		{
			MethodName: "GetPrefixMetadata",
			Handler:    _Repository_GetPrefixMetadata_Handler,
		},
		{
			MethodName: "GetInheritedPrefixMetadata",
			Handler:    _Repository_GetInheritedPrefixMetadata_Handler,
		},
		{
			MethodName: "UpdatePrefixMetadata",
			Handler:    _Repository_UpdatePrefixMetadata_Handler,
		},
		{
			MethodName: "GetRolesInPrefix",
			Handler:    _Repository_GetRolesInPrefix_Handler,
		},
		{
			MethodName: "GetRolesInPrefixOnBehalfOf",
			Handler:    _Repository_GetRolesInPrefixOnBehalfOf_Handler,
		},
		{
			MethodName: "ListPrefix",
			Handler:    _Repository_ListPrefix_Handler,
		},
		{
			MethodName: "HidePackage",
			Handler:    _Repository_HidePackage_Handler,
		},
		{
			MethodName: "UnhidePackage",
			Handler:    _Repository_UnhidePackage_Handler,
		},
		{
			MethodName: "DeletePackage",
			Handler:    _Repository_DeletePackage_Handler,
		},
		{
			MethodName: "RegisterInstance",
			Handler:    _Repository_RegisterInstance_Handler,
		},
		{
			MethodName: "ListInstances",
			Handler:    _Repository_ListInstances_Handler,
		},
		{
			MethodName: "SearchInstances",
			Handler:    _Repository_SearchInstances_Handler,
		},
		{
			MethodName: "CreateRef",
			Handler:    _Repository_CreateRef_Handler,
		},
		{
			MethodName: "DeleteRef",
			Handler:    _Repository_DeleteRef_Handler,
		},
		{
			MethodName: "ListRefs",
			Handler:    _Repository_ListRefs_Handler,
		},
		{
			MethodName: "AttachTags",
			Handler:    _Repository_AttachTags_Handler,
		},
		{
			MethodName: "DetachTags",
			Handler:    _Repository_DetachTags_Handler,
		},
		{
			MethodName: "AttachMetadata",
			Handler:    _Repository_AttachMetadata_Handler,
		},
		{
			MethodName: "DetachMetadata",
			Handler:    _Repository_DetachMetadata_Handler,
		},
		{
			MethodName: "ListMetadata",
			Handler:    _Repository_ListMetadata_Handler,
		},
		{
			MethodName: "ResolveVersion",
			Handler:    _Repository_ResolveVersion_Handler,
		},
		{
			MethodName: "GetInstanceURL",
			Handler:    _Repository_GetInstanceURL_Handler,
		},
		{
			MethodName: "DescribeInstance",
			Handler:    _Repository_DescribeInstance_Handler,
		},
		{
			MethodName: "DescribeClient",
			Handler:    _Repository_DescribeClient_Handler,
		},
		{
			MethodName: "DescribeBootstrapBundle",
			Handler:    _Repository_DescribeBootstrapBundle_Handler,
		},
	},
	Streams:  []grpc.StreamDesc{},
	Metadata: "go.chromium.org/luci/cipd/api/cipd/v1/repo.proto",
}

Repository_ServiceDesc is the grpc.ServiceDesc for Repository service. It's only intended for direct use with grpc.RegisterService, and not to be introspected or modified (even as a copy)

View Source 
var Storage_ServiceDesc = grpc.ServiceDesc{
	ServiceName: "cipd.Storage",
	HandlerType: (*StorageServer)(nil),
	Methods: []grpc.MethodDesc{
		{
			MethodName: "GetObjectURL",
			Handler:    _Storage_GetObjectURL_Handler,
		},
		{
			MethodName: "BeginUpload",
			Handler:    _Storage_BeginUpload_Handler,
		},
		{
			MethodName: "FinishUpload",
			Handler:    _Storage_FinishUpload_Handler,
		},
		{
			MethodName: "CancelUpload",
			Handler:    _Storage_CancelUpload_Handler,
		},
	},
	Streams:  []grpc.StreamDesc{},
	Metadata: "go.chromium.org/luci/cipd/api/cipd/v1/cas.proto",
}

Storage_ServiceDesc is the grpc.ServiceDesc for Storage service. It's only intended for direct use with grpc.RegisterService, and not to be introspected or modified (even as a copy)

Functions

func FileDescriptorSet 

func FileDescriptorSet() *descriptorpb.FileDescriptorSet

FileDescriptorSet returns a descriptor set for this proto package, which includes all defined services, and all transitive dependencies.

Will not return nil.

Do NOT modify the returned descriptor.

func RegisterRepositoryServer 

func RegisterRepositoryServer(s grpc.ServiceRegistrar, srv RepositoryServer)

func RegisterStorageServer 

func RegisterStorageServer(s grpc.ServiceRegistrar, srv StorageServer)

Types

type AccessLogEntry 

type AccessLogEntry struct {
	Method           string   `protobuf:"bytes,1,opt,name=method,proto3" json:"method,omitempty"`                                                 // the RPC method, e.g. "/cipd.Repository/ListPrefix"
	Timestamp        int64    `protobuf:"varint,2,opt,name=timestamp,proto3" json:"timestamp,omitempty"`                                          // microseconds since epoch
	Package          string   `protobuf:"bytes,3,opt,name=package,proto3" json:"package,omitempty"`                                               // CIPD package or package prefix (if known)
	Instance         string   `protobuf:"bytes,4,opt,name=instance,proto3" json:"instance,omitempty"`                                             // CIPD instance ID (if known)
	Version          string   `protobuf:"bytes,5,opt,name=version,proto3" json:"version,omitempty"`                                               // CIPD package version (if known)
	Tags             []string `protobuf:"bytes,6,rep,name=tags,proto3" json:"tags,omitempty"`                                                     // the requested tags (if known)
	Metadata         []string `protobuf:"bytes,7,rep,name=metadata,proto3" json:"metadata,omitempty"`                                             // the requested metadata keys (if known)
	Flags            []string `protobuf:"bytes,8,rep,name=flags,proto3" json:"flags,omitempty"`                                                   // encoding of boolean flags in the request
	CallIdentity     string   `protobuf:"bytes,9,opt,name=call_identity,json=callIdentity,proto3" json:"call_identity,omitempty"`                 // identity used to authorize the call
	PeerIdentity     string   `protobuf:"bytes,10,opt,name=peer_identity,json=peerIdentity,proto3" json:"peer_identity,omitempty"`                // identity of a service that made the RPC
	PeerIp           string   `protobuf:"bytes,11,opt,name=peer_ip,json=peerIp,proto3" json:"peer_ip,omitempty"`                                  // IP address of the caller
	UserAgent        string   `protobuf:"bytes,12,opt,name=user_agent,json=userAgent,proto3" json:"user_agent,omitempty"`                         // value of "User-Agent" header
	ServiceVersion   string   `protobuf:"bytes,13,opt,name=service_version,json=serviceVersion,proto3" json:"service_version,omitempty"`          // GAE app and version that handled the request
	ProcessId        string   `protobuf:"bytes,14,opt,name=process_id,json=processId,proto3" json:"process_id,omitempty"`                         // identifier of the concrete backend process
	RequestId        string   `protobuf:"bytes,15,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`                         // Cloud Trace ID of the request
	AuthDbRev        int64    `protobuf:"varint,16,opt,name=auth_db_rev,json=authDbRev,proto3" json:"auth_db_rev,omitempty"`                      // AuthDB revision used to authorize the call
	ResponseCode     string   `protobuf:"bytes,17,opt,name=response_code,json=responseCode,proto3" json:"response_code,omitempty"`                // canonical gRPC response code (e.g. "OK")
	ResponseErr      string   `protobuf:"bytes,18,opt,name=response_err,json=responseErr,proto3" json:"response_err,omitempty"`                   // the response error message if any
	ResponseTimeUsec int64    `protobuf:"varint,19,opt,name=response_time_usec,json=responseTimeUsec,proto3" json:"response_time_usec,omitempty"` // time spent handling the request in microseconds
	// contains filtered or unexported fields
}

AccessLogEntry defines a schema for `access` BigQuery table with access logs.

This is a best effort log populated using in-memory buffers. Some entries may be dropped if a process crashes before it flushes the buffer.

Field types must be compatible with BigQuery Storage Write API, see https://cloud.google.com/bigquery/docs/write-api#data_type_conversions

func (*AccessLogEntry) Descriptor deprecated 

func (*AccessLogEntry) Descriptor() ([]byte, []int)

Deprecated: Use AccessLogEntry.ProtoReflect.Descriptor instead.

func (*AccessLogEntry) GetAuthDbRev 

func (x *AccessLogEntry) GetAuthDbRev() int64

func (*AccessLogEntry) GetCallIdentity 

func (x *AccessLogEntry) GetCallIdentity() string

func (*AccessLogEntry) GetFlags 

func (x *AccessLogEntry) GetFlags() []string

func (*AccessLogEntry) GetInstance 

func (x *AccessLogEntry) GetInstance() string

func (*AccessLogEntry) GetMetadata 

func (x *AccessLogEntry) GetMetadata() []string

func (*AccessLogEntry) GetMethod 

func (x *AccessLogEntry) GetMethod() string

func (*AccessLogEntry) GetPackage 

func (x *AccessLogEntry) GetPackage() string

func (*AccessLogEntry) GetPeerIdentity 

func (x *AccessLogEntry) GetPeerIdentity() string

func (*AccessLogEntry) GetPeerIp 

func (x *AccessLogEntry) GetPeerIp() string

func (*AccessLogEntry) GetProcessId 

func (x *AccessLogEntry) GetProcessId() string

func (*AccessLogEntry) GetRequestId 

func (x *AccessLogEntry) GetRequestId() string

func (*AccessLogEntry) GetResponseCode 

func (x *AccessLogEntry) GetResponseCode() string

func (*AccessLogEntry) GetResponseErr 

func (x *AccessLogEntry) GetResponseErr() string

func (*AccessLogEntry) GetResponseTimeUsec 

func (x *AccessLogEntry) GetResponseTimeUsec() int64

func (*AccessLogEntry) GetServiceVersion 

func (x *AccessLogEntry) GetServiceVersion() string

func (*AccessLogEntry) GetTags 

func (x *AccessLogEntry) GetTags() []string

func (*AccessLogEntry) GetTimestamp 

func (x *AccessLogEntry) GetTimestamp() int64

func (*AccessLogEntry) GetUserAgent 

func (x *AccessLogEntry) GetUserAgent() string

func (*AccessLogEntry) GetVersion 

func (x *AccessLogEntry) GetVersion() string

func (*AccessLogEntry) ProtoMessage 

func (*AccessLogEntry) ProtoMessage()

func (*AccessLogEntry) ProtoReflect 

func (x *AccessLogEntry) ProtoReflect() protoreflect.Message

func (*AccessLogEntry) Reset 

func (x *AccessLogEntry) Reset()

func (*AccessLogEntry) String 

func (x *AccessLogEntry) String() string

type AttachMetadataRequest 

type AttachMetadataRequest struct {

	// The package that holds the instance we attach metadata to.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The instance we attach metadata to.
	Instance *ObjectRef `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// One or more metadata entries to attach.
	Metadata []*InstanceMetadata `protobuf:"bytes,3,rep,name=metadata,proto3" json:"metadata,omitempty"`
	// contains filtered or unexported fields
}

func (*AttachMetadataRequest) Descriptor deprecated 

func (*AttachMetadataRequest) Descriptor() ([]byte, []int)

Deprecated: Use AttachMetadataRequest.ProtoReflect.Descriptor instead.

func (*AttachMetadataRequest) GetInstance 

func (x *AttachMetadataRequest) GetInstance() *ObjectRef

func (*AttachMetadataRequest) GetMetadata 

func (x *AttachMetadataRequest) GetMetadata() []*InstanceMetadata

func (*AttachMetadataRequest) GetPackage 

func (x *AttachMetadataRequest) GetPackage() string

func (*AttachMetadataRequest) ProtoMessage 

func (*AttachMetadataRequest) ProtoMessage()

func (*AttachMetadataRequest) ProtoReflect 

func (x *AttachMetadataRequest) ProtoReflect() protoreflect.Message

func (*AttachMetadataRequest) Reset 

func (x *AttachMetadataRequest) Reset()

func (*AttachMetadataRequest) String 

func (x *AttachMetadataRequest) String() string

type AttachTagsRequest 

type AttachTagsRequest struct {

	// The package that holds the instance we attach tags to.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The instance we attach tags to.
	Instance *ObjectRef `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// One or more tags to attach (order doesn't matter).
	Tags []*Tag `protobuf:"bytes,3,rep,name=tags,proto3" json:"tags,omitempty"`
	// contains filtered or unexported fields
}

func (*AttachTagsRequest) Descriptor deprecated 

func (*AttachTagsRequest) Descriptor() ([]byte, []int)

Deprecated: Use AttachTagsRequest.ProtoReflect.Descriptor instead.

func (*AttachTagsRequest) GetInstance 

func (x *AttachTagsRequest) GetInstance() *ObjectRef

func (*AttachTagsRequest) GetPackage 

func (x *AttachTagsRequest) GetPackage() string

func (*AttachTagsRequest) GetTags 

func (x *AttachTagsRequest) GetTags() []*Tag

func (*AttachTagsRequest) ProtoMessage 

func (*AttachTagsRequest) ProtoMessage()

func (*AttachTagsRequest) ProtoReflect 

func (x *AttachTagsRequest) ProtoReflect() protoreflect.Message

func (*AttachTagsRequest) Reset 

func (x *AttachTagsRequest) Reset()

func (*AttachTagsRequest) String 

func (x *AttachTagsRequest) String() string

type BeginUploadRequest 

type BeginUploadRequest struct {

	// A reference to the object the client wants to put in the storage, if known.
	//
	// If such object already exists, RPC will finish with ALREADY_EXISTS status
	// right away.
	//
	// If this field is missing (in case the client doesn't know the hash yet),
	// the client MUST supply hash_algo field, to let the backend know what
	// hashing algorithm it should use for calculating object's hash.
	//
	// The calculated hash will be returned back to the client as part of
	// UploadOperation ('object' field) by FinishUpload call.
	Object *ObjectRef `protobuf:"bytes,1,opt,name=object,proto3" json:"object,omitempty"`
	// An algorithm to use to derive object's name during uploads when the final
	// hash of the object is not yet known.
	//
	// Optional if 'object' is present.
	//
	// If both 'object' and 'hash_algo' are present, 'object.hash_algo' MUST match
	// 'hash_algo'.
	HashAlgo HashAlgo `protobuf:"varint,2,opt,name=hash_algo,json=hashAlgo,proto3,enum=cipd.HashAlgo" json:"hash_algo,omitempty"`
	// contains filtered or unexported fields
}

func (*BeginUploadRequest) Descriptor deprecated 

func (*BeginUploadRequest) Descriptor() ([]byte, []int)

Deprecated: Use BeginUploadRequest.ProtoReflect.Descriptor instead.

func (*BeginUploadRequest) GetHashAlgo 

func (x *BeginUploadRequest) GetHashAlgo() HashAlgo

func (*BeginUploadRequest) GetObject 

func (x *BeginUploadRequest) GetObject() *ObjectRef

func (*BeginUploadRequest) ProtoMessage 

func (*BeginUploadRequest) ProtoMessage()

func (*BeginUploadRequest) ProtoReflect 

func (x *BeginUploadRequest) ProtoReflect() protoreflect.Message

func (*BeginUploadRequest) Reset 

func (x *BeginUploadRequest) Reset()

func (*BeginUploadRequest) String 

func (x *BeginUploadRequest) String() string

type CancelUploadRequest 

type CancelUploadRequest struct {

	// An identifier of an upload operation returned by BeginUpload RPC.
	UploadOperationId string `protobuf:"bytes,1,opt,name=upload_operation_id,json=uploadOperationId,proto3" json:"upload_operation_id,omitempty"`
	// contains filtered or unexported fields
}

func (*CancelUploadRequest) Descriptor deprecated 

func (*CancelUploadRequest) Descriptor() ([]byte, []int)

Deprecated: Use CancelUploadRequest.ProtoReflect.Descriptor instead.

func (*CancelUploadRequest) GetUploadOperationId 

func (x *CancelUploadRequest) GetUploadOperationId() string

func (*CancelUploadRequest) ProtoMessage 

func (*CancelUploadRequest) ProtoMessage()

func (*CancelUploadRequest) ProtoReflect 

func (x *CancelUploadRequest) ProtoReflect() protoreflect.Message

func (*CancelUploadRequest) Reset 

func (x *CancelUploadRequest) Reset()

func (*CancelUploadRequest) String 

func (x *CancelUploadRequest) String() string

type DeleteRefRequest 

type DeleteRefRequest struct {

	// Name of the ref, e.g. "latest".
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Name of the package where the ref is defined.
	Package string `protobuf:"bytes,2,opt,name=package,proto3" json:"package,omitempty"`
	// contains filtered or unexported fields
}

func (*DeleteRefRequest) Descriptor deprecated 

func (*DeleteRefRequest) Descriptor() ([]byte, []int)

Deprecated: Use DeleteRefRequest.ProtoReflect.Descriptor instead.

func (*DeleteRefRequest) GetName 

func (x *DeleteRefRequest) GetName() string

func (*DeleteRefRequest) GetPackage 

func (x *DeleteRefRequest) GetPackage() string

func (*DeleteRefRequest) ProtoMessage 

func (*DeleteRefRequest) ProtoMessage()

func (*DeleteRefRequest) ProtoReflect 

func (x *DeleteRefRequest) ProtoReflect() protoreflect.Message

func (*DeleteRefRequest) Reset 

func (x *DeleteRefRequest) Reset()

func (*DeleteRefRequest) String 

func (x *DeleteRefRequest) String() string

type DescribeBootstrapBundleRequest 

type DescribeBootstrapBundleRequest struct {

	// The package prefix that contains the bootstrap packages being described.
	Prefix string `protobuf:"bytes,1,opt,name=prefix,proto3" json:"prefix,omitempty"`
	// If given, specifies exactly what packages to examine.
	//
	// Examined package names will be formed as "<prefix>/<variant>".
	//
	// Based on existing package naming conventions, `variants` usually would be
	// an enumeration of platforms (e.g. ["linux-amd64", "mac-amd64", ...]).
	//
	// If empty, the CIPD backend will describe all packages directly under the
	// prefix (if any). If there are no packages under the prefix, the request
	// fails with NOT_FOUND.
	Variants []string `protobuf:"bytes,2,rep,name=variants,proto3" json:"variants,omitempty"`
	// The package version to describe, see ResolveVersion for details.
	//
	// Applies to all packages matching `prefix` + `variants`.
	//
	// If *all* packages lack this version, the request fails with NOT_FOUND.
	//
	// If only some packages lack this version, their corresponding BootstrapFile
	// entries in DescribeBootstrapBundleRequest will have google.rpc.Status set
	// to NOT_FOUND.
	Version string `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

func (*DescribeBootstrapBundleRequest) Descriptor deprecated 

func (*DescribeBootstrapBundleRequest) Descriptor() ([]byte, []int)

Deprecated: Use DescribeBootstrapBundleRequest.ProtoReflect.Descriptor instead.

func (*DescribeBootstrapBundleRequest) GetPrefix 

func (x *DescribeBootstrapBundleRequest) GetPrefix() string

func (*DescribeBootstrapBundleRequest) GetVariants 

func (x *DescribeBootstrapBundleRequest) GetVariants() []string

func (*DescribeBootstrapBundleRequest) GetVersion 

func (x *DescribeBootstrapBundleRequest) GetVersion() string

func (*DescribeBootstrapBundleRequest) ProtoMessage 

func (*DescribeBootstrapBundleRequest) ProtoMessage()

func (*DescribeBootstrapBundleRequest) ProtoReflect 

func (x *DescribeBootstrapBundleRequest) ProtoReflect() protoreflect.Message

func (*DescribeBootstrapBundleRequest) Reset 

func (x *DescribeBootstrapBundleRequest) Reset()

func (*DescribeBootstrapBundleRequest) String 

func (x *DescribeBootstrapBundleRequest) String() string

type DescribeBootstrapBundleResponse 

type DescribeBootstrapBundleResponse struct {
	Files []*DescribeBootstrapBundleResponse_BootstrapFile `protobuf:"bytes,1,rep,name=files,proto3" json:"files,omitempty"`
	// contains filtered or unexported fields
}

func (*DescribeBootstrapBundleResponse) Descriptor deprecated 

func (*DescribeBootstrapBundleResponse) Descriptor() ([]byte, []int)

Deprecated: Use DescribeBootstrapBundleResponse.ProtoReflect.Descriptor instead.

func (*DescribeBootstrapBundleResponse) GetFiles 

func (x *DescribeBootstrapBundleResponse) GetFiles() []*DescribeBootstrapBundleResponse_BootstrapFile

func (*DescribeBootstrapBundleResponse) ProtoMessage 

func (*DescribeBootstrapBundleResponse) ProtoMessage()

func (*DescribeBootstrapBundleResponse) ProtoReflect 

func (x *DescribeBootstrapBundleResponse) ProtoReflect() protoreflect.Message

func (*DescribeBootstrapBundleResponse) Reset 

func (x *DescribeBootstrapBundleResponse) Reset()

func (*DescribeBootstrapBundleResponse) String 

func (x *DescribeBootstrapBundleResponse) String() string

type DescribeBootstrapBundleResponse_BootstrapFile 

type DescribeBootstrapBundleResponse_BootstrapFile struct {
	Package  string         `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`   // the package the file was extracted from
	Status   *status.Status `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"`     // not OK on errors related to this package
	Instance *ObjectRef     `protobuf:"bytes,3,opt,name=instance,proto3" json:"instance,omitempty"` // the resolved package instance
	File     *ObjectRef     `protobuf:"bytes,4,opt,name=file,proto3" json:"file,omitempty"`         // the extracted file in the CAS
	Name     string         `protobuf:"bytes,5,opt,name=name,proto3" json:"name,omitempty"`         // the name of the extracted file
	Size     int64          `protobuf:"varint,6,opt,name=size,proto3" json:"size,omitempty"`        // its size in bytes
	// contains filtered or unexported fields
}

func (*DescribeBootstrapBundleResponse_BootstrapFile) Descriptor deprecated 

func (*DescribeBootstrapBundleResponse_BootstrapFile) Descriptor() ([]byte, []int)

Deprecated: Use DescribeBootstrapBundleResponse_BootstrapFile.ProtoReflect.Descriptor instead.

func (*DescribeBootstrapBundleResponse_BootstrapFile) GetFile 

func (x *DescribeBootstrapBundleResponse_BootstrapFile) GetFile() *ObjectRef

func (*DescribeBootstrapBundleResponse_BootstrapFile) GetInstance 

func (x *DescribeBootstrapBundleResponse_BootstrapFile) GetInstance() *ObjectRef

func (*DescribeBootstrapBundleResponse_BootstrapFile) GetName 

func (x *DescribeBootstrapBundleResponse_BootstrapFile) GetName() string

func (*DescribeBootstrapBundleResponse_BootstrapFile) GetPackage 

func (x *DescribeBootstrapBundleResponse_BootstrapFile) GetPackage() string

func (*DescribeBootstrapBundleResponse_BootstrapFile) GetSize 

func (x *DescribeBootstrapBundleResponse_BootstrapFile) GetSize() int64

func (*DescribeBootstrapBundleResponse_BootstrapFile) GetStatus 

func (x *DescribeBootstrapBundleResponse_BootstrapFile) GetStatus() *status.Status

func (*DescribeBootstrapBundleResponse_BootstrapFile) ProtoMessage 

func (*DescribeBootstrapBundleResponse_BootstrapFile) ProtoMessage()

func (*DescribeBootstrapBundleResponse_BootstrapFile) ProtoReflect 

func (x *DescribeBootstrapBundleResponse_BootstrapFile) ProtoReflect() protoreflect.Message

func (*DescribeBootstrapBundleResponse_BootstrapFile) Reset 

func (x *DescribeBootstrapBundleResponse_BootstrapFile) Reset()

func (*DescribeBootstrapBundleResponse_BootstrapFile) String 

func (x *DescribeBootstrapBundleResponse_BootstrapFile) String() string

type DescribeClientRequest 

type DescribeClientRequest struct {

	// The CIPD client package we want to get info about.
	//
	// For example 'infra/tools/cipd/linux-amd64'.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The client instance we want to get the info about.
	Instance *ObjectRef `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// contains filtered or unexported fields
}

func (*DescribeClientRequest) Descriptor deprecated 

func (*DescribeClientRequest) Descriptor() ([]byte, []int)

Deprecated: Use DescribeClientRequest.ProtoReflect.Descriptor instead.

func (*DescribeClientRequest) GetInstance 

func (x *DescribeClientRequest) GetInstance() *ObjectRef

func (*DescribeClientRequest) GetPackage 

func (x *DescribeClientRequest) GetPackage() string

func (*DescribeClientRequest) ProtoMessage 

func (*DescribeClientRequest) ProtoMessage()

func (*DescribeClientRequest) ProtoReflect 

func (x *DescribeClientRequest) ProtoReflect() protoreflect.Message

func (*DescribeClientRequest) Reset 

func (x *DescribeClientRequest) Reset()

func (*DescribeClientRequest) String 

func (x *DescribeClientRequest) String() string

type DescribeClientResponse 

type DescribeClientResponse struct {

	// The instance with all output fields filled in.
	Instance *Instance `protobuf:"bytes,1,opt,name=instance,proto3" json:"instance,omitempty"`
	// Reference to the extracted client binary in the storage.
	//
	// The hash algo here always matches the algo used when uploading the client
	// package file.
	//
	// Clients should expect to find an algo here that they do not support (if
	// the server was updated to support a better algo). They should pick the best
	// algo they support from client_ref_aliases list and use it for validation.
	//
	// Thus this field is mostly FYI.
	ClientRef *ObjectRef `protobuf:"bytes,2,opt,name=client_ref,json=clientRef,proto3" json:"client_ref,omitempty"`
	// Signed URL pointing to the extracted client binary in the storage.
	ClientBinary *ObjectURL `protobuf:"bytes,3,opt,name=client_binary,json=clientBinary,proto3" json:"client_binary,omitempty"`
	// Size of the client binary in bytes.
	ClientSize int64 `protobuf:"varint,4,opt,name=client_size,json=clientSize,proto3" json:"client_size,omitempty"`
	// SHA1 digest of the client binary (as hex string).
	//
	// Used only by old clients and present here for backward compatibility
	// reasons.
	//
	// Newer clients must verify one of client_ref_aliases instead.
	LegacySha1 string `protobuf:"bytes,5,opt,name=legacy_sha1,json=legacySha1,proto3" json:"legacy_sha1,omitempty"`
	// Contains hashes of the client binary calculated using ALL algos supported
	// by the server at the time the client package was uploaded.
	//
	// The callers that want to verify the client binary hash should pick the best
	// algo they understand.
	//
	// The list at least includes 'client_ref' itself and SHA1 hash (matching
	// legacy_sha1). The order is undefined.
	ClientRefAliases []*ObjectRef `protobuf:"bytes,6,rep,name=client_ref_aliases,json=clientRefAliases,proto3" json:"client_ref_aliases,omitempty"`
	// contains filtered or unexported fields
}

func (*DescribeClientResponse) Descriptor deprecated 

func (*DescribeClientResponse) Descriptor() ([]byte, []int)

Deprecated: Use DescribeClientResponse.ProtoReflect.Descriptor instead.

func (*DescribeClientResponse) GetClientBinary 

func (x *DescribeClientResponse) GetClientBinary() *ObjectURL

func (*DescribeClientResponse) GetClientRef 

func (x *DescribeClientResponse) GetClientRef() *ObjectRef

func (*DescribeClientResponse) GetClientRefAliases 

func (x *DescribeClientResponse) GetClientRefAliases() []*ObjectRef

func (*DescribeClientResponse) GetClientSize 

func (x *DescribeClientResponse) GetClientSize() int64

func (*DescribeClientResponse) GetInstance 

func (x *DescribeClientResponse) GetInstance() *Instance

func (*DescribeClientResponse) GetLegacySha1 

func (x *DescribeClientResponse) GetLegacySha1() string

func (*DescribeClientResponse) ProtoMessage 

func (*DescribeClientResponse) ProtoMessage()

func (*DescribeClientResponse) ProtoReflect 

func (x *DescribeClientResponse) ProtoReflect() protoreflect.Message

func (*DescribeClientResponse) Reset 

func (x *DescribeClientResponse) Reset()

func (*DescribeClientResponse) String 

func (x *DescribeClientResponse) String() string

type DescribeInstanceRequest 

type DescribeInstanceRequest struct {

	// The package that holds the instance we want to get the info for.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The instance we want to get the info for.
	Instance *ObjectRef `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// Whether the response should include "refs" field.
	DescribeRefs bool `protobuf:"varint,3,opt,name=describe_refs,json=describeRefs,proto3" json:"describe_refs,omitempty"`
	// Whether the response should include "tags" field.
	DescribeTags bool `protobuf:"varint,4,opt,name=describe_tags,json=describeTags,proto3" json:"describe_tags,omitempty"`
	// Whether the response should include "processors" field.
	DescribeProcessors bool `protobuf:"varint,5,opt,name=describe_processors,json=describeProcessors,proto3" json:"describe_processors,omitempty"`
	// Whether the response should include "metadata" field.
	DescribeMetadata bool `protobuf:"varint,6,opt,name=describe_metadata,json=describeMetadata,proto3" json:"describe_metadata,omitempty"`
	// contains filtered or unexported fields
}

func (*DescribeInstanceRequest) Descriptor deprecated 

func (*DescribeInstanceRequest) Descriptor() ([]byte, []int)

Deprecated: Use DescribeInstanceRequest.ProtoReflect.Descriptor instead.

func (*DescribeInstanceRequest) GetDescribeMetadata 

func (x *DescribeInstanceRequest) GetDescribeMetadata() bool

func (*DescribeInstanceRequest) GetDescribeProcessors 

func (x *DescribeInstanceRequest) GetDescribeProcessors() bool

func (*DescribeInstanceRequest) GetDescribeRefs 

func (x *DescribeInstanceRequest) GetDescribeRefs() bool

func (*DescribeInstanceRequest) GetDescribeTags 

func (x *DescribeInstanceRequest) GetDescribeTags() bool

func (*DescribeInstanceRequest) GetInstance 

func (x *DescribeInstanceRequest) GetInstance() *ObjectRef

func (*DescribeInstanceRequest) GetPackage 

func (x *DescribeInstanceRequest) GetPackage() string

func (*DescribeInstanceRequest) ProtoMessage 

func (*DescribeInstanceRequest) ProtoMessage()

func (*DescribeInstanceRequest) ProtoReflect 

func (x *DescribeInstanceRequest) ProtoReflect() protoreflect.Message

func (*DescribeInstanceRequest) Reset 

func (x *DescribeInstanceRequest) Reset()

func (*DescribeInstanceRequest) String 

func (x *DescribeInstanceRequest) String() string

type DescribeInstanceResponse 

type DescribeInstanceResponse struct {

	// The instance with all output fields filled in.
	Instance *Instance `protobuf:"bytes,1,opt,name=instance,proto3" json:"instance,omitempty"`
	// Refs pointing to the instance, sorted by modification time, most recent
	// first.
	//
	// Present only if the request has describe_refs = true.
	Refs []*Ref `protobuf:"bytes,2,rep,name=refs,proto3" json:"refs,omitempty"`
	// Tags attached to the instance, sorted by the tag key first, and then
	// by the timestamp (most recent first).
	//
	// Present only if the request has describe_tags = true.
	Tags []*Tag `protobuf:"bytes,3,rep,name=tags,proto3" json:"tags,omitempty"`
	// State of the processors that handled the instance (if any), sorted by their
	// ID.
	//
	// Present only if the request has describe_processors = true.
	Processors []*Processor `protobuf:"bytes,4,rep,name=processors,proto3" json:"processors,omitempty"`
	// Metadata attached to the instance.
	//
	// Present only if the request has describe_metadata = true.
	Metadata []*InstanceMetadata `protobuf:"bytes,5,rep,name=metadata,proto3" json:"metadata,omitempty"`
	// contains filtered or unexported fields
}

func (*DescribeInstanceResponse) Descriptor deprecated 

func (*DescribeInstanceResponse) Descriptor() ([]byte, []int)

Deprecated: Use DescribeInstanceResponse.ProtoReflect.Descriptor instead.

func (*DescribeInstanceResponse) GetInstance 

func (x *DescribeInstanceResponse) GetInstance() *Instance

func (*DescribeInstanceResponse) GetMetadata 

func (x *DescribeInstanceResponse) GetMetadata() []*InstanceMetadata

func (*DescribeInstanceResponse) GetProcessors 

func (x *DescribeInstanceResponse) GetProcessors() []*Processor

func (*DescribeInstanceResponse) GetRefs 

func (x *DescribeInstanceResponse) GetRefs() []*Ref

func (*DescribeInstanceResponse) GetTags 

func (x *DescribeInstanceResponse) GetTags() []*Tag

func (*DescribeInstanceResponse) ProtoMessage 

func (*DescribeInstanceResponse) ProtoMessage()

func (*DescribeInstanceResponse) ProtoReflect 

func (x *DescribeInstanceResponse) ProtoReflect() protoreflect.Message

func (*DescribeInstanceResponse) Reset 

func (x *DescribeInstanceResponse) Reset()

func (*DescribeInstanceResponse) String 

func (x *DescribeInstanceResponse) String() string

type DetachMetadataRequest 

type DetachMetadataRequest struct {

	// The package that holds the instance we detach metadata from.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The instance we detach metadata from.
	Instance *ObjectRef `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// Entries to detach: only 'fingerprint' or 'key'+'value' are used.
	Metadata []*InstanceMetadata `protobuf:"bytes,3,rep,name=metadata,proto3" json:"metadata,omitempty"`
	// contains filtered or unexported fields
}

func (*DetachMetadataRequest) Descriptor deprecated 

func (*DetachMetadataRequest) Descriptor() ([]byte, []int)

Deprecated: Use DetachMetadataRequest.ProtoReflect.Descriptor instead.

func (*DetachMetadataRequest) GetInstance 

func (x *DetachMetadataRequest) GetInstance() *ObjectRef

func (*DetachMetadataRequest) GetMetadata 

func (x *DetachMetadataRequest) GetMetadata() []*InstanceMetadata

func (*DetachMetadataRequest) GetPackage 

func (x *DetachMetadataRequest) GetPackage() string

func (*DetachMetadataRequest) ProtoMessage 

func (*DetachMetadataRequest) ProtoMessage()

func (*DetachMetadataRequest) ProtoReflect 

func (x *DetachMetadataRequest) ProtoReflect() protoreflect.Message

func (*DetachMetadataRequest) Reset 

func (x *DetachMetadataRequest) Reset()

func (*DetachMetadataRequest) String 

func (x *DetachMetadataRequest) String() string

type DetachTagsRequest 

type DetachTagsRequest struct {

	// The package that holds the instance we detach tags from.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The instance we detach tags from.
	Instance *ObjectRef `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// One or more tags to detach (order doesn't matter).
	Tags []*Tag `protobuf:"bytes,3,rep,name=tags,proto3" json:"tags,omitempty"`
	// contains filtered or unexported fields
}

func (*DetachTagsRequest) Descriptor deprecated 

func (*DetachTagsRequest) Descriptor() ([]byte, []int)

Deprecated: Use DetachTagsRequest.ProtoReflect.Descriptor instead.

func (*DetachTagsRequest) GetInstance 

func (x *DetachTagsRequest) GetInstance() *ObjectRef

func (*DetachTagsRequest) GetPackage 

func (x *DetachTagsRequest) GetPackage() string

func (*DetachTagsRequest) GetTags 

func (x *DetachTagsRequest) GetTags() []*Tag

func (*DetachTagsRequest) ProtoMessage 

func (*DetachTagsRequest) ProtoMessage()

func (*DetachTagsRequest) ProtoReflect 

func (x *DetachTagsRequest) ProtoReflect() protoreflect.Message

func (*DetachTagsRequest) Reset 

func (x *DetachTagsRequest) Reset()

func (*DetachTagsRequest) String 

func (x *DetachTagsRequest) String() string

type Event 

type Event struct {
	Kind EventKind `protobuf:"varint,1,opt,name=kind,proto3,enum=cipd.EventKind" json:"kind,omitempty"`
	Who  string    `protobuf:"bytes,2,opt,name=who,proto3" json:"who,omitempty"` // an identity string, e.g. "user:<email>"
	// Real time is used only for up to millisecond precisions. Nanoseconds are
	// abused to order events emitted by a single transaction.
	When          *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=when,proto3" json:"when,omitempty"`
	Package       string                 `protobuf:"bytes,4,opt,name=package,proto3" json:"package,omitempty"`   // a package name or a prefix (for PREFIX_* events)
	Instance      string                 `protobuf:"bytes,5,opt,name=instance,proto3" json:"instance,omitempty"` // an instance ID for INSTANCE_*
	Ref           string                 `protobuf:"bytes,6,opt,name=ref,proto3" json:"ref,omitempty"`           // a ref name for INSTANCE_REF_*
	Tag           string                 `protobuf:"bytes,7,opt,name=tag,proto3" json:"tag,omitempty"`           // a tag (in 'k:v' form) for INSTANCE_TAG_*
	GrantedRole   []*PrefixMetadata_ACL  `protobuf:"bytes,8,rep,name=granted_role,json=grantedRole,proto3" json:"granted_role,omitempty"`
	RevokedRole   []*PrefixMetadata_ACL  `protobuf:"bytes,9,rep,name=revoked_role,json=revokedRole,proto3" json:"revoked_role,omitempty"`
	MdKey         string                 `protobuf:"bytes,10,opt,name=md_key,json=mdKey,proto3" json:"md_key,omitempty"`                           // a metadata key
	MdValue       string                 `protobuf:"bytes,11,opt,name=md_value,json=mdValue,proto3" json:"md_value,omitempty"`                     // a metadata value, populated only for exported content types
	MdContentType string                 `protobuf:"bytes,12,opt,name=md_content_type,json=mdContentType,proto3" json:"md_content_type,omitempty"` // a metadata content type
	MdFingerprint string                 `protobuf:"bytes,13,opt,name=md_fingerprint,json=mdFingerprint,proto3" json:"md_fingerprint,omitempty"`   // a metadata fingerprint
	// contains filtered or unexported fields
}

Event in a global structured event log.

It exists in both BigQuery (for adhoc queries) and in Datastore (for showing in web UI, e.g. for "recent tags" feature).

Datastore entities contains serialized Event as is, plus a copy of some of its fields for indexing.

func (*Event) Descriptor deprecated 

func (*Event) Descriptor() ([]byte, []int)

Deprecated: Use Event.ProtoReflect.Descriptor instead.

func (*Event) GetGrantedRole 

func (x *Event) GetGrantedRole() []*PrefixMetadata_ACL

func (*Event) GetInstance 

func (x *Event) GetInstance() string

func (*Event) GetKind 

func (x *Event) GetKind() EventKind

func (*Event) GetMdContentType 

func (x *Event) GetMdContentType() string

func (*Event) GetMdFingerprint 

func (x *Event) GetMdFingerprint() string

func (*Event) GetMdKey 

func (x *Event) GetMdKey() string

func (*Event) GetMdValue 

func (x *Event) GetMdValue() string

func (*Event) GetPackage 

func (x *Event) GetPackage() string

func (*Event) GetRef 

func (x *Event) GetRef() string

func (*Event) GetRevokedRole 

func (x *Event) GetRevokedRole() []*PrefixMetadata_ACL

func (*Event) GetTag 

func (x *Event) GetTag() string

func (*Event) GetWhen 

func (x *Event) GetWhen() *timestamppb.Timestamp

func (*Event) GetWho 

func (x *Event) GetWho() string

func (*Event) ProtoMessage 

func (*Event) ProtoMessage()

func (*Event) ProtoReflect 

func (x *Event) ProtoReflect() protoreflect.Message

func (*Event) Reset 

func (x *Event) Reset()

func (*Event) String 

func (x *Event) String() string

type EventKind 

type EventKind int32
const (
	EventKind_EVENT_KIND_UNSPECIFIED EventKind = 0
	// Prefix events: relate to some CIPD prefix.
	EventKind_PREFIX_ACL_CHANGED EventKind = 100
	// Package events: relate to a package (as a whole).
	EventKind_PACKAGE_CREATED  EventKind = 200
	EventKind_PACKAGE_DELETED  EventKind = 201
	EventKind_PACKAGE_HIDDEN   EventKind = 202
	EventKind_PACKAGE_UNHIDDEN EventKind = 203
	// Instance events: relate to a particular package instance.
	EventKind_INSTANCE_CREATED           EventKind = 300
	EventKind_INSTANCE_DELETED           EventKind = 301
	EventKind_INSTANCE_REF_SET           EventKind = 302
	EventKind_INSTANCE_REF_UNSET         EventKind = 303
	EventKind_INSTANCE_TAG_ATTACHED      EventKind = 304
	EventKind_INSTANCE_TAG_DETACHED      EventKind = 305
	EventKind_INSTANCE_METADATA_ATTACHED EventKind = 306
	EventKind_INSTANCE_METADATA_DETACHED EventKind = 307
)

func (EventKind) Descriptor 

func (EventKind) Descriptor() protoreflect.EnumDescriptor

func (EventKind) Enum 

func (x EventKind) Enum() *EventKind

func (EventKind) EnumDescriptor deprecated 

func (EventKind) EnumDescriptor() ([]byte, []int)

Deprecated: Use EventKind.Descriptor instead.

func (EventKind) Number 

func (x EventKind) Number() protoreflect.EnumNumber

func (EventKind) String 

func (x EventKind) String() string

func (EventKind) Type 

func (EventKind) Type() protoreflect.EnumType

type ExportedTag 

type ExportedTag struct {
	Id         string                 `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`                                   // (pkg, inst, id) is full tag key
	Instance   string                 `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`                       // an instance ID, e.g. "AdPcH..."
	Package    string                 `protobuf:"bytes,3,opt,name=package,proto3" json:"package,omitempty"`                         // a package name, e.g. "a/b/c"
	Key        string                 `protobuf:"bytes,4,opt,name=key,proto3" json:"key,omitempty"`                                 // key portion of the tag
	Value      string                 `protobuf:"bytes,5,opt,name=value,proto3" json:"value,omitempty"`                             // value portion of the tag
	AttachedBy string                 `protobuf:"bytes,6,opt,name=attached_by,json=attachedBy,proto3" json:"attached_by,omitempty"` // who added it, "user:<email>"
	AttachedTs *timestamppb.Timestamp `protobuf:"bytes,7,opt,name=attached_ts,json=attachedTs,proto3" json:"attached_ts,omitempty"` // when it was added
	// contains filtered or unexported fields
}

ExportedTag defines a schema for 'exported_tags_<jobid>' BigQuery tables.

It is populated by EXPORT_TAGS_TO_BQ mapper job and can be used for various adhoc analysis of tags.

func (*ExportedTag) Descriptor deprecated 

func (*ExportedTag) Descriptor() ([]byte, []int)

Deprecated: Use ExportedTag.ProtoReflect.Descriptor instead.

func (*ExportedTag) GetAttachedBy 

func (x *ExportedTag) GetAttachedBy() string

func (*ExportedTag) GetAttachedTs 

func (x *ExportedTag) GetAttachedTs() *timestamppb.Timestamp

func (*ExportedTag) GetId 

func (x *ExportedTag) GetId() string

func (*ExportedTag) GetInstance 

func (x *ExportedTag) GetInstance() string

func (*ExportedTag) GetKey 

func (x *ExportedTag) GetKey() string

func (*ExportedTag) GetPackage 

func (x *ExportedTag) GetPackage() string

func (*ExportedTag) GetValue 

func (x *ExportedTag) GetValue() string

func (*ExportedTag) ProtoMessage 

func (*ExportedTag) ProtoMessage()

func (*ExportedTag) ProtoReflect 

func (x *ExportedTag) ProtoReflect() protoreflect.Message

func (*ExportedTag) Reset 

func (x *ExportedTag) Reset()

func (*ExportedTag) String 

func (x *ExportedTag) String() string

type FinishUploadRequest 

type FinishUploadRequest struct {

	// An identifier of an upload operation returned by BeginUpload RPC.
	UploadOperationId string `protobuf:"bytes,1,opt,name=upload_operation_id,json=uploadOperationId,proto3" json:"upload_operation_id,omitempty"`
	// If set, instructs Storage to skip the hash verification and just assume the
	// uploaded object has the given hash.
	//
	// This is used internally by the service as an optimization for cases when
	// it trusts the uploaded data (for example, when it upload it itself).
	//
	// External callers are denied usage of this field. Attempt to use it results
	// in PERMISSION_DENIED.
	ForceHash *ObjectRef `protobuf:"bytes,2,opt,name=force_hash,json=forceHash,proto3" json:"force_hash,omitempty"`
	// contains filtered or unexported fields
}

func (*FinishUploadRequest) Descriptor deprecated 

func (*FinishUploadRequest) Descriptor() ([]byte, []int)

Deprecated: Use FinishUploadRequest.ProtoReflect.Descriptor instead.

func (*FinishUploadRequest) GetForceHash 

func (x *FinishUploadRequest) GetForceHash() *ObjectRef

func (*FinishUploadRequest) GetUploadOperationId 

func (x *FinishUploadRequest) GetUploadOperationId() string

func (*FinishUploadRequest) ProtoMessage 

func (*FinishUploadRequest) ProtoMessage()

func (*FinishUploadRequest) ProtoReflect 

func (x *FinishUploadRequest) ProtoReflect() protoreflect.Message

func (*FinishUploadRequest) Reset 

func (x *FinishUploadRequest) Reset()

func (*FinishUploadRequest) String 

func (x *FinishUploadRequest) String() string

type GetInstanceURLRequest 

type GetInstanceURLRequest struct {

	// The package that holds the instance we want to get URL of.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The instance we want to get URL of.
	Instance *ObjectRef `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// contains filtered or unexported fields
}

func (*GetInstanceURLRequest) Descriptor deprecated 

func (*GetInstanceURLRequest) Descriptor() ([]byte, []int)

Deprecated: Use GetInstanceURLRequest.ProtoReflect.Descriptor instead.

func (*GetInstanceURLRequest) GetInstance 

func (x *GetInstanceURLRequest) GetInstance() *ObjectRef

func (*GetInstanceURLRequest) GetPackage 

func (x *GetInstanceURLRequest) GetPackage() string

func (*GetInstanceURLRequest) ProtoMessage 

func (*GetInstanceURLRequest) ProtoMessage()

func (*GetInstanceURLRequest) ProtoReflect 

func (x *GetInstanceURLRequest) ProtoReflect() protoreflect.Message

func (*GetInstanceURLRequest) Reset 

func (x *GetInstanceURLRequest) Reset()

func (*GetInstanceURLRequest) String 

func (x *GetInstanceURLRequest) String() string

type GetObjectURLRequest 

type GetObjectURLRequest struct {

	// A reference to the object the client wants to fetch.
	Object *ObjectRef `protobuf:"bytes,1,opt,name=object,proto3" json:"object,omitempty"`
	// If present, the returned URL will be served with Content-Disposition header
	// that includes the given filename. It makes browsers save the file under the
	// given name.
	DownloadFilename string `protobuf:"bytes,2,opt,name=download_filename,json=downloadFilename,proto3" json:"download_filename,omitempty"`
	// contains filtered or unexported fields
}

func (*GetObjectURLRequest) Descriptor deprecated 

func (*GetObjectURLRequest) Descriptor() ([]byte, []int)

Deprecated: Use GetObjectURLRequest.ProtoReflect.Descriptor instead.

func (*GetObjectURLRequest) GetDownloadFilename 

func (x *GetObjectURLRequest) GetDownloadFilename() string

func (*GetObjectURLRequest) GetObject 

func (x *GetObjectURLRequest) GetObject() *ObjectRef

func (*GetObjectURLRequest) ProtoMessage 

func (*GetObjectURLRequest) ProtoMessage()

func (*GetObjectURLRequest) ProtoReflect 

func (x *GetObjectURLRequest) ProtoReflect() protoreflect.Message

func (*GetObjectURLRequest) Reset 

func (x *GetObjectURLRequest) Reset()

func (*GetObjectURLRequest) String 

func (x *GetObjectURLRequest) String() string

type HashAlgo 

type HashAlgo int32

Supported hashing algorithms used by the content-addressable storage.

Literal names are important, since they are used to construct Google Storage paths internally. 

const (
	HashAlgo_HASH_ALGO_UNSPECIFIED HashAlgo = 0
	HashAlgo_SHA1                  HashAlgo = 1
	HashAlgo_SHA256                HashAlgo = 2
)

func (HashAlgo) Descriptor 

func (HashAlgo) Descriptor() protoreflect.EnumDescriptor

func (HashAlgo) Enum 

func (x HashAlgo) Enum() *HashAlgo

func (HashAlgo) EnumDescriptor deprecated 

func (HashAlgo) EnumDescriptor() ([]byte, []int)

Deprecated: Use HashAlgo.Descriptor instead.

func (HashAlgo) Number 

func (x HashAlgo) Number() protoreflect.EnumNumber

func (HashAlgo) String 

func (x HashAlgo) String() string

func (HashAlgo) Type 

func (HashAlgo) Type() protoreflect.EnumType

type InheritedPrefixMetadata 

type InheritedPrefixMetadata struct {

	// Per-prefix metadata that applies to a prefix, ordered by prefix length.
	//
	// For example, when requesting metadata for prefix "a/b/c/d" the reply may
	// contain entries for "a", "a/b", "a/b/c/d" (in that order, with "a/b/c"
	// skipped in this example as not having any metadata attached).
	PerPrefixMetadata []*PrefixMetadata `protobuf:"bytes,1,rep,name=per_prefix_metadata,json=perPrefixMetadata,proto3" json:"per_prefix_metadata,omitempty"`
	// contains filtered or unexported fields
}

func (*InheritedPrefixMetadata) Descriptor deprecated 

func (*InheritedPrefixMetadata) Descriptor() ([]byte, []int)

Deprecated: Use InheritedPrefixMetadata.ProtoReflect.Descriptor instead.

func (*InheritedPrefixMetadata) GetPerPrefixMetadata 

func (x *InheritedPrefixMetadata) GetPerPrefixMetadata() []*PrefixMetadata

func (*InheritedPrefixMetadata) ProtoMessage 

func (*InheritedPrefixMetadata) ProtoMessage()

func (*InheritedPrefixMetadata) ProtoReflect 

func (x *InheritedPrefixMetadata) ProtoReflect() protoreflect.Message

func (*InheritedPrefixMetadata) Reset 

func (x *InheritedPrefixMetadata) Reset()

func (*InheritedPrefixMetadata) String 

func (x *InheritedPrefixMetadata) String() string

type Instance 

type Instance struct {

	// A name of the package, e.g. "a/b/c/d".
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// A reference to the instance file in the storage.
	Instance *ObjectRef `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// User who registered the instance (output only).
	RegisteredBy string `protobuf:"bytes,3,opt,name=registered_by,json=registeredBy,proto3" json:"registered_by,omitempty"`
	// When the instance was registered (output only).
	RegisteredTs *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=registered_ts,json=registeredTs,proto3" json:"registered_ts,omitempty"`
	// contains filtered or unexported fields
}

Instance is a pointer to an instance of some package.

func (*Instance) Descriptor deprecated 

func (*Instance) Descriptor() ([]byte, []int)

Deprecated: Use Instance.ProtoReflect.Descriptor instead.

func (*Instance) GetInstance 

func (x *Instance) GetInstance() *ObjectRef

func (*Instance) GetPackage 

func (x *Instance) GetPackage() string

func (*Instance) GetRegisteredBy 

func (x *Instance) GetRegisteredBy() string

func (*Instance) GetRegisteredTs 

func (x *Instance) GetRegisteredTs() *timestamppb.Timestamp

func (*Instance) ProtoMessage 

func (*Instance) ProtoMessage()

func (*Instance) ProtoReflect 

func (x *Instance) ProtoReflect() protoreflect.Message

func (*Instance) Reset 

func (x *Instance) Reset()

func (*Instance) String 

func (x *Instance) String() string

type InstanceMetadata 

type InstanceMetadata struct {

	// Key is a lowercase string matching [a-z0-9_\-]{1,400}.
	Key string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
	// Value is an arbitrary byte blob smaller than 512 Kb.
	Value []byte `protobuf:"bytes,2,opt,name=value,proto3" json:"value,omitempty"`
	// Optional MIME content type of the metadata value, primarily for UI.
	ContentType string `protobuf:"bytes,3,opt,name=content_type,json=contentType,proto3" json:"content_type,omitempty"`
	// Fingerprint identifies this metadata entry.
	//
	// It is the first 16 bytes of SHA256("<key>:<value>") in lowercase hex
	// encoding (i.e. it is 32 lowercase hex characters).
	//
	// Populated by the server in all responses. Ignored in AttachMetadataRequest,
	// optionally used in DetachMetadataRequest.
	Fingerprint string `protobuf:"bytes,4,opt,name=fingerprint,proto3" json:"fingerprint,omitempty"`
	// User that attached this metadata (output only).
	AttachedBy string `protobuf:"bytes,5,opt,name=attached_by,json=attachedBy,proto3" json:"attached_by,omitempty"`
	// When the metadata was attached (output only).
	AttachedTs *timestamppb.Timestamp `protobuf:"bytes,6,opt,name=attached_ts,json=attachedTs,proto3" json:"attached_ts,omitempty"`
	// contains filtered or unexported fields
}

func (*InstanceMetadata) Descriptor deprecated 

func (*InstanceMetadata) Descriptor() ([]byte, []int)

Deprecated: Use InstanceMetadata.ProtoReflect.Descriptor instead.

func (*InstanceMetadata) GetAttachedBy 

func (x *InstanceMetadata) GetAttachedBy() string

func (*InstanceMetadata) GetAttachedTs 

func (x *InstanceMetadata) GetAttachedTs() *timestamppb.Timestamp

func (*InstanceMetadata) GetContentType 

func (x *InstanceMetadata) GetContentType() string

func (*InstanceMetadata) GetFingerprint 

func (x *InstanceMetadata) GetFingerprint() string

func (*InstanceMetadata) GetKey 

func (x *InstanceMetadata) GetKey() string

func (*InstanceMetadata) GetValue 

func (x *InstanceMetadata) GetValue() []byte

func (*InstanceMetadata) ProtoMessage 

func (*InstanceMetadata) ProtoMessage()

func (*InstanceMetadata) ProtoReflect 

func (x *InstanceMetadata) ProtoReflect() protoreflect.Message

func (*InstanceMetadata) Reset 

func (x *InstanceMetadata) Reset()

func (*InstanceMetadata) String 

func (x *InstanceMetadata) String() string

type ListInstancesRequest 

type ListInstancesRequest struct {

	// Name of a package to list instances of.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// Number of instances to return on one page, default is 100.
	PageSize int32 `protobuf:"varint,20,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Value of 'next_page_token' from the previous response.
	//
	// Can be used to resume fetching.
	PageToken string `protobuf:"bytes,21,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// contains filtered or unexported fields
}

func (*ListInstancesRequest) Descriptor deprecated 

func (*ListInstancesRequest) Descriptor() ([]byte, []int)

Deprecated: Use ListInstancesRequest.ProtoReflect.Descriptor instead.

func (*ListInstancesRequest) GetPackage 

func (x *ListInstancesRequest) GetPackage() string

func (*ListInstancesRequest) GetPageSize 

func (x *ListInstancesRequest) GetPageSize() int32

func (*ListInstancesRequest) GetPageToken 

func (x *ListInstancesRequest) GetPageToken() string

func (*ListInstancesRequest) ProtoMessage 

func (*ListInstancesRequest) ProtoMessage()

func (*ListInstancesRequest) ProtoReflect 

func (x *ListInstancesRequest) ProtoReflect() protoreflect.Message

func (*ListInstancesRequest) Reset 

func (x *ListInstancesRequest) Reset()

func (*ListInstancesRequest) String 

func (x *ListInstancesRequest) String() string

type ListInstancesResponse 

type ListInstancesResponse struct {

	// Package instances, sorted by registration time, most recent first.
	Instances []*Instance `protobuf:"bytes,1,rep,name=instances,proto3" json:"instances,omitempty"`
	// Value to pass as 'page_token' in ListInstancesRequest to resume fetching or
	// empty string if there's no more results.
	NextPageToken string `protobuf:"bytes,20,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// contains filtered or unexported fields
}

func (*ListInstancesResponse) Descriptor deprecated 

func (*ListInstancesResponse) Descriptor() ([]byte, []int)

Deprecated: Use ListInstancesResponse.ProtoReflect.Descriptor instead.

func (*ListInstancesResponse) GetInstances 

func (x *ListInstancesResponse) GetInstances() []*Instance

func (*ListInstancesResponse) GetNextPageToken 

func (x *ListInstancesResponse) GetNextPageToken() string

func (*ListInstancesResponse) ProtoMessage 

func (*ListInstancesResponse) ProtoMessage()

func (*ListInstancesResponse) ProtoReflect 

func (x *ListInstancesResponse) ProtoReflect() protoreflect.Message

func (*ListInstancesResponse) Reset 

func (x *ListInstancesResponse) Reset()

func (*ListInstancesResponse) String 

func (x *ListInstancesResponse) String() string

type ListMetadataRequest 

type ListMetadataRequest struct {

	// The package that holds the instance we list metadata of.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The instance to list metadata of.
	Instance *ObjectRef `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// Metadata keys to limit the listing to or empty to list all metadata.
	Keys []string `protobuf:"bytes,3,rep,name=keys,proto3" json:"keys,omitempty"`
	// Number of results to return on one page. Ignored for now.
	PageSize int32 `protobuf:"varint,20,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Value of 'next_page_token' from the previous response.
	PageToken string `protobuf:"bytes,21,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// contains filtered or unexported fields
}

func (*ListMetadataRequest) Descriptor deprecated 

func (*ListMetadataRequest) Descriptor() ([]byte, []int)

Deprecated: Use ListMetadataRequest.ProtoReflect.Descriptor instead.

func (*ListMetadataRequest) GetInstance 

func (x *ListMetadataRequest) GetInstance() *ObjectRef

func (*ListMetadataRequest) GetKeys 

func (x *ListMetadataRequest) GetKeys() []string

func (*ListMetadataRequest) GetPackage 

func (x *ListMetadataRequest) GetPackage() string

func (*ListMetadataRequest) GetPageSize 

func (x *ListMetadataRequest) GetPageSize() int32

func (*ListMetadataRequest) GetPageToken 

func (x *ListMetadataRequest) GetPageToken() string

func (*ListMetadataRequest) ProtoMessage 

func (*ListMetadataRequest) ProtoMessage()

func (*ListMetadataRequest) ProtoReflect 

func (x *ListMetadataRequest) ProtoReflect() protoreflect.Message

func (*ListMetadataRequest) Reset 

func (x *ListMetadataRequest) Reset()

func (*ListMetadataRequest) String 

func (x *ListMetadataRequest) String() string

type ListMetadataResponse 

type ListMetadataResponse struct {

	// Discovered metadata ordered by 'attached_ts' (the most recent first).
	Metadata []*InstanceMetadata `protobuf:"bytes,1,rep,name=metadata,proto3" json:"metadata,omitempty"`
	// Value to pass as 'page_token' in ListMetadataRequest to resume fetching or
	// an empty string if there's no more results.
	NextPageToken string `protobuf:"bytes,20,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// contains filtered or unexported fields
}

func (*ListMetadataResponse) Descriptor deprecated 

func (*ListMetadataResponse) Descriptor() ([]byte, []int)

Deprecated: Use ListMetadataResponse.ProtoReflect.Descriptor instead.

func (*ListMetadataResponse) GetMetadata 

func (x *ListMetadataResponse) GetMetadata() []*InstanceMetadata

func (*ListMetadataResponse) GetNextPageToken 

func (x *ListMetadataResponse) GetNextPageToken() string

func (*ListMetadataResponse) ProtoMessage 

func (*ListMetadataResponse) ProtoMessage()

func (*ListMetadataResponse) ProtoReflect 

func (x *ListMetadataResponse) ProtoReflect() protoreflect.Message

func (*ListMetadataResponse) Reset 

func (x *ListMetadataResponse) Reset()

func (*ListMetadataResponse) String 

func (x *ListMetadataResponse) String() string

type ListPrefixRequest 

type ListPrefixRequest struct {

	// A prefix within the repository to list, e.g. "a/b/c". Empty prefix is also
	// accepted: it means "root of the repository".
	Prefix string `protobuf:"bytes,1,opt,name=prefix,proto3" json:"prefix,omitempty"`
	// If false, list only direct descendants of the prefix, otherwise all.
	Recursive bool `protobuf:"varint,2,opt,name=recursive,proto3" json:"recursive,omitempty"`
	// If true, include hidden packages in the result.
	IncludeHidden bool `protobuf:"varint,3,opt,name=include_hidden,json=includeHidden,proto3" json:"include_hidden,omitempty"`
	// contains filtered or unexported fields
}

func (*ListPrefixRequest) Descriptor deprecated 

func (*ListPrefixRequest) Descriptor() ([]byte, []int)

Deprecated: Use ListPrefixRequest.ProtoReflect.Descriptor instead.

func (*ListPrefixRequest) GetIncludeHidden 

func (x *ListPrefixRequest) GetIncludeHidden() bool

func (*ListPrefixRequest) GetPrefix 

func (x *ListPrefixRequest) GetPrefix() string

func (*ListPrefixRequest) GetRecursive 

func (x *ListPrefixRequest) GetRecursive() bool

func (*ListPrefixRequest) ProtoMessage 

func (*ListPrefixRequest) ProtoMessage()

func (*ListPrefixRequest) ProtoReflect 

func (x *ListPrefixRequest) ProtoReflect() protoreflect.Message

func (*ListPrefixRequest) Reset 

func (x *ListPrefixRequest) Reset()

func (*ListPrefixRequest) String 

func (x *ListPrefixRequest) String() string

type ListPrefixResponse 

type ListPrefixResponse struct {

	// Lexicographically sorted list of full packages names.
	Packages []string `protobuf:"bytes,1,rep,name=packages,proto3" json:"packages,omitempty"`
	// Lexicographically sorted list of child prefixes (without trailing '/').
	Prefixes []string `protobuf:"bytes,2,rep,name=prefixes,proto3" json:"prefixes,omitempty"`
	// contains filtered or unexported fields
}

func (*ListPrefixResponse) Descriptor deprecated 

func (*ListPrefixResponse) Descriptor() ([]byte, []int)

Deprecated: Use ListPrefixResponse.ProtoReflect.Descriptor instead.

func (*ListPrefixResponse) GetPackages 

func (x *ListPrefixResponse) GetPackages() []string

func (*ListPrefixResponse) GetPrefixes 

func (x *ListPrefixResponse) GetPrefixes() []string

func (*ListPrefixResponse) ProtoMessage 

func (*ListPrefixResponse) ProtoMessage()

func (*ListPrefixResponse) ProtoReflect 

func (x *ListPrefixResponse) ProtoReflect() protoreflect.Message

func (*ListPrefixResponse) Reset 

func (x *ListPrefixResponse) Reset()

func (*ListPrefixResponse) String 

func (x *ListPrefixResponse) String() string

type ListRefsRequest 

type ListRefsRequest struct {

	// Name of a package to list refs of.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// contains filtered or unexported fields
}

func (*ListRefsRequest) Descriptor deprecated 

func (*ListRefsRequest) Descriptor() ([]byte, []int)

Deprecated: Use ListRefsRequest.ProtoReflect.Descriptor instead.

func (*ListRefsRequest) GetPackage 

func (x *ListRefsRequest) GetPackage() string

func (*ListRefsRequest) ProtoMessage 

func (*ListRefsRequest) ProtoMessage()

func (*ListRefsRequest) ProtoReflect 

func (x *ListRefsRequest) ProtoReflect() protoreflect.Message

func (*ListRefsRequest) Reset 

func (x *ListRefsRequest) Reset()

func (*ListRefsRequest) String 

func (x *ListRefsRequest) String() string

type ListRefsResponse 

type ListRefsResponse struct {

	// Package refs, sorted by modification time, most recently touched first.
	Refs []*Ref `protobuf:"bytes,1,rep,name=refs,proto3" json:"refs,omitempty"`
	// contains filtered or unexported fields
}

func (*ListRefsResponse) Descriptor deprecated 

func (*ListRefsResponse) Descriptor() ([]byte, []int)

Deprecated: Use ListRefsResponse.ProtoReflect.Descriptor instead.

func (*ListRefsResponse) GetRefs 

func (x *ListRefsResponse) GetRefs() []*Ref

func (*ListRefsResponse) ProtoMessage 

func (*ListRefsResponse) ProtoMessage()

func (*ListRefsResponse) ProtoReflect 

func (x *ListRefsResponse) ProtoReflect() protoreflect.Message

func (*ListRefsResponse) Reset 

func (x *ListRefsResponse) Reset()

func (*ListRefsResponse) String 

func (x *ListRefsResponse) String() string

type MockRepositoryClient 

type MockRepositoryClient struct {
	// contains filtered or unexported fields
}

MockRepositoryClient is a mock of RepositoryClient interface.

func NewMockRepositoryClient 

func NewMockRepositoryClient(ctrl *gomock.Controller) *MockRepositoryClient

NewMockRepositoryClient creates a new mock instance.

func (*MockRepositoryClient) AttachMetadata 

func (m *MockRepositoryClient) AttachMetadata(ctx context.Context, in *AttachMetadataRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)

AttachMetadata mocks base method.

func (*MockRepositoryClient) AttachTags 

func (m *MockRepositoryClient) AttachTags(ctx context.Context, in *AttachTagsRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)

AttachTags mocks base method.

func (*MockRepositoryClient) CreateRef 

func (m *MockRepositoryClient) CreateRef(ctx context.Context, in *Ref, opts ...grpc.CallOption) (*emptypb.Empty, error)

CreateRef mocks base method.

func (*MockRepositoryClient) DeletePackage 

func (m *MockRepositoryClient) DeletePackage(ctx context.Context, in *PackageRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)

DeletePackage mocks base method.

func (*MockRepositoryClient) DeleteRef 

func (m *MockRepositoryClient) DeleteRef(ctx context.Context, in *DeleteRefRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)

DeleteRef mocks base method.

func (*MockRepositoryClient) DescribeBootstrapBundle 

func (m *MockRepositoryClient) DescribeBootstrapBundle(ctx context.Context, in *DescribeBootstrapBundleRequest, opts ...grpc.CallOption) (*DescribeBootstrapBundleResponse, error)

DescribeBootstrapBundle mocks base method.

func (*MockRepositoryClient) DescribeClient 

func (m *MockRepositoryClient) DescribeClient(ctx context.Context, in *DescribeClientRequest, opts ...grpc.CallOption) (*DescribeClientResponse, error)

DescribeClient mocks base method.

func (*MockRepositoryClient) DescribeInstance 

func (m *MockRepositoryClient) DescribeInstance(ctx context.Context, in *DescribeInstanceRequest, opts ...grpc.CallOption) (*DescribeInstanceResponse, error)

DescribeInstance mocks base method.

func (*MockRepositoryClient) DetachMetadata 

func (m *MockRepositoryClient) DetachMetadata(ctx context.Context, in *DetachMetadataRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)

DetachMetadata mocks base method.

func (*MockRepositoryClient) DetachTags 

func (m *MockRepositoryClient) DetachTags(ctx context.Context, in *DetachTagsRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)

DetachTags mocks base method.

func (*MockRepositoryClient) EXPECT 

func (m *MockRepositoryClient) EXPECT() *MockRepositoryClientMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockRepositoryClient) GetInheritedPrefixMetadata 

func (m *MockRepositoryClient) GetInheritedPrefixMetadata(ctx context.Context, in *PrefixRequest, opts ...grpc.CallOption) (*InheritedPrefixMetadata, error)

GetInheritedPrefixMetadata mocks base method.

func (*MockRepositoryClient) GetInstanceURL 

func (m *MockRepositoryClient) GetInstanceURL(ctx context.Context, in *GetInstanceURLRequest, opts ...grpc.CallOption) (*ObjectURL, error)

GetInstanceURL mocks base method.

func (*MockRepositoryClient) GetPrefixMetadata 

func (m *MockRepositoryClient) GetPrefixMetadata(ctx context.Context, in *PrefixRequest, opts ...grpc.CallOption) (*PrefixMetadata, error)

GetPrefixMetadata mocks base method.

func (*MockRepositoryClient) GetRolesInPrefix 

func (m *MockRepositoryClient) GetRolesInPrefix(ctx context.Context, in *PrefixRequest, opts ...grpc.CallOption) (*RolesInPrefixResponse, error)

GetRolesInPrefix mocks base method.

func (*MockRepositoryClient) GetRolesInPrefixOnBehalfOf 

func (m *MockRepositoryClient) GetRolesInPrefixOnBehalfOf(ctx context.Context, in *PrefixRequestOnBehalfOf, opts ...grpc.CallOption) (*RolesInPrefixResponse, error)

GetRolesInPrefixOnBehalfOf mocks base method.

func (*MockRepositoryClient) HidePackage 

func (m *MockRepositoryClient) HidePackage(ctx context.Context, in *PackageRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)

HidePackage mocks base method.

func (*MockRepositoryClient) ListInstances 

func (m *MockRepositoryClient) ListInstances(ctx context.Context, in *ListInstancesRequest, opts ...grpc.CallOption) (*ListInstancesResponse, error)

ListInstances mocks base method.

func (*MockRepositoryClient) ListMetadata 

func (m *MockRepositoryClient) ListMetadata(ctx context.Context, in *ListMetadataRequest, opts ...grpc.CallOption) (*ListMetadataResponse, error)

ListMetadata mocks base method.

func (*MockRepositoryClient) ListPrefix 

func (m *MockRepositoryClient) ListPrefix(ctx context.Context, in *ListPrefixRequest, opts ...grpc.CallOption) (*ListPrefixResponse, error)

ListPrefix mocks base method.

func (*MockRepositoryClient) ListRefs 

func (m *MockRepositoryClient) ListRefs(ctx context.Context, in *ListRefsRequest, opts ...grpc.CallOption) (*ListRefsResponse, error)

ListRefs mocks base method.

func (*MockRepositoryClient) RegisterInstance 

func (m *MockRepositoryClient) RegisterInstance(ctx context.Context, in *Instance, opts ...grpc.CallOption) (*RegisterInstanceResponse, error)

RegisterInstance mocks base method.

func (*MockRepositoryClient) ResolveVersion 

func (m *MockRepositoryClient) ResolveVersion(ctx context.Context, in *ResolveVersionRequest, opts ...grpc.CallOption) (*Instance, error)

ResolveVersion mocks base method.

func (*MockRepositoryClient) SearchInstances 

func (m *MockRepositoryClient) SearchInstances(ctx context.Context, in *SearchInstancesRequest, opts ...grpc.CallOption) (*SearchInstancesResponse, error)

SearchInstances mocks base method.

func (*MockRepositoryClient) UnhidePackage 

func (m *MockRepositoryClient) UnhidePackage(ctx context.Context, in *PackageRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)

UnhidePackage mocks base method.

func (*MockRepositoryClient) UpdatePrefixMetadata 

func (m *MockRepositoryClient) UpdatePrefixMetadata(ctx context.Context, in *PrefixMetadata, opts ...grpc.CallOption) (*PrefixMetadata, error)

UpdatePrefixMetadata mocks base method.

type MockRepositoryClientMockRecorder 

type MockRepositoryClientMockRecorder struct {
	// contains filtered or unexported fields
}

MockRepositoryClientMockRecorder is the mock recorder for MockRepositoryClient.

func (*MockRepositoryClientMockRecorder) AttachMetadata 

func (mr *MockRepositoryClientMockRecorder) AttachMetadata(ctx, in interface{}, opts ...interface{}) *gomock.Call

AttachMetadata indicates an expected call of AttachMetadata.

func (*MockRepositoryClientMockRecorder) AttachTags 

func (mr *MockRepositoryClientMockRecorder) AttachTags(ctx, in interface{}, opts ...interface{}) *gomock.Call

AttachTags indicates an expected call of AttachTags.

func (*MockRepositoryClientMockRecorder) CreateRef 

func (mr *MockRepositoryClientMockRecorder) CreateRef(ctx, in interface{}, opts ...interface{}) *gomock.Call

CreateRef indicates an expected call of CreateRef.

func (*MockRepositoryClientMockRecorder) DeletePackage 

func (mr *MockRepositoryClientMockRecorder) DeletePackage(ctx, in interface{}, opts ...interface{}) *gomock.Call

DeletePackage indicates an expected call of DeletePackage.

func (*MockRepositoryClientMockRecorder) DeleteRef 

func (mr *MockRepositoryClientMockRecorder) DeleteRef(ctx, in interface{}, opts ...interface{}) *gomock.Call

DeleteRef indicates an expected call of DeleteRef.

func (*MockRepositoryClientMockRecorder) DescribeBootstrapBundle 

func (mr *MockRepositoryClientMockRecorder) DescribeBootstrapBundle(ctx, in interface{}, opts ...interface{}) *gomock.Call

DescribeBootstrapBundle indicates an expected call of DescribeBootstrapBundle.

func (*MockRepositoryClientMockRecorder) DescribeClient 

func (mr *MockRepositoryClientMockRecorder) DescribeClient(ctx, in interface{}, opts ...interface{}) *gomock.Call

DescribeClient indicates an expected call of DescribeClient.

func (*MockRepositoryClientMockRecorder) DescribeInstance 

func (mr *MockRepositoryClientMockRecorder) DescribeInstance(ctx, in interface{}, opts ...interface{}) *gomock.Call

DescribeInstance indicates an expected call of DescribeInstance.

func (*MockRepositoryClientMockRecorder) DetachMetadata 

func (mr *MockRepositoryClientMockRecorder) DetachMetadata(ctx, in interface{}, opts ...interface{}) *gomock.Call

DetachMetadata indicates an expected call of DetachMetadata.

func (*MockRepositoryClientMockRecorder) DetachTags 

func (mr *MockRepositoryClientMockRecorder) DetachTags(ctx, in interface{}, opts ...interface{}) *gomock.Call

DetachTags indicates an expected call of DetachTags.

func (*MockRepositoryClientMockRecorder) GetInheritedPrefixMetadata 

func (mr *MockRepositoryClientMockRecorder) GetInheritedPrefixMetadata(ctx, in interface{}, opts ...interface{}) *gomock.Call

GetInheritedPrefixMetadata indicates an expected call of GetInheritedPrefixMetadata.

func (*MockRepositoryClientMockRecorder) GetInstanceURL 

func (mr *MockRepositoryClientMockRecorder) GetInstanceURL(ctx, in interface{}, opts ...interface{}) *gomock.Call

GetInstanceURL indicates an expected call of GetInstanceURL.

func (*MockRepositoryClientMockRecorder) GetPrefixMetadata 

func (mr *MockRepositoryClientMockRecorder) GetPrefixMetadata(ctx, in interface{}, opts ...interface{}) *gomock.Call

GetPrefixMetadata indicates an expected call of GetPrefixMetadata.

func (*MockRepositoryClientMockRecorder) GetRolesInPrefix 

func (mr *MockRepositoryClientMockRecorder) GetRolesInPrefix(ctx, in interface{}, opts ...interface{}) *gomock.Call

GetRolesInPrefix indicates an expected call of GetRolesInPrefix.

func (*MockRepositoryClientMockRecorder) GetRolesInPrefixOnBehalfOf 

func (mr *MockRepositoryClientMockRecorder) GetRolesInPrefixOnBehalfOf(ctx, in interface{}, opts ...interface{}) *gomock.Call

GetRolesInPrefixOnBehalfOf indicates an expected call of GetRolesInPrefixOnBehalfOf.

func (*MockRepositoryClientMockRecorder) HidePackage 

func (mr *MockRepositoryClientMockRecorder) HidePackage(ctx, in interface{}, opts ...interface{}) *gomock.Call

HidePackage indicates an expected call of HidePackage.

func (*MockRepositoryClientMockRecorder) ListInstances 

func (mr *MockRepositoryClientMockRecorder) ListInstances(ctx, in interface{}, opts ...interface{}) *gomock.Call

ListInstances indicates an expected call of ListInstances.

func (*MockRepositoryClientMockRecorder) ListMetadata 

func (mr *MockRepositoryClientMockRecorder) ListMetadata(ctx, in interface{}, opts ...interface{}) *gomock.Call

ListMetadata indicates an expected call of ListMetadata.

func (*MockRepositoryClientMockRecorder) ListPrefix 

func (mr *MockRepositoryClientMockRecorder) ListPrefix(ctx, in interface{}, opts ...interface{}) *gomock.Call

ListPrefix indicates an expected call of ListPrefix.

func (*MockRepositoryClientMockRecorder) ListRefs 

func (mr *MockRepositoryClientMockRecorder) ListRefs(ctx, in interface{}, opts ...interface{}) *gomock.Call

ListRefs indicates an expected call of ListRefs.

func (*MockRepositoryClientMockRecorder) RegisterInstance 

func (mr *MockRepositoryClientMockRecorder) RegisterInstance(ctx, in interface{}, opts ...interface{}) *gomock.Call

RegisterInstance indicates an expected call of RegisterInstance.

func (*MockRepositoryClientMockRecorder) ResolveVersion 

func (mr *MockRepositoryClientMockRecorder) ResolveVersion(ctx, in interface{}, opts ...interface{}) *gomock.Call

ResolveVersion indicates an expected call of ResolveVersion.

func (*MockRepositoryClientMockRecorder) SearchInstances 

func (mr *MockRepositoryClientMockRecorder) SearchInstances(ctx, in interface{}, opts ...interface{}) *gomock.Call

SearchInstances indicates an expected call of SearchInstances.

func (*MockRepositoryClientMockRecorder) UnhidePackage 

func (mr *MockRepositoryClientMockRecorder) UnhidePackage(ctx, in interface{}, opts ...interface{}) *gomock.Call

UnhidePackage indicates an expected call of UnhidePackage.

func (*MockRepositoryClientMockRecorder) UpdatePrefixMetadata 

func (mr *MockRepositoryClientMockRecorder) UpdatePrefixMetadata(ctx, in interface{}, opts ...interface{}) *gomock.Call

UpdatePrefixMetadata indicates an expected call of UpdatePrefixMetadata.

type MockRepositoryServer 

type MockRepositoryServer struct {
	// contains filtered or unexported fields
}

MockRepositoryServer is a mock of RepositoryServer interface.

func NewMockRepositoryServer 

func NewMockRepositoryServer(ctrl *gomock.Controller) *MockRepositoryServer

NewMockRepositoryServer creates a new mock instance.

func (*MockRepositoryServer) AttachMetadata 

func (m *MockRepositoryServer) AttachMetadata(arg0 context.Context, arg1 *AttachMetadataRequest) (*emptypb.Empty, error)

AttachMetadata mocks base method.

func (*MockRepositoryServer) AttachTags 

func (m *MockRepositoryServer) AttachTags(arg0 context.Context, arg1 *AttachTagsRequest) (*emptypb.Empty, error)

AttachTags mocks base method.

func (*MockRepositoryServer) CreateRef 

func (m *MockRepositoryServer) CreateRef(arg0 context.Context, arg1 *Ref) (*emptypb.Empty, error)

CreateRef mocks base method.

func (*MockRepositoryServer) DeletePackage 

func (m *MockRepositoryServer) DeletePackage(arg0 context.Context, arg1 *PackageRequest) (*emptypb.Empty, error)

DeletePackage mocks base method.

func (*MockRepositoryServer) DeleteRef 

func (m *MockRepositoryServer) DeleteRef(arg0 context.Context, arg1 *DeleteRefRequest) (*emptypb.Empty, error)

DeleteRef mocks base method.

func (*MockRepositoryServer) DescribeBootstrapBundle 

func (m *MockRepositoryServer) DescribeBootstrapBundle(arg0 context.Context, arg1 *DescribeBootstrapBundleRequest) (*DescribeBootstrapBundleResponse, error)

DescribeBootstrapBundle mocks base method.

func (*MockRepositoryServer) DescribeClient 

func (m *MockRepositoryServer) DescribeClient(arg0 context.Context, arg1 *DescribeClientRequest) (*DescribeClientResponse, error)

DescribeClient mocks base method.

func (*MockRepositoryServer) DescribeInstance 

func (m *MockRepositoryServer) DescribeInstance(arg0 context.Context, arg1 *DescribeInstanceRequest) (*DescribeInstanceResponse, error)

DescribeInstance mocks base method.

func (*MockRepositoryServer) DetachMetadata 

func (m *MockRepositoryServer) DetachMetadata(arg0 context.Context, arg1 *DetachMetadataRequest) (*emptypb.Empty, error)

DetachMetadata mocks base method.

func (*MockRepositoryServer) DetachTags 

func (m *MockRepositoryServer) DetachTags(arg0 context.Context, arg1 *DetachTagsRequest) (*emptypb.Empty, error)

DetachTags mocks base method.

func (*MockRepositoryServer) EXPECT 

func (m *MockRepositoryServer) EXPECT() *MockRepositoryServerMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockRepositoryServer) GetInheritedPrefixMetadata 

func (m *MockRepositoryServer) GetInheritedPrefixMetadata(arg0 context.Context, arg1 *PrefixRequest) (*InheritedPrefixMetadata, error)

GetInheritedPrefixMetadata mocks base method.

func (*MockRepositoryServer) GetInstanceURL 

func (m *MockRepositoryServer) GetInstanceURL(arg0 context.Context, arg1 *GetInstanceURLRequest) (*ObjectURL, error)

GetInstanceURL mocks base method.

func (*MockRepositoryServer) GetPrefixMetadata 

func (m *MockRepositoryServer) GetPrefixMetadata(arg0 context.Context, arg1 *PrefixRequest) (*PrefixMetadata, error)

GetPrefixMetadata mocks base method.

func (*MockRepositoryServer) GetRolesInPrefix 

func (m *MockRepositoryServer) GetRolesInPrefix(arg0 context.Context, arg1 *PrefixRequest) (*RolesInPrefixResponse, error)

GetRolesInPrefix mocks base method.

func (*MockRepositoryServer) GetRolesInPrefixOnBehalfOf 

func (m *MockRepositoryServer) GetRolesInPrefixOnBehalfOf(arg0 context.Context, arg1 *PrefixRequestOnBehalfOf) (*RolesInPrefixResponse, error)

GetRolesInPrefixOnBehalfOf mocks base method.

func (*MockRepositoryServer) HidePackage 

func (m *MockRepositoryServer) HidePackage(arg0 context.Context, arg1 *PackageRequest) (*emptypb.Empty, error)

HidePackage mocks base method.

func (*MockRepositoryServer) ListInstances 

func (m *MockRepositoryServer) ListInstances(arg0 context.Context, arg1 *ListInstancesRequest) (*ListInstancesResponse, error)

ListInstances mocks base method.

func (*MockRepositoryServer) ListMetadata 

func (m *MockRepositoryServer) ListMetadata(arg0 context.Context, arg1 *ListMetadataRequest) (*ListMetadataResponse, error)

ListMetadata mocks base method.

func (*MockRepositoryServer) ListPrefix 

func (m *MockRepositoryServer) ListPrefix(arg0 context.Context, arg1 *ListPrefixRequest) (*ListPrefixResponse, error)

ListPrefix mocks base method.

func (*MockRepositoryServer) ListRefs 

func (m *MockRepositoryServer) ListRefs(arg0 context.Context, arg1 *ListRefsRequest) (*ListRefsResponse, error)

ListRefs mocks base method.

func (*MockRepositoryServer) RegisterInstance 

func (m *MockRepositoryServer) RegisterInstance(arg0 context.Context, arg1 *Instance) (*RegisterInstanceResponse, error)

RegisterInstance mocks base method.

func (*MockRepositoryServer) ResolveVersion 

func (m *MockRepositoryServer) ResolveVersion(arg0 context.Context, arg1 *ResolveVersionRequest) (*Instance, error)

ResolveVersion mocks base method.

func (*MockRepositoryServer) SearchInstances 

func (m *MockRepositoryServer) SearchInstances(arg0 context.Context, arg1 *SearchInstancesRequest) (*SearchInstancesResponse, error)

SearchInstances mocks base method.

func (*MockRepositoryServer) UnhidePackage 

func (m *MockRepositoryServer) UnhidePackage(arg0 context.Context, arg1 *PackageRequest) (*emptypb.Empty, error)

UnhidePackage mocks base method.

func (*MockRepositoryServer) UpdatePrefixMetadata 

func (m *MockRepositoryServer) UpdatePrefixMetadata(arg0 context.Context, arg1 *PrefixMetadata) (*PrefixMetadata, error)

UpdatePrefixMetadata mocks base method.

type MockRepositoryServerMockRecorder 

type MockRepositoryServerMockRecorder struct {
	// contains filtered or unexported fields
}

MockRepositoryServerMockRecorder is the mock recorder for MockRepositoryServer.

func (*MockRepositoryServerMockRecorder) AttachMetadata 

func (mr *MockRepositoryServerMockRecorder) AttachMetadata(arg0, arg1 interface{}) *gomock.Call

AttachMetadata indicates an expected call of AttachMetadata.

func (*MockRepositoryServerMockRecorder) AttachTags 

func (mr *MockRepositoryServerMockRecorder) AttachTags(arg0, arg1 interface{}) *gomock.Call

AttachTags indicates an expected call of AttachTags.

func (*MockRepositoryServerMockRecorder) CreateRef 

func (mr *MockRepositoryServerMockRecorder) CreateRef(arg0, arg1 interface{}) *gomock.Call

CreateRef indicates an expected call of CreateRef.

func (*MockRepositoryServerMockRecorder) DeletePackage 

func (mr *MockRepositoryServerMockRecorder) DeletePackage(arg0, arg1 interface{}) *gomock.Call

DeletePackage indicates an expected call of DeletePackage.

func (*MockRepositoryServerMockRecorder) DeleteRef 

func (mr *MockRepositoryServerMockRecorder) DeleteRef(arg0, arg1 interface{}) *gomock.Call

DeleteRef indicates an expected call of DeleteRef.

func (*MockRepositoryServerMockRecorder) DescribeBootstrapBundle 

func (mr *MockRepositoryServerMockRecorder) DescribeBootstrapBundle(arg0, arg1 interface{}) *gomock.Call

DescribeBootstrapBundle indicates an expected call of DescribeBootstrapBundle.

func (*MockRepositoryServerMockRecorder) DescribeClient 

func (mr *MockRepositoryServerMockRecorder) DescribeClient(arg0, arg1 interface{}) *gomock.Call

DescribeClient indicates an expected call of DescribeClient.

func (*MockRepositoryServerMockRecorder) DescribeInstance 

func (mr *MockRepositoryServerMockRecorder) DescribeInstance(arg0, arg1 interface{}) *gomock.Call

DescribeInstance indicates an expected call of DescribeInstance.

func (*MockRepositoryServerMockRecorder) DetachMetadata 

func (mr *MockRepositoryServerMockRecorder) DetachMetadata(arg0, arg1 interface{}) *gomock.Call

DetachMetadata indicates an expected call of DetachMetadata.

func (*MockRepositoryServerMockRecorder) DetachTags 

func (mr *MockRepositoryServerMockRecorder) DetachTags(arg0, arg1 interface{}) *gomock.Call

DetachTags indicates an expected call of DetachTags.

func (*MockRepositoryServerMockRecorder) GetInheritedPrefixMetadata 

func (mr *MockRepositoryServerMockRecorder) GetInheritedPrefixMetadata(arg0, arg1 interface{}) *gomock.Call

GetInheritedPrefixMetadata indicates an expected call of GetInheritedPrefixMetadata.

func (*MockRepositoryServerMockRecorder) GetInstanceURL 

func (mr *MockRepositoryServerMockRecorder) GetInstanceURL(arg0, arg1 interface{}) *gomock.Call

GetInstanceURL indicates an expected call of GetInstanceURL.

func (*MockRepositoryServerMockRecorder) GetPrefixMetadata 

func (mr *MockRepositoryServerMockRecorder) GetPrefixMetadata(arg0, arg1 interface{}) *gomock.Call

GetPrefixMetadata indicates an expected call of GetPrefixMetadata.

func (*MockRepositoryServerMockRecorder) GetRolesInPrefix 

func (mr *MockRepositoryServerMockRecorder) GetRolesInPrefix(arg0, arg1 interface{}) *gomock.Call

GetRolesInPrefix indicates an expected call of GetRolesInPrefix.

func (*MockRepositoryServerMockRecorder) GetRolesInPrefixOnBehalfOf 

func (mr *MockRepositoryServerMockRecorder) GetRolesInPrefixOnBehalfOf(arg0, arg1 interface{}) *gomock.Call

GetRolesInPrefixOnBehalfOf indicates an expected call of GetRolesInPrefixOnBehalfOf.

func (*MockRepositoryServerMockRecorder) HidePackage 

func (mr *MockRepositoryServerMockRecorder) HidePackage(arg0, arg1 interface{}) *gomock.Call

HidePackage indicates an expected call of HidePackage.

func (*MockRepositoryServerMockRecorder) ListInstances 

func (mr *MockRepositoryServerMockRecorder) ListInstances(arg0, arg1 interface{}) *gomock.Call

ListInstances indicates an expected call of ListInstances.

func (*MockRepositoryServerMockRecorder) ListMetadata 

func (mr *MockRepositoryServerMockRecorder) ListMetadata(arg0, arg1 interface{}) *gomock.Call

ListMetadata indicates an expected call of ListMetadata.

func (*MockRepositoryServerMockRecorder) ListPrefix 

func (mr *MockRepositoryServerMockRecorder) ListPrefix(arg0, arg1 interface{}) *gomock.Call

ListPrefix indicates an expected call of ListPrefix.

func (*MockRepositoryServerMockRecorder) ListRefs 

func (mr *MockRepositoryServerMockRecorder) ListRefs(arg0, arg1 interface{}) *gomock.Call

ListRefs indicates an expected call of ListRefs.

func (*MockRepositoryServerMockRecorder) RegisterInstance 

func (mr *MockRepositoryServerMockRecorder) RegisterInstance(arg0, arg1 interface{}) *gomock.Call

RegisterInstance indicates an expected call of RegisterInstance.

func (*MockRepositoryServerMockRecorder) ResolveVersion 

func (mr *MockRepositoryServerMockRecorder) ResolveVersion(arg0, arg1 interface{}) *gomock.Call

ResolveVersion indicates an expected call of ResolveVersion.

func (*MockRepositoryServerMockRecorder) SearchInstances 

func (mr *MockRepositoryServerMockRecorder) SearchInstances(arg0, arg1 interface{}) *gomock.Call

SearchInstances indicates an expected call of SearchInstances.

func (*MockRepositoryServerMockRecorder) UnhidePackage 

func (mr *MockRepositoryServerMockRecorder) UnhidePackage(arg0, arg1 interface{}) *gomock.Call

UnhidePackage indicates an expected call of UnhidePackage.

func (*MockRepositoryServerMockRecorder) UpdatePrefixMetadata 

func (mr *MockRepositoryServerMockRecorder) UpdatePrefixMetadata(arg0, arg1 interface{}) *gomock.Call

UpdatePrefixMetadata indicates an expected call of UpdatePrefixMetadata.

type MockUnsafeRepositoryServer 

type MockUnsafeRepositoryServer struct {
	// contains filtered or unexported fields
}

MockUnsafeRepositoryServer is a mock of UnsafeRepositoryServer interface.

func NewMockUnsafeRepositoryServer 

func NewMockUnsafeRepositoryServer(ctrl *gomock.Controller) *MockUnsafeRepositoryServer

NewMockUnsafeRepositoryServer creates a new mock instance.

func (*MockUnsafeRepositoryServer) EXPECT 

func (m *MockUnsafeRepositoryServer) EXPECT() *MockUnsafeRepositoryServerMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

type MockUnsafeRepositoryServerMockRecorder 

type MockUnsafeRepositoryServerMockRecorder struct {
	// contains filtered or unexported fields
}

MockUnsafeRepositoryServerMockRecorder is the mock recorder for MockUnsafeRepositoryServer.

type ObjectRef 

type ObjectRef struct {
	HashAlgo  HashAlgo `protobuf:"varint,1,opt,name=hash_algo,json=hashAlgo,proto3,enum=cipd.HashAlgo" json:"hash_algo,omitempty"` // an algorithm applied to the body to get the name
	HexDigest string   `protobuf:"bytes,2,opt,name=hex_digest,json=hexDigest,proto3" json:"hex_digest,omitempty"`                  // the name as lowercase hex string, e.g. 'abcdef...'
	// contains filtered or unexported fields
}

A reference to an object in the content-addressable storage.

func (*ObjectRef) Descriptor deprecated 

func (*ObjectRef) Descriptor() ([]byte, []int)

Deprecated: Use ObjectRef.ProtoReflect.Descriptor instead.

func (*ObjectRef) GetHashAlgo 

func (x *ObjectRef) GetHashAlgo() HashAlgo

func (*ObjectRef) GetHexDigest 

func (x *ObjectRef) GetHexDigest() string

func (*ObjectRef) ProtoMessage 

func (*ObjectRef) ProtoMessage()

func (*ObjectRef) ProtoReflect 

func (x *ObjectRef) ProtoReflect() protoreflect.Message

func (*ObjectRef) Reset 

func (x *ObjectRef) Reset()

func (*ObjectRef) String 

func (x *ObjectRef) String() string

type ObjectURL 

type ObjectURL struct {

	// A signed HTTPS URL to the object's body.
	//
	// Fetching it doesn't require authentication. Expires after some unspecified
	// short amount of time. It is expected that callers will use it immediately.
	//
	// The URL isn't guaranteed to have any particular internal structure. Do not
	// attempt to parse it.
	SignedUrl string `protobuf:"bytes,1,opt,name=signed_url,json=signedUrl,proto3" json:"signed_url,omitempty"`
	// contains filtered or unexported fields
}

func (*ObjectURL) Descriptor deprecated 

func (*ObjectURL) Descriptor() ([]byte, []int)

Deprecated: Use ObjectURL.ProtoReflect.Descriptor instead.

func (*ObjectURL) GetSignedUrl 

func (x *ObjectURL) GetSignedUrl() string

func (*ObjectURL) ProtoMessage 

func (*ObjectURL) ProtoMessage()

func (*ObjectURL) ProtoReflect 

func (x *ObjectURL) ProtoReflect() protoreflect.Message

func (*ObjectURL) Reset 

func (x *ObjectURL) Reset()

func (*ObjectURL) String 

func (x *ObjectURL) String() string

type PackageRequest 

type PackageRequest struct {
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// contains filtered or unexported fields
}

PackageRequest names a package and nothing else.

func (*PackageRequest) Descriptor deprecated 

func (*PackageRequest) Descriptor() ([]byte, []int)

Deprecated: Use PackageRequest.ProtoReflect.Descriptor instead.

func (*PackageRequest) GetPackage 

func (x *PackageRequest) GetPackage() string

func (*PackageRequest) ProtoMessage 

func (*PackageRequest) ProtoMessage()

func (*PackageRequest) ProtoReflect 

func (x *PackageRequest) ProtoReflect() protoreflect.Message

func (*PackageRequest) Reset 

func (x *PackageRequest) Reset()

func (*PackageRequest) String 

func (x *PackageRequest) String() string

type PrefixMetadata 

type PrefixMetadata struct {

	// Prefix this metadata is defined at, e.g. "a/b/c".
	//
	// Note: there's no metadata at the root, so prefix must never be "".
	Prefix string `protobuf:"bytes,1,opt,name=prefix,proto3" json:"prefix,omitempty"`
	// An opaque string that identifies a particular version of this metadata.
	//
	// Used by UpdatePrefixMetadata to prevent an accidental overwrite of changes.
	Fingerprint string `protobuf:"bytes,2,opt,name=fingerprint,proto3" json:"fingerprint,omitempty"`
	// When the metadata was modified the last time.
	//
	// Managed by the server, ignored when passed to UpdatePrefixMetadata.
	UpdateTime *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=update_time,json=updateTime,proto3" json:"update_time,omitempty"`
	// Identity string of whoever modified the metadata the last time.
	//
	// Managed by the server, ignored when passed to UpdatePrefixMetadata.
	UpdateUser string `protobuf:"bytes,4,opt,name=update_user,json=updateUser,proto3" json:"update_user,omitempty"`
	// ACLs that apply to this prefix and all subprefixes, as a mapping from
	// a role to a list of users and groups that have it.
	Acls []*PrefixMetadata_ACL `protobuf:"bytes,5,rep,name=acls,proto3" json:"acls,omitempty"`
	// contains filtered or unexported fields
}

PrefixMetadata is metadata defined at some concrete package prefix.

It applies to this prefix and all subprefixes, recursively.

func (*PrefixMetadata) Descriptor deprecated 

func (*PrefixMetadata) Descriptor() ([]byte, []int)

Deprecated: Use PrefixMetadata.ProtoReflect.Descriptor instead.

func (*PrefixMetadata) GetAcls 

func (x *PrefixMetadata) GetAcls() []*PrefixMetadata_ACL

func (*PrefixMetadata) GetFingerprint 

func (x *PrefixMetadata) GetFingerprint() string

func (*PrefixMetadata) GetPrefix 

func (x *PrefixMetadata) GetPrefix() string

func (*PrefixMetadata) GetUpdateTime 

func (x *PrefixMetadata) GetUpdateTime() *timestamppb.Timestamp

func (*PrefixMetadata) GetUpdateUser 

func (x *PrefixMetadata) GetUpdateUser() string

func (*PrefixMetadata) ProtoMessage 

func (*PrefixMetadata) ProtoMessage()

func (*PrefixMetadata) ProtoReflect 

func (x *PrefixMetadata) ProtoReflect() protoreflect.Message

func (*PrefixMetadata) Reset 

func (x *PrefixMetadata) Reset()

func (*PrefixMetadata) String 

func (x *PrefixMetadata) String() string

type PrefixMetadata_ACL 

type PrefixMetadata_ACL struct {

	// Role that this ACL describes.
	Role Role `protobuf:"varint,1,opt,name=role,proto3,enum=cipd.Role" json:"role,omitempty"`
	// Users and groups that have the specified role.
	//
	// Each entry has a form "<kind>:<value>", e.g. "group:..." or "user:...".
	Principals []string `protobuf:"bytes,2,rep,name=principals,proto3" json:"principals,omitempty"`
	// contains filtered or unexported fields
}

func (*PrefixMetadata_ACL) Descriptor deprecated 

func (*PrefixMetadata_ACL) Descriptor() ([]byte, []int)

Deprecated: Use PrefixMetadata_ACL.ProtoReflect.Descriptor instead.

func (*PrefixMetadata_ACL) GetPrincipals 

func (x *PrefixMetadata_ACL) GetPrincipals() []string

func (*PrefixMetadata_ACL) GetRole 

func (x *PrefixMetadata_ACL) GetRole() Role

func (*PrefixMetadata_ACL) ProtoMessage 

func (*PrefixMetadata_ACL) ProtoMessage()

func (*PrefixMetadata_ACL) ProtoReflect 

func (x *PrefixMetadata_ACL) ProtoReflect() protoreflect.Message

func (*PrefixMetadata_ACL) Reset 

func (x *PrefixMetadata_ACL) Reset()

func (*PrefixMetadata_ACL) String 

func (x *PrefixMetadata_ACL) String() string

type PrefixRequest 

type PrefixRequest struct {

	// A prefix within the repository, e.g. "a/b/c".
	Prefix string `protobuf:"bytes,1,opt,name=prefix,proto3" json:"prefix,omitempty"`
	// contains filtered or unexported fields
}

func (*PrefixRequest) Descriptor deprecated 

func (*PrefixRequest) Descriptor() ([]byte, []int)

Deprecated: Use PrefixRequest.ProtoReflect.Descriptor instead.

func (*PrefixRequest) GetPrefix 

func (x *PrefixRequest) GetPrefix() string

func (*PrefixRequest) ProtoMessage 

func (*PrefixRequest) ProtoMessage()

func (*PrefixRequest) ProtoReflect 

func (x *PrefixRequest) ProtoReflect() protoreflect.Message

func (*PrefixRequest) Reset 

func (x *PrefixRequest) Reset()

func (*PrefixRequest) String 

func (x *PrefixRequest) String() string

type PrefixRequestOnBehalfOf 

type PrefixRequestOnBehalfOf struct {

	// The identity that we are requesting prefix data on behalf of.
	//
	// This must be either anonymous or a luci-auth User identity, e.g.:
	//
	//   - anonymous:anonymous
	//   - user:<email address>
	Identity string `protobuf:"bytes,1,opt,name=identity,proto3" json:"identity,omitempty"`
	// The actual PrefixRequest.
	PrefixRequest *PrefixRequest `protobuf:"bytes,2,opt,name=prefix_request,json=prefixRequest,proto3" json:"prefix_request,omitempty"`
	// contains filtered or unexported fields
}

func (*PrefixRequestOnBehalfOf) Descriptor deprecated 

func (*PrefixRequestOnBehalfOf) Descriptor() ([]byte, []int)

Deprecated: Use PrefixRequestOnBehalfOf.ProtoReflect.Descriptor instead.

func (*PrefixRequestOnBehalfOf) GetIdentity 

func (x *PrefixRequestOnBehalfOf) GetIdentity() string

func (*PrefixRequestOnBehalfOf) GetPrefixRequest 

func (x *PrefixRequestOnBehalfOf) GetPrefixRequest() *PrefixRequest

func (*PrefixRequestOnBehalfOf) ProtoMessage 

func (*PrefixRequestOnBehalfOf) ProtoMessage()

func (*PrefixRequestOnBehalfOf) ProtoReflect 

func (x *PrefixRequestOnBehalfOf) ProtoReflect() protoreflect.Message

func (*PrefixRequestOnBehalfOf) Reset 

func (x *PrefixRequestOnBehalfOf) Reset()

func (*PrefixRequestOnBehalfOf) String 

func (x *PrefixRequestOnBehalfOf) String() string

type Processor 

type Processor struct {

	// Internal identifier of the processor, e.g. "cipd_client_binary:v1"
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// The state of this processor, see the enum.
	State Processor_State `protobuf:"varint,2,opt,name=state,proto3,enum=cipd.Processor_State" json:"state,omitempty"`
	// When the processor finished running (successfully or not).
	FinishedTs *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=finished_ts,json=finishedTs,proto3" json:"finished_ts,omitempty"`
	// For SUCCEEDED state, result of the processing.
	Result *structpb.Struct `protobuf:"bytes,4,opt,name=result,proto3" json:"result,omitempty"`
	// For FAILED state, the error message.
	Error string `protobuf:"bytes,5,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

Processor describes a state of some post-registration processing step performed on an instance.

func (*Processor) Descriptor deprecated 

func (*Processor) Descriptor() ([]byte, []int)

Deprecated: Use Processor.ProtoReflect.Descriptor instead.

func (*Processor) GetError 

func (x *Processor) GetError() string

func (*Processor) GetFinishedTs 

func (x *Processor) GetFinishedTs() *timestamppb.Timestamp

func (*Processor) GetId 

func (x *Processor) GetId() string

func (*Processor) GetResult 

func (x *Processor) GetResult() *structpb.Struct

func (*Processor) GetState 

func (x *Processor) GetState() Processor_State

func (*Processor) ProtoMessage 

func (*Processor) ProtoMessage()

func (*Processor) ProtoReflect 

func (x *Processor) ProtoReflect() protoreflect.Message

func (*Processor) Reset 

func (x *Processor) Reset()

func (*Processor) String 

func (x *Processor) String() string

type Processor_State 

type Processor_State int32
const (
	Processor_STATE_UNSPECIFIED Processor_State = 0
	Processor_PENDING           Processor_State = 1
	Processor_SUCCEEDED         Processor_State = 2
	Processor_FAILED            Processor_State = 3
)

func (Processor_State) Descriptor 

func (Processor_State) Descriptor() protoreflect.EnumDescriptor

func (Processor_State) Enum 

func (x Processor_State) Enum() *Processor_State

func (Processor_State) EnumDescriptor deprecated 

func (Processor_State) EnumDescriptor() ([]byte, []int)

Deprecated: Use Processor_State.Descriptor instead.

func (Processor_State) Number 

func (x Processor_State) Number() protoreflect.EnumNumber

func (Processor_State) String 

func (x Processor_State) String() string

func (Processor_State) Type 

func (Processor_State) Type() protoreflect.EnumType

type Ref 

type Ref struct {

	// Name of the ref, e.g. "latest".
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Name of the package where the ref is defined.
	Package string `protobuf:"bytes,2,opt,name=package,proto3" json:"package,omitempty"`
	// A package instance the ref is pointing to.
	Instance *ObjectRef `protobuf:"bytes,3,opt,name=instance,proto3" json:"instance,omitempty"`
	// User who modified this ref the last time (output only).
	ModifiedBy string `protobuf:"bytes,4,opt,name=modified_by,json=modifiedBy,proto3" json:"modified_by,omitempty"`
	// When the ref was modified the last time (output only).
	ModifiedTs *timestamppb.Timestamp `protobuf:"bytes,5,opt,name=modified_ts,json=modifiedTs,proto3" json:"modified_ts,omitempty"`
	// contains filtered or unexported fields
}

Ref is a mutable named pointer to some package instance that can be used as a version identifier.

func (*Ref) Descriptor deprecated 

func (*Ref) Descriptor() ([]byte, []int)

Deprecated: Use Ref.ProtoReflect.Descriptor instead.

func (*Ref) GetInstance 

func (x *Ref) GetInstance() *ObjectRef

func (*Ref) GetModifiedBy 

func (x *Ref) GetModifiedBy() string

func (*Ref) GetModifiedTs 

func (x *Ref) GetModifiedTs() *timestamppb.Timestamp

func (*Ref) GetName 

func (x *Ref) GetName() string

func (*Ref) GetPackage 

func (x *Ref) GetPackage() string

func (*Ref) ProtoMessage 

func (*Ref) ProtoMessage()

func (*Ref) ProtoReflect 

func (x *Ref) ProtoReflect() protoreflect.Message

func (*Ref) Reset 

func (x *Ref) Reset()

func (*Ref) String 

func (x *Ref) String() string

type RegisterInstanceResponse 

type RegisterInstanceResponse struct {

	// Outcome of the operation, see the enum for possibilities.
	//
	// Defines what other fields are present.
	Status RegistrationStatus `protobuf:"varint,1,opt,name=status,proto3,enum=cipd.RegistrationStatus" json:"status,omitempty"`
	// For statuses REGISTERED and ALREADY_REGISTERED contains details about the
	// instance. Not set for NOT_UPLOADED status.
	Instance *Instance `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	// For status NOT_UPLOADED contains a new upload operation that can be used
	// together with Storage service to upload the instance file. Not set for
	// other statuses.
	UploadOp *UploadOperation `protobuf:"bytes,3,opt,name=upload_op,json=uploadOp,proto3" json:"upload_op,omitempty"`
	// contains filtered or unexported fields
}

func (*RegisterInstanceResponse) Descriptor deprecated 

func (*RegisterInstanceResponse) Descriptor() ([]byte, []int)

Deprecated: Use RegisterInstanceResponse.ProtoReflect.Descriptor instead.

func (*RegisterInstanceResponse) GetInstance 

func (x *RegisterInstanceResponse) GetInstance() *Instance

func (*RegisterInstanceResponse) GetStatus 

func (x *RegisterInstanceResponse) GetStatus() RegistrationStatus

func (*RegisterInstanceResponse) GetUploadOp 

func (x *RegisterInstanceResponse) GetUploadOp() *UploadOperation

func (*RegisterInstanceResponse) ProtoMessage 

func (*RegisterInstanceResponse) ProtoMessage()

func (*RegisterInstanceResponse) ProtoReflect 

func (x *RegisterInstanceResponse) ProtoReflect() protoreflect.Message

func (*RegisterInstanceResponse) Reset 

func (x *RegisterInstanceResponse) Reset()

func (*RegisterInstanceResponse) String 

func (x *RegisterInstanceResponse) String() string

type RegistrationStatus 

type RegistrationStatus int32

RegistrationStatus is part of RegisterInstance RPC response. 

const (
	RegistrationStatus_REGISTRATION_STATUS_UNSPECIFIED RegistrationStatus = 0
	RegistrationStatus_REGISTERED                      RegistrationStatus = 1 // the instance was successfully registered just now
	RegistrationStatus_ALREADY_REGISTERED              RegistrationStatus = 2 // the instance already exists, this is OK
	RegistrationStatus_NOT_UPLOADED                    RegistrationStatus = 3 // the instance should be uploaded to Storage first
)

func (RegistrationStatus) Descriptor 

func (RegistrationStatus) Descriptor() protoreflect.EnumDescriptor

func (RegistrationStatus) Enum 

func (x RegistrationStatus) Enum() *RegistrationStatus

func (RegistrationStatus) EnumDescriptor deprecated 

func (RegistrationStatus) EnumDescriptor() ([]byte, []int)

Deprecated: Use RegistrationStatus.Descriptor instead.

func (RegistrationStatus) Number 

func (x RegistrationStatus) Number() protoreflect.EnumNumber

func (RegistrationStatus) String 

func (x RegistrationStatus) String() string

func (RegistrationStatus) Type 

func (RegistrationStatus) Type() protoreflect.EnumType

type RepositoryClient 

type RepositoryClient interface {
	// Returns metadata associated with the given prefix.
	//
	// Requires the caller to have OWNER role for the requested prefix or any of
	// parent prefixes, or be in a special global "cipd-prefixes-viewers" group,
	// otherwise the call fails with PERMISSION_DENIED error.
	//
	// If the caller has OWNER permission in any of parent prefixes, but the
	// requested prefix has no metadata associated with it, the call fails with
	// NOT_FOUND error.
	GetPrefixMetadata(ctx context.Context, in *PrefixRequest, opts ...grpc.CallOption) (*PrefixMetadata, error)
	// Returns metadata associated with the given prefix and all parent prefixes.
	//
	// Requires the caller to have OWNER role for the requested prefix or any of
	// parent prefixes, or be in a special global "cipd-prefixes-viewers" group,
	// otherwise the call fails with PERMISSION_DENIED error.
	//
	// Note that if the caller has permission to see the metadata for the
	// requested prefix, they will also see metadata for all parent prefixes,
	// since it is needed to assemble the final metadata for the prefix (it
	// includes inherited properties from all parent prefixes).
	GetInheritedPrefixMetadata(ctx context.Context, in *PrefixRequest, opts ...grpc.CallOption) (*InheritedPrefixMetadata, error)
	// Updates or creates metadata associated with the given prefix.
	//
	// Requires the caller to have OWNER role for the requested prefix or any of
	// parent prefixes, otherwise the call fails with PERMISSION_DENIED error.
	//
	// This method checks 'fingerprint' field of the PrefixMetadata object. If the
	// metadata for the given prefix already exists, and the fingerprint in the
	// request doesn't match the current fingerprint, the request fails with
	// FAILED_PRECONDITION error.
	//
	// If the metadata doesn't exist yet, its fingerprint is assumed to be empty
	// string. So pass empty fingerprint when creating initial metadata objects.
	//
	// If the caller passes empty fingerprint, but the metadata already exists,
	// the request fails with ALREADY_EXISTS error.
	//
	// Note that there's no way to delete metadata once it was created. Passing
	// empty PrefixMetadata object is the best that can be done.
	//
	// On success returns PrefixMetadata object with the updated fingerprint.
	UpdatePrefixMetadata(ctx context.Context, in *PrefixMetadata, opts ...grpc.CallOption) (*PrefixMetadata, error)
	// Returns a set of roles the caller has in the given prefix.
	//
	// Unlike GetPrefixMetadata call that requires special permissions (since it
	// returns a lot of detailed information), GetRolesInPrefix can be called by
	// anyone.
	//
	// It understands and expands roles inheritance, e.g. if the caller is an
	// OWNER, the result will also contain WRITER and READER (as they are implied
	// by being an OWNER).
	//
	// Returns empty set of roles if the caller has no permissions to access the
	// prefix at all or such prefix doesn't exist.
	GetRolesInPrefix(ctx context.Context, in *PrefixRequest, opts ...grpc.CallOption) (*RolesInPrefixResponse, error)
	// Returns a set of roles a specific identity has in the given prefix.
	//
	// This works the same way as GetRolesInPrefix, except:
	//   - The caller requires the same permission as GetPrefixMetadata.
	//   - Uses PrefixRequestOnBehalfOf.identity, rather than the caller's
	//     identity, for determining the returned Roles.
	GetRolesInPrefixOnBehalfOf(ctx context.Context, in *PrefixRequestOnBehalfOf, opts ...grpc.CallOption) (*RolesInPrefixResponse, error)
	// Lists packages and subprefixes registered under the prefix.
	//
	// Lists either only direct descendants or recursively all descendants. The
	// result is sorted lexicographically.
	//
	// For example, for packages ["a", "a/b", "a/c/d", "a/c/e/f"], listing of "a"
	// will be:
	//   - {packages: ["a/b"], prefixes: ["a/c"]} if listing non-recursively.
	//   - {packages: ["a/b", "a/c/d", "a/c/e/f"], prefixes: ["a/c", "a/c/e"]} if
	//     listing recursively.
	//
	// Returns only packages and prefixes visible to the caller. This applies even
	// when listing a prefix the caller has no direct read access to. For example,
	// recursively listing the root prefix will return all packages the caller has
	// read access to (no matter when in the hierarchy they are located), even if
	// the caller has no READER permission in the root. It works as if the caller
	// can freely browse the repository that contains only the packages they can
	// see and nothing else.
	ListPrefix(ctx context.Context, in *ListPrefixRequest, opts ...grpc.CallOption) (*ListPrefixResponse, error)
	// HidePackage marks the package as hidden.
	//
	// This removes it from the ListPrefix results, but doesn't otherwise affect
	// its usage (e.g. it is still fetchable).
	//
	// Requires OWNER role for the package prefix. Returns PERMISSION_DENIED
	// otherwise.
	HidePackage(ctx context.Context, in *PackageRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// UnhidePackage marks the package as visible again.
	//
	// It's reverse of HidePackage.
	//
	// Requires OWNER role for the package prefix. Returns PERMISSION_DENIED
	// otherwise.
	UnhidePackage(ctx context.Context, in *PackageRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// DeletePackage removes the package (along with all its instances, tags, refs
	// etc) from the repository.
	//
	// There's no undo. Once the package is deleted, it is gone forever.
	//
	// This operation has a potential to break various pinned historical CIPD
	// ensure files and thus should not be used casually, only in extreme cases.
	// Consider just hiding the package instead of deleting it.
	//
	// For the reasons above, the operation requires admin access: only owners of
	// the repository root can delete packages.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a root owner.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package doesn't exist.
	DeletePackage(ctx context.Context, in *PackageRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// Registers a package instance in the repository (if it was uploaded to the
	// storage already and wasn't registered yet) or initiates a new upload
	// operation.
	//
	// Callers are expected to execute the following protocol:
	//  1. Attempt to register a package instance by calling RegisterInstance.
	//  2. On NOT_UPLOADED status, upload the package data and finalize the
	//     upload operation using Storage RPC service and upload_op from the
	//     response.
	//  3. Once the upload operation is finalized, call RegisterInstance again,
	//     it should succeed with status REGISTERED now.
	//
	// If such instance is already registered by someone else, returns
	// ALREADY_REGISTERED status. This is not an error.
	//
	// Callers must have roles WRITER or OWNER for the package prefix. Returns
	// PERMISSION_DENIED otherwise.
	RegisterInstance(ctx context.Context, in *Instance, opts ...grpc.CallOption) (*RegisterInstanceResponse, error)
	// Lists instances of a package, most recent first.
	//
	// Callers must have roles READER (or above) for the package prefix. Returns
	// PERMISSION_DENIED otherwise.
	//
	// If the package doesn't exist, returns NOT_FOUND.
	ListInstances(ctx context.Context, in *ListInstancesRequest, opts ...grpc.CallOption) (*ListInstancesResponse, error)
	// Returns package instances that have all given tags attached.
	//
	// Queries only instances of some particular package (i.e. this is not a
	// global query).
	//
	// Callers must have roles READER (or above) for the package prefix. Returns
	// PERMISSION_DENIED otherwise.
	//
	// If the package doesn't exist, returns NOT_FOUND.
	SearchInstances(ctx context.Context, in *SearchInstancesRequest, opts ...grpc.CallOption) (*SearchInstancesResponse, error)
	// Creates a new ref or moves an existing one.
	//
	// A ref is a mutable named pointer to some existing package instance that
	// can be used as a version identifier. For example, "latest" or "stable".
	//
	// Refs are namespaced to some particular package. E.g. "latest" ref in
	// packages "A" and "B" are completely different entities not related to each
	// other.
	//
	// Pointing a ref to an instance generally makes the instance "discoverable".
	// For that reason the ref can be set only to instances that successfully
	// passed all post-registration processing.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a WRITER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance the ref points to doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed.
	//	ABORTED if the instance has some failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	CreateRef(ctx context.Context, in *Ref, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// Removes a ref.
	//
	// Not a failure if there's no such ref.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a WRITER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package doesn't exist.
	DeleteRef(ctx context.Context, in *DeleteRefRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// Lists refs defined in a package, most recently modified first.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package doesn't exist.
	ListRefs(ctx context.Context, in *ListRefsRequest, opts ...grpc.CallOption) (*ListRefsResponse, error)
	// Attaches one or more tags to an instance.
	//
	// Silently skips already attached tags.
	//
	// Tags are "key:value" pairs associated with a concrete package instance.
	// They can be used for querying registered instances and for version
	// resolution: if a tag is attached to one and only one instance of a package,
	// the tag uniquely identifies this instance and such tag can be used as an
	// alias of the instance ID.
	//
	// Tags generally should be assumed globally namespaced (e.g. it makes sense
	// to query for all registered instances with a given tag, across all
	// packages), and they don't have to be unique: same tag may be attached to
	// multiple instances (of the same or different packages).
	//
	// Additionally, tags (unlike refs) are intended to be mostly static, since
	// they usually relate to some properties of package instances, which are
	// static entities. This is particularity important for tags used for version
	// resolution.
	//
	// Attaching a tag to an instance generally makes the instance "discoverable".
	// For that reason tags can be attached only to instances that successfully
	// passed all post-registration processing.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a WRITER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed.
	//	ABORTED if the instance has some failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	AttachTags(ctx context.Context, in *AttachTagsRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// Detaches one or more tags if they were attached.
	//
	// This call should not be used routinely, since tags are assumed to be
	// static (and thus not detachable).
	//
	// It is occasionally useful for fixing screw ups though. For that reason,
	// DetachTags is allowed only by OWNERS of a prefix (not WRITERS, like
	// AttachTags).
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not an OWNER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	DetachTags(ctx context.Context, in *DetachTagsRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// Attaches one or more metadata entries to an instance.
	//
	// An instance metadata entry is a key-value pair, where the key is a
	// lowercase string and the value is an arbitrary blob up to 512 Kb in size.
	//
	// A single key can have multiple different values associated with it.
	// Completely identical key-value pairs are deduplicated: attaching already
	// attached metadata is a noop. Thus all metadata of an instance is a
	// multimap, where a key maps to a set of unique values.
	//
	// A metadata entry is identified by its fingerprint: a hash of concatenated
	// key and value (see InstanceMetadata message for details). It can be used,
	// for example, to point to an entry to detach in DetachMetadata.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a WRITER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed.
	//	ABORTED if the instance has some failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	AttachMetadata(ctx context.Context, in *AttachMetadataRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// Detaches one or more metadata entries if they were attached.
	//
	// Entries are identified by their fingerprints. They can either be calculated
	// from a key-value pair by the client (see InstanceMetadata message for
	// details), by the server (if InstanceMetadata messages inside
	// DetachMetadataRequest have 'key' and 'value' populated, but not
	// 'fingerprint') or taken from some existing InstanceMetadata message (e.g.
	// from inside a ListMetadataResponse).
	//
	// Detaching metadata that doesn't exist is a noop.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not an OWNER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	DetachMetadata(ctx context.Context, in *DetachMetadataRequest, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// Lists metadata entries attached to an instance.
	//
	// Either returns all metadata or only entries with requested keys. The list
	// is sorted by the registration time of metadata entries (the most recent
	// first).
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	ListMetadata(ctx context.Context, in *ListMetadataRequest, opts ...grpc.CallOption) (*ListMetadataResponse, error)
	// Takes a version string and resolves it into a concrete package instance.
	//
	// A version string can be any of:
	//   - A string-encoded instance ID, e.g. "abcdef....".
	//   - A ref name, e.g. "latest".
	//   - A tag, e.g. "version:1.10.3".
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if there's no such package or version.
	//	FAILED_PRECONDITION if the tag resolves to multiple instances.
	ResolveVersion(ctx context.Context, in *ResolveVersionRequest, opts ...grpc.CallOption) (*Instance, error)
	// Produces a signed URL that can be used to fetch the package instance file.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if there's no such instance.
	GetInstanceURL(ctx context.Context, in *GetInstanceURLRequest, opts ...grpc.CallOption) (*ObjectURL, error)
	// Returns information about a package instance.
	//
	// Depending on fields set in the request, returns details such as when the
	// instance was registered and by whom, refs pointing to it, tags attached to
	// it, state of all processors that handled it (if any).
	//
	// May also be used as a simple instance presence check, if all describe_*
	// fields in the request are false. If the request succeeds, then the
	// instance exists.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the instance doesn't exist.
	DescribeInstance(ctx context.Context, in *DescribeInstanceRequest, opts ...grpc.CallOption) (*DescribeInstanceResponse, error)
	// Returns information about a CIPD client package.
	//
	// Used by the client self-update procedure.
	//
	// Returns:
	//
	//	NOT_FOUND if the package or the instance doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed.
	//	ABORTED if the instance has some failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	DescribeClient(ctx context.Context, in *DescribeClientRequest, opts ...grpc.CallOption) (*DescribeClientResponse, error)
	// Returns information about binaries extracted from bootstrap packages under
	// some prefix.
	//
	// This is a niche functionality used by some LUCI systems.
	//
	// Unlike other RPC methods here, it operates with a bunch of packages at
	// once. Errors that relate to a particular package instance (instead of the
	// request as a whole) are returned as google.rpc.Status inside the
	// corresponding BootstrapFile entry in DescribeBootstrapBundleResponse.
	// Possible statuses communicated that way:
	//
	//	NOT_FOUND if the requested version of the package doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed or it is not
	//	    a bootstrap package at all.
	//	ABORTED if the instance has failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	//
	// NOTE: The CIPD package server implements a REST endpoint which can be used
	// to retrieve the contents of bootstrap packages:
	//
	//	GET /bootstrap/<package>/+/<version>
	//
	// which will serve a 302 redirect to a signed url for the `file` contents.
	//
	// Returns:
	//
	//	OK if the request was accepted and (perhaps partially) processed.
	//	NOT_FOUND if none of the requested instances exist.
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	DescribeBootstrapBundle(ctx context.Context, in *DescribeBootstrapBundleRequest, opts ...grpc.CallOption) (*DescribeBootstrapBundleResponse, error)
}

RepositoryClient is the client API for Repository service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.

Manages CIPD packages and their associated metadata.

A package is a named collection of one or more versions of a group of files. A package should typically be used for a single software component or dataset, not a conglomeration. A package instance is a concrete incarnation of a such version: it is a real file, and it is identified by its SHA256 (or SHA1 for older packages) digest, represented by ObjectRef proto in the protocol.

A particular serialization of ObjectRef proto into a string is referred to as "instance ID" and it is used to identify package instances (mostly in the interface exposed by the CIPD command line client, but also in ResolveVersion RPC):

  • For legacy reasons SHA1 digests are encoded with lowercase hex encoding, which always results in 40 char ASCII strings).
  • Other digests are encoded using base64(digest + []byte{ref.HashAlgo}), where 'base64' is URL-safe and unpadded and '+' is concatenation. For SHA256 digests this results in 44 char ASCII strings that end with C.

Instance files themselves are zip archives with some additional metadata. They are produced and consumed by cipd CLI client, and the backend mostly doesn't care about their internal structure.

Package names look like rootless file system paths (e.g. "a/b/c"). The identifier of a package is always the full path. There's no notion of "relative paths", or "..", or any other similar constructs. The name of the last path component has no intrinsic significance either, though it is often used to denote a platform the package is intended for. For example "infra/tools/cipd/linux-amd64" package is intended for Linux running on amd64 architecture. This is just a convention, and it is not enforced nor understood by the backend.

Each element of the package namespace (known as "package path prefix" or just "prefix") can have some metadata attached to it. Currently it includes only an access control list (ACL) that specifies what roles are granted to what users for the given prefix and all packages underneath it.

For example, granting READER role to user@example.com in ACL associated with prefix "a/b/c" gives user@example.com permission to read all package instances of "a/b/c" and any packages below it (e.g. "a/b/c/d"). See Role enum for list of roles.

There's no finer permission granularity inside the package itself, e.g. it is not possible to allow to read some particular package instance, without allowing to read all instances of the package.

func NewRepositoryClient 

func NewRepositoryClient(cc grpc.ClientConnInterface) RepositoryClient

type RepositoryServer 

type RepositoryServer interface {
	// Returns metadata associated with the given prefix.
	//
	// Requires the caller to have OWNER role for the requested prefix or any of
	// parent prefixes, or be in a special global "cipd-prefixes-viewers" group,
	// otherwise the call fails with PERMISSION_DENIED error.
	//
	// If the caller has OWNER permission in any of parent prefixes, but the
	// requested prefix has no metadata associated with it, the call fails with
	// NOT_FOUND error.
	GetPrefixMetadata(context.Context, *PrefixRequest) (*PrefixMetadata, error)
	// Returns metadata associated with the given prefix and all parent prefixes.
	//
	// Requires the caller to have OWNER role for the requested prefix or any of
	// parent prefixes, or be in a special global "cipd-prefixes-viewers" group,
	// otherwise the call fails with PERMISSION_DENIED error.
	//
	// Note that if the caller has permission to see the metadata for the
	// requested prefix, they will also see metadata for all parent prefixes,
	// since it is needed to assemble the final metadata for the prefix (it
	// includes inherited properties from all parent prefixes).
	GetInheritedPrefixMetadata(context.Context, *PrefixRequest) (*InheritedPrefixMetadata, error)
	// Updates or creates metadata associated with the given prefix.
	//
	// Requires the caller to have OWNER role for the requested prefix or any of
	// parent prefixes, otherwise the call fails with PERMISSION_DENIED error.
	//
	// This method checks 'fingerprint' field of the PrefixMetadata object. If the
	// metadata for the given prefix already exists, and the fingerprint in the
	// request doesn't match the current fingerprint, the request fails with
	// FAILED_PRECONDITION error.
	//
	// If the metadata doesn't exist yet, its fingerprint is assumed to be empty
	// string. So pass empty fingerprint when creating initial metadata objects.
	//
	// If the caller passes empty fingerprint, but the metadata already exists,
	// the request fails with ALREADY_EXISTS error.
	//
	// Note that there's no way to delete metadata once it was created. Passing
	// empty PrefixMetadata object is the best that can be done.
	//
	// On success returns PrefixMetadata object with the updated fingerprint.
	UpdatePrefixMetadata(context.Context, *PrefixMetadata) (*PrefixMetadata, error)
	// Returns a set of roles the caller has in the given prefix.
	//
	// Unlike GetPrefixMetadata call that requires special permissions (since it
	// returns a lot of detailed information), GetRolesInPrefix can be called by
	// anyone.
	//
	// It understands and expands roles inheritance, e.g. if the caller is an
	// OWNER, the result will also contain WRITER and READER (as they are implied
	// by being an OWNER).
	//
	// Returns empty set of roles if the caller has no permissions to access the
	// prefix at all or such prefix doesn't exist.
	GetRolesInPrefix(context.Context, *PrefixRequest) (*RolesInPrefixResponse, error)
	// Returns a set of roles a specific identity has in the given prefix.
	//
	// This works the same way as GetRolesInPrefix, except:
	//   - The caller requires the same permission as GetPrefixMetadata.
	//   - Uses PrefixRequestOnBehalfOf.identity, rather than the caller's
	//     identity, for determining the returned Roles.
	GetRolesInPrefixOnBehalfOf(context.Context, *PrefixRequestOnBehalfOf) (*RolesInPrefixResponse, error)
	// Lists packages and subprefixes registered under the prefix.
	//
	// Lists either only direct descendants or recursively all descendants. The
	// result is sorted lexicographically.
	//
	// For example, for packages ["a", "a/b", "a/c/d", "a/c/e/f"], listing of "a"
	// will be:
	//   - {packages: ["a/b"], prefixes: ["a/c"]} if listing non-recursively.
	//   - {packages: ["a/b", "a/c/d", "a/c/e/f"], prefixes: ["a/c", "a/c/e"]} if
	//     listing recursively.
	//
	// Returns only packages and prefixes visible to the caller. This applies even
	// when listing a prefix the caller has no direct read access to. For example,
	// recursively listing the root prefix will return all packages the caller has
	// read access to (no matter when in the hierarchy they are located), even if
	// the caller has no READER permission in the root. It works as if the caller
	// can freely browse the repository that contains only the packages they can
	// see and nothing else.
	ListPrefix(context.Context, *ListPrefixRequest) (*ListPrefixResponse, error)
	// HidePackage marks the package as hidden.
	//
	// This removes it from the ListPrefix results, but doesn't otherwise affect
	// its usage (e.g. it is still fetchable).
	//
	// Requires OWNER role for the package prefix. Returns PERMISSION_DENIED
	// otherwise.
	HidePackage(context.Context, *PackageRequest) (*emptypb.Empty, error)
	// UnhidePackage marks the package as visible again.
	//
	// It's reverse of HidePackage.
	//
	// Requires OWNER role for the package prefix. Returns PERMISSION_DENIED
	// otherwise.
	UnhidePackage(context.Context, *PackageRequest) (*emptypb.Empty, error)
	// DeletePackage removes the package (along with all its instances, tags, refs
	// etc) from the repository.
	//
	// There's no undo. Once the package is deleted, it is gone forever.
	//
	// This operation has a potential to break various pinned historical CIPD
	// ensure files and thus should not be used casually, only in extreme cases.
	// Consider just hiding the package instead of deleting it.
	//
	// For the reasons above, the operation requires admin access: only owners of
	// the repository root can delete packages.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a root owner.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package doesn't exist.
	DeletePackage(context.Context, *PackageRequest) (*emptypb.Empty, error)
	// Registers a package instance in the repository (if it was uploaded to the
	// storage already and wasn't registered yet) or initiates a new upload
	// operation.
	//
	// Callers are expected to execute the following protocol:
	//  1. Attempt to register a package instance by calling RegisterInstance.
	//  2. On NOT_UPLOADED status, upload the package data and finalize the
	//     upload operation using Storage RPC service and upload_op from the
	//     response.
	//  3. Once the upload operation is finalized, call RegisterInstance again,
	//     it should succeed with status REGISTERED now.
	//
	// If such instance is already registered by someone else, returns
	// ALREADY_REGISTERED status. This is not an error.
	//
	// Callers must have roles WRITER or OWNER for the package prefix. Returns
	// PERMISSION_DENIED otherwise.
	RegisterInstance(context.Context, *Instance) (*RegisterInstanceResponse, error)
	// Lists instances of a package, most recent first.
	//
	// Callers must have roles READER (or above) for the package prefix. Returns
	// PERMISSION_DENIED otherwise.
	//
	// If the package doesn't exist, returns NOT_FOUND.
	ListInstances(context.Context, *ListInstancesRequest) (*ListInstancesResponse, error)
	// Returns package instances that have all given tags attached.
	//
	// Queries only instances of some particular package (i.e. this is not a
	// global query).
	//
	// Callers must have roles READER (or above) for the package prefix. Returns
	// PERMISSION_DENIED otherwise.
	//
	// If the package doesn't exist, returns NOT_FOUND.
	SearchInstances(context.Context, *SearchInstancesRequest) (*SearchInstancesResponse, error)
	// Creates a new ref or moves an existing one.
	//
	// A ref is a mutable named pointer to some existing package instance that
	// can be used as a version identifier. For example, "latest" or "stable".
	//
	// Refs are namespaced to some particular package. E.g. "latest" ref in
	// packages "A" and "B" are completely different entities not related to each
	// other.
	//
	// Pointing a ref to an instance generally makes the instance "discoverable".
	// For that reason the ref can be set only to instances that successfully
	// passed all post-registration processing.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a WRITER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance the ref points to doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed.
	//	ABORTED if the instance has some failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	CreateRef(context.Context, *Ref) (*emptypb.Empty, error)
	// Removes a ref.
	//
	// Not a failure if there's no such ref.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a WRITER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package doesn't exist.
	DeleteRef(context.Context, *DeleteRefRequest) (*emptypb.Empty, error)
	// Lists refs defined in a package, most recently modified first.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package doesn't exist.
	ListRefs(context.Context, *ListRefsRequest) (*ListRefsResponse, error)
	// Attaches one or more tags to an instance.
	//
	// Silently skips already attached tags.
	//
	// Tags are "key:value" pairs associated with a concrete package instance.
	// They can be used for querying registered instances and for version
	// resolution: if a tag is attached to one and only one instance of a package,
	// the tag uniquely identifies this instance and such tag can be used as an
	// alias of the instance ID.
	//
	// Tags generally should be assumed globally namespaced (e.g. it makes sense
	// to query for all registered instances with a given tag, across all
	// packages), and they don't have to be unique: same tag may be attached to
	// multiple instances (of the same or different packages).
	//
	// Additionally, tags (unlike refs) are intended to be mostly static, since
	// they usually relate to some properties of package instances, which are
	// static entities. This is particularity important for tags used for version
	// resolution.
	//
	// Attaching a tag to an instance generally makes the instance "discoverable".
	// For that reason tags can be attached only to instances that successfully
	// passed all post-registration processing.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a WRITER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed.
	//	ABORTED if the instance has some failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	AttachTags(context.Context, *AttachTagsRequest) (*emptypb.Empty, error)
	// Detaches one or more tags if they were attached.
	//
	// This call should not be used routinely, since tags are assumed to be
	// static (and thus not detachable).
	//
	// It is occasionally useful for fixing screw ups though. For that reason,
	// DetachTags is allowed only by OWNERS of a prefix (not WRITERS, like
	// AttachTags).
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not an OWNER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	DetachTags(context.Context, *DetachTagsRequest) (*emptypb.Empty, error)
	// Attaches one or more metadata entries to an instance.
	//
	// An instance metadata entry is a key-value pair, where the key is a
	// lowercase string and the value is an arbitrary blob up to 512 Kb in size.
	//
	// A single key can have multiple different values associated with it.
	// Completely identical key-value pairs are deduplicated: attaching already
	// attached metadata is a noop. Thus all metadata of an instance is a
	// multimap, where a key maps to a set of unique values.
	//
	// A metadata entry is identified by its fingerprint: a hash of concatenated
	// key and value (see InstanceMetadata message for details). It can be used,
	// for example, to point to an entry to detach in DetachMetadata.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a WRITER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed.
	//	ABORTED if the instance has some failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	AttachMetadata(context.Context, *AttachMetadataRequest) (*emptypb.Empty, error)
	// Detaches one or more metadata entries if they were attached.
	//
	// Entries are identified by their fingerprints. They can either be calculated
	// from a key-value pair by the client (see InstanceMetadata message for
	// details), by the server (if InstanceMetadata messages inside
	// DetachMetadataRequest have 'key' and 'value' populated, but not
	// 'fingerprint') or taken from some existing InstanceMetadata message (e.g.
	// from inside a ListMetadataResponse).
	//
	// Detaching metadata that doesn't exist is a noop.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not an OWNER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	DetachMetadata(context.Context, *DetachMetadataRequest) (*emptypb.Empty, error)
	// Lists metadata entries attached to an instance.
	//
	// Either returns all metadata or only entries with requested keys. The list
	// is sorted by the registration time of metadata entries (the most recent
	// first).
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the package or the instance doesn't exist.
	ListMetadata(context.Context, *ListMetadataRequest) (*ListMetadataResponse, error)
	// Takes a version string and resolves it into a concrete package instance.
	//
	// A version string can be any of:
	//   - A string-encoded instance ID, e.g. "abcdef....".
	//   - A ref name, e.g. "latest".
	//   - A tag, e.g. "version:1.10.3".
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if there's no such package or version.
	//	FAILED_PRECONDITION if the tag resolves to multiple instances.
	ResolveVersion(context.Context, *ResolveVersionRequest) (*Instance, error)
	// Produces a signed URL that can be used to fetch the package instance file.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if there's no such instance.
	GetInstanceURL(context.Context, *GetInstanceURLRequest) (*ObjectURL, error)
	// Returns information about a package instance.
	//
	// Depending on fields set in the request, returns details such as when the
	// instance was registered and by whom, refs pointing to it, tags attached to
	// it, state of all processors that handled it (if any).
	//
	// May also be used as a simple instance presence check, if all describe_*
	// fields in the request are false. If the request succeeds, then the
	// instance exists.
	//
	// Returns:
	//
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	//	NOT_FOUND if the instance doesn't exist.
	DescribeInstance(context.Context, *DescribeInstanceRequest) (*DescribeInstanceResponse, error)
	// Returns information about a CIPD client package.
	//
	// Used by the client self-update procedure.
	//
	// Returns:
	//
	//	NOT_FOUND if the package or the instance doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed.
	//	ABORTED if the instance has some failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	DescribeClient(context.Context, *DescribeClientRequest) (*DescribeClientResponse, error)
	// Returns information about binaries extracted from bootstrap packages under
	// some prefix.
	//
	// This is a niche functionality used by some LUCI systems.
	//
	// Unlike other RPC methods here, it operates with a bunch of packages at
	// once. Errors that relate to a particular package instance (instead of the
	// request as a whole) are returned as google.rpc.Status inside the
	// corresponding BootstrapFile entry in DescribeBootstrapBundleResponse.
	// Possible statuses communicated that way:
	//
	//	NOT_FOUND if the requested version of the package doesn't exist.
	//	FAILED_PRECONDITION if the instance is still being processed or it is not
	//	    a bootstrap package at all.
	//	ABORTED if the instance has failed processors associated with it,
	//	    such instance is effectively broken and should not be used.
	//
	// NOTE: The CIPD package server implements a REST endpoint which can be used
	// to retrieve the contents of bootstrap packages:
	//
	//	GET /bootstrap/<package>/+/<version>
	//
	// which will serve a 302 redirect to a signed url for the `file` contents.
	//
	// Returns:
	//
	//	OK if the request was accepted and (perhaps partially) processed.
	//	NOT_FOUND if none of the requested instances exist.
	//	PERMISSION_DENIED if the caller is not a READER for the prefix.
	//	INVALID_ARGUMENT if the request is malformed.
	DescribeBootstrapBundle(context.Context, *DescribeBootstrapBundleRequest) (*DescribeBootstrapBundleResponse, error)
	// contains filtered or unexported methods
}

RepositoryServer is the server API for Repository service. All implementations must embed UnimplementedRepositoryServer for forward compatibility.

Manages CIPD packages and their associated metadata.

A package is a named collection of one or more versions of a group of files. A package should typically be used for a single software component or dataset, not a conglomeration. A package instance is a concrete incarnation of a such version: it is a real file, and it is identified by its SHA256 (or SHA1 for older packages) digest, represented by ObjectRef proto in the protocol.

A particular serialization of ObjectRef proto into a string is referred to as "instance ID" and it is used to identify package instances (mostly in the interface exposed by the CIPD command line client, but also in ResolveVersion RPC):

  • For legacy reasons SHA1 digests are encoded with lowercase hex encoding, which always results in 40 char ASCII strings).
  • Other digests are encoded using base64(digest + []byte{ref.HashAlgo}), where 'base64' is URL-safe and unpadded and '+' is concatenation. For SHA256 digests this results in 44 char ASCII strings that end with C.

Instance files themselves are zip archives with some additional metadata. They are produced and consumed by cipd CLI client, and the backend mostly doesn't care about their internal structure.

Package names look like rootless file system paths (e.g. "a/b/c"). The identifier of a package is always the full path. There's no notion of "relative paths", or "..", or any other similar constructs. The name of the last path component has no intrinsic significance either, though it is often used to denote a platform the package is intended for. For example "infra/tools/cipd/linux-amd64" package is intended for Linux running on amd64 architecture. This is just a convention, and it is not enforced nor understood by the backend.

Each element of the package namespace (known as "package path prefix" or just "prefix") can have some metadata attached to it. Currently it includes only an access control list (ACL) that specifies what roles are granted to what users for the given prefix and all packages underneath it.

For example, granting READER role to user@example.com in ACL associated with prefix "a/b/c" gives user@example.com permission to read all package instances of "a/b/c" and any packages below it (e.g. "a/b/c/d"). See Role enum for list of roles.

There's no finer permission granularity inside the package itself, e.g. it is not possible to allow to read some particular package instance, without allowing to read all instances of the package.

type ResolveVersionRequest 

type ResolveVersionRequest struct {

	// The package that contains the instance we are resolving version of.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The version string to resolve, see ResolveVersion for details.
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

func (*ResolveVersionRequest) Descriptor deprecated 

func (*ResolveVersionRequest) Descriptor() ([]byte, []int)

Deprecated: Use ResolveVersionRequest.ProtoReflect.Descriptor instead.

func (*ResolveVersionRequest) GetPackage 

func (x *ResolveVersionRequest) GetPackage() string

func (*ResolveVersionRequest) GetVersion 

func (x *ResolveVersionRequest) GetVersion() string

func (*ResolveVersionRequest) ProtoMessage 

func (*ResolveVersionRequest) ProtoMessage()

func (*ResolveVersionRequest) ProtoReflect 

func (x *ResolveVersionRequest) ProtoReflect() protoreflect.Message

func (*ResolveVersionRequest) Reset 

func (x *ResolveVersionRequest) Reset()

func (*ResolveVersionRequest) String 

func (x *ResolveVersionRequest) String() string

type Role 

type Role int32

Roles used in package prefix ACLs.

A user can have one or more such roles for a package prefix. They get inherited by all subprefixes. 

const (
	Role_ROLE_UNSPECIFIED Role = 0
	// Readers can fetch package instances and package metadata (e.g. list of
	// instances, all tags, all refs), but not prefix metadata (e.g. ACLs).
	Role_READER Role = 1
	// Writers can do everything that readers can, plus create new packages,
	// upload package instances, attach tags, move refs.
	Role_WRITER Role = 2
	// Owners can do everything that writers can, plus read prefix metadata for
	// all parent prefixes and all subprefixes, and modify prefix metadata for
	// all subprefixes.
	Role_OWNER Role = 3
)

func (Role) Descriptor 

func (Role) Descriptor() protoreflect.EnumDescriptor

func (Role) Enum 

func (x Role) Enum() *Role

func (Role) EnumDescriptor deprecated 

func (Role) EnumDescriptor() ([]byte, []int)

Deprecated: Use Role.Descriptor instead.

func (Role) Number 

func (x Role) Number() protoreflect.EnumNumber

func (Role) String 

func (x Role) String() string

func (Role) Type 

func (Role) Type() protoreflect.EnumType

type RolesInPrefixResponse 

type RolesInPrefixResponse struct {

	// Unordered set or roles the caller has in the requested prefix.
	Roles []*RolesInPrefixResponse_RoleInPrefix `protobuf:"bytes,1,rep,name=roles,proto3" json:"roles,omitempty"`
	// contains filtered or unexported fields
}

func (*RolesInPrefixResponse) Descriptor deprecated 

func (*RolesInPrefixResponse) Descriptor() ([]byte, []int)

Deprecated: Use RolesInPrefixResponse.ProtoReflect.Descriptor instead.

func (*RolesInPrefixResponse) GetRoles 

func (x *RolesInPrefixResponse) GetRoles() []*RolesInPrefixResponse_RoleInPrefix

func (*RolesInPrefixResponse) ProtoMessage 

func (*RolesInPrefixResponse) ProtoMessage()

func (*RolesInPrefixResponse) ProtoReflect 

func (x *RolesInPrefixResponse) ProtoReflect() protoreflect.Message

func (*RolesInPrefixResponse) Reset 

func (x *RolesInPrefixResponse) Reset()

func (*RolesInPrefixResponse) String 

func (x *RolesInPrefixResponse) String() string

type RolesInPrefixResponse_RoleInPrefix 

type RolesInPrefixResponse_RoleInPrefix struct {
	Role Role `protobuf:"varint,1,opt,name=role,proto3,enum=cipd.Role" json:"role,omitempty"`
	// contains filtered or unexported fields
}

func (*RolesInPrefixResponse_RoleInPrefix) Descriptor deprecated 

func (*RolesInPrefixResponse_RoleInPrefix) Descriptor() ([]byte, []int)

Deprecated: Use RolesInPrefixResponse_RoleInPrefix.ProtoReflect.Descriptor instead.

func (*RolesInPrefixResponse_RoleInPrefix) GetRole 

func (x *RolesInPrefixResponse_RoleInPrefix) GetRole() Role

func (*RolesInPrefixResponse_RoleInPrefix) ProtoMessage 

func (*RolesInPrefixResponse_RoleInPrefix) ProtoMessage()

func (*RolesInPrefixResponse_RoleInPrefix) ProtoReflect 

func (x *RolesInPrefixResponse_RoleInPrefix) ProtoReflect() protoreflect.Message

func (*RolesInPrefixResponse_RoleInPrefix) Reset 

func (x *RolesInPrefixResponse_RoleInPrefix) Reset()

func (*RolesInPrefixResponse_RoleInPrefix) String 

func (x *RolesInPrefixResponse_RoleInPrefix) String() string

type SearchInstancesRequest 

type SearchInstancesRequest struct {

	// Name of a package to query instances of (required).
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// Tags to look for (the found instances have ALL these tags attached).
	//
	// Due to internal limitations, the query is most efficient only when it
	// specifies one tag to filter by. All additional tags are checked in a
	// separate step after the initial query. For that reason when searching for
	// multiple tags it is better to specify the most limiting tags first.
	Tags []*Tag `protobuf:"bytes,2,rep,name=tags,proto3" json:"tags,omitempty"`
	// Number of instances to return on one page, default is 100.
	PageSize int32 `protobuf:"varint,20,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Value of 'next_page_token' from the previous response.
	//
	// Can be used to resume fetching.
	PageToken string `protobuf:"bytes,21,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// contains filtered or unexported fields
}

func (*SearchInstancesRequest) Descriptor deprecated 

func (*SearchInstancesRequest) Descriptor() ([]byte, []int)

Deprecated: Use SearchInstancesRequest.ProtoReflect.Descriptor instead.

func (*SearchInstancesRequest) GetPackage 

func (x *SearchInstancesRequest) GetPackage() string

func (*SearchInstancesRequest) GetPageSize 

func (x *SearchInstancesRequest) GetPageSize() int32

func (*SearchInstancesRequest) GetPageToken 

func (x *SearchInstancesRequest) GetPageToken() string

func (*SearchInstancesRequest) GetTags 

func (x *SearchInstancesRequest) GetTags() []*Tag

func (*SearchInstancesRequest) ProtoMessage 

func (*SearchInstancesRequest) ProtoMessage()

func (*SearchInstancesRequest) ProtoReflect 

func (x *SearchInstancesRequest) ProtoReflect() protoreflect.Message

func (*SearchInstancesRequest) Reset 

func (x *SearchInstancesRequest) Reset()

func (*SearchInstancesRequest) String 

func (x *SearchInstancesRequest) String() string

type SearchInstancesResponse 

type SearchInstancesResponse struct {

	// Package instances, sorted by registration time, most recent first.
	Instances []*Instance `protobuf:"bytes,1,rep,name=instances,proto3" json:"instances,omitempty"`
	// Value to pass as 'page_token' in SearchInstancesRequest to resume fetching
	// or empty string if there's no more results.
	NextPageToken string `protobuf:"bytes,20,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// contains filtered or unexported fields
}

func (*SearchInstancesResponse) Descriptor deprecated 

func (*SearchInstancesResponse) Descriptor() ([]byte, []int)

Deprecated: Use SearchInstancesResponse.ProtoReflect.Descriptor instead.

func (*SearchInstancesResponse) GetInstances 

func (x *SearchInstancesResponse) GetInstances() []*Instance

func (*SearchInstancesResponse) GetNextPageToken 

func (x *SearchInstancesResponse) GetNextPageToken() string

func (*SearchInstancesResponse) ProtoMessage 

func (*SearchInstancesResponse) ProtoMessage()

func (*SearchInstancesResponse) ProtoReflect 

func (x *SearchInstancesResponse) ProtoReflect() protoreflect.Message

func (*SearchInstancesResponse) Reset 

func (x *SearchInstancesResponse) Reset()

func (*SearchInstancesResponse) String 

func (x *SearchInstancesResponse) String() string

type StorageClient 

type StorageClient interface {
	// Produces a signed URL that can be used to fetch an object.
	//
	// Returns NOT_FOUND status code if there's no such object.
	GetObjectURL(ctx context.Context, in *GetObjectURLRequest, opts ...grpc.CallOption) (*ObjectURL, error)
	// Initiates an upload operation.
	//
	// Once the upload is initiated the client is responsible for uploading the
	// object to the temporary location (provided via 'upload_url' which should be
	// used as an upload URL in Google Storage Resumable Upload protocol) and
	// finishing the upload with a call to FinishUpload, which will launch
	// the verification of the object's hash on the server side.
	//
	// If the client knows the hash of the object it wants to upload already, it
	// can provide it via 'object' field. In that case Storage may reply right
	// away that such object already exists by retuning ALREADY_EXISTS status
	// code.
	//
	// If the client doesn't know the hash yet (perhaps if the object's body is
	// generated on the fly), it still can open an upload operation and start
	// streaming the data. When finalizing the upload the backend will calculate
	// and return the resulting hash of the object.
	//
	// An UploadOperation returned by this method contains tokens that grant
	// direct upload access to whoever possesses them, so it should be treated as
	// a secret. See UploadOperation for more info.
	BeginUpload(ctx context.Context, in *BeginUploadRequest, opts ...grpc.CallOption) (*UploadOperation, error)
	// Finishes the pending upload operation, returning its new status.
	//
	// Clients are expected to finish Google Storage Resumable protocol first
	// before calling FinishUpload. Failure to do so will cause the upload
	// operation to end up in ERROR state.
	//
	// This call is idempotent and it is expected that clients will keep polling
	// it if they want to wait for the server to verify the hash of the uploaded
	// object.
	//
	// Returns NOT_FOUND if the provided upload operation doesn't exist.
	//
	// Errors related to the uploaded file body are communicated through 'status'
	// field of the upload operation, since they are not directly related to this
	// RPC call, but rather to the upload operation itself.
	FinishUpload(ctx context.Context, in *FinishUploadRequest, opts ...grpc.CallOption) (*UploadOperation, error)
	// CancelUpload aborts the pending upload operation.
	//
	// It moves it to CANCELED state if it was in UPLOADING state and cleans up
	// any temporary garbage. Returns the most recent state of the upload
	// operation (whatever it may be).
	//
	// Does nothing if the operation is already canceled or failed.
	//
	// Returns:
	//
	//	NOT_FOUND if the provided upload operation doesn't exist.
	//	FAILED_PRECONDITION if the upload operation is in PUBLISHED or VERIFYING
	//	   state (i.e. finished or being finalized now).
	CancelUpload(ctx context.Context, in *CancelUploadRequest, opts ...grpc.CallOption) (*UploadOperation, error)
}

StorageClient is the client API for Storage service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.

Exposes content-addressable storage that stores the package files.

All CIPD package instances (actual physical files) are residing in this storage, and the package repository data structures just reference them by their digest.

Most of the Storage service API is used internally by the backend and corresponding RPC methods are ACLed only to admins, with exception of FinishUpload that is allowed to be used directly by clients to finalize upload operations started by the backend.

func NewStorageClient 

func NewStorageClient(cc grpc.ClientConnInterface) StorageClient

type StorageServer 

type StorageServer interface {
	// Produces a signed URL that can be used to fetch an object.
	//
	// Returns NOT_FOUND status code if there's no such object.
	GetObjectURL(context.Context, *GetObjectURLRequest) (*ObjectURL, error)
	// Initiates an upload operation.
	//
	// Once the upload is initiated the client is responsible for uploading the
	// object to the temporary location (provided via 'upload_url' which should be
	// used as an upload URL in Google Storage Resumable Upload protocol) and
	// finishing the upload with a call to FinishUpload, which will launch
	// the verification of the object's hash on the server side.
	//
	// If the client knows the hash of the object it wants to upload already, it
	// can provide it via 'object' field. In that case Storage may reply right
	// away that such object already exists by retuning ALREADY_EXISTS status
	// code.
	//
	// If the client doesn't know the hash yet (perhaps if the object's body is
	// generated on the fly), it still can open an upload operation and start
	// streaming the data. When finalizing the upload the backend will calculate
	// and return the resulting hash of the object.
	//
	// An UploadOperation returned by this method contains tokens that grant
	// direct upload access to whoever possesses them, so it should be treated as
	// a secret. See UploadOperation for more info.
	BeginUpload(context.Context, *BeginUploadRequest) (*UploadOperation, error)
	// Finishes the pending upload operation, returning its new status.
	//
	// Clients are expected to finish Google Storage Resumable protocol first
	// before calling FinishUpload. Failure to do so will cause the upload
	// operation to end up in ERROR state.
	//
	// This call is idempotent and it is expected that clients will keep polling
	// it if they want to wait for the server to verify the hash of the uploaded
	// object.
	//
	// Returns NOT_FOUND if the provided upload operation doesn't exist.
	//
	// Errors related to the uploaded file body are communicated through 'status'
	// field of the upload operation, since they are not directly related to this
	// RPC call, but rather to the upload operation itself.
	FinishUpload(context.Context, *FinishUploadRequest) (*UploadOperation, error)
	// CancelUpload aborts the pending upload operation.
	//
	// It moves it to CANCELED state if it was in UPLOADING state and cleans up
	// any temporary garbage. Returns the most recent state of the upload
	// operation (whatever it may be).
	//
	// Does nothing if the operation is already canceled or failed.
	//
	// Returns:
	//
	//	NOT_FOUND if the provided upload operation doesn't exist.
	//	FAILED_PRECONDITION if the upload operation is in PUBLISHED or VERIFYING
	//	   state (i.e. finished or being finalized now).
	CancelUpload(context.Context, *CancelUploadRequest) (*UploadOperation, error)
	// contains filtered or unexported methods
}

StorageServer is the server API for Storage service. All implementations must embed UnimplementedStorageServer for forward compatibility.

Exposes content-addressable storage that stores the package files.

All CIPD package instances (actual physical files) are residing in this storage, and the package repository data structures just reference them by their digest.

Most of the Storage service API is used internally by the backend and corresponding RPC methods are ACLed only to admins, with exception of FinishUpload that is allowed to be used directly by clients to finalize upload operations started by the backend.

type Tag 

type Tag struct {

	// Key is a lowercase string matching [a-z0-9_\-]+.
	Key string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
	// Value is a string matching [A-Za-z0-9$()*+,\-./:;<=>@\\_{}~ ]+.
	Value string `protobuf:"bytes,2,opt,name=value,proto3" json:"value,omitempty"`
	// User that attached this tag (output only).
	AttachedBy string `protobuf:"bytes,3,opt,name=attached_by,json=attachedBy,proto3" json:"attached_by,omitempty"`
	// When the tag was attached (output only).
	AttachedTs *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=attached_ts,json=attachedTs,proto3" json:"attached_ts,omitempty"`
	// contains filtered or unexported fields
}

Tag is a key:value pair attached to some instance.

Keys don't have to be unique, only the full pair should. For example, it is fine to have "version:1" and "version:2" tags attached to the same instance.

The total length of the tag (as "key:value" pair) should be less that 400 bytes.

func (*Tag) Descriptor deprecated 

func (*Tag) Descriptor() ([]byte, []int)

Deprecated: Use Tag.ProtoReflect.Descriptor instead.

func (*Tag) GetAttachedBy 

func (x *Tag) GetAttachedBy() string

func (*Tag) GetAttachedTs 

func (x *Tag) GetAttachedTs() *timestamppb.Timestamp

func (*Tag) GetKey 

func (x *Tag) GetKey() string

func (*Tag) GetValue 

func (x *Tag) GetValue() string

func (*Tag) ProtoMessage 

func (*Tag) ProtoMessage()

func (*Tag) ProtoReflect 

func (x *Tag) ProtoReflect() protoreflect.Message

func (*Tag) Reset 

func (x *Tag) Reset()

func (*Tag) String 

func (x *Tag) String() string

type UnimplementedRepositoryServer 

type UnimplementedRepositoryServer struct{}

UnimplementedRepositoryServer must be embedded to have forward compatible implementations.

NOTE: this should be embedded by value instead of pointer to avoid a nil pointer dereference when methods are called.

func (UnimplementedRepositoryServer) AttachMetadata 

func (UnimplementedRepositoryServer) AttachMetadata(context.Context, *AttachMetadataRequest) (*emptypb.Empty, error)

func (UnimplementedRepositoryServer) AttachTags 

func (UnimplementedRepositoryServer) AttachTags(context.Context, *AttachTagsRequest) (*emptypb.Empty, error)

func (UnimplementedRepositoryServer) CreateRef 

func (UnimplementedRepositoryServer) CreateRef(context.Context, *Ref) (*emptypb.Empty, error)

func (UnimplementedRepositoryServer) DeletePackage 

func (UnimplementedRepositoryServer) DeletePackage(context.Context, *PackageRequest) (*emptypb.Empty, error)

func (UnimplementedRepositoryServer) DeleteRef 

func (UnimplementedRepositoryServer) DeleteRef(context.Context, *DeleteRefRequest) (*emptypb.Empty, error)

func (UnimplementedRepositoryServer) DescribeBootstrapBundle 

func (UnimplementedRepositoryServer) DescribeBootstrapBundle(context.Context, *DescribeBootstrapBundleRequest) (*DescribeBootstrapBundleResponse, error)

func (UnimplementedRepositoryServer) DescribeClient 

func (UnimplementedRepositoryServer) DescribeClient(context.Context, *DescribeClientRequest) (*DescribeClientResponse, error)

func (UnimplementedRepositoryServer) DescribeInstance 

func (UnimplementedRepositoryServer) DescribeInstance(context.Context, *DescribeInstanceRequest) (*DescribeInstanceResponse, error)

func (UnimplementedRepositoryServer) DetachMetadata 

func (UnimplementedRepositoryServer) DetachMetadata(context.Context, *DetachMetadataRequest) (*emptypb.Empty, error)

func (UnimplementedRepositoryServer) DetachTags 

func (UnimplementedRepositoryServer) DetachTags(context.Context, *DetachTagsRequest) (*emptypb.Empty, error)

func (UnimplementedRepositoryServer) GetInheritedPrefixMetadata 

func (UnimplementedRepositoryServer) GetInheritedPrefixMetadata(context.Context, *PrefixRequest) (*InheritedPrefixMetadata, error)

func (UnimplementedRepositoryServer) GetInstanceURL 

func (UnimplementedRepositoryServer) GetInstanceURL(context.Context, *GetInstanceURLRequest) (*ObjectURL, error)

func (UnimplementedRepositoryServer) GetPrefixMetadata 

func (UnimplementedRepositoryServer) GetPrefixMetadata(context.Context, *PrefixRequest) (*PrefixMetadata, error)

func (UnimplementedRepositoryServer) GetRolesInPrefix 

func (UnimplementedRepositoryServer) GetRolesInPrefix(context.Context, *PrefixRequest) (*RolesInPrefixResponse, error)

func (UnimplementedRepositoryServer) GetRolesInPrefixOnBehalfOf 

func (UnimplementedRepositoryServer) GetRolesInPrefixOnBehalfOf(context.Context, *PrefixRequestOnBehalfOf) (*RolesInPrefixResponse, error)

func (UnimplementedRepositoryServer) HidePackage 

func (UnimplementedRepositoryServer) HidePackage(context.Context, *PackageRequest) (*emptypb.Empty, error)

func (UnimplementedRepositoryServer) ListInstances 

func (UnimplementedRepositoryServer) ListInstances(context.Context, *ListInstancesRequest) (*ListInstancesResponse, error)

func (UnimplementedRepositoryServer) ListMetadata 

func (UnimplementedRepositoryServer) ListMetadata(context.Context, *ListMetadataRequest) (*ListMetadataResponse, error)

func (UnimplementedRepositoryServer) ListPrefix 

func (UnimplementedRepositoryServer) ListPrefix(context.Context, *ListPrefixRequest) (*ListPrefixResponse, error)

func (UnimplementedRepositoryServer) ListRefs 

func (UnimplementedRepositoryServer) ListRefs(context.Context, *ListRefsRequest) (*ListRefsResponse, error)

func (UnimplementedRepositoryServer) RegisterInstance 

func (UnimplementedRepositoryServer) RegisterInstance(context.Context, *Instance) (*RegisterInstanceResponse, error)

func (UnimplementedRepositoryServer) ResolveVersion 

func (UnimplementedRepositoryServer) ResolveVersion(context.Context, *ResolveVersionRequest) (*Instance, error)

func (UnimplementedRepositoryServer) SearchInstances 

func (UnimplementedRepositoryServer) SearchInstances(context.Context, *SearchInstancesRequest) (*SearchInstancesResponse, error)

func (UnimplementedRepositoryServer) UnhidePackage 

func (UnimplementedRepositoryServer) UnhidePackage(context.Context, *PackageRequest) (*emptypb.Empty, error)

func (UnimplementedRepositoryServer) UpdatePrefixMetadata 

func (UnimplementedRepositoryServer) UpdatePrefixMetadata(context.Context, *PrefixMetadata) (*PrefixMetadata, error)

type UnimplementedStorageServer 

type UnimplementedStorageServer struct{}

UnimplementedStorageServer must be embedded to have forward compatible implementations.

NOTE: this should be embedded by value instead of pointer to avoid a nil pointer dereference when methods are called.

func (UnimplementedStorageServer) BeginUpload 

func (UnimplementedStorageServer) BeginUpload(context.Context, *BeginUploadRequest) (*UploadOperation, error)

func (UnimplementedStorageServer) CancelUpload 

func (UnimplementedStorageServer) CancelUpload(context.Context, *CancelUploadRequest) (*UploadOperation, error)

func (UnimplementedStorageServer) FinishUpload 

func (UnimplementedStorageServer) FinishUpload(context.Context, *FinishUploadRequest) (*UploadOperation, error)

func (UnimplementedStorageServer) GetObjectURL 

func (UnimplementedStorageServer) GetObjectURL(context.Context, *GetObjectURLRequest) (*ObjectURL, error)

type UnsafeRepositoryServer 

type UnsafeRepositoryServer interface {
	// contains filtered or unexported methods
}

UnsafeRepositoryServer may be embedded to opt out of forward compatibility for this service. Use of this interface is not recommended, as added methods to RepositoryServer will result in compilation errors.

type UnsafeStorageServer 

type UnsafeStorageServer interface {
	// contains filtered or unexported methods
}

UnsafeStorageServer may be embedded to opt out of forward compatibility for this service. Use of this interface is not recommended, as added methods to StorageServer will result in compilation errors.

type UploadOperation 

type UploadOperation struct {

	// An opaque string that identifies this upload operation.
	//
	// It acts as a temporary authorization token for FinishUpload RPC. Treat it
	// as a secret.
	OperationId string `protobuf:"bytes,1,opt,name=operation_id,json=operationId,proto3" json:"operation_id,omitempty"`
	// URL the client should use in Google Storage Resumable Upload protocol to
	// upload the object's body.
	//
	// No authentication is required to upload data to this URL, so it also should
	// be treated as a secret.
	UploadUrl string `protobuf:"bytes,2,opt,name=upload_url,json=uploadUrl,proto3" json:"upload_url,omitempty"`
	// Status of the upload operation.
	Status UploadStatus `protobuf:"varint,3,opt,name=status,proto3,enum=cipd.UploadStatus" json:"status,omitempty"`
	// For PUBLISHED status, the reference to the published object.
	//
	// This is in particular useful for uploads when the hash of the object is not
	// known until the upload is finished.
	Object *ObjectRef `protobuf:"bytes,4,opt,name=object,proto3" json:"object,omitempty"`
	// For ERRORED status, a human readable error message.
	ErrorMessage string `protobuf:"bytes,5,opt,name=error_message,json=errorMessage,proto3" json:"error_message,omitempty"`
	// contains filtered or unexported fields
}

func (*UploadOperation) Descriptor deprecated 

func (*UploadOperation) Descriptor() ([]byte, []int)

Deprecated: Use UploadOperation.ProtoReflect.Descriptor instead.

func (*UploadOperation) GetErrorMessage 

func (x *UploadOperation) GetErrorMessage() string

func (*UploadOperation) GetObject 

func (x *UploadOperation) GetObject() *ObjectRef

func (*UploadOperation) GetOperationId 

func (x *UploadOperation) GetOperationId() string

func (*UploadOperation) GetStatus 

func (x *UploadOperation) GetStatus() UploadStatus

func (*UploadOperation) GetUploadUrl 

func (x *UploadOperation) GetUploadUrl() string

func (*UploadOperation) ProtoMessage 

func (*UploadOperation) ProtoMessage()

func (*UploadOperation) ProtoReflect 

func (x *UploadOperation) ProtoReflect() protoreflect.Message

func (*UploadOperation) Reset 

func (x *UploadOperation) Reset()

func (*UploadOperation) String 

func (x *UploadOperation) String() string

type UploadStatus 

type UploadStatus int32
const (
	UploadStatus_UPLOAD_STATUS_UNSPECIFIED UploadStatus = 0
	UploadStatus_UPLOADING                 UploadStatus = 1 // the data is being uploaded now
	UploadStatus_VERIFYING                 UploadStatus = 2 // the object's hash is being verified now
	UploadStatus_PUBLISHED                 UploadStatus = 3 // the object has been published in the CAS
	UploadStatus_ERRORED                   UploadStatus = 4 // there were fatal errors during the finalization
	UploadStatus_CANCELED                  UploadStatus = 5 // the operation was canceled via CancelUpload
)

func (UploadStatus) Descriptor 

func (UploadStatus) Descriptor() protoreflect.EnumDescriptor

func (UploadStatus) Enum 

func (x UploadStatus) Enum() *UploadStatus

func (UploadStatus) EnumDescriptor deprecated 

func (UploadStatus) EnumDescriptor() ([]byte, []int)

Deprecated: Use UploadStatus.Descriptor instead.

func (UploadStatus) Number 

func (x UploadStatus) Number() protoreflect.EnumNumber

func (UploadStatus) String 

func (x UploadStatus) String() string

func (UploadStatus) Type 

func (UploadStatus) Type() protoreflect.EnumType

type VerificationLogEntry 

type VerificationLogEntry struct {
	OperationId        int64  `protobuf:"varint,1,opt,name=operation_id,json=operationId,proto3" json:"operation_id,omitempty"`                       // matches UploadOperation.ID
	InitiatedBy        string `protobuf:"bytes,2,opt,name=initiated_by,json=initiatedBy,proto3" json:"initiated_by,omitempty"`                        // e.g. "user:someone@example.com"
	TempGsPath         string `protobuf:"bytes,3,opt,name=temp_gs_path,json=tempGsPath,proto3" json:"temp_gs_path,omitempty"`                         // the GS object in the staging area being verified
	ExpectedInstanceId string `protobuf:"bytes,4,opt,name=expected_instance_id,json=expectedInstanceId,proto3" json:"expected_instance_id,omitempty"` // may be empty if not known
	VerifiedInstanceId string `protobuf:"bytes,5,opt,name=verified_instance_id,json=verifiedInstanceId,proto3" json:"verified_instance_id,omitempty"` // always populated on success
	Submitted          int64  `protobuf:"varint,6,opt,name=submitted,proto3" json:"submitted,omitempty"`                                              // microseconds since epoch
	Started            int64  `protobuf:"varint,7,opt,name=started,proto3" json:"started,omitempty"`                                                  // microseconds since epoch
	Finished           int64  `protobuf:"varint,8,opt,name=finished,proto3" json:"finished,omitempty"`                                                // microseconds since epoch
	ServiceVersion     string `protobuf:"bytes,9,opt,name=service_version,json=serviceVersion,proto3" json:"service_version,omitempty"`               // GAE service version e.g. "4123-abcdef"
	ProcessId          string `protobuf:"bytes,10,opt,name=process_id,json=processId,proto3" json:"process_id,omitempty"`                             // identifier of the concrete backend process
	TraceId            string `protobuf:"bytes,11,opt,name=trace_id,json=traceId,proto3" json:"trace_id,omitempty"`                                   // Cloud Trace ID of the request
	FileSize           int64  `protobuf:"varint,12,opt,name=file_size,json=fileSize,proto3" json:"file_size,omitempty"`                               // total file size in bytes
	VerificationSpeed  int64  `protobuf:"varint,13,opt,name=verification_speed,json=verificationSpeed,proto3" json:"verification_speed,omitempty"`    // file_size / duration, in bytes per second
	Outcome            string `protobuf:"bytes,14,opt,name=outcome,proto3" json:"outcome,omitempty"`                                                  // see cas.UploadStatus enum
	Error              string `protobuf:"bytes,15,opt,name=error,proto3" json:"error,omitempty"`                                                      // error message, if any
	// contains filtered or unexported fields
}

VerificationLogEntry defines a schema for `verification` BigQuery table.

It records details about hash verification jobs, in particular to collect information for https://crbug.com/1261988.

This is a best effort log populated using in-memory buffers. Some entries may be dropped if a process crashes before it flushes the buffer.

Field types must be compatible with BigQuery Storage Write API, see https://cloud.google.com/bigquery/docs/write-api#data_type_conversions

func (*VerificationLogEntry) Descriptor deprecated 

func (*VerificationLogEntry) Descriptor() ([]byte, []int)

Deprecated: Use VerificationLogEntry.ProtoReflect.Descriptor instead.

func (*VerificationLogEntry) GetError 

func (x *VerificationLogEntry) GetError() string

func (*VerificationLogEntry) GetExpectedInstanceId 

func (x *VerificationLogEntry) GetExpectedInstanceId() string

func (*VerificationLogEntry) GetFileSize 

func (x *VerificationLogEntry) GetFileSize() int64

func (*VerificationLogEntry) GetFinished 

func (x *VerificationLogEntry) GetFinished() int64

func (*VerificationLogEntry) GetInitiatedBy 

func (x *VerificationLogEntry) GetInitiatedBy() string

func (*VerificationLogEntry) GetOperationId 

func (x *VerificationLogEntry) GetOperationId() int64

func (*VerificationLogEntry) GetOutcome 

func (x *VerificationLogEntry) GetOutcome() string

func (*VerificationLogEntry) GetProcessId 

func (x *VerificationLogEntry) GetProcessId() string

func (*VerificationLogEntry) GetServiceVersion 

func (x *VerificationLogEntry) GetServiceVersion() string

func (*VerificationLogEntry) GetStarted 

func (x *VerificationLogEntry) GetStarted() int64

func (*VerificationLogEntry) GetSubmitted 

func (x *VerificationLogEntry) GetSubmitted() int64

func (*VerificationLogEntry) GetTempGsPath 

func (x *VerificationLogEntry) GetTempGsPath() string

func (*VerificationLogEntry) GetTraceId 

func (x *VerificationLogEntry) GetTraceId() string

func (*VerificationLogEntry) GetVerificationSpeed 

func (x *VerificationLogEntry) GetVerificationSpeed() int64

func (*VerificationLogEntry) GetVerifiedInstanceId 

func (x *VerificationLogEntry) GetVerifiedInstanceId() string

func (*VerificationLogEntry) ProtoMessage 

func (*VerificationLogEntry) ProtoMessage()

func (*VerificationLogEntry) ProtoReflect 

func (x *VerificationLogEntry) ProtoReflect() protoreflect.Message

func (*VerificationLogEntry) Reset 

func (x *VerificationLogEntry) Reset()

func (*VerificationLogEntry) String 

func (x *VerificationLogEntry) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.