diff --git a/google/api/experimental/authorization_config.proto b/google/api/experimental/authorization_config.proto index c4fdca36..4fb24ecd 100644 --- a/google/api/experimental/authorization_config.proto +++ b/google/api/experimental/authorization_config.proto @@ -23,7 +23,6 @@ option java_outer_classname = "AuthorizationConfigProto"; option java_package = "com.google.api"; option objc_class_prefix = "GAPI"; - // Configuration of authorization. // // This section determines the authorization provider, if unspecified, then no diff --git a/google/api/experimental/experimental.proto b/google/api/experimental/experimental.proto index b1a82dc4..6f40d71f 100644 --- a/google/api/experimental/experimental.proto +++ b/google/api/experimental/experimental.proto @@ -26,7 +26,6 @@ option java_outer_classname = "ExperimentalProto"; option java_package = "com.google.api"; option objc_class_prefix = "GAPI"; - // Experimental service configuration. These configuration options can // only be used by whitelisted users. message Experimental { diff --git a/google/api/expr/v1alpha1/cel_service.proto b/google/api/expr/v1alpha1/cel_service.proto index 1a1b7ed7..0bf649ff 100644 --- a/google/api/expr/v1alpha1/cel_service.proto +++ b/google/api/expr/v1alpha1/cel_service.proto @@ -25,7 +25,6 @@ option java_multiple_files = true; option java_outer_classname = "CelServiceProto"; option java_package = "com.google.api.expr.v1alpha1"; - // Access a CEL implementation from another process or machine. // A CEL implementation is decomposed as a parser, a static checker, // and an evaluator. Every CEL implementation is expected to provide @@ -33,16 +32,13 @@ option java_package = "com.google.api.expr.v1alpha1"; // utilities, and execution as a service. service CelService { // Transforms CEL source text into a parsed representation. - rpc Parse(ParseRequest) returns (ParseResponse) { - } + rpc Parse(ParseRequest) returns (ParseResponse) {} // Runs static checks on a parsed CEL representation and return // an annotated representation, or a set of issues. - rpc Check(CheckRequest) returns (CheckResponse) { - } + rpc Check(CheckRequest) returns (CheckResponse) {} // Evaluates a parsed or annotation CEL representation given // values of external bindings. - rpc Eval(EvalRequest) returns (EvalResponse) { - } + rpc Eval(EvalRequest) returns (EvalResponse) {} } diff --git a/google/api/expr/v1alpha1/checked.proto b/google/api/expr/v1alpha1/checked.proto index 1148ef57..60dd09e2 100644 --- a/google/api/expr/v1alpha1/checked.proto +++ b/google/api/expr/v1alpha1/checked.proto @@ -26,6 +26,7 @@ option go_package = "google.golang.org/genproto/googleapis/api/expr/v1alpha1;exp option java_multiple_files = true; option java_outer_classname = "DeclProto"; option java_package = "com.google.api.expr.v1alpha1"; + // Protos for representing CEL declarations and typed checked expressions. // A CEL expression which has been successfully type checked. diff --git a/google/api/expr/v1alpha1/syntax.proto b/google/api/expr/v1alpha1/syntax.proto index af18c53b..4a3cb907 100644 --- a/google/api/expr/v1alpha1/syntax.proto +++ b/google/api/expr/v1alpha1/syntax.proto @@ -26,6 +26,7 @@ option go_package = "google.golang.org/genproto/googleapis/api/expr/v1alpha1;exp option java_multiple_files = true; option java_outer_classname = "SyntaxProto"; option java_package = "com.google.api.expr.v1alpha1"; + // A representation of the abstract syntax of the Common Expression Language. // An expression together with source information as returned by the parser. diff --git a/google/api/expr/v1alpha1/value.proto b/google/api/expr/v1alpha1/value.proto index d732bc67..a0508ed9 100644 --- a/google/api/expr/v1alpha1/value.proto +++ b/google/api/expr/v1alpha1/value.proto @@ -25,6 +25,7 @@ option go_package = "google.golang.org/genproto/googleapis/api/expr/v1alpha1;exp option java_multiple_files = true; option java_outer_classname = "ValueProto"; option java_package = "com.google.api.expr.v1alpha1"; + // Contains representations for CEL runtime values. // Represents a CEL value. diff --git a/google/api/expr/v1beta1/expr.proto b/google/api/expr/v1beta1/expr.proto index 7187fa9e..93b917f1 100644 --- a/google/api/expr/v1beta1/expr.proto +++ b/google/api/expr/v1beta1/expr.proto @@ -26,7 +26,6 @@ option java_multiple_files = true; option java_outer_classname = "ExprProto"; option java_package = "com.google.api.expr.v1beta1"; - // An expression together with source information as returned by the parser. message ParsedExpr { // The parsed expression. diff --git a/google/api/servicecontrol/v1/check_error.proto b/google/api/servicecontrol/v1/check_error.proto index 5666d556..3395839d 100644 --- a/google/api/servicecontrol/v1/check_error.proto +++ b/google/api/servicecontrol/v1/check_error.proto @@ -24,7 +24,6 @@ option java_multiple_files = true; option java_outer_classname = "CheckErrorProto"; option java_package = "com.google.api.servicecontrol.v1"; - // Defines the errors to be returned in // [google.api.servicecontrol.v1.CheckResponse.check_errors][google.api.servicecontrol.v1.CheckResponse.check_errors]. message CheckError { diff --git a/google/api/servicecontrol/v1/distribution.proto b/google/api/servicecontrol/v1/distribution.proto index 757bbfc0..40b89f5b 100644 --- a/google/api/servicecontrol/v1/distribution.proto +++ b/google/api/servicecontrol/v1/distribution.proto @@ -22,7 +22,6 @@ option java_multiple_files = true; option java_outer_classname = "DistributionProto"; option java_package = "com.google.api.servicecontrol.v1"; - // Distribution represents a frequency distribution of double-valued sample // points. It contains the size of the population of sample points plus // additional optional information: diff --git a/google/api/servicecontrol/v1/log_entry.proto b/google/api/servicecontrol/v1/log_entry.proto index c06232f3..50b0fc46 100644 --- a/google/api/servicecontrol/v1/log_entry.proto +++ b/google/api/servicecontrol/v1/log_entry.proto @@ -27,7 +27,6 @@ option java_multiple_files = true; option java_outer_classname = "LogEntryProto"; option java_package = "com.google.api.servicecontrol.v1"; - // An individual log entry. message LogEntry { // Required. The log to which this log entry belongs. Examples: `"syslog"`, diff --git a/google/api/servicecontrol/v1/metric_value.proto b/google/api/servicecontrol/v1/metric_value.proto index bfc40a8f..9a62ff69 100644 --- a/google/api/servicecontrol/v1/metric_value.proto +++ b/google/api/servicecontrol/v1/metric_value.proto @@ -27,12 +27,12 @@ option java_multiple_files = true; option java_outer_classname = "MetricValueSetProto"; option java_package = "com.google.api.servicecontrol.v1"; - // Represents a single metric value. message MetricValue { // The labels describing the metric value. - // See comments on [google.api.servicecontrol.v1.Operation.labels][google.api.servicecontrol.v1.Operation.labels] for - // the overriding relationship. + // See comments on + // [google.api.servicecontrol.v1.Operation.labels][google.api.servicecontrol.v1.Operation.labels] + // for the overriding relationship. map labels = 1; // The start of the time period over which this metric value's measurement diff --git a/google/api/servicecontrol/v1/operation.proto b/google/api/servicecontrol/v1/operation.proto index 37aa81fb..301f3575 100644 --- a/google/api/servicecontrol/v1/operation.proto +++ b/google/api/servicecontrol/v1/operation.proto @@ -27,7 +27,6 @@ option java_multiple_files = true; option java_outer_classname = "OperationProto"; option java_package = "com.google.api.servicecontrol.v1"; - // Represents information regarding an operation. message Operation { // Defines the importance of the data contained in the operation. @@ -71,8 +70,10 @@ message Operation { google.protobuf.Timestamp start_time = 4; // End time of the operation. - // Required when the operation is used in [ServiceController.Report][google.api.servicecontrol.v1.ServiceController.Report], - // but optional when the operation is used in [ServiceController.Check][google.api.servicecontrol.v1.ServiceController.Check]. + // Required when the operation is used in + // [ServiceController.Report][google.api.servicecontrol.v1.ServiceController.Report], + // but optional when the operation is used in + // [ServiceController.Check][google.api.servicecontrol.v1.ServiceController.Check]. google.protobuf.Timestamp end_time = 5; // Labels describing the operation. Only the following labels are allowed: diff --git a/google/api/servicecontrol/v1/quota_controller.proto b/google/api/servicecontrol/v1/quota_controller.proto index 3d48620d..808a7354 100644 --- a/google/api/servicecontrol/v1/quota_controller.proto +++ b/google/api/servicecontrol/v1/quota_controller.proto @@ -25,7 +25,6 @@ option java_multiple_files = true; option java_outer_classname = "QuotaControllerProto"; option java_package = "com.google.api.servicecontrol.v1"; - // [Google Quota Control API](/service-control/overview) // // Allows clients to allocate and release quota against a [managed @@ -43,7 +42,10 @@ service QuotaController { // reliability, the server may inject these errors to prohibit any hard // dependency on the quota functionality. rpc AllocateQuota(AllocateQuotaRequest) returns (AllocateQuotaResponse) { - option (google.api.http) = { post: "/v1/services/{service_name}:allocateQuota" body: "*" }; + option (google.api.http) = { + post: "/v1/services/{service_name}:allocateQuota" + body: "*" + }; } } @@ -52,7 +54,8 @@ message AllocateQuotaRequest { // Name of the service as specified in the service configuration. For example, // `"pubsub.googleapis.com"`. // - // See [google.api.Service][google.api.Service] for the definition of a service name. + // See [google.api.Service][google.api.Service] for the definition of a + // service name. string service_name = 1; // Operation that describes the quota allocation. @@ -160,7 +163,8 @@ message AllocateQuotaResponse { string service_config_id = 4; } -// Represents error information for [QuotaOperation][google.api.servicecontrol.v1.QuotaOperation]. +// Represents error information for +// [QuotaOperation][google.api.servicecontrol.v1.QuotaOperation]. message QuotaError { // Error codes related to project config validations are deprecated since the // quota controller methods do not perform these validations. Instead services diff --git a/google/api/servicecontrol/v1/service_controller.proto b/google/api/servicecontrol/v1/service_controller.proto index 38171ba5..6e11bcf0 100644 --- a/google/api/servicecontrol/v1/service_controller.proto +++ b/google/api/servicecontrol/v1/service_controller.proto @@ -28,7 +28,6 @@ option java_outer_classname = "ServiceControllerProto"; option java_package = "com.google.api.servicecontrol.v1"; option objc_class_prefix = "GASC"; - // [Google Service Control API](/service-control/overview) // // Lets clients check and report operations against a [managed @@ -42,13 +41,17 @@ service ServiceController { // 60 seconds. In case of server errors, the client can rely on the cached // results for longer time. // - // NOTE: the [CheckRequest][google.api.servicecontrol.v1.CheckRequest] has the size limit of 64KB. + // NOTE: the [CheckRequest][google.api.servicecontrol.v1.CheckRequest] has the + // size limit of 64KB. // // This method requires the `servicemanagement.services.check` permission // on the specified service. For more information, see // [Google Cloud IAM](https://cloud.google.com/iam). rpc Check(CheckRequest) returns (CheckResponse) { - option (google.api.http) = { post: "/v1/services/{service_name}:check" body: "*" }; + option (google.api.http) = { + post: "/v1/services/{service_name}:check" + body: "*" + }; } // Reports operation results to Google Service Control, such as logs and @@ -60,13 +63,17 @@ service ServiceController { // the aggregation time window to avoid data loss risk more than 0.01% // for business and compliance reasons. // - // NOTE: the [ReportRequest][google.api.servicecontrol.v1.ReportRequest] has the size limit of 1MB. + // NOTE: the [ReportRequest][google.api.servicecontrol.v1.ReportRequest] has + // the size limit of 1MB. // // This method requires the `servicemanagement.services.report` permission // on the specified service. For more information, see // [Google Cloud IAM](https://cloud.google.com/iam). rpc Report(ReportRequest) returns (ReportResponse) { - option (google.api.http) = { post: "/v1/services/{service_name}:report" body: "*" }; + option (google.api.http) = { + post: "/v1/services/{service_name}:report" + body: "*" + }; } } @@ -105,8 +112,9 @@ message CheckResponse { int64 project_number = 1; } - // The same operation_id value used in the [CheckRequest][google.api.servicecontrol.v1.CheckRequest]. - // Used for logging and diagnostics purposes. + // The same operation_id value used in the + // [CheckRequest][google.api.servicecontrol.v1.CheckRequest]. Used for logging + // and diagnostics purposes. string operation_id = 1; // Indicate the decision of the check. @@ -141,8 +149,9 @@ message ReportRequest { // of the report. // // If multiple operations are in a single request, the total request size - // should be no larger than 1MB. See [ReportResponse.report_errors][google.api.servicecontrol.v1.ReportResponse.report_errors] for - // partial failure behavior. + // should be no larger than 1MB. See + // [ReportResponse.report_errors][google.api.servicecontrol.v1.ReportResponse.report_errors] + // for partial failure behavior. repeated Operation operations = 2; // Specifies which version of service config should be used to process the @@ -155,12 +164,16 @@ message ReportRequest { // Response message for the Report method. message ReportResponse { - // Represents the processing error of one [Operation][google.api.servicecontrol.v1.Operation] in the request. + // Represents the processing error of one + // [Operation][google.api.servicecontrol.v1.Operation] in the request. message ReportError { - // The [Operation.operation_id][google.api.servicecontrol.v1.Operation.operation_id] value from the request. + // The + // [Operation.operation_id][google.api.servicecontrol.v1.Operation.operation_id] + // value from the request. string operation_id = 1; - // Details of the error when processing the [Operation][google.api.servicecontrol.v1.Operation]. + // Details of the error when processing the + // [Operation][google.api.servicecontrol.v1.Operation]. google.rpc.Status status = 2; } diff --git a/google/api/servicemanagement/v1/resources.proto b/google/api/servicemanagement/v1/resources.proto index 08f334f4..1c924849 100644 --- a/google/api/servicemanagement/v1/resources.proto +++ b/google/api/servicemanagement/v1/resources.proto @@ -35,7 +35,6 @@ option java_package = "com.google.api.servicemanagement.v1"; option objc_class_prefix = "GASM"; option php_namespace = "Google\\Cloud\\ServiceManagement\\V1"; - // The full representation of a Service that is managed by // Google Service Management. message ManagedService { @@ -233,9 +232,7 @@ message Rollout { // Strategy used to delete a service. This strategy is a placeholder only // used by the system generated rollout to delete a service. - message DeleteServiceStrategy { - - } + message DeleteServiceStrategy {} // Status of a Rollout. enum RolloutStatus { diff --git a/google/api/servicemanagement/v1/servicemanager.proto b/google/api/servicemanagement/v1/servicemanager.proto index cde85eb5..02d50666 100644 --- a/google/api/servicemanagement/v1/servicemanager.proto +++ b/google/api/servicemanagement/v1/servicemanager.proto @@ -33,7 +33,6 @@ option java_package = "com.google.api.servicemanagement.v1"; option objc_class_prefix = "GASM"; option php_namespace = "Google\\Cloud\\ServiceManagement\\V1"; - // [Google Service Management API](/service-management/overview) service ServiceManager { // Lists managed services. @@ -63,7 +62,8 @@ service ServiceManager { // Please note one producer project can own no more than 20 services. // // Operation - rpc CreateService(CreateServiceRequest) returns (google.longrunning.Operation) { + rpc CreateService(CreateServiceRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services" body: "service" @@ -72,11 +72,14 @@ service ServiceManager { // Deletes a managed service. This method will change the service to the // `Soft-Delete` state for 30 days. Within this period, service producers may - // call [UndeleteService][google.api.servicemanagement.v1.ServiceManager.UndeleteService] to restore the service. - // After 30 days, the service will be permanently deleted. + // call + // [UndeleteService][google.api.servicemanagement.v1.ServiceManager.UndeleteService] + // to restore the service. After 30 days, the service will be permanently + // deleted. // // Operation - rpc DeleteService(DeleteServiceRequest) returns (google.longrunning.Operation) { + rpc DeleteService(DeleteServiceRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { delete: "/v1/services/{service_name}" }; @@ -88,7 +91,8 @@ service ServiceManager { // last 30 days. // // Operation - rpc UndeleteService(UndeleteServiceRequest) returns (google.longrunning.Operation) { + rpc UndeleteService(UndeleteServiceRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services/{service_name}:undelete" }; @@ -96,7 +100,8 @@ service ServiceManager { // Lists the history of the service configuration for a managed service, // from the newest to the oldest. - rpc ListServiceConfigs(ListServiceConfigsRequest) returns (ListServiceConfigsResponse) { + rpc ListServiceConfigs(ListServiceConfigsRequest) + returns (ListServiceConfigsResponse) { option (google.api.http) = { get: "/v1/services/{service_name}/configs" }; @@ -106,9 +111,7 @@ service ServiceManager { rpc GetServiceConfig(GetServiceConfigRequest) returns (google.api.Service) { option (google.api.http) = { get: "/v1/services/{service_name}/configs/{config_id}" - additional_bindings { - get: "/v1/services/{service_name}/config" - } + additional_bindings { get: "/v1/services/{service_name}/config" } }; } @@ -120,7 +123,8 @@ service ServiceManager { // Only the 100 most recent service configurations and ones referenced by // existing rollouts are kept for each service. The rest will be deleted // eventually. - rpc CreateServiceConfig(CreateServiceConfigRequest) returns (google.api.Service) { + rpc CreateServiceConfig(CreateServiceConfigRequest) + returns (google.api.Service) { option (google.api.http) = { post: "/v1/services/{service_name}/configs" body: "service_config" @@ -133,14 +137,16 @@ service ServiceManager { // Specification). This method stores the source configurations as well as the // generated service configuration. To rollout the service configuration to // other services, - // please call [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout]. + // please call + // [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout]. // // Only the 100 most recent configuration sources and ones referenced by // existing service configurtions are kept for each service. The rest will be // deleted eventually. // // Operation - rpc SubmitConfigSource(SubmitConfigSourceRequest) returns (google.longrunning.Operation) { + rpc SubmitConfigSource(SubmitConfigSourceRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services/{service_name}/configs:submit" body: "*" @@ -149,13 +155,15 @@ service ServiceManager { // Lists the history of the service configuration rollouts for a managed // service, from the newest to the oldest. - rpc ListServiceRollouts(ListServiceRolloutsRequest) returns (ListServiceRolloutsResponse) { + rpc ListServiceRollouts(ListServiceRolloutsRequest) + returns (ListServiceRolloutsResponse) { option (google.api.http) = { get: "/v1/services/{service_name}/rollouts" }; } - // Gets a service configuration [rollout][google.api.servicemanagement.v1.Rollout]. + // Gets a service configuration + // [rollout][google.api.servicemanagement.v1.Rollout]. rpc GetServiceRollout(GetServiceRolloutRequest) returns (Rollout) { option (google.api.http) = { get: "/v1/services/{service_name}/rollouts/{rollout_id}" @@ -176,7 +184,8 @@ service ServiceManager { // service. The rest will be deleted eventually. // // Operation - rpc CreateServiceRollout(CreateServiceRolloutRequest) returns (google.longrunning.Operation) { + rpc CreateServiceRollout(CreateServiceRolloutRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services/{service_name}/rollouts" body: "rollout" @@ -194,32 +203,35 @@ service ServiceManager { // If GenerateConfigReportRequest.old_value is not specified, this method // will compare GenerateConfigReportRequest.new_value with the last pushed // service configuration. - rpc GenerateConfigReport(GenerateConfigReportRequest) returns (GenerateConfigReportResponse) { + rpc GenerateConfigReport(GenerateConfigReportRequest) + returns (GenerateConfigReportResponse) { option (google.api.http) = { post: "/v1/services:generateConfigReport" body: "*" }; } - // Enables a [service][google.api.servicemanagement.v1.ManagedService] for a project, so it can be used - // for the project. See - // [Cloud Auth Guide](https://cloud.google.com/docs/authentication) for - // more information. + // Enables a [service][google.api.servicemanagement.v1.ManagedService] for a + // project, so it can be used for the project. See [Cloud Auth + // Guide](https://cloud.google.com/docs/authentication) for more information. // // Operation - rpc EnableService(EnableServiceRequest) returns (google.longrunning.Operation) { + rpc EnableService(EnableServiceRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services/{service_name}:enable" body: "*" }; } - // Disables a [service][google.api.servicemanagement.v1.ManagedService] for a project, so it can no longer be - // be used for the project. It prevents accidental usage that may cause - // unexpected billing charges or security leaks. + // Disables a [service][google.api.servicemanagement.v1.ManagedService] for a + // project, so it can no longer be be used for the project. It prevents + // accidental usage that may cause unexpected billing charges or security + // leaks. // // Operation - rpc DisableService(DisableServiceRequest) returns (google.longrunning.Operation) { + rpc DisableService(DisableServiceRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services/{service_name}:disable" body: "*"