diff --git a/api-ref/source/v2/metering.inc b/api-ref/source/v2/metering.inc
index 7e6cc55a1..cfc5b02d9 100644
--- a/api-ref/source/v2/metering.inc
+++ b/api-ref/source/v2/metering.inc
@@ -208,8 +208,8 @@ Response Parameters
 .. rest_parameters:: parameters.yaml
 
    - metering_label_rules: metering_label_rules
-   - direction: direction
-   - remote_ip_prefix: remote_ip_prefix
+   - direction: metering_label_rule-direction
+   - remote_ip_prefix: metering_label_rule-remote_ip_prefix
    - excluded : excluded
    - metering_label_id: metering_label-id-body
    - id: metering_label_rule-id
@@ -237,8 +237,8 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - metering_label_rule: metering_label_rule
-   - remote_ip_prefix: remote_ip_prefix
-   - direction: direction
+   - remote_ip_prefix: metering_label_rule-remote_ip_prefix
+   - direction: metering_label_rule-direction
    - metering_label_id: metering_label-id-body
    - excluded: excluded-request
 
@@ -254,8 +254,8 @@ Response Parameters
 .. rest_parameters:: parameters.yaml
 
    - metering_label_rule: metering_label_rule
-   - direction: direction
-   - remote_ip_prefix: remote_ip_prefix
+   - direction: metering_label_rule-direction
+   - remote_ip_prefix: metering_label_rule-remote_ip_prefix
    - excluded : excluded
    - metering_label_id: metering_label-id-body
    - id: metering_label_rule-id
@@ -309,8 +309,8 @@ Response Paramters
 .. rest_parameters:: parameters.yaml
 
    - metering_label_rule: metering_label_rule
-   - direction: direction
-   - remote_ip_prefix: remote_ip_prefix
+   - direction: metering_label_rule-direction
+   - remote_ip_prefix: metering_label_rule-remote_ip_prefix
    - excluded : excluded
    - metering_label_id: metering_label-id-body
    - id: metering_label_rule-id
diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index 587ec0e3c..99053dc73 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -375,8 +375,8 @@ device_owner-query:
   type: string
 direction-query:
   description: |
-    Filter the security group rule list result by the direction in
-    which the metering rule is applied, which is ``ingress`` or ``egress``.
+    Filter the security group rule list result by the direction in which
+    the security group rule is applied, which is ``ingress`` or ``egress``.
   in: query
   required: false
   type: string
@@ -855,6 +855,13 @@ remote_group_id-query:
   in: query
   required: false
   type: string
+remote_ip_prefix-query:
+  description: |
+    Filter the list result by the remote IP prefix that is matched by
+    this security group rule.
+  in: query
+  required: false
+  type: string
 resource_log_id-query:
   description: |
     Filter the log list result by the ID of resource (e.g security group ID).
@@ -930,7 +937,7 @@ security_group_rule-sort_key:
     - ``port_range_max``
     - ``port_range_min``
     - ``protocol``
-    - ``remote_group_id```
+    - ``remote_group_id``
     - ``remote_ip_prefix``
     - ``security_group_id``
     - ``tenant_id``
@@ -1939,7 +1946,7 @@ device_owner-request:
 direction:
   description: |
     Ingress or egress, which is the direction in
-    which the metering rule is applied.
+    which the security group rule is applied.
   in: body
   required: true
   type: string
@@ -2078,6 +2085,13 @@ endpoints:
   required: true
   type: array
 ethertype:
+  description: |
+    Must be IPv4 or IPv6, and addresses represented
+    in CIDR must match the ingress or egress rules.
+  in: body
+  required: true
+  type: string
+ethertype-request:
   description: |
     Must be IPv4 or IPv6, and addresses represented
     in CIDR must match the ingress or egress rules.
@@ -3538,12 +3552,25 @@ metering_label_rule:
   in: body
   required: true
   type: object
+metering_label_rule-direction:
+  description: |
+    Ingress or egress, which is the direction in
+    which the metering rule is applied.
+  in: body
+  required: true
+  type: string
 metering_label_rule-id:
   description: |
     The ID of the metering label rule.
   in: body
   required: true
   type: string
+metering_label_rule-remote_ip_prefix:
+  description: |
+    The remote IP prefix that is matched by this metering rule.
+  in: body
+  required: true
+  type: string
 metering_label_rules:
   description: |
     A list of ``metering_label_rule`` objects.
@@ -3941,6 +3968,16 @@ port_id_subport:
   required: true
   type: string
 port_range_max:
+  description: |
+    The maximum port number in the range that is
+    matched by the security group rule. If the protocol is TCP, UDP,
+    DCCP, SCTP or UDP-Lite this value must be greater than or equal to
+    the ``port_range_min`` attribute value. If the protocol is ICMP,
+    this value must be an ICMP type.
+  in: body
+  required: true
+  type: integer
+port_range_max-request:
   description: |
     The maximum port number in the range that is
     matched by the security group rule. If the protocol is TCP, UDP,
@@ -3951,6 +3988,16 @@ port_range_max:
   required: false
   type: integer
 port_range_min:
+  description: |
+    The minimum port number in the range that is
+    matched by the security group rule. If the protocol is TCP, UDP,
+    DCCP, SCTP or UDP-Lite this value must be less than or equal to
+    the ``port_range_max`` attribute value. If the protocol is ICMP,
+    this value must be an ICMP type.
+  in: body
+  required: true
+  type: integer
+port_range_min-request:
   description: |
     The minimum port number in the range that is
     matched by the security group rule. If the protocol is TCP, UDP,
@@ -4056,6 +4103,24 @@ protocol:
   in: body
   required: true
   type: string
+protocol-request:
+  description: |
+    The IP protocol can be represented by a string, an integer, or ``null``.
+    Valid string or integer values are ``any`` or ``0``, ``ah`` or ``51``,
+    ``dccp`` or ``33``, ``egp`` or ``8``, ``esp`` or ``50``, ``gre`` or ``47``,
+    ``icmp`` or ``1``, ``icmpv6`` or ``58``, ``igmp`` or ``2``,
+    ``ipip`` or ``4``, ``ipv6-encap`` or ``41``,
+    ``ipv6-frag`` or ``44``, ``ipv6-icmp`` or ``58``, ``ipv6-nonxt`` or ``59``,
+    ``ipv6-opts`` or ``60``, ``ipv6-route`` or ``43``, ``ospf`` or ``89``,
+    ``pgm`` or ``113``, ``rsvp`` or ``46``, ``sctp`` or ``132``,
+    ``tcp`` or ``6``, ``udp`` or ``17``, ``udplite`` or ``136``,
+    ``vrrp`` or ``112``. Additionally, any integer value between [0-255] is
+    also valid. The string ``any`` (or integer ``0``) means ``all`` IP
+    protocols. See the constants in ``neutron_lib.constants`` for the most
+    up-to-date list of supported strings.
+  in: body
+  required: false
+  type: string
 protocol-response:
   description: |
     The IP protocol. Valid value is ``icmp``,
@@ -4437,6 +4502,15 @@ rbac_policy_id:
   required: true
   type: string
 remote_group_id:
+  description: |
+    The remote group UUID to associate with this
+    security group rule. You can specify either the
+    ``remote_group_id`` or ``remote_ip_prefix`` attribute in the
+    request body.
+  in: body
+  required: true
+  type: string
+remote_group_id-request:
   description: |
     The remote group UUID to associate with this
     security group rule. You can specify either the
@@ -4447,11 +4521,16 @@ remote_group_id:
   type: string
 remote_ip_prefix:
   description: |
-    The remote IP prefix to associate with this
-    metering rule packet.
+    The remote IP prefix that is matched by this security group rule.
   in: body
   required: true
   type: string
+remote_ip_prefix-request:
+  description: |
+    The remote IP prefix that is matched by this security group rule.
+  in: body
+  required: false
+  type: string
 resource-collection:
   description: |
     Collection name of the resource.
diff --git a/api-ref/source/v2/security-group-rules.inc b/api-ref/source/v2/security-group-rules.inc
index e37109991..3f25f0fb4 100644
--- a/api-ref/source/v2/security-group-rules.inc
+++ b/api-ref/source/v2/security-group-rules.inc
@@ -48,6 +48,7 @@ Request
    - tenant_id: project_id-query
    - project_id: project_id-query
    - port_range_min: port_range_min-query
+   - remote_ip_prefix: remote_ip_prefix-query
    - revision_number: revision_number-query
    - id: id-query
    - description: description-query
@@ -100,14 +101,14 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - security_group_rule: security_group_rule
-   - remote_group_id: remote_group_id
+   - remote_group_id: remote_group_id-request
    - direction: direction
-   - protocol: protocol
-   - ethertype: ethertype
-   - port_range_max: port_range_max
+   - protocol: protocol-request
+   - ethertype: ethertype-request
+   - port_range_max: port_range_max-request
    - security_group_id: security_group_rule-security_group_id
-   - port_range_min: port_range_min
-   - remote_ip_prefix: remote_ip_prefix
+   - port_range_min: port_range_min-request
+   - remote_ip_prefix: remote_ip_prefix-request
    - description: description-request
 
 Request Example