AppEnablementAPI.json 81.1 KB
Newer Older
YannGarcia's avatar
YannGarcia committed
        },
        "links": {
          "getIndividualMeService": {
            "$ref": "#/components/links/GetIndividualMeService"
          },
          "putIndividualMeService": {
            "$ref": "#/components/links/PutIndividualMeService"
YannGarcia's avatar
YannGarcia committed
      "Services.201": {
        "description": "Upon success, the HTTP response shall include a Location HTTP header that contains the resource URI of the created resource.",
        "headers": {
          "location": {
            "description": "The resource URI of the created resource",
            "schema": {
              "type": "string",
              "format": "uri"
            }
          }
        },
YannGarcia's avatar
YannGarcia committed
        "content": {
          "application/json": {
            "schema": {
YannGarcia's avatar
YannGarcia committed
              "$ref": "#/components/schemas/ServiceInfo"
            },
            "examples": {
              "ServiceInfo": {
                "$ref": "#/components/examples/ServiceInfo"
              }
YannGarcia's avatar
YannGarcia committed
        "links": {
          "getIndividualMeService": {
            "$ref": "#/components/links/GetIndividualMeService"
          },
          "putIndividualMeService": {
            "$ref": "#/components/links/PutIndividualMeService"
          }
        }
      },
      "ServicesServiceId.200": {
        "description": "It is used to indicate nonspecific success. The response body contains a representation of the resource.",
YannGarcia's avatar
YannGarcia committed
        "content": {
          "application/json": {
            "schema": {
YannGarcia's avatar
YannGarcia committed
              "$ref": "#/components/schemas/ServiceInfo"
            },
            "examples": {
              "ServiceInfo": {
                "$ref": "#/components/examples/ServiceInfo"
              }
YannGarcia's avatar
YannGarcia committed
      "TimingCurrentTime.200": {
        "description": "It is used to indicate nonspecific success. The response body contains a representation of the resource.",
YannGarcia's avatar
YannGarcia committed
        "content": {
          "application/json": {
            "schema": {
YannGarcia's avatar
YannGarcia committed
              "$ref": "#/components/schemas/CurrentTime"
YannGarcia's avatar
YannGarcia committed
      "TimingCaps.200": {
        "description": "It is used to indicate nonspecific success. The response body contains a representation of the resource.",
YannGarcia's avatar
YannGarcia committed
        "content": {
YannGarcia's avatar
YannGarcia committed
          "application/json": {
YannGarcia's avatar
YannGarcia committed
            "schema": {
YannGarcia's avatar
YannGarcia committed
              "$ref": "#/components/schemas/TimingCaps"
YannGarcia's avatar
YannGarcia committed
            }
YannGarcia's avatar
YannGarcia committed
          }
        }
      },
      "Transports.200": {
        "description": "It is used to indicate nonspecific success. The response body contains a representation of the resource.",
        "content": {
          "application/json": {
YannGarcia's avatar
YannGarcia committed
            "schema": {
YannGarcia's avatar
YannGarcia committed
              "type": "array",
              "minItems": 0,
              "items": {
                "$ref": "#/components/schemas/TransportInfo"
              }
YannGarcia's avatar
YannGarcia committed
            }
          }
YannGarcia's avatar
YannGarcia committed
        },
        "links": {
          "getTransportInfo": {
            "$ref": "#/components/links/GetTransportInfo"
          }
YannGarcia's avatar
YannGarcia committed
        }
      },
YannGarcia's avatar
YannGarcia committed
      "Error.400": {
        "description": "Bad Request",
YannGarcia's avatar
YannGarcia committed
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/ProblemDetails"
            }
          },
          "text/plain": {
            "schema": {
              "$ref": "#/components/schemas/Empty"
            }
          }
        }
      },
      "Error.403": {
YannGarcia's avatar
YannGarcia committed
        "description": "Forbidden",
YannGarcia's avatar
YannGarcia committed
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/ProblemDetails"
            }
          }
        }
      },
      "Error.404": {
YannGarcia's avatar
YannGarcia committed
        "description": "Not Found",
YannGarcia's avatar
YannGarcia committed
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/ProblemDetails"
            }
          },
          "text/plain": {
            "schema": {
              "$ref": "#/components/schemas/Empty"
            }
          }
        }
YannGarcia's avatar
YannGarcia committed
      },
      "Error.412": {
        "description": "Precondition Failed",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/ProblemDetails"
            }
          },
          "text/plain": {
            "schema": {
              "$ref": "#/components/schemas/Empty"
YannGarcia's avatar
YannGarcia committed
    "requestBodies": {
      "ApplicationsDnsRule": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/DnsRule"
            }
YannGarcia's avatar
YannGarcia committed
          }
YannGarcia's avatar
YannGarcia committed
        },
        "description": "The updated state is included in the entity body of the request.",
        "required": true
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "ApplicationsSubscriptions": {
        "content": {
          "application/json": {
            "schema": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/AppTerminationNotificationSubscription"
                },
                {
                  "$ref": "#/components/schemas/SerAvailabilityNotificationSubscription"
                }
              ]
            }
          }
        },
        "description": "Entity body in the request contains a subscription to the mobile edge application termination notifications that is to be created.",
        "required": true
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "ApplicationsTrafficRule": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/TrafficRule"
            }
          }
        },
        "description": "One or more updated attributes that are allowed to be changed",
        "required": true
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "Services": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ServiceInfo"
            }
          }
        },
        "description": "New ServiceInfo with updated \"state\" is included as entity body of the request",
        "required": true
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "Services.Post": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ServiceInfo.Post"
            }
          }
        },
        "description": "New ServiceInfo with updated \"state\" is included as entity body of the request",
        "required": true
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "ServicesServiceId": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ServiceInfo"
            }
YannGarcia's avatar
YannGarcia committed
          }
YannGarcia's avatar
YannGarcia committed
        },
        "description": "New ServiceInfo with updated \"state\" is included as entity body of the request",
        "required": true
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "AppTerminationNotification": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/AppTerminationNotification"
            }
YannGarcia's avatar
YannGarcia committed
      "ServiceAvailabilityNotification": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ServiceAvailabilityNotification"
            }
YannGarcia's avatar
YannGarcia committed
          }
        }
YannGarcia's avatar
YannGarcia committed
      }
    },
    "callbacks": {
      "AppTerminationNotification": {
        "{$request.body#/callbackReference}": {
          "post": {
            "description": "Represents the information that the MEP notifies the subscribed application instance about the corresponding  application instance termination/stop",
            "operationId": "AppTerminationNotification_POST",
            "tags": [
              "callback"
            ],
            "requestBody": {
              "$ref": "#/components/requestBodies/AppTerminationNotification"
            },
            "responses": {
              "200": {
                "description": "Expected responses from callback consumer, if it accepts the callback"
              }
            }
          }
YannGarcia's avatar
YannGarcia committed
        }
      },
YannGarcia's avatar
YannGarcia committed
      "ServiceAvailabilityNotification": {
        "{$request.body#/callbackReference}": {
          "post": {
            "description": "'Represents the service availability information that  is used in the following cases - when the MEC platform announces the newly available\n services to the authorized relevant MEC applications (e.g. \n the applications that indicate the services as \"optional\" \n or \"required\") that are subscribed to the corresponding \n service availability notifications\n-  when the MEC platform notifies the authorized relevant  applications that are subscribed to the corresponding  service availability notifications about the service availability changes.'",
            "operationId": "ServiceAvailabilityNotification_POST",
            "tags": [
              "callback"
            ],
            "requestBody": {
              "$ref": "#/components/requestBodies/ServiceAvailabilityNotification"
            },
            "responses": {
              "200": {
                "description": "Expected responses from callback consumer, if it accepts the callback"
              }
            }
YannGarcia's avatar
YannGarcia committed
          }
        }
YannGarcia's avatar
YannGarcia committed
      }
    },
    "links": {
      "GetIndividualMeService": {
        "operationId": "ServicesServiceId_GET",
        "description": "The `serviceId` value returned in the response can be used as the `serviceId` parameter in `GET /services/{serviceId}`",
        "parameters": {
          "serviceId": "$response.body#/serviceId"
        }
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "PutIndividualMeService": {
        "operationId": "ServicesServiceId_PUT",
        "description": "The `serviceId` value returned in the response can be used as the `serviceId` parameter in `PUT /services/{serviceId}`",
        "parameters": {
          "serviceId": "$response.body#/serviceId"
        }
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "GetIndividualMeDNSRule": {
        "operationId": "ApplicationsDnsRule_GET",
        "description": "The `dnsRuleId` value returned in the response can be used as the `dnsRuleId` parameter in `GET /applications/{appInstanceId}/dns_rules/{dnsRuleId}`",
        "parameters": {
          "dnsRuleId": "$response.body#/dnsRuleId"
        }
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "PutIndividualMeDNSRule": {
        "operationId": "ApplicationsDnsRule_PUT",
        "description": "The `dnsRuleId` value returned in the response can be used as the `dnsRuleId` parameter in `PUT /applications/{appInstanceId}/dns_rules/{dnsRuleId}`",
        "parameters": {
          "dnsRuleId": "$response.body#/dnsRuleId"
YannGarcia's avatar
YannGarcia committed
        }
      },
YannGarcia's avatar
YannGarcia committed
      "GetIndividualMeTrafficRule": {
        "operationId": "ApplicationsTrafficRule_GET",
        "description": "The `trafficRuleId` value returned in the response can be used as the `trafficRuleId` parameter in `GET /applications/{appInstanceId}/traffic_rules/{trafficRuleId}`",
        "parameters": {
          "trafficRuleId": "$response.body#/trafficRuleId"
YannGarcia's avatar
YannGarcia committed
        }
      },
YannGarcia's avatar
YannGarcia committed
      "PutIndividualMeTrafficRule": {
        "operationId": "ApplicationsTrafficRule_PUT",
        "description": "The `trafficRuleId` value returned in the response can be used as the `trafficRuleId` parameter in `PUT /applications/{appInstanceId}/traffic_rules/{trafficRuleId}`",
        "parameters": {
          "trafficRuleId": "$response.body#/trafficRuleId"
YannGarcia's avatar
YannGarcia committed
        }
      },
YannGarcia's avatar
YannGarcia committed
      "GetTransportInfo": {
        "operationId": "AppServices_POST",
        "description": "The `id` value returned in the response can be used as the `transportId` parameter in `POST /applications/{appInstanceId}/services`. The first transport is provided as the link as wildcards are not supported",
        "parameters": {
          "transportId": "$response.body#/0/id"
YannGarcia's avatar
YannGarcia committed
        }
      },
YannGarcia's avatar
YannGarcia committed
      "GetIndividualMeMp1Subscription": {
        "operationId": "ApplicationsSubscription_GET",
        "description": "The `subscriptionId` value returned in the response can be used as the `subscriptionId` parameter in `GET /applications/{appInstanceId}/subscriptions/{subscriptionType}/{subscriptionId}`",
        "parameters": {
          "description": "regex = \\/mp1\\/v1\\/applications\\/.*\\/subscriptions\\/.*\\/(.*);subscriptionId = href.match(regex)[1];// where \"href\" is an attribute within the subscription attribute within the _links attribute",
          "subscriptionId": "TBC"
        }
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "DelIndividualMeMp1Subscription": {
        "operationId": "ApplicationsSubscription_DELETE",
        "description": "The `subscriptionId` value returned in the response can be used as the `subscriptionId` parameter in `DELETE /applications/{appInstanceId}/subscriptions/{subscriptionType}/{subscriptionId}`",
        "parameters": {
          "description": "regex = \\/mp1\\/v1\\/applications\\/.*\\/subscriptions\\/.*\\/(.*);subscriptionId = href.match(regex)[1];// where \"href\" is an attribute within the subscription attribute within the _links attribute",
          "subscriptionId": "TBC"
        }
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "GetIndividualMeMp1SubscriptionLinkList": {
        "operationId": "ApplicationsSubscription_GET",
        "description": "The `subscriptionId` value returned in the response can be used as the `subscriptionId` parameter in `GET /applications/{appInstanceId}/subscriptions/{subscriptionType}/{subscriptionId}`",
        "parameters": {
          "description": "regex = \\/mp1\\/v1\\/applications\\/.*\\/subscriptions\\/.*\\/(.*);subscriptionId = href.match(regex)[1];// where \"href\" is an attribute within the subscription attribute within the _links attribute",
          "subscriptionId": "TBC"
        }
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "DelIndividualMeMp1SubscriptionLinkList": {
        "operationId": "ApplicationsSubscription_DELETE",
        "description": "The `subscriptionId` value returned in the response can be used as the `subscriptionId` parameter in `DELETE /applications/{appInstanceId}/subscriptions/{subscriptionType}/{subscriptionId}`",
        "parameters": {
          "description": "regex = \\/mp1\\/v1\\/applications\\/.*\\/subscriptions\\/.*\\/(.*);subscriptionId = href.match(regex)[1];// where \"href\" is an attribute within the subscription attribute within the _links attribute",
          "subscriptionId": "TBC"
        }
      }
    },
    "examples": {
      "DnsRule": {
        "value": {
          "dnsRuleId": "DnsRule1",
          "domainName": "www.example.com",
          "ipAddressType": "IP_V4",
          "ipAddress": "146.241.7.3",
          "ttl": 300,
          "state": "ACTIVE"
        }
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "DnsRules": {
        "value": [
          {
            "dnsRuleId": "DnsRule1",
            "domainName": "www.example.com",
            "ipAddressType": "IP_V4",
            "ipAddress": "146.241.7.3",
            "ttl": 300,
            "state": "ACTIVE"
          }
YannGarcia's avatar
YannGarcia committed
        ]
      },
YannGarcia's avatar
YannGarcia committed
      "ServiceInfo": {
        "value": {
          "serInstanceId": "ServiceInstance123",
          "serName": "ExampleService",
          "serCategory": {
            "href": "catItem1",
            "id": "id12345",
            "name": "RNI",
            "version": "version1"
          },
          "version": "ServiceVersion1",
          "state": "ACTIVE",
          "transportInfo": {
            "id": "TransId12345",
            "name": "REST",
            "description": "REST API",
            "type": "REST_HTTP",
            "protocol": "HTTP",
            "version": "2.0",
            "endpoint": {
              "uris": [
                "/meMp1/service/EntryPoint"
              ]
            },
            "security": {
              "oAuth2Info": {
                "grantTypes": [
                  "OAUTH2_CLIENT_CREDENTIALS"
                ],
                "tokenEndpoint": "/meMp1/security/TokenEndPoint"
              }
            }
          },
          "serializer": "JSON"
        }
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "ServiceInfoList": {
        "value": [
          {
            "serInstanceId": "ServiceInstance123",
            "serName": "ExampleService",
            "serCategory": {
              "href": "catItem1",
              "id": "id12345",
              "name": "RNI",
              "version": "version1"
            },
            "version": "ServiceVersion1",
            "state": "ACTIVE",
            "transportInfo": {
              "id": "TransId12345",
              "name": "REST",
              "description": "REST API",
              "type": "REST_HTTP",
              "protocol": "HTTP",
              "version": "2.0",
              "endpoint": {
                "addresses": [
                  {
                    "host": "192.0.2.0",
                    "port": 8080
                  }
                ]
              },
              "security": {
                "oAuth2Info": {
                  "grantTypes": [
                    "OAUTH2_CLIENT_CREDENTIALS"
                  ],
                  "tokenEndpoint": "/meMp1/security/TokenEndPoint"
                }
              }
            },
            "serializer": "JSON"
          }
        ]
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "TrafficRule": {
        "value": {
          "trafficRuleId": "TrafficRule123",
          "serName": "ExampleService",
          "filterType": "FLOW",
          "priority": 1,
          "trafficFilter": [
            {
              "srcAddress": [
                "192.168.2.0/24",
                "192.168.3.0/24"
              ],
              "dstAddress": [
                "192.127.4.100/32"
              ],
              "dstPort": [
                "80"
              ]
            }
          ],
          "action": "FORWARD_DECAPSULATED",
          "dstInterface": {
            "interfaceType": "IP",
            "dstIpAddress": "20.1.1.1"
          },
          "state": "ACTIVE"
        }
YannGarcia's avatar
YannGarcia committed
      },
YannGarcia's avatar
YannGarcia committed
      "TrafficRules": {
        "value": [
          {
            "trafficRuleId": "TrafficRule123",
            "serName": "ExampleService",
            "filterType": "FLOW",
            "priority": 1,
            "trafficFilter": [
              {
                "srcAddress": [
                  "192.168.2.0/24",
                  "192.168.3.0/24"
                ],
                "dstAddress": [
                  "192.127.4.100/32"
                ],
                "dstPort": [
                  "80"
                ]
              }
            ],
            "action": "FORWARD_DECAPSULATED",
            "dstInterface": {
              "interfaceType": "IP",
              "dstIpAddress": "20.1.1.1"
            },
            "state": "ACTIVE"
          }
        ]