Versions Compared

Key

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

...

Interface DefinitionDescription
URI

/api/aai-esr-server/v1/vims

Operation TypePOST

...

Request Sample:
/api/aai-esr-server/v1/vims

Body:

{
"cloud-owner": "ZTE",
"status": "active",
"cloud-region-id": "region-one",
"cloud-type": "openstack",
"cloud-region-version": "v1.0",
"owner-defined-type": "owner-defined-type",
"cloud-zone": "cloud zone",
"complex-name": "complex name",
"cloud-extra-info": "cloud-extra-info",
"auth-info-items": [
{
"username": "admin",
"password": "admin",
"auth-url": "http://10.74.151.13:5000/v2.0",
"ssl-cacert": "ssl-cacert",
"ssl-insecure": "true",
"cloud-domain": "cloud-domain"
}
]
}

...

Errorcode: 500 Internal Server Error

Update VIM info

Interface Definition

Description

URI/api/aai-esr-server/v1/vims/{cloudOwner}/{cloudRegionId}
Operation TypePUT

Request Body:

   

AttributeQualifierDefaultContentDescription
cloudTypeM
Stringtype of the cloud, decides which multicloud plugin to use, openstack or vio
cloudRegionVersionM
Stringcloud version, ocata, mitaka or other
ownerDefinedTypeO
StringCloud-owner defined type indicator (e.g., dcp, lcp)
cloudZoneO
StringZone where the cloud is homed.
complexNameO
Stringcomplex name for cloud-region instance.
cloudExtraInfoO
Stringextra info for Cloud
authInfoItemsM
[Obj]Auth information of Cloud

authInfoItem:

AttributeQualifierDefaultContentDescription
cloudDomainM
Stringdomain info for keystone v3
userNameM
StringUser name
passwordM
StringPassword
authUrlM
Stringauthentication url of the cloud, e.g. keystone url
ssl-cacertO
Stringca file content if enabled ssl on auth-url
ssl-insecureO
BooleanWhether to verify VIM's certificate


Request Sample:
/api/aai-esr-server/v1/vims/ZTE/region-one

{
"status": "active",
"cloud-type": "openstack",
"cloud-region-version": "v1.0",
"owner-defined-type": "owner-defined-type",
"cloud-zone": "cloud zone",
"complex-name": "complex name",
"cloud-extra-info": "cloud-extra-info",
"auth-info-items": [
{
"username": "admin",
"password": "admin",
"auth-url": "http://10.74.151.13:5000/v2.0",
"ssl-cacert": "ssl-cacert",
"ssl-insecure": "ssl-insecure",
"cloud-domain": "cloud-domain"
}
]
}

...

Interface DefinitionDescription
URI

/api/aai-esr-server/v1/vims/{cloud-owner}/{cloud-region-id}

Operation TypeGET

...

Request Sample:
/api/aai-esr-server/v1/vims/ZTE/region-one

Response Parameters:

...

Interface DefinitionDescription
URI/api/aai-esr-server/v1/vims
Operation TypeGET

...

Request Sample:
/api/aai-esr-server/v1/vims/

Response Parameters:
List<VIM>

...

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

...

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

...

Errorcode: 500 Internal Server Error

VNFM

VNFM registration

...

Interface DefinitionDescription
URI/api/aai-esr-server/v1/vnfms/vnfm/{vnfmId}
Operation TypePUTPOST

Request Parameters:

O
AttributeQualifierCardinalityContentDescriptionvnfmId
0..1StringVNFM UUID generated by ESRnameM1StringVNFM 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:
/api/aai-vnfmesr-server/v1/vnfms/vnfm/19ecbb3a-3242-4fa3-9926-8dfb7ddc29ee

Body:

   {
       "vnfmIdname":"19ecbb3a-3242-4fa3-9926-8dfb7ddc29eevnfm",
       "nametype":"vnfmTacker",
       "type":"Tacker",
       "vimId"vimId":"",
       "vendor":"ZTE",
       "version":"v1.0",
       "description":"vnfm",
       "url":"http://10.74.44.11",
       "certificateUrl":"",
       "userName":"admin",
       "password":"admin"
   }

Response:

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

}

Success Code: 201

Errorcode: 500 Internal Server Error

...

VNFM update

Interface DefinitionDescription
URI/api/aai-
vnfm
esr-server/v1/vnfms/
vnfm/
{vnfmId}
Operation Type
GET
POST

Request Parameters:

AttributeQualifierCardinalityContentDescription
vnfmId
nameM1StringVNFM
identifier
name

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

Response Parameters:
VNFM

Response Sample:

Success Code: 201

typeM1StringVNFM type
vimIdO0..1StringRelated VIM
vendorM1StringVNFM vendor
versionM1StringVNFM version
descriptionO0..1StringVNFM description
certificateUrlO0..1Stringcertificate url
urlM1StringAccess url
userNameO0..1StringUser name
passwordO0..1StringPassword

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

Body:

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

Get all VNFM

Response:

Success Code: 201

Errorcode: 500 Internal Server Error


Get VNFM

Interface DefinitionDescriptionInterface DefinitionDescription
URI/api/aai-esr-vnfmserver/v1/vnfms/{vnfmId}
Operation TypeGET

Request Parameters:N/A

AttributeQualifierCardinalityContentDescription
vnfmIdM1StringVNFM identifier

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

Response Parameters:
List<VNFM>

Response Sample:

Success

...

Code:

...

201

...


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

Get all VNFM

Interface DefinitionDescription
URI/api/aai-esr-server/v1/vnfms
Operation TypeGET

Request Parameters:
N/A

Request Sample:
/api/aai-esr-server/v1/vnfms

Response Parameters:
List<VNFM>

Response Sample:

Success Code: 201   
 [
       {
           "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/api/aai-esr-server/v1/vnfms/{vnfmId}
Operation TypeDELETE

Request Parameters:

AttributeQualifierCardinalityContentDescription
vnfmIdM1StringVNFM identifier

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

Response:

Success Code: 204

Errorcode: 500 Internal Server Error

SDN Controller

SDN Controller registration 

Interface DefinitionDescription
URI/api/aai-esr-server/v1/sdncontrollers
Operation TypePOST

Request Parameters:

AttributeQualifierCardinalityContentDescription

sdnControllerId

M1StringUUID of sdncontroller
nameM1StringSDN Controller name
locationO1Stringfit for DC type
urlM1StringAccess url
vendorM1StringSDNC vendor
versionM1StringSDNC version
descriptionO0..1StringSDNC description
productNameO0..1StringSDNC productName
protocolM1Stringprotocol, such as netconf/snmp
userNameM1StringUser name
passwordM1StringPassword
typeM1Enum{WAN/DC}SDN Controller type

Request Sample:
/api/aai-esr-server/v1/sdncontrollers

Body:

{

"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:

body:

{

"sdnControllerId":"a6c42529-cd6b-4c01-b149-03eb54b20a03",

}

Success Code: 201

Delete VNFM

...

Request Parameters:

...

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

Response:

Success Code: 204

Errorcode: 500 Internal Server Error

SDN Controller

...

Error

Update SDN Controller info

...

Interface DefinitionDescription
URI/api/aai-
sdncontroller
esr-server/v1/sdncontrollers
/sdncontroller
/{sdnControllerId}
Operation TypePUT

Request Parameters:

AttributeQualifierCardinalityContentDescription

sdnControllerId

M1StringUUID of sdncontroller
nameM1StringSDN Controller name
locationO1Stringfit for DC type
urlM1StringAccess url
vendorM1StringSDNC vendor
versionM1StringSDNC version
descriptionO0..1StringSDNC description
productNameO0..1StringSDNC productName
protocolM1
Enum{
Stringprotocol, such as netconf/snmp
}
protocol
userNameM1StringUser name
passwordM1StringPassword
typeM1Enum{WAN/DC}SDN Controller type

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

Body:

{

...

a6c42529-cd6b-4c01-b149-03eb54b20a03

...

Body:

{

"name":"sdn",

"url":"http://10.74.151.13:8181",

...

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

...

AttributeQualifierCardinalityContentDescription
sdnControllerIdM1StringSDN Controller identifier

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

...

Interface DefinitionDescription
URI/api/aai-esr-sdncontrollerserver/v1/sdncontrollers
Operation TypeGET

Request Parameters:
N/A

Request Sample:
/api/aai-esr-sdncontrollerserver/v1/sdncontrollers

Response Parameters:
List<SDN Controller>

...

Interface DefinitionDescription
URI/api/aai-sdncontrolleresr-server/v1/sdncontrollers/sdncontroller/{sdnControllerId}
Operation TypeDELETE

...

AttributeQualifierCardinalityContentDescription
sdnControllerIdM1StringSDN Controller identifier

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

...