Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

1.API NameOnboard ApplicationType : POST Interface : MM3
DescriptionThis API is for MEO to onboard package, currently we just upload package directly to MEPM-APPLCM in the rest request, appPkgPath is of no use

Resource URI/ealtedge/mepm/app_pkgm/v1/app_packages/
Request Parameters
NameCardinalityTypeDescription
CreateAppPkg1Complex
Response Codes201 : Created
Response Parameters
Parameter NameCardinalityTypeDescription
AppPkgInfo0..NComplexIndicates a successful request. The response body shall contain a representation of the application package resource.

...

1.API NameCreate Application InstanceType : POST Interface : MM3
DescriptionThis API is for MEO to onboard package, currently we just upload package directly to MEPM-APPLCM in the rest request, appPkgPath is of no use

Resource URI/ealtedge/mepm/app_lcm/v1/app_instances
Request Body Parameters
Parameter NameCardinalityTypeDescription

appDId

1StringApplication Description ID
appInstancename1StringApplication Instance Name

appInstanceDescriptor

1StringApplication Instance Descriptor
Response Codes201
Response Parameters
Parameter NameCardinalityTypeDescription
AppInstanceInfo1ComplexApplication Instance Info

...

2.API Name / CategoryApplication Instance Info Type : GETInterface : MM3
DescriptionThis API is for MEO to onboard package, currently we just upload package directly to MEPM-APPLCM in the rest request, appPkgPath is of no use

Resource URI/ealtedge/mepm/app_lcm/v1/app_instances/{appInstanceId}
Request Body Parameters - None

Response Codes201
Response Parameters
Parameter NameCardinalityTypeDescription / Example
AppInstanceInfo1ComplexApplication Instance Info

...

4.API Name: Instantiate ApplicationType : POST 

Interface : MM3

OSS→ MEO, MEO->MEPM

DescriptionTo instantiate the application instance
Resource URI/ealtedge/mepm/app_lcm/v1/app_instances/{appInstanceId}/instantiate 
Request Body Parameters
Attribute NameCardinalityTypeDescription

InstantiateAppRequest

1ComplexRequest parameters of the "Instantiate Application" operation

Response Codes202 -  Accepted. The request was accepted for processing, but the processing has not yet been completed
Response Parameters - Response Body is Empty

...

5.API Name: Terminate ApplicationType : POST 

Interface : MM3 (OSS→ MEO, MEO->MEPM)

DescriptionTo instantiate the application instance
Resource URI/ealtedge/mepm/app_lcm/v1/app_instances/{appInstanceId}/terminate
Request Body Parameters
NameCardinalityTypeDescription

TerminateAppRequest          TerminateAppRequest                     

1Complex

Response Codes202 -  Accepted. The request was accepted for processing, but the processing has not yet been completed
Response Parameters - Response Body is Empty

...

AppPkgInfo Parameters

Attribute NameCardinalityData TypeDescription  
ID1StringID
AppDID1StringApplication Development ID
AppProvider0..1String

Application Provider.

Ex : Huawei

AppName1StringApplication Name. Ex : Face Recognition                                     
AppSoftwareVersion1StringApplication Software Version. Ex : 1.0
AppDVersion1StringApplication Deployment Version. Ex: 1.0
OnboardingState1StringOn Boarding State. Ex : ONBOARDED
DeployType1StringDeploy Type ; Ex : Helm
AppPackage1StringApplication Package

CreateAppPkg
Anchor
CreateAppPkg
CreateAppPkg

CreateAppPkg Parameters

Attribute NameCardinalityData TypeDescription
appPkgName1StringApplication Package Name  to be onboarded
appPkgVersion1StringApplication Package Version  to be onboarded

appProvider

0..1StringThe provider's name of the application package to be onboarded.
checksumchecksumchecksumChecksum of the onboarded application package
userDefinedData0..1KeyValuePairUser defined data for the application package.
appPkgPath1StringAddress information of the application package Currently not in use

ApplnstanceInfo
Anchor
ApplnstanceInfo
ApplnstanceInfo

ApplnstanceInfo Parameters

Attribute NameCardinalityData TypeDescription
ID1String

Application Instance Description

Ex : ID1

AppInstanceName0..1StringApplication Descriptor ID
AppInstanceDescription0..1String

Application Provider

Ex: Huawei

AppDID1String

Application Name 

Ex : Face_Recognition.

AppProvider1String
AppName1StringDeploy Type ; Ex : Helm
AppSoftVersion1String

Application Package ID

Ex: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177

AppDVersion1String

Instantiation State.

Ex : NOT_INSTANTIATED

InstantiateAppRequest
Anchor
InstantiateAppRequest
InstantiateAppRequest

InstantiateAppRequest Parameters
Attribute NameCardinalityData TypeDescription
selectedMECHostInfo1..NMECHostInformation

Describes the information of selected host for the application instance


TerminateAppRequest
Anchor
TerminateAppRequest
TerminateAppRequest

TerminateAppRequest Parameters

Attribute NameCardinalityData TypeDescription
terminationType1Enum

Indicates whether forceful or graceful termination is
requested. See note.
• FORCEFUL: it will shut down the application
instance and release the resources immediately
after accepting the request. See note.
• GRACEFUL: it will first arrange to take the
application instance out of service after
accepting the request. Once the operation of
taking the application instance out of service
finishes or once the timer value specified in the
"gracefulTerminationTimeout" attribute expires,
it will shut down the application instance and
release the resources.

gracefulTerminationTimeout0..1IntegerThis attribute is only applicable in case of graceful
termination. It defines the time to wait for the
application instance to be taken out of service before
shutting down the application and releasing the
resources.
The unit is seconds.
If not given and the "terminationType" attribute is set to
"GRACEFUL", it is expected to wait for the successful
taking out of service of the application, no matter how
long it takes, before shutting down the application and
releasing the resources.

...