api

package
v0.0.0-...-1643519 Latest Latest
Warning

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

 Go to latest Published: Jul 16, 2024 License: Apache-2.0 Imports: 12 Imported by: 16

Documentation

Overview

Package api contains CIPD backend API definitions.

Index

Constants

This section is empty.

Variables

View Source 
var HashAlgo_name = map[int32]string{
	0: "HASH_ALGO_UNSPECIFIED",
	1: "SHA1",
	2: "SHA256",
}
View Source 
var HashAlgo_value = map[string]int32{
	"HASH_ALGO_UNSPECIFIED": 0,
	"SHA1":                  1,
	"SHA256":                2,
}
View Source 
var Processor_State_name = map[int32]string{
	0: "STATE_UNSPECIFIED",
	1: "PENDING",
	2: "SUCCEEDED",
	3: "FAILED",
}
View Source 
var Processor_State_value = map[string]int32{
	"STATE_UNSPECIFIED": 0,
	"PENDING":           1,
	"SUCCEEDED":         2,
	"FAILED":            3,
}
View Source 
var RegistrationStatus_name = map[int32]string{
	0: "REGISTRATION_STATUS_UNSPECIFIED",
	1: "REGISTERED",
	2: "ALREADY_REGISTERED",
	3: "NOT_UPLOADED",
}
View Source 
var RegistrationStatus_value = map[string]int32{
	"REGISTRATION_STATUS_UNSPECIFIED": 0,
	"REGISTERED":                      1,
	"ALREADY_REGISTERED":              2,
	"NOT_UPLOADED":                    3,
}
View Source 
var Role_name = map[int32]string{
	0: "ROLE_UNSPECIFIED",
	1: "READER",
	2: "WRITER",
	3: "OWNER",
}
View Source 
var Role_value = map[string]int32{
	"ROLE_UNSPECIFIED": 0,
	"READER":           1,
	"WRITER":           2,
	"OWNER":            3,
}
View Source 
var UploadStatus_name = map[int32]string{
	0: "UPLOAD_STATUS_UNSPECIFIED",
	1: "UPLOADING",
	2: "VERIFYING",
	3: "PUBLISHED",
	4: "ERRORED",
	5: "CANCELED",
}
View Source 
var UploadStatus_value = map[string]int32{
	"UPLOAD_STATUS_UNSPECIFIED": 0,
	"UPLOADING":                 1,
	"VERIFYING":                 2,
	"PUBLISHED":                 3,
	"ERRORED":                   4,
	"CANCELED":                  5,
}

Functions

func FileDescriptorSet 

func FileDescriptorSet() *descriptor.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 prpc.Registrar, srv RepositoryServer)

func RegisterStorageServer 

func RegisterStorageServer(s prpc.Registrar, srv StorageServer)

Types

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*AttachTagsRequest) Descriptor 

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

func (*AttachTagsRequest) GetInstance 

func (m *AttachTagsRequest) GetInstance() *ObjectRef

func (*AttachTagsRequest) GetPackage 

func (m *AttachTagsRequest) GetPackage() string

func (*AttachTagsRequest) GetTags 

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

func (*AttachTagsRequest) ProtoMessage 

func (*AttachTagsRequest) ProtoMessage()

func (*AttachTagsRequest) Reset 

func (m *AttachTagsRequest) Reset()

func (*AttachTagsRequest) String 

func (m *AttachTagsRequest) String() string

func (*AttachTagsRequest) XXX_DiscardUnknown 

func (m *AttachTagsRequest) XXX_DiscardUnknown()

func (*AttachTagsRequest) XXX_Marshal 

func (m *AttachTagsRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*AttachTagsRequest) XXX_Merge 

func (m *AttachTagsRequest) XXX_Merge(src proto.Message)

func (*AttachTagsRequest) XXX_Size 

func (m *AttachTagsRequest) XXX_Size() int

func (*AttachTagsRequest) XXX_Unmarshal 

func (m *AttachTagsRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*BeginUploadRequest) Descriptor 

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

func (*BeginUploadRequest) GetHashAlgo 

func (m *BeginUploadRequest) GetHashAlgo() HashAlgo

func (*BeginUploadRequest) GetObject 

func (m *BeginUploadRequest) GetObject() *ObjectRef

func (*BeginUploadRequest) ProtoMessage 

func (*BeginUploadRequest) ProtoMessage()

func (*BeginUploadRequest) Reset 

func (m *BeginUploadRequest) Reset()

func (*BeginUploadRequest) String 

func (m *BeginUploadRequest) String() string

func (*BeginUploadRequest) XXX_DiscardUnknown 

func (m *BeginUploadRequest) XXX_DiscardUnknown()

func (*BeginUploadRequest) XXX_Marshal 

func (m *BeginUploadRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*BeginUploadRequest) XXX_Merge 

func (m *BeginUploadRequest) XXX_Merge(src proto.Message)

func (*BeginUploadRequest) XXX_Size 

func (m *BeginUploadRequest) XXX_Size() int

func (*BeginUploadRequest) XXX_Unmarshal 

func (m *BeginUploadRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*CancelUploadRequest) Descriptor 

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

func (*CancelUploadRequest) GetUploadOperationId 

func (m *CancelUploadRequest) GetUploadOperationId() string

func (*CancelUploadRequest) ProtoMessage 

func (*CancelUploadRequest) ProtoMessage()

func (*CancelUploadRequest) Reset 

func (m *CancelUploadRequest) Reset()

func (*CancelUploadRequest) String 

func (m *CancelUploadRequest) String() string

func (*CancelUploadRequest) XXX_DiscardUnknown 

func (m *CancelUploadRequest) XXX_DiscardUnknown()

func (*CancelUploadRequest) XXX_Marshal 

func (m *CancelUploadRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*CancelUploadRequest) XXX_Merge 

func (m *CancelUploadRequest) XXX_Merge(src proto.Message)

func (*CancelUploadRequest) XXX_Size 

func (m *CancelUploadRequest) XXX_Size() int

func (*CancelUploadRequest) XXX_Unmarshal 

func (m *CancelUploadRequest) XXX_Unmarshal(b []byte) error

type DecoratedStorage 

type DecoratedStorage struct {
	// Service is the service to decorate.
	Service StorageServer
	// Prelude is called for each method before forwarding the call to Service.
	// If Prelude returns an error, then the call is skipped and the error is
	// processed via the Postlude (if one is defined), or it is returned directly.
	Prelude func(c context.Context, methodName string, req proto.Message) (context.Context, error)
	// Postlude is called for each method after Service has processed the call, or
	// after the Prelude has returned an error. This takes the the Service's
	// response proto (which may be nil) and/or any error. The decorated
	// service will return the response (possibly mutated) and error that Postlude
	// returns.
	Postlude func(c context.Context, methodName string, rsp proto.Message, err error) error
}

func (*DecoratedStorage) BeginUpload 

func (s *DecoratedStorage) BeginUpload(c context.Context, req *BeginUploadRequest) (rsp *UploadOperation, err error)

func (*DecoratedStorage) CancelUpload 

func (s *DecoratedStorage) CancelUpload(c context.Context, req *CancelUploadRequest) (rsp *UploadOperation, err error)

func (*DecoratedStorage) FinishUpload 

func (s *DecoratedStorage) FinishUpload(c context.Context, req *FinishUploadRequest) (rsp *UploadOperation, err error)

func (*DecoratedStorage) GetObjectURL 

func (s *DecoratedStorage) GetObjectURL(c context.Context, req *GetObjectURLRequest) (rsp *ObjectURL, err error)

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*DeleteRefRequest) Descriptor 

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

func (*DeleteRefRequest) GetName 

func (m *DeleteRefRequest) GetName() string

func (*DeleteRefRequest) GetPackage 

func (m *DeleteRefRequest) GetPackage() string

func (*DeleteRefRequest) ProtoMessage 

func (*DeleteRefRequest) ProtoMessage()

func (*DeleteRefRequest) Reset 

func (m *DeleteRefRequest) Reset()

func (*DeleteRefRequest) String 

func (m *DeleteRefRequest) String() string

func (*DeleteRefRequest) XXX_DiscardUnknown 

func (m *DeleteRefRequest) XXX_DiscardUnknown()

func (*DeleteRefRequest) XXX_Marshal 

func (m *DeleteRefRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DeleteRefRequest) XXX_Merge 

func (m *DeleteRefRequest) XXX_Merge(src proto.Message)

func (*DeleteRefRequest) XXX_Size 

func (m *DeleteRefRequest) XXX_Size() int

func (*DeleteRefRequest) XXX_Unmarshal 

func (m *DeleteRefRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{}   `json:"-"`
	XXX_unrecognized     []byte     `json:"-"`
	XXX_sizecache        int32      `json:"-"`
}

func (*DescribeClientRequest) Descriptor 

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

func (*DescribeClientRequest) GetInstance 

func (m *DescribeClientRequest) GetInstance() *ObjectRef

func (*DescribeClientRequest) GetPackage 

func (m *DescribeClientRequest) GetPackage() string

func (*DescribeClientRequest) ProtoMessage 

func (*DescribeClientRequest) ProtoMessage()

func (*DescribeClientRequest) Reset 

func (m *DescribeClientRequest) Reset()

func (*DescribeClientRequest) String 

func (m *DescribeClientRequest) String() string

func (*DescribeClientRequest) XXX_DiscardUnknown 

func (m *DescribeClientRequest) XXX_DiscardUnknown()

func (*DescribeClientRequest) XXX_Marshal 

func (m *DescribeClientRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DescribeClientRequest) XXX_Merge 

func (m *DescribeClientRequest) XXX_Merge(src proto.Message)

func (*DescribeClientRequest) XXX_Size 

func (m *DescribeClientRequest) XXX_Size() int

func (*DescribeClientRequest) XXX_Unmarshal 

func (m *DescribeClientRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{}     `json:"-"`
	XXX_unrecognized     []byte       `json:"-"`
	XXX_sizecache        int32        `json:"-"`
}

func (*DescribeClientResponse) Descriptor 

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

func (*DescribeClientResponse) GetClientBinary 

func (m *DescribeClientResponse) GetClientBinary() *ObjectURL

func (*DescribeClientResponse) GetClientRef 

func (m *DescribeClientResponse) GetClientRef() *ObjectRef

func (*DescribeClientResponse) GetClientRefAliases 

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

func (*DescribeClientResponse) GetClientSize 

func (m *DescribeClientResponse) GetClientSize() int64

func (*DescribeClientResponse) GetInstance 

func (m *DescribeClientResponse) GetInstance() *Instance

func (*DescribeClientResponse) GetLegacySha1 

func (m *DescribeClientResponse) GetLegacySha1() string

func (*DescribeClientResponse) ProtoMessage 

func (*DescribeClientResponse) ProtoMessage()

func (*DescribeClientResponse) Reset 

func (m *DescribeClientResponse) Reset()

func (*DescribeClientResponse) String 

func (m *DescribeClientResponse) String() string

func (*DescribeClientResponse) XXX_DiscardUnknown 

func (m *DescribeClientResponse) XXX_DiscardUnknown()

func (*DescribeClientResponse) XXX_Marshal 

func (m *DescribeClientResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DescribeClientResponse) XXX_Merge 

func (m *DescribeClientResponse) XXX_Merge(src proto.Message)

func (*DescribeClientResponse) XXX_Size 

func (m *DescribeClientResponse) XXX_Size() int

func (*DescribeClientResponse) XXX_Unmarshal 

func (m *DescribeClientResponse) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*DescribeInstanceRequest) Descriptor 

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

func (*DescribeInstanceRequest) GetDescribeProcessors 

func (m *DescribeInstanceRequest) GetDescribeProcessors() bool

func (*DescribeInstanceRequest) GetDescribeRefs 

func (m *DescribeInstanceRequest) GetDescribeRefs() bool

func (*DescribeInstanceRequest) GetDescribeTags 

func (m *DescribeInstanceRequest) GetDescribeTags() bool

func (*DescribeInstanceRequest) GetInstance 

func (m *DescribeInstanceRequest) GetInstance() *ObjectRef

func (*DescribeInstanceRequest) GetPackage 

func (m *DescribeInstanceRequest) GetPackage() string

func (*DescribeInstanceRequest) ProtoMessage 

func (*DescribeInstanceRequest) ProtoMessage()

func (*DescribeInstanceRequest) Reset 

func (m *DescribeInstanceRequest) Reset()

func (*DescribeInstanceRequest) String 

func (m *DescribeInstanceRequest) String() string

func (*DescribeInstanceRequest) XXX_DiscardUnknown 

func (m *DescribeInstanceRequest) XXX_DiscardUnknown()

func (*DescribeInstanceRequest) XXX_Marshal 

func (m *DescribeInstanceRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DescribeInstanceRequest) XXX_Merge 

func (m *DescribeInstanceRequest) XXX_Merge(src proto.Message)

func (*DescribeInstanceRequest) XXX_Size 

func (m *DescribeInstanceRequest) XXX_Size() int

func (*DescribeInstanceRequest) XXX_Unmarshal 

func (m *DescribeInstanceRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{}     `json:"-"`
	XXX_unrecognized     []byte       `json:"-"`
	XXX_sizecache        int32        `json:"-"`
}

func (*DescribeInstanceResponse) Descriptor 

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

func (*DescribeInstanceResponse) GetInstance 

func (m *DescribeInstanceResponse) GetInstance() *Instance

func (*DescribeInstanceResponse) GetProcessors 

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

func (*DescribeInstanceResponse) GetRefs 

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

func (*DescribeInstanceResponse) GetTags 

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

func (*DescribeInstanceResponse) ProtoMessage 

func (*DescribeInstanceResponse) ProtoMessage()

func (*DescribeInstanceResponse) Reset 

func (m *DescribeInstanceResponse) Reset()

func (*DescribeInstanceResponse) String 

func (m *DescribeInstanceResponse) String() string

func (*DescribeInstanceResponse) XXX_DiscardUnknown 

func (m *DescribeInstanceResponse) XXX_DiscardUnknown()

func (*DescribeInstanceResponse) XXX_Marshal 

func (m *DescribeInstanceResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DescribeInstanceResponse) XXX_Merge 

func (m *DescribeInstanceResponse) XXX_Merge(src proto.Message)

func (*DescribeInstanceResponse) XXX_Size 

func (m *DescribeInstanceResponse) XXX_Size() int

func (*DescribeInstanceResponse) XXX_Unmarshal 

func (m *DescribeInstanceResponse) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*DetachTagsRequest) Descriptor 

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

func (*DetachTagsRequest) GetInstance 

func (m *DetachTagsRequest) GetInstance() *ObjectRef

func (*DetachTagsRequest) GetPackage 

func (m *DetachTagsRequest) GetPackage() string

func (*DetachTagsRequest) GetTags 

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

func (*DetachTagsRequest) ProtoMessage 

func (*DetachTagsRequest) ProtoMessage()

func (*DetachTagsRequest) Reset 

func (m *DetachTagsRequest) Reset()

func (*DetachTagsRequest) String 

func (m *DetachTagsRequest) String() string

func (*DetachTagsRequest) XXX_DiscardUnknown 

func (m *DetachTagsRequest) XXX_DiscardUnknown()

func (*DetachTagsRequest) XXX_Marshal 

func (m *DetachTagsRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DetachTagsRequest) XXX_Merge 

func (m *DetachTagsRequest) XXX_Merge(src proto.Message)

func (*DetachTagsRequest) XXX_Size 

func (m *DetachTagsRequest) XXX_Size() int

func (*DetachTagsRequest) XXX_Unmarshal 

func (m *DetachTagsRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{}   `json:"-"`
	XXX_unrecognized     []byte     `json:"-"`
	XXX_sizecache        int32      `json:"-"`
}

func (*FinishUploadRequest) Descriptor 

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

func (*FinishUploadRequest) GetForceHash 

func (m *FinishUploadRequest) GetForceHash() *ObjectRef

func (*FinishUploadRequest) GetUploadOperationId 

func (m *FinishUploadRequest) GetUploadOperationId() string

func (*FinishUploadRequest) ProtoMessage 

func (*FinishUploadRequest) ProtoMessage()

func (*FinishUploadRequest) Reset 

func (m *FinishUploadRequest) Reset()

func (*FinishUploadRequest) String 

func (m *FinishUploadRequest) String() string

func (*FinishUploadRequest) XXX_DiscardUnknown 

func (m *FinishUploadRequest) XXX_DiscardUnknown()

func (*FinishUploadRequest) XXX_Marshal 

func (m *FinishUploadRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*FinishUploadRequest) XXX_Merge 

func (m *FinishUploadRequest) XXX_Merge(src proto.Message)

func (*FinishUploadRequest) XXX_Size 

func (m *FinishUploadRequest) XXX_Size() int

func (*FinishUploadRequest) XXX_Unmarshal 

func (m *FinishUploadRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{}   `json:"-"`
	XXX_unrecognized     []byte     `json:"-"`
	XXX_sizecache        int32      `json:"-"`
}

func (*GetInstanceURLRequest) Descriptor 

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

func (*GetInstanceURLRequest) GetInstance 

func (m *GetInstanceURLRequest) GetInstance() *ObjectRef

func (*GetInstanceURLRequest) GetPackage 

func (m *GetInstanceURLRequest) GetPackage() string

func (*GetInstanceURLRequest) ProtoMessage 

func (*GetInstanceURLRequest) ProtoMessage()

func (*GetInstanceURLRequest) Reset 

func (m *GetInstanceURLRequest) Reset()

func (*GetInstanceURLRequest) String 

func (m *GetInstanceURLRequest) String() string

func (*GetInstanceURLRequest) XXX_DiscardUnknown 

func (m *GetInstanceURLRequest) XXX_DiscardUnknown()

func (*GetInstanceURLRequest) XXX_Marshal 

func (m *GetInstanceURLRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*GetInstanceURLRequest) XXX_Merge 

func (m *GetInstanceURLRequest) XXX_Merge(src proto.Message)

func (*GetInstanceURLRequest) XXX_Size 

func (m *GetInstanceURLRequest) XXX_Size() int

func (*GetInstanceURLRequest) XXX_Unmarshal 

func (m *GetInstanceURLRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*GetObjectURLRequest) Descriptor 

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

func (*GetObjectURLRequest) GetDownloadFilename 

func (m *GetObjectURLRequest) GetDownloadFilename() string

func (*GetObjectURLRequest) GetObject 

func (m *GetObjectURLRequest) GetObject() *ObjectRef

func (*GetObjectURLRequest) ProtoMessage 

func (*GetObjectURLRequest) ProtoMessage()

func (*GetObjectURLRequest) Reset 

func (m *GetObjectURLRequest) Reset()

func (*GetObjectURLRequest) String 

func (m *GetObjectURLRequest) String() string

func (*GetObjectURLRequest) XXX_DiscardUnknown 

func (m *GetObjectURLRequest) XXX_DiscardUnknown()

func (*GetObjectURLRequest) XXX_Marshal 

func (m *GetObjectURLRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*GetObjectURLRequest) XXX_Merge 

func (m *GetObjectURLRequest) XXX_Merge(src proto.Message)

func (*GetObjectURLRequest) XXX_Size 

func (m *GetObjectURLRequest) XXX_Size() int

func (*GetObjectURLRequest) XXX_Unmarshal 

func (m *GetObjectURLRequest) XXX_Unmarshal(b []byte) error

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) EnumDescriptor 

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

func (HashAlgo) String 

func (x HashAlgo) String() string

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"`
	XXX_NoUnkeyedLiteral struct{}          `json:"-"`
	XXX_unrecognized     []byte            `json:"-"`
	XXX_sizecache        int32             `json:"-"`
}

func (*InheritedPrefixMetadata) Descriptor 

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

func (*InheritedPrefixMetadata) GetPerPrefixMetadata 

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

func (*InheritedPrefixMetadata) ProtoMessage 

func (*InheritedPrefixMetadata) ProtoMessage()

func (*InheritedPrefixMetadata) Reset 

func (m *InheritedPrefixMetadata) Reset()

func (*InheritedPrefixMetadata) String 

func (m *InheritedPrefixMetadata) String() string

func (*InheritedPrefixMetadata) XXX_DiscardUnknown 

func (m *InheritedPrefixMetadata) XXX_DiscardUnknown()

func (*InheritedPrefixMetadata) XXX_Marshal 

func (m *InheritedPrefixMetadata) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*InheritedPrefixMetadata) XXX_Merge 

func (m *InheritedPrefixMetadata) XXX_Merge(src proto.Message)

func (*InheritedPrefixMetadata) XXX_Size 

func (m *InheritedPrefixMetadata) XXX_Size() int

func (*InheritedPrefixMetadata) XXX_Unmarshal 

func (m *InheritedPrefixMetadata) XXX_Unmarshal(b []byte) error

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         *timestamp.Timestamp `protobuf:"bytes,4,opt,name=registered_ts,json=registeredTs,proto3" json:"registered_ts,omitempty"`
	XXX_NoUnkeyedLiteral struct{}             `json:"-"`
	XXX_unrecognized     []byte               `json:"-"`
	XXX_sizecache        int32                `json:"-"`
}

Instance is a pointer to an instance of some package.

func (*Instance) Descriptor 

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

func (*Instance) GetInstance 

func (m *Instance) GetInstance() *ObjectRef

func (*Instance) GetPackage 

func (m *Instance) GetPackage() string

func (*Instance) GetRegisteredBy 

func (m *Instance) GetRegisteredBy() string

func (*Instance) GetRegisteredTs 

func (m *Instance) GetRegisteredTs() *timestamp.Timestamp

func (*Instance) ProtoMessage 

func (*Instance) ProtoMessage()

func (*Instance) Reset 

func (m *Instance) Reset()

func (*Instance) String 

func (m *Instance) String() string

func (*Instance) XXX_DiscardUnknown 

func (m *Instance) XXX_DiscardUnknown()

func (*Instance) XXX_Marshal 

func (m *Instance) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Instance) XXX_Merge 

func (m *Instance) XXX_Merge(src proto.Message)

func (*Instance) XXX_Size 

func (m *Instance) XXX_Size() int

func (*Instance) XXX_Unmarshal 

func (m *Instance) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*ListInstancesRequest) Descriptor 

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

func (*ListInstancesRequest) GetPackage 

func (m *ListInstancesRequest) GetPackage() string

func (*ListInstancesRequest) GetPageSize 

func (m *ListInstancesRequest) GetPageSize() int32

func (*ListInstancesRequest) GetPageToken 

func (m *ListInstancesRequest) GetPageToken() string

func (*ListInstancesRequest) ProtoMessage 

func (*ListInstancesRequest) ProtoMessage()

func (*ListInstancesRequest) Reset 

func (m *ListInstancesRequest) Reset()

func (*ListInstancesRequest) String 

func (m *ListInstancesRequest) String() string

func (*ListInstancesRequest) XXX_DiscardUnknown 

func (m *ListInstancesRequest) XXX_DiscardUnknown()

func (*ListInstancesRequest) XXX_Marshal 

func (m *ListInstancesRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ListInstancesRequest) XXX_Merge 

func (m *ListInstancesRequest) XXX_Merge(src proto.Message)

func (*ListInstancesRequest) XXX_Size 

func (m *ListInstancesRequest) XXX_Size() int

func (*ListInstancesRequest) XXX_Unmarshal 

func (m *ListInstancesRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*ListInstancesResponse) Descriptor 

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

func (*ListInstancesResponse) GetInstances 

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

func (*ListInstancesResponse) GetNextPageToken 

func (m *ListInstancesResponse) GetNextPageToken() string

func (*ListInstancesResponse) ProtoMessage 

func (*ListInstancesResponse) ProtoMessage()

func (*ListInstancesResponse) Reset 

func (m *ListInstancesResponse) Reset()

func (*ListInstancesResponse) String 

func (m *ListInstancesResponse) String() string

func (*ListInstancesResponse) XXX_DiscardUnknown 

func (m *ListInstancesResponse) XXX_DiscardUnknown()

func (*ListInstancesResponse) XXX_Marshal 

func (m *ListInstancesResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ListInstancesResponse) XXX_Merge 

func (m *ListInstancesResponse) XXX_Merge(src proto.Message)

func (*ListInstancesResponse) XXX_Size 

func (m *ListInstancesResponse) XXX_Size() int

func (*ListInstancesResponse) XXX_Unmarshal 

func (m *ListInstancesResponse) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*ListPrefixRequest) Descriptor 

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

func (*ListPrefixRequest) GetIncludeHidden 

func (m *ListPrefixRequest) GetIncludeHidden() bool

func (*ListPrefixRequest) GetPrefix 

func (m *ListPrefixRequest) GetPrefix() string

func (*ListPrefixRequest) GetRecursive 

func (m *ListPrefixRequest) GetRecursive() bool

func (*ListPrefixRequest) ProtoMessage 

func (*ListPrefixRequest) ProtoMessage()

func (*ListPrefixRequest) Reset 

func (m *ListPrefixRequest) Reset()

func (*ListPrefixRequest) String 

func (m *ListPrefixRequest) String() string

func (*ListPrefixRequest) XXX_DiscardUnknown 

func (m *ListPrefixRequest) XXX_DiscardUnknown()

func (*ListPrefixRequest) XXX_Marshal 

func (m *ListPrefixRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ListPrefixRequest) XXX_Merge 

func (m *ListPrefixRequest) XXX_Merge(src proto.Message)

func (*ListPrefixRequest) XXX_Size 

func (m *ListPrefixRequest) XXX_Size() int

func (*ListPrefixRequest) XXX_Unmarshal 

func (m *ListPrefixRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*ListPrefixResponse) Descriptor 

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

func (*ListPrefixResponse) GetPackages 

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

func (*ListPrefixResponse) GetPrefixes 

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

func (*ListPrefixResponse) ProtoMessage 

func (*ListPrefixResponse) ProtoMessage()

func (*ListPrefixResponse) Reset 

func (m *ListPrefixResponse) Reset()

func (*ListPrefixResponse) String 

func (m *ListPrefixResponse) String() string

func (*ListPrefixResponse) XXX_DiscardUnknown 

func (m *ListPrefixResponse) XXX_DiscardUnknown()

func (*ListPrefixResponse) XXX_Marshal 

func (m *ListPrefixResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ListPrefixResponse) XXX_Merge 

func (m *ListPrefixResponse) XXX_Merge(src proto.Message)

func (*ListPrefixResponse) XXX_Size 

func (m *ListPrefixResponse) XXX_Size() int

func (*ListPrefixResponse) XXX_Unmarshal 

func (m *ListPrefixResponse) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*ListRefsRequest) Descriptor 

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

func (*ListRefsRequest) GetPackage 

func (m *ListRefsRequest) GetPackage() string

func (*ListRefsRequest) ProtoMessage 

func (*ListRefsRequest) ProtoMessage()

func (*ListRefsRequest) Reset 

func (m *ListRefsRequest) Reset()

func (*ListRefsRequest) String 

func (m *ListRefsRequest) String() string

func (*ListRefsRequest) XXX_DiscardUnknown 

func (m *ListRefsRequest) XXX_DiscardUnknown()

func (*ListRefsRequest) XXX_Marshal 

func (m *ListRefsRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ListRefsRequest) XXX_Merge 

func (m *ListRefsRequest) XXX_Merge(src proto.Message)

func (*ListRefsRequest) XXX_Size 

func (m *ListRefsRequest) XXX_Size() int

func (*ListRefsRequest) XXX_Unmarshal 

func (m *ListRefsRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*ListRefsResponse) Descriptor 

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

func (*ListRefsResponse) GetRefs 

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

func (*ListRefsResponse) ProtoMessage 

func (*ListRefsResponse) ProtoMessage()

func (*ListRefsResponse) Reset 

func (m *ListRefsResponse) Reset()

func (*ListRefsResponse) String 

func (m *ListRefsResponse) String() string

func (*ListRefsResponse) XXX_DiscardUnknown 

func (m *ListRefsResponse) XXX_DiscardUnknown()

func (*ListRefsResponse) XXX_Marshal 

func (m *ListRefsResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ListRefsResponse) XXX_Merge 

func (m *ListRefsResponse) XXX_Merge(src proto.Message)

func (*ListRefsResponse) XXX_Size 

func (m *ListRefsResponse) XXX_Size() int

func (*ListRefsResponse) XXX_Unmarshal 

func (m *ListRefsResponse) XXX_Unmarshal(b []byte) error

type ObjectRef 

type ObjectRef struct {
	HashAlgo             HashAlgo `protobuf:"varint,1,opt,name=hash_algo,json=hashAlgo,proto3,enum=cipd.HashAlgo" json:"hash_algo,omitempty"`
	HexDigest            string   `protobuf:"bytes,2,opt,name=hex_digest,json=hexDigest,proto3" json:"hex_digest,omitempty"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

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

func (*ObjectRef) Descriptor 

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

func (*ObjectRef) GetHashAlgo 

func (m *ObjectRef) GetHashAlgo() HashAlgo

func (*ObjectRef) GetHexDigest 

func (m *ObjectRef) GetHexDigest() string

func (*ObjectRef) ProtoMessage 

func (*ObjectRef) ProtoMessage()

func (*ObjectRef) Reset 

func (m *ObjectRef) Reset()

func (*ObjectRef) String 

func (m *ObjectRef) String() string

func (*ObjectRef) XXX_DiscardUnknown 

func (m *ObjectRef) XXX_DiscardUnknown()

func (*ObjectRef) XXX_Marshal 

func (m *ObjectRef) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ObjectRef) XXX_Merge 

func (m *ObjectRef) XXX_Merge(src proto.Message)

func (*ObjectRef) XXX_Size 

func (m *ObjectRef) XXX_Size() int

func (*ObjectRef) XXX_Unmarshal 

func (m *ObjectRef) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*ObjectURL) Descriptor 

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

func (*ObjectURL) GetSignedUrl 

func (m *ObjectURL) GetSignedUrl() string

func (*ObjectURL) ProtoMessage 

func (*ObjectURL) ProtoMessage()

func (*ObjectURL) Reset 

func (m *ObjectURL) Reset()

func (*ObjectURL) String 

func (m *ObjectURL) String() string

func (*ObjectURL) XXX_DiscardUnknown 

func (m *ObjectURL) XXX_DiscardUnknown()

func (*ObjectURL) XXX_Marshal 

func (m *ObjectURL) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ObjectURL) XXX_Merge 

func (m *ObjectURL) XXX_Merge(src proto.Message)

func (*ObjectURL) XXX_Size 

func (m *ObjectURL) XXX_Size() int

func (*ObjectURL) XXX_Unmarshal 

func (m *ObjectURL) XXX_Unmarshal(b []byte) error

type PackageRequest 

type PackageRequest struct {
	Package              string   `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

PackageRequest names a package and nothing else.

func (*PackageRequest) Descriptor 

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

func (*PackageRequest) GetPackage 

func (m *PackageRequest) GetPackage() string

func (*PackageRequest) ProtoMessage 

func (*PackageRequest) ProtoMessage()

func (*PackageRequest) Reset 

func (m *PackageRequest) Reset()

func (*PackageRequest) String 

func (m *PackageRequest) String() string

func (*PackageRequest) XXX_DiscardUnknown 

func (m *PackageRequest) XXX_DiscardUnknown()

func (*PackageRequest) XXX_Marshal 

func (m *PackageRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*PackageRequest) XXX_Merge 

func (m *PackageRequest) XXX_Merge(src proto.Message)

func (*PackageRequest) XXX_Size 

func (m *PackageRequest) XXX_Size() int

func (*PackageRequest) XXX_Unmarshal 

func (m *PackageRequest) XXX_Unmarshal(b []byte) error

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 *timestamp.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"`
	XXX_NoUnkeyedLiteral struct{}              `json:"-"`
	XXX_unrecognized     []byte                `json:"-"`
	XXX_sizecache        int32                 `json:"-"`
}

PrefixMetadata is metadata defined at some concrete package prefix.

It applies to this prefix and all subprefixes, recursively.

func (*PrefixMetadata) Descriptor 

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

func (*PrefixMetadata) GetAcls 

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

func (*PrefixMetadata) GetFingerprint 

func (m *PrefixMetadata) GetFingerprint() string

func (*PrefixMetadata) GetPrefix 

func (m *PrefixMetadata) GetPrefix() string

func (*PrefixMetadata) GetUpdateTime 

func (m *PrefixMetadata) GetUpdateTime() *timestamp.Timestamp

func (*PrefixMetadata) GetUpdateUser 

func (m *PrefixMetadata) GetUpdateUser() string

func (*PrefixMetadata) ProtoMessage 

func (*PrefixMetadata) ProtoMessage()

func (*PrefixMetadata) Reset 

func (m *PrefixMetadata) Reset()

func (*PrefixMetadata) String 

func (m *PrefixMetadata) String() string

func (*PrefixMetadata) XXX_DiscardUnknown 

func (m *PrefixMetadata) XXX_DiscardUnknown()

func (*PrefixMetadata) XXX_Marshal 

func (m *PrefixMetadata) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*PrefixMetadata) XXX_Merge 

func (m *PrefixMetadata) XXX_Merge(src proto.Message)

func (*PrefixMetadata) XXX_Size 

func (m *PrefixMetadata) XXX_Size() int

func (*PrefixMetadata) XXX_Unmarshal 

func (m *PrefixMetadata) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*PrefixMetadata_ACL) Descriptor 

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

func (*PrefixMetadata_ACL) GetPrincipals 

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

func (*PrefixMetadata_ACL) GetRole 

func (m *PrefixMetadata_ACL) GetRole() Role

func (*PrefixMetadata_ACL) ProtoMessage 

func (*PrefixMetadata_ACL) ProtoMessage()

func (*PrefixMetadata_ACL) Reset 

func (m *PrefixMetadata_ACL) Reset()

func (*PrefixMetadata_ACL) String 

func (m *PrefixMetadata_ACL) String() string

func (*PrefixMetadata_ACL) XXX_DiscardUnknown 

func (m *PrefixMetadata_ACL) XXX_DiscardUnknown()

func (*PrefixMetadata_ACL) XXX_Marshal 

func (m *PrefixMetadata_ACL) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*PrefixMetadata_ACL) XXX_Merge 

func (m *PrefixMetadata_ACL) XXX_Merge(src proto.Message)

func (*PrefixMetadata_ACL) XXX_Size 

func (m *PrefixMetadata_ACL) XXX_Size() int

func (*PrefixMetadata_ACL) XXX_Unmarshal 

func (m *PrefixMetadata_ACL) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*PrefixRequest) Descriptor 

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

func (*PrefixRequest) GetPrefix 

func (m *PrefixRequest) GetPrefix() string

func (*PrefixRequest) ProtoMessage 

func (*PrefixRequest) ProtoMessage()

func (*PrefixRequest) Reset 

func (m *PrefixRequest) Reset()

func (*PrefixRequest) String 

func (m *PrefixRequest) String() string

func (*PrefixRequest) XXX_DiscardUnknown 

func (m *PrefixRequest) XXX_DiscardUnknown()

func (*PrefixRequest) XXX_Marshal 

func (m *PrefixRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*PrefixRequest) XXX_Merge 

func (m *PrefixRequest) XXX_Merge(src proto.Message)

func (*PrefixRequest) XXX_Size 

func (m *PrefixRequest) XXX_Size() int

func (*PrefixRequest) XXX_Unmarshal 

func (m *PrefixRequest) XXX_Unmarshal(b []byte) error

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 *timestamp.Timestamp `protobuf:"bytes,3,opt,name=finished_ts,json=finishedTs,proto3" json:"finished_ts,omitempty"`
	// For SUCCEEDED state, result of the processing.
	Result *_struct.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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

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

func (*Processor) Descriptor 

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

func (*Processor) GetError 

func (m *Processor) GetError() string

func (*Processor) GetFinishedTs 

func (m *Processor) GetFinishedTs() *timestamp.Timestamp

func (*Processor) GetId 

func (m *Processor) GetId() string

func (*Processor) GetResult 

func (m *Processor) GetResult() *_struct.Struct

func (*Processor) GetState 

func (m *Processor) GetState() Processor_State

func (*Processor) ProtoMessage 

func (*Processor) ProtoMessage()

func (*Processor) Reset 

func (m *Processor) Reset()

func (*Processor) String 

func (m *Processor) String() string

func (*Processor) XXX_DiscardUnknown 

func (m *Processor) XXX_DiscardUnknown()

func (*Processor) XXX_Marshal 

func (m *Processor) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Processor) XXX_Merge 

func (m *Processor) XXX_Merge(src proto.Message)

func (*Processor) XXX_Size 

func (m *Processor) XXX_Size() int

func (*Processor) XXX_Unmarshal 

func (m *Processor) XXX_Unmarshal(b []byte) error

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) EnumDescriptor 

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

func (Processor_State) String 

func (x Processor_State) String() string

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           *timestamp.Timestamp `protobuf:"bytes,5,opt,name=modified_ts,json=modifiedTs,proto3" json:"modified_ts,omitempty"`
	XXX_NoUnkeyedLiteral struct{}             `json:"-"`
	XXX_unrecognized     []byte               `json:"-"`
	XXX_sizecache        int32                `json:"-"`
}

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

func (*Ref) Descriptor 

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

func (*Ref) GetInstance 

func (m *Ref) GetInstance() *ObjectRef

func (*Ref) GetModifiedBy 

func (m *Ref) GetModifiedBy() string

func (*Ref) GetModifiedTs 

func (m *Ref) GetModifiedTs() *timestamp.Timestamp

func (*Ref) GetName 

func (m *Ref) GetName() string

func (*Ref) GetPackage 

func (m *Ref) GetPackage() string

func (*Ref) ProtoMessage 

func (*Ref) ProtoMessage()

func (*Ref) Reset 

func (m *Ref) Reset()

func (*Ref) String 

func (m *Ref) String() string

func (*Ref) XXX_DiscardUnknown 

func (m *Ref) XXX_DiscardUnknown()

func (*Ref) XXX_Marshal 

func (m *Ref) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Ref) XXX_Merge 

func (m *Ref) XXX_Merge(src proto.Message)

func (*Ref) XXX_Size 

func (m *Ref) XXX_Size() int

func (*Ref) XXX_Unmarshal 

func (m *Ref) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{}         `json:"-"`
	XXX_unrecognized     []byte           `json:"-"`
	XXX_sizecache        int32            `json:"-"`
}

func (*RegisterInstanceResponse) Descriptor 

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

func (*RegisterInstanceResponse) GetInstance 

func (m *RegisterInstanceResponse) GetInstance() *Instance

func (*RegisterInstanceResponse) GetStatus 

func (m *RegisterInstanceResponse) GetStatus() RegistrationStatus

func (*RegisterInstanceResponse) GetUploadOp 

func (m *RegisterInstanceResponse) GetUploadOp() *UploadOperation

func (*RegisterInstanceResponse) ProtoMessage 

func (*RegisterInstanceResponse) ProtoMessage()

func (*RegisterInstanceResponse) Reset 

func (m *RegisterInstanceResponse) Reset()

func (*RegisterInstanceResponse) String 

func (m *RegisterInstanceResponse) String() string

func (*RegisterInstanceResponse) XXX_DiscardUnknown 

func (m *RegisterInstanceResponse) XXX_DiscardUnknown()

func (*RegisterInstanceResponse) XXX_Marshal 

func (m *RegisterInstanceResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*RegisterInstanceResponse) XXX_Merge 

func (m *RegisterInstanceResponse) XXX_Merge(src proto.Message)

func (*RegisterInstanceResponse) XXX_Size 

func (m *RegisterInstanceResponse) XXX_Size() int

func (*RegisterInstanceResponse) XXX_Unmarshal 

func (m *RegisterInstanceResponse) XXX_Unmarshal(b []byte) error

type RegistrationStatus 

type RegistrationStatus int32

RegistrationStatus is part of RegisterInstance RPC response. 

const (
	RegistrationStatus_REGISTRATION_STATUS_UNSPECIFIED RegistrationStatus = 0
	RegistrationStatus_REGISTERED                      RegistrationStatus = 1
	RegistrationStatus_ALREADY_REGISTERED              RegistrationStatus = 2
	RegistrationStatus_NOT_UPLOADED                    RegistrationStatus = 3
)

func (RegistrationStatus) EnumDescriptor 

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

func (RegistrationStatus) String 

func (x RegistrationStatus) String() string

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, 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, 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 OWNER access (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)
	// 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) (*empty.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) (*empty.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) (*empty.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) (*empty.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) (*empty.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) (*empty.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) (*empty.Empty, 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)
}

RepositoryClient is the client API for Repository service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.

func NewRepositoryClient 

func NewRepositoryClient(cc *grpc.ClientConn) RepositoryClient

func NewRepositoryPRPCClient 

func NewRepositoryPRPCClient(client *prpc.Client) 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, 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, 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 OWNER access (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)
	// 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) (*empty.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) (*empty.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) (*empty.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) (*empty.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) (*empty.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) (*empty.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) (*empty.Empty, 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)
}

RepositoryServer is the server API for Repository service.

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*ResolveVersionRequest) Descriptor 

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

func (*ResolveVersionRequest) GetPackage 

func (m *ResolveVersionRequest) GetPackage() string

func (*ResolveVersionRequest) GetVersion 

func (m *ResolveVersionRequest) GetVersion() string

func (*ResolveVersionRequest) ProtoMessage 

func (*ResolveVersionRequest) ProtoMessage()

func (*ResolveVersionRequest) Reset 

func (m *ResolveVersionRequest) Reset()

func (*ResolveVersionRequest) String 

func (m *ResolveVersionRequest) String() string

func (*ResolveVersionRequest) XXX_DiscardUnknown 

func (m *ResolveVersionRequest) XXX_DiscardUnknown()

func (*ResolveVersionRequest) XXX_Marshal 

func (m *ResolveVersionRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ResolveVersionRequest) XXX_Merge 

func (m *ResolveVersionRequest) XXX_Merge(src proto.Message)

func (*ResolveVersionRequest) XXX_Size 

func (m *ResolveVersionRequest) XXX_Size() int

func (*ResolveVersionRequest) XXX_Unmarshal 

func (m *ResolveVersionRequest) XXX_Unmarshal(b []byte) error

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) EnumDescriptor 

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

func (Role) String 

func (x Role) String() string

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"`
	XXX_NoUnkeyedLiteral struct{}                              `json:"-"`
	XXX_unrecognized     []byte                                `json:"-"`
	XXX_sizecache        int32                                 `json:"-"`
}

func (*RolesInPrefixResponse) Descriptor 

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

func (*RolesInPrefixResponse) GetRoles 

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

func (*RolesInPrefixResponse) ProtoMessage 

func (*RolesInPrefixResponse) ProtoMessage()

func (*RolesInPrefixResponse) Reset 

func (m *RolesInPrefixResponse) Reset()

func (*RolesInPrefixResponse) String 

func (m *RolesInPrefixResponse) String() string

func (*RolesInPrefixResponse) XXX_DiscardUnknown 

func (m *RolesInPrefixResponse) XXX_DiscardUnknown()

func (*RolesInPrefixResponse) XXX_Marshal 

func (m *RolesInPrefixResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*RolesInPrefixResponse) XXX_Merge 

func (m *RolesInPrefixResponse) XXX_Merge(src proto.Message)

func (*RolesInPrefixResponse) XXX_Size 

func (m *RolesInPrefixResponse) XXX_Size() int

func (*RolesInPrefixResponse) XXX_Unmarshal 

func (m *RolesInPrefixResponse) XXX_Unmarshal(b []byte) error

type RolesInPrefixResponse_RoleInPrefix 

type RolesInPrefixResponse_RoleInPrefix struct {
	Role                 Role     `protobuf:"varint,1,opt,name=role,proto3,enum=cipd.Role" json:"role,omitempty"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*RolesInPrefixResponse_RoleInPrefix) Descriptor 

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

func (*RolesInPrefixResponse_RoleInPrefix) GetRole 

func (m *RolesInPrefixResponse_RoleInPrefix) GetRole() Role

func (*RolesInPrefixResponse_RoleInPrefix) ProtoMessage 

func (*RolesInPrefixResponse_RoleInPrefix) ProtoMessage()

func (*RolesInPrefixResponse_RoleInPrefix) Reset 

func (m *RolesInPrefixResponse_RoleInPrefix) Reset()

func (*RolesInPrefixResponse_RoleInPrefix) String 

func (m *RolesInPrefixResponse_RoleInPrefix) String() string

func (*RolesInPrefixResponse_RoleInPrefix) XXX_DiscardUnknown 

func (m *RolesInPrefixResponse_RoleInPrefix) XXX_DiscardUnknown()

func (*RolesInPrefixResponse_RoleInPrefix) XXX_Marshal 

func (m *RolesInPrefixResponse_RoleInPrefix) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*RolesInPrefixResponse_RoleInPrefix) XXX_Merge 

func (m *RolesInPrefixResponse_RoleInPrefix) XXX_Merge(src proto.Message)

func (*RolesInPrefixResponse_RoleInPrefix) XXX_Size 

func (m *RolesInPrefixResponse_RoleInPrefix) XXX_Size() int

func (*RolesInPrefixResponse_RoleInPrefix) XXX_Unmarshal 

func (m *RolesInPrefixResponse_RoleInPrefix) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*SearchInstancesRequest) Descriptor 

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

func (*SearchInstancesRequest) GetPackage 

func (m *SearchInstancesRequest) GetPackage() string

func (*SearchInstancesRequest) GetPageSize 

func (m *SearchInstancesRequest) GetPageSize() int32

func (*SearchInstancesRequest) GetPageToken 

func (m *SearchInstancesRequest) GetPageToken() string

func (*SearchInstancesRequest) GetTags 

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

func (*SearchInstancesRequest) ProtoMessage 

func (*SearchInstancesRequest) ProtoMessage()

func (*SearchInstancesRequest) Reset 

func (m *SearchInstancesRequest) Reset()

func (*SearchInstancesRequest) String 

func (m *SearchInstancesRequest) String() string

func (*SearchInstancesRequest) XXX_DiscardUnknown 

func (m *SearchInstancesRequest) XXX_DiscardUnknown()

func (*SearchInstancesRequest) XXX_Marshal 

func (m *SearchInstancesRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*SearchInstancesRequest) XXX_Merge 

func (m *SearchInstancesRequest) XXX_Merge(src proto.Message)

func (*SearchInstancesRequest) XXX_Size 

func (m *SearchInstancesRequest) XXX_Size() int

func (*SearchInstancesRequest) XXX_Unmarshal 

func (m *SearchInstancesRequest) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*SearchInstancesResponse) Descriptor 

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

func (*SearchInstancesResponse) GetInstances 

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

func (*SearchInstancesResponse) GetNextPageToken 

func (m *SearchInstancesResponse) GetNextPageToken() string

func (*SearchInstancesResponse) ProtoMessage 

func (*SearchInstancesResponse) ProtoMessage()

func (*SearchInstancesResponse) Reset 

func (m *SearchInstancesResponse) Reset()

func (*SearchInstancesResponse) String 

func (m *SearchInstancesResponse) String() string

func (*SearchInstancesResponse) XXX_DiscardUnknown 

func (m *SearchInstancesResponse) XXX_DiscardUnknown()

func (*SearchInstancesResponse) XXX_Marshal 

func (m *SearchInstancesResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*SearchInstancesResponse) XXX_Merge 

func (m *SearchInstancesResponse) XXX_Merge(src proto.Message)

func (*SearchInstancesResponse) XXX_Size 

func (m *SearchInstancesResponse) XXX_Size() int

func (*SearchInstancesResponse) XXX_Unmarshal 

func (m *SearchInstancesResponse) XXX_Unmarshal(b []byte) error

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://godoc.org/google.golang.org/grpc#ClientConn.NewStream.

func NewStorageClient 

func NewStorageClient(cc *grpc.ClientConn) StorageClient

func NewStoragePRPCClient 

func NewStoragePRPCClient(client *prpc.Client) 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)
}

StorageServer is the server API for Storage service.

type Tag 

type Tag struct {
	// Key should be a lowercase identifier-like string ([a-z0-9_\-]+).
	Key string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
	// Value can be an arbitrary string.
	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           *timestamp.Timestamp `protobuf:"bytes,4,opt,name=attached_ts,json=attachedTs,proto3" json:"attached_ts,omitempty"`
	XXX_NoUnkeyedLiteral struct{}             `json:"-"`
	XXX_unrecognized     []byte               `json:"-"`
	XXX_sizecache        int32                `json:"-"`
}

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 

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

func (*Tag) GetAttachedBy 

func (m *Tag) GetAttachedBy() string

func (*Tag) GetAttachedTs 

func (m *Tag) GetAttachedTs() *timestamp.Timestamp

func (*Tag) GetKey 

func (m *Tag) GetKey() string

func (*Tag) GetValue 

func (m *Tag) GetValue() string

func (*Tag) ProtoMessage 

func (*Tag) ProtoMessage()

func (*Tag) Reset 

func (m *Tag) Reset()

func (*Tag) String 

func (m *Tag) String() string

func (*Tag) XXX_DiscardUnknown 

func (m *Tag) XXX_DiscardUnknown()

func (*Tag) XXX_Marshal 

func (m *Tag) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Tag) XXX_Merge 

func (m *Tag) XXX_Merge(src proto.Message)

func (*Tag) XXX_Size 

func (m *Tag) XXX_Size() int

func (*Tag) XXX_Unmarshal 

func (m *Tag) XXX_Unmarshal(b []byte) error

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"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

func (*UploadOperation) Descriptor 

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

func (*UploadOperation) GetErrorMessage 

func (m *UploadOperation) GetErrorMessage() string

func (*UploadOperation) GetObject 

func (m *UploadOperation) GetObject() *ObjectRef

func (*UploadOperation) GetOperationId 

func (m *UploadOperation) GetOperationId() string

func (*UploadOperation) GetStatus 

func (m *UploadOperation) GetStatus() UploadStatus

func (*UploadOperation) GetUploadUrl 

func (m *UploadOperation) GetUploadUrl() string

func (*UploadOperation) ProtoMessage 

func (*UploadOperation) ProtoMessage()

func (*UploadOperation) Reset 

func (m *UploadOperation) Reset()

func (*UploadOperation) String 

func (m *UploadOperation) String() string

func (*UploadOperation) XXX_DiscardUnknown 

func (m *UploadOperation) XXX_DiscardUnknown()

func (*UploadOperation) XXX_Marshal 

func (m *UploadOperation) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*UploadOperation) XXX_Merge 

func (m *UploadOperation) XXX_Merge(src proto.Message)

func (*UploadOperation) XXX_Size 

func (m *UploadOperation) XXX_Size() int

func (*UploadOperation) XXX_Unmarshal 

func (m *UploadOperation) XXX_Unmarshal(b []byte) error

type UploadStatus 

type UploadStatus int32
const (
	UploadStatus_UPLOAD_STATUS_UNSPECIFIED UploadStatus = 0
	UploadStatus_UPLOADING                 UploadStatus = 1
	UploadStatus_VERIFYING                 UploadStatus = 2
	UploadStatus_PUBLISHED                 UploadStatus = 3
	UploadStatus_ERRORED                   UploadStatus = 4
	UploadStatus_CANCELED                  UploadStatus = 5
)

func (UploadStatus) EnumDescriptor 

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

func (UploadStatus) String 

func (x UploadStatus) 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.