[DOCS] Adds shards object to Create pack and Update pack API (elastic…

…#166363)

## Summary

- Resolves elastic/security-docs#3822

Adds the `shards` object schema definition to Create pack and Update
pack API, and to the Create pack request example.

- Related dev PR: elastic#166178

(cherry picked from commit 0215ed3)

docs/api/osquery-manager/packs/create.asciidoc

@@ -33,6 +33,8 @@ experimental[] Create packs.
 
 `policy_ids`:: (Optional, array) A list of agents policy IDs.
 
+`shards`:: (Required, object) An object with shard configuration for policies included in the pack. For each policy, set the shard configuration to a percentage (1–100) of target hosts.
+
 `queries`:: (Required, object) An object of queries.
 
 
@@ -56,8 +58,13 @@ $ curl -X POST api/osquery/packs \
   "description": "My pack",
   "enabled": true,
   "policy_ids": [
-    "my_policy_id"
+    "my_policy_id",
+    "fleet-server-policy"
   ],
+  "shards": {
+    "my_policy_id": 35,
+    "fleet-server-policy": 58
+  },
   "queries": {
     "my_query": {
       "query": "SELECT * FROM listening_ports;",
@@ -67,7 +74,10 @@ $ curl -X POST api/osquery/packs \
           "field": "port"
         },
         "tags": {
-          "value": ["tag1", "tag2"]
+          "value": [
+            "tag1",
+            "tag2"
+          ]
         }
       }
     }

docs/api/osquery-manager/packs/update.asciidoc

@@ -38,6 +38,8 @@ WARNING: You are unable to update a prebuilt pack (`read_only = true`).
 
 `policy_ids`:: (Optional, array) A list of agent policy IDs.
 
+`shards`:: (Optional, object) An object with shard configuration for policies included in the pack. For each policy, set the shard configuration to a percentage (1–100) of target hosts.
+
 `queries`:: (Required, object) An object of queries.