runtimeconfig

package
v0.0.0-...-96659ae Latest Latest
Warning

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

Go to latest
Published: Jan 17, 2018 License: Apache-2.0 Imports: 11 Imported by: 0

Documentation

Overview

Package runtimeconfig is a generated protocol buffer package.

It is generated from these files:

google/cloud/runtimeconfig/v1beta1/resources.proto
google/cloud/runtimeconfig/v1beta1/runtimeconfig.proto

It has these top-level messages:

RuntimeConfig
Variable
EndCondition
Waiter
ListConfigsRequest
ListConfigsResponse
GetConfigRequest
CreateConfigRequest
UpdateConfigRequest
DeleteConfigRequest
ListVariablesRequest
ListVariablesResponse
WatchVariableRequest
GetVariableRequest
CreateVariableRequest
UpdateVariableRequest
DeleteVariableRequest
ListWaitersRequest
ListWaitersResponse
GetWaiterRequest
CreateWaiterRequest
DeleteWaiterRequest

Index

Constants

This section is empty.

Variables

View Source
var VariableState_name = map[int32]string{
	0: "VARIABLE_STATE_UNSPECIFIED",
	1: "UPDATED",
	2: "DELETED",
}
View Source
var VariableState_value = map[string]int32{
	"VARIABLE_STATE_UNSPECIFIED": 0,
	"UPDATED":                    1,
	"DELETED":                    2,
}

Functions

func RegisterRuntimeConfigManagerServer

func RegisterRuntimeConfigManagerServer(s *grpc.Server, srv RuntimeConfigManagerServer)

Types

type CreateConfigRequest

type CreateConfigRequest struct {
	// The [project ID](https://support.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)
	// for this request, in the format `projects/[PROJECT_ID]`.
	Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
	// The RuntimeConfig to create.
	Config *RuntimeConfig `protobuf:"bytes,2,opt,name=config" json:"config,omitempty"`
	// An optional but recommended unique `request_id`. If the server
	// receives two `create()` requests  with the same
	// `request_id`, then the second request will be ignored and the
	// first resource created and stored in the backend is returned.
	// Empty `request_id` fields are ignored.
	//
	// It is responsibility of the client to ensure uniqueness of the
	// `request_id` strings.
	//
	// `request_id` strings are limited to 64 characters.
	RequestId string `protobuf:"bytes,3,opt,name=request_id,json=requestId" json:"request_id,omitempty"`
}

Creates a RuntimeConfig resource.

func (*CreateConfigRequest) Descriptor

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

func (*CreateConfigRequest) GetConfig

func (m *CreateConfigRequest) GetConfig() *RuntimeConfig

func (*CreateConfigRequest) GetParent

func (m *CreateConfigRequest) GetParent() string

func (*CreateConfigRequest) GetRequestId

func (m *CreateConfigRequest) GetRequestId() string

func (*CreateConfigRequest) ProtoMessage

func (*CreateConfigRequest) ProtoMessage()

func (*CreateConfigRequest) Reset

func (m *CreateConfigRequest) Reset()

func (*CreateConfigRequest) String

func (m *CreateConfigRequest) String() string

type CreateVariableRequest

type CreateVariableRequest struct {
	// The path to the RutimeConfig resource that this variable should belong to.
	// The configuration must exist beforehand; the path must by in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
	Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
	// The variable to create.
	Variable *Variable `protobuf:"bytes,2,opt,name=variable" json:"variable,omitempty"`
	// An optional but recommended unique `request_id`. If the server
	// receives two `create()` requests  with the same
	// `request_id`, then the second request will be ignored and the
	// first resource created and stored in the backend is returned.
	// Empty `request_id` fields are ignored.
	//
	// It is responsibility of the client to ensure uniqueness of the
	// `request_id` strings.
	//
	// `request_id` strings are limited to 64 characters.
	RequestId string `protobuf:"bytes,3,opt,name=request_id,json=requestId" json:"request_id,omitempty"`
}

Request for the `CreateVariable()` method.

func (*CreateVariableRequest) Descriptor

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

func (*CreateVariableRequest) GetParent

func (m *CreateVariableRequest) GetParent() string

func (*CreateVariableRequest) GetRequestId

func (m *CreateVariableRequest) GetRequestId() string

func (*CreateVariableRequest) GetVariable

func (m *CreateVariableRequest) GetVariable() *Variable

func (*CreateVariableRequest) ProtoMessage

func (*CreateVariableRequest) ProtoMessage()

func (*CreateVariableRequest) Reset

func (m *CreateVariableRequest) Reset()

func (*CreateVariableRequest) String

func (m *CreateVariableRequest) String() string

type CreateWaiterRequest

type CreateWaiterRequest struct {
	// The path to the configuration that will own the waiter.
	// The configuration must exist beforehand; the path must by in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
	Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
	// The Waiter resource to create.
	Waiter *Waiter `protobuf:"bytes,2,opt,name=waiter" json:"waiter,omitempty"`
	// An optional but recommended unique `request_id`. If the server
	// receives two `create()` requests  with the same
	// `request_id`, then the second request will be ignored and the
	// first resource created and stored in the backend is returned.
	// Empty `request_id` fields are ignored.
	//
	// It is responsibility of the client to ensure uniqueness of the
	// `request_id` strings.
	//
	// `request_id` strings are limited to 64 characters.
	RequestId string `protobuf:"bytes,3,opt,name=request_id,json=requestId" json:"request_id,omitempty"`
}

Request message for `CreateWaiter()` method.

func (*CreateWaiterRequest) Descriptor

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

func (*CreateWaiterRequest) GetParent

func (m *CreateWaiterRequest) GetParent() string

func (*CreateWaiterRequest) GetRequestId

func (m *CreateWaiterRequest) GetRequestId() string

func (*CreateWaiterRequest) GetWaiter

func (m *CreateWaiterRequest) GetWaiter() *Waiter

func (*CreateWaiterRequest) ProtoMessage

func (*CreateWaiterRequest) ProtoMessage()

func (*CreateWaiterRequest) Reset

func (m *CreateWaiterRequest) Reset()

func (*CreateWaiterRequest) String

func (m *CreateWaiterRequest) String() string

type DeleteConfigRequest

type DeleteConfigRequest struct {
	// The RuntimeConfig resource to delete, in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
}

Request for the `DeleteConfig()` method.

func (*DeleteConfigRequest) Descriptor

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

func (*DeleteConfigRequest) GetName

func (m *DeleteConfigRequest) GetName() string

func (*DeleteConfigRequest) ProtoMessage

func (*DeleteConfigRequest) ProtoMessage()

func (*DeleteConfigRequest) Reset

func (m *DeleteConfigRequest) Reset()

func (*DeleteConfigRequest) String

func (m *DeleteConfigRequest) String() string

type DeleteVariableRequest

type DeleteVariableRequest struct {
	// The name of the variable to delete, in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]`
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	// Set to `true` to recursively delete multiple variables with the same
	// prefix.
	Recursive bool `protobuf:"varint,2,opt,name=recursive" json:"recursive,omitempty"`
}

Request for the `DeleteVariable()` method.

func (*DeleteVariableRequest) Descriptor

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

func (*DeleteVariableRequest) GetName

func (m *DeleteVariableRequest) GetName() string

func (*DeleteVariableRequest) GetRecursive

func (m *DeleteVariableRequest) GetRecursive() bool

func (*DeleteVariableRequest) ProtoMessage

func (*DeleteVariableRequest) ProtoMessage()

func (*DeleteVariableRequest) Reset

func (m *DeleteVariableRequest) Reset()

func (*DeleteVariableRequest) String

func (m *DeleteVariableRequest) String() string

type DeleteWaiterRequest

type DeleteWaiterRequest struct {
	// The Waiter resource to delete, in the format:
	//
	//  `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
}

Request for the `DeleteWaiter()` method.

func (*DeleteWaiterRequest) Descriptor

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

func (*DeleteWaiterRequest) GetName

func (m *DeleteWaiterRequest) GetName() string

func (*DeleteWaiterRequest) ProtoMessage

func (*DeleteWaiterRequest) ProtoMessage()

func (*DeleteWaiterRequest) Reset

func (m *DeleteWaiterRequest) Reset()

func (*DeleteWaiterRequest) String

func (m *DeleteWaiterRequest) String() string

type EndCondition

type EndCondition struct {
	// The condition oneof holds the available condition types for this
	// EndCondition. Currently, the only available type is Cardinality.
	//
	// Types that are valid to be assigned to Condition:
	//	*EndCondition_Cardinality_
	Condition isEndCondition_Condition `protobuf_oneof:"condition"`
}

The condition that a Waiter resource is waiting for.

func (*EndCondition) Descriptor

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

func (*EndCondition) GetCardinality

func (m *EndCondition) GetCardinality() *EndCondition_Cardinality

func (*EndCondition) GetCondition

func (m *EndCondition) GetCondition() isEndCondition_Condition

func (*EndCondition) ProtoMessage

func (*EndCondition) ProtoMessage()

func (*EndCondition) Reset

func (m *EndCondition) Reset()

func (*EndCondition) String

func (m *EndCondition) String() string

func (*EndCondition) XXX_OneofFuncs

func (*EndCondition) XXX_OneofFuncs() (func(msg proto.Message, b *proto.Buffer) error, func(msg proto.Message, tag, wire int, b *proto.Buffer) (bool, error), func(msg proto.Message) (n int), []interface{})

XXX_OneofFuncs is for the internal use of the proto package.

type EndCondition_Cardinality

type EndCondition_Cardinality struct {
	// The root of the variable subtree to monitor. For example, `/foo`.
	Path string `protobuf:"bytes,1,opt,name=path" json:"path,omitempty"`
	// The number variables under the `path` that must exist to meet this
	// condition. Defaults to 1 if not specified.
	Number int32 `protobuf:"varint,2,opt,name=number" json:"number,omitempty"`
}

A Cardinality condition for the Waiter resource. A cardinality condition is met when the number of variables under a specified path prefix reaches a predefined number. For example, if you set a Cardinality condition where the `path` is set to `/foo` and the number of paths is set to 2, the following variables would meet the condition in a RuntimeConfig resource:

+ `/foo/variable1 = "value1"` + `/foo/variable2 = "value2"` + `/bar/variable3 = "value3"`

It would not would not satisify the same condition with the `number` set to 3, however, because there is only 2 paths that start with `/foo`. Cardinality conditions are recursive; all subtrees under the specific path prefix are counted.

func (*EndCondition_Cardinality) Descriptor

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

func (*EndCondition_Cardinality) GetNumber

func (m *EndCondition_Cardinality) GetNumber() int32

func (*EndCondition_Cardinality) GetPath

func (m *EndCondition_Cardinality) GetPath() string

func (*EndCondition_Cardinality) ProtoMessage

func (*EndCondition_Cardinality) ProtoMessage()

func (*EndCondition_Cardinality) Reset

func (m *EndCondition_Cardinality) Reset()

func (*EndCondition_Cardinality) String

func (m *EndCondition_Cardinality) String() string

type EndCondition_Cardinality_

type EndCondition_Cardinality_ struct {
	Cardinality *EndCondition_Cardinality `protobuf:"bytes,1,opt,name=cardinality,oneof"`
}

type GetConfigRequest

type GetConfigRequest struct {
	// The name of the RuntimeConfig resource to retrieve, in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
	Name string `protobuf:"bytes,2,opt,name=name" json:"name,omitempty"`
}

Gets a RuntimeConfig resource.

func (*GetConfigRequest) Descriptor

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

func (*GetConfigRequest) GetName

func (m *GetConfigRequest) GetName() string

func (*GetConfigRequest) ProtoMessage

func (*GetConfigRequest) ProtoMessage()

func (*GetConfigRequest) Reset

func (m *GetConfigRequest) Reset()

func (*GetConfigRequest) String

func (m *GetConfigRequest) String() string

type GetVariableRequest

type GetVariableRequest struct {
	// The name of the variable to return, in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIBLE_NAME]`
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
}

Request for the `GetVariable()` method.

func (*GetVariableRequest) Descriptor

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

func (*GetVariableRequest) GetName

func (m *GetVariableRequest) GetName() string

func (*GetVariableRequest) ProtoMessage

func (*GetVariableRequest) ProtoMessage()

func (*GetVariableRequest) Reset

func (m *GetVariableRequest) Reset()

func (*GetVariableRequest) String

func (m *GetVariableRequest) String() string

type GetWaiterRequest

type GetWaiterRequest struct {
	// The fully-qualified name of the Waiter resource object to retrieve, in the
	// format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
}

Request for the `GetWaiter()` method.

func (*GetWaiterRequest) Descriptor

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

func (*GetWaiterRequest) GetName

func (m *GetWaiterRequest) GetName() string

func (*GetWaiterRequest) ProtoMessage

func (*GetWaiterRequest) ProtoMessage()

func (*GetWaiterRequest) Reset

func (m *GetWaiterRequest) Reset()

func (*GetWaiterRequest) String

func (m *GetWaiterRequest) String() string

type ListConfigsRequest

type ListConfigsRequest struct {
	// The [project ID](https://support.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)
	// for this request, in the format `projects/[PROJECT_ID]`.
	Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
	// Specifies the number of results to return per page. If there are fewer
	// elements than the specified number, returns all elements.
	PageSize int32 `protobuf:"varint,2,opt,name=page_size,json=pageSize" json:"page_size,omitempty"`
	// Specifies a page token to use. Set `pageToken` to a `nextPageToken`
	// returned by a previous list request to get the next page of results.
	PageToken string `protobuf:"bytes,3,opt,name=page_token,json=pageToken" json:"page_token,omitempty"`
}

Request for the `ListConfigs()` method.

func (*ListConfigsRequest) Descriptor

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

func (*ListConfigsRequest) GetPageSize

func (m *ListConfigsRequest) GetPageSize() int32

func (*ListConfigsRequest) GetPageToken

func (m *ListConfigsRequest) GetPageToken() string

func (*ListConfigsRequest) GetParent

func (m *ListConfigsRequest) GetParent() string

func (*ListConfigsRequest) ProtoMessage

func (*ListConfigsRequest) ProtoMessage()

func (*ListConfigsRequest) Reset

func (m *ListConfigsRequest) Reset()

func (*ListConfigsRequest) String

func (m *ListConfigsRequest) String() string

type ListConfigsResponse

type ListConfigsResponse struct {
	// A list of the configurations in the project. The order of returned
	// objects is arbitrary; that is, it is not ordered in any particular way.
	Configs []*RuntimeConfig `protobuf:"bytes,1,rep,name=configs" json:"configs,omitempty"`
	// This token allows you to get the next page of results for list requests.
	// If the number of results is larger than `pageSize`, use the `nextPageToken`
	// as a value for the query parameter `pageToken` in the next list request.
	// Subsequent list requests will have their own `nextPageToken` to continue
	// paging through the results
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken" json:"next_page_token,omitempty"`
}

`ListConfigs()` returns the following response. The order of returned objects is arbitrary; that is, it is not ordered in any particular way.

func (*ListConfigsResponse) Descriptor

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

func (*ListConfigsResponse) GetConfigs

func (m *ListConfigsResponse) GetConfigs() []*RuntimeConfig

func (*ListConfigsResponse) GetNextPageToken

func (m *ListConfigsResponse) GetNextPageToken() string

func (*ListConfigsResponse) ProtoMessage

func (*ListConfigsResponse) ProtoMessage()

func (*ListConfigsResponse) Reset

func (m *ListConfigsResponse) Reset()

func (*ListConfigsResponse) String

func (m *ListConfigsResponse) String() string

type ListVariablesRequest

type ListVariablesRequest struct {
	// The path to the RuntimeConfig resource for which you want to list variables.
	// The configuration must exist beforehand; the path must by in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
	Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
	// Filters variables by matching the specified filter. For example:
	//
	// `projects/example-project/config/[CONFIG_NAME]/variables/example-variable`.
	Filter string `protobuf:"bytes,2,opt,name=filter" json:"filter,omitempty"`
	// Specifies the number of results to return per page. If there are fewer
	// elements than the specified number, returns all elements.
	PageSize int32 `protobuf:"varint,3,opt,name=page_size,json=pageSize" json:"page_size,omitempty"`
	// Specifies a page token to use. Set `pageToken` to a `nextPageToken`
	// returned by a previous list request to get the next page of results.
	PageToken string `protobuf:"bytes,4,opt,name=page_token,json=pageToken" json:"page_token,omitempty"`
	// The flag indicates whether the user wants to return values of variables.
	// If true, then only those variables that user has IAM GetVariable permission
	// will be returned along with their values.
	ReturnValues bool `protobuf:"varint,5,opt,name=return_values,json=returnValues" json:"return_values,omitempty"`
}

Request for the `ListVariables()` method.

func (*ListVariablesRequest) Descriptor

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

func (*ListVariablesRequest) GetFilter

func (m *ListVariablesRequest) GetFilter() string

func (*ListVariablesRequest) GetPageSize

func (m *ListVariablesRequest) GetPageSize() int32

func (*ListVariablesRequest) GetPageToken

func (m *ListVariablesRequest) GetPageToken() string

func (*ListVariablesRequest) GetParent

func (m *ListVariablesRequest) GetParent() string

func (*ListVariablesRequest) GetReturnValues

func (m *ListVariablesRequest) GetReturnValues() bool

func (*ListVariablesRequest) ProtoMessage

func (*ListVariablesRequest) ProtoMessage()

func (*ListVariablesRequest) Reset

func (m *ListVariablesRequest) Reset()

func (*ListVariablesRequest) String

func (m *ListVariablesRequest) String() string

type ListVariablesResponse

type ListVariablesResponse struct {
	// A list of variables and their values. The order of returned variable
	// objects is arbitrary.
	Variables []*Variable `protobuf:"bytes,1,rep,name=variables" json:"variables,omitempty"`
	// This token allows you to get the next page of results for list requests.
	// If the number of results is larger than `pageSize`, use the `nextPageToken`
	// as a value for the query parameter `pageToken` in the next list request.
	// Subsequent list requests will have their own `nextPageToken` to continue
	// paging through the results
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken" json:"next_page_token,omitempty"`
}

Response for the `ListVariables()` method.

func (*ListVariablesResponse) Descriptor

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

func (*ListVariablesResponse) GetNextPageToken

func (m *ListVariablesResponse) GetNextPageToken() string

func (*ListVariablesResponse) GetVariables

func (m *ListVariablesResponse) GetVariables() []*Variable

func (*ListVariablesResponse) ProtoMessage

func (*ListVariablesResponse) ProtoMessage()

func (*ListVariablesResponse) Reset

func (m *ListVariablesResponse) Reset()

func (*ListVariablesResponse) String

func (m *ListVariablesResponse) String() string

type ListWaitersRequest

type ListWaitersRequest struct {
	// The path to the configuration for which you want to get a list of waiters.
	// The configuration must exist beforehand; the path must by in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
	Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
	// Specifies the number of results to return per page. If there are fewer
	// elements than the specified number, returns all elements.
	PageSize int32 `protobuf:"varint,2,opt,name=page_size,json=pageSize" json:"page_size,omitempty"`
	// Specifies a page token to use. Set `pageToken` to a `nextPageToken`
	// returned by a previous list request to get the next page of results.
	PageToken string `protobuf:"bytes,3,opt,name=page_token,json=pageToken" json:"page_token,omitempty"`
}

Request for the `ListWaiters()` method.

func (*ListWaitersRequest) Descriptor

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

func (*ListWaitersRequest) GetPageSize

func (m *ListWaitersRequest) GetPageSize() int32

func (*ListWaitersRequest) GetPageToken

func (m *ListWaitersRequest) GetPageToken() string

func (*ListWaitersRequest) GetParent

func (m *ListWaitersRequest) GetParent() string

func (*ListWaitersRequest) ProtoMessage

func (*ListWaitersRequest) ProtoMessage()

func (*ListWaitersRequest) Reset

func (m *ListWaitersRequest) Reset()

func (*ListWaitersRequest) String

func (m *ListWaitersRequest) String() string

type ListWaitersResponse

type ListWaitersResponse struct {
	// Found waiters in the project.
	Waiters []*Waiter `protobuf:"bytes,1,rep,name=waiters" json:"waiters,omitempty"`
	// This token allows you to get the next page of results for list requests.
	// If the number of results is larger than `pageSize`, use the `nextPageToken`
	// as a value for the query parameter `pageToken` in the next list request.
	// Subsequent list requests will have their own `nextPageToken` to continue
	// paging through the results
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken" json:"next_page_token,omitempty"`
}

Response for the `ListWaiters()` method. Order of returned waiter objects is arbitrary.

func (*ListWaitersResponse) Descriptor

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

func (*ListWaitersResponse) GetNextPageToken

func (m *ListWaitersResponse) GetNextPageToken() string

func (*ListWaitersResponse) GetWaiters

func (m *ListWaitersResponse) GetWaiters() []*Waiter

func (*ListWaitersResponse) ProtoMessage

func (*ListWaitersResponse) ProtoMessage()

func (*ListWaitersResponse) Reset

func (m *ListWaitersResponse) Reset()

func (*ListWaitersResponse) String

func (m *ListWaitersResponse) String() string

type RuntimeConfig

type RuntimeConfig struct {
	// The resource name of a runtime config. The name must have the format:
	//
	//     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
	//
	// The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
	// arbitrary name that matches RFC 1035 segment specification. The length of
	// `[CONFIG_NAME]` must be less than 64 bytes.
	//
	// You pick the RuntimeConfig resource name, but the server will validate that
	// the name adheres to this format. After you create the resource, you cannot
	// change the resource's name.
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	// An optional description of the RuntimeConfig object.
	Description string `protobuf:"bytes,2,opt,name=description" json:"description,omitempty"`
}

A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig service. A RuntimeConfig resource consists of metadata and a hierarchy of variables.

func (*RuntimeConfig) Descriptor

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

func (*RuntimeConfig) GetDescription

func (m *RuntimeConfig) GetDescription() string

func (*RuntimeConfig) GetName

func (m *RuntimeConfig) GetName() string

func (*RuntimeConfig) ProtoMessage

func (*RuntimeConfig) ProtoMessage()

func (*RuntimeConfig) Reset

func (m *RuntimeConfig) Reset()

func (*RuntimeConfig) String

func (m *RuntimeConfig) String() string

type RuntimeConfigManagerClient

type RuntimeConfigManagerClient interface {
	// Lists all the RuntimeConfig resources within project.
	ListConfigs(ctx context.Context, in *ListConfigsRequest, opts ...grpc.CallOption) (*ListConfigsResponse, error)
	// Gets information about a RuntimeConfig resource.
	GetConfig(ctx context.Context, in *GetConfigRequest, opts ...grpc.CallOption) (*RuntimeConfig, error)
	// Creates a new RuntimeConfig resource. The configuration name must be
	// unique within project.
	CreateConfig(ctx context.Context, in *CreateConfigRequest, opts ...grpc.CallOption) (*RuntimeConfig, error)
	// Updates a RuntimeConfig resource. The configuration must exist beforehand.
	UpdateConfig(ctx context.Context, in *UpdateConfigRequest, opts ...grpc.CallOption) (*RuntimeConfig, error)
	// Deletes a RuntimeConfig resource.
	DeleteConfig(ctx context.Context, in *DeleteConfigRequest, opts ...grpc.CallOption) (*google_protobuf4.Empty, error)
	// Lists variables within given a configuration, matching any provided filters.
	// This only lists variable names, not the values, unless `return_values` is
	// true, in which case only variables that user has IAM permission to
	// GetVariable will be returned.
	ListVariables(ctx context.Context, in *ListVariablesRequest, opts ...grpc.CallOption) (*ListVariablesResponse, error)
	// Gets information about a single variable.
	GetVariable(ctx context.Context, in *GetVariableRequest, opts ...grpc.CallOption) (*Variable, error)
	// Watches a specific variable and waits for a change in the variable's value.
	// When there is a change, this method returns the new value or times out.
	//
	// If a variable is deleted while being watched, the `variableState` state is
	// set to `DELETED` and the method returns the last known variable `value`.
	//
	// If you set the deadline for watching to a larger value than internal timeout
	// (60 seconds), the current variable value is returned and the `variableState`
	// will be `VARIABLE_STATE_UNSPECIFIED`.
	//
	// To learn more about creating a watcher, read the
	// [Watching a Variable for Changes](/deployment-manager/runtime-configurator/watching-a-variable)
	// documentation.
	WatchVariable(ctx context.Context, in *WatchVariableRequest, opts ...grpc.CallOption) (*Variable, error)
	// Creates a variable within the given configuration. You cannot create
	// a variable with a name that is a prefix of an existing variable name, or a
	// name that has an existing variable name as a prefix.
	//
	// To learn more about creating a variable, read the
	// [Setting and Getting Data](/deployment-manager/runtime-configurator/set-and-get-variables)
	// documentation.
	CreateVariable(ctx context.Context, in *CreateVariableRequest, opts ...grpc.CallOption) (*Variable, error)
	// Updates an existing variable with a new value.
	UpdateVariable(ctx context.Context, in *UpdateVariableRequest, opts ...grpc.CallOption) (*Variable, error)
	// Deletes a variable or multiple variables.
	//
	// If you specify a variable name, then that variable is deleted. If you
	// specify a prefix and `recursive` is true, then all variables with that
	// prefix are deleted. You must set a `recursive` to true if you delete
	// variables by prefix.
	DeleteVariable(ctx context.Context, in *DeleteVariableRequest, opts ...grpc.CallOption) (*google_protobuf4.Empty, error)
	// List waiters within the given configuration.
	ListWaiters(ctx context.Context, in *ListWaitersRequest, opts ...grpc.CallOption) (*ListWaitersResponse, error)
	// Gets information about a single waiter.
	GetWaiter(ctx context.Context, in *GetWaiterRequest, opts ...grpc.CallOption) (*Waiter, error)
	// Creates a Waiter resource. This operation returns a long-running Operation
	// resource which can be polled for completion. However, a waiter with the
	// given name will exist (and can be retrieved) prior to the operation
	// completing. If the operation fails, the failed Waiter resource will
	// still exist and must be deleted prior to subsequent creation attempts.
	CreateWaiter(ctx context.Context, in *CreateWaiterRequest, opts ...grpc.CallOption) (*google_longrunning.Operation, error)
	// Deletes the waiter with the specified name.
	DeleteWaiter(ctx context.Context, in *DeleteWaiterRequest, opts ...grpc.CallOption) (*google_protobuf4.Empty, error)
}

func NewRuntimeConfigManagerClient

func NewRuntimeConfigManagerClient(cc *grpc.ClientConn) RuntimeConfigManagerClient

type RuntimeConfigManagerServer

type RuntimeConfigManagerServer interface {
	// Lists all the RuntimeConfig resources within project.
	ListConfigs(context.Context, *ListConfigsRequest) (*ListConfigsResponse, error)
	// Gets information about a RuntimeConfig resource.
	GetConfig(context.Context, *GetConfigRequest) (*RuntimeConfig, error)
	// Creates a new RuntimeConfig resource. The configuration name must be
	// unique within project.
	CreateConfig(context.Context, *CreateConfigRequest) (*RuntimeConfig, error)
	// Updates a RuntimeConfig resource. The configuration must exist beforehand.
	UpdateConfig(context.Context, *UpdateConfigRequest) (*RuntimeConfig, error)
	// Deletes a RuntimeConfig resource.
	DeleteConfig(context.Context, *DeleteConfigRequest) (*google_protobuf4.Empty, error)
	// Lists variables within given a configuration, matching any provided filters.
	// This only lists variable names, not the values, unless `return_values` is
	// true, in which case only variables that user has IAM permission to
	// GetVariable will be returned.
	ListVariables(context.Context, *ListVariablesRequest) (*ListVariablesResponse, error)
	// Gets information about a single variable.
	GetVariable(context.Context, *GetVariableRequest) (*Variable, error)
	// Watches a specific variable and waits for a change in the variable's value.
	// When there is a change, this method returns the new value or times out.
	//
	// If a variable is deleted while being watched, the `variableState` state is
	// set to `DELETED` and the method returns the last known variable `value`.
	//
	// If you set the deadline for watching to a larger value than internal timeout
	// (60 seconds), the current variable value is returned and the `variableState`
	// will be `VARIABLE_STATE_UNSPECIFIED`.
	//
	// To learn more about creating a watcher, read the
	// [Watching a Variable for Changes](/deployment-manager/runtime-configurator/watching-a-variable)
	// documentation.
	WatchVariable(context.Context, *WatchVariableRequest) (*Variable, error)
	// Creates a variable within the given configuration. You cannot create
	// a variable with a name that is a prefix of an existing variable name, or a
	// name that has an existing variable name as a prefix.
	//
	// To learn more about creating a variable, read the
	// [Setting and Getting Data](/deployment-manager/runtime-configurator/set-and-get-variables)
	// documentation.
	CreateVariable(context.Context, *CreateVariableRequest) (*Variable, error)
	// Updates an existing variable with a new value.
	UpdateVariable(context.Context, *UpdateVariableRequest) (*Variable, error)
	// Deletes a variable or multiple variables.
	//
	// If you specify a variable name, then that variable is deleted. If you
	// specify a prefix and `recursive` is true, then all variables with that
	// prefix are deleted. You must set a `recursive` to true if you delete
	// variables by prefix.
	DeleteVariable(context.Context, *DeleteVariableRequest) (*google_protobuf4.Empty, error)
	// List waiters within the given configuration.
	ListWaiters(context.Context, *ListWaitersRequest) (*ListWaitersResponse, error)
	// Gets information about a single waiter.
	GetWaiter(context.Context, *GetWaiterRequest) (*Waiter, error)
	// Creates a Waiter resource. This operation returns a long-running Operation
	// resource which can be polled for completion. However, a waiter with the
	// given name will exist (and can be retrieved) prior to the operation
	// completing. If the operation fails, the failed Waiter resource will
	// still exist and must be deleted prior to subsequent creation attempts.
	CreateWaiter(context.Context, *CreateWaiterRequest) (*google_longrunning.Operation, error)
	// Deletes the waiter with the specified name.
	DeleteWaiter(context.Context, *DeleteWaiterRequest) (*google_protobuf4.Empty, error)
}

type UpdateConfigRequest

type UpdateConfigRequest struct {
	// The name of the RuntimeConfig resource to update, in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	// The config resource to update.
	Config *RuntimeConfig `protobuf:"bytes,2,opt,name=config" json:"config,omitempty"`
}

Request message for `UpdateConfig()` method.

func (*UpdateConfigRequest) Descriptor

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

func (*UpdateConfigRequest) GetConfig

func (m *UpdateConfigRequest) GetConfig() *RuntimeConfig

func (*UpdateConfigRequest) GetName

func (m *UpdateConfigRequest) GetName() string

func (*UpdateConfigRequest) ProtoMessage

func (*UpdateConfigRequest) ProtoMessage()

func (*UpdateConfigRequest) Reset

func (m *UpdateConfigRequest) Reset()

func (*UpdateConfigRequest) String

func (m *UpdateConfigRequest) String() string

type UpdateVariableRequest

type UpdateVariableRequest struct {
	// The name of the variable to update, in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]`
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	// The variable to update.
	Variable *Variable `protobuf:"bytes,2,opt,name=variable" json:"variable,omitempty"`
}

Request for the `UpdateVariable()` method.

func (*UpdateVariableRequest) Descriptor

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

func (*UpdateVariableRequest) GetName

func (m *UpdateVariableRequest) GetName() string

func (*UpdateVariableRequest) GetVariable

func (m *UpdateVariableRequest) GetVariable() *Variable

func (*UpdateVariableRequest) ProtoMessage

func (*UpdateVariableRequest) ProtoMessage()

func (*UpdateVariableRequest) Reset

func (m *UpdateVariableRequest) Reset()

func (*UpdateVariableRequest) String

func (m *UpdateVariableRequest) String() string

type Variable

type Variable struct {
	// The name of the variable resource, in the format:
	//
	//     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
	//
	// The `[PROJECT_ID]` must be a valid project ID, `[CONFIG_NAME]` must be a
	// valid RuntimeConfig reource and `[VARIABLE_NAME]` follows Unix file system
	// file path naming.
	//
	// The `[VARIABLE_NAME]` can contain ASCII letters, numbers, slashes and
	// dashes. Slashes are used as path element separators and are not part of the
	// `[VARIABLE_NAME]` itself, so `[VARIABLE_NAME]` must contain at least one
	// non-slash character. Multiple slashes are coalesced into single slash
	// character. Each path segment should follow RFC 1035 segment specification.
	// The length of a `[VARIABLE_NAME]` must be less than 256 bytes.
	//
	// Once you create a variable, you cannot change the variable name.
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	// The the value of the variable. It can be either a binary or a string
	// value. You must specify one of either `value` or `text`. Specifying both
	// will cause the server to return an error.
	//
	// Types that are valid to be assigned to Contents:
	//	*Variable_Value
	//	*Variable_Text
	Contents isVariable_Contents `protobuf_oneof:"contents"`
	// [Output Only] The time of the last variable update.
	UpdateTime *google_protobuf2.Timestamp `protobuf:"bytes,3,opt,name=update_time,json=updateTime" json:"update_time,omitempty"`
	// [Ouput only] The current state of the variable. The variable state indicates
	// the outcome of the `variables().watch` call and is visible through the
	// `get` and `list` calls.
	State VariableState `protobuf:"varint,4,opt,name=state,enum=google.cloud.runtimeconfig.v1beta1.VariableState" json:"state,omitempty"`
}

Describes a single variable within a RuntimeConfig resource. The name denotes the hierarchical variable name. For example, `ports/serving_port` is a valid variable name. The variable value is an opaque string and only leaf variables can have values (that is, variables that do not have any child variables).

func (*Variable) Descriptor

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

func (*Variable) GetContents

func (m *Variable) GetContents() isVariable_Contents

func (*Variable) GetName

func (m *Variable) GetName() string

func (*Variable) GetState

func (m *Variable) GetState() VariableState

func (*Variable) GetText

func (m *Variable) GetText() string

func (*Variable) GetUpdateTime

func (m *Variable) GetUpdateTime() *google_protobuf2.Timestamp

func (*Variable) GetValue

func (m *Variable) GetValue() []byte

func (*Variable) ProtoMessage

func (*Variable) ProtoMessage()

func (*Variable) Reset

func (m *Variable) Reset()

func (*Variable) String

func (m *Variable) String() string

func (*Variable) XXX_OneofFuncs

func (*Variable) XXX_OneofFuncs() (func(msg proto.Message, b *proto.Buffer) error, func(msg proto.Message, tag, wire int, b *proto.Buffer) (bool, error), func(msg proto.Message) (n int), []interface{})

XXX_OneofFuncs is for the internal use of the proto package.

type VariableState

type VariableState int32

The `VariableState` describes the last known state of the variable and is used during a `variables().watch` call to distinguish the state of the variable.

const (
	// Default variable state.
	VariableState_VARIABLE_STATE_UNSPECIFIED VariableState = 0
	// The variable was updated, while `variables().watch` was executing.
	VariableState_UPDATED VariableState = 1
	// The variable was deleted, while `variables().watch` was executing.
	VariableState_DELETED VariableState = 2
)

func (VariableState) EnumDescriptor

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

func (VariableState) String

func (x VariableState) String() string

type Variable_Text

type Variable_Text struct {
	Text string `protobuf:"bytes,5,opt,name=text,oneof"`
}

type Variable_Value

type Variable_Value struct {
	Value []byte `protobuf:"bytes,2,opt,name=value,proto3,oneof"`
}

type Waiter

type Waiter struct {
	// The name of the Waiter resource, in the format:
	//
	//     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
	//
	// The `[PROJECT_ID]` must be a valid Google Cloud project ID,
	// the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
	// `[WAITER_NAME]` must match RFC 1035 segment specification, and the length
	// of `[WAITER_NAME]` must be less than 64 bytes.
	//
	// After you create a Waiter resource, you cannot change the resource name.
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	// [Required] Specifies the timeout of the waiter in seconds, beginning from
	// the instant that `waiters().create` method is called. If this time elapses
	// before the success or failure conditions are met, the waiter fails and sets
	// the `error` code to `DEADLINE_EXCEEDED`.
	Timeout *google_protobuf1.Duration `protobuf:"bytes,2,opt,name=timeout" json:"timeout,omitempty"`
	// [Optional] The failure condition of this waiter. If this condition is met,
	// `done` will be set to `true` and the `error` code will be set to `ABORTED`.
	// The failure condition takes precedence over the success condition. If both
	// conditions are met, a failure will be indicated. This value is optional; if
	// no failure condition is set, the only failure scenario will be a timeout.
	Failure *EndCondition `protobuf:"bytes,3,opt,name=failure" json:"failure,omitempty"`
	// [Required] The success condition. If this condition is met, `done` will be
	// set to `true` and the `error` value will remain unset. The failure condition
	// takes precedence over the success condition. If both conditions are met, a
	// failure will be indicated.
	Success *EndCondition `protobuf:"bytes,4,opt,name=success" json:"success,omitempty"`
	// [Output Only] The instant at which this Waiter resource was created. Adding
	// the value of `timeout` to this instant yields the timeout deadline for the
	// waiter.
	CreateTime *google_protobuf2.Timestamp `protobuf:"bytes,5,opt,name=create_time,json=createTime" json:"create_time,omitempty"`
	// [Output Only] If the value is `false`, it means the waiter is still waiting
	// for one of its conditions to be met.
	//
	// If true, the waiter has finished. If the waiter finished due to a timeout
	// or failure, `error` will be set.
	Done bool `protobuf:"varint,6,opt,name=done" json:"done,omitempty"`
	// [Output Only] If the waiter ended due to a failure or timeout, this value
	// will be set.
	Error *google_rpc.Status `protobuf:"bytes,7,opt,name=error" json:"error,omitempty"`
}

A Waiter resource waits for some end condition within a RuntimeConfig resource to be met before it returns. For example, assume you have a distributed system where each node writes to a Variable resource indidicating the node's readiness as part of the startup process.

You then configure a Waiter resource with the success condition set to wait until some number of nodes have checked in. Afterwards, your application runs some arbitrary code after the condition has been met and the waiter returns successfully.

Once created, a Waiter resource is immutable.

To learn more about using waiters, read the [Creating a Waiter](/deployment-manager/runtime-configurator/creating-a-waiter) documentation.

func (*Waiter) Descriptor

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

func (*Waiter) GetCreateTime

func (m *Waiter) GetCreateTime() *google_protobuf2.Timestamp

func (*Waiter) GetDone

func (m *Waiter) GetDone() bool

func (*Waiter) GetError

func (m *Waiter) GetError() *google_rpc.Status

func (*Waiter) GetFailure

func (m *Waiter) GetFailure() *EndCondition

func (*Waiter) GetName

func (m *Waiter) GetName() string

func (*Waiter) GetSuccess

func (m *Waiter) GetSuccess() *EndCondition

func (*Waiter) GetTimeout

func (m *Waiter) GetTimeout() *google_protobuf1.Duration

func (*Waiter) ProtoMessage

func (*Waiter) ProtoMessage()

func (*Waiter) Reset

func (m *Waiter) Reset()

func (*Waiter) String

func (m *Waiter) String() string

type WatchVariableRequest

type WatchVariableRequest struct {
	// The name of the variable to watch, in the format:
	//
	// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	// If specified, checks the current timestamp of the variable and if the
	// current timestamp is newer than `newerThan` timestamp, the method returns
	// immediately.
	//
	// If not specified or the variable has an older timestamp, the watcher waits
	// for a the value to change before returning.
	NewerThan *google_protobuf2.Timestamp `protobuf:"bytes,4,opt,name=newer_than,json=newerThan" json:"newer_than,omitempty"`
}

Request for the `WatchVariable()` method.

func (*WatchVariableRequest) Descriptor

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

func (*WatchVariableRequest) GetName

func (m *WatchVariableRequest) GetName() string

func (*WatchVariableRequest) GetNewerThan

func (m *WatchVariableRequest) GetNewerThan() *google_protobuf2.Timestamp

func (*WatchVariableRequest) ProtoMessage

func (*WatchVariableRequest) ProtoMessage()

func (*WatchVariableRequest) Reset

func (m *WatchVariableRequest) Reset()

func (*WatchVariableRequest) String

func (m *WatchVariableRequest) String() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL