suguo
/
googleapis
0
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

docs: Fixed casing in proto documentation to match other documentation. 

feat: Added retry configuration.

PiperOrigin-RevId: 317139704
This commit is contained in:
Google APIs 2020-06-18 11:06:46 -07:00 committed by Copybara-Service
parent eb37e68833
commit 4684dae25e
12 changed files with 177 additions and 123 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
google/cloud/gaming/v1beta/BUILD.bazel
View File

@ -126,7 +126,7 @@ go_proto_library(
go_gapic_library(
name = "gaming_go_gapic",
srcs = [":gaming_proto_with_info"],
grpc_service_config = "",
grpc_service_config = "gaming_grpc_service_config.json",
importpath = "cloud.google.com/go/gaming/apiv1beta;gaming",
service_yaml = "gameservices_v1beta.yaml",
deps = [
@ -272,7 +272,7 @@ load(
nodejs_gapic_library(
name = "gaming_nodejs_gapic",
src = ":gaming_proto_with_info",
grpc_service_config = None,
grpc_service_config = "gaming_grpc_service_config.json",
package = "google.cloud.gaming.v1beta",
service_yaml = "gameservices_v1beta.yaml",
deps = [],

16
google/cloud/gaming/v1beta/common.proto
View File

@ -55,7 +55,7 @@ message OperationMetadata {
// Output only. List of Locations that could not be reached.
repeated string unreachable = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Operation status for gameservices API operations. Operation status is in
// Output only. Operation status for Game Services API operations. Operation status is in
// the form of key-value pairs where keys are resource IDs and the values show
// the status of the operation. In case of failures, the value includes an
// error code and error message.
@ -89,9 +89,9 @@ message LabelSelector {
map<string, string> labels = 1;
}
// The Realm selector, used to match Realm resources.
// The realm selector, used to match realm resources.
message RealmSelector {
// List of Realms to match.
// List of realms to match.
repeated string realms = 1;
}
@ -116,13 +116,13 @@ message Schedule {
// The cron definition of the scheduled event. See
// https://en.wikipedia.org/wiki/Cron. Cron spec specifies the local time as
// defined by the Realm.
// defined by the realm.
string cron_spec = 4;
}
// Encapsulates Agones fleet spec and Agones autoscaler spec sources.
message SpecSource {
// The Game Server Config resource. Uses the form:
// The game server config resource. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment_id}/configs/{config_id}`.
string game_server_config_name = 1;
@ -163,17 +163,17 @@ message TargetDetails {
TargetFleetAutoscaler autoscaler = 2;
}
// The Game Server Cluster name. Uses the form:
// The game server cluster name. Uses the form:
//
// `projects/{project}/locations/{location}/realms/{realm}/gameServerClusters/{cluster}`.
string game_server_cluster_name = 1;
// The Game Server Deployment name. Uses the form:
// The game server deployment name. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment_id}`.
string game_server_deployment_name = 2;
// Agones fleet details for Game Server Clusters and Game Server Deployments.
// Agones fleet details for game server clusters and game server deployments.
repeated TargetFleetDetails fleet_details = 3;
}

40
google/cloud/gaming/v1beta/game_server_clusters.proto
View File

@ -39,8 +39,8 @@ message ListGameServerClustersRequest {
}
];
// Optional. The maximum number of items to return. If unspecified, server
// will pick an appropriate default. Server may return fewer items than
// Optional. The maximum number of items to return. If unspecified, the server
// will pick an appropriate default. The server may return fewer items than
// requested. A caller should only rely on response's
// [next_page_token][google.cloud.gaming.v1beta.ListGameServerClustersResponse.next_page_token] to
// determine if there are more GameServerClusters left to be queried.
@ -59,20 +59,20 @@ message ListGameServerClustersRequest {
// Response message for GameServerClustersService.ListGameServerClusters.
message ListGameServerClustersResponse {
// The list of Game Server Clusters.
// The list of game server clusters.
repeated GameServerCluster game_server_clusters = 1;
// Token to retrieve the next page of results, or empty if there are no more
// results in the list.
string next_page_token = 2;
// List of Locations that could not be reached.
// List of locations that could not be reached.
repeated string unreachable = 4;
}
// Request message for GameServerClustersService.GetGameServerCluster.
message GetGameServerClusterRequest {
// Required. The name of the Game Server Cluster to retrieve. Uses the form:
// Required. The name of the game server cluster to retrieve. Uses the form:
//
// `projects/{project}/locations/{location}/realms/{realm-id}/gameServerClusters/{cluster}`.
string name = 1 [
@ -94,10 +94,10 @@ message CreateGameServerClusterRequest {
}
];
// Required. The ID of the Game Server Cluster resource to be created.
// Required. The ID of the game server cluster resource to be created.
string game_server_cluster_id = 2 [(google.api.field_behavior) = REQUIRED];
// Required. The Game Server Cluster resource to be created.
// Required. The game server cluster resource to be created.
GameServerCluster game_server_cluster = 3 [(google.api.field_behavior) = REQUIRED];
}
@ -112,10 +112,10 @@ message PreviewCreateGameServerClusterRequest {
}
];
// Required. The ID of the Game Server Cluster resource to be created.
// Required. The ID of the game server cluster resource to be created.
string game_server_cluster_id = 2 [(google.api.field_behavior) = REQUIRED];
// Required. The Game Server Cluster resource to be created.
// Required. The game server cluster resource to be created.
GameServerCluster game_server_cluster = 3 [(google.api.field_behavior) = REQUIRED];
// Optional. The target timestamp to compute the preview.
@ -134,7 +134,7 @@ message PreviewCreateGameServerClusterResponse {
// Request message for GameServerClustersService.DeleteGameServerCluster.
message DeleteGameServerClusterRequest {
// Required. The name of the Game Server Cluster to delete. Uses the form:
// Required. The name of the game server cluster to delete. Uses the form:
// `projects/{project}/locations/{location}/gameServerClusters/{cluster}`.
string name = 1 [
(google.api.field_behavior) = REQUIRED,
@ -146,7 +146,7 @@ message DeleteGameServerClusterRequest {
// Request message for GameServerClustersService.PreviewDeleteGameServerCluster.
message PreviewDeleteGameServerClusterRequest {
// Required. The name of the Game Server Cluster to delete. Uses the form:
// Required. The name of the game server cluster to delete. Uses the form:
// `projects/{project}/locations/{location}/gameServerClusters/{cluster}`.
string name = 1 [
(google.api.field_behavior) = REQUIRED,
@ -171,7 +171,7 @@ message PreviewDeleteGameServerClusterResponse {
// Request message for GameServerClustersService.UpdateGameServerCluster.
message UpdateGameServerClusterRequest {
// Required. The Game Server Cluster to be updated.
// Required. The game server cluster to be updated.
// Only fields specified in update_mask are updated.
GameServerCluster game_server_cluster = 1 [(google.api.field_behavior) = REQUIRED];
@ -186,7 +186,7 @@ message UpdateGameServerClusterRequest {
// Request message for GameServerClustersService.UpdateGameServerCluster.
message PreviewUpdateGameServerClusterRequest {
// Required. The Game Server Cluster to be updated.
// Required. The game server cluster to be updated.
// Only fields specified in update_mask are updated.
GameServerCluster game_server_cluster = 1 [(google.api.field_behavior) = REQUIRED];
@ -211,7 +211,7 @@ message PreviewUpdateGameServerClusterResponse {
TargetState target_state = 3;
}
// The Game Server Cluster connection information.
// The game server cluster connection information.
message GameServerClusterConnectionInfo {
// The location of the Kubernetes cluster.
oneof cluster_reference {
@ -219,7 +219,7 @@ message GameServerClusterConnectionInfo {
GkeClusterReference gke_cluster_reference = 7;
}
// Namespace designated on the Game Server Cluster where the Agones game
// Namespace designated on the game server cluster where the Agones game
// server instances will be created. Existence of the namespace will be
// validated during creation.
string namespace = 5;
@ -238,14 +238,14 @@ message GkeClusterReference {
string cluster = 1;
}
// A Game Server Cluster resource.
// A game server cluster resource.
message GameServerCluster {
option (google.api.resource) = {
type: "gameservices.googleapis.com/GameServerCluster"
pattern: "projects/{project}/locations/{location}/realms/{realm}/gameServerClusters/{cluster}"
};
// Required. The resource name of the Game Server Cluster. Uses the form:
// Required. The resource name of the game server cluster. Uses the form:
//
// `projects/{project}/locations/{location}/realms/{realm}/gameServerClusters/{cluster}`.
// For example,
@ -259,12 +259,12 @@ message GameServerCluster {
// Output only. The last-modified time.
google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
// The labels associated with this Game Server Cluster. Each label is a
// The labels associated with this game server cluster. Each label is a
// key-value pair.
map<string, string> labels = 4;
// Game Server Cluster connection information. This information is used to
// manage Game Server Clusters.
// The game server cluster connection information. This information is used to
// manage game server clusters.
GameServerClusterConnectionInfo connection_info = 5;
// ETag of the resource.

2
google/cloud/gaming/v1beta/game_server_clusters_service.proto
View File

@ -32,7 +32,7 @@ service GameServerClustersService {
option (google.api.default_host) = "gameservices.googleapis.com";
option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
// Lists Game Server Clusters in a given project and location.
// Lists game server clusters in a given project and location.
rpc ListGameServerClusters(ListGameServerClustersRequest) returns (ListGameServerClustersResponse) {
option (google.api.http) = {
get: "/v1beta/{parent=projects/*/locations/*/realms/*}/gameServerClusters"

26
google/cloud/gaming/v1beta/game_server_configs.proto
View File

@ -46,7 +46,7 @@ message ListGameServerConfigsRequest {
// determine if there are more GameServerConfigs left to be queried.
int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
// Optional. The next_page_token value returned from a previous List request, if any.
// Optional. The next_page_token value returned from a previous list request, if any.
string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
// Optional. The filter to apply to list results.
@ -59,20 +59,20 @@ message ListGameServerConfigsRequest {
// Response message for GameServerConfigsService.ListGameServerConfigs.
message ListGameServerConfigsResponse {
// The list of Game Server Configs.
// The list of game server configs.
repeated GameServerConfig game_server_configs = 1;
// Token to retrieve the next page of results, or empty if there are no more
// results in the list.
string next_page_token = 2;
// List of Locations that could not be reached.
// List of locations that could not be reached.
repeated string unreachable = 4;
}
// Request message for GameServerConfigsService.GetGameServerConfig.
message GetGameServerConfigRequest {
// Required. The name of the Game Server Config to retrieve. Uses the form:
// Required. The name of the game server config to retrieve. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/configs/{config}`.
string name = 1 [
@ -95,16 +95,16 @@ message CreateGameServerConfigRequest {
}
];
// Required. The ID of the Game Server Config resource to be created.
// Required. The ID of the game server config resource to be created.
string config_id = 2 [(google.api.field_behavior) = REQUIRED];
// Required. The Game Server Config resource to be created.
// Required. The game server config resource to be created.
GameServerConfig game_server_config = 3 [(google.api.field_behavior) = REQUIRED];
}
// Request message for GameServerConfigsService.DeleteGameServerConfig.
message DeleteGameServerConfigRequest {
// Required. The name of the Game Server Config to delete. Uses the form:
// Required. The name of the game server config to delete. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/configs/{config}`.
string name = 1 [
@ -124,8 +124,8 @@ message ScalingConfig {
// https://agones.dev/site/docs/reference/fleetautoscaler/
string fleet_autoscaler_spec = 2 [(google.api.field_behavior) = REQUIRED];
// Labels used to identify the Game Server Clusters to which this Agones
// scaling config applies. A Game Server Cluster is subject to this Agones
// Labels used to identify the game server clusters to which this Agones
// scaling config applies. A game server cluster is subject to this Agones
// scaling config if its labels match any of the selector entries.
repeated LabelSelector selectors = 4;
@ -143,14 +143,14 @@ message FleetConfig {
string name = 2;
}
// A Game Server Config resource.
// A game server config resource.
message GameServerConfig {
option (google.api.resource) = {
type: "gameservices.googleapis.com/GameServerConfig"
pattern: "projects/{project}/locations/{location}/gameServerDeployments/{deployment}/configs/{config}"
};
// The resource name of the Game Server Config. Uses the form:
// The resource name of the game server config. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/configs/{config}`.
// For example,
@ -164,7 +164,7 @@ message GameServerConfig {
// Output only. The last-modified time.
google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
// The labels associated with this Game Server Config. Each label is a
// The labels associated with this game server config. Each label is a
// key-value pair.
map<string, string> labels = 4;
@ -175,6 +175,6 @@ message GameServerConfig {
// The autoscaling settings.
repeated ScalingConfig scaling_configs = 6;
// The description of the Game Server Config.
// The description of the game server config.
string description = 7;
}

18
google/cloud/gaming/v1beta/game_server_configs_service.proto
View File

@ -26,13 +26,13 @@ option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;g
option java_multiple_files = true;
option java_package = "com.google.cloud.gaming.v1beta";
// The Game Server Config configures the game servers in an Agones fleet.
// The game server config configures the game servers in an Agones fleet.
service GameServerConfigsService {
option (google.api.default_host) = "gameservices.googleapis.com";
option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
// Lists Game Server Configs in a given project, Location, and Game Server
// Deployment.
// Lists game server configs in a given project, location, and game server
// deployment.
rpc ListGameServerConfigs(ListGameServerConfigsRequest) returns (ListGameServerConfigsResponse) {
option (google.api.http) = {
get: "/v1beta/{parent=projects/*/locations/*/gameServerDeployments/*}/configs"
@ -40,7 +40,7 @@ service GameServerConfigsService {
option (google.api.method_signature) = "parent";
}
// Gets details of a single Game Server Config.
// Gets details of a single game server config.
rpc GetGameServerConfig(GetGameServerConfigRequest) returns (GameServerConfig) {
option (google.api.http) = {
get: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*/configs/*}"
@ -48,9 +48,9 @@ service GameServerConfigsService {
option (google.api.method_signature) = "name";
}
// Creates a new Game Server Config in a given project, Location, and Game
// Server Deployment. Game Server Configs are immutable, and are not applied
// until referenced in the Game Server Deployment Rollout resource.
// Creates a new game server config in a given project, location, and game
// server deployment. Game server configs are immutable, and are not applied
// until referenced in the game server deployment rollout resource.
rpc CreateGameServerConfig(CreateGameServerConfigRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
post: "/v1beta/{parent=projects/*/locations/*/gameServerDeployments/*}/configs"
@ -63,8 +63,8 @@ service GameServerConfigsService {
};
}
// Deletes a single Game Server Config. The deletion will fail if the Game
// Server Config is referenced in a Game Server Deployment Rollout.
// Deletes a single game server config. The deletion will fail if the game
// server config is referenced in a game server deployment rollout.
rpc DeleteGameServerConfig(DeleteGameServerConfigRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
delete: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*/configs/*}"

64
google/cloud/gaming/v1beta/game_server_deployments.proto
View File

@ -39,8 +39,8 @@ message ListGameServerDeploymentsRequest {
}
];
// Optional. The maximum number of items to return. If unspecified, server
// will pick an appropriate default. Server may return fewer items than
// Optional. The maximum number of items to return. If unspecified, the server
// will pick an appropriate default. The server may return fewer items than
// requested. A caller should only rely on response's
// [next_page_token][google.cloud.gaming.v1beta.ListGameServerDeploymentsResponse.next_page_token] to
// determine if there are more GameServerDeployments left to be queried.
@ -60,20 +60,20 @@ message ListGameServerDeploymentsRequest {
// Response message for GameServerDeploymentsService.ListGameServerDeployments.
message ListGameServerDeploymentsResponse {
// The list of Game Server Delpoyments.
// The list of game server deployments.
repeated GameServerDeployment game_server_deployments = 1;
// Token to retrieve the next page of results, or empty if there are no more
// results in the list.
string next_page_token = 2;
// List of Locations that could not be reached.
// List of locations that could not be reached.
repeated string unreachable = 4;
}
// Request message for GameServerDeploymentsService.GetGameServerDeployment.
message GetGameServerDeploymentRequest {
// Required. The name of the Game Server Deployment to retrieve. Uses the form:
// Required. The name of the game server delpoyment to retrieve. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment}`.
string name = 1 [
@ -87,7 +87,7 @@ message GetGameServerDeploymentRequest {
// Request message for
// GameServerDeploymentsService.GetGameServerDeploymentRollout.
message GetGameServerDeploymentRolloutRequest {
// Required. The name of the Game Server Deployment to retrieve. Uses the form:
// Required. The name of the game server delpoyment to retrieve. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/rollout`.
string name = 1 [
@ -109,16 +109,16 @@ message CreateGameServerDeploymentRequest {
}
];
// Required. The ID of the Game Server Deployment resource to be created.
// Required. The ID of the game server delpoyment resource to be created.
string deployment_id = 2 [(google.api.field_behavior) = REQUIRED];
// Required. The Game Server Deployment resource to be created.
// Required. The game server delpoyment resource to be created.
GameServerDeployment game_server_deployment = 3 [(google.api.field_behavior) = REQUIRED];
}
// Request message for GameServerDeploymentsService.DeleteGameServerDeployment.
message DeleteGameServerDeploymentRequest {
// Required. The name of the Game Server Deployment to delete. Uses the form:
// Required. The name of the game server delpoyment to delete. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment}`.
string name = 1 [
@ -132,7 +132,7 @@ message DeleteGameServerDeploymentRequest {
// Request message for GameServerDeploymentsService.UpdateGameServerDeployment.
// Only allows updates for labels.
message UpdateGameServerDeploymentRequest {
// Required. The Game Server Deployment to be updated.
// Required. The game server delpoyment to be updated.
// Only fields specified in update_mask are updated.
GameServerDeployment game_server_deployment = 1 [(google.api.field_behavior) = REQUIRED];
@ -148,7 +148,7 @@ message UpdateGameServerDeploymentRequest {
// Request message for
// GameServerDeploymentsService.UpdateGameServerRolloutDeployment.
message UpdateGameServerDeploymentRolloutRequest {
// Required. The Game Server Deployment Rollout to be updated.
// Required. The game server delpoyment rollout to be updated.
// Only fields specified in update_mask are updated.
GameServerDeploymentRollout rollout = 1 [(google.api.field_behavior) = REQUIRED];
@ -163,7 +163,7 @@ message UpdateGameServerDeploymentRolloutRequest {
// Request message for GameServerDeploymentsService.FetchDeploymentState.
message FetchDeploymentStateRequest {
// Required. The name of the Game Server Deployment. Uses the form:
// Required. The name of the game server delpoyment. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment}`.
string name = 1 [(google.api.field_behavior) = REQUIRED];
@ -171,31 +171,31 @@ message FetchDeploymentStateRequest {
// Response message for GameServerDeploymentsService.FetchDeploymentState.
message FetchDeploymentStateResponse {
// The Game Server Cluster changes made by the Game Server Deployment.
// The game server cluster changes made by the game server deployment.
message DeployedClusterState {
// The name of the cluster.
string cluster = 1;
// The details about the Agones fleets and autoscalers created in the
// Game Server Cluster.
// game server cluster.
repeated DeployedFleetDetails fleet_details = 2;
}
// The state of the Game Server Deployment in each Game Server Cluster.
// The state of the game server deployment in each game server cluster.
repeated DeployedClusterState cluster_state = 1;
// List of Locations that could not be reached.
// List of locations that could not be reached.
repeated string unavailable = 2;
}
// A Game Server Deployment resource.
// A game server deployment resource.
message GameServerDeployment {
option (google.api.resource) = {
type: "gameservices.googleapis.com/GameServerDeployment"
pattern: "projects/{project}/locations/{location}/gameServerDeployments/{deployment}"
};
// The resource name of the Game Server Deployment. Uses the form:
// The resource name of the game server deployment. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment}`.
// For example,
@ -209,33 +209,33 @@ message GameServerDeployment {
// Output only. The last-modified time.
google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
// The labels associated with this Game Server Deployment. Each label is a
// The labels associated with this game server deployment. Each label is a
// key-value pair.
map<string, string> labels = 4;
// ETag of the resource.
string etag = 7;
// Human readable description of the Game Server Deployment.
// Human readable description of the game server delpoyment.
string description = 8;
}
// A Game Server Config override.
// A game server config override.
message GameServerConfigOverride {
// Selector chooses the Game Server Config targets.
// Selector chooses the game server config targets.
oneof selector {
// Selector for choosing applicable realms.
RealmSelector realms_selector = 1;
}
// Selects the Game Server Config and how it should be applied.
// Selects the game server config and how it should be applied.
oneof change {
// The game server config for this override.
string config_version = 100;
}
}
// The Game Server Deployment Rollout which represents the desired rollout
// The game server deployment rollout which represents the desired rollout
// state.
message GameServerDeploymentRollout {
option (google.api.resource) = {
@ -243,7 +243,7 @@ message GameServerDeploymentRollout {
pattern: "projects/{project}/locations/{location}/gameServerDeployments/{deployment}/rollout"
};
// The resource name of the Game Server Deployment Rollout. Uses the form:
// The resource name of the game server deployment rollout. Uses the form:
//
// `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/rollout`.
// For example,
@ -257,14 +257,14 @@ message GameServerDeploymentRollout {
// Output only. The last-modified time.
google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
// The default Game Server Config is applied to all Realms unless overridden
// in the Rollout. For example,
// The default game server config is applied to all realms unless overridden
// in the rollout. For example,
//
// `projects/my-project/locations/global/gameServerDeployments/my-game/configs/my-config`.
string default_game_server_config = 4;
// Contains the Game Server Config Rollout overrides. Overrides are processed
// in the order they are listed. Once a match is found for a Realm, the rest
// Contains the game server config rollout overrides. Overrides are processed
// in the order they are listed. Once a match is found for a realm, the rest
// of the list is not processed.
repeated GameServerConfigOverride game_server_config_overrides = 5;
@ -274,7 +274,7 @@ message GameServerDeploymentRollout {
// Request message for PreviewGameServerDeploymentRollout.
message PreviewGameServerDeploymentRolloutRequest {
// Required. The Game Server Deployment Rollout to be updated.
// Required. The game server deployment rollout to be updated.
// Only fields specified in update_mask are updated.
GameServerDeploymentRollout rollout = 1 [(google.api.field_behavior) = REQUIRED];
@ -287,7 +287,7 @@ message PreviewGameServerDeploymentRolloutRequest {
google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL];
// Optional. The target timestamp to compute the preview. Defaults to the immediately
// after the proposed Rollout completes.
// after the proposed rollout completes.
google.protobuf.Timestamp preview_time = 3 [(google.api.field_behavior) = OPTIONAL];
}
@ -297,7 +297,7 @@ message PreviewGameServerDeploymentRolloutResponse {
// Locations that could not be reached on this request.
repeated string unavailable = 2;
// ETag of the Game Server Deployment.
// ETag of the game server deployment.
string etag = 3;
// The target state.

26
google/cloud/gaming/v1beta/game_server_deployments_service.proto
View File

@ -26,13 +26,13 @@ option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;g
option java_multiple_files = true;
option java_package = "com.google.cloud.gaming.v1beta";
// The Game Server Deployment is used to control the deployment of Agones
// The game server deployment is used to control the deployment of Agones
// fleets.
service GameServerDeploymentsService {
option (google.api.default_host) = "gameservices.googleapis.com";
option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
// Lists Game Server Deployments in a given project and Location.
// Lists game server deployments in a given project and location.
rpc ListGameServerDeployments(ListGameServerDeploymentsRequest) returns (ListGameServerDeploymentsResponse) {
option (google.api.http) = {
get: "/v1beta/{parent=projects/*/locations/*}/gameServerDeployments"
@ -40,7 +40,7 @@ service GameServerDeploymentsService {
option (google.api.method_signature) = "parent";
}
// Gets details of a single Game Server Deployment.
// Gets details of a single game server deployment.
rpc GetGameServerDeployment(GetGameServerDeploymentRequest) returns (GameServerDeployment) {
option (google.api.http) = {
get: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*}"
@ -48,7 +48,7 @@ service GameServerDeploymentsService {
option (google.api.method_signature) = "name";
}
// Creates a new Game Server Deployment in a given project and Location.
// Creates a new game server deployment in a given project and location.
rpc CreateGameServerDeployment(CreateGameServerDeploymentRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
post: "/v1beta/{parent=projects/*/locations/*}/gameServerDeployments"
@ -61,7 +61,7 @@ service GameServerDeploymentsService {
};
}
// Deletes a single Game Server Deployment.
// Deletes a single game server deployment.
rpc DeleteGameServerDeployment(DeleteGameServerDeploymentRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
delete: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*}"
@ -73,7 +73,7 @@ service GameServerDeploymentsService {
};
}
// Patches a Game Server Deployment.
// Patches a game server deployment.
rpc UpdateGameServerDeployment(UpdateGameServerDeploymentRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
patch: "/v1beta/{game_server_deployment.name=projects/*/locations/*/gameServerDeployments/*}"
@ -86,7 +86,7 @@ service GameServerDeploymentsService {
};
}
// Gets details a single Game Server Deployment Rollout.
// Gets details a single game server deployment rollout.
rpc GetGameServerDeploymentRollout(GetGameServerDeploymentRolloutRequest) returns (GameServerDeploymentRollout) {
option (google.api.http) = {
get: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*}/rollout"
@ -94,7 +94,7 @@ service GameServerDeploymentsService {
option (google.api.method_signature) = "name";
}
// Patches a single Game Server Deployment Rollout.
// Patches a single game server deployment rollout.
// The method will not return an error if the update does not affect any
// existing realms. For example - if the default_game_server_config is changed
// but all existing realms use the override, that is valid. Similarly, if a
@ -112,8 +112,8 @@ service GameServerDeploymentsService {
};
}
// Previews the Game Server Deployment Rollout. This API does not mutate the
// Rollout resource.
// Previews the game server deployment rollout. This API does not mutate the
// rollout resource.
rpc PreviewGameServerDeploymentRollout(PreviewGameServerDeploymentRolloutRequest) returns (PreviewGameServerDeploymentRolloutResponse) {
option (google.api.http) = {
patch: "/v1beta/{rollout.name=projects/*/locations/*/gameServerDeployments/*}/rollout:preview"
@ -121,9 +121,9 @@ service GameServerDeploymentsService {
};
}
// Retrieves information about the current state of the Game Server
// Ddeployment. Gathers all the Agones fleets and Agones autoscalers,
// including fleets running an older version of the Game Server Deployment.
// Retrieves information about the current state of the game server
// deployment. Gathers all the Agones fleets and Agones autoscalers,
// including fleets running an older version of the game server deployment.
rpc FetchDeploymentState(FetchDeploymentStateRequest) returns (FetchDeploymentStateResponse) {
option (google.api.http) = {
post: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*}:fetchDeploymentState"

8
google/cloud/gaming/v1beta/gameservices_v1beta.yaml
View File

@ -1,7 +1,7 @@
type: google.api.Service
config_version: 3
name: gameservices.googleapis.com
title: Game Servers API
title: Game Services API
apis:
- name: google.cloud.gaming.v1beta.GameServerClustersService
@ -27,14 +27,14 @@ documentation:
Sets the access control policy on the specified resource. Replaces
any existing policy.
Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
PERMISSION_DENIED
Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`
errors.
- selector: google.iam.v1.IAMPolicy.TestIamPermissions
description: |-
Returns permissions that a caller has on the specified resource. If the
resource does not exist, this will return an empty set of
permissions, not a NOT_FOUND error.
permissions, not a `NOT_FOUND` error.
Note: This operation is designed to be used for building
permission-aware UIs and command-line tools, not for authorization

54
google/cloud/gaming/v1beta/gaming_grpc_service_config.json Normal file
View File

@ -0,0 +1,54 @@
{
"methodConfig": [
{
"name": [
{ "service": "google.cloud.gaming.v1beta.GameServerClustersService", "method": "ListGameServerClusters" },
{ "service": "google.cloud.gaming.v1beta.GameServerClustersService", "method": "GetGameServerCluster" },
{ "service": "google.cloud.gaming.v1beta.GameServerClustersService", "method": "PreviewCreateGameServerCluster" },
{ "service": "google.cloud.gaming.v1beta.GameServerClustersService", "method": "PreviewDeleteGameServerCluster" },
{ "service": "google.cloud.gaming.v1beta.GameServerClustersService", "method": "PreviewUpdateGameServerCluster" },
{ "service": "google.cloud.gaming.v1beta.GameServerConfigsService", "method": "ListGameServerConfigs" },
{ "service": "google.cloud.gaming.v1beta.GameServerConfigsService", "method": "GetGameServerConfig" },
{ "service": "google.cloud.gaming.v1beta.GameServerDeploymentsService", "method": "ListGameServerDeployments" },
{ "service": "google.cloud.gaming.v1beta.GameServerDeploymentsService", "method": "GetGameServerDeployment" },
{ "service": "google.cloud.gaming.v1beta.GameServerDeploymentsService", "method": "GetGameServerDeploymentRollout" },
{ "service": "google.cloud.gaming.v1beta.GameServerDeploymentsService", "method": "PreviewGameServerDeploymentRollout" },
{ "service": "google.cloud.gaming.v1beta.GameServerDeploymentsService", "method": "FetchDeploymentState" },
{ "service": "google.cloud.gaming.v1beta.RealmsService", "method": "ListRealms" },
{ "service": "google.cloud.gaming.v1beta.RealmsService", "method": "GetRealm" },
{ "service": "google.cloud.gaming.v1beta.RealmsService", "method": "PreviewRealmUpdate" }
],
"timeout": "60s",
"retryPolicy": {
"maxAttempts": 5,
"initialBackoff": "1s",
"maxBackoff": "10s",
"backoffMultiplier": 1.3,
"retryableStatusCodes": ["UNAVAILABLE"]
}
},
{
"name": [
{ "service": "google.cloud.gaming.v1beta.GameServerClustersService", "method": "CreateGameServerCluster" },
{ "service": "google.cloud.gaming.v1beta.GameServerClustersService", "method": "DeleteGameServerCluster" },
{ "service": "google.cloud.gaming.v1beta.GameServerClustersService", "method": "UpdateGameServerCluster" },
{ "service": "google.cloud.gaming.v1beta.GameServerConfigsService", "method": "CreateGameServerConfig" },
{ "service": "google.cloud.gaming.v1beta.GameServerConfigsService", "method": "DeleteGameServerConfig" },
{ "service": "google.cloud.gaming.v1beta.GameServerDeploymentsService", "method": "CreateGameServerDeployment" },
{ "service": "google.cloud.gaming.v1beta.GameServerDeploymentsService", "method": "DeleteGameServerDeployment" },
{ "service": "google.cloud.gaming.v1beta.GameServerDeploymentsService", "method": "UpdateGameServerDeployment" },
{ "service": "google.cloud.gaming.v1beta.GameServerDeploymentsService", "method": "UpdateGameServerDeploymentRollout" },
{ "service": "google.cloud.gaming.v1beta.RealmsService", "method": "CreateRealm" },
{ "service": "google.cloud.gaming.v1beta.RealmsService", "method": "DeleteRealm" },
{ "service": "google.cloud.gaming.v1beta.RealmsService", "method": "UpdateRealm" }
],
"timeout": "60s"
}
]
}

28
google/cloud/gaming/v1beta/realms.proto
View File

@ -43,7 +43,7 @@ message ListRealmsRequest {
// will pick an appropriate default. Server may return fewer items than
// requested. A caller should only rely on response's
// [next_page_token][google.cloud.gaming.v1beta.ListRealmsResponse.next_page_token] to
// determine if there are more Realms left to be queried.
// determine if there are more realms left to be queried.
int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
// Optional. The next_page_token value returned from a previous List request,
@ -60,20 +60,20 @@ message ListRealmsRequest {
// Response message for RealmsService.ListRealms.
message ListRealmsResponse {
// The list of Realms.
// The list of realms.
repeated Realm realms = 1;
// Token to retrieve the next page of results, or empty if there are no more
// results in the list.
string next_page_token = 2;
// List of Locations that could not be reached.
// List of locations that could not be reached.
repeated string unreachable = 3;
}
// Request message for RealmsService.GetRealm.
message GetRealmRequest {
// Required. The name of the Realm to retrieve. Uses the form:
// Required. The name of the realm to retrieve. Uses the form:
// `projects/{project}/locations/{location}/realms/{realm}`.
string name = 1 [
(google.api.field_behavior) = REQUIRED,
@ -94,16 +94,16 @@ message CreateRealmRequest {
}
];
// Required. The ID of the Realm resource to be created.
// Required. The ID of the realm resource to be created.
string realm_id = 2 [(google.api.field_behavior) = REQUIRED];
// Required. The Realm resource to be created.
// Required. The realm resource to be created.
Realm realm = 3 [(google.api.field_behavior) = REQUIRED];
}
// Request message for RealmsService.DeleteRealm.
message DeleteRealmRequest {
// Required. The name of the Realm to delete. Uses the form:
// Required. The name of the realm to delete. Uses the form:
// `projects/{project}/locations/{location}/realms/{realm}`.
string name = 1 [
(google.api.field_behavior) = REQUIRED,
@ -115,7 +115,7 @@ message DeleteRealmRequest {
// Request message for RealmsService.UpdateRealm.
message UpdateRealmRequest {
// Required. The Realm to be updated.
// Required. The realm to be updated.
// Only fields specified in update_mask are updated.
Realm realm = 1 [(google.api.field_behavior) = REQUIRED];
@ -130,7 +130,7 @@ message UpdateRealmRequest {
// Request message for RealmsService.PreviewRealmUpdate.
message PreviewRealmUpdateRequest {
// Required. The Realm to be updated.
// Required. The realm to be updated.
// Only fields specified in update_mask are updated.
Realm realm = 1 [(google.api.field_behavior) = REQUIRED];
@ -155,14 +155,14 @@ message PreviewRealmUpdateResponse {
TargetState target_state = 3;
}
// A Realm resource.
// A realm resource.
message Realm {
option (google.api.resource) = {
type: "gameservices.googleapis.com/Realm"
pattern: "projects/{project}/locations/{location}/realms/{realm}"
};
// The resource name of the Realm. Uses the form:
// The resource name of the realm. Uses the form:
// `projects/{project}/locations/{location}/realms/{realm}`. For
// example, `projects/my-project/locations/{location}/realms/my-realm`.
string name = 1;
@ -173,10 +173,10 @@ message Realm {
// Output only. The last-modified time.
google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
// The labels associated with this Realm. Each label is a key-value pair.
// The labels associated with this realm. Each label is a key-value pair.
map<string, string> labels = 4;
// Required. Time zone where all policies targeting this Realm are evaluated. The value
// Required. Time zone where all policies targeting this realm are evaluated. The value
// of this field must be from the IANA time zone database:
// https://www.iana.org/time-zones.
string time_zone = 6 [(google.api.field_behavior) = REQUIRED];
@ -184,6 +184,6 @@ message Realm {
// ETag of the resource.
string etag = 7;
// Human readable description of the Realm.
// Human readable description of the realm.
string description = 8;
}

14
google/cloud/gaming/v1beta/realms_service.proto
View File

@ -26,13 +26,13 @@ option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;g
option java_multiple_files = true;
option java_package = "com.google.cloud.gaming.v1beta";
// A Realm is a grouping of Game Server Clusters that are considered
// A realm is a grouping of game server clusters that are considered
// interchangeable.
service RealmsService {
option (google.api.default_host) = "gameservices.googleapis.com";
option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
// Lists Realms in a given project and Location.
// Lists realms in a given project and location.
rpc ListRealms(ListRealmsRequest) returns (ListRealmsResponse) {
option (google.api.http) = {
get: "/v1beta/{parent=projects/*/locations/*}/realms"
@ -40,7 +40,7 @@ service RealmsService {
option (google.api.method_signature) = "parent";
}
// Gets details of a single Realm.
// Gets details of a single realm.
rpc GetRealm(GetRealmRequest) returns (Realm) {
option (google.api.http) = {
get: "/v1beta/{name=projects/*/locations/*/realms/*}"
@ -48,7 +48,7 @@ service RealmsService {
option (google.api.method_signature) = "name";
}
// Creates a new Realm in a given project and Location.
// Creates a new realm in a given project and location.
rpc CreateRealm(CreateRealmRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
post: "/v1beta/{parent=projects/*/locations/*}/realms"
@ -61,7 +61,7 @@ service RealmsService {
};
}
// Deletes a single Realm.
// Deletes a single realm.
rpc DeleteRealm(DeleteRealmRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
delete: "/v1beta/{name=projects/*/locations/*/realms/*}"
@ -73,7 +73,7 @@ service RealmsService {
};
}
// Patches a single Realm.
// Patches a single realm.
rpc UpdateRealm(UpdateRealmRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
patch: "/v1beta/{realm.name=projects/*/locations/*/realms/*}"
@ -86,7 +86,7 @@ service RealmsService {
};
}
// Previews patches to a single Realm.
// Previews patches to a single realm.
rpc PreviewRealmUpdate(PreviewRealmUpdateRequest) returns (PreviewRealmUpdateResponse) {
option (google.api.http) = {
patch: "/v1beta/{realm.name=projects/*/locations/*/realms/*}:previewUpdate"