aboutsummaryrefslogtreecommitdiffstats
path: root/a1-policy-management/api/pms-api.json
diff options
context:
space:
mode:
authorPatrikBuhr <patrik.buhr@est.tech>2021-01-20 12:21:52 +0100
committerPatrikBuhr <patrik.buhr@est.tech>2021-01-21 10:44:37 +0100
commit1122b01a05d4de22564716b815935bf880703276 (patch)
tree4d72bd20a2b1058b02b8b61b6c9aae04db8f759b /a1-policy-management/api/pms-api.json
parentbe0ae3e197f5d5032c0766a59050b03e2a4deb99 (diff)
PMS API Documentation updates
Change-Id: I2a02145c48fd4b022b2e17b157760bd7ddb8128f Issue-ID: CCSDK-3077 Signed-off-by: PatrikBuhr <patrik.buhr@est.tech>
Diffstat (limited to 'a1-policy-management/api/pms-api.json')
-rw-r--r--a1-policy-management/api/pms-api.json127
1 files changed, 57 insertions, 70 deletions
diff --git a/a1-policy-management/api/pms-api.json b/a1-policy-management/api/pms-api.json
index d1823894..fe4554bf 100644
--- a/a1-policy-management/api/pms-api.json
+++ b/a1-policy-management/api/pms-api.json
@@ -5,7 +5,7 @@
"summary": "Query policy type names",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "getPolicyTypesUsingGET",
+ "operationId": "getPolicyTypesUsingGET_1",
"responses": {
"200": {
"schema": {
@@ -29,7 +29,7 @@
"type": "string",
"required": false
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}},
"/a1-policy/v2/policy-instances": {"get": {
"summary": "Query for A1 policy instances",
@@ -75,7 +75,7 @@
"required": false
}
],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
}},
"/a1-policy/v2/status": {"get": {
"summary": "Returns status and statistics of this service",
@@ -91,14 +91,14 @@
"403": {"description": "Forbidden"},
"404": {"description": "Not Found"}
},
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
}},
"/services": {
"get": {
"summary": "Returns service information",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "getServicesUsingGET",
+ "operationId": "getServicesUsingGET_1",
"responses": {
"200": {
"schema": {
@@ -122,13 +122,13 @@
"type": "string",
"required": false
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
},
"delete": {
"summary": "Delete a service",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "deleteServiceUsingDELETE",
+ "operationId": "deleteServiceUsingDELETE_1",
"responses": {
"200": {
"schema": {"type": "string"},
@@ -153,7 +153,7 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}
},
"/a1-policy/v2/rics/ric": {"get": {
@@ -161,7 +161,7 @@
"deprecated": false,
"produces": ["application/json"],
"description": "Either a Near-RT RIC identity or a Mananged Element identity can be specified.<br>The intention with Mananged Element identity is the ID used in O1 for accessing the traffical element (such as the ID of CU).",
- "operationId": "getRicUsingGET",
+ "operationId": "getRicUsingGET_1",
"responses": {
"200": {
"schema": {"$ref": "#/definitions/ric_info_v2"},
@@ -192,14 +192,14 @@
"required": false
}
],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
}},
"/a1-policy/v2/policies/{policy_id}": {
"get": {
"summary": "Returns a policy",
"deprecated": false,
"produces": ["application/json"],
- "operationId": "getPolicyUsingGET_1",
+ "operationId": "getPolicyUsingGET",
"responses": {
"200": {
"schema": {"$ref": "#/definitions/policy_info_v2"},
@@ -219,13 +219,13 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
},
"delete": {
"summary": "Delete a policy",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "deletePolicyUsingDELETE_1",
+ "operationId": "deletePolicyUsingDELETE",
"responses": {
"200": {"description": "Not used"},
"401": {"description": "Unauthorized"},
@@ -247,14 +247,14 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
}
},
"/a1-policy/v2/policy-types": {"get": {
"summary": "Query policy type identities",
"deprecated": false,
"produces": ["application/json"],
- "operationId": "getPolicyTypesUsingGET_1",
+ "operationId": "getPolicyTypesUsingGET",
"responses": {
"200": {
"schema": {"$ref": "#/definitions/policytype_id_list_v2"},
@@ -275,7 +275,7 @@
"type": "string",
"required": false
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
}},
"/a1-policy/v2/configuration": {
"get": {
@@ -335,7 +335,7 @@
"summary": "Returns a policy configuration",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "getPolicyUsingGET",
+ "operationId": "getPolicyUsingGET_1",
"responses": {
"200": {
"schema": {"type": "object"},
@@ -356,13 +356,13 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
},
"delete": {
"summary": "Delete a policy",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "deletePolicyUsingDELETE",
+ "operationId": "deletePolicyUsingDELETE_1",
"responses": {
"200": {"description": "Not used"},
"401": {"description": "Unauthorized"},
@@ -385,13 +385,13 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
},
"put": {
"summary": "Put a policy",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "putPolicyUsingPUT",
+ "operationId": "putPolicyUsingPUT_1",
"responses": {
"200": {"description": "Policy updated"},
"201": {"description": "Policy created"},
@@ -457,7 +457,7 @@
"required": false
}
],
- "tags": ["A1 Policy Management Version 1.0"],
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"],
"consumes": ["application/json"]
}
},
@@ -507,13 +507,13 @@
"required": false
}
],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}},
"/a1-policy/v2/services/{service_id}/keepalive": {"put": {
"summary": "Heartbeat indicates that the service is running",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "keepAliveServiceUsingPUT_1",
+ "operationId": "keepAliveServiceUsingPUT",
"responses": {
"200": {
"schema": {"type": "object"},
@@ -534,7 +534,7 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"],
+ "tags": ["A1 Policy Management Version 2.0"],
"consumes": ["application/json"]
}},
"/policy_schema": {"get": {
@@ -562,13 +562,13 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}},
"/rics": {"get": {
"summary": "Query Near-RT RIC information",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "getRicsUsingGET_1",
+ "operationId": "getRicsUsingGET",
"responses": {
"200": {
"schema": {
@@ -592,13 +592,13 @@
"type": "string",
"required": false
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}},
"/policy_status": {"get": {
"summary": "Returns a policy status",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "getPolicyStatusUsingGET",
+ "operationId": "getPolicyStatusUsingGET_1",
"responses": {
"200": {
"schema": {"type": "object"},
@@ -619,14 +619,14 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}},
"/a1-policy/v2/rics": {"get": {
"summary": "Query Near-RT RIC information",
"deprecated": false,
"produces": ["application/json"],
"description": "The call returns all Near-RT RICs that supports a given policy type identity",
- "operationId": "getRicsUsingGET",
+ "operationId": "getRicsUsingGET_1",
"responses": {
"200": {
"schema": {"$ref": "#/definitions/ric_info_list_v2"},
@@ -647,13 +647,13 @@
"type": "string",
"required": false
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
}},
"/policy_ids": {"get": {
"summary": "Query policies, only policy identities returned",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "getPolicyIdsUsingGET",
+ "operationId": "getPolicyIdsUsingGET_1",
"responses": {
"200": {
"schema": {
@@ -695,7 +695,7 @@
"required": false
}
],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}},
"/policy_schemas": {"get": {
"summary": "Returns policy type schema definitions",
@@ -725,7 +725,7 @@
"type": "string",
"required": false
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}},
"/a1-policy/v2/services": {
"get": {
@@ -733,7 +733,7 @@
"deprecated": false,
"produces": ["application/json"],
"description": "Either information about a registered service with given identity or all registered services are returned.",
- "operationId": "getServicesUsingGET_1",
+ "operationId": "getServicesUsingGET",
"responses": {
"200": {
"schema": {"$ref": "#/definitions/service_list_v2"},
@@ -754,14 +754,14 @@
"type": "string",
"required": false
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
},
"put": {
"summary": "Register a service",
"deprecated": false,
"produces": ["*/*"],
"description": "Registering a service is needed to:<ul><li>Get callbacks.<\/li><li>Activate supervision of the service. If a service is inactive, its policies will be deleted.<\/li><\/ul>",
- "operationId": "putServiceUsingPUT_1",
+ "operationId": "putServiceUsingPUT",
"responses": {
"200": {
"schema": {"type": "object"},
@@ -786,7 +786,7 @@
"description": "registrationInfo",
"required": true
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"],
+ "tags": ["A1 Policy Management Version 2.0"],
"consumes": ["application/json"]
}
},
@@ -794,7 +794,7 @@
"summary": "Returns the name of a RIC managing one Mananged Element",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "getRicUsingGET_1",
+ "operationId": "getRicUsingGET",
"responses": {
"200": {
"schema": {"type": "string"},
@@ -815,13 +815,13 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}},
"/services/keepalive": {"put": {
"summary": "Heartbeat from a service",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "keepAliveServiceUsingPUT",
+ "operationId": "keepAliveServiceUsingPUT_1",
"responses": {
"200": {
"schema": {"type": "string"},
@@ -840,7 +840,7 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 1.0"],
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"],
"consumes": ["application/json"]
}},
"/a1-policy/v2/policy-types/{policytype_id}": {"get": {
@@ -867,7 +867,7 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
}},
"/status": {"get": {
"summary": "Returns status and statistics of this service",
@@ -883,7 +883,7 @@
"403": {"description": "Forbidden"},
"404": {"description": "Not Found"}
},
- "tags": ["A1 Policy Management Version 1.0"]
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"]
}},
"/a1-policy/v2/policies": {
"get": {
@@ -891,7 +891,7 @@
"deprecated": false,
"produces": ["application/json"],
"description": "Returns a list of A1 policies matching given search criteria. <br>If several query parameters are defined, the policies matching all conditions are returned.",
- "operationId": "getPolicyIdsUsingGET_1",
+ "operationId": "getPolicyIdsUsingGET",
"responses": {
"200": {
"schema": {"$ref": "#/definitions/policy_id_list_v2"},
@@ -930,13 +930,13 @@
"required": false
}
],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
},
"put": {
"summary": "Create or update a policy",
"deprecated": false,
"produces": ["application/json"],
- "operationId": "putPolicyUsingPUT_1",
+ "operationId": "putPolicyUsingPUT",
"responses": {
"200": {"description": "Policy updated"},
"201": {"description": "Policy created"},
@@ -958,7 +958,7 @@
"description": "policyInfo",
"required": true
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"],
+ "tags": ["A1 Policy Management Version 2.0"],
"consumes": ["application/json"]
}
},
@@ -989,7 +989,7 @@
"summary": "Unregister a service",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "deleteServiceUsingDELETE_1",
+ "operationId": "deleteServiceUsingDELETE",
"responses": {
"200": {"description": "Not used"},
"401": {"description": "Unauthorized"},
@@ -1010,13 +1010,13 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
}},
"/service": {"put": {
"summary": "Register a service",
"deprecated": false,
"produces": ["*/*"],
- "operationId": "putServiceUsingPUT",
+ "operationId": "putServiceUsingPUT_1",
"responses": {
"200": {
"schema": {"type": "string"},
@@ -1041,14 +1041,14 @@
"description": "registrationInfo",
"required": true
}],
- "tags": ["A1 Policy Management Version 1.0"],
+ "tags": ["A1 Policy Management Version 1.0 (deprecated)"],
"consumes": ["application/json"]
}},
"/a1-policy/v2/policies/{policy_id}/status": {"get": {
"summary": "Returns a policy status",
"deprecated": false,
"produces": ["application/json"],
- "operationId": "getPolicyStatusUsingGET_1",
+ "operationId": "getPolicyStatusUsingGET",
"responses": {
"200": {
"schema": {"$ref": "#/definitions/policy_status_info_v2"},
@@ -1068,7 +1068,7 @@
"type": "string",
"required": true
}],
- "tags": ["A1 Policy Management Version 2.0 (in progress)"]
+ "tags": ["A1 Policy Management Version 2.0"]
}}
},
"definitions": {
@@ -1090,11 +1090,6 @@
}
}
},
- "void": {
- "description": "Void/empty",
- "type": "object",
- "title": "void"
- },
"status_info_v2": {
"type": "object",
"title": "status_info_v2",
@@ -1133,10 +1128,6 @@
}
}
},
- "Mono«ResponseEntity«object»»": {
- "type": "object",
- "title": "Mono«ResponseEntity«object»»"
- },
"ric_info_v2": {
"description": "Information for a Near-RT RIC",
"type": "object",
@@ -1412,10 +1403,6 @@
"enum": ["AVAILABLE"]
}
}
- },
- "Mono«ResponseEntity«string»»": {
- "type": "object",
- "title": "Mono«ResponseEntity«string»»"
}
},
"swagger": "2.0",
@@ -1432,11 +1419,11 @@
},
"tags": [
{
- "name": "A1 Policy Management Version 1.0",
+ "name": "A1 Policy Management Version 1.0 (deprecated)",
"description": "Policy Controller"
},
{
- "name": "A1 Policy Management Version 2.0 (in progress)",
+ "name": "A1 Policy Management Version 2.0",
"description": "Policy Controller"
},
{