diff --git a/google/cloud/gaming/v1beta/BUILD.bazel b/google/cloud/gaming/v1beta/BUILD.bazel index 0538623624..b305a86b8b 100644 --- a/google/cloud/gaming/v1beta/BUILD.bazel +++ b/google/cloud/gaming/v1beta/BUILD.bazel @@ -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 = [], diff --git a/google/cloud/gaming/v1beta/common.proto b/google/cloud/gaming/v1beta/common.proto index 027272cf30..159167a469 100644 --- a/google/cloud/gaming/v1beta/common.proto +++ b/google/cloud/gaming/v1beta/common.proto @@ -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 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; } diff --git a/google/cloud/gaming/v1beta/game_server_clusters.proto b/google/cloud/gaming/v1beta/game_server_clusters.proto index fd67a112b2..357ef36eba 100644 --- a/google/cloud/gaming/v1beta/game_server_clusters.proto +++ b/google/cloud/gaming/v1beta/game_server_clusters.proto @@ -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 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. diff --git a/google/cloud/gaming/v1beta/game_server_clusters_service.proto b/google/cloud/gaming/v1beta/game_server_clusters_service.proto index 2d81c43827..74128bc3aa 100644 --- a/google/cloud/gaming/v1beta/game_server_clusters_service.proto +++ b/google/cloud/gaming/v1beta/game_server_clusters_service.proto @@ -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" diff --git a/google/cloud/gaming/v1beta/game_server_configs.proto b/google/cloud/gaming/v1beta/game_server_configs.proto index ea0820bd79..86c6ed293f 100644 --- a/google/cloud/gaming/v1beta/game_server_configs.proto +++ b/google/cloud/gaming/v1beta/game_server_configs.proto @@ -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 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; } diff --git a/google/cloud/gaming/v1beta/game_server_configs_service.proto b/google/cloud/gaming/v1beta/game_server_configs_service.proto index 29e886c50d..3c4d45f1b2 100644 --- a/google/cloud/gaming/v1beta/game_server_configs_service.proto +++ b/google/cloud/gaming/v1beta/game_server_configs_service.proto @@ -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/*}" diff --git a/google/cloud/gaming/v1beta/game_server_deployments.proto b/google/cloud/gaming/v1beta/game_server_deployments.proto index 2e87e386c8..a9a31e3ad4 100644 --- a/google/cloud/gaming/v1beta/game_server_deployments.proto +++ b/google/cloud/gaming/v1beta/game_server_deployments.proto @@ -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 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. diff --git a/google/cloud/gaming/v1beta/game_server_deployments_service.proto b/google/cloud/gaming/v1beta/game_server_deployments_service.proto index ccacfbacd5..0ecd160c69 100644 --- a/google/cloud/gaming/v1beta/game_server_deployments_service.proto +++ b/google/cloud/gaming/v1beta/game_server_deployments_service.proto @@ -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" diff --git a/google/cloud/gaming/v1beta/gameservices_v1beta.yaml b/google/cloud/gaming/v1beta/gameservices_v1beta.yaml index dd33603965..aa501c32dd 100644 --- a/google/cloud/gaming/v1beta/gameservices_v1beta.yaml +++ b/google/cloud/gaming/v1beta/gameservices_v1beta.yaml @@ -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 diff --git a/google/cloud/gaming/v1beta/gaming_grpc_service_config.json b/google/cloud/gaming/v1beta/gaming_grpc_service_config.json new file mode 100644 index 0000000000..92733c4cd8 --- /dev/null +++ b/google/cloud/gaming/v1beta/gaming_grpc_service_config.json @@ -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" + } + ] +} diff --git a/google/cloud/gaming/v1beta/realms.proto b/google/cloud/gaming/v1beta/realms.proto index c1fa9982f2..f07013fb37 100644 --- a/google/cloud/gaming/v1beta/realms.proto +++ b/google/cloud/gaming/v1beta/realms.proto @@ -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 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; } diff --git a/google/cloud/gaming/v1beta/realms_service.proto b/google/cloud/gaming/v1beta/realms_service.proto index 4c87cac3d3..7806ccd737 100644 --- a/google/cloud/gaming/v1beta/realms_service.proto +++ b/google/cloud/gaming/v1beta/realms_service.proto @@ -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"