v1.10: Bump tonic, tonic-build, prost, and etcd-client (#24157)
* Bump tonic, prost, and etcd-client * Restore doc ignores
This commit is contained in:
@ -1,12 +1,12 @@
|
||||
/// Defines the HTTP configuration for an API service. It contains a list of
|
||||
/// [HttpRule][google.api.HttpRule], each specifying the mapping of an RPC method
|
||||
/// \[HttpRule][google.api.HttpRule\], each specifying the mapping of an RPC method
|
||||
/// to one or more HTTP REST API methods.
|
||||
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||
pub struct Http {
|
||||
/// A list of HTTP configuration rules that apply to individual API methods.
|
||||
///
|
||||
/// **NOTE:** All service configuration rules follow "last one wins" order.
|
||||
#[prost(message, repeated, tag = "1")]
|
||||
#[prost(message, repeated, tag="1")]
|
||||
pub rules: ::prost::alloc::vec::Vec<HttpRule>,
|
||||
/// When set to true, URL path parameters will be fully URI-decoded except in
|
||||
/// cases of single segment matches in reserved expansion, where "%2F" will be
|
||||
@ -14,7 +14,7 @@ pub struct Http {
|
||||
///
|
||||
/// The default behavior is to not decode RFC 6570 reserved characters in multi
|
||||
/// segment matches.
|
||||
#[prost(bool, tag = "2")]
|
||||
#[prost(bool, tag="2")]
|
||||
pub fully_decode_reserved_expansion: bool,
|
||||
}
|
||||
/// # gRPC Transcoding
|
||||
@ -22,10 +22,10 @@ pub struct Http {
|
||||
/// gRPC Transcoding is a feature for mapping between a gRPC method and one or
|
||||
/// more HTTP REST endpoints. It allows developers to build a single API service
|
||||
/// that supports both gRPC APIs and REST APIs. Many systems, including [Google
|
||||
/// APIs](https://github.com/googleapis/googleapis),
|
||||
/// [Cloud Endpoints](https://cloud.google.com/endpoints), [gRPC
|
||||
/// Gateway](https://github.com/grpc-ecosystem/grpc-gateway),
|
||||
/// and [Envoy](https://github.com/envoyproxy/envoy) proxy support this feature
|
||||
/// APIs](<https://github.com/googleapis/googleapis>),
|
||||
/// [Cloud Endpoints](<https://cloud.google.com/endpoints>), [gRPC
|
||||
/// Gateway](<https://github.com/grpc-ecosystem/grpc-gateway>),
|
||||
/// and \[Envoy\](<https://github.com/envoyproxy/envoy>) proxy support this feature
|
||||
/// and use it for large scale production services.
|
||||
///
|
||||
/// `HttpRule` defines the schema of the gRPC/REST mapping. The mapping specifies
|
||||
@ -186,15 +186,15 @@ pub struct Http {
|
||||
/// 1. Leaf request fields (recursive expansion nested messages in the request
|
||||
/// message) are classified into three categories:
|
||||
/// - Fields referred by the path template. They are passed via the URL path.
|
||||
/// - Fields referred by the [HttpRule.body][google.api.HttpRule.body]. They are passed via the HTTP
|
||||
/// - Fields referred by the \[HttpRule.body][google.api.HttpRule.body\]. They are passed via the HTTP
|
||||
/// request body.
|
||||
/// - All other fields are passed via the URL query parameters, and the
|
||||
/// parameter name is the field path in the request message. A repeated
|
||||
/// field can be represented as multiple query parameters under the same
|
||||
/// name.
|
||||
/// 2. If [HttpRule.body][google.api.HttpRule.body] is "*", there is no URL query parameter, all fields
|
||||
/// 2. If \[HttpRule.body][google.api.HttpRule.body\] is "*", there is no URL query parameter, all fields
|
||||
/// are passed via URL path and HTTP request body.
|
||||
/// 3. If [HttpRule.body][google.api.HttpRule.body] is omitted, there is no HTTP request body, all
|
||||
/// 3. If \[HttpRule.body][google.api.HttpRule.body\] is omitted, there is no HTTP request body, all
|
||||
/// fields are passed via URL path and URL query parameters.
|
||||
///
|
||||
/// ### Path template syntax
|
||||
@ -221,19 +221,19 @@ pub struct Http {
|
||||
///
|
||||
/// If a variable contains exactly one path segment, such as `"{var}"` or
|
||||
/// `"{var=*}"`, when such a variable is expanded into a URL path on the client
|
||||
/// side, all characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The
|
||||
/// side, all characters except `\[-_.~0-9a-zA-Z\]` are percent-encoded. The
|
||||
/// server side does the reverse decoding. Such variables show up in the
|
||||
/// [Discovery
|
||||
/// Document](https://developers.google.com/discovery/v1/reference/apis) as
|
||||
/// Document](<https://developers.google.com/discovery/v1/reference/apis>) as
|
||||
/// `{var}`.
|
||||
///
|
||||
/// If a variable contains multiple path segments, such as `"{var=foo/*}"`
|
||||
/// or `"{var=**}"`, when such a variable is expanded into a URL path on the
|
||||
/// client side, all characters except `[-_.~/0-9a-zA-Z]` are percent-encoded.
|
||||
/// client side, all characters except `\[-_.~/0-9a-zA-Z\]` are percent-encoded.
|
||||
/// The server side does the reverse decoding, except "%2F" and "%2f" are left
|
||||
/// unchanged. Such variables show up in the
|
||||
/// [Discovery
|
||||
/// Document](https://developers.google.com/discovery/v1/reference/apis) as
|
||||
/// Document](<https://developers.google.com/discovery/v1/reference/apis>) as
|
||||
/// `{+var}`.
|
||||
///
|
||||
/// ## Using gRPC API Service Configuration
|
||||
@ -263,10 +263,10 @@ pub struct Http {
|
||||
///
|
||||
/// When gRPC Transcoding is used to map a gRPC to JSON REST endpoints, the
|
||||
/// proto to JSON conversion must follow the [proto3
|
||||
/// specification](https://developers.google.com/protocol-buffers/docs/proto3#json).
|
||||
/// specification](<https://developers.google.com/protocol-buffers/docs/proto3#json>).
|
||||
///
|
||||
/// While the single segment variable follows the semantics of
|
||||
/// [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String
|
||||
/// [RFC 6570](<https://tools.ietf.org/html/rfc6570>) Section 3.2.2 Simple String
|
||||
/// Expansion, the multi segment variable **does not** follow RFC 6570 Section
|
||||
/// 3.2.3 Reserved Expansion. The reason is that the Reserved Expansion
|
||||
/// does not expand special characters like `?` and `#`, which would lead
|
||||
@ -290,8 +290,8 @@ pub struct Http {
|
||||
pub struct HttpRule {
|
||||
/// Selects a method to which this rule applies.
|
||||
///
|
||||
/// Refer to [selector][google.api.DocumentationRule.selector] for syntax details.
|
||||
#[prost(string, tag = "1")]
|
||||
/// Refer to \[selector][google.api.DocumentationRule.selector\] for syntax details.
|
||||
#[prost(string, tag="1")]
|
||||
pub selector: ::prost::alloc::string::String,
|
||||
/// The name of the request field whose value is mapped to the HTTP request
|
||||
/// body, or `*` for mapping all request fields not captured by the path
|
||||
@ -299,7 +299,7 @@ pub struct HttpRule {
|
||||
///
|
||||
/// NOTE: the referred field must be present at the top-level of the request
|
||||
/// message type.
|
||||
#[prost(string, tag = "7")]
|
||||
#[prost(string, tag="7")]
|
||||
pub body: ::prost::alloc::string::String,
|
||||
/// Optional. The name of the response field whose value is mapped to the HTTP
|
||||
/// response body. When omitted, the entire response message will be used
|
||||
@ -307,17 +307,17 @@ pub struct HttpRule {
|
||||
///
|
||||
/// NOTE: The referred field must be present at the top-level of the response
|
||||
/// message type.
|
||||
#[prost(string, tag = "12")]
|
||||
#[prost(string, tag="12")]
|
||||
pub response_body: ::prost::alloc::string::String,
|
||||
/// Additional HTTP bindings for the selector. Nested bindings must
|
||||
/// not contain an `additional_bindings` field themselves (that is,
|
||||
/// the nesting may only be one level deep).
|
||||
#[prost(message, repeated, tag = "11")]
|
||||
#[prost(message, repeated, tag="11")]
|
||||
pub additional_bindings: ::prost::alloc::vec::Vec<HttpRule>,
|
||||
/// Determines the URL pattern is matched by this rules. This pattern can be
|
||||
/// used with any of the {get|put|post|delete|patch} methods. A custom method
|
||||
/// can be defined using the 'custom' field.
|
||||
#[prost(oneof = "http_rule::Pattern", tags = "2, 3, 4, 5, 6, 8")]
|
||||
#[prost(oneof="http_rule::Pattern", tags="2, 3, 4, 5, 6, 8")]
|
||||
pub pattern: ::core::option::Option<http_rule::Pattern>,
|
||||
}
|
||||
/// Nested message and enum types in `HttpRule`.
|
||||
@ -329,25 +329,25 @@ pub mod http_rule {
|
||||
pub enum Pattern {
|
||||
/// Maps to HTTP GET. Used for listing and getting information about
|
||||
/// resources.
|
||||
#[prost(string, tag = "2")]
|
||||
#[prost(string, tag="2")]
|
||||
Get(::prost::alloc::string::String),
|
||||
/// Maps to HTTP PUT. Used for replacing a resource.
|
||||
#[prost(string, tag = "3")]
|
||||
#[prost(string, tag="3")]
|
||||
Put(::prost::alloc::string::String),
|
||||
/// Maps to HTTP POST. Used for creating a resource or performing an action.
|
||||
#[prost(string, tag = "4")]
|
||||
#[prost(string, tag="4")]
|
||||
Post(::prost::alloc::string::String),
|
||||
/// Maps to HTTP DELETE. Used for deleting a resource.
|
||||
#[prost(string, tag = "5")]
|
||||
#[prost(string, tag="5")]
|
||||
Delete(::prost::alloc::string::String),
|
||||
/// Maps to HTTP PATCH. Used for updating a resource.
|
||||
#[prost(string, tag = "6")]
|
||||
#[prost(string, tag="6")]
|
||||
Patch(::prost::alloc::string::String),
|
||||
/// The custom pattern is used for specifying an HTTP method that is not
|
||||
/// included in the `pattern` field, such as HEAD, or "*" to leave the
|
||||
/// HTTP method unspecified for this rule. The wild-card rule is useful
|
||||
/// for services that provide content to Web (HTML) clients.
|
||||
#[prost(message, tag = "8")]
|
||||
#[prost(message, tag="8")]
|
||||
Custom(super::CustomHttpPattern),
|
||||
}
|
||||
}
|
||||
@ -355,10 +355,10 @@ pub mod http_rule {
|
||||
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||
pub struct CustomHttpPattern {
|
||||
/// The name of this custom HTTP verb.
|
||||
#[prost(string, tag = "1")]
|
||||
#[prost(string, tag="1")]
|
||||
pub kind: ::prost::alloc::string::String,
|
||||
/// The path matched by this custom verb.
|
||||
#[prost(string, tag = "2")]
|
||||
#[prost(string, tag="2")]
|
||||
pub path: ::prost::alloc::string::String,
|
||||
}
|
||||
/// An indicator of the behavior of a given field (for example, that a field
|
||||
@ -393,6 +393,16 @@ pub enum FieldBehavior {
|
||||
/// This indicates that the field may be set once in a request to create a
|
||||
/// resource, but may not be changed thereafter.
|
||||
Immutable = 5,
|
||||
/// Denotes that a (repeated) field is an unordered list.
|
||||
/// This indicates that the service may provide the elements of the list
|
||||
/// in any arbitrary order, rather than the order the user originally
|
||||
/// provided. Additionally, the list's order may or may not be stable.
|
||||
UnorderedList = 6,
|
||||
/// Denotes that this field returns a non-empty default value if not set.
|
||||
/// This indicates that if the user provides the empty value in a request,
|
||||
/// a non-empty value will be returned. The user will not be aware of what
|
||||
/// non-empty value to expect.
|
||||
NonEmptyDefault = 7,
|
||||
}
|
||||
/// A simple descriptor of a resource type.
|
||||
///
|
||||
@ -511,10 +521,10 @@ pub struct ResourceDescriptor {
|
||||
/// Example: `storage.googleapis.com/Bucket`
|
||||
///
|
||||
/// The value of the resource_type_kind must follow the regular expression
|
||||
/// /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and
|
||||
/// /\[A-Za-z][a-zA-Z0-9\]+/. It should start with an upper case character and
|
||||
/// should use PascalCase (UpperCamelCase). The maximum number of
|
||||
/// characters allowed for the `resource_type_kind` is 100.
|
||||
#[prost(string, tag = "1")]
|
||||
#[prost(string, tag="1")]
|
||||
pub r#type: ::prost::alloc::string::String,
|
||||
/// Optional. The relative resource name pattern associated with this resource
|
||||
/// type. The DNS prefix of the full resource name shouldn't be specified here.
|
||||
@ -535,11 +545,11 @@ pub struct ResourceDescriptor {
|
||||
/// hierarchy. It is expected that, if multiple patterns are provided,
|
||||
/// the same component name (e.g. "project") refers to IDs of the same
|
||||
/// type of resource.
|
||||
#[prost(string, repeated, tag = "2")]
|
||||
#[prost(string, repeated, tag="2")]
|
||||
pub pattern: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
|
||||
/// Optional. The field on the resource that designates the resource name
|
||||
/// field. If omitted, this is assumed to be "name".
|
||||
#[prost(string, tag = "3")]
|
||||
#[prost(string, tag="3")]
|
||||
pub name_field: ::prost::alloc::string::String,
|
||||
/// Optional. The historical or future-looking state of the resource pattern.
|
||||
///
|
||||
@ -556,27 +566,27 @@ pub struct ResourceDescriptor {
|
||||
/// history: ORIGINALLY_SINGLE_PATTERN
|
||||
/// };
|
||||
/// }
|
||||
#[prost(enumeration = "resource_descriptor::History", tag = "4")]
|
||||
#[prost(enumeration="resource_descriptor::History", tag="4")]
|
||||
pub history: i32,
|
||||
/// The plural name used in the resource name and permission names, such as
|
||||
/// 'projects' for the resource name of 'projects/{project}' and the permission
|
||||
/// name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
|
||||
/// concept of the `plural` field in k8s CRD spec
|
||||
/// https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
||||
/// <https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/>
|
||||
///
|
||||
/// Note: The plural form is required even for singleton resources. See
|
||||
/// https://aip.dev/156
|
||||
#[prost(string, tag = "5")]
|
||||
/// <https://aip.dev/156>
|
||||
#[prost(string, tag="5")]
|
||||
pub plural: ::prost::alloc::string::String,
|
||||
/// The same concept of the `singular` field in k8s CRD spec
|
||||
/// https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
||||
/// <https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/>
|
||||
/// Such as "project" for the `resourcemanager.googleapis.com/Project` type.
|
||||
#[prost(string, tag = "6")]
|
||||
#[prost(string, tag="6")]
|
||||
pub singular: ::prost::alloc::string::String,
|
||||
/// Style flag(s) for this resource.
|
||||
/// These indicate that a resource is expected to conform to a given
|
||||
/// style. See the specific style flags for additional information.
|
||||
#[prost(enumeration = "resource_descriptor::Style", repeated, tag = "10")]
|
||||
#[prost(enumeration="resource_descriptor::Style", repeated, tag="10")]
|
||||
pub style: ::prost::alloc::vec::Vec<i32>,
|
||||
}
|
||||
/// Nested message and enum types in `ResourceDescriptor`.
|
||||
@ -637,7 +647,7 @@ pub struct ResourceReference {
|
||||
/// type: "*"
|
||||
/// }];
|
||||
/// }
|
||||
#[prost(string, tag = "1")]
|
||||
#[prost(string, tag="1")]
|
||||
pub r#type: ::prost::alloc::string::String,
|
||||
/// The resource type of a child collection that the annotated field
|
||||
/// references. This is useful for annotating the `parent` field that
|
||||
@ -650,6 +660,6 @@ pub struct ResourceReference {
|
||||
/// child_type: "logging.googleapis.com/LogEntry"
|
||||
/// };
|
||||
/// }
|
||||
#[prost(string, tag = "2")]
|
||||
#[prost(string, tag="2")]
|
||||
pub child_type: ::prost::alloc::string::String,
|
||||
}
|
||||
|
Reference in New Issue
Block a user