[brooklyn-server] branch master updated: add notes on deprecated endpoints

[heneveld]

This is an automated email from the ASF dual-hosted git repository.

heneveld pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/brooklyn-server.git


The following commit(s) were added to refs/heads/master by this push:
     new 4b840ae  add notes on deprecated endpoints
4b840ae is described below

commit 4b840aef7731284e0ffdd43497be0d0edb931181
Author: Alex Heneveld <alex.henev...@cloudsoftcorp.com>
AuthorDate: Fri Jul 30 15:17:18 2021 +0100

    add notes on deprecated endpoints
---
 .../src/main/java/org/apache/brooklyn/rest/api/CatalogApi.java        | 4 +++-
 .../src/main/java/org/apache/brooklyn/rest/api/PolicyApi.java         | 2 +-
 .../src/main/java/org/apache/brooklyn/rest/api/PolicyConfigApi.java   | 2 +-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git 
a/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/CatalogApi.java 
b/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/CatalogApi.java
index 40a077c..57b5a27 100644
--- a/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/CatalogApi.java
+++ b/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/CatalogApi.java
@@ -48,9 +48,11 @@ import io.swagger.annotations.ApiResponse;
 import io.swagger.annotations.ApiResponses;
 
 @Path("/catalog")
-@Api("Catalog")
+@Api(value = "Catalog (deprecated; use Catalog Types endpoint)", hidden = true)
 @Consumes(MediaType.APPLICATION_JSON)
 @Produces(MediaType.APPLICATION_JSON)
+@Deprecated
+/** @deprecated since 1.1 use {@link TypeApi} instead */
 public interface CatalogApi {
 
     /** @deprecated since 0.11.0 use {@link #createFromYaml(String, boolean)} 
instead */
diff --git 
a/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/PolicyApi.java 
b/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/PolicyApi.java
index fd79798..2e4e5d8 100644
--- a/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/PolicyApi.java
+++ b/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/PolicyApi.java
@@ -33,7 +33,7 @@ import java.util.List;
 import java.util.Map;
 
 @Path("/applications/{application}/entities/{entity}/policies")
-@Api("Entity Policies")
+@Api(value="Entity Policies (deprecated; use Entity Adjuncts endpoint)", 
hidden = true)
 @Produces(MediaType.APPLICATION_JSON)
 @Consumes(MediaType.APPLICATION_JSON)
 /** @deprecated since 1.0.0 use AdjunctApi */
diff --git 
a/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/PolicyConfigApi.java 
b/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/PolicyConfigApi.java
index fafed43..3a31619 100644
--- 
a/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/PolicyConfigApi.java
+++ 
b/rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/PolicyConfigApi.java
@@ -39,7 +39,7 @@ import io.swagger.annotations.ApiResponse;
 import io.swagger.annotations.ApiResponses;
 
 @Path("/applications/{application}/entities/{entity}/policies/{policy}/config")
-@Api("Entity Policy Config")
+@Api(value="Entity Policy Config (deprecated; use Entity Adjuncts endpoint)", 
hidden = true)
 @Produces(MediaType.APPLICATION_JSON)
 @Consumes(MediaType.APPLICATION_JSON)
 /** @deprecated since 1.0.0 use AdjunctApi */