luci: go.chromium.org/luci/cipd/api/cipd/v1 Index | Files

package api

import "go.chromium.org/luci/cipd/api/cipd/v1"

Package api contains CIPD backend API definitions.

Index

Package Files

cas.pb.go gen.go pb.discovery.go repo.pb.go storageserver_dec.go

Variables

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

func FileDescriptorSet Uses

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 Uses

func RegisterRepositoryServer(s prpc.Registrar, srv RepositoryServer)

func RegisterStorageServer Uses

func RegisterStorageServer(s prpc.Registrar, srv StorageServer)

type AttachTagsRequest Uses

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 Uses

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

func (*AttachTagsRequest) GetInstance Uses

func (m *AttachTagsRequest) GetInstance() *ObjectRef

func (*AttachTagsRequest) GetPackage Uses

func (m *AttachTagsRequest) GetPackage() string

func (*AttachTagsRequest) GetTags Uses

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

func (*AttachTagsRequest) ProtoMessage Uses

func (*AttachTagsRequest) ProtoMessage()

func (*AttachTagsRequest) Reset Uses

func (m *AttachTagsRequest) Reset()

func (*AttachTagsRequest) String Uses

func (m *AttachTagsRequest) String() string

func (*AttachTagsRequest) XXX_DiscardUnknown Uses

func (m *AttachTagsRequest) XXX_DiscardUnknown()

func (*AttachTagsRequest) XXX_Marshal Uses

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

func (*AttachTagsRequest) XXX_Merge Uses

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

func (*AttachTagsRequest) XXX_Size Uses

func (m *AttachTagsRequest) XXX_Size() int

func (*AttachTagsRequest) XXX_Unmarshal Uses

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

type BeginUploadRequest Uses

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 Uses

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

func (*BeginUploadRequest) GetHashAlgo Uses

func (m *BeginUploadRequest) GetHashAlgo() HashAlgo

func (*BeginUploadRequest) GetObject Uses

func (m *BeginUploadRequest) GetObject() *ObjectRef

func (*BeginUploadRequest) ProtoMessage Uses

func (*BeginUploadRequest) ProtoMessage()

func (*BeginUploadRequest) Reset Uses

func (m *BeginUploadRequest) Reset()

func (*BeginUploadRequest) String Uses

func (m *BeginUploadRequest) String() string

func (*BeginUploadRequest) XXX_DiscardUnknown Uses

func (m *BeginUploadRequest) XXX_DiscardUnknown()

func (*BeginUploadRequest) XXX_Marshal Uses

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

func (*BeginUploadRequest) XXX_Merge Uses

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

func (*BeginUploadRequest) XXX_Size Uses

func (m *BeginUploadRequest) XXX_Size() int

func (*BeginUploadRequest) XXX_Unmarshal Uses

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

type CancelUploadRequest Uses

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 Uses

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

func (*CancelUploadRequest) GetUploadOperationId Uses

func (m *CancelUploadRequest) GetUploadOperationId() string

func (*CancelUploadRequest) ProtoMessage Uses

func (*CancelUploadRequest) ProtoMessage()

func (*CancelUploadRequest) Reset Uses

func (m *CancelUploadRequest) Reset()

func (*CancelUploadRequest) String Uses

func (m *CancelUploadRequest) String() string

func (*CancelUploadRequest) XXX_DiscardUnknown Uses

func (m *CancelUploadRequest) XXX_DiscardUnknown()

func (*CancelUploadRequest) XXX_Marshal Uses

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

func (*CancelUploadRequest) XXX_Merge Uses

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

func (*CancelUploadRequest) XXX_Size Uses

func (m *CancelUploadRequest) XXX_Size() int

func (*CancelUploadRequest) XXX_Unmarshal Uses

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

type DecoratedStorage Uses

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 Uses

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

func (*DecoratedStorage) CancelUpload Uses

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

func (*DecoratedStorage) FinishUpload Uses

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

func (*DecoratedStorage) GetObjectURL Uses

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

type DeleteRefRequest Uses

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 Uses

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

func (*DeleteRefRequest) GetName Uses

func (m *DeleteRefRequest) GetName() string

func (*DeleteRefRequest) GetPackage Uses

func (m *DeleteRefRequest) GetPackage() string

func (*DeleteRefRequest) ProtoMessage Uses

func (*DeleteRefRequest) ProtoMessage()

func (*DeleteRefRequest) Reset Uses

func (m *DeleteRefRequest) Reset()

func (*DeleteRefRequest) String Uses

func (m *DeleteRefRequest) String() string

func (*DeleteRefRequest) XXX_DiscardUnknown Uses

func (m *DeleteRefRequest) XXX_DiscardUnknown()

func (*DeleteRefRequest) XXX_Marshal Uses

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

func (*DeleteRefRequest) XXX_Merge Uses

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

func (*DeleteRefRequest) XXX_Size Uses

func (m *DeleteRefRequest) XXX_Size() int

func (*DeleteRefRequest) XXX_Unmarshal Uses

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

type DescribeClientRequest Uses

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 Uses

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

func (*DescribeClientRequest) GetInstance Uses

func (m *DescribeClientRequest) GetInstance() *ObjectRef

func (*DescribeClientRequest) GetPackage Uses

func (m *DescribeClientRequest) GetPackage() string

func (*DescribeClientRequest) ProtoMessage Uses

func (*DescribeClientRequest) ProtoMessage()

func (*DescribeClientRequest) Reset Uses

func (m *DescribeClientRequest) Reset()

func (*DescribeClientRequest) String Uses

func (m *DescribeClientRequest) String() string

func (*DescribeClientRequest) XXX_DiscardUnknown Uses

func (m *DescribeClientRequest) XXX_DiscardUnknown()

func (*DescribeClientRequest) XXX_Marshal Uses

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

func (*DescribeClientRequest) XXX_Merge Uses

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

func (*DescribeClientRequest) XXX_Size Uses

func (m *DescribeClientRequest) XXX_Size() int

func (*DescribeClientRequest) XXX_Unmarshal Uses

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

type DescribeClientResponse Uses

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 Uses

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

func (*DescribeClientResponse) GetClientBinary Uses

func (m *DescribeClientResponse) GetClientBinary() *ObjectURL

func (*DescribeClientResponse) GetClientRef Uses

func (m *DescribeClientResponse) GetClientRef() *ObjectRef

func (*DescribeClientResponse) GetClientRefAliases Uses

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

func (*DescribeClientResponse) GetClientSize Uses

func (m *DescribeClientResponse) GetClientSize() int64

func (*DescribeClientResponse) GetInstance Uses

func (m *DescribeClientResponse) GetInstance() *Instance

func (*DescribeClientResponse) GetLegacySha1 Uses

func (m *DescribeClientResponse) GetLegacySha1() string

func (*DescribeClientResponse) ProtoMessage Uses

func (*DescribeClientResponse) ProtoMessage()

func (*DescribeClientResponse) Reset Uses

func (m *DescribeClientResponse) Reset()

func (*DescribeClientResponse) String Uses

func (m *DescribeClientResponse) String() string

func (*DescribeClientResponse) XXX_DiscardUnknown Uses

func (m *DescribeClientResponse) XXX_DiscardUnknown()

func (*DescribeClientResponse) XXX_Marshal Uses

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

func (*DescribeClientResponse) XXX_Merge Uses

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

func (*DescribeClientResponse) XXX_Size Uses

func (m *DescribeClientResponse) XXX_Size() int

func (*DescribeClientResponse) XXX_Unmarshal Uses

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

type DescribeInstanceRequest Uses

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 Uses

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

func (*DescribeInstanceRequest) GetDescribeProcessors Uses

func (m *DescribeInstanceRequest) GetDescribeProcessors() bool

func (*DescribeInstanceRequest) GetDescribeRefs Uses

func (m *DescribeInstanceRequest) GetDescribeRefs() bool

func (*DescribeInstanceRequest) GetDescribeTags Uses

func (m *DescribeInstanceRequest) GetDescribeTags() bool

func (*DescribeInstanceRequest) GetInstance Uses

func (m *DescribeInstanceRequest) GetInstance() *ObjectRef

func (*DescribeInstanceRequest) GetPackage Uses

func (m *DescribeInstanceRequest) GetPackage() string

func (*DescribeInstanceRequest) ProtoMessage Uses

func (*DescribeInstanceRequest) ProtoMessage()

func (*DescribeInstanceRequest) Reset Uses

func (m *DescribeInstanceRequest) Reset()

func (*DescribeInstanceRequest) String Uses

func (m *DescribeInstanceRequest) String() string

func (*DescribeInstanceRequest) XXX_DiscardUnknown Uses

func (m *DescribeInstanceRequest) XXX_DiscardUnknown()

func (*DescribeInstanceRequest) XXX_Marshal Uses

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

func (*DescribeInstanceRequest) XXX_Merge Uses

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

func (*DescribeInstanceRequest) XXX_Size Uses

func (m *DescribeInstanceRequest) XXX_Size() int

func (*DescribeInstanceRequest) XXX_Unmarshal Uses

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

type DescribeInstanceResponse Uses

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 Uses

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

func (*DescribeInstanceResponse) GetInstance Uses

func (m *DescribeInstanceResponse) GetInstance() *Instance

func (*DescribeInstanceResponse) GetProcessors Uses

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

func (*DescribeInstanceResponse) GetRefs Uses

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

func (*DescribeInstanceResponse) GetTags Uses

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

func (*DescribeInstanceResponse) ProtoMessage Uses

func (*DescribeInstanceResponse) ProtoMessage()

func (*DescribeInstanceResponse) Reset Uses

func (m *DescribeInstanceResponse) Reset()

func (*DescribeInstanceResponse) String Uses

func (m *DescribeInstanceResponse) String() string

func (*DescribeInstanceResponse) XXX_DiscardUnknown Uses

func (m *DescribeInstanceResponse) XXX_DiscardUnknown()

func (*DescribeInstanceResponse) XXX_Marshal Uses

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

func (*DescribeInstanceResponse) XXX_Merge Uses

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

func (*DescribeInstanceResponse) XXX_Size Uses

func (m *DescribeInstanceResponse) XXX_Size() int

func (*DescribeInstanceResponse) XXX_Unmarshal Uses

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

type DetachTagsRequest Uses

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 Uses

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

func (*DetachTagsRequest) GetInstance Uses

func (m *DetachTagsRequest) GetInstance() *ObjectRef

func (*DetachTagsRequest) GetPackage Uses

func (m *DetachTagsRequest) GetPackage() string

func (*DetachTagsRequest) GetTags Uses

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

func (*DetachTagsRequest) ProtoMessage Uses

func (*DetachTagsRequest) ProtoMessage()

func (*DetachTagsRequest) Reset Uses

func (m *DetachTagsRequest) Reset()

func (*DetachTagsRequest) String Uses

func (m *DetachTagsRequest) String() string

func (*DetachTagsRequest) XXX_DiscardUnknown Uses

func (m *DetachTagsRequest) XXX_DiscardUnknown()

func (*DetachTagsRequest) XXX_Marshal Uses

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

func (*DetachTagsRequest) XXX_Merge Uses

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

func (*DetachTagsRequest) XXX_Size Uses

func (m *DetachTagsRequest) XXX_Size() int

func (*DetachTagsRequest) XXX_Unmarshal Uses

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

type FinishUploadRequest Uses

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 Uses

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

func (*FinishUploadRequest) GetForceHash Uses

func (m *FinishUploadRequest) GetForceHash() *ObjectRef

func (*FinishUploadRequest) GetUploadOperationId Uses

func (m *FinishUploadRequest) GetUploadOperationId() string

func (*FinishUploadRequest) ProtoMessage Uses

func (*FinishUploadRequest) ProtoMessage()

func (*FinishUploadRequest) Reset Uses

func (m *FinishUploadRequest) Reset()

func (*FinishUploadRequest) String Uses

func (m *FinishUploadRequest) String() string

func (*FinishUploadRequest) XXX_DiscardUnknown Uses

func (m *FinishUploadRequest) XXX_DiscardUnknown()

func (*FinishUploadRequest) XXX_Marshal Uses

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

func (*FinishUploadRequest) XXX_Merge Uses

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

func (*FinishUploadRequest) XXX_Size Uses

func (m *FinishUploadRequest) XXX_Size() int

func (*FinishUploadRequest) XXX_Unmarshal Uses

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

type GetInstanceURLRequest Uses

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 Uses

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

func (*GetInstanceURLRequest) GetInstance Uses

func (m *GetInstanceURLRequest) GetInstance() *ObjectRef

func (*GetInstanceURLRequest) GetPackage Uses

func (m *GetInstanceURLRequest) GetPackage() string

func (*GetInstanceURLRequest) ProtoMessage Uses

func (*GetInstanceURLRequest) ProtoMessage()

func (*GetInstanceURLRequest) Reset Uses

func (m *GetInstanceURLRequest) Reset()

func (*GetInstanceURLRequest) String Uses

func (m *GetInstanceURLRequest) String() string

func (*GetInstanceURLRequest) XXX_DiscardUnknown Uses

func (m *GetInstanceURLRequest) XXX_DiscardUnknown()

func (*GetInstanceURLRequest) XXX_Marshal Uses

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

func (*GetInstanceURLRequest) XXX_Merge Uses

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

func (*GetInstanceURLRequest) XXX_Size Uses

func (m *GetInstanceURLRequest) XXX_Size() int

func (*GetInstanceURLRequest) XXX_Unmarshal Uses

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

type GetObjectURLRequest Uses

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 Uses

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

func (*GetObjectURLRequest) GetDownloadFilename Uses

func (m *GetObjectURLRequest) GetDownloadFilename() string

func (*GetObjectURLRequest) GetObject Uses

func (m *GetObjectURLRequest) GetObject() *ObjectRef

func (*GetObjectURLRequest) ProtoMessage Uses

func (*GetObjectURLRequest) ProtoMessage()

func (*GetObjectURLRequest) Reset Uses

func (m *GetObjectURLRequest) Reset()

func (*GetObjectURLRequest) String Uses

func (m *GetObjectURLRequest) String() string

func (*GetObjectURLRequest) XXX_DiscardUnknown Uses

func (m *GetObjectURLRequest) XXX_DiscardUnknown()

func (*GetObjectURLRequest) XXX_Marshal Uses

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

func (*GetObjectURLRequest) XXX_Merge Uses

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

func (*GetObjectURLRequest) XXX_Size Uses

func (m *GetObjectURLRequest) XXX_Size() int

func (*GetObjectURLRequest) XXX_Unmarshal Uses

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

type HashAlgo Uses

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 Uses

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

func (HashAlgo) String Uses

func (x HashAlgo) String() string

type InheritedPrefixMetadata Uses

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 Uses

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

func (*InheritedPrefixMetadata) GetPerPrefixMetadata Uses

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

func (*InheritedPrefixMetadata) ProtoMessage Uses

func (*InheritedPrefixMetadata) ProtoMessage()

func (*InheritedPrefixMetadata) Reset Uses

func (m *InheritedPrefixMetadata) Reset()

func (*InheritedPrefixMetadata) String Uses

func (m *InheritedPrefixMetadata) String() string

func (*InheritedPrefixMetadata) XXX_DiscardUnknown Uses

func (m *InheritedPrefixMetadata) XXX_DiscardUnknown()

func (*InheritedPrefixMetadata) XXX_Marshal Uses

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

func (*InheritedPrefixMetadata) XXX_Merge Uses

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

func (*InheritedPrefixMetadata) XXX_Size Uses

func (m *InheritedPrefixMetadata) XXX_Size() int

func (*InheritedPrefixMetadata) XXX_Unmarshal Uses

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

type Instance Uses

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 Uses

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

func (*Instance) GetInstance Uses

func (m *Instance) GetInstance() *ObjectRef

func (*Instance) GetPackage Uses

func (m *Instance) GetPackage() string

func (*Instance) GetRegisteredBy Uses

func (m *Instance) GetRegisteredBy() string

func (*Instance) GetRegisteredTs Uses

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

func (*Instance) ProtoMessage Uses

func (*Instance) ProtoMessage()

func (*Instance) Reset Uses

func (m *Instance) Reset()

func (*Instance) String Uses

func (m *Instance) String() string

func (*Instance) XXX_DiscardUnknown Uses

func (m *Instance) XXX_DiscardUnknown()

func (*Instance) XXX_Marshal Uses

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

func (*Instance) XXX_Merge Uses

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

func (*Instance) XXX_Size Uses

func (m *Instance) XXX_Size() int

func (*Instance) XXX_Unmarshal Uses

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

type ListInstancesRequest Uses

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 Uses

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

func (*ListInstancesRequest) GetPackage Uses

func (m *ListInstancesRequest) GetPackage() string

func (*ListInstancesRequest) GetPageSize Uses

func (m *ListInstancesRequest) GetPageSize() int32

func (*ListInstancesRequest) GetPageToken Uses

func (m *ListInstancesRequest) GetPageToken() string

func (*ListInstancesRequest) ProtoMessage Uses

func (*ListInstancesRequest) ProtoMessage()

func (*ListInstancesRequest) Reset Uses

func (m *ListInstancesRequest) Reset()

func (*ListInstancesRequest) String Uses

func (m *ListInstancesRequest) String() string

func (*ListInstancesRequest) XXX_DiscardUnknown Uses

func (m *ListInstancesRequest) XXX_DiscardUnknown()

func (*ListInstancesRequest) XXX_Marshal Uses

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

func (*ListInstancesRequest) XXX_Merge Uses

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

func (*ListInstancesRequest) XXX_Size Uses

func (m *ListInstancesRequest) XXX_Size() int

func (*ListInstancesRequest) XXX_Unmarshal Uses

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

type ListInstancesResponse Uses

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 Uses

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

func (*ListInstancesResponse) GetInstances Uses

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

func (*ListInstancesResponse) GetNextPageToken Uses

func (m *ListInstancesResponse) GetNextPageToken() string

func (*ListInstancesResponse) ProtoMessage Uses

func (*ListInstancesResponse) ProtoMessage()

func (*ListInstancesResponse) Reset Uses

func (m *ListInstancesResponse) Reset()

func (*ListInstancesResponse) String Uses

func (m *ListInstancesResponse) String() string

func (*ListInstancesResponse) XXX_DiscardUnknown Uses

func (m *ListInstancesResponse) XXX_DiscardUnknown()

func (*ListInstancesResponse) XXX_Marshal Uses

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

func (*ListInstancesResponse) XXX_Merge Uses

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

func (*ListInstancesResponse) XXX_Size Uses

func (m *ListInstancesResponse) XXX_Size() int

func (*ListInstancesResponse) XXX_Unmarshal Uses

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

type ListPrefixRequest Uses

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 Uses

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

func (*ListPrefixRequest) GetIncludeHidden Uses

func (m *ListPrefixRequest) GetIncludeHidden() bool

func (*ListPrefixRequest) GetPrefix Uses

func (m *ListPrefixRequest) GetPrefix() string

func (*ListPrefixRequest) GetRecursive Uses

func (m *ListPrefixRequest) GetRecursive() bool

func (*ListPrefixRequest) ProtoMessage Uses

func (*ListPrefixRequest) ProtoMessage()

func (*ListPrefixRequest) Reset Uses

func (m *ListPrefixRequest) Reset()

func (*ListPrefixRequest) String Uses

func (m *ListPrefixRequest) String() string

func (*ListPrefixRequest) XXX_DiscardUnknown Uses

func (m *ListPrefixRequest) XXX_DiscardUnknown()

func (*ListPrefixRequest) XXX_Marshal Uses

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

func (*ListPrefixRequest) XXX_Merge Uses

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

func (*ListPrefixRequest) XXX_Size Uses

func (m *ListPrefixRequest) XXX_Size() int

func (*ListPrefixRequest) XXX_Unmarshal Uses

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

type ListPrefixResponse Uses

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 Uses

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

func (*ListPrefixResponse) GetPackages Uses

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

func (*ListPrefixResponse) GetPrefixes Uses

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

func (*ListPrefixResponse) ProtoMessage Uses

func (*ListPrefixResponse) ProtoMessage()

func (*ListPrefixResponse) Reset Uses

func (m *ListPrefixResponse) Reset()

func (*ListPrefixResponse) String Uses

func (m *ListPrefixResponse) String() string

func (*ListPrefixResponse) XXX_DiscardUnknown Uses

func (m *ListPrefixResponse) XXX_DiscardUnknown()

func (*ListPrefixResponse) XXX_Marshal Uses

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

func (*ListPrefixResponse) XXX_Merge Uses

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

func (*ListPrefixResponse) XXX_Size Uses

func (m *ListPrefixResponse) XXX_Size() int

func (*ListPrefixResponse) XXX_Unmarshal Uses

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

type ListRefsRequest Uses

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 Uses

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

func (*ListRefsRequest) GetPackage Uses

func (m *ListRefsRequest) GetPackage() string

func (*ListRefsRequest) ProtoMessage Uses

func (*ListRefsRequest) ProtoMessage()

func (*ListRefsRequest) Reset Uses

func (m *ListRefsRequest) Reset()

func (*ListRefsRequest) String Uses

func (m *ListRefsRequest) String() string

func (*ListRefsRequest) XXX_DiscardUnknown Uses

func (m *ListRefsRequest) XXX_DiscardUnknown()

func (*ListRefsRequest) XXX_Marshal Uses

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

func (*ListRefsRequest) XXX_Merge Uses

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

func (*ListRefsRequest) XXX_Size Uses

func (m *ListRefsRequest) XXX_Size() int

func (*ListRefsRequest) XXX_Unmarshal Uses

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

type ListRefsResponse Uses

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 Uses

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

func (*ListRefsResponse) GetRefs Uses

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

func (*ListRefsResponse) ProtoMessage Uses

func (*ListRefsResponse) ProtoMessage()

func (*ListRefsResponse) Reset Uses

func (m *ListRefsResponse) Reset()

func (*ListRefsResponse) String Uses

func (m *ListRefsResponse) String() string

func (*ListRefsResponse) XXX_DiscardUnknown Uses

func (m *ListRefsResponse) XXX_DiscardUnknown()

func (*ListRefsResponse) XXX_Marshal Uses

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

func (*ListRefsResponse) XXX_Merge Uses

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

func (*ListRefsResponse) XXX_Size Uses

func (m *ListRefsResponse) XXX_Size() int

func (*ListRefsResponse) XXX_Unmarshal Uses

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

type ObjectRef Uses

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 Uses

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

func (*ObjectRef) GetHashAlgo Uses

func (m *ObjectRef) GetHashAlgo() HashAlgo

func (*ObjectRef) GetHexDigest Uses

func (m *ObjectRef) GetHexDigest() string

func (*ObjectRef) ProtoMessage Uses

func (*ObjectRef) ProtoMessage()

func (*ObjectRef) Reset Uses

func (m *ObjectRef) Reset()

func (*ObjectRef) String Uses

func (m *ObjectRef) String() string

func (*ObjectRef) XXX_DiscardUnknown Uses

func (m *ObjectRef) XXX_DiscardUnknown()

func (*ObjectRef) XXX_Marshal Uses

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

func (*ObjectRef) XXX_Merge Uses

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

func (*ObjectRef) XXX_Size Uses

func (m *ObjectRef) XXX_Size() int

func (*ObjectRef) XXX_Unmarshal Uses

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

type ObjectURL Uses

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 Uses

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

func (*ObjectURL) GetSignedUrl Uses

func (m *ObjectURL) GetSignedUrl() string

func (*ObjectURL) ProtoMessage Uses

func (*ObjectURL) ProtoMessage()

func (*ObjectURL) Reset Uses

func (m *ObjectURL) Reset()

func (*ObjectURL) String Uses

func (m *ObjectURL) String() string

func (*ObjectURL) XXX_DiscardUnknown Uses

func (m *ObjectURL) XXX_DiscardUnknown()

func (*ObjectURL) XXX_Marshal Uses

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

func (*ObjectURL) XXX_Merge Uses

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

func (*ObjectURL) XXX_Size Uses

func (m *ObjectURL) XXX_Size() int

func (*ObjectURL) XXX_Unmarshal Uses

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

type PackageRequest Uses

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 Uses

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

func (*PackageRequest) GetPackage Uses

func (m *PackageRequest) GetPackage() string

func (*PackageRequest) ProtoMessage Uses

func (*PackageRequest) ProtoMessage()

func (*PackageRequest) Reset Uses

func (m *PackageRequest) Reset()

func (*PackageRequest) String Uses

func (m *PackageRequest) String() string

func (*PackageRequest) XXX_DiscardUnknown Uses

func (m *PackageRequest) XXX_DiscardUnknown()

func (*PackageRequest) XXX_Marshal Uses

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

func (*PackageRequest) XXX_Merge Uses

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

func (*PackageRequest) XXX_Size Uses

func (m *PackageRequest) XXX_Size() int

func (*PackageRequest) XXX_Unmarshal Uses

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

type PrefixMetadata Uses

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 Uses

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

func (*PrefixMetadata) GetAcls Uses

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

func (*PrefixMetadata) GetFingerprint Uses

func (m *PrefixMetadata) GetFingerprint() string

func (*PrefixMetadata) GetPrefix Uses

func (m *PrefixMetadata) GetPrefix() string

func (*PrefixMetadata) GetUpdateTime Uses

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

func (*PrefixMetadata) GetUpdateUser Uses

func (m *PrefixMetadata) GetUpdateUser() string

func (*PrefixMetadata) ProtoMessage Uses

func (*PrefixMetadata) ProtoMessage()

func (*PrefixMetadata) Reset Uses

func (m *PrefixMetadata) Reset()

func (*PrefixMetadata) String Uses

func (m *PrefixMetadata) String() string

func (*PrefixMetadata) XXX_DiscardUnknown Uses

func (m *PrefixMetadata) XXX_DiscardUnknown()

func (*PrefixMetadata) XXX_Marshal Uses

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

func (*PrefixMetadata) XXX_Merge Uses

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

func (*PrefixMetadata) XXX_Size Uses

func (m *PrefixMetadata) XXX_Size() int

func (*PrefixMetadata) XXX_Unmarshal Uses

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

type PrefixMetadata_ACL Uses

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 Uses

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

func (*PrefixMetadata_ACL) GetPrincipals Uses

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

func (*PrefixMetadata_ACL) GetRole Uses

func (m *PrefixMetadata_ACL) GetRole() Role

func (*PrefixMetadata_ACL) ProtoMessage Uses

func (*PrefixMetadata_ACL) ProtoMessage()

func (*PrefixMetadata_ACL) Reset Uses

func (m *PrefixMetadata_ACL) Reset()

func (*PrefixMetadata_ACL) String Uses

func (m *PrefixMetadata_ACL) String() string

func (*PrefixMetadata_ACL) XXX_DiscardUnknown Uses

func (m *PrefixMetadata_ACL) XXX_DiscardUnknown()

func (*PrefixMetadata_ACL) XXX_Marshal Uses

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

func (*PrefixMetadata_ACL) XXX_Merge Uses

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

func (*PrefixMetadata_ACL) XXX_Size Uses

func (m *PrefixMetadata_ACL) XXX_Size() int

func (*PrefixMetadata_ACL) XXX_Unmarshal Uses

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

type PrefixRequest Uses

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 Uses

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

func (*PrefixRequest) GetPrefix Uses

func (m *PrefixRequest) GetPrefix() string

func (*PrefixRequest) ProtoMessage Uses

func (*PrefixRequest) ProtoMessage()

func (*PrefixRequest) Reset Uses

func (m *PrefixRequest) Reset()

func (*PrefixRequest) String Uses

func (m *PrefixRequest) String() string

func (*PrefixRequest) XXX_DiscardUnknown Uses

func (m *PrefixRequest) XXX_DiscardUnknown()

func (*PrefixRequest) XXX_Marshal Uses

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

func (*PrefixRequest) XXX_Merge Uses

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

func (*PrefixRequest) XXX_Size Uses

func (m *PrefixRequest) XXX_Size() int

func (*PrefixRequest) XXX_Unmarshal Uses

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

type Processor Uses

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 Uses

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

func (*Processor) GetError Uses

func (m *Processor) GetError() string

func (*Processor) GetFinishedTs Uses

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

func (*Processor) GetId Uses

func (m *Processor) GetId() string

func (*Processor) GetResult Uses

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

func (*Processor) GetState Uses

func (m *Processor) GetState() Processor_State

func (*Processor) ProtoMessage Uses

func (*Processor) ProtoMessage()

func (*Processor) Reset Uses

func (m *Processor) Reset()

func (*Processor) String Uses

func (m *Processor) String() string

func (*Processor) XXX_DiscardUnknown Uses

func (m *Processor) XXX_DiscardUnknown()

func (*Processor) XXX_Marshal Uses

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

func (*Processor) XXX_Merge Uses

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

func (*Processor) XXX_Size Uses

func (m *Processor) XXX_Size() int

func (*Processor) XXX_Unmarshal Uses

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

type Processor_State Uses

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 Uses

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

func (Processor_State) String Uses

func (x Processor_State) String() string

type Ref Uses

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 Uses

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

func (*Ref) GetInstance Uses

func (m *Ref) GetInstance() *ObjectRef

func (*Ref) GetModifiedBy Uses

func (m *Ref) GetModifiedBy() string

func (*Ref) GetModifiedTs Uses

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

func (*Ref) GetName Uses

func (m *Ref) GetName() string

func (*Ref) GetPackage Uses

func (m *Ref) GetPackage() string

func (*Ref) ProtoMessage Uses

func (*Ref) ProtoMessage()

func (*Ref) Reset Uses

func (m *Ref) Reset()

func (*Ref) String Uses

func (m *Ref) String() string

func (*Ref) XXX_DiscardUnknown Uses

func (m *Ref) XXX_DiscardUnknown()

func (*Ref) XXX_Marshal Uses

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

func (*Ref) XXX_Merge Uses

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

func (*Ref) XXX_Size Uses

func (m *Ref) XXX_Size() int

func (*Ref) XXX_Unmarshal Uses

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

type RegisterInstanceResponse Uses

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 Uses

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

func (*RegisterInstanceResponse) GetInstance Uses

func (m *RegisterInstanceResponse) GetInstance() *Instance

func (*RegisterInstanceResponse) GetStatus Uses

func (m *RegisterInstanceResponse) GetStatus() RegistrationStatus

func (*RegisterInstanceResponse) GetUploadOp Uses

func (m *RegisterInstanceResponse) GetUploadOp() *UploadOperation

func (*RegisterInstanceResponse) ProtoMessage Uses

func (*RegisterInstanceResponse) ProtoMessage()

func (*RegisterInstanceResponse) Reset Uses

func (m *RegisterInstanceResponse) Reset()

func (*RegisterInstanceResponse) String Uses

func (m *RegisterInstanceResponse) String() string

func (*RegisterInstanceResponse) XXX_DiscardUnknown Uses

func (m *RegisterInstanceResponse) XXX_DiscardUnknown()

func (*RegisterInstanceResponse) XXX_Marshal Uses

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

func (*RegisterInstanceResponse) XXX_Merge Uses

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

func (*RegisterInstanceResponse) XXX_Size Uses

func (m *RegisterInstanceResponse) XXX_Size() int

func (*RegisterInstanceResponse) XXX_Unmarshal Uses

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

type RegistrationStatus Uses

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 Uses

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

func (RegistrationStatus) String Uses

func (x RegistrationStatus) String() string

type RepositoryClient Uses

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)
    // 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 Uses

func NewRepositoryClient(cc *grpc.ClientConn) RepositoryClient

func NewRepositoryPRPCClient Uses

func NewRepositoryPRPCClient(client *prpc.Client) RepositoryClient

type RepositoryServer Uses

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)
    // 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 Uses

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 Uses

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

func (*ResolveVersionRequest) GetPackage Uses

func (m *ResolveVersionRequest) GetPackage() string

func (*ResolveVersionRequest) GetVersion Uses

func (m *ResolveVersionRequest) GetVersion() string

func (*ResolveVersionRequest) ProtoMessage Uses

func (*ResolveVersionRequest) ProtoMessage()

func (*ResolveVersionRequest) Reset Uses

func (m *ResolveVersionRequest) Reset()

func (*ResolveVersionRequest) String Uses

func (m *ResolveVersionRequest) String() string

func (*ResolveVersionRequest) XXX_DiscardUnknown Uses

func (m *ResolveVersionRequest) XXX_DiscardUnknown()

func (*ResolveVersionRequest) XXX_Marshal Uses

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

func (*ResolveVersionRequest) XXX_Merge Uses

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

func (*ResolveVersionRequest) XXX_Size Uses

func (m *ResolveVersionRequest) XXX_Size() int

func (*ResolveVersionRequest) XXX_Unmarshal Uses

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

type Role Uses

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 Uses

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

func (Role) String Uses

func (x Role) String() string

type RolesInPrefixResponse Uses

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 Uses

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

func (*RolesInPrefixResponse) GetRoles Uses

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

func (*RolesInPrefixResponse) ProtoMessage Uses

func (*RolesInPrefixResponse) ProtoMessage()

func (*RolesInPrefixResponse) Reset Uses

func (m *RolesInPrefixResponse) Reset()

func (*RolesInPrefixResponse) String Uses

func (m *RolesInPrefixResponse) String() string

func (*RolesInPrefixResponse) XXX_DiscardUnknown Uses

func (m *RolesInPrefixResponse) XXX_DiscardUnknown()

func (*RolesInPrefixResponse) XXX_Marshal Uses

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

func (*RolesInPrefixResponse) XXX_Merge Uses

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

func (*RolesInPrefixResponse) XXX_Size Uses

func (m *RolesInPrefixResponse) XXX_Size() int

func (*RolesInPrefixResponse) XXX_Unmarshal Uses

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

type RolesInPrefixResponse_RoleInPrefix Uses

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 Uses

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

func (*RolesInPrefixResponse_RoleInPrefix) GetRole Uses

func (m *RolesInPrefixResponse_RoleInPrefix) GetRole() Role

func (*RolesInPrefixResponse_RoleInPrefix) ProtoMessage Uses

func (*RolesInPrefixResponse_RoleInPrefix) ProtoMessage()

func (*RolesInPrefixResponse_RoleInPrefix) Reset Uses

func (m *RolesInPrefixResponse_RoleInPrefix) Reset()

func (*RolesInPrefixResponse_RoleInPrefix) String Uses

func (m *RolesInPrefixResponse_RoleInPrefix) String() string

func (*RolesInPrefixResponse_RoleInPrefix) XXX_DiscardUnknown Uses

func (m *RolesInPrefixResponse_RoleInPrefix) XXX_DiscardUnknown()

func (*RolesInPrefixResponse_RoleInPrefix) XXX_Marshal Uses

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

func (*RolesInPrefixResponse_RoleInPrefix) XXX_Merge Uses

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

func (*RolesInPrefixResponse_RoleInPrefix) XXX_Size Uses

func (m *RolesInPrefixResponse_RoleInPrefix) XXX_Size() int

func (*RolesInPrefixResponse_RoleInPrefix) XXX_Unmarshal Uses

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

type SearchInstancesRequest Uses

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 Uses

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

func (*SearchInstancesRequest) GetPackage Uses

func (m *SearchInstancesRequest) GetPackage() string

func (*SearchInstancesRequest) GetPageSize Uses

func (m *SearchInstancesRequest) GetPageSize() int32

func (*SearchInstancesRequest) GetPageToken Uses

func (m *SearchInstancesRequest) GetPageToken() string

func (*SearchInstancesRequest) GetTags Uses

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

func (*SearchInstancesRequest) ProtoMessage Uses

func (*SearchInstancesRequest) ProtoMessage()

func (*SearchInstancesRequest) Reset Uses

func (m *SearchInstancesRequest) Reset()

func (*SearchInstancesRequest) String Uses

func (m *SearchInstancesRequest) String() string

func (*SearchInstancesRequest) XXX_DiscardUnknown Uses

func (m *SearchInstancesRequest) XXX_DiscardUnknown()

func (*SearchInstancesRequest) XXX_Marshal Uses

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

func (*SearchInstancesRequest) XXX_Merge Uses

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

func (*SearchInstancesRequest) XXX_Size Uses

func (m *SearchInstancesRequest) XXX_Size() int

func (*SearchInstancesRequest) XXX_Unmarshal Uses

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

type SearchInstancesResponse Uses

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 Uses

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

func (*SearchInstancesResponse) GetInstances Uses

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

func (*SearchInstancesResponse) GetNextPageToken Uses

func (m *SearchInstancesResponse) GetNextPageToken() string

func (*SearchInstancesResponse) ProtoMessage Uses

func (*SearchInstancesResponse) ProtoMessage()

func (*SearchInstancesResponse) Reset Uses

func (m *SearchInstancesResponse) Reset()

func (*SearchInstancesResponse) String Uses

func (m *SearchInstancesResponse) String() string

func (*SearchInstancesResponse) XXX_DiscardUnknown Uses

func (m *SearchInstancesResponse) XXX_DiscardUnknown()

func (*SearchInstancesResponse) XXX_Marshal Uses

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

func (*SearchInstancesResponse) XXX_Merge Uses

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

func (*SearchInstancesResponse) XXX_Size Uses

func (m *SearchInstancesResponse) XXX_Size() int

func (*SearchInstancesResponse) XXX_Unmarshal Uses

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

type StorageClient Uses

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 Uses

func NewStorageClient(cc *grpc.ClientConn) StorageClient

func NewStoragePRPCClient Uses

func NewStoragePRPCClient(client *prpc.Client) StorageClient

type StorageServer Uses

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 Uses

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 Uses

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

func (*Tag) GetAttachedBy Uses

func (m *Tag) GetAttachedBy() string

func (*Tag) GetAttachedTs Uses

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

func (*Tag) GetKey Uses

func (m *Tag) GetKey() string

func (*Tag) GetValue Uses

func (m *Tag) GetValue() string

func (*Tag) ProtoMessage Uses

func (*Tag) ProtoMessage()

func (*Tag) Reset Uses

func (m *Tag) Reset()

func (*Tag) String Uses

func (m *Tag) String() string

func (*Tag) XXX_DiscardUnknown Uses

func (m *Tag) XXX_DiscardUnknown()

func (*Tag) XXX_Marshal Uses

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

func (*Tag) XXX_Merge Uses

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

func (*Tag) XXX_Size Uses

func (m *Tag) XXX_Size() int

func (*Tag) XXX_Unmarshal Uses

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

type UploadOperation Uses

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 Uses

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

func (*UploadOperation) GetErrorMessage Uses

func (m *UploadOperation) GetErrorMessage() string

func (*UploadOperation) GetObject Uses

func (m *UploadOperation) GetObject() *ObjectRef

func (*UploadOperation) GetOperationId Uses

func (m *UploadOperation) GetOperationId() string

func (*UploadOperation) GetStatus Uses

func (m *UploadOperation) GetStatus() UploadStatus

func (*UploadOperation) GetUploadUrl Uses

func (m *UploadOperation) GetUploadUrl() string

func (*UploadOperation) ProtoMessage Uses

func (*UploadOperation) ProtoMessage()

func (*UploadOperation) Reset Uses

func (m *UploadOperation) Reset()

func (*UploadOperation) String Uses

func (m *UploadOperation) String() string

func (*UploadOperation) XXX_DiscardUnknown Uses

func (m *UploadOperation) XXX_DiscardUnknown()

func (*UploadOperation) XXX_Marshal Uses

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

func (*UploadOperation) XXX_Merge Uses

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

func (*UploadOperation) XXX_Size Uses

func (m *UploadOperation) XXX_Size() int

func (*UploadOperation) XXX_Unmarshal Uses

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

type UploadStatus Uses

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 Uses

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

func (UploadStatus) String Uses

func (x UploadStatus) String() string

Package api imports 11 packages (graph) and is imported by 18 packages. Updated 2018-08-20. Refresh now. Tools for package owners.