...
ActiveGo 1.8Package runtimeconfig
Overview ▹
Index ▹
Variables
var VariableState_name = map[int32]string{
0: "VARIABLE_STATE_UNSPECIFIED",
1: "UPDATED",
2: "DELETED",
}
var VariableState_value = map[string]int32{
"VARIABLE_STATE_UNSPECIFIED": 0,
"UPDATED": 1,
"DELETED": 2,
}
func RegisterRuntimeConfigManagerServer ¶
func RegisterRuntimeConfigManagerServer(s *grpc.Server, srv RuntimeConfigManagerServer)
type CreateConfigRequest ¶
Creates a RuntimeConfig resource.
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"`
}
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 ¶
Request for the `CreateVariable()` method.
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"`
}
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 ¶
Request message for `CreateWaiter()` method.
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"`
}
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 ¶
Request for the `DeleteConfig()` method.
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"`
}
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 ¶
Request for the `DeleteVariable()` method.
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"`
}
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 ¶
Request for the `DeleteWaiter()` method.
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"`
}
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 ¶
The condition that a Waiter resource is waiting for.
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"`
}
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 ¶
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.
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"`
}
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 ¶
Gets a RuntimeConfig resource.
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"`
}
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 ¶
Request for the `GetVariable()` method.
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"`
}
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 ¶
Request for the `GetWaiter()` method.
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"`
}
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 ¶
Request for the `ListConfigs()` method.
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"`
}
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 ¶
`ListConfigs()` returns the following response. The order of returned objects is arbitrary; that is, it is not ordered in any particular way.
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"`
}
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 ¶
Request for the `ListVariables()` method.
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"`
}
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 ¶
Response for the `ListVariables()` method.
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"`
}
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 ¶
Request for the `ListWaiters()` method.
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"`
}
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 ¶
Response for the `ListWaiters()` method. Order of returned waiter objects is arbitrary.
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"`
}
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 ¶
A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig service. A RuntimeConfig resource consists of metadata and a hierarchy of variables.
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"`
}
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 ¶
Request message for `UpdateConfig()` method.
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"`
}
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 ¶
Request for the `UpdateVariable()` method.
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"`
}
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 ¶
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).
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"`
}
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 ¶
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.
type VariableState int32
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 ¶
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.
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"`
}
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 ¶
Request for the `WatchVariable()` method.
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"`
}
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