Save Storage Policy¶

Update and save the configuration of the specified storage policy, including the data storage time and models and measurement points that are configured with it.

Note

To avoid the lack of system resources and system instability, the interface for modifying the storage time will not be available after 2.3 CU5, please contact the system administrator if you are required to update it.

Request Format¶

POST https://{apigw-address}/tsdb-policy/v2.0/policies/{policyId}

Request Parameters (Header)¶

Name	Mandatory/Optional	Data Type	Description
Content-Type	Mandatory	String	Content or file type. The default value is application/json.

Request Parameters (URI)¶

Name	Location (Path/Query)	Mandatory/Optional	Data Type	Description
policyId	Path	Mandatory	String	The storage policy ID, which can be retrieved through the EnOS Management Console > Time Series Data Management > Storage Policy page.
orgId	Query	Mandatory	String	The organization ID which the asset belongs to. How to get organization ID>>

Request Parameters (Body)¶

Name	Mandatory/Optional	Data Type	Description
retention	Optional	String	The data storage time. If the models and measurement points already have the storage time configured, this parameter is optional. All supported retention include `1M`, `3M`, `6M`, `1y`, `2y`, `3y`, `5y`, `10y`, `15y`, `20y`.
models	Mandatory	List<JSONObject>	The list of models and measurement points. See Model and Point Struct

Model and Point Struct¶

Name	Mandatory/Optional	Data Type	Description
modelId	Mandatory	String	Model ID.
points	Mandatory	List<JSONObject>	A list of measurement points in the model that need storage policy configuration.

Error Code¶

For the description of error codes, see Common Error Codes.

Sample¶

Request Sample¶

url: https://{apigw-address}/tsdb-policy/v2.0/policies/aa8bbcba-2919-4c78-854c-54984d85d2fa

method: POST

requestBody:
{
   "models": [
      {
         "modelId": "yourModelId1",
         "points": [
            "yourPointId1",
            "yourPointId2"
         ]
      },
      {
         "modelId": "yourModelId2",
         "points": [
            "yourPointId3",
            "yourPointId4"
         ]
      }
   ],
   "retention": "6M"
}

Return Sample¶

{
  "code": 0,
  "msg": "OK",
  "data": null
}

Java SDK Sample¶

import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.envision.apim.poseidon.config.PConfig;
import com.envision.apim.poseidon.core.Poseidon;
import com.envision.apim.poseidon.request.PoseidonRequest;

public class Sample {
    private static final String API_GATEWAY_URL = "https://{apigw-address}";

    private static class Request extends PoseidonRequest {

        public void setBodyParams(String key, Object value) {
            bodyParams().put(key, value);
        }

        public void setMethod(String method) {
            this.method = method;
        }

        private String method;

        @Override
        public String baseUri() {
            return "";
        }

        @Override
        public String method() {
            return method;
        }
    }

    public static void main(String[] args) {
         Poseidon poseidon = Poseidon.config(
                 PConfig.init()
                         .appKey("AccessKey of your APP")
                         .appSecret("SecretKey of your APP")
         ).method("POST") .header("Content-Type", "application/json");
        Request request = new Request();

        JSONArray models = new JSONArray();
        JSONObject model1 = new JSONObject();
        model1.put("modelId", "yourModelId1");
        model1.put("points", new String[]{"yourPointId1", "yourPointId2"});
        JSONObject model2 = new JSONObject();
        model2.put("modelId", "yourModelId2");
        model2.put("points", new String[]{"yourPointId1", "yourPointId2"});
        models.add(model1);
        models.add(model2);

        request.setBodyParams("models", models);
        request.setBodyParams("retention", "6M");

        String policyId = "yourPolicyId";
        JSONObject resp = poseidon.url(API_GATEWAY_URL + "/tsdb-policy/v2.0/policies/" + policyId)
                .queryParam("orgId", "yourOrgId")
                .getResponse(request, JSONObject.class);

        System.out.println(resp);
    }
}