You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@apisix.apache.org by GitBox <gi...@apache.org> on 2022/11/01 08:07:09 UTC

[GitHub] [apisix-ingress-controller] navendu-pottekkat opened a new pull request, #1423: docs: update ApisixRoute/v2 reference

navendu-pottekkat opened a new pull request, #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423

   Signed-off-by: Navendu Pottekkat <na...@apache.org>
   
   Updates the documentation of ApisixRoute/v2 reference page.
   
   Similar changes would be made across the reference section after approving this PR.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] navendu-pottekkat commented on a diff in pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
navendu-pottekkat commented on code in PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#discussion_r1012588068


##########
docs/en/latest/references/apisix_route_v2.md:
##########
@@ -77,11 +77,11 @@ The table below describes each of the attributes in the spec. The fields `apiVer
 | stream[].name                        | string (required)  | Name of the rule.                                                                                                                                                                         |
 | stream[].match                       | object (required)  | Conditions to match the request with the Route.                                                                                                                                           |
 | stream[].match.ingressPort           | integer (required) | Listening port in the Ingress proxy server. This port should be defined in the [APISIX configuration](https://github.com/apache/apisix/blob/master/conf/config-default.yaml#L101).        |
-| stream[].backend                     | object             | Backend service (deprecated). Use `http[].backends` instead.                                                                                                                              |
-| stream[].backend.serviceName         | string             | Name of the backend service (depricated). The service and the `ApisixRoute` resource should be created in the same namespace.                                                             |
-| stream[].backend.servicePort         | integer or string  | Port number or the name defined in the service object of the backend (depricated).                                                                                                        |
-| stream[].backend.resolveGranularity  | string             | See [Service resolution granularity](#service-resolution-granularity) for details (depricated).                                                                                           |
-| stream[].backend.subset              | string             | Subset for the target service (depricated). Should be pre-defined in the `ApisixUpstream` resource.                                                                                       |
+| stream[].backend                     | object             | Backend service (depreciated). Use `http[].backends` instead.                                                                                                                              |

Review Comment:
   Yes. I thought I was wrong and changed it... Deprecated is the correct one. I have checked.
   
   I have reverted the commit



##########
docs/en/latest/references/apisix_route_v2.md:
##########
@@ -77,11 +77,11 @@ The table below describes each of the attributes in the spec. The fields `apiVer
 | stream[].name                        | string (required)  | Name of the rule.                                                                                                                                                                         |
 | stream[].match                       | object (required)  | Conditions to match the request with the Route.                                                                                                                                           |
 | stream[].match.ingressPort           | integer (required) | Listening port in the Ingress proxy server. This port should be defined in the [APISIX configuration](https://github.com/apache/apisix/blob/master/conf/config-default.yaml#L101).        |
-| stream[].backend                     | object             | Backend service (deprecated). Use `http[].backends` instead.                                                                                                                              |
-| stream[].backend.serviceName         | string             | Name of the backend service (depricated). The service and the `ApisixRoute` resource should be created in the same namespace.                                                             |
-| stream[].backend.servicePort         | integer or string  | Port number or the name defined in the service object of the backend (depricated).                                                                                                        |
-| stream[].backend.resolveGranularity  | string             | See [Service resolution granularity](#service-resolution-granularity) for details (depricated).                                                                                           |
-| stream[].backend.subset              | string             | Subset for the target service (depricated). Should be pre-defined in the `ApisixUpstream` resource.                                                                                       |
+| stream[].backend                     | object             | Backend service (depreciated). Use `http[].backends` instead.                                                                                                                              |

Review Comment:
   Yes. I thought I was wrong and changed it... Deprecated is the correct one. I have checked.
   
   I have reverted the commit.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] juzhiyuan commented on a diff in pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
juzhiyuan commented on code in PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#discussion_r1011125343


##########
docs/en/latest/references/apisix_route_v2.md:
##########
@@ -21,83 +26,85 @@ title: ApisixRoute/v2 Reference
 #
 -->
 
+See [concepts](https://apisix.apache.org/docs/ingress-controller/concepts/apisix_route) to learn more about how to use the ApisixRoute resource.
+
 ## Spec
 
-Meaning of each field in the spec of ApisixRoute are followed, the top level fields (`apiVersion`, `kind` and `metadata`) are same as other Kubernetes Resources.
+See the [definition](https://github.com/apache/apisix-ingress-controller/blob/master/samples/deploy/crd/v1/ApisixRoute.yaml) on GitHub.
+
+The table below describes each of the attributes in the spec. The fields `apiVersion`, `kind`, and `metadata` are similar to other Kubernetes resources and are excluded below.
+
+| Attribute                            | Type               | Description                                                                                                                                                                               |
+| ------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| http                                 | array              | HTTP Route rules.                                                                                                                                                                         |
+| http[].name                          | string (required)  | Route rule name.                                                                                                                                                                          |
+| http[].priority                      | integer            | Route priority. Used to determined which Route to use when multiple routes contain the same URI. Large number means higher priority.                                                      |
+| http[].timeout                       | object             | Timeouts for connecting, sending, and receiving messages between Ingress and the service. This will overwrite the value configured in `ApisixUpstream` resource.                          |
+| http[].timeout.connect               | string             | Connect timeout in the form "72h3m0.5s".                                                                                                                                                  |

Review Comment:
   Hi @navendu-pottekkat, is this expected?
   
   <img width="499" alt="image" src="https://user-images.githubusercontent.com/2106987/199390099-3c0c7919-6a28-480c-a30e-f7763c04b3ae.png">
   



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] navendu-pottekkat commented on pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
navendu-pottekkat commented on PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#issuecomment-1298218704

   Any idea why there is this lint error? https://github.com/apache/apisix-ingress-controller/actions/runs/3367934841/jobs/5585981373#step:5:6
   
   It is not obvious what the issue is to me.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] navendu-pottekkat commented on pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
navendu-pottekkat commented on PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#issuecomment-1311321700

   I have fixed the link check error in a different PR. All checks will pass here.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] tao12345666333 merged pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
tao12345666333 merged PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] navendu-pottekkat commented on a diff in pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
navendu-pottekkat commented on code in PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#discussion_r1011218179


##########
docs/en/latest/references/apisix_route_v2.md:
##########
@@ -21,83 +26,85 @@ title: ApisixRoute/v2 Reference
 #
 -->
 
+See [concepts](https://apisix.apache.org/docs/ingress-controller/concepts/apisix_route) to learn more about how to use the ApisixRoute resource.
+
 ## Spec
 
-Meaning of each field in the spec of ApisixRoute are followed, the top level fields (`apiVersion`, `kind` and `metadata`) are same as other Kubernetes Resources.
+See the [definition](https://github.com/apache/apisix-ingress-controller/blob/master/samples/deploy/crd/v1/ApisixRoute.yaml) on GitHub.
+
+The table below describes each of the attributes in the spec. The fields `apiVersion`, `kind`, and `metadata` are similar to other Kubernetes resources and are excluded below.
+
+| Attribute                            | Type               | Description                                                                                                                                                                               |
+| ------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| http                                 | array              | HTTP Route rules.                                                                                                                                                                         |
+| http[].name                          | string (required)  | Route rule name.                                                                                                                                                                          |
+| http[].priority                      | integer            | Route priority. Used to determined which Route to use when multiple routes contain the same URI. Large number means higher priority.                                                      |
+| http[].timeout                       | object             | Timeouts for connecting, sending, and receiving messages between Ingress and the service. This will overwrite the value configured in `ApisixUpstream` resource.                          |
+| http[].timeout.connect               | string             | Connect timeout in the form "72h3m0.5s".                                                                                                                                                  |

Review Comment:
   I don't know. I did not change it. @tao12345666333 could you confirm?



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] juzhiyuan commented on a diff in pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
juzhiyuan commented on code in PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#discussion_r1011217130


##########
docs/en/latest/references/apisix_route_v2.md:
##########
@@ -21,83 +26,85 @@ title: ApisixRoute/v2 Reference
 #
 -->
 
+See [concepts](https://apisix.apache.org/docs/ingress-controller/concepts/apisix_route) to learn more about how to use the ApisixRoute resource.
+
 ## Spec
 
-Meaning of each field in the spec of ApisixRoute are followed, the top level fields (`apiVersion`, `kind` and `metadata`) are same as other Kubernetes Resources.
+See the [definition](https://github.com/apache/apisix-ingress-controller/blob/master/samples/deploy/crd/v1/ApisixRoute.yaml) on GitHub.
+
+The table below describes each of the attributes in the spec. The fields `apiVersion`, `kind`, and `metadata` are similar to other Kubernetes resources and are excluded below.
+
+| Attribute                            | Type               | Description                                                                                                                                                                               |
+| ------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| http                                 | array              | HTTP Route rules.                                                                                                                                                                         |
+| http[].name                          | string (required)  | Route rule name.                                                                                                                                                                          |
+| http[].priority                      | integer            | Route priority. Used to determined which Route to use when multiple routes contain the same URI. Large number means higher priority.                                                      |
+| http[].timeout                       | object             | Timeouts for connecting, sending, and receiving messages between Ingress and the service. This will overwrite the value configured in `ApisixUpstream` resource.                          |
+| http[].timeout.connect               | string             | Connect timeout in the form "72h3m0.5s".                                                                                                                                                  |

Review Comment:
   <img width="335" alt="image" src="https://user-images.githubusercontent.com/2106987/199407627-c1137ba5-0e66-4354-af74-26d84581be9b.png">
   
   This form is valid?



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] tao12345666333 commented on a diff in pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
tao12345666333 commented on code in PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#discussion_r1013373345


##########
docs/en/latest/references/apisix_route_v2.md:
##########
@@ -21,83 +26,85 @@ title: ApisixRoute/v2 Reference
 #
 -->
 
+See [concepts](https://apisix.apache.org/docs/ingress-controller/concepts/apisix_route) to learn more about how to use the ApisixRoute resource.
+
 ## Spec
 
-Meaning of each field in the spec of ApisixRoute are followed, the top level fields (`apiVersion`, `kind` and `metadata`) are same as other Kubernetes Resources.
+See the [definition](https://github.com/apache/apisix-ingress-controller/blob/master/samples/deploy/crd/v1/ApisixRoute.yaml) on GitHub.
+
+The table below describes each of the attributes in the spec. The fields `apiVersion`, `kind`, and `metadata` are similar to other Kubernetes resources and are excluded below.
+
+| Attribute                            | Type               | Description                                                                                                                                                                               |
+| ------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| http                                 | array              | HTTP Route rules.                                                                                                                                                                         |
+| http[].name                          | string (required)  | Route rule name.                                                                                                                                                                          |
+| http[].priority                      | integer            | Route priority. Used to determined which Route to use when multiple routes contain the same URI. Large number means higher priority.                                                      |
+| http[].timeout                       | object             | Timeouts for connecting, sending, and receiving messages between Ingress and the service. This will overwrite the value configured in `ApisixUpstream` resource.                          |
+| http[].timeout.connect               | string             | Connect timeout in the form "72h3m0.5s".                                                                                                                                                  |

Review Comment:
   let me check it.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] juzhiyuan commented on a diff in pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
juzhiyuan commented on code in PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#discussion_r1012535355


##########
docs/en/latest/references/apisix_route_v2.md:
##########
@@ -77,11 +77,11 @@ The table below describes each of the attributes in the spec. The fields `apiVer
 | stream[].name                        | string (required)  | Name of the rule.                                                                                                                                                                         |
 | stream[].match                       | object (required)  | Conditions to match the request with the Route.                                                                                                                                           |
 | stream[].match.ingressPort           | integer (required) | Listening port in the Ingress proxy server. This port should be defined in the [APISIX configuration](https://github.com/apache/apisix/blob/master/conf/config-default.yaml#L101).        |
-| stream[].backend                     | object             | Backend service (deprecated). Use `http[].backends` instead.                                                                                                                              |
-| stream[].backend.serviceName         | string             | Name of the backend service (depricated). The service and the `ApisixRoute` resource should be created in the same namespace.                                                             |
-| stream[].backend.servicePort         | integer or string  | Port number or the name defined in the service object of the backend (depricated).                                                                                                        |
-| stream[].backend.resolveGranularity  | string             | See [Service resolution granularity](#service-resolution-granularity) for details (depricated).                                                                                           |
-| stream[].backend.subset              | string             | Subset for the target service (depricated). Should be pre-defined in the `ApisixUpstream` resource.                                                                                       |
+| stream[].backend                     | object             | Backend service (depreciated). Use `http[].backends` instead.                                                                                                                              |

Review Comment:
   Hi, I think `deprecated` is correct 🤔 



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] navendu-pottekkat commented on a diff in pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
navendu-pottekkat commented on code in PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#discussion_r1011136101


##########
docs/en/latest/references/apisix_route_v2.md:
##########
@@ -21,83 +26,85 @@ title: ApisixRoute/v2 Reference
 #
 -->
 
+See [concepts](https://apisix.apache.org/docs/ingress-controller/concepts/apisix_route) to learn more about how to use the ApisixRoute resource.
+
 ## Spec
 
-Meaning of each field in the spec of ApisixRoute are followed, the top level fields (`apiVersion`, `kind` and `metadata`) are same as other Kubernetes Resources.
+See the [definition](https://github.com/apache/apisix-ingress-controller/blob/master/samples/deploy/crd/v1/ApisixRoute.yaml) on GitHub.
+
+The table below describes each of the attributes in the spec. The fields `apiVersion`, `kind`, and `metadata` are similar to other Kubernetes resources and are excluded below.
+
+| Attribute                            | Type               | Description                                                                                                                                                                               |
+| ------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| http                                 | array              | HTTP Route rules.                                                                                                                                                                         |
+| http[].name                          | string (required)  | Route rule name.                                                                                                                                                                          |
+| http[].priority                      | integer            | Route priority. Used to determined which Route to use when multiple routes contain the same URI. Large number means higher priority.                                                      |
+| http[].timeout                       | object             | Timeouts for connecting, sending, and receiving messages between Ingress and the service. This will overwrite the value configured in `ApisixUpstream` resource.                          |
+| http[].timeout.connect               | string             | Connect timeout in the form "72h3m0.5s".                                                                                                                                                  |

Review Comment:
   @juzhiyuan I did not understand your question.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] juzhiyuan commented on a diff in pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
juzhiyuan commented on code in PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#discussion_r1013594259


##########
docs/en/latest/references/apisix_route_v2.md:
##########
@@ -21,83 +26,85 @@ title: ApisixRoute/v2 Reference
 #
 -->
 
+See [concepts](https://apisix.apache.org/docs/ingress-controller/concepts/apisix_route) to learn more about how to use the ApisixRoute resource.
+
 ## Spec
 
-Meaning of each field in the spec of ApisixRoute are followed, the top level fields (`apiVersion`, `kind` and `metadata`) are same as other Kubernetes Resources.
+See the [definition](https://github.com/apache/apisix-ingress-controller/blob/master/samples/deploy/crd/v1/ApisixRoute.yaml) on GitHub.
+
+The table below describes each of the attributes in the spec. The fields `apiVersion`, `kind`, and `metadata` are similar to other Kubernetes resources and are excluded below.
+
+| Attribute                            | Type               | Description                                                                                                                                                                               |
+| ------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| http                                 | array              | HTTP Route rules.                                                                                                                                                                         |
+| http[].name                          | string (required)  | Route rule name.                                                                                                                                                                          |
+| http[].priority                      | integer            | Route priority. Used to determined which Route to use when multiple routes contain the same URI. Large number means higher priority.                                                      |
+| http[].timeout                       | object             | Timeouts for connecting, sending, and receiving messages between Ingress and the service. This will overwrite the value configured in `ApisixUpstream` resource.                          |
+| http[].timeout.connect               | string             | Connect timeout in the form "72h3m0.5s".                                                                                                                                                  |
+| http[].timeout.send                  | string             | Send timeout in the form "72h3m0.5s".                                                                                                                                                     |
+| http[].timeout.read                  | string             | Read timeout in the form "72h3m0.5s".                                                                                                                                                     |
+| http[].match                         | object             | Conditions to match a request with the Route.                                                                                                                                             |
+| http[].match.paths                   | array              | List of URIs to match the Route with. The Route will be used if any one of the URIs is matched.                                                                                           |
+| http[].match.hosts                   | array              | List of hosts to match the Route with. The Route will be used if any one of the hosts is matched.                                                                                         |
+| http[].match.methods                 | array              | List of HTTP methods (`GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS`, `CONNECT`, `TRACE`) to match the Route with. The Route will be used if any one of the hosts is matched. |
+| http[].match.remoteAddrs             | array              | List of IP addresses (CIDR format) to match the Route with. The Route will be used if any one of the IP address is matched.                                                               |
+| http[].match.exprs                   | array              | List of expressions to match the Route with. The Route will be used if any one of the expression is matched.                                                                              |
+| http[].match.exprs[].subject         | object             | Subject for the expression.                                                                                                                                                               |
+| http[].match.exprs[].subject.scope   | string             | Scope of the subject. Can be one of `Header`, `Query`, `Cookie`, or `Path`.                                                                                                               |
+| http[].match.exprs[].subject.name    | string             | Subject name. Can be empty when the scope is `Path`.                                                                                                                                      |
+| http[].match.exprs[].op              | string             | Operator for the expression. See [Expression operators](#expression-operators) for more details.                                                                                          |
+| http[].match.exprs[].value           | string             | Value to compare the subject with. Can use either this or `http[].match.exprs[].set`.                                                                                                     |
+| http[].match.exprs[].set             | array              | Set to compare the subject with. Only used when the operator is `In` or `NotIn`. Can use either this or `http[].match.exprs[].value`.                                                     |
+| http[].websocket                     | boolean            | When set to `true``enables websocket proxy.                                                                                                                                               |
+| http[].plugin_config_name            | string             | Existing Plugin Config name to use in the Route.                                                                                                                                          |
+| http[].backends                      | object             | List of backend services. If there are more than one, a weight based traffic split policy would be applied.                                                                               |
+| http[].backends[].serviceName        | string             | Name of the backend service. The service and the `ApisixRoute` resource should be created in the same namespace.                                                                          |
+| http[].backends[].servicePort        | integer or string  | Port number or the name defined in the service object of the backend.                                                                                                                     |
+| http[].backends[].resolveGranularity | string             | See [Service resolution granularity](#service-resolution-granularity) for details.                                                                                                        |
+| http[].backends[].weight             | int                | Weight with which to split traffic to the backend. Defaults to `100` and is ignored when there is only one backend.                                                                       |
+| http[].backends[].subset             | string             | Subset for the target service. Should be pre-defined in the `ApisixUpstream` resource.                                                                                                    |
+| http[].plugins                       | array              | [APISIX Plugins](https://apisix.apache.org/docs/apisix/plugins/batch-requests/) to be executed if the Route is matched.                                                                   |
+| http[].plugins[].name                | string             | Name of the Plugin. See [Plugin hub](https://apisix.apache.org/plugins/) for a list of available Plugins.                                                                                 |
+| http[].plugins[].enable              | boolean            | When set to `true`, the Plugin is enabled on the Route.                                                                                                                                   |
+| http[].plugins[].config              | object             | Configuration of the Plugin. Should have the same fields as in [APISIX docs](https://apisix.apache.org/docs/apisix/plugins/batch-requests/).                                              |
+| http[].authentication                | object             | List of APISIX authentication Plugins.                                                                                                                                                    |
+| http[].authentication.enable         | boolean            | When set to `true`, the authentication Plugin is enabled on the Route.                                                                                                                    |
+| http[].authentication.type           | string             | Type of authentication. Set to one of `basicAuth` or `keyAuth`.                                                                                                                           |
+| http[].authentication.keyAuth        | object             | Unique key for a [Consumer](https://apisix.apache.org/docs/apisix/terminology/consumer/).                                                                                                 |
+| http[].authentication.keyAuth.header | string             | Header to get the key from.                                                                                                                                                               |
+| stream                               | array              | Stream route rules. Contains TCP or UDP rules.                                                                                                                                            |
+| stream[].protocol                    | string (required)  | The protocol of rule. Support `TCP` or `UDP`                                                                                                                                              |
+| stream[].name                        | string (required)  | Name of the rule.                                                                                                                                                                         |
+| stream[].match                       | object (required)  | Conditions to match the request with the Route.                                                                                                                                           |
+| stream[].match.ingressPort           | integer (required) | Listening port in the Ingress proxy server. This port should be defined in the [APISIX configuration](https://github.com/apache/apisix/blob/master/conf/config-default.yaml#L101).        |
+| stream[].backend                     | object             | Backend service (deprecated). Use `http[].backends` instead.                                                                                                                              |
+| stream[].backend.serviceName         | string             | Name of the backend service (depricated). The service and the `ApisixRoute` resource should be created in the same namespace.                                                             |
+| stream[].backend.servicePort         | integer or string  | Port number or the name defined in the service object of the backend (depricated).                                                                                                        |

Review Comment:
   ```suggestion
   | stream[].backend.servicePort         | integer or string  | Port number or the name defined in the service object of the backend (deprecated).                                                                                                        |
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] juzhiyuan commented on pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
juzhiyuan commented on PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#issuecomment-1299522296

   <img width="789" alt="image" src="https://user-images.githubusercontent.com/2106987/199389929-19ab6976-bebf-4cfb-8676-c5c4b6835536.png">
   
   Error from other docs, I think we can ignore them in this PR.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix-ingress-controller] navendu-pottekkat commented on pull request #1423: docs: update ApisixRoute/v2 reference

Posted by GitBox <gi...@apache.org>.
navendu-pottekkat commented on PR #1423:
URL: https://github.com/apache/apisix-ingress-controller/pull/1423#issuecomment-1314729342

   @juzhiyuan @tao12345666333 I have updated the v2beta3 docs as well in this PR. Please review and merge.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org