MecAppSupportApi.json 113 KB
Newer Older
3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090 3091 3092 3093 3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 3131 3132 3133 3134 3135 3136 3137 3138 3139 3140 3141 3142 3143 3144 3145 3146 3147 3148 3149 3150 3151 3152 3153 3154 3155 3156 3157 3158 3159 3160 3161 3162 3163 3164 3165 3166 3167 3168 3169 3170 3171 3172 3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230 3231 3232 3233 3234 3235 3236 3237 3238 3239 3240 3241 3242 3243 3244 3245 3246 3247 3248 3249 3250 3251 3252 3253 3254 3255 3256 3257 3258 3259 3260 3261 3262 3263 3264 3265 3266 3267 3268 3269 3270 3271 3272 3273 3274 3275 3276 3277 3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296 3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 3312 3313 3314 3315 3316 3317 3318 3319 3320 3321 3322 3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396 3397
      "EndPointInfo.Address": {
        "title": "EndPointInfo.Address",
        "required": [
          "host",
          "port"
        ],
        "type": "object",
        "properties": {
          "host": {
            "type": "string",
            "description": "Host portion of the address",
            "examples": [
              "192.0.2.0"
            ]
          },
          "port": {
            "type": "integer",
            "description": "Port portion of the address",
            "contentEncoding": "int32",
            "examples": [
              8080
            ]
          }
        },
        "description": "A IP address and port pair"
      },
      "EndPointInfo.Addresses": {
        "title": "EndPointInfo.Addresses",
        "required": [
          "addresses"
        ],
        "type": "object",
        "properties": {
          "addresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EndPointInfo.Address"
            },
            "description": "Entry point information of the service as one or more pairs of IP address and port. See note."
          }
        },
        "description": "This type represents information about a transport endpoint."
      },
      "EndPointInfo.Alternative": {
        "title": "EndPointInfo.Alternative",
        "required": [
          "alternative"
        ],
        "type": "object",
        "properties": {
          "alternative": {
            "type": "object",
            "description": "Entry point information of the service in a format defined by an implementation, or in an external specification. See note."
          }
        },
        "description": "This type represents information about a transport endpoint."
      },
      "EndPointInfo.Uris": {
        "title": "EndPointInfo.Uris",
        "required": [
          "uris"
        ],
        "type": "object",
        "properties": {
          "uris": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Entry point information of the service as string, formatted according to URI syntax"
          }
        },
        "description": "This type represents information about a transport endpoint."
      },
      "EndPointInfo.Fqdn": {
        "title": "EndPointInfo.Fqdn",
        "required": [
          "fqdn"
        ],
        "type": "object",
        "properties": {
          "fqdn": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Fully Qualified Domain Name of the service. See note."
          }
        },
        "description": "This type represents information about a transport endpoint. "
      },
      "ServiceDependency": {
        "properties": {
          "requestedPermissions": {
            "description": "Requested permissions regarding the access of the application to the service. See clause 8.2 of ETSI GS MEC 009 [4].\nThe format of this attribute is left for the data model design stage.",
            "items": {
              "$ref": "#/components/schemas/Not_specified"
            },
            "minItems": 0,
            "type": "array"
          },
          "serCategory": {
            "$ref": "#/components/schemas/CategoryRef"
          },
          "serName": {
            "description": "The name of the service, for example, RNIS, LocationService, etc.",
            "type": "string"
          },
          "serTransportDependencies": {
            "description": "Indicates transport and serialization format dependencies of consuming the service. Defaults to REST + JSON if absent. See note.",
            "items": {
              "$ref": "#/components/schemas/TransportDependency"
            },
            "minItems": 0,
            "type": "array"
          },
          "version": {
            "description": "The version of the service.",
            "type": "string"
          }
        },
        "required": [
          "serName",
          "version"
        ],
        "type": "object",
        "x-etsi-notes": "NOTE:\tThis attribute indicates groups of transport bindings that a service-consuming MEC application supports for the consumption of the MEC service defined by this ServiceDependency structure. If at least one of the indicated groups is supported by the service it may be consumed by the application."
      },
      "TransportDependency": {
        "properties": {
          "labels": {
            "description": "Set of labels that allow to define groups of transport bindings. The mechanism of the grouping is defined below this table.",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "serializers": {
            "description": "Information about the serializers in this transport binding, as defined in the SerializerType type in ETSI GS MEC 011 [i.4]. Support for at least one of the entries is required in conjunction with the transport.",
            "items": {
              "$ref": "#/components/schemas/SerializerType"
            },
            "minItems": 1,
            "type": "array"
          },
          "transport": {
            "$ref": "#/components/schemas/TransportDescriptor"
          }
        },
        "required": [
          "transport",
          "serializers",
          "labels"
        ],
        "type": "object"
      },
      "TransportDescriptor": {
        "properties": {
          "protocol": {
            "description": "The name of the protocol used. Shall be set to \"HTTP\" for a REST API.",
            "type": "string"
          },
          "security": {
            "$ref": "#/components/schemas/SecurityInfo"
          },
          "type": {
            "$ref": "#/components/schemas/TransportType"
          },
          "version": {
            "description": "The version of the protocol used.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "protocol",
          "version",
          "security"
        ],
        "type": "object"
      },
      "SerializerType": {
        "title": "SerializerType",
        "enum": [
          "JSON",
          "XML",
          "PROTOBUF3"
        ],
        "type": "string",
        "description": "The enumeration represents types of serializers",
        "examples": [
          "JSON"
        ]
      },
      "SecurityInfo": {
        "title": "SecurityInfo",
        "type": "object",
        "properties": {
          "oAuth2Info": {
            "$ref": "#/components/schemas/SecurityInfo.OAuth2Info"
          }
        },
        "description": "This type represents security information related to a transport"
      },
      "SecurityInfo.OAuth2Info": {
        "title": "SecurityInfo.OAuth2Info",
        "required": [
          "grantTypes",
          "tokenEndpoint"
        ],
        "type": "object",
        "properties": {
          "grantTypes": {
            "maxItems": 4,
            "minItems": 1,
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SecurityInfo.OAuth2Info.GrantType"
            },
            "description": "List of supported OAuth 2.0 grant types."
          },
          "tokenEndpoint": {
            "type": "string",
            "description": "The token endpoint",
            "examples": [
              "/mecSerMgmtApi/security/TokenEndPoint"
            ]
          }
        },
        "description": "Parameters related to use of OAuth 2.0"
      },
      "SecurityInfo.OAuth2Info.GrantType": {
        "title": "SecurityInfo.OAuth2Info.GrantType",
        "enum": [
          "OAUTH2_AUTHORIZATION_CODE",
          "OAUTH2_IMPLICIT_GRANT",
          "OAUTH2_RESOURCE_OWNER",
          "OAUTH2_CLIENT_CREDENTIALS"
        ],
        "type": "string",
        "description": "OAuth 2.0 grant type",
        "examples": [
          "OAUTH2_CLIENT_CREDENTIALS"
        ]
      },
      "TransportType": {
        "title": "TransportType",
        "enum": [
          "REST_HTTP",
          "MB_TOPIC_BASED",
          "MB_ROUTING",
          "MB_PUBSUB",
          "RPC",
          "RPC_STREAMING",
          "WEBSOCKET"
        ],
        "type": "string",
        "description": "The enumeration TransportType represents types of transports",
        "examples": [
          "REST_HTTP"
        ]
      },
      "FeatureDependency": {
        "properties": {
          "featureName": {
            "description": "The name of the feature, for example, UserApps, UEIdentity, etc.",
            "type": "string"
          },
          "version": {
            "description": "The version of the feature.",
            "type": "string"
          }
        },
        "required": [
          "featureName",
          "version"
        ],
        "type": "object"
      },
      "AppProfile": {
        "type": "object",
        "required": [
          "easId",
          "endPt",
          "acIds",
          "scheds",
          "permLvl",
          "easFeats",
          "svcContSupp",
          "appLocs"
        ],
        "properties": {
          "easId": {
            "description": "The identifier of the EAS",
            "type": "string",
            "examples": [
              "appName"
            ]
          },
          "endPt": {
            "description": "The version of the feature.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/EndPointInfo.Uris"
              },
              {
                "$ref": "#/components/schemas/EndPointInfo.Fqdn"
              },
              {
                "$ref": "#/components/schemas/EndPointInfo.Addresses"
              },
              {
                "$ref": "#/components/schemas/EndPointInfo.Alternative"
              }
            ]
          },
          "acIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "description": "Identities of the Application Clients that can be served by the EAS"
          },
          "provId": {
            "type": "string",
            "description": "Identifier of the ASP that provides the EAS.",
            "examples": [
              "appProvider1"
            ]
          },
          "type": {
            "description": "The category or type of EAS.",
            "type": "string"
          },
          "scheds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "description": "The availability schedule of the EAS."
          },
          "svcArea": {
            "type": "string",
            "description": "The list of geographical and topological areas that the EAS serves. ACs in the UE that are outside the area will not be served."
          },
          "svcKpi": {
            "type": "string",
            "description": "Service characteristics provided by the EAS."
          },
          "permLvl": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "description": "level of service permissions supported by the EAS."
          },
          "easFeats": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "description": "Service features supported by the EAS."
          },
          "svcContSupp": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "description": "The ACR scenarios supported by the EAS for service continuity."
          },
          "appLocs": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "description": "List of DNAI(s) and the N6 traffic information associated with the EAS."
          },
          "avlRep": {
            "type": "integer",
            "description": "The period indicating to the EES, how often the EES needs to check the EAS's availability after a successful registration.",
            "contentEncoding": "int32",
            "examples": [
              1577836800
            ]
          },
          "status": {
            "type": "string",
            "description": "EAS status information. "
          }
        }
      }
    },
    "requestBodies": {
      "AppTerminationNotification": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/AppTerminationNotification"
            }
          }
Walter Featherstone's avatar
Walter Featherstone committed
        },
        "required": true
  },
  "security": [