Autogenerated openapi version v030101 (21f7931a) · Commits · MEC - Multi-access Edge Computing / Application package lifecycle and operation granting API

MEC01002_AppGrant.yaml

+8 −14

Original line number	Diff line number	Diff line
		@@ -197,6 +197,8 @@ components:
		type: string
		operation:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'The lifecycle management operation for which granting is requested:

		INSTANTIATE.
		@@ -207,8 +209,6 @@ components:


		See notes 1 and 2.'
		enum:
		- SEE_DESCRIPTION
		addResources:
		description: List of resource definitions in the AppD for resources to be added by the LCM operation which is related to this grant request, with one entry per resource.
		type: array
		@@ -254,6 +254,8 @@ components:
		type: string
		type:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Type of the resource definition referenced.

		Permitted values:
		@@ -265,8 +267,6 @@ components:
		LINKPORT

		OSCONTAINER, see note.'
		enum:
		- SEE_DESCRIPTION
		vduId:
		description: 'Reference to the related VDU in the AppD applicable to this resource.

		@@ -486,7 +486,6 @@ components:
		resourceHandle:
		description: Reference to the virtualised resource realizing this link port.
		$ref: '#/components/schemas/ResourceHandle'
		type: object
		required:
		- id
		- resourceHandle
		@@ -567,6 +566,8 @@ components:
		properties:
		layerProtocol:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Identifier of layer(s) and protocol(s).


		@@ -574,12 +575,9 @@ components:


		See note.'
		enum:
		- SEE_DESCRIPTION
		ipOverEthernet:
		description: Network address data for IP over Ethernet to assign to the extCP instance. Shall be present if layerProtocol is equal to "IP_OVER_ETHERNET", and shall be absent otherwise.
		$ref: '#/components/schemas/IpOverEthernetAddressData'
		type: object
		required:
		- layerProtocol
		description: "\|-\n NOTE:\tThis attribute allows to signal the addition of further types of layer and protocol in future versions of the present document in a backwards-compatible way. In the current version of the present document, only IP over Ethernet is supported."
		@@ -645,11 +643,9 @@ components:
		appLcmOpOcc:
		description: Related lifecycle management operation occurrence.
		$ref: '#/components/schemas/LinkType'
		type: object
		appInstance:
		description: Related application instance.
		$ref: '#/components/schemas/LinkType'
		type: object
		required:
		- appLcmOpOcc
		- appInstance
		@@ -664,7 +660,6 @@ components:
		vimConnectionInfo:
		description: Specifies the connection information of VIM for the resources of the application instance.
		$ref: '#/components/schemas/VimConnectionInfo'
		type: object
		resourceId:
		description: Identifier of the resource in the scope of the VIM.
		type: string
		@@ -705,16 +700,15 @@ components:

		If this attribute is not present, no IP address shall be assigned. See note 1.'
		type: object
		minItems: 0
		properties:
		type:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'The type of the IP addresses.


		Permitted values: IPV4, IPV6.'
		enum:
		- SEE_DESCRIPTION
		fixedAddresses:
		description: Fixed addresses to assign (from the subnet defined by "subnetId" if provided). See note 2.
		type: array

MEC01002_AppLcm.yaml

+45 −109

File changed.

Preview size limit exceeded, changes collapsed.

MEC01002_AppPkgMgmt.yaml

+40 −73

Original line number	Diff line number	Diff line
		@@ -162,7 +162,7 @@ paths:
		$ref: '#/components/responses/429'
		/app_packages/{appPkgId}:
		post:
		summary: Notify application package on boarding or change.
		summary: Delivers a notification from the application lifecycle management resource to the subscriber.
		description: The POST method delivers a notification from the application package management resource in MEO or MEAO to the subscriber.
		operationId: UserdefinednotificationPOST
		tags:
		@@ -356,7 +356,7 @@ paths:
		post:
		summary: Callback POST used to send a notification
		description: Subscription notification
		operationId: notificationPOST
		operationId: notificationPOST290025
		requestBody:
		description: Subscription notification
		required: true
		@@ -464,7 +464,7 @@ paths:
		type: string
		/user_defined_notification:
		post:
		summary: Notify application package on boarding or change.
		summary: Delivers a notification from the application lifecycle management resource to the subscriber.
		description: The POST method delivers a notification from the application package management resource in MEO or MEAO to the subscriber.
		operationId: UserdefinednotificationPOST
		tags:
		@@ -752,8 +752,6 @@ paths:
		type: string
		components:
		schemas:
		Not_specified:
		type: object
		ProblemDetails:
		type: object
		properties:
		@@ -1591,7 +1589,6 @@ components:
		virtualComputeDescriptor:
		description: Describes CPU and memory requirements, as well as optional additional requirements, such as disk and acceleration related capabilities, of the single VM used to realize this MEC application. See note 5.
		$ref: '#/components/schemas/VirtualComputeDescriptor'
		type: object
		osContainerDescriptor:
		description: 'Describes CPU, memory requirements and limits, and software images of the OS Containers realizing this MEC application corresponding to OS Containers sharing the same host and same network namespace.

		@@ -1673,30 +1670,24 @@ components:
		appLatency:
		description: Describes the maximum latency tolerated by the MEC application.
		$ref: '#/components/schemas/LatencyDescriptor'
		type: object
		terminateAppInstanceOpConfig:
		description: Configuration parameters for the Terminate application instance operation.
		$ref: '#/components/schemas/TerminateAppInstanceOpConfig'
		type: object
		changeAppInstanceStateOpConfig:
		description: Configuration parameters for the change application instance state operation.
		$ref: '#/components/schemas/ChangeAppInstanceStateOpConfig'
		type: object
		userContextTransferCapability:
		description: If the application supports the user context transfer capability, this attribute shall be included.
		$ref: '#/components/schemas/UserContextTransferCapability'
		type: object
		appNetworkPolicy:
		description: If present, it represents the application network policy of carrying the application traffic.
		$ref: '#/components/schemas/AppNetworkPolicy'
		type: object
		mciopId:
		description: Identifies the MCIOP in the application package, used in containerized workload management, when the application is realized by a set of OS containers. See note 7.
		type: string
		mcioIdentificationData:
		description: Name and type of the Managed Container Infrastructure Object (MCIO) that realizes this application. It allows the VNFM to identify the MCIO e.g. when querying the Container Infrastructure Service Management (CISM). See note 7. It shall be present when the application is realized by one or a set of OS containers and shall be absent otherwise.
		$ref: '#/components/schemas/McioIdentificationData'
		type: object
		logicalNode:
		description: 'The logical node requirements.

		@@ -1760,7 +1751,6 @@ components:
		serCategory:
		description: A Category reference of the service, defined in ETSI GS MEC 011 [17].
		$ref: '#/components/schemas/CategoryRef'
		type: object
		version:
		description: The version of the service.
		type: string
		@@ -1793,11 +1783,11 @@ components:
		type: string
		filterType:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Definition of filter type: per FLOW or PACKET

		If it is per FLOW, the filter matches upstream (e.g. UE->EPC) packets and downstream (e.g. EPC->UE) packets are handled by the same context.'
		enum:
		- SEE_DESCRIPTION
		priority:
		description: "Priority of this traffic rule within the range 0 to 255. If traffic rule conflicts, the one with higher priority take precedence. See note\_1."
		type: integer
		@@ -1809,6 +1799,8 @@ components:
		$ref: '#/components/schemas/TrafficFilter'
		action:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Identifies the action of the MEC host data plane, when a packet matches the trafficFilter, the example actions include:

		DROP,
		@@ -1822,12 +1814,9 @@ components:
		DUPLICATE_DECAPSULATED,

		DUPLICATE_ENCAPSULATED '
		enum:
		- SEE_DESCRIPTION
		dstInterface:
		description: Describes the destination interface information. If the action is FORWARD_DECAPSULATED, FORWARD_ENCAPSULATED or PASSTHROUGH, one value shall be provided. If the action is DUPLICATE_DECAPSULATED or DUPLICATE_ENCAPSULATED, two values shall be provided. See note 2. If the action is DROP, no value shall be provided.
		$ref: '#/components/schemas/InterfaceDescriptor'
		type: object
		required:
		- trafficRuleId
		- filterType
		@@ -1934,13 +1923,12 @@ components:
		properties:
		interfaceType:
		type: string
		description: 'Type of interface: TUNNEL, MAC, IP, etc.'
		enum:
		- SEE_DESCRIPTION
		description: 'Type of interface: TUNNEL, MAC, IP, etc.'
		tunnelInfo:
		description: Included only if the destination address type is tunnel.
		$ref: '#/components/schemas/TunnelInfo'
		type: object
		srcMACAddress:
		description: If the interface type is MAC, the source address identifies the MAC address of the interface.
		type: string
		@@ -1958,9 +1946,9 @@ components:
		properties:
		tunnelType:
		type: string
		description: 'Type of tunnel: GTP-U, GRE, etc.'
		enum:
		- SEE_DESCRIPTION
		description: 'Type of tunnel: GTP-U, GRE, etc.'
		tunnelDstAddress:
		description: Destination address of the tunnel.
		type: string
		@@ -1986,9 +1974,9 @@ components:
		type: string
		ipAddressType:
		type: string
		description: 'Specifies the IP address type, value: IP_V6, IP_V4'
		enum:
		- SEE_DESCRIPTION
		- IP_V4
		description: 'Specifies the IP address type, value: IP_V6, IP_V4'
		ipAddress:
		description: IP address given by the DNS rule
		type: string
		@@ -2021,7 +2009,6 @@ components:
		serCategory:
		description: A Category reference of the service.
		$ref: '#/components/schemas/CategoryRef'
		type: object
		version:
		description: The version of the service.
		type: string
		@@ -2050,7 +2037,6 @@ components:
		transport:
		description: Information about the transport in this transport binding.
		$ref: '#/components/schemas/TransportDescriptor'
		type: object
		serializers:
		description: Information about the serializers in this transport binding, as defined in the SerializerType type in ETSI GS MEC 011 [17]. Support for at least one of the entries is required in conjunction with the transport.
		type: array
		@@ -2080,7 +2066,6 @@ components:
		type:
		description: Type of the transport, as defined in the TransportTypes type in ETSI GS MEC 011 [17].
		$ref: '#/components/schemas/TransportTypes'
		type: object
		protocol:
		description: The name of the protocol used. Shall be set to "HTTP" for a REST API.
		type: string
		@@ -2090,7 +2075,6 @@ components:
		security:
		description: Information about the security used by the transport in ETSI GS MEC 011 [17].
		$ref: '#/components/schemas/SecurityInfo'
		type: object
		implSpecificInfo:
		description: Additional implementation specific details of the transport.
		type: object
		@@ -2146,7 +2130,6 @@ components:
		checksum:
		description: Checksum of the onboarded application package.
		$ref: '#/components/schemas/Checksum'
		type: object
		userDefinedData:
		description: User defined data for the application package.
		type: object
		@@ -2187,7 +2170,6 @@ components:
		checksum:
		description: Checksum of the onboarded application package.
		$ref: '#/components/schemas/Checksum'
		type: object
		signingCertificate:
		description: The singleton signing certificate if it is included as a file in the AppD archive.
		type: string
		@@ -2205,6 +2187,8 @@ components:
		$ref: '#/components/schemas/AppPkgArtifactInfo'
		onboardingState:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Onboarding state of application package:

		CREATED: The application package resource has been created.
		@@ -2214,26 +2198,24 @@ components:
		PROCESSING: The associated application package content is being processed, e.g. validation.

		ONBOARDED: The associated application package content is successfully onboarded.'
		enum:
		- SEE_DESCRIPTION
		operationalState:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Operational state of the onboarded application package:

		ENABLED: the application package can be used for instantiation of new application instances.

		DISABLED: the application package cannot be used for further application instantiation requests.'
		enum:
		- SEE_DESCRIPTION
		usageState:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Usage state of the onboarded instance of the application package:

		IN_USE: application instances instantiated from this package exist.

		NOT_IN_USE: No application instance instantiated from this package exist.'
		enum:
		- SEE_DESCRIPTION
		mecInfo:
		description: The MEC version that compatible with this application. This information is copied from the AppD.
		type: array
		@@ -2246,7 +2228,6 @@ components:
		onboardingFailureDetails:
		description: Failure details of current onboarding procedure. See ETSI GS MEC 009 [4].
		$ref: '#/components/schemas/ProblemDetails'
		type: object
		_links:
		$ref: '#/components/schemas/_links'
		required:
		@@ -2273,7 +2254,6 @@ components:
		subscriptionType:
		description: Type of subscription.
		$ref: '#/components/schemas/AppPkgSubscriptionType'
		type: object
		callbackUri:
		description: The URI of the endpoint for the subscription related notification to be sent to.
		type: string
		@@ -2317,7 +2297,6 @@ components:
		timeStamp:
		description: Date and time of the notification generation.
		$ref: '#/components/schemas/TimeStamp'
		type: object
		appPkgId:
		description: Identifier of the onboarded application package.
		type: string
		@@ -2326,13 +2305,13 @@ components:
		type: string
		operationalState:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Operational state of the application package:

		ENABLED: the application package can be used for instantiation of new application instances.

		DISABLED: the application package cannot be used for further application instantiation requests.'
		enum:
		- SEE_DESCRIPTION
		_links:
		$ref: '#/components/schemas/_links3'
		required:
		@@ -2355,7 +2334,6 @@ components:
		subscriptionType:
		description: Type of the subscription.
		$ref: '#/components/schemas/AppPkgSubscriptionType'
		type: object
		appPkgFilter:
		description: The attribute-based filter is to filter application packages on which the query applies.
		type: array
		@@ -2371,9 +2349,9 @@ components:
		properties:
		operationalState:
		type: string
		description: "New value of the \"operationalState\" attribute of the \"OnboardedAppPkgInfo\" structure.\n\nPermitted values \nDISABLED: to disable the individual application package.\nENABLED: to enable the individual application package."
		enum:
		- SEE_DESCRIPTION
		description: "New value of the \"operationalState\" attribute of the \"OnboardedAppPkgInfo\" structure.\n\nPermitted values \nDISABLED: to disable the individual application package.\nENABLED: to enable the individual application package."
		required:
		- operationalState
		AppPkgFilter:
		@@ -2400,6 +2378,8 @@ components:
		type: string
		operationalState:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Match particular operational state of the application package:

		ENABLED: the application package can be used for instantiation of new application instances.
		@@ -2408,10 +2388,10 @@ components:


		May be present if the "subscriptionType" attribute contains the value "AppPackageChangeSubscription", and shall be absent otherwise.'
		enum:
		- SEE_DESCRIPTION
		usageState:
		type: string
		enum:
		- SEE_DESCRIPTION
		description: 'Match particular usage state of the application package:

		IN_USE: application instances instantiated from this package exist.
		@@ -2420,8 +2400,6 @@ components:


		May be present if the "subscriptionType" attribute contains the value "AppPackageChangeSubscription", and shall be absent otherwise.'
		enum:
		- SEE_DESCRIPTION
		description: "\|-\n NOTE:\tThe attributes \"appPkgInfoId \", and \"appDId\" are alternatives to reference particular application package in a filter. They should not be used both in the same filter instance, but one alternative should be chosen."
		LinkType:
		x-etsi-ref: 6.2.5.2
		@@ -2464,12 +2442,10 @@ components:
		TransportsSupported:
		description: Indicates transports and serialization formats supported made available to the service-consuming application. Defaults to REST + JSON if absent.
		type: object
		minItems: 0
		properties:
		transport:
		description: Information about the transport in this binding.
		$ref: '#/components/schemas/TransportDescriptor'
		type: object
		serializers:
		description: "Information about the serializers in this binding, as defined in the SerializerType type in ETSI GS\_MEC\_011\_[17]."
		type: array
		@@ -2501,19 +2477,15 @@ components:
		self:
		description: Self referring URI.
		$ref: '#/components/schemas/LinkType'
		type: object
		appD:
		description: Link to the appD resource.
		$ref: '#/components/schemas/LinkType'
		type: object
		appPkgContent:
		description: Link to the "Onboarded application package content" resource.
		$ref: '#/components/schemas/LinkType'
		type: object
		vnfPkgInfo:
		description: Link to the corresponding VNF package resource at NFVO. See note 3.
		$ref: '#/components/schemas/LinkType'
		type: object
		required:
		- self
		- appD
		@@ -2525,13 +2497,11 @@ components:
		self:
		description: URI of this resource.
		$ref: '#/components/schemas/LinkType'
		type: object
		required:
		- self
		Subscriptions:
		description: A link list to the subscriptions to an application package.
		type: object
		minItems: 0
		properties:
		href:
		description: The URI referring to the subscription.
		@@ -2540,7 +2510,6 @@ components:
		subscriptionType:
		description: Type of the subscription.
		$ref: '#/components/schemas/AppPkgSubscriptionType'
		type: object
		required:
		- href
		- subscriptionType
		@@ -2551,7 +2520,6 @@ components:
		self:
		description: URI of this resource.
		$ref: '#/components/schemas/LinkType'
		type: object
		subscriptions:
		type: array
		items:
		@@ -2565,7 +2533,6 @@ components:
		subscription:
		description: A link to the related subscription.
		$ref: '#/components/schemas/LinkType'
		type: object
		required:
		- subscription
		responses: