Versions Compared

Key

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

Table of Contents

VNFM

VNFM registration (Update VNFM)

Interface DefinitionDescription
URI/onapapiapi/aai/esr-vnfm/v1/vnfms/vnfm/{vnfmId}
Operation TypePUT

Request Parameters:

AttributeQualifierCardinalityContentDescription
vnfmIdO0..1StringVNFM UUID generated by ESR
nameM1StringVNFM name
typeM1StringVNFM type
vimIdO0..1StringRelated VIM
vendorM1StringVNFM vendor
versionM1StringVNFM version
descriptionO0..1StringVNFM description
certificateUrlO0..1Stringcertificate url
urlM1StringAccess url
userNameO0..1StringUser name
passwordO0..1StringPassword

Request Sample:
/onapapiapi/aai-vnfm/esr/v1/vnfms/vnfm/19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee

   {
       "vnfmId":"19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee",

...

Errorcode: 500 Internal Server Error

Get VNFM

...

Interface DefinitionDescription
URI/onapapiapi/aai-vnfm/esr/v1/vnfms/vnfm/{vnfmId}
Operation TypeGET

Request Parameters:

...

Interface DefinitionDescription
URI/onapapiapi/aai/esr-vnfm/v1/vnfms
Operation TypeGET

Request Parameters:
N/A

...

 [
       {
           "vnfmId":"19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee",
           "name":"vnfm",
           "type":"Tacker",
           "vimId":"",
           "vendor":"ZTE",
           "version":"v1.0",
           "description":"vnfm",
           "certificateUrl":"",
           "url":"http://10.74.44.11",
           "userName":"admin",
           "password":"admin"
       }
   ]

...

Delete VNFM

Interface DefinitionDescription
URI/onapapiapi/aai-vnfm/esr/v1/vnfms/vnfm/{vnfmId}
Operation TypePUTDELETE

Request Parameters:

AttributeQualifierCardinalityContentDescription
vnfmIdM1StringVNFM identifier

Request Sample:
/api/aai-vnfm/v1/vnfms/vnfm/19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee

Response:

Success Code: 204

Errorcode: 500 Internal Server Error

VIM

VIM registration(Update VIM)

Interface DefinitionDescription
URI

/api/aai-cloudInfrastructure/v1/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}

Operation TypePUT

Request Body:

AttributeQualifierCardinalityContentDescription
cloud-ownerM1StringCloud owner
cloud-regionIdM1StringCloud region
auth-infoM1ObjAuth information of Cloud

authInfo:

AttributeQualifierCardinalityContentDescription
urlM1StringAccess url
userNameM1
nameO0..1StringVNFM name
vendorO0..1StringVNFM vendor
urlO0..1StringAccess url
userNameO0..1StringUser name
passwordOM0..1StringPassword
tenantM1StringTenant name
domainO0..1StringDomain
vendorM1StringVIM vendor
versionM1StringVIM version
typeM1StringVIM type

Request Sample:
/api/aai-cloudInfrastructure/v1/cloud-regions/cloud-region/owner/region-oneRequest Sample:
/onapapi/aai/esr/v1/vnfms/19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee

   {
       "vnfmIdcloud-owner":"19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee",
"owner",
       "namecloud-region":"vnfmregion-one",

       "vendorauthInfo": {
"ZTE",
       "url":"http://10.74.44.11.151.13:5000/v2.0",
       "userName":"admin",
       "password":"admin",
   }

Response Parameters:

Success Code: 201

Errorcode: 500 Internal Server Error

...

    "tenant":"admin",
       "domain":"",
       "vendor":"ZTE",
       "version":"v1.0",
       "type":"openstack"
       }
   }

Response:

Success Code: 201

Errorcode: 500 Internal Server Error

Get VIM

Interface DefinitionDescription
URI

/

onapapi

api/aai

/esr/v1/vnfms/{vnfmId

-cloudInfrastructure/v1/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}

Operation TypeDELETEGET

Request Parameters:

vnfmIdVNFM identifier
AttributeQualifierCardinalityContentDescription
cloudOwnerM1StringCloud owner
cloudRegionIdM1StringCloud region

Request Sample:
/onapapiapi/aai-cloudInfrastructure/esr/v1/vnfmscloud-regions/19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee

Response:

Success Code: 204

Errorcode: 500 Internal Server Error

VIM

...

cloud-region/owner/region-one

Response Parameters:

VIM

Get all VIM

Interface DefinitionDescription
URI/api/aai-cloudInfrastructure/v1/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}
Operation TypePUTGET

Request BodyParameters:

...

N/A

Request Sample:
/onapapi/aai/esr/v1/vims

Response Parameters:
List<VIM>

Response Sample:

Success Code: 201  
 [
       {
       "cloud-owner":"owner",
       "cloud-region":"region-one",
       "authInfo": {
       "url":"http://10.74.151.13:5000/v2.0",
       "userName":"admin",
       "password":"admin",
       "tenant":"admin",
       "domain":"",
       "vendor":"ZTE",
       "version":"v1.0",

authInfo:

...

Request Sample:
/api/aai-cloudInfrastructure/v1/cloud-regions/cloud-region/owner/region-one

   {
       "cloud-owner":"owner",
       "cloud-regiontype":"region-oneopenstack",
       "authInfo": {}
       "url":"http://10.74.151.13:5000/v2.0",}
       "userName":"admin",
       "password":"admin",
       "tenant":"admin",
       "domain":"",
       "vendor":"ZTE",
       "version":"v1.0",
       "type":"openstack"
       }
   }

Response:

Success Code: 201

Errorcode: 500 Internal Server Error

...

]

Delete VIM

Interface DefinitionDescription
URI/onapapi/aai/esr/v1/vims?cloudOwner=xxx&cloudRegionId=xxx
Operation TypeDELETE

Request Parameters:

AttributeQualifierCardinalityContentDescription
vimIdM1StringVIM identifier

Request Sample:
/onapapi/aai/esr/v1/vims?cloudOwner=owner&cloudRegionId=region-one

Response:

Success Code: 204

Errorcode: 500 Internal Server Error

SDN Controller

SDN Controller registration (Update SDN Controller)

Interface DefinitionDescription
URI/api/aai-cloudInfrastructuresdncontroller/v1/cloud-regions/cloud-regionsdncontrollers/sdncontroller/{cloud-owner}/{cloud-region-id}sdnControllerId}
Operation TypePUTOperation TypeGET

Request Parameters:

cloudOwnercloudRegionId
AttributeQualifierCardinalityContentDescription

sdnControllerId

M1StringCloud ownerUUID of sdncontroller
nameM1StringCloud region

Request Sample:
/api/aai-cloudInfrastructure/v1/cloud-regions/cloud-region/owner/region-one

Response Parameters:

VIM

Get all VIM

...

SDN Controller name
locationO1Stringfit for DC type
urlM1StringAccess url
vendorM1StringSDNC vendor
versionM1StringSDNC version
descriptionO0..1StringSDNC description
productNameO0..1StringSDNC productName
protocolM1Enum{netconf/snmp}protocol
userNameM1StringUser name
passwordM1StringPassword
typeM1Enum{WAN/DC}SDN Controller type

Request Sample:
/api/aai-sdncontroller/v1/sdncontrollers/sdncontroller/{sdnControllerId}

   {

Request Parameters:
N/A

Request Sample:
/onapapi/aai/esr/v1/vims

Response Parameters:
List<VIM>

Response Sample:

Success Code: 201  
 [
       {
       "cloud-owner":"owner",
       "cloud-region":"region-one",
       "authInfo": {
       "url":"http://10.74.151.13:5000/v2.0",
       "userName":"admin",
       "passwordsdnControllerId":"admina6c42529-cd6b-4c01-b149-03eb54b20a03",

       "tenantname":"adminsdn",
       "domainurl":"",
http://10.74.151.13:8181",
       "vendoruserName":"ZTEadmin",
       "versionpassword":"v1.0admin",
       "typeversion":"openstack"v1.0",
       }
       }
   ]

Delete VIM

...

Request Parameters:

...

Request Sample:
/onapapi/aai/esr/v1/vims?cloudOwner=owner&cloudRegionId=region-one

Response:

Success Code: 204

Errorcode: 500 Internal Server Error

SDN Controller

SDN Controller registration

...

Request Parameters:

...

"vendor":"ZTE",
       "description":"",
       "protocol":"netconf",
       "productName":"",
       "type":"WAN"
   }

Response:

Success Code: 201

Errorcode: 500 Internal Server Error

Get SDN Controller

Interface DefinitionDescription
URI/api/aai-sdncontroller/v1/sdncontrollers/sdncontroller/{sdnControllerId}
Operation TypeGET

Request Parameters:

AttributeQualifierCardinalityContentDescription
sdnControllerIdM1StringSDN Controller identifier

Request Sample:
/api/aai-sdncontroller/v1/sdncontrollers/sdncontroller

Request Sample:
/onapapi/aai/esr/v1/sdncontrollers

   {
       "name":"sdn",
       "url":"http://10.74.151.13:8181",
       "userName":"admin",
       "password":"admin",
       "version":"v1.0",
       "vendor":"ZTE",
       "description":"",
       "protocol":"netconf",
       "productName":"",
       "type":"WAN"
   }

Response:

Success Code: 201

Errorcode: 500 Internal Server Error

Get SDN Controller by id

...

Request Parameters:

...

Request Sample:
/onapapi/aai/esr/v1/sdncontrollers/57674786-5b2e-4c92-bb68-578dbd79e2f5

Response Parameters:
SDN Controller

Response Sample:

Success Code: 201

   {
       "sdnControllerId":"a6c42529-cd6b-4c01-b149-03eb54b20a03",
       "name":"sdn",
       "url":"http://10.74.151.13:8181",
       "userName":"admin",
       "password":"admin", 
       "version":"v1.0",
       "vendor":"ZTE",
       "description":"",
       "protocol":"netconf",
       "productName":"",
       "type":"WAN",
       "createTime":"2016-07-18 12:22:53"
   }

Get all SDN Controller

...

Request Parameters:
N/A

Request Sample:
/onapapi/aai/esr/v1/sdncontrollers

Response Parameters:
List<SDN Controller>

Response Sample:

Success Code: 201  
 [
       {
           "sdnControllerId":"a6c42529-cd6b-4c01-b149-03eb54b20a03",
           "name":"sdn",
           "url":"http://10.74.151.13:8181",
           "userName":"admin",
           "password":"admin",
           "version":"v1.0",
           "vendor":"ZTE",
           "description":"",
           "protocol":"netconf",
           "productName":"", 
           "type":"WAN",
           "createTime":"2016-07-18 12:22:53"
       }
   ]

Update SDN Controller

...

Request Parameters:

...

Request Sample:
/onapapi/aai/esr/v1/sdncontrollers/57674786-5b2e-4c92-bb68-578dbd79e2f5578dbd79e2f5

Response Parameters:
SDN Controller

Response Sample:

Success Code: 201

   {
       "sdnControllerId":"a6c42529-cd6b-4c01-b149-03eb54b20a03",
       "name":"sdn",
       "url":"http://10.74.151.13:8181",
       "userName":"admin",
       "password":"admin", 
       "version":"v1.0",
       "vendor":"ZTE",
       "description":"",
       "protocol":"netconf",
       "productName":"",
       "type":"WAN",
       "createTime":"2016-07-18 12:22:53":""
   }

   }

Get all SDN Controller

Interface DefinitionDescription
URI/api/aai-sdncontroller/v1/sdncontrollers
Operation TypeGET

Request Parameters:
N/A

Request Sample:
/api/aai-sdncontroller/v1/sdncontrollers

Response Parameters:
List<SDN Controller>

Response Sample:

Success Code: 201  
 [
       {
           "sdnControllerId":"a6c42529-cd6b-4c01-b149-03eb54b20a03",
           "name":"sdn",
           "url":"http://10.74.151.13:8181",
           "userName":"admin",
           "password":"admin",
   
        "version":"v1.0",
           "vendor":"ZTE",
           "description":"",
           "protocol":"netconf",
           "productName":"", 
           "type":"WAN",
           "createTime":"2016-07-18 12:22:53"
       }
   ]

Delete SDN Controller

Interface DefinitionDescription
URI/onapapiapi/aai/esr-sdncontroller/v1/sdncontrollers/sdncontroller/{sdnControllerId}
Operation TypeDELETE

...

Request Sample:
/onapapi/aai/esr/v1/sdncontrollers/sdncontroller/57674786-5b2e-4c92-bb68-578dbd79e2f5

...

Interface DefinitionDescription
URI/onapapiapi/aai-ems/esr/v1/emses/ems/{emsId}
Operation TypePUT

Request Parameters:

...

AttributeQualifierCardinalityContentDescription
ipM1Stringservice IP of ftp server
portM1Stringservice port of ftp server
userM1Stringftp user name
passwordM1Stringftp password

Request Sample:

/onapapiapi/aai/esr-ems/v1/emses/ems/19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee

{   

"emsId": "19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee",

"emsName": "EMS_TEST",

...

"version":"v1.0",

...

"vendor":"ZTE",

...

"description":"",

...

"createTime":"2016-07-18

...

12:22:53"

...

"resouceAddr": {

        "ftptype": "ftp",
        "ip": "10.44.55.145",
        "port": "2000",
        "user": "root",
        "password": "test",
        "remotepath": "/opt/res/data/",
        "passive": true
 

...

},

...

"performanceAddr": {
        "ftptype": "ftp",
        "ip": "10.44.55.145",
        "port": "2000",
        "user": "root",
        "password": "test",
        "remotepath": "/opt/Gcp/data/",
        "passive": true

...

},

...

"alarmAddr": {
        "ip": "10.44.55.145",
        "port": 2000,
        "user": "root",
        "password": "test"

...

}

}


Response Parameters:
EMS

Response Sample:

{   

"emsId": "19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee",

...

"emsName": "EMS_TEST",

...

"version":"v1.0",

...

"vendor":"ZTE",

...

"description":"",

...

"createTime":"2016-07-18

...

12:22:53"

...

"resouceAddr": {

        "ftptype": "ftp",
        "ip": "10.44.55.145",
        "port": "2000",
        "user": "root",
        "password": "test",
        "remotepath": "/opt/res/data/",
        "passive": true

...

 },

...

"performanceAddr": {
        "ftptype": "ftp",
        "ip": "10.44.55.145",
        "port": "2000",
        "user": "root",
        "password": "test",
        "remotepath": "/opt/Gcp/data/",
        "passive": true

...

},

...

"alarmAddr": {
        "ip": "10.44.55.145",
        "port": 2000,
        "user": "root",
        "password": "test"

...

}

}

Get EMS by id

Interface DefinitionDescription
URI/onapapiapi/aai-ems/esr/v1/emses/ems/{emsId}
Operation TypeGET

Request Parameters:

AttributeQualifierCardinalityContentDescription
emsIdM1StringEMS identifier

Request Sample:
/onapapiapi/aai/esr-ems/v1/emses/ems/19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee

Response Parameters:
EMS

Response Sample:

{   

"emsId": "19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee",

...

"emsName": "EMS_TEST",

...

"version":"v1.0",

...

"vendor":"ZTE",

...

"description":"",

...

"createTime":"2016-07-18

...

12:22:53"

...

"resouceAddr": {

        "ftptype": "ftp",
        "ip": "10.44.55.145",
        "port": "2000",
        "user": "root",
        "password": "test",
        "remotepath": "/opt/res/data/",
        "passive": true
 

...

},

...

"performanceAddr": {
        "ftptype": "ftp",
        "ip": "10.44.55.145",
        "port": "2000",
        "user": "root",
        "password": "test",
        "remotepath": "/opt/Gcp/data/",
        "passive": true

...

},

...

"alarmAddr": {
        "ip": "10.44.55.145",
        "port": 2000,
        "user": "root",
        "password": "test"

...

}

}


Get all EMS

Interface DefinitionDescription
URI/onapapiapi/aai-ems/esr/v1/emssemses
Operation TypeGET

Request Parameters:
N/A

Request Sample:
/onapapiapi/aai/esr-ems/v1/emssemses

Response Parameters:
List<EMS>

Response Sample:

Success Code: 201

...

[

{

    "emsId": "19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee",

    "emsName": "EMS_TEST",

...

"version":"v1.0",

...

"vendor":"ZTE",

...

"description":"",

...

"createTime":"2016-07-18

...

12:22:53"

    "resouceresouceAddr": {

        "ftptype": "ftp",
        "ip": "10.44.55.145",
        "port": "2000",
        "user": "root",
        "password": "test",
        "remotepath": "/opt/res/data/",
        "passive": true
    },   

"performanceperformanceAddr": {
        "ftptype": "ftp",
        "ip": "10.44.55.145",
        "port": "2000",
        "user": "root",
        "password": "test",
        "remotepath": "/opt/Gcp/data/",
        "passive": true   

},

    "alarmalarmAddr": {
        "ip": "10.44.55.145",
        "port": 2000,
        "user": "root",
        "password": "test"   

}

}

...

]

...


Update EMS

Interface DefinitionDescription
URI/onapapi/aai/esr/v1/emses/{emsId}
Operation TypePUT

...

AttributeQualifierCardinalityContentDescription
urlM1StringAccess url
userNameM1StringUser name
passwordM1StringPassword
tenantM1StringTenant name
domainO0..1StringDomain
vendorM1StringVIM vendor
versionM1StringVIM version
typeM1StringVIM type

SDN Controller

AttributeQualifierCardinalityContentDescription

sdnControllerId

M1StringUUID of sdncontroller
nameM1String
Domain
SDN Controller name
vendor
location
M
O1String
VIM vendor
fit for DC type
url
version
M1String
VIM version
Access url
type
vendorM1String
VIM type

...

SDNC vendor
versionM1StringSDNC version
descriptionO0..1StringSDNC description
productNameO0..1StringSDNC productName
protocolM1Enum{netconf/snmp}protocol
userNameM1
AttributeContentDescriptionsdnControllerId(UUID)StringSDN Controller identifiernameStringSDN Controller namedescriptionStringdescriptionversionStringversionvendorStringvendortypeEnum{WAN/DC}SDN Controller typeurlStringAccess urluserName
StringUser name
passwordM1StringPassword
createTime
type
StringCreate time
M1
protocol
Enum{
netconf
WAN/
snmp
DC}
protocolproductNameStringproductNamelocationStringonly fit for DC
SDN Controller type

EMS

AttributeQualifierCardinalityContentDescription
emsIdM1StringEMS identifier
(UUID)
nameO0..1StringEMS name
description
vendorO0..1String
description
Vendor
versionO0..1Stringversion
vendor
description
StringVendorcreateTimeStringCreate timeproductNameStringproduct nameresourceresourceInforesource data access addressperformanceperformanceInfoperformance data access addressalarmalarmInfo
O0..1Stringdescription
resourceAddrO0..1ObjAddress to get resource data
performanceAddrO0..1ObjAddress to get performance data
alarmAddrO0..1ObjAddress to get alarm data
alarm data access address

resourceAddr:

AttributeQualifierCardinalityContentDescription
ftptypeO0..1Enum{ftp/sftp}ftp type
ipO0..1Stringservice IP of ftp server
portO0..1Stringservice port of ftp server
userO0..1Stringftp user name
passwordO0..1Stringftp password
remotepathO0..1Stringresource data file path
passiveO0..1Booleanftp passive mode or not

performanceAddr:

AttributeQualifierCardinalityContentDescription
ftptypeO0..1Enum{ftp/sftp}ftp type
ipO0..1Stringservice IP of ftp server
portO0..1Stringservice port of ftp server
userO0..1Stringftp user name
passwordO0..1Stringftp password
remotepathO0..1Stringperformance data file path
passiveO0..1Booleanftp passive mode or not

alarmAddr:

AttributeQualifierCardinalityContentDescription
ipO0..1Stringservice IP of ftp server
portO0..1Stringservice port of ftp server
userO0..1Stringftp user name
passwordO0..1Stringftp password