async-grpc-xds 0.0.1

data/proto/envoy/type/matcher/v3/value.proto

@@ -0,0 +1,80 @@
+syntax = "proto3";
+
+package envoy.type.matcher.v3;
+
+import "envoy/type/matcher/v3/number.proto";
+import "envoy/type/matcher/v3/string.proto";
+
+import "udpa/annotations/status.proto";
+import "udpa/annotations/versioning.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.type.matcher.v3";
+option java_outer_classname = "ValueProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type/matcher/v3;matcherv3";
+option (udpa.annotations.file_status).package_version_status = ACTIVE;
+
+// [#protodoc-title: Value matcher]
+
+// Specifies the way to match a Protobuf::Value. Primitive values and ListValue are supported.
+// StructValue is not supported and is always not matched.
+// [#next-free-field: 8]
+message ValueMatcher {
+  option (udpa.annotations.versioning).previous_message_type = "envoy.type.matcher.ValueMatcher";
+
+  // NullMatch is an empty message to specify a null value.
+  message NullMatch {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.matcher.ValueMatcher.NullMatch";
+  }
+
+  // Specifies how to match a value.
+  oneof match_pattern {
+    option (validate.required) = true;
+
+    // If specified, a match occurs if and only if the target value is a NullValue.
+    NullMatch null_match = 1;
+
+    // If specified, a match occurs if and only if the target value is a double value and is
+    // matched to this field.
+    DoubleMatcher double_match = 2;
+
+    // If specified, a match occurs if and only if the target value is a string value and is
+    // matched to this field.
+    StringMatcher string_match = 3;
+
+    // If specified, a match occurs if and only if the target value is a bool value and is equal
+    // to this field.
+    bool bool_match = 4;
+
+    // If specified, value match will be performed based on whether the path is referring to a
+    // valid primitive value in the metadata. If the path is referring to a non-primitive value,
+    // the result is always not matched.
+    bool present_match = 5;
+
+    // If specified, a match occurs if and only if the target value is a list value and
+    // is matched to this field.
+    ListMatcher list_match = 6;
+
+    // If specified, a match occurs if and only if any of the alternatives in the match accept the value.
+    OrMatcher or_match = 7;
+  }
+}
+
+// Specifies the way to match a list value.
+message ListMatcher {
+  option (udpa.annotations.versioning).previous_message_type = "envoy.type.matcher.ListMatcher";
+
+  oneof match_pattern {
+    option (validate.required) = true;
+
+    // If specified, at least one of the values in the list must match the value specified.
+    ValueMatcher one_of = 1;
+  }
+}
+
+// Specifies a list of alternatives for the match.
+message OrMatcher {
+  repeated ValueMatcher value_matchers = 1 [(validate.rules).repeated = {min_items: 2}];
+}

data/proto/envoy/type/metadata/v3/metadata.proto

@@ -0,0 +1,117 @@
+syntax = "proto3";
+
+package envoy.type.metadata.v3;
+
+import "udpa/annotations/status.proto";
+import "udpa/annotations/versioning.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.type.metadata.v3";
+option java_outer_classname = "MetadataProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type/metadata/v3;metadatav3";
+option (udpa.annotations.file_status).package_version_status = ACTIVE;
+
+// [#protodoc-title: Metadata]
+
+// MetadataKey provides a way to retrieve values from
+// :ref:`Metadata <envoy_v3_api_msg_config.core.v3.Metadata>` using a ``key`` and a ``path``.
+//
+// For example, consider the following Metadata:
+//
+// .. code-block:: yaml
+//
+//    filter_metadata:
+//      envoy.xxx:
+//        prop:
+//          foo: bar
+//          xyz:
+//            hello: envoy
+//
+// The following MetadataKey would retrieve the string value "bar" from the Metadata:
+//
+// .. code-block:: yaml
+//
+//    key: envoy.xxx
+//    path:
+//    - key: prop
+//    - key: foo
+//
+message MetadataKey {
+  option (udpa.annotations.versioning).previous_message_type = "envoy.type.metadata.v2.MetadataKey";
+
+  // Specifies a segment in a path for retrieving values from Metadata.
+  // Currently, only key-based segments (field names) are supported.
+  message PathSegment {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.metadata.v2.MetadataKey.PathSegment";
+
+    oneof segment {
+      option (validate.required) = true;
+
+      // If specified, use this key to retrieve the value in a Struct.
+      string key = 1 [(validate.rules).string = {min_len: 1}];
+    }
+  }
+
+  // The key name of the Metadata from which to retrieve the Struct.
+  // This typically represents a builtin subsystem or custom extension.
+  string key = 1 [(validate.rules).string = {min_len: 1}];
+
+  // The path used to retrieve a specific Value from the Struct.
+  // This can be either a prefix or a full path, depending on the use case.
+  // For example, ``[prop, xyz]`` would retrieve a struct or ``[prop, foo]`` would retrieve a string
+  // in the example above.
+  //
+  // .. note::
+  //   Since only key-type segments are supported, a path cannot specify a list
+  //   unless the list is the last segment.
+  repeated PathSegment path = 2 [(validate.rules).repeated = {min_items: 1}];
+}
+
+// Describes different types of metadata sources.
+message MetadataKind {
+  option (udpa.annotations.versioning).previous_message_type =
+      "envoy.type.metadata.v2.MetadataKind";
+
+  // Represents dynamic metadata associated with the request.
+  message Request {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.metadata.v2.MetadataKind.Request";
+  }
+
+  // Represents metadata from :ref:`the route<envoy_v3_api_field_config.route.v3.Route.metadata>`.
+  message Route {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.metadata.v2.MetadataKind.Route";
+  }
+
+  // Represents metadata from :ref:`the upstream cluster<envoy_v3_api_field_config.cluster.v3.Cluster.metadata>`.
+  message Cluster {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.metadata.v2.MetadataKind.Cluster";
+  }
+
+  // Represents metadata from :ref:`the upstream
+  // host<envoy_v3_api_field_config.endpoint.v3.LbEndpoint.metadata>`.
+  message Host {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.metadata.v2.MetadataKind.Host";
+  }
+
+  oneof kind {
+    option (validate.required) = true;
+
+    // Request kind of metadata.
+    Request request = 1;
+
+    // Route kind of metadata.
+    Route route = 2;
+
+    // Cluster kind of metadata.
+    Cluster cluster = 3;
+
+    // Host kind of metadata.
+    Host host = 4;
+  }
+}

data/proto/envoy/type/percent.proto

@@ -0,0 +1,52 @@
+syntax = "proto3";
+
+package envoy.type;
+
+import "udpa/annotations/status.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.type";
+option java_outer_classname = "PercentProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type";
+option (udpa.annotations.file_status).package_version_status = FROZEN;
+
+// [#protodoc-title: Percent]
+
+// Identifies a percentage, in the range [0.0, 100.0].
+message Percent {
+  double value = 1 [(validate.rules).double = {lte: 100.0 gte: 0.0}];
+}
+
+// A fractional percentage is used in cases in which for performance reasons performing floating
+// point to integer conversions during randomness calculations is undesirable. The message includes
+// both a numerator and denominator that together determine the final fractional value.
+//
+// * **Example**: 1/100 = 1%.
+// * **Example**: 3/10000 = 0.03%.
+message FractionalPercent {
+  // Fraction percentages support several fixed denominator values.
+  enum DenominatorType {
+    // 100.
+    //
+    // **Example**: 1/100 = 1%.
+    HUNDRED = 0;
+
+    // 10,000.
+    //
+    // **Example**: 1/10000 = 0.01%.
+    TEN_THOUSAND = 1;
+
+    // 1,000,000.
+    //
+    // **Example**: 1/1000000 = 0.0001%.
+    MILLION = 2;
+  }
+
+  // Specifies the numerator. Defaults to 0.
+  uint32 numerator = 1;
+
+  // Specifies the denominator. If the denominator specified is less than the numerator, the final
+  // fractional percentage is capped at 1 (100%).
+  DenominatorType denominator = 2 [(validate.rules).enum = {defined_only: true}];
+}

data/proto/envoy/type/range.proto

@@ -0,0 +1,43 @@
+syntax = "proto3";
+
+package envoy.type;
+
+import "udpa/annotations/status.proto";
+
+option java_package = "io.envoyproxy.envoy.type";
+option java_outer_classname = "RangeProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type";
+option (udpa.annotations.file_status).package_version_status = FROZEN;
+
+// [#protodoc-title: Range]
+
+// Specifies the int64 start and end of the range using half-open interval semantics [start,
+// end).
+message Int64Range {
+  // start of the range (inclusive)
+  int64 start = 1;
+
+  // end of the range (exclusive)
+  int64 end = 2;
+}
+
+// Specifies the int32 start and end of the range using half-open interval semantics [start,
+// end).
+message Int32Range {
+  // start of the range (inclusive)
+  int32 start = 1;
+
+  // end of the range (exclusive)
+  int32 end = 2;
+}
+
+// Specifies the double start and end of the range using half-open interval semantics [start,
+// end).
+message DoubleRange {
+  // start of the range (inclusive)
+  double start = 1;
+
+  // end of the range (exclusive)
+  double end = 2;
+}

data/proto/envoy/type/semantic_version.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+
+package envoy.type;
+
+import "udpa/annotations/status.proto";
+
+option java_package = "io.envoyproxy.envoy.type";
+option java_outer_classname = "SemanticVersionProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type";
+option (udpa.annotations.file_status).package_version_status = FROZEN;
+
+// [#protodoc-title: Semantic Version]
+
+// Envoy uses SemVer (https://semver.org/). Major/minor versions indicate
+// expected behaviors and APIs, the patch version field is used only
+// for security fixes and can be generally ignored.
+message SemanticVersion {
+  uint32 major_number = 1;
+
+  uint32 minor_number = 2;
+
+  uint32 patch = 3;
+}

data/proto/envoy/type/token_bucket.proto

@@ -0,0 +1,36 @@
+syntax = "proto3";
+
+package envoy.type;
+
+import "google/protobuf/duration.proto";
+import "google/protobuf/wrappers.proto";
+
+import "udpa/annotations/status.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.type";
+option java_outer_classname = "TokenBucketProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type";
+option (udpa.annotations.file_status).package_version_status = FROZEN;
+
+// [#protodoc-title: Token bucket]
+
+// Configures a token bucket, typically used for rate limiting.
+message TokenBucket {
+  // The maximum tokens that the bucket can hold. This is also the number of tokens that the bucket
+  // initially contains.
+  uint32 max_tokens = 1 [(validate.rules).uint32 = {gt: 0}];
+
+  // The number of tokens added to the bucket during each fill interval. If not specified, defaults
+  // to a single token.
+  google.protobuf.UInt32Value tokens_per_fill = 2 [(validate.rules).uint32 = {gt: 0}];
+
+  // The fill interval that tokens are added to the bucket. During each fill interval
+  // `tokens_per_fill` are added to the bucket. The bucket will never contain more than
+  // `max_tokens` tokens.
+  google.protobuf.Duration fill_interval = 3 [(validate.rules).duration = {
+    required: true
+    gt {}
+  }];
+}

data/proto/envoy/type/v3/BUILD

@@ -0,0 +1,12 @@
+# DO NOT EDIT. This file is generated by tools/proto_format/proto_sync.py.
+
+load("@envoy_api//bazel:api_build_system.bzl", "api_proto_package")
+
+licenses(["notice"])  # Apache 2
+
+api_proto_package(
+    deps = [
+        "@com_github_cncf_xds//udpa/annotations:pkg",
+        "@com_github_cncf_xds//xds/annotations/v3:pkg",
+    ],
+)

data/proto/envoy/type/v3/hash_policy.proto

@@ -0,0 +1,43 @@
+syntax = "proto3";
+
+package envoy.type.v3;
+
+import "udpa/annotations/status.proto";
+import "udpa/annotations/versioning.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.type.v3";
+option java_outer_classname = "HashPolicyProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type/v3;typev3";
+option (udpa.annotations.file_status).package_version_status = ACTIVE;
+
+// [#protodoc-title: Hash Policy]
+
+// Specifies the hash policy
+message HashPolicy {
+  option (udpa.annotations.versioning).previous_message_type = "envoy.type.HashPolicy";
+
+  // The source IP will be used to compute the hash used by hash-based load balancing
+  // algorithms.
+  message SourceIp {
+    option (udpa.annotations.versioning).previous_message_type = "envoy.type.HashPolicy.SourceIp";
+  }
+
+  // An Object in the :ref:`filterState <arch_overview_data_sharing_between_filters>` will be used
+  // to compute the hash used by hash-based load balancing algorithms.
+  message FilterState {
+    // The name of the Object in the filterState, which is an Envoy::Hashable object. If there is no
+    // data associated with the key, or the stored object is not Envoy::Hashable, no hash will be
+    // produced.
+    string key = 1 [(validate.rules).string = {min_len: 1}];
+  }
+
+  oneof policy_specifier {
+    option (validate.required) = true;
+
+    SourceIp source_ip = 1;
+
+    FilterState filter_state = 2;
+  }
+}

data/proto/envoy/type/v3/http.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+
+package envoy.type.v3;
+
+import "udpa/annotations/status.proto";
+
+option java_package = "io.envoyproxy.envoy.type.v3";
+option java_outer_classname = "HttpProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type/v3;typev3";
+option (udpa.annotations.file_status).package_version_status = ACTIVE;
+
+// [#protodoc-title: HTTP]
+
+enum CodecClientType {
+  HTTP1 = 0;
+
+  HTTP2 = 1;
+
+  // [#not-implemented-hide:] QUIC implementation is not production ready yet. Use this enum with
+  // caution to prevent accidental execution of QUIC code. I.e. `!= HTTP2` is no longer sufficient
+  // to distinguish HTTP1 and HTTP2 traffic.
+  HTTP3 = 2;
+}

data/proto/envoy/type/v3/http_status.proto

@@ -0,0 +1,199 @@
+syntax = "proto3";
+
+package envoy.type.v3;
+
+import "udpa/annotations/status.proto";
+import "udpa/annotations/versioning.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.type.v3";
+option java_outer_classname = "HttpStatusProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type/v3;typev3";
+option (udpa.annotations.file_status).package_version_status = ACTIVE;
+
+// [#protodoc-title: HTTP status codes]
+
+// HTTP response codes supported in Envoy.
+// For more details: https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
+enum StatusCode {
+  // Empty - This code not part of the HTTP status code specification, but it is needed for proto
+  // `enum` type.
+  Empty = 0;
+
+  // Continue - ``100`` status code.
+  Continue = 100;
+
+  // OK - ``200`` status code.
+  OK = 200;
+
+  // Created - ``201`` status code.
+  Created = 201;
+
+  // Accepted - ``202`` status code.
+  Accepted = 202;
+
+  // NonAuthoritativeInformation - ``203`` status code.
+  NonAuthoritativeInformation = 203;
+
+  // NoContent - ``204`` status code.
+  NoContent = 204;
+
+  // ResetContent - ``205`` status code.
+  ResetContent = 205;
+
+  // PartialContent - ``206`` status code.
+  PartialContent = 206;
+
+  // MultiStatus - ``207`` status code.
+  MultiStatus = 207;
+
+  // AlreadyReported - ``208`` status code.
+  AlreadyReported = 208;
+
+  // IMUsed - ``226`` status code.
+  IMUsed = 226;
+
+  // MultipleChoices - ``300`` status code.
+  MultipleChoices = 300;
+
+  // MovedPermanently - ``301`` status code.
+  MovedPermanently = 301;
+
+  // Found - ``302`` status code.
+  Found = 302;
+
+  // SeeOther - ``303`` status code.
+  SeeOther = 303;
+
+  // NotModified - ``304`` status code.
+  NotModified = 304;
+
+  // UseProxy - ``305`` status code.
+  UseProxy = 305;
+
+  // TemporaryRedirect - ``307`` status code.
+  TemporaryRedirect = 307;
+
+  // PermanentRedirect - ``308`` status code.
+  PermanentRedirect = 308;
+
+  // BadRequest - ``400`` status code.
+  BadRequest = 400;
+
+  // Unauthorized - ``401`` status code.
+  Unauthorized = 401;
+
+  // PaymentRequired - ``402`` status code.
+  PaymentRequired = 402;
+
+  // Forbidden - ``403`` status code.
+  Forbidden = 403;
+
+  // NotFound - ``404`` status code.
+  NotFound = 404;
+
+  // MethodNotAllowed - ``405`` status code.
+  MethodNotAllowed = 405;
+
+  // NotAcceptable - ``406`` status code.
+  NotAcceptable = 406;
+
+  // ProxyAuthenticationRequired - ``407`` status code.
+  ProxyAuthenticationRequired = 407;
+
+  // RequestTimeout - ``408`` status code.
+  RequestTimeout = 408;
+
+  // Conflict - ``409`` status code.
+  Conflict = 409;
+
+  // Gone - ``410`` status code.
+  Gone = 410;
+
+  // LengthRequired - ``411`` status code.
+  LengthRequired = 411;
+
+  // PreconditionFailed - ``412`` status code.
+  PreconditionFailed = 412;
+
+  // PayloadTooLarge - ``413`` status code.
+  PayloadTooLarge = 413;
+
+  // URITooLong - ``414`` status code.
+  URITooLong = 414;
+
+  // UnsupportedMediaType - ``415`` status code.
+  UnsupportedMediaType = 415;
+
+  // RangeNotSatisfiable - ``416`` status code.
+  RangeNotSatisfiable = 416;
+
+  // ExpectationFailed - ``417`` status code.
+  ExpectationFailed = 417;
+
+  // MisdirectedRequest - ``421`` status code.
+  MisdirectedRequest = 421;
+
+  // UnprocessableEntity - ``422`` status code.
+  UnprocessableEntity = 422;
+
+  // Locked - ``423`` status code.
+  Locked = 423;
+
+  // FailedDependency - ``424`` status code.
+  FailedDependency = 424;
+
+  // UpgradeRequired - ``426`` status code.
+  UpgradeRequired = 426;
+
+  // PreconditionRequired - ``428`` status code.
+  PreconditionRequired = 428;
+
+  // TooManyRequests - ``429`` status code.
+  TooManyRequests = 429;
+
+  // RequestHeaderFieldsTooLarge - ``431`` status code.
+  RequestHeaderFieldsTooLarge = 431;
+
+  // InternalServerError - ``500`` status code.
+  InternalServerError = 500;
+
+  // NotImplemented - ``501`` status code.
+  NotImplemented = 501;
+
+  // BadGateway - ``502`` status code.
+  BadGateway = 502;
+
+  // ServiceUnavailable - ``503`` status code.
+  ServiceUnavailable = 503;
+
+  // GatewayTimeout - ``504`` status code.
+  GatewayTimeout = 504;
+
+  // HTTPVersionNotSupported - ``505`` status code.
+  HTTPVersionNotSupported = 505;
+
+  // VariantAlsoNegotiates - ``506`` status code.
+  VariantAlsoNegotiates = 506;
+
+  // InsufficientStorage - ``507`` status code.
+  InsufficientStorage = 507;
+
+  // LoopDetected - ``508`` status code.
+  LoopDetected = 508;
+
+  // NotExtended - ``510`` status code.
+  NotExtended = 510;
+
+  // NetworkAuthenticationRequired - ``511`` status code.
+  NetworkAuthenticationRequired = 511;
+}
+
+// HTTP status.
+message HttpStatus {
+  option (udpa.annotations.versioning).previous_message_type = "envoy.type.HttpStatus";
+
+  // Supplies HTTP response code.
+  StatusCode code = 1 [(validate.rules).enum = {defined_only: true not_in: 0}];
+}

data/proto/envoy/type/v3/percent.proto

@@ -0,0 +1,57 @@
+syntax = "proto3";
+
+package envoy.type.v3;
+
+import "udpa/annotations/status.proto";
+import "udpa/annotations/versioning.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.type.v3";
+option java_outer_classname = "PercentProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type/v3;typev3";
+option (udpa.annotations.file_status).package_version_status = ACTIVE;
+
+// [#protodoc-title: Percent]
+
+// Identifies a percentage, in the range [0.0, 100.0].
+message Percent {
+  option (udpa.annotations.versioning).previous_message_type = "envoy.type.Percent";
+
+  double value = 1 [(validate.rules).double = {lte: 100.0 gte: 0.0}];
+}
+
+// A fractional percentage is used in cases in which for performance reasons performing floating
+// point to integer conversions during randomness calculations is undesirable. The message includes
+// both a numerator and denominator that together determine the final fractional value.
+//
+// * **Example**: 1/100 = 1%.
+// * **Example**: 3/10000 = 0.03%.
+message FractionalPercent {
+  option (udpa.annotations.versioning).previous_message_type = "envoy.type.FractionalPercent";
+
+  // Fraction percentages support several fixed denominator values.
+  enum DenominatorType {
+    // 100.
+    //
+    // **Example**: 1/100 = 1%.
+    HUNDRED = 0;
+
+    // 10,000.
+    //
+    // **Example**: 1/10000 = 0.01%.
+    TEN_THOUSAND = 1;
+
+    // 1,000,000.
+    //
+    // **Example**: 1/1000000 = 0.0001%.
+    MILLION = 2;
+  }
+
+  // Specifies the numerator. Defaults to 0.
+  uint32 numerator = 1;
+
+  // Specifies the denominator. If the denominator specified is less than the numerator, the final
+  // fractional percentage is capped at 1 (100%).
+  DenominatorType denominator = 2 [(validate.rules).enum = {defined_only: true}];
+}