Deprecate freeze and unfreeze indices endpoints in REST API specification (#75042) (#75058)

* Deprecate frozen indices endpoint
* Improve description to match warning
* Deprecate unfreeze indices in REST API specs

Co-authored-by: Steve Gordon <[email protected]>

Author: elasticsearchmachine

rest-api-spec/src/main/resources/rest-api-spec/api/indices.freeze.json

@@ -21,6 +21,10 @@
               "type":"string",
               "description":"The name of the index to freeze"
             }
+          },
+          "deprecated":{
+            "version":"7.14.0",
+            "description":"Frozen indices are deprecated because they provide no benefit given improvements in heap memory utilization. They will be removed in a future release."
           }
         }
       ]

rest-api-spec/src/main/resources/rest-api-spec/api/indices.unfreeze.json

@@ -21,6 +21,10 @@
               "type":"string",
               "description":"The name of the index to unfreeze"
             }
+          },
+          "deprecated":{
+            "version":"7.14.0",
+            "description":"Frozen indices are deprecated because they provide no benefit given improvements in heap memory utilization. They will be removed in a future release."
           }
         }
       ]