@@ -18,7 +18,7 @@ Definition
18
18
Removes the association between a range of shard key values and a
19
19
:term:`zone`.
20
20
21
- :method:` sh.removeRangeFromZone()` takes the following arguments :
21
+ `` sh.removeRangeFromZone()`` takes the following fields :
22
22
23
23
24
24
.. list-table::
@@ -60,25 +60,22 @@ Definition
60
60
61
61
Specify each field of the shard key in the form of ``<fieldname> : <value>``.
62
62
The value must be of the same BSON type or types as the shard key.
63
-
64
-
65
-
66
63
67
64
68
- Use :method:` sh.removeRangeFromZone()` to remove the association between
69
- unused, out of date, or conflicting ranges and a zone.
65
+ Use `` sh.removeRangeFromZone()` ` to remove the association between
66
+ unused, out of date, or conflicting shard key ranges and a zone.
70
67
71
68
If no range matches the minimum and maximum bounds passed to
72
- :method:`~ sh.removeShardFromZone() `, nothing is removed.
69
+ `` sh.removeRangeFromZone()` `, nothing is removed.
73
70
74
- Only issue :method:` sh.removeTagRange() ` when connected to a
71
+ Only run `` sh.removeRangeFromZone()` ` when connected to a
75
72
:binary:`~bin.mongos` instance.
76
73
77
74
Behavior
78
75
--------
79
76
80
- :method:` sh.removeShardFromZone ()` does not remove the zone associated to the
81
- specified range .
77
+ `` sh.removeRangeFromZone ()`` doesn't remove the association between
78
+ a zone and a shard. It also doesn't remove the zone itself .
82
79
83
80
See the :ref:`zone <zone-sharding>` manual page for more information on zones
84
81
in sharded clusters.
@@ -112,11 +109,10 @@ must authenticate as either:
112
109
or, alternatively
113
110
114
111
- a user whose privileges include :authaction:`enableSharding` on the
115
- :ref:`cluster <resource-specific-collection>` resource (available
116
- starting in version 4.2.2, 4.0.14, 3.6.16).
112
+ :ref:`cluster <resource-specific-collection>` resource.
117
113
118
114
The :authrole:`clusterAdmin` or :authrole:`clusterManager` built-in roles have
119
- the appropriate permissions for issuing :method:` sh.removeRangeFromZone()`.
115
+ the appropriate permissions for running `` sh.removeRangeFromZone()` `.
120
116
See the documentation page for :ref:`Role-Based Access Control
121
117
<authorization>` for more information.
122
118
@@ -152,7 +148,7 @@ specifies ``{ a : 0 }`` as the ``min`` bound:
152
148
153
149
While the range of ``{ a : 0 }`` and ``{ a : 10 }`` encompasses the existing
154
150
range, it is not an exact match and therefore
155
- :method:` sh.removeRangeFromZone()` does not remove anything.
151
+ `` sh.removeRangeFromZone()` ` does not remove anything.
156
152
157
153
Compound Shard Key
158
154
~~~~~~~~~~~~~~~~~~
@@ -171,5 +167,5 @@ bound of ``{ a : 1, b : 1}`` and an upper bound of ``{ a : 10, b : 10 }``:
171
167
Given the previous example, if there was an existing range with a lower bound
172
168
of ``{ a : 1, b : 5 }`` and an upper bound of ``{ a : 10, b : 1 }``, the
173
169
operation would *not* remove that range, as it is not an exact match of the
174
- minimum and maximum passed to :method:` sh.removeRangeFromZone()`.
170
+ minimum and maximum passed to `` sh.removeRangeFromZone()` `.
175
171
0 commit comments