diff options
author | 2018-01-30 14:04:13 -0500 | |
---|---|---|
committer | 2018-02-27 19:35:30 -0500 | |
commit | aefeb9ff5ec5c7ce3c20f420db1116c31f034615 (patch) | |
tree | 986dc4e1c6f8b897b3e6e99fba2af8df3a3f0965 /aai-schema/src/main/resources/aai_swagger_yaml/aai_swagger_v11.yaml | |
parent | 4eae7a8de0381e013daa717626c6c431d1dca35b (diff) |
Update the files for ajsc 6 changes
Issue-ID: AAI-33
Change-Id: I897566e79eb7505232b692e551f6347e69fafed6
Signed-off-by: Venkata Harish K Kajur <vk250x@att.com>
Diffstat (limited to 'aai-schema/src/main/resources/aai_swagger_yaml/aai_swagger_v11.yaml')
-rw-r--r-- | aai-schema/src/main/resources/aai_swagger_yaml/aai_swagger_v11.yaml | 29238 |
1 files changed, 25025 insertions, 4213 deletions
diff --git a/aai-schema/src/main/resources/aai_swagger_yaml/aai_swagger_v11.yaml b/aai-schema/src/main/resources/aai_swagger_yaml/aai_swagger_v11.yaml index 4447f7f3..5e6105e4 100644 --- a/aai-schema/src/main/resources/aai_swagger_yaml/aai_swagger_v11.yaml +++ b/aai-schema/src/main/resources/aai_swagger_yaml/aai_swagger_v11.yaml @@ -1,28 +1,9 @@ -# -# ============LICENSE_START======================================================= -# org.onap.aai -# ================================================================================ -# Copyright © 2017 AT&T Intellectual Property. All rights reserved. -# ================================================================================ -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. -# ============LICENSE_END========================================================= -# -# ECOMP is a trademark and service mark of AT&T Intellectual Property. -# - swagger: "2.0" info: description: | + + [Differences versus the previous schema version](apidocs/aai_swagger_v11.diff) + Copyright © 2017 AT&T Intellectual Property. All rights reserved. Licensed under the Creative Commons License, Attribution 4.0 Intl. (the "License"); you may not use this documentation except in compliance with the License. @@ -71,19 +52,22 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: target-pe in: path description: The Target provider edge router required: true type: string + example: __TARGET-PE__ - name: availability-zone-name in: path description: Name of the availability zone required: true type: string + example: __AVAILABILITY-ZONE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureComplexesComplexCtagPoolsCtagPool.json) required: true schema: $ref: "#/definitions/relationship" @@ -108,16 +92,19 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: target-pe in: path description: The Target provider edge router required: true type: string + example: __TARGET-PE__ - name: availability-zone-name in: path description: Name of the availability zone required: true type: string + example: __AVAILABILITY-ZONE-NAME__ /cloud-infrastructure/complexes/complex/{physical-location-id}/ctag-pools/ctag-pool/{target-pe}/{availability-zone-name}: get: tags: @@ -132,7 +119,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/ctag-pool" + $ref: "#/getDefinitions/ctag-pool" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -141,16 +128,19 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: target-pe in: path description: The Target provider edge router required: true type: string + example: __TARGET-PE__ - name: availability-zone-name in: path description: Name of the availability zone required: true type: string + example: __AVAILABILITY-ZONE-NAME__ - name: data-center-code in: query description: Data center code which can be an alternate way to identify a complex @@ -170,7 +160,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing ctag-pool - description: create or update an existing ctag-pool + description: | + Create or update an existing ctag-pool. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureComplexesComplexCtagPoolsCtagPool consumes: - application/json @@ -187,22 +180,76 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: target-pe in: path description: The Target provider edge router required: true type: string + example: __TARGET-PE__ - name: availability-zone-name in: path description: Name of the availability zone required: true type: string + example: __AVAILABILITY-ZONE-NAME__ - name: body in: body - description: ctag-pool object that needs to be created or updated + description: ctag-pool object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureComplexesComplexCtagPoolsCtagPool.json) required: true schema: $ref: "#/definitions/ctag-pool" + patch: + tags: + - CloudInfrastructure + summary: update an existing ctag-pool + description: | + Update an existing ctag-pool + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureComplexesComplexCtagPoolsCtagPool + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: physical-location-id + in: path + description: Unique identifier for physical location, e.g., CLLI + required: true + type: string + example: __PHYSICAL-LOCATION-ID__ + - name: target-pe + in: path + description: The Target provider edge router + required: true + type: string + example: __TARGET-PE__ + - name: availability-zone-name + in: path + description: Name of the availability zone + required: true + type: string + example: __AVAILABILITY-ZONE-NAME__ + - name: body + in: body + description: ctag-pool object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/ctag-pool" delete: tags: - CloudInfrastructure @@ -224,16 +271,19 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: target-pe in: path description: The Target provider edge router required: true type: string + example: __TARGET-PE__ - name: availability-zone-name in: path description: Name of the availability zone required: true type: string + example: __AVAILABILITY-ZONE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -253,7 +303,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/ctag-pools" + $ref: "#/getDefinitions/ctag-pools" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -262,6 +312,7 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: data-center-code in: query description: Data center code which can be an alternate way to identify a complex @@ -298,9 +349,10 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureComplexesComplex.json) required: true schema: $ref: "#/definitions/relationship" @@ -325,6 +377,7 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ /cloud-infrastructure/complexes/complex/{physical-location-id}: get: tags: @@ -339,7 +392,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/complex" + $ref: "#/getDefinitions/complex" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -348,6 +401,7 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: data-center-code in: query description: Data center code which can be an alternate way to identify a complex @@ -367,7 +421,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing complex - description: create or update an existing complex + description: | + Create or update an existing complex. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureComplexesComplex consumes: - application/json @@ -384,12 +441,52 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: body in: body - description: complex object that needs to be created or updated + description: complex object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureComplexesComplex.json) required: true schema: $ref: "#/definitions/complex" + patch: + tags: + - CloudInfrastructure + summary: update an existing complex + description: | + Update an existing complex + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureComplexesComplex + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: physical-location-id + in: path + description: Unique identifier for physical location, e.g., CLLI + required: true + type: string + example: __PHYSICAL-LOCATION-ID__ + - name: body + in: body + description: complex object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/complex" delete: tags: - CloudInfrastructure @@ -411,6 +508,7 @@ paths: description: Unique identifier for physical location, e.g., CLLI required: true type: string + example: __PHYSICAL-LOCATION-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -430,7 +528,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/complexes" + $ref: "#/getDefinitions/complexes" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/volume-groups/volume-group/{volume-group-id}/relationship-list/relationship: @@ -454,19 +552,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: volume-group-id in: path description: Unique ID of volume-group. required: true type: string + example: __VOLUME-GROUP-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVolumeGroupsVolumeGroup.json) required: true schema: $ref: "#/definitions/relationship" @@ -491,16 +592,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: volume-group-id in: path description: Unique ID of volume-group. required: true type: string + example: __VOLUME-GROUP-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/volume-groups/volume-group/{volume-group-id}: get: tags: @@ -515,7 +619,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/volume-group" + $ref: "#/getDefinitions/volume-group" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -524,16 +628,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: volume-group-id in: path description: Unique ID of volume-group. required: true type: string + example: __VOLUME-GROUP-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -563,7 +670,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing volume-group - description: create or update an existing volume-group + description: | + Create or update an existing volume-group. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionVolumeGroupsVolumeGroup consumes: - application/json @@ -580,22 +690,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: volume-group-id in: path description: Unique ID of volume-group. required: true type: string + example: __VOLUME-GROUP-ID__ - name: body in: body - description: volume-group object that needs to be created or updated + description: volume-group object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVolumeGroupsVolumeGroup.json) required: true schema: $ref: "#/definitions/volume-group" + patch: + tags: + - CloudInfrastructure + summary: update an existing volume-group + description: | + Update an existing volume-group + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionVolumeGroupsVolumeGroup + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: volume-group-id + in: path + description: Unique ID of volume-group. + required: true + type: string + example: __VOLUME-GROUP-ID__ + - name: body + in: body + description: volume-group object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/volume-group" delete: tags: - CloudInfrastructure @@ -617,16 +781,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: volume-group-id in: path description: Unique ID of volume-group. required: true type: string + example: __VOLUME-GROUP-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -646,7 +813,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/volume-groups" + $ref: "#/getDefinitions/volume-groups" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -655,11 +822,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -691,29 +860,34 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: volume-id in: path description: Unique ID of block storage volume relative to the vserver. required: true type: string + example: __VOLUME-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverVolumesVolume.json) required: true schema: $ref: "#/definitions/relationship" @@ -738,26 +912,31 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: volume-id in: path description: Unique ID of block storage volume relative to the vserver. required: true type: string + example: __VOLUME-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/volumes/volume/{volume-id}: get: tags: @@ -772,7 +951,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/volume" + $ref: "#/getDefinitions/volume" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -781,26 +960,31 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: volume-id in: path description: Unique ID of block storage volume relative to the vserver. required: true type: string + example: __VOLUME-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -848,7 +1032,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing volume - description: create or update an existing volume + description: | + Create or update an existing volume. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverVolumesVolume consumes: - application/json @@ -865,32 +1052,100 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: volume-id in: path description: Unique ID of block storage volume relative to the vserver. required: true type: string + example: __VOLUME-ID__ - name: body in: body - description: volume object that needs to be created or updated + description: volume object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverVolumesVolume.json) required: true schema: $ref: "#/definitions/volume" + patch: + tags: + - CloudInfrastructure + summary: update an existing volume + description: | + Update an existing volume + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverVolumesVolume + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: vserver-id + in: path + description: Unique identifier for this vserver relative to its tenant + required: true + type: string + example: __VSERVER-ID__ + - name: volume-id + in: path + description: Unique ID of block storage volume relative to the vserver. + required: true + type: string + example: __VOLUME-ID__ + - name: body + in: body + description: volume object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/volume" delete: tags: - CloudInfrastructure @@ -912,26 +1167,31 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: volume-id in: path description: Unique ID of block storage volume relative to the vserver. required: true type: string + example: __VOLUME-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -951,7 +1211,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/volumes" + $ref: "#/getDefinitions/volumes" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -960,21 +1220,25 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -1039,24 +1303,28 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserver.json) required: true schema: $ref: "#/definitions/relationship" @@ -1081,21 +1349,25 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship: put: tags: @@ -1117,34 +1389,40 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -1169,31 +1447,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -1215,39 +1499,46 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -1272,36 +1563,43 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -1316,7 +1614,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -1325,36 +1623,43 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -1444,7 +1749,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -1461,42 +1769,124 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: vserver-id + in: path + description: Unique identifier for this vserver relative to its tenant + required: true + type: string + example: __VSERVER-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - CloudInfrastructure @@ -1518,36 +1908,43 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -1574,39 +1971,46 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -1631,36 +2035,43 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -1675,7 +2086,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -1684,36 +2095,43 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -1803,7 +2221,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -1820,42 +2241,124 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: vserver-id + in: path + description: Unique identifier for this vserver relative to its tenant + required: true + type: string + example: __VSERVER-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - CloudInfrastructure @@ -1877,36 +2380,43 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -1926,7 +2436,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -1935,31 +2445,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -2033,7 +2549,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -2050,37 +2569,112 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - CloudInfrastructure + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: vserver-id + in: path + description: Unique identifier for this vserver relative to its tenant + required: true + type: string + example: __VSERVER-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - CloudInfrastructure @@ -2102,31 +2696,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -2146,7 +2746,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -2155,26 +2755,31 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -2254,34 +2859,40 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -2306,31 +2917,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -2345,7 +2962,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -2354,31 +2971,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -2461,7 +3084,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -2478,37 +3104,112 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - CloudInfrastructure + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: vserver-id + in: path + description: Unique identifier for this vserver relative to its tenant + required: true + type: string + example: __VSERVER-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - CloudInfrastructure @@ -2530,31 +3231,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -2574,7 +3281,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -2583,26 +3290,31 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -2682,29 +3394,34 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -2729,26 +3446,31 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -2770,34 +3492,40 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -2822,31 +3550,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -2861,7 +3595,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -2870,31 +3604,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -2973,7 +3713,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -2990,37 +3733,112 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: vserver-id + in: path + description: Unique identifier for this vserver relative to its tenant + required: true + type: string + example: __VSERVER-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - CloudInfrastructure @@ -3042,31 +3860,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -3093,34 +3917,40 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -3145,31 +3975,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -3184,7 +4020,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -3193,31 +4029,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -3296,7 +4138,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -3313,37 +4158,112 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: vserver-id + in: path + description: Unique identifier for this vserver relative to its tenant + required: true + type: string + example: __VSERVER-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - CloudInfrastructure @@ -3365,31 +4285,37 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -3409,7 +4335,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -3418,26 +4344,31 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -3500,7 +4431,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface consumes: - application/json @@ -3517,32 +4451,100 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - CloudInfrastructure + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: vserver-id + in: path + description: Unique identifier for this vserver relative to its tenant + required: true + type: string + example: __VSERVER-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - CloudInfrastructure @@ -3564,26 +4566,31 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -3603,7 +4610,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -3612,21 +4619,25 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -3684,7 +4695,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vserver" + $ref: "#/getDefinitions/vserver" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -3693,21 +4704,25 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -3755,7 +4770,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing vserver - description: create or update an existing vserver + description: | + Create or update an existing vserver. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserver consumes: - application/json @@ -3772,27 +4790,88 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: body in: body - description: vserver object that needs to be created or updated + description: vserver object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserver.json) required: true schema: $ref: "#/definitions/vserver" + patch: + tags: + - CloudInfrastructure + summary: update an existing vserver + description: | + Update an existing vserver + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserver + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: vserver-id + in: path + description: Unique identifier for this vserver relative to its tenant + required: true + type: string + example: __VSERVER-ID__ + - name: body + in: body + description: vserver object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vserver" delete: tags: - CloudInfrastructure @@ -3814,21 +4893,25 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: vserver-id in: path description: Unique identifier for this vserver relative to its tenant required: true type: string + example: __VSERVER-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -3848,7 +4931,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vservers" + $ref: "#/getDefinitions/vservers" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -3857,16 +4940,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -3908,19 +4994,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenant.json) required: true schema: $ref: "#/definitions/relationship" @@ -3945,16 +5034,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}: get: tags: @@ -3969,7 +5061,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/tenant" + $ref: "#/getDefinitions/tenant" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -3978,16 +5070,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -4012,7 +5107,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing tenant - description: create or update an existing tenant + description: | + Create or update an existing tenant. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenant consumes: - application/json @@ -4029,22 +5127,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: body in: body - description: tenant object that needs to be created or updated + description: tenant object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenant.json) required: true schema: $ref: "#/definitions/tenant" + patch: + tags: + - CloudInfrastructure + summary: update an existing tenant + description: | + Update an existing tenant + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenant + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: tenant-id + in: path + description: Unique id relative to the cloud-region. + required: true + type: string + example: __TENANT-ID__ + - name: body + in: body + description: tenant object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/tenant" delete: tags: - CloudInfrastructure @@ -4066,16 +5218,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: tenant-id in: path description: Unique id relative to the cloud-region. required: true type: string + example: __TENANT-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -4095,7 +5250,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/tenants" + $ref: "#/getDefinitions/tenants" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -4104,11 +5259,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -4140,19 +5297,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: flavor-id in: path description: Flavor id, expected to be unique across cloud-region. required: true type: string + example: __FLAVOR-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionFlavorsFlavor.json) required: true schema: $ref: "#/definitions/relationship" @@ -4177,16 +5337,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: flavor-id in: path description: Flavor id, expected to be unique across cloud-region. required: true type: string + example: __FLAVOR-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/flavors/flavor/{flavor-id}: get: tags: @@ -4201,7 +5364,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/flavor" + $ref: "#/getDefinitions/flavor" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -4210,16 +5373,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: flavor-id in: path description: Flavor id, expected to be unique across cloud-region. required: true type: string + example: __FLAVOR-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -4239,7 +5405,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing flavor - description: create or update an existing flavor + description: | + Create or update an existing flavor. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionFlavorsFlavor consumes: - application/json @@ -4256,22 +5425,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: flavor-id in: path description: Flavor id, expected to be unique across cloud-region. required: true type: string + example: __FLAVOR-ID__ - name: body in: body - description: flavor object that needs to be created or updated + description: flavor object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionFlavorsFlavor.json) required: true schema: $ref: "#/definitions/flavor" + patch: + tags: + - CloudInfrastructure + summary: update an existing flavor + description: | + Update an existing flavor + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionFlavorsFlavor + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: flavor-id + in: path + description: Flavor id, expected to be unique across cloud-region. + required: true + type: string + example: __FLAVOR-ID__ + - name: body + in: body + description: flavor object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/flavor" delete: tags: - CloudInfrastructure @@ -4293,16 +5516,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: flavor-id in: path description: Flavor id, expected to be unique across cloud-region. required: true type: string + example: __FLAVOR-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -4322,7 +5548,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/flavors" + $ref: "#/getDefinitions/flavors" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -4331,11 +5557,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -4367,19 +5595,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: group-id in: path description: Group id, expected to be unique across cloud-region. required: true type: string + example: __GROUP-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment.json) required: true schema: $ref: "#/definitions/relationship" @@ -4404,16 +5635,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: group-id in: path description: Group id, expected to be unique across cloud-region. required: true type: string + example: __GROUP-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/group-assignments/group-assignment/{group-id}: get: tags: @@ -4428,7 +5662,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/group-assignment" + $ref: "#/getDefinitions/group-assignment" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -4437,16 +5671,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: group-id in: path description: Group id, expected to be unique across cloud-region. required: true type: string + example: __GROUP-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -4471,7 +5708,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing group-assignment - description: create or update an existing group-assignment + description: | + Create or update an existing group-assignment. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment consumes: - application/json @@ -4488,22 +5728,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: group-id in: path description: Group id, expected to be unique across cloud-region. required: true type: string + example: __GROUP-ID__ - name: body in: body - description: group-assignment object that needs to be created or updated + description: group-assignment object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment.json) required: true schema: $ref: "#/definitions/group-assignment" + patch: + tags: + - CloudInfrastructure + summary: update an existing group-assignment + description: | + Update an existing group-assignment + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: group-id + in: path + description: Group id, expected to be unique across cloud-region. + required: true + type: string + example: __GROUP-ID__ + - name: body + in: body + description: group-assignment object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/group-assignment" delete: tags: - CloudInfrastructure @@ -4525,16 +5819,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: group-id in: path description: Group id, expected to be unique across cloud-region. required: true type: string + example: __GROUP-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -4554,7 +5851,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/group-assignments" + $ref: "#/getDefinitions/group-assignments" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -4563,11 +5860,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -4599,19 +5898,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: snapshot-id in: path description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. required: true type: string + example: __SNAPSHOT-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionSnapshotsSnapshot.json) required: true schema: $ref: "#/definitions/relationship" @@ -4636,16 +5938,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: snapshot-id in: path description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. required: true type: string + example: __SNAPSHOT-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/snapshots/snapshot/{snapshot-id}: get: tags: @@ -4660,7 +5965,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/snapshot" + $ref: "#/getDefinitions/snapshot" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -4669,16 +5974,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: snapshot-id in: path description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. required: true type: string + example: __SNAPSHOT-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -4718,7 +6026,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing snapshot - description: create or update an existing snapshot + description: | + Create or update an existing snapshot. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionSnapshotsSnapshot consumes: - application/json @@ -4735,22 +6046,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: snapshot-id in: path description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. required: true type: string + example: __SNAPSHOT-ID__ - name: body in: body - description: snapshot object that needs to be created or updated + description: snapshot object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionSnapshotsSnapshot.json) required: true schema: $ref: "#/definitions/snapshot" + patch: + tags: + - CloudInfrastructure + summary: update an existing snapshot + description: | + Update an existing snapshot + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionSnapshotsSnapshot + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: snapshot-id + in: path + description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. + required: true + type: string + example: __SNAPSHOT-ID__ + - name: body + in: body + description: snapshot object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/snapshot" delete: tags: - CloudInfrastructure @@ -4772,16 +6137,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: snapshot-id in: path description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. required: true type: string + example: __SNAPSHOT-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -4801,7 +6169,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/snapshots" + $ref: "#/getDefinitions/snapshots" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -4810,11 +6178,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -4846,19 +6216,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: image-id in: path description: Image id, expected to be unique across cloud region required: true type: string + example: __IMAGE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionImagesImage.json) required: true schema: $ref: "#/definitions/relationship" @@ -4883,16 +6256,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: image-id in: path description: Image id, expected to be unique across cloud region required: true type: string + example: __IMAGE-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/images/image/{image-id}/metadata/metadatum/{metaname}: get: tags: @@ -4907,7 +6283,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/metadatum" + $ref: "#/getDefinitions/metadatum" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -4916,20 +6292,24 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: image-id in: path description: Image id, expected to be unique across cloud region required: true type: string + example: __IMAGE-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -4964,7 +6344,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing metadatum - description: create or update an existing metadatum + description: | + Create or update an existing metadatum. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionImagesImageMetadataMetadatum consumes: - application/json @@ -4981,26 +6364,86 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: image-id in: path description: Image id, expected to be unique across cloud region required: true type: string + example: __IMAGE-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: body in: body - description: metadatum object that needs to be created or updated + description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionImagesImageMetadataMetadatum.json) required: true schema: $ref: "#/definitions/metadatum" + patch: + tags: + - CloudInfrastructure + summary: update an existing metadatum + description: | + Update an existing metadatum + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionImagesImageMetadataMetadatum + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: image-id + in: path + description: Image id, expected to be unique across cloud region + required: true + type: string + example: __IMAGE-ID__ + - name: metaname + in: path + required: true + type: string + example: __METANAME__ + - name: body + in: body + description: metadatum object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/metadatum" delete: tags: - CloudInfrastructure @@ -5022,20 +6465,24 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: image-id in: path description: Image id, expected to be unique across cloud region required: true type: string + example: __IMAGE-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: resource-version in: query description: resource-version for concurrency @@ -5055,7 +6502,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/metadata" + $ref: "#/getDefinitions/metadata" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -5064,16 +6511,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: image-id in: path description: Image id, expected to be unique across cloud region required: true type: string + example: __IMAGE-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -5118,7 +6568,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/image" + $ref: "#/getDefinitions/image" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -5127,16 +6577,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: image-id in: path description: Image id, expected to be unique across cloud region required: true type: string + example: __IMAGE-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -5171,7 +6624,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing image - description: create or update an existing image + description: | + Create or update an existing image. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionImagesImage consumes: - application/json @@ -5188,22 +6644,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: image-id in: path description: Image id, expected to be unique across cloud region required: true type: string + example: __IMAGE-ID__ - name: body in: body - description: image object that needs to be created or updated + description: image object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionImagesImage.json) required: true schema: $ref: "#/definitions/image" + patch: + tags: + - CloudInfrastructure + summary: update an existing image + description: | + Update an existing image + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionImagesImage + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: image-id + in: path + description: Image id, expected to be unique across cloud region + required: true + type: string + example: __IMAGE-ID__ + - name: body + in: body + description: image object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/image" delete: tags: - CloudInfrastructure @@ -5225,16 +6735,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: image-id in: path description: Image id, expected to be unique across cloud region required: true type: string + example: __IMAGE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -5254,7 +6767,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/images" + $ref: "#/getDefinitions/images" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -5263,11 +6776,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -5299,19 +6814,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: switch-name in: path description: DVS switch name required: true type: string + example: __SWITCH-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch.json) required: true schema: $ref: "#/definitions/relationship" @@ -5336,16 +6854,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: switch-name in: path description: DVS switch name required: true type: string + example: __SWITCH-NAME__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/dvs-switches/dvs-switch/{switch-name}: get: tags: @@ -5360,7 +6881,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/dvs-switch" + $ref: "#/getDefinitions/dvs-switch" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -5369,16 +6890,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: switch-name in: path description: DVS switch name required: true type: string + example: __SWITCH-NAME__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -5398,7 +6922,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing dvs-switch - description: create or update an existing dvs-switch + description: | + Create or update an existing dvs-switch. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch consumes: - application/json @@ -5415,22 +6942,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: switch-name in: path description: DVS switch name required: true type: string + example: __SWITCH-NAME__ - name: body in: body - description: dvs-switch object that needs to be created or updated + description: dvs-switch object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch.json) required: true schema: $ref: "#/definitions/dvs-switch" + patch: + tags: + - CloudInfrastructure + summary: update an existing dvs-switch + description: | + Update an existing dvs-switch + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: switch-name + in: path + description: DVS switch name + required: true + type: string + example: __SWITCH-NAME__ + - name: body + in: body + description: dvs-switch object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/dvs-switch" delete: tags: - CloudInfrastructure @@ -5452,16 +7033,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: switch-name in: path description: DVS switch name required: true type: string + example: __SWITCH-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -5481,7 +7065,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/dvs-switches" + $ref: "#/getDefinitions/dvs-switches" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -5490,11 +7074,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -5526,19 +7112,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: network-uuid in: path description: UUID of the network. Unique across a cloud-region required: true type: string + example: __NETWORK-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork.json) required: true schema: $ref: "#/definitions/relationship" @@ -5563,16 +7152,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: network-uuid in: path description: UUID of the network. Unique across a cloud-region required: true type: string + example: __NETWORK-UUID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/oam-networks/oam-network/{network-uuid}: get: tags: @@ -5587,7 +7179,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/oam-network" + $ref: "#/getDefinitions/oam-network" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -5596,16 +7188,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: network-uuid in: path description: UUID of the network. Unique across a cloud-region required: true type: string + example: __NETWORK-UUID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -5631,7 +7226,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing oam-network - description: create or update an existing oam-network + description: | + Create or update an existing oam-network. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork consumes: - application/json @@ -5648,22 +7246,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: network-uuid in: path description: UUID of the network. Unique across a cloud-region required: true type: string + example: __NETWORK-UUID__ - name: body in: body - description: oam-network object that needs to be created or updated + description: oam-network object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork.json) required: true schema: $ref: "#/definitions/oam-network" + patch: + tags: + - CloudInfrastructure + summary: update an existing oam-network + description: | + Update an existing oam-network + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: network-uuid + in: path + description: UUID of the network. Unique across a cloud-region + required: true + type: string + example: __NETWORK-UUID__ + - name: body + in: body + description: oam-network object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/oam-network" delete: tags: - CloudInfrastructure @@ -5685,16 +7337,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: network-uuid in: path description: UUID of the network. Unique across a cloud-region required: true type: string + example: __NETWORK-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -5714,7 +7369,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/oam-networks" + $ref: "#/getDefinitions/oam-networks" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -5723,11 +7378,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -5759,19 +7416,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: availability-zone-name in: path description: Name of the availability zone. Unique across a cloud region required: true type: string + example: __AVAILABILITY-ZONE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionAvailabilityZonesAvailabilityZone.json) required: true schema: $ref: "#/definitions/relationship" @@ -5796,16 +7456,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: availability-zone-name in: path description: Name of the availability zone. Unique across a cloud region required: true type: string + example: __AVAILABILITY-ZONE-NAME__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/availability-zones/availability-zone/{availability-zone-name}: get: tags: @@ -5820,7 +7483,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/availability-zone" + $ref: "#/getDefinitions/availability-zone" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -5829,16 +7492,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: availability-zone-name in: path description: Name of the availability zone. Unique across a cloud region required: true type: string + example: __AVAILABILITY-ZONE-NAME__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -5853,7 +7519,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing availability-zone - description: create or update an existing availability-zone + description: | + Create or update an existing availability-zone. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionAvailabilityZonesAvailabilityZone consumes: - application/json @@ -5870,22 +7539,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: availability-zone-name in: path description: Name of the availability zone. Unique across a cloud region required: true type: string + example: __AVAILABILITY-ZONE-NAME__ - name: body in: body - description: availability-zone object that needs to be created or updated + description: availability-zone object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionAvailabilityZonesAvailabilityZone.json) required: true schema: $ref: "#/definitions/availability-zone" + patch: + tags: + - CloudInfrastructure + summary: update an existing availability-zone + description: | + Update an existing availability-zone + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionAvailabilityZonesAvailabilityZone + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: availability-zone-name + in: path + description: Name of the availability zone. Unique across a cloud region + required: true + type: string + example: __AVAILABILITY-ZONE-NAME__ + - name: body + in: body + description: availability-zone object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/availability-zone" delete: tags: - CloudInfrastructure @@ -5907,16 +7630,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: availability-zone-name in: path description: Name of the availability zone. Unique across a cloud region required: true type: string + example: __AVAILABILITY-ZONE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -5936,7 +7662,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/availability-zones" + $ref: "#/getDefinitions/availability-zones" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -5945,11 +7671,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -5981,14 +7709,16 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegion.json) required: true schema: $ref: "#/definitions/relationship" @@ -6013,11 +7743,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}/relationship-list/relationship: put: tags: @@ -6039,19 +7771,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: esr-system-info-id in: path description: Unique ID of esr system info. required: true type: string + example: __ESR-SYSTEM-INFO-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo.json) required: true schema: $ref: "#/definitions/relationship" @@ -6076,16 +7811,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: esr-system-info-id in: path description: Unique ID of esr system info. required: true type: string + example: __ESR-SYSTEM-INFO-ID__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}: get: tags: @@ -6100,7 +7838,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/esr-system-info" + $ref: "#/getDefinitions/esr-system-info" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -6109,16 +7847,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: esr-system-info-id in: path description: Unique ID of esr system info. required: true type: string + example: __ESR-SYSTEM-INFO-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -6143,7 +7884,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing esr-system-info - description: create or update an existing esr-system-info + description: | + Create or update an existing esr-system-info. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo consumes: - application/json @@ -6160,22 +7904,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: esr-system-info-id in: path description: Unique ID of esr system info. required: true type: string + example: __ESR-SYSTEM-INFO-ID__ - name: body in: body - description: esr-system-info object that needs to be created or updated + description: esr-system-info object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo.json) required: true schema: $ref: "#/definitions/esr-system-info" + patch: + tags: + - CloudInfrastructure + summary: update an existing esr-system-info + description: | + Update an existing esr-system-info + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: esr-system-info-id + in: path + description: Unique ID of esr system info. + required: true + type: string + example: __ESR-SYSTEM-INFO-ID__ + - name: body + in: body + description: esr-system-info object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/esr-system-info" delete: tags: - CloudInfrastructure @@ -6197,16 +7995,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: esr-system-info-id in: path description: Unique ID of esr system info. required: true type: string + example: __ESR-SYSTEM-INFO-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -6226,7 +8027,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/esr-system-info-list" + $ref: "#/getDefinitions/esr-system-info-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -6235,11 +8036,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -6271,19 +8074,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv4-address in: path description: IP address required: true type: string + example: __VIP-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -6308,16 +8114,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv4-address in: path description: IP address required: true type: string + example: __VIP-IPV4-ADDRESS__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/vip-ipv4-address-list/{vip-ipv4-address}: get: tags: @@ -6332,7 +8141,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vip-ipv4-address-list" + $ref: "#/getDefinitions/vip-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -6341,16 +8150,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv4-address in: path description: IP address required: true type: string + example: __VIP-IPV4-ADDRESS__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -6381,7 +8193,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing vip-ipv4-address-list - description: create or update an existing vip-ipv4-address-list + description: | + Create or update an existing vip-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList consumes: - application/json @@ -6398,22 +8213,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv4-address in: path description: IP address required: true type: string + example: __VIP-IPV4-ADDRESS__ - name: body in: body - description: vip-ipv4-address-list object that needs to be created or updated + description: vip-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList.json) required: true schema: $ref: "#/definitions/vip-ipv4-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing vip-ipv4-address-list + description: | + Update an existing vip-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: vip-ipv4-address + in: path + description: IP address + required: true + type: string + example: __VIP-IPV4-ADDRESS__ + - name: body + in: body + description: vip-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vip-ipv4-address-list" delete: tags: - CloudInfrastructure @@ -6435,16 +8304,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv4-address in: path description: IP address required: true type: string + example: __VIP-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -6471,19 +8343,22 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv6-address in: path description: IP address required: true type: string + example: __VIP-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -6508,16 +8383,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv6-address in: path description: IP address required: true type: string + example: __VIP-IPV6-ADDRESS__ /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/vip-ipv6-address-list/{vip-ipv6-address}: get: tags: @@ -6532,7 +8410,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vip-ipv6-address-list" + $ref: "#/getDefinitions/vip-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -6541,16 +8419,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv6-address in: path description: IP address required: true type: string + example: __VIP-IPV6-ADDRESS__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -6581,7 +8462,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing vip-ipv6-address-list - description: create or update an existing vip-ipv6-address-list + description: | + Create or update an existing vip-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList consumes: - application/json @@ -6598,22 +8482,76 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv6-address in: path description: IP address required: true type: string + example: __VIP-IPV6-ADDRESS__ - name: body in: body - description: vip-ipv6-address-list object that needs to be created or updated + description: vip-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList.json) required: true schema: $ref: "#/definitions/vip-ipv6-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing vip-ipv6-address-list + description: | + Update an existing vip-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: vip-ipv6-address + in: path + description: IP address + required: true + type: string + example: __VIP-IPV6-ADDRESS__ + - name: body + in: body + description: vip-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vip-ipv6-address-list" delete: tags: - CloudInfrastructure @@ -6635,16 +8573,19 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: vip-ipv6-address in: path description: IP address required: true type: string + example: __VIP-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -6664,7 +8605,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/cloud-region" + $ref: "#/getDefinitions/cloud-region" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -6673,11 +8614,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: cloud-type in: query description: Type of the cloud (e.g., openstack) @@ -6692,7 +8635,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing cloud-region - description: create or update an existing cloud-region + description: | + Create or update an existing cloud-region. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegion consumes: - application/json @@ -6709,17 +8655,64 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: body in: body - description: cloud-region object that needs to be created or updated + description: cloud-region object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegion.json) required: true schema: $ref: "#/definitions/cloud-region" + patch: + tags: + - CloudInfrastructure + summary: update an existing cloud-region + description: | + Update an existing cloud-region + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureCloudRegionsCloudRegion + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: cloud-owner + in: path + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + required: true + type: string + example: __CLOUD-OWNER__ + - name: cloud-region-id + in: path + description: Identifier used by the vendor for the region. Second part of composite key + required: true + type: string + example: __CLOUD-REGION-ID__ + - name: body + in: body + description: cloud-region object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/cloud-region" delete: tags: - CloudInfrastructure @@ -6741,11 +8734,13 @@ paths: description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname required: true type: string + example: __CLOUD-OWNER__ - name: cloud-region-id in: path description: Identifier used by the vendor for the region. Second part of composite key required: true type: string + example: __CLOUD-REGION-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -6765,7 +8760,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/cloud-regions" + $ref: "#/getDefinitions/cloud-regions" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /cloud-infrastructure/network-profiles/network-profile/{nm-profile-name}/relationship-list/relationship: @@ -6789,9 +8784,10 @@ paths: description: Unique name of network profile. required: true type: string + example: __NM-PROFILE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureNetworkProfilesNetworkProfile.json) required: true schema: $ref: "#/definitions/relationship" @@ -6816,6 +8812,7 @@ paths: description: Unique name of network profile. required: true type: string + example: __NM-PROFILE-NAME__ /cloud-infrastructure/network-profiles/network-profile/{nm-profile-name}: get: tags: @@ -6830,7 +8827,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/network-profile" + $ref: "#/getDefinitions/network-profile" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -6839,11 +8836,15 @@ paths: description: Unique name of network profile. required: true type: string + example: __NM-PROFILE-NAME__ put: tags: - CloudInfrastructure summary: create or update an existing network-profile - description: create or update an existing network-profile + description: | + Create or update an existing network-profile. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureNetworkProfilesNetworkProfile consumes: - application/json @@ -6860,12 +8861,52 @@ paths: description: Unique name of network profile. required: true type: string + example: __NM-PROFILE-NAME__ - name: body in: body - description: network-profile object that needs to be created or updated + description: network-profile object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureNetworkProfilesNetworkProfile.json) required: true schema: $ref: "#/definitions/network-profile" + patch: + tags: + - CloudInfrastructure + summary: update an existing network-profile + description: | + Update an existing network-profile + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureNetworkProfilesNetworkProfile + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: nm-profile-name + in: path + description: Unique name of network profile. + required: true + type: string + example: __NM-PROFILE-NAME__ + - name: body + in: body + description: network-profile object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/network-profile" delete: tags: - CloudInfrastructure @@ -6887,6 +8928,7 @@ paths: description: Unique name of network profile. required: true type: string + example: __NM-PROFILE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -6906,7 +8948,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/network-profiles" + $ref: "#/getDefinitions/network-profiles" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /cloud-infrastructure/pservers/pserver/{hostname}/relationship-list/relationship: @@ -6930,9 +8972,10 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserver.json) required: true schema: $ref: "#/definitions/relationship" @@ -6957,6 +9000,7 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship: put: tags: @@ -6978,14 +9022,16 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -7010,11 +9056,13 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship: put: tags: @@ -7036,19 +9084,22 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf.json) required: true schema: $ref: "#/definitions/relationship" @@ -7073,16 +9124,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}: get: tags: @@ -7097,7 +9151,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-pf" + $ref: "#/getDefinitions/sriov-pf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -7106,16 +9160,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -7144,7 +9201,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing sriov-pf - description: create or update an existing sriov-pf + description: | + Create or update an existing sriov-pf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf consumes: - application/json @@ -7161,22 +9221,76 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: body in: body - description: sriov-pf object that needs to be created or updated + description: sriov-pf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf.json) required: true schema: $ref: "#/definitions/sriov-pf" + patch: + tags: + - CloudInfrastructure + summary: update an existing sriov-pf + description: | + Update an existing sriov-pf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pf-pci-id + in: path + description: Identifier for the sriov-pf + required: true + type: string + example: __PF-PCI-ID__ + - name: body + in: body + description: sriov-pf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-pf" delete: tags: - CloudInfrastructure @@ -7198,16 +9312,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -7227,7 +9344,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-pfs" + $ref: "#/getDefinitions/sriov-pfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -7236,11 +9353,13 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -7286,24 +9405,28 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -7328,21 +9451,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -7364,29 +9491,34 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -7411,26 +9543,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -7445,7 +9582,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -7454,26 +9591,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -7544,7 +9686,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -7561,32 +9706,100 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - CloudInfrastructure @@ -7608,26 +9821,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -7654,29 +9872,34 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -7701,26 +9924,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -7735,7 +9963,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -7744,26 +9972,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -7834,7 +10067,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -7851,32 +10087,100 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - CloudInfrastructure @@ -7898,26 +10202,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -7937,7 +10246,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -7946,21 +10255,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -8015,7 +10328,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -8032,27 +10348,88 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - CloudInfrastructure + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - CloudInfrastructure @@ -8074,21 +10451,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -8108,7 +10489,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -8117,16 +10498,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -8187,24 +10571,28 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -8229,21 +10617,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -8258,7 +10650,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -8267,21 +10659,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -8345,7 +10741,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -8362,27 +10761,88 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - CloudInfrastructure + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - CloudInfrastructure @@ -8404,21 +10864,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -8438,7 +10902,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -8447,16 +10911,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -8517,19 +10984,22 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -8554,16 +11024,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -8585,24 +11058,28 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -8627,21 +11104,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -8656,7 +11137,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -8665,21 +11146,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -8739,7 +11224,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -8756,27 +11244,88 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - CloudInfrastructure @@ -8798,21 +11347,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -8839,24 +11392,28 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -8881,21 +11438,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -8910,7 +11471,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -8919,21 +11480,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -8993,7 +11558,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -9010,27 +11578,88 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - CloudInfrastructure @@ -9052,21 +11681,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -9086,7 +11719,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -9095,16 +11728,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -9148,7 +11784,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface consumes: - application/json @@ -9165,22 +11804,76 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - CloudInfrastructure + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - CloudInfrastructure @@ -9202,16 +11895,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -9231,7 +11927,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -9240,11 +11936,13 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -9283,7 +11981,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/p-interface" + $ref: "#/getDefinitions/p-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -9292,11 +11990,13 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -9325,7 +12025,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing p-interface - description: create or update an existing p-interface + description: | + Create or update an existing p-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterface consumes: - application/json @@ -9342,17 +12045,64 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: p-interface object that needs to be created or updated + description: p-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterface.json) required: true schema: $ref: "#/definitions/p-interface" + patch: + tags: + - CloudInfrastructure + summary: update an existing p-interface + description: | + Update an existing p-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: p-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/p-interface" delete: tags: - CloudInfrastructure @@ -9374,11 +12124,13 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -9398,7 +12150,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/p-interfaces" + $ref: "#/getDefinitions/p-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -9407,6 +12159,7 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -9447,14 +12200,16 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -9479,11 +12234,13 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship: put: tags: @@ -9505,24 +12262,28 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -9547,21 +12308,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -9583,29 +12348,34 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -9630,26 +12400,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -9664,7 +12439,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -9673,26 +12448,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -9768,7 +12548,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -9785,32 +12568,100 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - CloudInfrastructure @@ -9832,26 +12683,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -9878,29 +12734,34 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -9925,26 +12786,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -9959,7 +12825,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -9968,26 +12834,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -10063,7 +12934,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -10080,32 +12954,100 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - CloudInfrastructure @@ -10127,26 +13069,31 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -10166,7 +13113,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -10175,21 +13122,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -10249,7 +13200,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -10266,27 +13220,88 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - CloudInfrastructure + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - CloudInfrastructure @@ -10308,21 +13323,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -10342,7 +13361,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -10351,16 +13370,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -10426,24 +13448,28 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -10468,21 +13494,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -10497,7 +13527,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -10506,21 +13536,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -10589,7 +13623,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -10606,27 +13643,88 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - CloudInfrastructure + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - CloudInfrastructure @@ -10648,21 +13746,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -10682,7 +13784,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -10691,16 +13793,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -10766,19 +13871,22 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -10803,16 +13911,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -10834,24 +13945,28 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -10876,21 +13991,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -10905,7 +14024,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -10914,21 +14033,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -10993,7 +14116,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -11010,27 +14136,88 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - CloudInfrastructure @@ -11052,21 +14239,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -11093,24 +14284,28 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -11135,21 +14330,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -11164,7 +14363,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -11173,21 +14372,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -11252,7 +14455,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -11269,27 +14475,88 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - CloudInfrastructure + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - CloudInfrastructure @@ -11311,21 +14578,25 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -11345,7 +14616,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -11354,16 +14625,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -11412,7 +14686,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface consumes: - application/json @@ -11429,22 +14706,76 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - CloudInfrastructure + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - CloudInfrastructure @@ -11466,16 +14797,19 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -11495,7 +14829,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -11504,11 +14838,13 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -11552,7 +14888,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-interface" + $ref: "#/getDefinitions/lag-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -11561,11 +14897,13 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -11599,7 +14937,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing lag-interface - description: create or update an existing lag-interface + description: | + Create or update an existing lag-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterface consumes: - application/json @@ -11616,17 +14957,64 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: lag-interface object that needs to be created or updated + description: lag-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterface.json) required: true schema: $ref: "#/definitions/lag-interface" + patch: + tags: + - CloudInfrastructure + summary: update an existing lag-interface + description: | + Update an existing lag-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: lag-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/lag-interface" delete: tags: - CloudInfrastructure @@ -11648,11 +15036,13 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -11672,7 +15062,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-interfaces" + $ref: "#/getDefinitions/lag-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -11681,6 +15071,7 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -11714,7 +15105,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/pserver" + $ref: "#/getDefinitions/pserver" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -11723,6 +15114,7 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -11746,7 +15138,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing pserver - description: create or update an existing pserver + description: | + Create or update an existing pserver. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructurePserversPserver consumes: - application/json @@ -11763,12 +15158,52 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: body in: body - description: pserver object that needs to be created or updated + description: pserver object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserver.json) required: true schema: $ref: "#/definitions/pserver" + patch: + tags: + - CloudInfrastructure + summary: update an existing pserver + description: | + Update an existing pserver + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructurePserversPserver + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: hostname + in: path + description: Value from executing hostname on the compute node. + required: true + type: string + example: __HOSTNAME__ + - name: body + in: body + description: pserver object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/pserver" delete: tags: - CloudInfrastructure @@ -11790,6 +15225,7 @@ paths: description: Value from executing hostname on the compute node. required: true type: string + example: __HOSTNAME__ - name: resource-version in: query description: resource-version for concurrency @@ -11809,7 +15245,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/pservers" + $ref: "#/getDefinitions/pservers" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /cloud-infrastructure/virtual-data-centers/virtual-data-center/{vdc-id}/relationship-list/relationship: @@ -11833,9 +15269,10 @@ paths: description: Unique ID of the vdc required: true type: string + example: __VDC-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureVirtualDataCentersVirtualDataCenter.json) required: true schema: $ref: "#/definitions/relationship" @@ -11860,6 +15297,7 @@ paths: description: Unique ID of the vdc required: true type: string + example: __VDC-ID__ /cloud-infrastructure/virtual-data-centers/virtual-data-center/{vdc-id}: get: tags: @@ -11874,7 +15312,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/virtual-data-center" + $ref: "#/getDefinitions/virtual-data-center" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -11883,6 +15321,7 @@ paths: description: Unique ID of the vdc required: true type: string + example: __VDC-ID__ - name: vdc-name in: query description: Name of the virtual data center @@ -11892,7 +15331,10 @@ paths: tags: - CloudInfrastructure summary: create or update an existing virtual-data-center - description: create or update an existing virtual-data-center + description: | + Create or update an existing virtual-data-center. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateCloudInfrastructureVirtualDataCentersVirtualDataCenter consumes: - application/json @@ -11909,18 +15351,30 @@ paths: description: Unique ID of the vdc required: true type: string + example: __VDC-ID__ - name: body in: body - description: virtual-data-center object that needs to be created or updated + description: virtual-data-center object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureVirtualDataCentersVirtualDataCenter.json) required: true schema: $ref: "#/definitions/virtual-data-center" - delete: + patch: tags: - CloudInfrastructure - summary: delete an existing virtual-data-center - description: delete an existing virtual-data-center - operationId: deleteCloudInfrastructureVirtualDataCentersVirtualDataCenter + summary: update an existing virtual-data-center + description: | + Update an existing virtual-data-center + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateCloudInfrastructureVirtualDataCentersVirtualDataCenter consumes: - application/json - application/xml @@ -11936,960 +15390,19 @@ paths: description: Unique ID of the vdc required: true type: string - - name: resource-version - in: query - description: resource-version for concurrency - required: true - type: string - /cloud-infrastructure/virtual-data-centers: - get: - tags: - - CloudInfrastructure - summary: returns virtual-data-centers - description: returns virtual-data-centers - operationId: getCloudInfrastructureVirtualDataCenters - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/virtual-data-centers" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - /external-system/esr-ems-list/esr-ems/{ems-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}/relationship-list/relationship: - put: - tags: - - ExternalSystem - summary: see node definition for valid relationships - operationId: createOrUpdateExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfoRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: body - in: body - description: relationship object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/relationship" - delete: - tags: - - ExternalSystem - summary: delete an existing relationship - description: delete an existing relationship - operationId: deleteExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfoRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - /external-system/esr-ems-list/esr-ems/{ems-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}: - get: - tags: - - ExternalSystem - summary: returns esr-system-info - description: returns esr-system-info - operationId: getExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfo - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-system-info" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: system-name - in: query - description: name of external system. - required: false - type: string - - name: system-type - in: query - description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm. - required: false - type: string - put: - tags: - - ExternalSystem - summary: create or update an existing esr-system-info - description: create or update an existing esr-system-info - operationId: createOrUpdateExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfo - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string + example: __VDC-ID__ - name: body in: body - description: esr-system-info object that needs to be created or updated + description: virtual-data-center object that needs to be created or updated. required: true schema: - $ref: "#/definitions/esr-system-info" + $ref: "#/patchDefinitions/virtual-data-center" delete: tags: - - ExternalSystem - summary: delete an existing esr-system-info - description: delete an existing esr-system-info - operationId: deleteExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfo - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: resource-version - in: query - description: resource-version for concurrency - required: true - type: string - /external-system/esr-ems-list/esr-ems/{ems-id}/esr-system-info-list: - get: - tags: - - ExternalSystem - summary: returns esr-system-info-list - description: returns esr-system-info-list - operationId: getExternalSystemEsrEmsListEsrEmsEsrSystemInfoList - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-system-info-list" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - /external-system/esr-ems-list/esr-ems/{ems-id}/relationship-list/relationship: - put: - tags: - - ExternalSystem - summary: see node definition for valid relationships - operationId: createOrUpdateExternalSystemEsrEmsListEsrEmsRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - - name: body - in: body - description: relationship object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/relationship" - delete: - tags: - - ExternalSystem - summary: delete an existing relationship - description: delete an existing relationship - operationId: deleteExternalSystemEsrEmsListEsrEmsRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - /external-system/esr-ems-list/esr-ems/{ems-id}: - get: - tags: - - ExternalSystem - summary: returns esr-ems - description: returns esr-ems - operationId: getExternalSystemEsrEmsListEsrEms - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-ems" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - put: - tags: - - ExternalSystem - summary: create or update an existing esr-ems - description: create or update an existing esr-ems - operationId: createOrUpdateExternalSystemEsrEmsListEsrEms - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - - name: body - in: body - description: esr-ems object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/esr-ems" - delete: - tags: - - ExternalSystem - summary: delete an existing esr-ems - description: delete an existing esr-ems - operationId: deleteExternalSystemEsrEmsListEsrEms - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: ems-id - in: path - description: Unique ID of EMS. - required: true - type: string - - name: resource-version - in: query - description: resource-version for concurrency - required: true - type: string - /external-system/esr-ems-list: - get: - tags: - - ExternalSystem - summary: returns esr-ems-list - description: returns esr-ems-list - operationId: getExternalSystemEsrEmsList - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-ems-list" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}/relationship-list/relationship: - put: - tags: - - ExternalSystem - summary: see node definition for valid relationships - operationId: createOrUpdateExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfoRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: body - in: body - description: relationship object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/relationship" - delete: - tags: - - ExternalSystem - summary: delete an existing relationship - description: delete an existing relationship - operationId: deleteExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfoRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}: - get: - tags: - - ExternalSystem - summary: returns esr-system-info - description: returns esr-system-info - operationId: getExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfo - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-system-info" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: system-name - in: query - description: name of external system. - required: false - type: string - - name: system-type - in: query - description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm. - required: false - type: string - put: - tags: - - ExternalSystem - summary: create or update an existing esr-system-info - description: create or update an existing esr-system-info - operationId: createOrUpdateExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfo - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: body - in: body - description: esr-system-info object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/esr-system-info" - delete: - tags: - - ExternalSystem - summary: delete an existing esr-system-info - description: delete an existing esr-system-info - operationId: deleteExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfo - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: resource-version - in: query - description: resource-version for concurrency - required: true - type: string - /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}/esr-system-info-list: - get: - tags: - - ExternalSystem - summary: returns esr-system-info-list - description: returns esr-system-info-list - operationId: getExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoList - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-system-info-list" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}/relationship-list/relationship: - put: - tags: - - ExternalSystem - summary: see node definition for valid relationships - operationId: createOrUpdateExternalSystemEsrVnfmListEsrVnfmRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - - name: body - in: body - description: relationship object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/relationship" - delete: - tags: - - ExternalSystem - summary: delete an existing relationship - description: delete an existing relationship - operationId: deleteExternalSystemEsrVnfmListEsrVnfmRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}: - get: - tags: - - ExternalSystem - summary: returns esr-vnfm - description: returns esr-vnfm - operationId: getExternalSystemEsrVnfmListEsrVnfm - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-vnfm" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - put: - tags: - - ExternalSystem - summary: create or update an existing esr-vnfm - description: create or update an existing esr-vnfm - operationId: createOrUpdateExternalSystemEsrVnfmListEsrVnfm - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - - name: body - in: body - description: esr-vnfm object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/esr-vnfm" - delete: - tags: - - ExternalSystem - summary: delete an existing esr-vnfm - description: delete an existing esr-vnfm - operationId: deleteExternalSystemEsrVnfmListEsrVnfm - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: vnfm-id - in: path - description: Unique ID of VNFM. - required: true - type: string - - name: resource-version - in: query - description: resource-version for concurrency - required: true - type: string - /external-system/esr-vnfm-list: - get: - tags: - - ExternalSystem - summary: returns esr-vnfm-list - description: returns esr-vnfm-list - operationId: getExternalSystemEsrVnfmList - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-vnfm-list" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}/relationship-list/relationship: - put: - tags: - - ExternalSystem - summary: see node definition for valid relationships - operationId: createOrUpdateExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfoRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: body - in: body - description: relationship object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/relationship" - delete: - tags: - - ExternalSystem - summary: delete an existing relationship - description: delete an existing relationship - operationId: deleteExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfoRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}: - get: - tags: - - ExternalSystem - summary: returns esr-system-info - description: returns esr-system-info - operationId: getExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfo - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-system-info" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: system-name - in: query - description: name of external system. - required: false - type: string - - name: system-type - in: query - description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm. - required: false - type: string - put: - tags: - - ExternalSystem - summary: create or update an existing esr-system-info - description: create or update an existing esr-system-info - operationId: createOrUpdateExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfo - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: body - in: body - description: esr-system-info object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/esr-system-info" - delete: - tags: - - ExternalSystem - summary: delete an existing esr-system-info - description: delete an existing esr-system-info - operationId: deleteExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfo - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - - name: esr-system-info-id - in: path - description: Unique ID of esr system info. - required: true - type: string - - name: resource-version - in: query - description: resource-version for concurrency - required: true - type: string - /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}/esr-system-info-list: - get: - tags: - - ExternalSystem - summary: returns esr-system-info-list - description: returns esr-system-info-list - operationId: getExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoList - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-system-info-list" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}/relationship-list/relationship: - put: - tags: - - ExternalSystem - summary: see node definition for valid relationships - operationId: createOrUpdateExternalSystemEsrThirdpartySdncListEsrThirdpartySdncRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - - name: body - in: body - description: relationship object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/relationship" - delete: - tags: - - ExternalSystem - summary: delete an existing relationship - description: delete an existing relationship - operationId: deleteExternalSystemEsrThirdpartySdncListEsrThirdpartySdncRelationshipListRelationship - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}: - get: - tags: - - ExternalSystem - summary: returns esr-thirdparty-sdnc - description: returns esr-thirdparty-sdnc - operationId: getExternalSystemEsrThirdpartySdncListEsrThirdpartySdnc - produces: - - application/json - - application/xml - responses: - "200": - description: successful operation - schema: - $ref: "#/definitions/esr-thirdparty-sdnc" - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - put: - tags: - - ExternalSystem - summary: create or update an existing esr-thirdparty-sdnc - description: create or update an existing esr-thirdparty-sdnc - operationId: createOrUpdateExternalSystemEsrThirdpartySdncListEsrThirdpartySdnc - consumes: - - application/json - - application/xml - produces: - - application/json - - application/xml - responses: - "default": - description: Response codes found in [response codes](https://wiki.onap.org/). - parameters: - - name: thirdparty-sdnc-id - in: path - description: Unique ID of SDNC. - required: true - type: string - - name: body - in: body - description: esr-thirdparty-sdnc object that needs to be created or updated - required: true - schema: - $ref: "#/definitions/esr-thirdparty-sdnc" - delete: - tags: - - ExternalSystem - summary: delete an existing esr-thirdparty-sdnc - description: delete an existing esr-thirdparty-sdnc - operationId: deleteExternalSystemEsrThirdpartySdncListEsrThirdpartySdnc + - CloudInfrastructure + summary: delete an existing virtual-data-center + description: delete an existing virtual-data-center + operationId: deleteCloudInfrastructureVirtualDataCentersVirtualDataCenter consumes: - application/json - application/xml @@ -12900,23 +15413,24 @@ paths: "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: - - name: thirdparty-sdnc-id + - name: vdc-id in: path - description: Unique ID of SDNC. + description: Unique ID of the vdc required: true type: string + example: __VDC-ID__ - name: resource-version in: query description: resource-version for concurrency required: true type: string - /external-system/esr-thirdparty-sdnc-list: + /cloud-infrastructure/virtual-data-centers: get: tags: - - ExternalSystem - summary: returns esr-thirdparty-sdnc-list - description: returns esr-thirdparty-sdnc-list - operationId: getExternalSystemEsrThirdpartySdncList + - CloudInfrastructure + summary: returns virtual-data-centers + description: returns virtual-data-centers + operationId: getCloudInfrastructureVirtualDataCenters produces: - application/json - application/xml @@ -12924,7 +15438,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/esr-thirdparty-sdnc-list" + $ref: "#/getDefinitions/virtual-data-centers" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /business/connectors/connector/{resource-instance-id}/relationship-list/relationship: @@ -12948,9 +15462,10 @@ paths: description: Unique id of resource instance. required: true type: string + example: __RESOURCE-INSTANCE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessConnectorsConnector.json) required: true schema: $ref: "#/definitions/relationship" @@ -12975,6 +15490,7 @@ paths: description: Unique id of resource instance. required: true type: string + example: __RESOURCE-INSTANCE-ID__ /business/connectors/connector/{resource-instance-id}/metadata/metadatum/{metaname}: get: tags: @@ -12989,7 +15505,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/metadatum" + $ref: "#/getDefinitions/metadatum" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -12998,10 +15514,12 @@ paths: description: Unique id of resource instance. required: true type: string + example: __RESOURCE-INSTANCE-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: model-invariant-id in: query description: the ASDC model id for this resource or service model. @@ -13026,7 +15544,10 @@ paths: tags: - Business summary: create or update an existing metadatum - description: create or update an existing metadatum + description: | + Create or update an existing metadatum. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessConnectorsConnectorMetadataMetadatum consumes: - application/json @@ -13043,16 +15564,62 @@ paths: description: Unique id of resource instance. required: true type: string + example: __RESOURCE-INSTANCE-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: body in: body - description: metadatum object that needs to be created or updated + description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessConnectorsConnectorMetadataMetadatum.json) required: true schema: $ref: "#/definitions/metadatum" + patch: + tags: + - Business + summary: update an existing metadatum + description: | + Update an existing metadatum + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessConnectorsConnectorMetadataMetadatum + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: resource-instance-id + in: path + description: Unique id of resource instance. + required: true + type: string + example: __RESOURCE-INSTANCE-ID__ + - name: metaname + in: path + required: true + type: string + example: __METANAME__ + - name: body + in: body + description: metadatum object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/metadatum" delete: tags: - Business @@ -13074,10 +15641,12 @@ paths: description: Unique id of resource instance. required: true type: string + example: __RESOURCE-INSTANCE-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: resource-version in: query description: resource-version for concurrency @@ -13097,7 +15666,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/metadata" + $ref: "#/getDefinitions/metadata" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -13106,6 +15675,7 @@ paths: description: Unique id of resource instance. required: true type: string + example: __RESOURCE-INSTANCE-ID__ - name: model-invariant-id in: query description: the ASDC model id for this resource or service model. @@ -13140,7 +15710,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/connector" + $ref: "#/getDefinitions/connector" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -13149,6 +15719,7 @@ paths: description: Unique id of resource instance. required: true type: string + example: __RESOURCE-INSTANCE-ID__ - name: model-invariant-id in: query description: the ASDC model id for this resource or service model. @@ -13173,7 +15744,10 @@ paths: tags: - Business summary: create or update an existing connector - description: create or update an existing connector + description: | + Create or update an existing connector. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessConnectorsConnector consumes: - application/json @@ -13190,12 +15764,52 @@ paths: description: Unique id of resource instance. required: true type: string + example: __RESOURCE-INSTANCE-ID__ - name: body in: body - description: connector object that needs to be created or updated + description: connector object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessConnectorsConnector.json) required: true schema: $ref: "#/definitions/connector" + patch: + tags: + - Business + summary: update an existing connector + description: | + Update an existing connector + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessConnectorsConnector + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: resource-instance-id + in: path + description: Unique id of resource instance. + required: true + type: string + example: __RESOURCE-INSTANCE-ID__ + - name: body + in: body + description: connector object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/connector" delete: tags: - Business @@ -13217,6 +15831,7 @@ paths: description: Unique id of resource instance. required: true type: string + example: __RESOURCE-INSTANCE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -13236,7 +15851,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/connectors" + $ref: "#/getDefinitions/connectors" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/relationship-list/relationship: @@ -13260,19 +15875,22 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstance.json) required: true schema: $ref: "#/definitions/relationship" @@ -13297,16 +15915,19 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/metadata/metadatum/{metaname}: get: tags: @@ -13321,7 +15942,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/metadatum" + $ref: "#/getDefinitions/metadatum" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -13330,20 +15951,24 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -13403,7 +16028,10 @@ paths: tags: - Business summary: create or update an existing metadatum - description: create or update an existing metadatum + description: | + Create or update an existing metadatum. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceMetadataMetadatum consumes: - application/json @@ -13420,26 +16048,86 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: body in: body - description: metadatum object that needs to be created or updated + description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceMetadataMetadatum.json) required: true schema: $ref: "#/definitions/metadatum" + patch: + tags: + - Business + summary: update an existing metadatum + description: | + Update an existing metadatum + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceMetadataMetadatum + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: global-customer-id + in: path + description: Global customer id used across ECOMP to uniquely identify customer. + required: true + type: string + example: __GLOBAL-CUSTOMER-ID__ + - name: service-type + in: path + description: Value defined by orchestration to identify this service across ECOMP. + required: true + type: string + example: __SERVICE-TYPE__ + - name: service-instance-id + in: path + description: Uniquely identifies this instance of a service + required: true + type: string + example: __SERVICE-INSTANCE-ID__ + - name: metaname + in: path + required: true + type: string + example: __METANAME__ + - name: body + in: body + description: metadatum object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/metadatum" delete: tags: - Business @@ -13461,20 +16149,24 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: resource-version in: query description: resource-version for concurrency @@ -13494,7 +16186,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/metadata" + $ref: "#/getDefinitions/metadata" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -13503,16 +16195,19 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -13589,29 +16284,34 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResourceTunnelXconnectsTunnelXconnect.json) required: true schema: $ref: "#/definitions/relationship" @@ -13636,26 +16336,31 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/allotted-resources/allotted-resource/{id}/tunnel-xconnects/tunnel-xconnect/{id}: get: tags: @@ -13670,7 +16375,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/tunnel-xconnect" + $ref: "#/getDefinitions/tunnel-xconnect" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -13679,26 +16384,31 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -13778,7 +16488,10 @@ paths: tags: - Business summary: create or update an existing tunnel-xconnect - description: create or update an existing tunnel-xconnect + description: | + Create or update an existing tunnel-xconnect. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResourceTunnelXconnectsTunnelXconnect consumes: - application/json @@ -13795,32 +16508,100 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: body in: body - description: tunnel-xconnect object that needs to be created or updated + description: tunnel-xconnect object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResourceTunnelXconnectsTunnelXconnect.json) required: true schema: $ref: "#/definitions/tunnel-xconnect" + patch: + tags: + - Business + summary: update an existing tunnel-xconnect + description: | + Update an existing tunnel-xconnect + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResourceTunnelXconnectsTunnelXconnect + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: global-customer-id + in: path + description: Global customer id used across ECOMP to uniquely identify customer. + required: true + type: string + example: __GLOBAL-CUSTOMER-ID__ + - name: service-type + in: path + description: Value defined by orchestration to identify this service across ECOMP. + required: true + type: string + example: __SERVICE-TYPE__ + - name: service-instance-id + in: path + description: Uniquely identifies this instance of a service + required: true + type: string + example: __SERVICE-INSTANCE-ID__ + - name: id + in: path + description: Allotted Resource id UUID assigned to this instance. + required: true + type: string + example: __ID__ + - name: id + in: path + description: Allotted Resource id UUID assigned to this instance. + required: true + type: string + example: __ID__ + - name: body + in: body + description: tunnel-xconnect object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/tunnel-xconnect" delete: tags: - Business @@ -13842,26 +16623,31 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: resource-version in: query description: resource-version for concurrency @@ -13881,7 +16667,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/tunnel-xconnects" + $ref: "#/getDefinitions/tunnel-xconnects" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -13890,21 +16676,25 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -14001,24 +16791,28 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResource.json) required: true schema: $ref: "#/definitions/relationship" @@ -14043,21 +16837,25 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/allotted-resources/allotted-resource/{id}: get: tags: @@ -14072,7 +16870,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/allotted-resource" + $ref: "#/getDefinitions/allotted-resource" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -14081,21 +16879,25 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -14175,7 +16977,10 @@ paths: tags: - Business summary: create or update an existing allotted-resource - description: create or update an existing allotted-resource + description: | + Create or update an existing allotted-resource. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResource consumes: - application/json @@ -14192,27 +16997,88 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: body in: body - description: allotted-resource object that needs to be created or updated + description: allotted-resource object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResource.json) required: true schema: $ref: "#/definitions/allotted-resource" + patch: + tags: + - Business + summary: update an existing allotted-resource + description: | + Update an existing allotted-resource + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResource + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: global-customer-id + in: path + description: Global customer id used across ECOMP to uniquely identify customer. + required: true + type: string + example: __GLOBAL-CUSTOMER-ID__ + - name: service-type + in: path + description: Value defined by orchestration to identify this service across ECOMP. + required: true + type: string + example: __SERVICE-TYPE__ + - name: service-instance-id + in: path + description: Uniquely identifies this instance of a service + required: true + type: string + example: __SERVICE-INSTANCE-ID__ + - name: id + in: path + description: Allotted Resource id UUID assigned to this instance. + required: true + type: string + example: __ID__ + - name: body + in: body + description: allotted-resource object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/allotted-resource" delete: tags: - Business @@ -14234,21 +17100,25 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: id in: path description: Allotted Resource id UUID assigned to this instance. required: true type: string + example: __ID__ - name: resource-version in: query description: resource-version for concurrency @@ -14268,7 +17138,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/allotted-resources" + $ref: "#/getDefinitions/allotted-resources" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -14277,16 +17147,19 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -14356,7 +17229,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/service-instance" + $ref: "#/getDefinitions/service-instance" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -14365,16 +17238,19 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -14434,7 +17310,10 @@ paths: tags: - Business summary: create or update an existing service-instance - description: create or update an existing service-instance + description: | + Create or update an existing service-instance. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstance consumes: - application/json @@ -14451,22 +17330,76 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: body in: body - description: service-instance object that needs to be created or updated + description: service-instance object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstance.json) required: true schema: $ref: "#/definitions/service-instance" + patch: + tags: + - Business + summary: update an existing service-instance + description: | + Update an existing service-instance + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstance + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: global-customer-id + in: path + description: Global customer id used across ECOMP to uniquely identify customer. + required: true + type: string + example: __GLOBAL-CUSTOMER-ID__ + - name: service-type + in: path + description: Value defined by orchestration to identify this service across ECOMP. + required: true + type: string + example: __SERVICE-TYPE__ + - name: service-instance-id + in: path + description: Uniquely identifies this instance of a service + required: true + type: string + example: __SERVICE-INSTANCE-ID__ + - name: body + in: body + description: service-instance object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/service-instance" delete: tags: - Business @@ -14488,16 +17421,19 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: service-instance-id in: path description: Uniquely identifies this instance of a service required: true type: string + example: __SERVICE-INSTANCE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -14517,7 +17453,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/service-instances" + $ref: "#/getDefinitions/service-instances" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -14526,11 +17462,13 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -14562,14 +17500,16 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscription.json) required: true schema: $ref: "#/definitions/relationship" @@ -14594,11 +17534,13 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}: get: tags: @@ -14613,7 +17555,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/service-subscription" + $ref: "#/getDefinitions/service-subscription" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -14622,11 +17564,13 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -14641,7 +17585,10 @@ paths: tags: - Business summary: create or update an existing service-subscription - description: create or update an existing service-subscription + description: | + Create or update an existing service-subscription. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscription consumes: - application/json @@ -14658,17 +17605,64 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: body in: body - description: service-subscription object that needs to be created or updated + description: service-subscription object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscription.json) required: true schema: $ref: "#/definitions/service-subscription" + patch: + tags: + - Business + summary: update an existing service-subscription + description: | + Update an existing service-subscription + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscription + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: global-customer-id + in: path + description: Global customer id used across ECOMP to uniquely identify customer. + required: true + type: string + example: __GLOBAL-CUSTOMER-ID__ + - name: service-type + in: path + description: Value defined by orchestration to identify this service across ECOMP. + required: true + type: string + example: __SERVICE-TYPE__ + - name: body + in: body + description: service-subscription object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/service-subscription" delete: tags: - Business @@ -14690,11 +17684,13 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: service-type in: path description: Value defined by orchestration to identify this service across ECOMP. required: true type: string + example: __SERVICE-TYPE__ - name: resource-version in: query description: resource-version for concurrency @@ -14714,7 +17710,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/service-subscriptions" + $ref: "#/getDefinitions/service-subscriptions" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -14723,6 +17719,7 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -14754,9 +17751,10 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomer.json) required: true schema: $ref: "#/definitions/relationship" @@ -14781,6 +17779,7 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ /business/customers/customer/{global-customer-id}: get: tags: @@ -14795,7 +17794,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/customer" + $ref: "#/getDefinitions/customer" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -14804,6 +17803,7 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: subscriber-name in: query description: Subscriber name, an alternate way to retrieve a customer. @@ -14818,7 +17818,10 @@ paths: tags: - Business summary: create or update an existing customer - description: create or update an existing customer + description: | + Create or update an existing customer. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessCustomersCustomer consumes: - application/json @@ -14835,12 +17838,52 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: body in: body - description: customer object that needs to be created or updated + description: customer object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomer.json) required: true schema: $ref: "#/definitions/customer" + patch: + tags: + - Business + summary: update an existing customer + description: | + Update an existing customer + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessCustomersCustomer + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: global-customer-id + in: path + description: Global customer id used across ECOMP to uniquely identify customer. + required: true + type: string + example: __GLOBAL-CUSTOMER-ID__ + - name: body + in: body + description: customer object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/customer" delete: tags: - Business @@ -14862,6 +17905,7 @@ paths: description: Global customer id used across ECOMP to uniquely identify customer. required: true type: string + example: __GLOBAL-CUSTOMER-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -14881,7 +17925,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/customers" + $ref: "#/getDefinitions/customers" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /business/lines-of-business/line-of-business/{line-of-business-name}/relationship-list/relationship: @@ -14905,9 +17949,10 @@ paths: description: Name of the line-of-business (product) required: true type: string + example: __LINE-OF-BUSINESS-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessLinesOfBusinessLineOfBusiness.json) required: true schema: $ref: "#/definitions/relationship" @@ -14932,6 +17977,7 @@ paths: description: Name of the line-of-business (product) required: true type: string + example: __LINE-OF-BUSINESS-NAME__ /business/lines-of-business/line-of-business/{line-of-business-name}: get: tags: @@ -14946,7 +17992,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/line-of-business" + $ref: "#/getDefinitions/line-of-business" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -14955,11 +18001,15 @@ paths: description: Name of the line-of-business (product) required: true type: string + example: __LINE-OF-BUSINESS-NAME__ put: tags: - Business summary: create or update an existing line-of-business - description: create or update an existing line-of-business + description: | + Create or update an existing line-of-business. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessLinesOfBusinessLineOfBusiness consumes: - application/json @@ -14976,12 +18026,52 @@ paths: description: Name of the line-of-business (product) required: true type: string + example: __LINE-OF-BUSINESS-NAME__ - name: body in: body - description: line-of-business object that needs to be created or updated + description: line-of-business object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessLinesOfBusinessLineOfBusiness.json) required: true schema: $ref: "#/definitions/line-of-business" + patch: + tags: + - Business + summary: update an existing line-of-business + description: | + Update an existing line-of-business + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessLinesOfBusinessLineOfBusiness + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: line-of-business-name + in: path + description: Name of the line-of-business (product) + required: true + type: string + example: __LINE-OF-BUSINESS-NAME__ + - name: body + in: body + description: line-of-business object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/line-of-business" delete: tags: - Business @@ -15003,6 +18093,7 @@ paths: description: Name of the line-of-business (product) required: true type: string + example: __LINE-OF-BUSINESS-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -15022,7 +18113,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lines-of-business" + $ref: "#/getDefinitions/lines-of-business" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /business/owning-entities/owning-entity/{owning-entity-id}/relationship-list/relationship: @@ -15046,9 +18137,10 @@ paths: description: UUID of an owning entity required: true type: string + example: __OWNING-ENTITY-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessOwningEntitiesOwningEntity.json) required: true schema: $ref: "#/definitions/relationship" @@ -15073,6 +18165,7 @@ paths: description: UUID of an owning entity required: true type: string + example: __OWNING-ENTITY-ID__ /business/owning-entities/owning-entity/{owning-entity-id}: get: tags: @@ -15087,7 +18180,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/owning-entity" + $ref: "#/getDefinitions/owning-entity" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -15096,11 +18189,15 @@ paths: description: UUID of an owning entity required: true type: string + example: __OWNING-ENTITY-ID__ put: tags: - Business summary: create or update an existing owning-entity - description: create or update an existing owning-entity + description: | + Create or update an existing owning-entity. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessOwningEntitiesOwningEntity consumes: - application/json @@ -15117,12 +18214,52 @@ paths: description: UUID of an owning entity required: true type: string + example: __OWNING-ENTITY-ID__ - name: body in: body - description: owning-entity object that needs to be created or updated + description: owning-entity object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessOwningEntitiesOwningEntity.json) required: true schema: $ref: "#/definitions/owning-entity" + patch: + tags: + - Business + summary: update an existing owning-entity + description: | + Update an existing owning-entity + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessOwningEntitiesOwningEntity + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: owning-entity-id + in: path + description: UUID of an owning entity + required: true + type: string + example: __OWNING-ENTITY-ID__ + - name: body + in: body + description: owning-entity object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/owning-entity" delete: tags: - Business @@ -15144,6 +18281,7 @@ paths: description: UUID of an owning entity required: true type: string + example: __OWNING-ENTITY-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -15163,7 +18301,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/owning-entities" + $ref: "#/getDefinitions/owning-entities" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /business/platforms/platform/{platform-name}/relationship-list/relationship: @@ -15187,9 +18325,10 @@ paths: description: Name of the platform required: true type: string + example: __PLATFORM-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessPlatformsPlatform.json) required: true schema: $ref: "#/definitions/relationship" @@ -15214,6 +18353,7 @@ paths: description: Name of the platform required: true type: string + example: __PLATFORM-NAME__ /business/platforms/platform/{platform-name}: get: tags: @@ -15228,7 +18368,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/platform" + $ref: "#/getDefinitions/platform" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -15237,11 +18377,15 @@ paths: description: Name of the platform required: true type: string + example: __PLATFORM-NAME__ put: tags: - Business summary: create or update an existing platform - description: create or update an existing platform + description: | + Create or update an existing platform. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessPlatformsPlatform consumes: - application/json @@ -15258,12 +18402,52 @@ paths: description: Name of the platform required: true type: string + example: __PLATFORM-NAME__ - name: body in: body - description: platform object that needs to be created or updated + description: platform object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessPlatformsPlatform.json) required: true schema: $ref: "#/definitions/platform" + patch: + tags: + - Business + summary: update an existing platform + description: | + Update an existing platform + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessPlatformsPlatform + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: platform-name + in: path + description: Name of the platform + required: true + type: string + example: __PLATFORM-NAME__ + - name: body + in: body + description: platform object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/platform" delete: tags: - Business @@ -15285,6 +18469,7 @@ paths: description: Name of the platform required: true type: string + example: __PLATFORM-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -15304,7 +18489,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/platforms" + $ref: "#/getDefinitions/platforms" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /business/projects/project/{project-name}/relationship-list/relationship: @@ -15328,9 +18513,10 @@ paths: description: Name of the project deploying a service required: true type: string + example: __PROJECT-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessProjectsProject.json) required: true schema: $ref: "#/definitions/relationship" @@ -15355,6 +18541,7 @@ paths: description: Name of the project deploying a service required: true type: string + example: __PROJECT-NAME__ /business/projects/project/{project-name}: get: tags: @@ -15369,7 +18556,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/project" + $ref: "#/getDefinitions/project" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -15378,11 +18565,15 @@ paths: description: Name of the project deploying a service required: true type: string + example: __PROJECT-NAME__ put: tags: - Business summary: create or update an existing project - description: create or update an existing project + description: | + Create or update an existing project. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateBusinessProjectsProject consumes: - application/json @@ -15399,12 +18590,52 @@ paths: description: Name of the project deploying a service required: true type: string + example: __PROJECT-NAME__ - name: body in: body - description: project object that needs to be created or updated + description: project object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessProjectsProject.json) required: true schema: $ref: "#/definitions/project" + patch: + tags: + - Business + summary: update an existing project + description: | + Update an existing project + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateBusinessProjectsProject + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: project-name + in: path + description: Name of the project deploying a service + required: true + type: string + example: __PROJECT-NAME__ + - name: body + in: body + description: project object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/project" delete: tags: - Business @@ -15426,6 +18657,7 @@ paths: description: Name of the project deploying a service required: true type: string + example: __PROJECT-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -15445,7 +18677,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/projects" + $ref: "#/getDefinitions/projects" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /service-design-and-creation/vnf-images/vnf-image/{vnf-image-uuid}/relationship-list/relationship: @@ -15469,9 +18701,10 @@ paths: description: Unique ID of this asset required: true type: string + example: __VNF-IMAGE-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationVnfImagesVnfImage.json) required: true schema: $ref: "#/definitions/relationship" @@ -15496,6 +18729,7 @@ paths: description: Unique ID of this asset required: true type: string + example: __VNF-IMAGE-UUID__ /service-design-and-creation/vnf-images/vnf-image/{vnf-image-uuid}: get: tags: @@ -15510,7 +18744,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vnf-image" + $ref: "#/getDefinitions/vnf-image" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -15519,6 +18753,7 @@ paths: description: Unique ID of this asset required: true type: string + example: __VNF-IMAGE-UUID__ - name: application in: query description: The application that the image instantiates. @@ -15538,7 +18773,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing vnf-image - description: create or update an existing vnf-image + description: | + Create or update an existing vnf-image. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationVnfImagesVnfImage consumes: - application/json @@ -15555,12 +18793,52 @@ paths: description: Unique ID of this asset required: true type: string + example: __VNF-IMAGE-UUID__ - name: body in: body - description: vnf-image object that needs to be created or updated + description: vnf-image object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationVnfImagesVnfImage.json) required: true schema: $ref: "#/definitions/vnf-image" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing vnf-image + description: | + Update an existing vnf-image + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationVnfImagesVnfImage + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-image-uuid + in: path + description: Unique ID of this asset + required: true + type: string + example: __VNF-IMAGE-UUID__ + - name: body + in: body + description: vnf-image object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vnf-image" delete: tags: - ServiceDesignAndCreation @@ -15582,6 +18860,7 @@ paths: description: Unique ID of this asset required: true type: string + example: __VNF-IMAGE-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -15601,7 +18880,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vnf-images" + $ref: "#/getDefinitions/vnf-images" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /service-design-and-creation/services/service/{service-id}/relationship-list/relationship: @@ -15625,9 +18904,10 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationServicesService.json) required: true schema: $ref: "#/definitions/relationship" @@ -15652,6 +18932,7 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-ID__ /service-design-and-creation/services/service/{service-id}: get: tags: @@ -15666,7 +18947,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/service" + $ref: "#/getDefinitions/service" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -15675,6 +18956,7 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-ID__ - name: service-description in: query description: Description of the service @@ -15684,7 +18966,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing service - description: create or update an existing service + description: | + Create or update an existing service. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationServicesService consumes: - application/json @@ -15701,12 +18986,52 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-ID__ - name: body in: body - description: service object that needs to be created or updated + description: service object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationServicesService.json) required: true schema: $ref: "#/definitions/service" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing service + description: | + Update an existing service + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationServicesService + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: service-id + in: path + description: This gets defined by others to provide a unique ID for the service, we accept what is sent. + required: true + type: string + example: __SERVICE-ID__ + - name: body + in: body + description: service object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/service" delete: tags: - ServiceDesignAndCreation @@ -15728,6 +19053,7 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -15747,7 +19073,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/services" + $ref: "#/getDefinitions/services" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /service-design-and-creation/service-capabilities/service-capability/{service-type}/{vnf-type}/relationship-list/relationship: @@ -15771,14 +19097,16 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-TYPE__ - name: vnf-type in: path description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. required: true type: string + example: __VNF-TYPE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationServiceCapabilitiesServiceCapability.json) required: true schema: $ref: "#/definitions/relationship" @@ -15803,11 +19131,13 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-TYPE__ - name: vnf-type in: path description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. required: true type: string + example: __VNF-TYPE__ /service-design-and-creation/service-capabilities/service-capability/{service-type}/{vnf-type}: get: tags: @@ -15822,7 +19152,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/service-capability" + $ref: "#/getDefinitions/service-capability" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -15831,16 +19161,21 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-TYPE__ - name: vnf-type in: path description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. required: true type: string + example: __VNF-TYPE__ put: tags: - ServiceDesignAndCreation summary: create or update an existing service-capability - description: create or update an existing service-capability + description: | + Create or update an existing service-capability. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationServiceCapabilitiesServiceCapability consumes: - application/json @@ -15857,17 +19192,64 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-TYPE__ - name: vnf-type in: path description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. required: true type: string + example: __VNF-TYPE__ - name: body in: body - description: service-capability object that needs to be created or updated + description: service-capability object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationServiceCapabilitiesServiceCapability.json) required: true schema: $ref: "#/definitions/service-capability" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing service-capability + description: | + Update an existing service-capability + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationServiceCapabilitiesServiceCapability + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: service-type + in: path + description: This gets defined by others to provide a unique ID for the service, we accept what is sent. + required: true + type: string + example: __SERVICE-TYPE__ + - name: vnf-type + in: path + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + required: true + type: string + example: __VNF-TYPE__ + - name: body + in: body + description: service-capability object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/service-capability" delete: tags: - ServiceDesignAndCreation @@ -15889,11 +19271,13 @@ paths: description: This gets defined by others to provide a unique ID for the service, we accept what is sent. required: true type: string + example: __SERVICE-TYPE__ - name: vnf-type in: path description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. required: true type: string + example: __VNF-TYPE__ - name: resource-version in: query description: resource-version for concurrency @@ -15913,7 +19297,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/service-capabilities" + $ref: "#/getDefinitions/service-capabilities" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/element-choice-sets/element-choice-set/{element-choice-set-uuid}/relationship-list/relationship: @@ -15937,30 +19321,36 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: element-choice-set-uuid in: path required: true type: string + example: __ELEMENT-CHOICE-SET-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet.json) required: true schema: $ref: "#/definitions/relationship" @@ -15985,27 +19375,33 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: element-choice-set-uuid in: path required: true type: string + example: __ELEMENT-CHOICE-SET-UUID__ /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/element-choice-sets/element-choice-set/{element-choice-set-uuid}: get: tags: @@ -16020,7 +19416,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/element-choice-set" + $ref: "#/getDefinitions/element-choice-set" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -16029,27 +19425,33 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: element-choice-set-uuid in: path required: true type: string + example: __ELEMENT-CHOICE-SET-UUID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -16069,7 +19471,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing element-choice-set - description: create or update an existing element-choice-set + description: | + Create or update an existing element-choice-set. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet consumes: - application/json @@ -16086,33 +19491,104 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: element-choice-set-uuid in: path required: true type: string + example: __ELEMENT-CHOICE-SET-UUID__ - name: body in: body - description: element-choice-set object that needs to be created or updated + description: element-choice-set object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet.json) required: true schema: $ref: "#/definitions/element-choice-set" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing element-choice-set + description: | + Update an existing element-choice-set + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: model-invariant-id + in: path + description: Unique identifier corresponding to the main definition of a model in ASDC + required: true + type: string + example: __MODEL-INVARIANT-ID__ + - name: model-version-id + in: path + description: Unique identifier corresponding to one version of a model in ASDC + required: true + type: string + example: __MODEL-VERSION-ID__ + - name: model-element-uuid + in: path + required: true + type: string + example: __MODEL-ELEMENT-UUID__ + - name: model-constraint-uuid + in: path + required: true + type: string + example: __MODEL-CONSTRAINT-UUID__ + - name: constrained-element-set-uuid + in: path + required: true + type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ + - name: element-choice-set-uuid + in: path + required: true + type: string + example: __ELEMENT-CHOICE-SET-UUID__ + - name: body + in: body + description: element-choice-set object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/element-choice-set" delete: tags: - ServiceDesignAndCreation @@ -16134,27 +19610,33 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: element-choice-set-uuid in: path required: true type: string + example: __ELEMENT-CHOICE-SET-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -16174,7 +19656,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/element-choice-sets" + $ref: "#/getDefinitions/element-choice-sets" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -16183,23 +19665,28 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -16236,26 +19723,31 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet.json) required: true schema: $ref: "#/definitions/relationship" @@ -16280,23 +19772,28 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}: get: tags: @@ -16311,7 +19808,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/constrained-element-set" + $ref: "#/getDefinitions/constrained-element-set" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -16320,23 +19817,28 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -16356,7 +19858,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing constrained-element-set - description: create or update an existing constrained-element-set + description: | + Create or update an existing constrained-element-set. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet consumes: - application/json @@ -16373,29 +19878,94 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: body in: body - description: constrained-element-set object that needs to be created or updated + description: constrained-element-set object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet.json) required: true schema: $ref: "#/definitions/constrained-element-set" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing constrained-element-set + description: | + Update an existing constrained-element-set + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: model-invariant-id + in: path + description: Unique identifier corresponding to the main definition of a model in ASDC + required: true + type: string + example: __MODEL-INVARIANT-ID__ + - name: model-version-id + in: path + description: Unique identifier corresponding to one version of a model in ASDC + required: true + type: string + example: __MODEL-VERSION-ID__ + - name: model-element-uuid + in: path + required: true + type: string + example: __MODEL-ELEMENT-UUID__ + - name: model-constraint-uuid + in: path + required: true + type: string + example: __MODEL-CONSTRAINT-UUID__ + - name: constrained-element-set-uuid + in: path + required: true + type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ + - name: body + in: body + description: constrained-element-set object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/constrained-element-set" delete: tags: - ServiceDesignAndCreation @@ -16417,23 +19987,28 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: constrained-element-set-uuid in: path required: true type: string + example: __CONSTRAINED-ELEMENT-SET-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -16453,7 +20028,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/constrained-element-sets" + $ref: "#/getDefinitions/constrained-element-sets" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -16462,19 +20037,23 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -16504,7 +20083,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/model-constraint" + $ref: "#/getDefinitions/model-constraint" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -16513,19 +20092,23 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -16545,7 +20128,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing model-constraint - description: create or update an existing model-constraint + description: | + Create or update an existing model-constraint. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint consumes: - application/json @@ -16562,25 +20148,84 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: body in: body - description: model-constraint object that needs to be created or updated + description: model-constraint object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint.json) required: true schema: $ref: "#/definitions/model-constraint" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing model-constraint + description: | + Update an existing model-constraint + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: model-invariant-id + in: path + description: Unique identifier corresponding to the main definition of a model in ASDC + required: true + type: string + example: __MODEL-INVARIANT-ID__ + - name: model-version-id + in: path + description: Unique identifier corresponding to one version of a model in ASDC + required: true + type: string + example: __MODEL-VERSION-ID__ + - name: model-element-uuid + in: path + required: true + type: string + example: __MODEL-ELEMENT-UUID__ + - name: model-constraint-uuid + in: path + required: true + type: string + example: __MODEL-CONSTRAINT-UUID__ + - name: body + in: body + description: model-constraint object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/model-constraint" delete: tags: - ServiceDesignAndCreation @@ -16602,19 +20247,23 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-constraint-uuid in: path required: true type: string + example: __MODEL-CONSTRAINT-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -16634,7 +20283,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/model-constraints" + $ref: "#/getDefinitions/model-constraints" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -16643,15 +20292,18 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -16688,18 +20340,21 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement.json) required: true schema: $ref: "#/definitions/relationship" @@ -16724,15 +20379,18 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}: get: tags: @@ -16747,7 +20405,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/model-element" + $ref: "#/getDefinitions/model-element" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -16756,15 +20414,18 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -16784,7 +20445,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing model-element - description: create or update an existing model-element + description: | + Create or update an existing model-element. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement consumes: - application/json @@ -16801,21 +20465,74 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: body in: body - description: model-element object that needs to be created or updated + description: model-element object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement.json) required: true schema: $ref: "#/definitions/model-element" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing model-element + description: | + Update an existing model-element + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: model-invariant-id + in: path + description: Unique identifier corresponding to the main definition of a model in ASDC + required: true + type: string + example: __MODEL-INVARIANT-ID__ + - name: model-version-id + in: path + description: Unique identifier corresponding to one version of a model in ASDC + required: true + type: string + example: __MODEL-VERSION-ID__ + - name: model-element-uuid + in: path + required: true + type: string + example: __MODEL-ELEMENT-UUID__ + - name: body + in: body + description: model-element object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/model-element" delete: tags: - ServiceDesignAndCreation @@ -16837,15 +20554,18 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-element-uuid in: path required: true type: string + example: __MODEL-ELEMENT-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -16865,7 +20585,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/model-elements" + $ref: "#/getDefinitions/model-elements" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -16874,11 +20594,13 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -16908,7 +20630,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/metadatum" + $ref: "#/getDefinitions/metadatum" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -16917,15 +20639,18 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -16945,7 +20670,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing metadatum - description: create or update an existing metadatum + description: | + Create or update an existing metadatum. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum consumes: - application/json @@ -16962,21 +20690,74 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: body in: body - description: metadatum object that needs to be created or updated + description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum.json) required: true schema: $ref: "#/definitions/metadatum" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing metadatum + description: | + Update an existing metadatum + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: model-invariant-id + in: path + description: Unique identifier corresponding to the main definition of a model in ASDC + required: true + type: string + example: __MODEL-INVARIANT-ID__ + - name: model-version-id + in: path + description: Unique identifier corresponding to one version of a model in ASDC + required: true + type: string + example: __MODEL-VERSION-ID__ + - name: metaname + in: path + required: true + type: string + example: __METANAME__ + - name: body + in: body + description: metadatum object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/metadatum" delete: tags: - ServiceDesignAndCreation @@ -16998,15 +20779,18 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: metaname in: path required: true type: string + example: __METANAME__ - name: resource-version in: query description: resource-version for concurrency @@ -17026,7 +20810,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/metadata" + $ref: "#/getDefinitions/metadata" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17035,11 +20819,13 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -17076,14 +20862,16 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVer.json) required: true schema: $ref: "#/definitions/relationship" @@ -17108,11 +20896,13 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}: get: tags: @@ -17127,7 +20917,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/model-ver" + $ref: "#/getDefinitions/model-ver" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17136,11 +20926,13 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -17160,7 +20952,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing model-ver - description: create or update an existing model-ver + description: | + Create or update an existing model-ver. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVer consumes: - application/json @@ -17177,17 +20972,64 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: body in: body - description: model-ver object that needs to be created or updated + description: model-ver object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVer.json) required: true schema: $ref: "#/definitions/model-ver" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing model-ver + description: | + Update an existing model-ver + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVer + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: model-invariant-id + in: path + description: Unique identifier corresponding to the main definition of a model in ASDC + required: true + type: string + example: __MODEL-INVARIANT-ID__ + - name: model-version-id + in: path + description: Unique identifier corresponding to one version of a model in ASDC + required: true + type: string + example: __MODEL-VERSION-ID__ + - name: body + in: body + description: model-ver object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/model-ver" delete: tags: - ServiceDesignAndCreation @@ -17209,11 +21051,13 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-version-id in: path description: Unique identifier corresponding to one version of a model in ASDC required: true type: string + example: __MODEL-VERSION-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -17233,7 +21077,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/model-vers" + $ref: "#/getDefinitions/model-vers" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17242,6 +21086,7 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -17268,9 +21113,10 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModel.json) required: true schema: $ref: "#/definitions/relationship" @@ -17295,6 +21141,7 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ /service-design-and-creation/models/model/{model-invariant-id}: get: tags: @@ -17309,7 +21156,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/model" + $ref: "#/getDefinitions/model" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17318,6 +21165,7 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: model-type in: query description: Type of the model, e.g., service, resource, widget, etc. @@ -17327,7 +21175,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing model - description: create or update an existing model + description: | + Create or update an existing model. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationModelsModel consumes: - application/json @@ -17344,12 +21195,52 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: body in: body - description: model object that needs to be created or updated + description: model object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModel.json) required: true schema: $ref: "#/definitions/model" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing model + description: | + Update an existing model + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationModelsModel + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: model-invariant-id + in: path + description: Unique identifier corresponding to the main definition of a model in ASDC + required: true + type: string + example: __MODEL-INVARIANT-ID__ + - name: body + in: body + description: model object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/model" delete: tags: - ServiceDesignAndCreation @@ -17371,6 +21262,7 @@ paths: description: Unique identifier corresponding to the main definition of a model in ASDC required: true type: string + example: __MODEL-INVARIANT-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -17390,7 +21282,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/models" + $ref: "#/getDefinitions/models" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/related-lookups/related-lookup/{related-lookup-uuid}/relationship-list/relationship: @@ -17413,17 +21305,20 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: related-lookup-uuid in: path required: true type: string + example: __RELATED-LOOKUP-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup.json) required: true schema: $ref: "#/definitions/relationship" @@ -17447,14 +21342,17 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: related-lookup-uuid in: path required: true type: string + example: __RELATED-LOOKUP-UUID__ /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/related-lookups/related-lookup/{related-lookup-uuid}: get: tags: @@ -17469,7 +21367,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/related-lookup" + $ref: "#/getDefinitions/related-lookup" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17477,14 +21375,17 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: related-lookup-uuid in: path required: true type: string + example: __RELATED-LOOKUP-UUID__ - name: named-query-name in: query required: false @@ -17493,7 +21394,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing related-lookup - description: create or update an existing related-lookup + description: | + Create or update an existing related-lookup. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup consumes: - application/json @@ -17509,20 +21413,71 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: related-lookup-uuid in: path required: true type: string + example: __RELATED-LOOKUP-UUID__ - name: body in: body - description: related-lookup object that needs to be created or updated + description: related-lookup object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup.json) required: true schema: $ref: "#/definitions/related-lookup" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing related-lookup + description: | + Update an existing related-lookup + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: named-query-uuid + in: path + required: true + type: string + example: __NAMED-QUERY-UUID__ + - name: named-query-element-uuid + in: path + required: true + type: string + example: __NAMED-QUERY-ELEMENT-UUID__ + - name: related-lookup-uuid + in: path + required: true + type: string + example: __RELATED-LOOKUP-UUID__ + - name: body + in: body + description: related-lookup object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/related-lookup" delete: tags: - ServiceDesignAndCreation @@ -17543,14 +21498,17 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: related-lookup-uuid in: path required: true type: string + example: __RELATED-LOOKUP-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -17570,7 +21528,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/related-lookups" + $ref: "#/getDefinitions/related-lookups" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17578,10 +21536,12 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: named-query-name in: query required: false @@ -17600,7 +21560,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/property-constraint" + $ref: "#/getDefinitions/property-constraint" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17608,14 +21568,17 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: property-constraint-uuid in: path required: true type: string + example: __PROPERTY-CONSTRAINT-UUID__ - name: named-query-name in: query required: false @@ -17624,7 +21587,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing property-constraint - description: create or update an existing property-constraint + description: | + Create or update an existing property-constraint. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint consumes: - application/json @@ -17640,20 +21606,71 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: property-constraint-uuid in: path required: true type: string + example: __PROPERTY-CONSTRAINT-UUID__ - name: body in: body - description: property-constraint object that needs to be created or updated + description: property-constraint object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint.json) required: true schema: $ref: "#/definitions/property-constraint" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing property-constraint + description: | + Update an existing property-constraint + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: named-query-uuid + in: path + required: true + type: string + example: __NAMED-QUERY-UUID__ + - name: named-query-element-uuid + in: path + required: true + type: string + example: __NAMED-QUERY-ELEMENT-UUID__ + - name: property-constraint-uuid + in: path + required: true + type: string + example: __PROPERTY-CONSTRAINT-UUID__ + - name: body + in: body + description: property-constraint object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/property-constraint" delete: tags: - ServiceDesignAndCreation @@ -17674,14 +21691,17 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: property-constraint-uuid in: path required: true type: string + example: __PROPERTY-CONSTRAINT-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -17701,7 +21721,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/property-constraints" + $ref: "#/getDefinitions/property-constraints" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17709,10 +21729,12 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: named-query-name in: query required: false @@ -17737,13 +21759,15 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement.json) required: true schema: $ref: "#/definitions/relationship" @@ -17767,10 +21791,12 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}: get: tags: @@ -17785,7 +21811,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/named-query-element" + $ref: "#/getDefinitions/named-query-element" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17793,10 +21819,12 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: named-query-name in: query required: false @@ -17805,7 +21833,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing named-query-element - description: create or update an existing named-query-element + description: | + Create or update an existing named-query-element. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement consumes: - application/json @@ -17821,16 +21852,61 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: body in: body - description: named-query-element object that needs to be created or updated + description: named-query-element object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement.json) required: true schema: $ref: "#/definitions/named-query-element" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing named-query-element + description: | + Update an existing named-query-element + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: named-query-uuid + in: path + required: true + type: string + example: __NAMED-QUERY-UUID__ + - name: named-query-element-uuid + in: path + required: true + type: string + example: __NAMED-QUERY-ELEMENT-UUID__ + - name: body + in: body + description: named-query-element object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/named-query-element" delete: tags: - ServiceDesignAndCreation @@ -17851,10 +21927,12 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-element-uuid in: path required: true type: string + example: __NAMED-QUERY-ELEMENT-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -17874,7 +21952,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/named-query-elements" + $ref: "#/getDefinitions/named-query-elements" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17882,6 +21960,7 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-name in: query required: false @@ -17906,9 +21985,10 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQuery.json) required: true schema: $ref: "#/definitions/relationship" @@ -17932,6 +22012,7 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ /service-design-and-creation/named-queries/named-query/{named-query-uuid}: get: tags: @@ -17946,7 +22027,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/named-query" + $ref: "#/getDefinitions/named-query" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -17954,6 +22035,7 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: named-query-name in: query required: false @@ -17962,7 +22044,10 @@ paths: tags: - ServiceDesignAndCreation summary: create or update an existing named-query - description: create or update an existing named-query + description: | + Create or update an existing named-query. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQuery consumes: - application/json @@ -17978,12 +22063,51 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: body in: body - description: named-query object that needs to be created or updated + description: named-query object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQuery.json) required: true schema: $ref: "#/definitions/named-query" + patch: + tags: + - ServiceDesignAndCreation + summary: update an existing named-query + description: | + Update an existing named-query + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateServiceDesignAndCreationNamedQueriesNamedQuery + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: named-query-uuid + in: path + required: true + type: string + example: __NAMED-QUERY-UUID__ + - name: body + in: body + description: named-query object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/named-query" delete: tags: - ServiceDesignAndCreation @@ -18004,6 +22128,7 @@ paths: in: path required: true type: string + example: __NAMED-QUERY-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -18023,7 +22148,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/named-queries" + $ref: "#/getDefinitions/named-queries" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/logical-links/logical-link/{link-name}/relationship-list/relationship: @@ -18047,9 +22172,10 @@ paths: description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ required: true type: string + example: __LINK-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkLogicalLinksLogicalLink.json) required: true schema: $ref: "#/definitions/relationship" @@ -18074,6 +22200,7 @@ paths: description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ required: true type: string + example: __LINK-NAME__ /network/logical-links/logical-link/{link-name}: get: tags: @@ -18088,7 +22215,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/logical-link" + $ref: "#/getDefinitions/logical-link" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -18097,6 +22224,7 @@ paths: description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ required: true type: string + example: __LINK-NAME__ - name: model-invariant-id in: query description: the ASDC model id for this resource or service model. @@ -18141,7 +22269,10 @@ paths: tags: - Network summary: create or update an existing logical-link - description: create or update an existing logical-link + description: | + Create or update an existing logical-link. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkLogicalLinksLogicalLink consumes: - application/json @@ -18158,12 +22289,52 @@ paths: description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ required: true type: string + example: __LINK-NAME__ - name: body in: body - description: logical-link object that needs to be created or updated + description: logical-link object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkLogicalLinksLogicalLink.json) required: true schema: $ref: "#/definitions/logical-link" + patch: + tags: + - Network + summary: update an existing logical-link + description: | + Update an existing logical-link + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkLogicalLinksLogicalLink + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: link-name + in: path + description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ + required: true + type: string + example: __LINK-NAME__ + - name: body + in: body + description: logical-link object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/logical-link" delete: tags: - Network @@ -18185,6 +22356,7 @@ paths: description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ required: true type: string + example: __LINK-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -18204,7 +22376,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/logical-links" + $ref: "#/getDefinitions/logical-links" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/classes-of-service/class-of-service/{cos}/relationship-list/relationship: @@ -18228,24 +22400,28 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ - name: cos in: path description: unique identifier of probe required: true type: string + example: __COS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService.json) required: true schema: $ref: "#/definitions/relationship" @@ -18270,21 +22446,25 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ - name: cos in: path description: unique identifier of probe required: true type: string + example: __COS__ /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/classes-of-service/class-of-service/{cos}: get: tags: @@ -18299,7 +22479,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/class-of-service" + $ref: "#/getDefinitions/class-of-service" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -18308,26 +22488,33 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ - name: cos in: path description: unique identifier of probe required: true type: string + example: __COS__ put: tags: - Network summary: create or update an existing class-of-service - description: create or update an existing class-of-service + description: | + Create or update an existing class-of-service. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService consumes: - application/json @@ -18344,27 +22531,88 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ - name: cos in: path description: unique identifier of probe required: true type: string + example: __COS__ - name: body in: body - description: class-of-service object that needs to be created or updated + description: class-of-service object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService.json) required: true schema: $ref: "#/definitions/class-of-service" + patch: + tags: + - Network + summary: update an existing class-of-service + description: | + Update an existing class-of-service + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: site-pair-set-id + in: path + description: Unique id of site pair set. + required: true + type: string + example: __SITE-PAIR-SET-ID__ + - name: routing-instance-id + in: path + description: Unique id of routing instance + required: true + type: string + example: __ROUTING-INSTANCE-ID__ + - name: site-pair-id + in: path + description: unique identifier of probe + required: true + type: string + example: __SITE-PAIR-ID__ + - name: cos + in: path + description: unique identifier of probe + required: true + type: string + example: __COS__ + - name: body + in: body + description: class-of-service object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/class-of-service" delete: tags: - Network @@ -18386,21 +22634,25 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ - name: cos in: path description: unique identifier of probe required: true type: string + example: __COS__ - name: resource-version in: query description: resource-version for concurrency @@ -18420,7 +22672,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/classes-of-service" + $ref: "#/getDefinitions/classes-of-service" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -18429,16 +22681,19 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/relationship-list/relationship: put: tags: @@ -18460,19 +22715,22 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair.json) required: true schema: $ref: "#/definitions/relationship" @@ -18497,16 +22755,19 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}: get: tags: @@ -18521,7 +22782,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/site-pair" + $ref: "#/getDefinitions/site-pair" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -18530,21 +22791,27 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ put: tags: - Network summary: create or update an existing site-pair - description: create or update an existing site-pair + description: | + Create or update an existing site-pair. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair consumes: - application/json @@ -18561,22 +22828,76 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ - name: body in: body - description: site-pair object that needs to be created or updated + description: site-pair object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair.json) required: true schema: $ref: "#/definitions/site-pair" + patch: + tags: + - Network + summary: update an existing site-pair + description: | + Update an existing site-pair + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: site-pair-set-id + in: path + description: Unique id of site pair set. + required: true + type: string + example: __SITE-PAIR-SET-ID__ + - name: routing-instance-id + in: path + description: Unique id of routing instance + required: true + type: string + example: __ROUTING-INSTANCE-ID__ + - name: site-pair-id + in: path + description: unique identifier of probe + required: true + type: string + example: __SITE-PAIR-ID__ + - name: body + in: body + description: site-pair object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/site-pair" delete: tags: - Network @@ -18598,16 +22919,19 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: site-pair-id in: path description: unique identifier of probe required: true type: string + example: __SITE-PAIR-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -18627,7 +22951,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/site-pairs" + $ref: "#/getDefinitions/site-pairs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -18636,11 +22960,13 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/relationship-list/relationship: put: tags: @@ -18662,14 +22988,16 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance.json) required: true schema: $ref: "#/definitions/relationship" @@ -18694,11 +23022,13 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}: get: tags: @@ -18713,7 +23043,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/routing-instance" + $ref: "#/getDefinitions/routing-instance" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -18722,16 +23052,21 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ put: tags: - Network summary: create or update an existing routing-instance - description: create or update an existing routing-instance + description: | + Create or update an existing routing-instance. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance consumes: - application/json @@ -18748,17 +23083,64 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: body in: body - description: routing-instance object that needs to be created or updated + description: routing-instance object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance.json) required: true schema: $ref: "#/definitions/routing-instance" + patch: + tags: + - Network + summary: update an existing routing-instance + description: | + Update an existing routing-instance + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: site-pair-set-id + in: path + description: Unique id of site pair set. + required: true + type: string + example: __SITE-PAIR-SET-ID__ + - name: routing-instance-id + in: path + description: Unique id of routing instance + required: true + type: string + example: __ROUTING-INSTANCE-ID__ + - name: body + in: body + description: routing-instance object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/routing-instance" delete: tags: - Network @@ -18780,11 +23162,13 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: routing-instance-id in: path description: Unique id of routing instance required: true type: string + example: __ROUTING-INSTANCE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -18804,7 +23188,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/routing-instances" + $ref: "#/getDefinitions/routing-instances" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -18813,6 +23197,7 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ /network/site-pair-sets/site-pair-set/{site-pair-set-id}/relationship-list/relationship: put: tags: @@ -18834,9 +23219,10 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSet.json) required: true schema: $ref: "#/definitions/relationship" @@ -18861,6 +23247,7 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ /network/site-pair-sets/site-pair-set/{site-pair-set-id}: get: tags: @@ -18875,7 +23262,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/site-pair-set" + $ref: "#/getDefinitions/site-pair-set" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -18884,11 +23271,15 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ put: tags: - Network summary: create or update an existing site-pair-set - description: create or update an existing site-pair-set + description: | + Create or update an existing site-pair-set. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkSitePairSetsSitePairSet consumes: - application/json @@ -18905,12 +23296,52 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: body in: body - description: site-pair-set object that needs to be created or updated + description: site-pair-set object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSet.json) required: true schema: $ref: "#/definitions/site-pair-set" + patch: + tags: + - Network + summary: update an existing site-pair-set + description: | + Update an existing site-pair-set + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkSitePairSetsSitePairSet + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: site-pair-set-id + in: path + description: Unique id of site pair set. + required: true + type: string + example: __SITE-PAIR-SET-ID__ + - name: body + in: body + description: site-pair-set object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/site-pair-set" delete: tags: - Network @@ -18932,6 +23363,7 @@ paths: description: Unique id of site pair set. required: true type: string + example: __SITE-PAIR-SET-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -18951,7 +23383,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/site-pair-sets" + $ref: "#/getDefinitions/site-pair-sets" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets/route-target/{global-route-target}/{route-target-role}/relationship-list/relationship: @@ -18975,19 +23407,22 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: global-route-target in: path description: Number used to identify an RT, globally unique in the network required: true type: string + example: __GLOBAL-ROUTE-TARGET__ - name: route-target-role in: path description: Role assigned to this route target required: true type: string + example: __ROUTE-TARGET-ROLE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVpnBindingsVpnBindingRouteTargetsRouteTarget.json) required: true schema: $ref: "#/definitions/relationship" @@ -19012,16 +23447,19 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: global-route-target in: path description: Number used to identify an RT, globally unique in the network required: true type: string + example: __GLOBAL-ROUTE-TARGET__ - name: route-target-role in: path description: Role assigned to this route target required: true type: string + example: __ROUTE-TARGET-ROLE__ /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets/route-target/{global-route-target}/{route-target-role}: get: tags: @@ -19036,7 +23474,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/route-target" + $ref: "#/getDefinitions/route-target" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -19045,16 +23483,19 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: global-route-target in: path description: Number used to identify an RT, globally unique in the network required: true type: string + example: __GLOBAL-ROUTE-TARGET__ - name: route-target-role in: path description: Role assigned to this route target required: true type: string + example: __ROUTE-TARGET-ROLE__ - name: vpn-name in: query description: VPN Name @@ -19069,7 +23510,10 @@ paths: tags: - Network summary: create or update an existing route-target - description: create or update an existing route-target + description: | + Create or update an existing route-target. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVpnBindingsVpnBindingRouteTargetsRouteTarget consumes: - application/json @@ -19086,22 +23530,76 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: global-route-target in: path description: Number used to identify an RT, globally unique in the network required: true type: string + example: __GLOBAL-ROUTE-TARGET__ - name: route-target-role in: path description: Role assigned to this route target required: true type: string + example: __ROUTE-TARGET-ROLE__ - name: body in: body - description: route-target object that needs to be created or updated + description: route-target object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVpnBindingsVpnBindingRouteTargetsRouteTarget.json) required: true schema: $ref: "#/definitions/route-target" + patch: + tags: + - Network + summary: update an existing route-target + description: | + Update an existing route-target + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVpnBindingsVpnBindingRouteTargetsRouteTarget + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vpn-id + in: path + description: VPN ID, globally unique within A&AI + required: true + type: string + example: __VPN-ID__ + - name: global-route-target + in: path + description: Number used to identify an RT, globally unique in the network + required: true + type: string + example: __GLOBAL-ROUTE-TARGET__ + - name: route-target-role + in: path + description: Role assigned to this route target + required: true + type: string + example: __ROUTE-TARGET-ROLE__ + - name: body + in: body + description: route-target object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/route-target" delete: tags: - Network @@ -19123,16 +23621,19 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: global-route-target in: path description: Number used to identify an RT, globally unique in the network required: true type: string + example: __GLOBAL-ROUTE-TARGET__ - name: route-target-role in: path description: Role assigned to this route target required: true type: string + example: __ROUTE-TARGET-ROLE__ - name: resource-version in: query description: resource-version for concurrency @@ -19152,7 +23653,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/route-targets" + $ref: "#/getDefinitions/route-targets" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -19161,6 +23662,7 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: vpn-name in: query description: VPN Name @@ -19192,9 +23694,10 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVpnBindingsVpnBinding.json) required: true schema: $ref: "#/definitions/relationship" @@ -19219,6 +23722,7 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ /network/vpn-bindings/vpn-binding/{vpn-id}: get: tags: @@ -19233,7 +23737,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vpn-binding" + $ref: "#/getDefinitions/vpn-binding" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -19242,6 +23746,7 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: vpn-name in: query description: VPN Name @@ -19256,7 +23761,10 @@ paths: tags: - Network summary: create or update an existing vpn-binding - description: create or update an existing vpn-binding + description: | + Create or update an existing vpn-binding. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVpnBindingsVpnBinding consumes: - application/json @@ -19273,12 +23781,52 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: body in: body - description: vpn-binding object that needs to be created or updated + description: vpn-binding object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVpnBindingsVpnBinding.json) required: true schema: $ref: "#/definitions/vpn-binding" + patch: + tags: + - Network + summary: update an existing vpn-binding + description: | + Update an existing vpn-binding + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVpnBindingsVpnBinding + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vpn-id + in: path + description: VPN ID, globally unique within A&AI + required: true + type: string + example: __VPN-ID__ + - name: body + in: body + description: vpn-binding object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vpn-binding" delete: tags: - Network @@ -19300,6 +23848,7 @@ paths: description: VPN ID, globally unique within A&AI required: true type: string + example: __VPN-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -19319,7 +23868,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vpn-bindings" + $ref: "#/getDefinitions/vpn-bindings" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/vpls-pes/vpls-pe/{equipment-name}/relationship-list/relationship: @@ -19342,9 +23891,10 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPe.json) required: true schema: $ref: "#/definitions/relationship" @@ -19368,6 +23918,7 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship: put: tags: @@ -19388,14 +23939,16 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -19419,11 +23972,13 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship: put: tags: @@ -19444,19 +23999,22 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf.json) required: true schema: $ref: "#/definitions/relationship" @@ -19480,16 +24038,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}: get: tags: @@ -19504,7 +24065,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-pf" + $ref: "#/getDefinitions/sriov-pf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -19512,16 +24073,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -19536,7 +24100,10 @@ paths: tags: - Network summary: create or update an existing sriov-pf - description: create or update an existing sriov-pf + description: | + Create or update an existing sriov-pf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf consumes: - application/json @@ -19552,22 +24119,75 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: body in: body - description: sriov-pf object that needs to be created or updated + description: sriov-pf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf.json) required: true schema: $ref: "#/definitions/sriov-pf" + patch: + tags: + - Network + summary: update an existing sriov-pf + description: | + Update an existing sriov-pf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pf-pci-id + in: path + description: Identifier for the sriov-pf + required: true + type: string + example: __PF-PCI-ID__ + - name: body + in: body + description: sriov-pf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-pf" delete: tags: - Network @@ -19588,16 +24208,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -19617,7 +24240,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-pfs" + $ref: "#/getDefinitions/sriov-pfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -19625,11 +24248,13 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -19660,24 +24285,28 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -19701,21 +24330,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -19736,29 +24369,34 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -19782,26 +24420,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -19816,7 +24459,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -19824,26 +24467,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -19900,7 +24548,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -19916,32 +24567,99 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -19962,26 +24680,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -20007,29 +24730,34 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -20053,26 +24781,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -20087,7 +24820,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -20095,26 +24828,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -20171,7 +24909,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -20187,32 +24928,99 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -20233,26 +25041,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -20272,7 +25085,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -20280,21 +25093,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -20335,7 +25152,10 @@ paths: tags: - Network summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -20351,27 +25171,87 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - Network + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - Network @@ -20392,21 +25272,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -20426,7 +25310,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -20434,16 +25318,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -20489,24 +25376,28 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -20530,21 +25421,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -20559,7 +25454,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -20567,21 +25462,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -20631,7 +25530,10 @@ paths: tags: - Network summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -20647,27 +25549,87 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - Network + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - Network @@ -20688,21 +25650,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -20722,7 +25688,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -20730,16 +25696,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -20785,19 +25754,22 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -20821,16 +25793,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -20851,24 +25826,28 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -20892,21 +25871,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -20921,7 +25904,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -20929,21 +25912,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -20989,7 +25976,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -21005,27 +25995,87 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -21046,21 +26096,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -21086,24 +26140,28 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -21127,21 +26185,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -21156,7 +26218,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -21164,21 +26226,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -21224,7 +26290,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -21240,27 +26309,87 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -21281,21 +26410,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -21315,7 +26448,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -21323,16 +26456,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -21362,7 +26498,10 @@ paths: tags: - Network summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface consumes: - application/json @@ -21378,22 +26517,75 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - Network + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - Network @@ -21414,16 +26606,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -21443,7 +26638,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -21451,11 +26646,13 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -21480,7 +26677,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/p-interface" + $ref: "#/getDefinitions/p-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -21488,11 +26685,13 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -21507,7 +26706,10 @@ paths: tags: - Network summary: create or update an existing p-interface - description: create or update an existing p-interface + description: | + Create or update an existing p-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterface consumes: - application/json @@ -21523,17 +26725,63 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: p-interface object that needs to be created or updated + description: p-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterface.json) required: true schema: $ref: "#/definitions/p-interface" + patch: + tags: + - Network + summary: update an existing p-interface + description: | + Update an existing p-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: p-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/p-interface" delete: tags: - Network @@ -21554,11 +26802,13 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -21578,7 +26828,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/p-interfaces" + $ref: "#/getDefinitions/p-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -21586,6 +26836,7 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -21611,14 +26862,16 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -21642,11 +26895,13 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship: put: tags: @@ -21667,24 +26922,28 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -21708,21 +26967,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -21743,29 +27006,34 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -21789,26 +27057,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -21823,7 +27096,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -21831,26 +27104,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -21912,7 +27190,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -21928,32 +27209,99 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -21974,26 +27322,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -22019,29 +27372,34 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -22065,26 +27423,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -22099,7 +27462,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -22107,26 +27470,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -22188,7 +27556,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -22204,32 +27575,99 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -22250,26 +27688,31 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -22289,7 +27732,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -22297,21 +27740,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -22357,7 +27804,10 @@ paths: tags: - Network summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -22373,27 +27823,87 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - Network + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - Network @@ -22414,21 +27924,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -22448,7 +27962,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -22456,16 +27970,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -22516,24 +28033,28 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -22557,21 +28078,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -22586,7 +28111,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -22594,21 +28119,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -22663,7 +28192,10 @@ paths: tags: - Network summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -22679,27 +28211,87 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - Network + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - Network @@ -22720,21 +28312,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -22754,7 +28350,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -22762,16 +28358,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -22822,19 +28421,22 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -22858,16 +28460,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -22888,24 +28493,28 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -22929,21 +28538,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -22958,7 +28571,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -22966,21 +28579,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -23031,7 +28648,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -23047,27 +28667,87 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -23088,21 +28768,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -23128,24 +28812,28 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -23169,21 +28857,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -23198,7 +28890,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -23206,21 +28898,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -23271,7 +28967,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -23287,27 +28986,87 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -23328,21 +29087,25 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -23362,7 +29125,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -23370,16 +29133,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -23414,7 +29180,10 @@ paths: tags: - Network summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface consumes: - application/json @@ -23430,22 +29199,75 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - Network + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - Network @@ -23466,16 +29288,19 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -23495,7 +29320,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -23503,11 +29328,13 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -23537,7 +29364,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-interface" + $ref: "#/getDefinitions/lag-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -23545,11 +29372,13 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -23569,7 +29398,10 @@ paths: tags: - Network summary: create or update an existing lag-interface - description: create or update an existing lag-interface + description: | + Create or update an existing lag-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterface consumes: - application/json @@ -23585,17 +29417,63 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: lag-interface object that needs to be created or updated + description: lag-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterface.json) required: true schema: $ref: "#/definitions/lag-interface" + patch: + tags: + - Network + summary: update an existing lag-interface + description: | + Update an existing lag-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: lag-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/lag-interface" delete: tags: - Network @@ -23616,11 +29494,13 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -23640,7 +29520,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-interfaces" + $ref: "#/getDefinitions/lag-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -23648,6 +29528,7 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -23667,7 +29548,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vpls-pe" + $ref: "#/getDefinitions/vpls-pe" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -23675,6 +29556,7 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: prov-status in: query description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. @@ -23684,7 +29566,10 @@ paths: tags: - Network summary: create or update an existing vpls-pe - description: create or update an existing vpls-pe + description: | + Create or update an existing vpls-pe. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVplsPesVplsPe consumes: - application/json @@ -23700,12 +29585,51 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: body in: body - description: vpls-pe object that needs to be created or updated + description: vpls-pe object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPe.json) required: true schema: $ref: "#/definitions/vpls-pe" + patch: + tags: + - Network + summary: update an existing vpls-pe + description: | + Update an existing vpls-pe + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVplsPesVplsPe + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: equipment-name + in: path + required: true + type: string + example: __EQUIPMENT-NAME__ + - name: body + in: body + description: vpls-pe object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vpls-pe" delete: tags: - Network @@ -23726,6 +29650,7 @@ paths: in: path required: true type: string + example: __EQUIPMENT-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -23745,7 +29670,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vpls-pes" + $ref: "#/getDefinitions/vpls-pes" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/multicast-configurations/multicast-configuration/{multicast-configuration-id}/relationship-list/relationship: @@ -23769,9 +29694,10 @@ paths: description: Unique id of multicast configuration. required: true type: string + example: __MULTICAST-CONFIGURATION-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkMulticastConfigurationsMulticastConfiguration.json) required: true schema: $ref: "#/definitions/relationship" @@ -23796,6 +29722,7 @@ paths: description: Unique id of multicast configuration. required: true type: string + example: __MULTICAST-CONFIGURATION-ID__ /network/multicast-configurations/multicast-configuration/{multicast-configuration-id}: get: tags: @@ -23810,7 +29737,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/multicast-configuration" + $ref: "#/getDefinitions/multicast-configuration" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -23819,11 +29746,15 @@ paths: description: Unique id of multicast configuration. required: true type: string + example: __MULTICAST-CONFIGURATION-ID__ put: tags: - Network summary: create or update an existing multicast-configuration - description: create or update an existing multicast-configuration + description: | + Create or update an existing multicast-configuration. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkMulticastConfigurationsMulticastConfiguration consumes: - application/json @@ -23840,12 +29771,52 @@ paths: description: Unique id of multicast configuration. required: true type: string + example: __MULTICAST-CONFIGURATION-ID__ - name: body in: body - description: multicast-configuration object that needs to be created or updated + description: multicast-configuration object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkMulticastConfigurationsMulticastConfiguration.json) required: true schema: $ref: "#/definitions/multicast-configuration" + patch: + tags: + - Network + summary: update an existing multicast-configuration + description: | + Update an existing multicast-configuration + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkMulticastConfigurationsMulticastConfiguration + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: multicast-configuration-id + in: path + description: Unique id of multicast configuration. + required: true + type: string + example: __MULTICAST-CONFIGURATION-ID__ + - name: body + in: body + description: multicast-configuration object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/multicast-configuration" delete: tags: - Network @@ -23867,6 +29838,7 @@ paths: description: Unique id of multicast configuration. required: true type: string + example: __MULTICAST-CONFIGURATION-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -23886,7 +29858,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/multicast-configurations" + $ref: "#/getDefinitions/multicast-configurations" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/cvlan-tags/cvlan-tag-entry/{cvlan-tag}/relationship-list/relationship: @@ -23910,20 +29882,23 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: cvlan-tag in: path description: See mis-na-virtualization-platform.yang required: true type: integer format: int64 + example: __CVLAN-TAG__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry.json) required: true schema: $ref: "#/definitions/relationship" @@ -23948,17 +29923,20 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: cvlan-tag in: path description: See mis-na-virtualization-platform.yang required: true type: integer format: int64 + example: __CVLAN-TAG__ /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/cvlan-tags/cvlan-tag-entry/{cvlan-tag}: get: tags: @@ -23973,7 +29951,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/cvlan-tag-entry" + $ref: "#/getDefinitions/cvlan-tag-entry" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -23982,17 +29960,20 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: cvlan-tag in: path description: See mis-na-virtualization-platform.yang required: true type: integer format: int64 + example: __CVLAN-TAG__ - name: vnf-name in: query description: Name of VNF. @@ -24052,7 +30033,10 @@ paths: tags: - Network summary: create or update an existing cvlan-tag-entry - description: create or update an existing cvlan-tag-entry + description: | + Create or update an existing cvlan-tag-entry. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry consumes: - application/json @@ -24069,23 +30053,78 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: cvlan-tag in: path description: See mis-na-virtualization-platform.yang required: true type: integer format: int64 + example: __CVLAN-TAG__ - name: body in: body - description: cvlan-tag-entry object that needs to be created or updated + description: cvlan-tag-entry object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry.json) required: true schema: $ref: "#/definitions/cvlan-tag-entry" + patch: + tags: + - Network + summary: update an existing cvlan-tag-entry + description: | + Update an existing cvlan-tag-entry + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-id + in: path + description: Unique ID of the interface + required: true + type: string + example: __INTERFACE-ID__ + - name: cvlan-tag + in: path + description: See mis-na-virtualization-platform.yang + required: true + type: integer + format: int64 + example: __CVLAN-TAG__ + - name: body + in: body + description: cvlan-tag-entry object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/cvlan-tag-entry" delete: tags: - Network @@ -24107,17 +30146,20 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: cvlan-tag in: path description: See mis-na-virtualization-platform.yang required: true type: integer format: int64 + example: __CVLAN-TAG__ - name: resource-version in: query description: resource-version for concurrency @@ -24137,7 +30179,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/cvlan-tags" + $ref: "#/getDefinitions/cvlan-tags" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -24146,11 +30188,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: vnf-name in: query description: Name of VNF. @@ -24227,14 +30271,16 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVcePortGroupsPortGroup.json) required: true schema: $ref: "#/definitions/relationship" @@ -24259,11 +30305,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}: get: tags: @@ -24278,7 +30326,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/port-group" + $ref: "#/getDefinitions/port-group" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -24287,11 +30335,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: vnf-name in: query description: Name of VNF. @@ -24351,7 +30401,10 @@ paths: tags: - Network summary: create or update an existing port-group - description: create or update an existing port-group + description: | + Create or update an existing port-group. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroup consumes: - application/json @@ -24368,17 +30421,64 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: body in: body - description: port-group object that needs to be created or updated + description: port-group object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVcePortGroupsPortGroup.json) required: true schema: $ref: "#/definitions/port-group" + patch: + tags: + - Network + summary: update an existing port-group + description: | + Update an existing port-group + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVcesVcePortGroupsPortGroup + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-id + in: path + description: Unique ID of the interface + required: true + type: string + example: __INTERFACE-ID__ + - name: body + in: body + description: port-group object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/port-group" delete: tags: - Network @@ -24400,11 +30500,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-id in: path description: Unique ID of the interface required: true type: string + example: __INTERFACE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -24424,7 +30526,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/port-groups" + $ref: "#/getDefinitions/port-groups" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -24433,6 +30535,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -24494,19 +30597,22 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVceLicensesLicense.json) required: true schema: $ref: "#/definitions/relationship" @@ -24531,16 +30637,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ /network/vces/vce/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}: get: tags: @@ -24555,7 +30664,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/license" + $ref: "#/getDefinitions/license" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -24564,16 +30673,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ - name: vnf-name in: query description: Name of VNF. @@ -24618,7 +30730,10 @@ paths: tags: - Network summary: create or update an existing license - description: create or update an existing license + description: | + Create or update an existing license. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVcesVceLicensesLicense consumes: - application/json @@ -24635,22 +30750,76 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ - name: body in: body - description: license object that needs to be created or updated + description: license object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVceLicensesLicense.json) required: true schema: $ref: "#/definitions/license" + patch: + tags: + - Network + summary: update an existing license + description: | + Update an existing license + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVcesVceLicensesLicense + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: group-uuid + in: path + description: Unique ID for the license group the resource belongs to, should be uuid. + required: true + type: string + example: __GROUP-UUID__ + - name: resource-uuid + in: path + description: Unique ID of a license resource. + required: true + type: string + example: __RESOURCE-UUID__ + - name: body + in: body + description: license object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/license" delete: tags: - Network @@ -24672,16 +30841,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -24701,7 +30873,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/licenses" + $ref: "#/getDefinitions/licenses" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -24710,6 +30882,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -24771,19 +30944,22 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVceEntitlementsEntitlement.json) required: true schema: $ref: "#/definitions/relationship" @@ -24808,16 +30984,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ /network/vces/vce/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}: get: tags: @@ -24832,7 +31011,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/entitlement" + $ref: "#/getDefinitions/entitlement" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -24841,16 +31020,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ - name: vnf-name in: query description: Name of VNF. @@ -24895,7 +31077,10 @@ paths: tags: - Network summary: create or update an existing entitlement - description: create or update an existing entitlement + description: | + Create or update an existing entitlement. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVcesVceEntitlementsEntitlement consumes: - application/json @@ -24912,22 +31097,76 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ - name: body in: body - description: entitlement object that needs to be created or updated + description: entitlement object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVceEntitlementsEntitlement.json) required: true schema: $ref: "#/definitions/entitlement" + patch: + tags: + - Network + summary: update an existing entitlement + description: | + Update an existing entitlement + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVcesVceEntitlementsEntitlement + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: group-uuid + in: path + description: Unique ID for the entitlement group the resource comes from, should be uuid. + required: true + type: string + example: __GROUP-UUID__ + - name: resource-uuid + in: path + description: Unique ID of an entitlement resource. + required: true + type: string + example: __RESOURCE-UUID__ + - name: body + in: body + description: entitlement object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/entitlement" delete: tags: - Network @@ -24949,16 +31188,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -24978,7 +31220,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/entitlements" + $ref: "#/getDefinitions/entitlements" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -24987,6 +31229,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -25048,9 +31291,10 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVce.json) required: true schema: $ref: "#/definitions/relationship" @@ -25075,6 +31319,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ /network/vces/vce/{vnf-id}: get: tags: @@ -25089,7 +31334,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vce" + $ref: "#/getDefinitions/vce" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -25098,6 +31343,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -25142,7 +31388,10 @@ paths: tags: - Network summary: create or update an existing vce - description: create or update an existing vce + description: | + Create or update an existing vce. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVcesVce consumes: - application/json @@ -25159,12 +31408,52 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: body in: body - description: vce object that needs to be created or updated + description: vce object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVce.json) required: true schema: $ref: "#/definitions/vce" + patch: + tags: + - Network + summary: update an existing vce + description: | + Update an existing vce + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVcesVce + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: body + in: body + description: vce object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vce" delete: tags: - Network @@ -25186,6 +31475,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -25205,7 +31495,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vces" + $ref: "#/getDefinitions/vces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/vnfcs/vnfc/{vnfc-name}/relationship-list/relationship: @@ -25229,9 +31519,10 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfc.json) required: true schema: $ref: "#/definitions/relationship" @@ -25256,6 +31547,7 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -25277,14 +31569,16 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfcL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -25309,11 +31603,13 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -25328,7 +31624,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -25337,11 +31633,13 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: nfc-naming-code in: query description: Short code that is used in naming instances of the item being modeled @@ -25405,7 +31703,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVnfcsVnfcL3InterfaceIpv4AddressList consumes: - application/json @@ -25422,17 +31723,64 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfcL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVnfcsVnfcL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnfc-name + in: path + description: Unique ID of vnfc. + required: true + type: string + example: __VNFC-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -25454,11 +31802,13 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -25485,14 +31835,16 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfcL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -25517,11 +31869,13 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -25536,7 +31890,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -25545,11 +31899,13 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: nfc-naming-code in: query description: Short code that is used in naming instances of the item being modeled @@ -25613,7 +31969,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVnfcsVnfcL3InterfaceIpv6AddressList consumes: - application/json @@ -25630,17 +31989,64 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfcL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVnfcsVnfcL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnfc-name + in: path + description: Unique ID of vnfc. + required: true + type: string + example: __VNFC-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -25662,11 +32068,13 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -25686,7 +32094,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vnfc" + $ref: "#/getDefinitions/vnfc" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -25695,6 +32103,7 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: nfc-naming-code in: query description: Short code that is used in naming instances of the item being modeled @@ -25742,7 +32151,10 @@ paths: tags: - Network summary: create or update an existing vnfc - description: create or update an existing vnfc + description: | + Create or update an existing vnfc. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkVnfcsVnfc consumes: - application/json @@ -25759,12 +32171,52 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: body in: body - description: vnfc object that needs to be created or updated + description: vnfc object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfc.json) required: true schema: $ref: "#/definitions/vnfc" + patch: + tags: + - Network + summary: update an existing vnfc + description: | + Update an existing vnfc + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkVnfcsVnfc + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnfc-name + in: path + description: Unique ID of vnfc. + required: true + type: string + example: __VNFC-NAME__ + - name: body + in: body + description: vnfc object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vnfc" delete: tags: - Network @@ -25786,6 +32238,7 @@ paths: description: Unique ID of vnfc. required: true type: string + example: __VNFC-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -25805,7 +32258,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vnfcs" + $ref: "#/getDefinitions/vnfcs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/host-routes/host-route/{host-route-id}/relationship-list/relationship: @@ -25829,19 +32282,22 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: host-route-id in: path description: host-route id required: true type: string + example: __HOST-ROUTE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute.json) required: true schema: $ref: "#/definitions/relationship" @@ -25866,16 +32322,19 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: host-route-id in: path description: host-route id required: true type: string + example: __HOST-ROUTE-ID__ /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/host-routes/host-route/{host-route-id}: get: tags: @@ -25890,7 +32349,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/host-route" + $ref: "#/getDefinitions/host-route" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -25899,16 +32358,19 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: host-route-id in: path description: host-route id required: true type: string + example: __HOST-ROUTE-ID__ - name: network-name in: query description: Name of the network, governed by some naming convention.. @@ -25963,7 +32425,10 @@ paths: tags: - Network summary: create or update an existing host-route - description: create or update an existing host-route + description: | + Create or update an existing host-route. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute consumes: - application/json @@ -25980,22 +32445,76 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: host-route-id in: path description: host-route id required: true type: string + example: __HOST-ROUTE-ID__ - name: body in: body - description: host-route object that needs to be created or updated + description: host-route object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute.json) required: true schema: $ref: "#/definitions/host-route" + patch: + tags: + - Network + summary: update an existing host-route + description: | + Update an existing host-route + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: network-id + in: path + description: Network ID, should be uuid. Unique across A&AI. + required: true + type: string + example: __NETWORK-ID__ + - name: subnet-id + in: path + description: Subnet ID, should be UUID. + required: true + type: string + example: __SUBNET-ID__ + - name: host-route-id + in: path + description: host-route id + required: true + type: string + example: __HOST-ROUTE-ID__ + - name: body + in: body + description: host-route object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/host-route" delete: tags: - Network @@ -26017,16 +32536,19 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: host-route-id in: path description: host-route id required: true type: string + example: __HOST-ROUTE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -26046,7 +32568,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/host-routes" + $ref: "#/getDefinitions/host-routes" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -26055,11 +32577,13 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: network-name in: query description: Name of the network, governed by some naming convention.. @@ -26131,14 +32655,16 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSubnetsSubnet.json) required: true schema: $ref: "#/definitions/relationship" @@ -26163,11 +32689,13 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}: get: tags: @@ -26182,7 +32710,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/subnet" + $ref: "#/getDefinitions/subnet" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -26191,11 +32719,13 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: network-name in: query description: Name of the network, governed by some naming convention.. @@ -26250,7 +32780,10 @@ paths: tags: - Network summary: create or update an existing subnet - description: create or update an existing subnet + description: | + Create or update an existing subnet. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkL3NetworksL3NetworkSubnetsSubnet consumes: - application/json @@ -26267,17 +32800,64 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: body in: body - description: subnet object that needs to be created or updated + description: subnet object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSubnetsSubnet.json) required: true schema: $ref: "#/definitions/subnet" + patch: + tags: + - Network + summary: update an existing subnet + description: | + Update an existing subnet + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkL3NetworksL3NetworkSubnetsSubnet + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: network-id + in: path + description: Network ID, should be uuid. Unique across A&AI. + required: true + type: string + example: __NETWORK-ID__ + - name: subnet-id + in: path + description: Subnet ID, should be UUID. + required: true + type: string + example: __SUBNET-ID__ + - name: body + in: body + description: subnet object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/subnet" delete: tags: - Network @@ -26299,11 +32879,13 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: subnet-id in: path description: Subnet ID, should be UUID. required: true type: string + example: __SUBNET-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -26323,7 +32905,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/subnets" + $ref: "#/getDefinitions/subnets" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -26332,6 +32914,7 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: network-name in: query description: Name of the network, governed by some naming convention.. @@ -26398,15 +32981,17 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: vlan-id-inner in: path description: id. required: true type: integer format: int64 + example: __VLAN-ID-INNER__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment.json) required: true schema: $ref: "#/definitions/relationship" @@ -26431,12 +33016,14 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: vlan-id-inner in: path description: id. required: true type: integer format: int64 + example: __VLAN-ID-INNER__ /network/l3-networks/l3-network/{network-id}/ctag-assignments/ctag-assignment/{vlan-id-inner}: get: tags: @@ -26451,7 +33038,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/ctag-assignment" + $ref: "#/getDefinitions/ctag-assignment" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -26460,12 +33047,14 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: vlan-id-inner in: path description: id. required: true type: integer format: int64 + example: __VLAN-ID-INNER__ - name: network-name in: query description: Name of the network, governed by some naming convention.. @@ -26515,7 +33104,10 @@ paths: tags: - Network summary: create or update an existing ctag-assignment - description: create or update an existing ctag-assignment + description: | + Create or update an existing ctag-assignment. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment consumes: - application/json @@ -26532,18 +33124,66 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: vlan-id-inner in: path description: id. required: true type: integer format: int64 + example: __VLAN-ID-INNER__ - name: body in: body - description: ctag-assignment object that needs to be created or updated + description: ctag-assignment object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment.json) required: true schema: $ref: "#/definitions/ctag-assignment" + patch: + tags: + - Network + summary: update an existing ctag-assignment + description: | + Update an existing ctag-assignment + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: network-id + in: path + description: Network ID, should be uuid. Unique across A&AI. + required: true + type: string + example: __NETWORK-ID__ + - name: vlan-id-inner + in: path + description: id. + required: true + type: integer + format: int64 + example: __VLAN-ID-INNER__ + - name: body + in: body + description: ctag-assignment object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/ctag-assignment" delete: tags: - Network @@ -26565,12 +33205,14 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: vlan-id-inner in: path description: id. required: true type: integer format: int64 + example: __VLAN-ID-INNER__ - name: resource-version in: query description: resource-version for concurrency @@ -26590,7 +33232,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/ctag-assignments" + $ref: "#/getDefinitions/ctag-assignments" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -26599,6 +33241,7 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: network-name in: query description: Name of the network, governed by some naming convention.. @@ -26665,14 +33308,16 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: segmentation-id in: path description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __SEGMENTATION-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment.json) required: true schema: $ref: "#/definitions/relationship" @@ -26697,11 +33342,13 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: segmentation-id in: path description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __SEGMENTATION-ID__ /network/l3-networks/l3-network/{network-id}/segmentation-assignments/segmentation-assignment/{segmentation-id}: get: tags: @@ -26716,7 +33363,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/segmentation-assignment" + $ref: "#/getDefinitions/segmentation-assignment" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -26725,11 +33372,13 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: segmentation-id in: path description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __SEGMENTATION-ID__ - name: network-name in: query description: Name of the network, governed by some naming convention.. @@ -26779,7 +33428,10 @@ paths: tags: - Network summary: create or update an existing segmentation-assignment - description: create or update an existing segmentation-assignment + description: | + Create or update an existing segmentation-assignment. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment consumes: - application/json @@ -26796,17 +33448,64 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: segmentation-id in: path description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __SEGMENTATION-ID__ - name: body in: body - description: segmentation-assignment object that needs to be created or updated + description: segmentation-assignment object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment.json) required: true schema: $ref: "#/definitions/segmentation-assignment" + patch: + tags: + - Network + summary: update an existing segmentation-assignment + description: | + Update an existing segmentation-assignment + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: network-id + in: path + description: Network ID, should be uuid. Unique across A&AI. + required: true + type: string + example: __NETWORK-ID__ + - name: segmentation-id + in: path + description: Route Table Reference id, UUID assigned to this instance. + required: true + type: string + example: __SEGMENTATION-ID__ + - name: body + in: body + description: segmentation-assignment object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/segmentation-assignment" delete: tags: - Network @@ -26828,11 +33527,13 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: segmentation-id in: path description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __SEGMENTATION-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -26852,7 +33553,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/segmentation-assignments" + $ref: "#/getDefinitions/segmentation-assignments" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -26861,6 +33562,7 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: network-name in: query description: Name of the network, governed by some naming convention.. @@ -26927,9 +33629,10 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3Network.json) required: true schema: $ref: "#/definitions/relationship" @@ -26954,6 +33657,7 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ /network/l3-networks/l3-network/{network-id}: get: tags: @@ -26968,7 +33672,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-network" + $ref: "#/getDefinitions/l3-network" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -26977,6 +33681,7 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: network-name in: query description: Name of the network, governed by some naming convention.. @@ -27026,7 +33731,10 @@ paths: tags: - Network summary: create or update an existing l3-network - description: create or update an existing l3-network + description: | + Create or update an existing l3-network. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkL3NetworksL3Network consumes: - application/json @@ -27043,12 +33751,52 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: body in: body - description: l3-network object that needs to be created or updated + description: l3-network object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3Network.json) required: true schema: $ref: "#/definitions/l3-network" + patch: + tags: + - Network + summary: update an existing l3-network + description: | + Update an existing l3-network + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkL3NetworksL3Network + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: network-id + in: path + description: Network ID, should be uuid. Unique across A&AI. + required: true + type: string + example: __NETWORK-ID__ + - name: body + in: body + description: l3-network object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-network" delete: tags: - Network @@ -27070,6 +33818,7 @@ paths: description: Network ID, should be uuid. Unique across A&AI. required: true type: string + example: __NETWORK-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -27089,7 +33838,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-networks" + $ref: "#/getDefinitions/l3-networks" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/network-policies/network-policy/{network-policy-id}/relationship-list/relationship: @@ -27113,9 +33862,10 @@ paths: description: UUID representing unique key to this instance required: true type: string + example: __NETWORK-POLICY-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNetworkPoliciesNetworkPolicy.json) required: true schema: $ref: "#/definitions/relationship" @@ -27140,6 +33890,7 @@ paths: description: UUID representing unique key to this instance required: true type: string + example: __NETWORK-POLICY-ID__ /network/network-policies/network-policy/{network-policy-id}: get: tags: @@ -27154,7 +33905,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/network-policy" + $ref: "#/getDefinitions/network-policy" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -27163,6 +33914,7 @@ paths: description: UUID representing unique key to this instance required: true type: string + example: __NETWORK-POLICY-ID__ - name: network-policy-fqdn in: query description: Contrail FQDN for the policy @@ -27172,7 +33924,10 @@ paths: tags: - Network summary: create or update an existing network-policy - description: create or update an existing network-policy + description: | + Create or update an existing network-policy. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkNetworkPoliciesNetworkPolicy consumes: - application/json @@ -27189,12 +33944,52 @@ paths: description: UUID representing unique key to this instance required: true type: string + example: __NETWORK-POLICY-ID__ - name: body in: body - description: network-policy object that needs to be created or updated + description: network-policy object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNetworkPoliciesNetworkPolicy.json) required: true schema: $ref: "#/definitions/network-policy" + patch: + tags: + - Network + summary: update an existing network-policy + description: | + Update an existing network-policy + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkNetworkPoliciesNetworkPolicy + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: network-policy-id + in: path + description: UUID representing unique key to this instance + required: true + type: string + example: __NETWORK-POLICY-ID__ + - name: body + in: body + description: network-policy object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/network-policy" delete: tags: - Network @@ -27216,6 +34011,7 @@ paths: description: UUID representing unique key to this instance required: true type: string + example: __NETWORK-POLICY-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -27235,7 +34031,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/network-policies" + $ref: "#/getDefinitions/network-policies" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/generic-vnfs/generic-vnf/{vnf-id}/relationship-list/relationship: @@ -27259,9 +34055,10 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnf.json) required: true schema: $ref: "#/definitions/relationship" @@ -27286,6 +34083,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship: put: tags: @@ -27307,19 +34105,22 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -27344,16 +34145,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -27375,24 +34179,28 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -27417,21 +34225,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -27446,7 +34258,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -27455,21 +34267,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -27599,7 +34415,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -27616,27 +34435,88 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -27658,21 +34538,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -27699,24 +34583,28 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -27741,21 +34629,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -27770,7 +34662,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -27779,21 +34671,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -27923,7 +34819,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -27940,27 +34839,88 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -27982,21 +34942,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -28016,7 +34980,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -28025,16 +34989,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: vnf-name in: query description: Name of VNF. @@ -28148,7 +35115,10 @@ paths: tags: - Network summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -28165,22 +35135,76 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - Network + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - Network @@ -28202,16 +35226,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -28231,7 +35258,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -28240,11 +35267,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -28364,19 +35393,22 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -28401,16 +35433,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -28425,7 +35460,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -28434,16 +35469,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: vnf-name in: query description: Name of VNF. @@ -28566,7 +35604,10 @@ paths: tags: - Network summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -28583,22 +35624,76 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - Network + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - Network @@ -28620,16 +35715,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -28649,7 +35747,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -28658,11 +35756,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -28782,14 +35882,16 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -28814,11 +35916,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -28840,19 +35944,22 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -28877,16 +35984,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -28901,7 +36011,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -28910,16 +36020,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -29038,7 +36151,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -29055,22 +36171,76 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -29092,16 +36262,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -29128,19 +36301,22 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -29165,16 +36341,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -29189,7 +36368,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -29198,16 +36377,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -29326,7 +36508,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -29343,22 +36528,76 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -29380,16 +36619,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -29409,7 +36651,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -29418,11 +36660,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -29525,7 +36769,10 @@ paths: tags: - Network summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterface consumes: - application/json @@ -29542,17 +36789,64 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - Network + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - Network @@ -29574,11 +36868,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -29598,7 +36894,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -29607,6 +36903,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -29711,14 +37008,16 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -29743,11 +37042,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship: put: tags: @@ -29769,24 +37070,28 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -29811,21 +37116,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -29847,29 +37156,34 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -29894,26 +37208,31 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -29928,7 +37247,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -29937,26 +37256,31 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -30096,7 +37420,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -30113,32 +37440,100 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -30160,26 +37555,31 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -30206,29 +37606,34 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -30253,26 +37658,31 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -30287,7 +37697,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -30296,26 +37706,31 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -30455,7 +37870,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -30472,32 +37890,100 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -30519,26 +38005,31 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -30558,7 +38049,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -30567,21 +38058,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: vnf-name in: query description: Name of VNF. @@ -30705,7 +38200,10 @@ paths: tags: - Network summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -30722,27 +38220,88 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - Network + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - Network @@ -30764,21 +38323,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -30798,7 +38361,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -30807,16 +38370,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -30946,24 +38512,28 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -30988,21 +38558,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -31017,7 +38591,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -31026,21 +38600,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: vnf-name in: query description: Name of VNF. @@ -31173,7 +38751,10 @@ paths: tags: - Network summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -31190,27 +38771,88 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - Network + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - Network @@ -31232,21 +38874,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -31266,7 +38912,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -31275,16 +38921,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -31414,19 +39063,22 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -31451,16 +39103,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -31482,24 +39137,28 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -31524,21 +39183,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -31553,7 +39216,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -31562,21 +39225,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -31705,7 +39372,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -31722,27 +39392,88 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -31764,21 +39495,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -31805,24 +39540,28 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -31847,21 +39586,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -31876,7 +39619,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -31885,21 +39628,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -32028,7 +39775,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -32045,27 +39795,88 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -32087,21 +39898,25 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -32121,7 +39936,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -32130,16 +39945,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -32252,7 +40070,10 @@ paths: tags: - Network summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface consumes: - application/json @@ -32269,22 +40090,76 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - Network + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - Network @@ -32306,16 +40181,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -32335,7 +40213,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -32344,11 +40222,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -32456,7 +40336,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-interface" + $ref: "#/getDefinitions/lag-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -32465,11 +40345,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -32567,7 +40449,10 @@ paths: tags: - Network summary: create or update an existing lag-interface - description: create or update an existing lag-interface + description: | + Create or update an existing lag-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterface consumes: - application/json @@ -32584,17 +40469,64 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: lag-interface object that needs to be created or updated + description: lag-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterface.json) required: true schema: $ref: "#/definitions/lag-interface" + patch: + tags: + - Network + summary: update an existing lag-interface + description: | + Update an existing lag-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: lag-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/lag-interface" delete: tags: - Network @@ -32616,11 +40548,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -32640,7 +40574,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-interfaces" + $ref: "#/getDefinitions/lag-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -32649,6 +40583,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -32753,14 +40688,16 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vf-module-id in: path description: Unique ID of vf-module. required: true type: string + example: __VF-MODULE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfVfModulesVfModule.json) required: true schema: $ref: "#/definitions/relationship" @@ -32785,11 +40722,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vf-module-id in: path description: Unique ID of vf-module. required: true type: string + example: __VF-MODULE-ID__ /network/generic-vnfs/generic-vnf/{vnf-id}/vf-modules/vf-module/{vf-module-id}: get: tags: @@ -32804,7 +40743,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vf-module" + $ref: "#/getDefinitions/vf-module" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -32813,11 +40752,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vf-module-id in: path description: Unique ID of vf-module. required: true type: string + example: __VF-MODULE-ID__ - name: vnf-name in: query description: Name of VNF. @@ -32940,7 +40881,10 @@ paths: tags: - Network summary: create or update an existing vf-module - description: create or update an existing vf-module + description: | + Create or update an existing vf-module. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfVfModulesVfModule consumes: - application/json @@ -32957,17 +40901,64 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vf-module-id in: path description: Unique ID of vf-module. required: true type: string + example: __VF-MODULE-ID__ - name: body in: body - description: vf-module object that needs to be created or updated + description: vf-module object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfVfModulesVfModule.json) required: true schema: $ref: "#/definitions/vf-module" + patch: + tags: + - Network + summary: update an existing vf-module + description: | + Update an existing vf-module + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfVfModulesVfModule + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: vf-module-id + in: path + description: Unique ID of vf-module. + required: true + type: string + example: __VF-MODULE-ID__ + - name: body + in: body + description: vf-module object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vf-module" delete: tags: - Network @@ -32989,11 +40980,13 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vf-module-id in: path description: Unique ID of vf-module. required: true type: string + example: __VF-MODULE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -33013,7 +41006,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vf-modules" + $ref: "#/getDefinitions/vf-modules" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -33022,6 +41015,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -33126,19 +41120,22 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLicensesLicense.json) required: true schema: $ref: "#/definitions/relationship" @@ -33163,16 +41160,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ /network/generic-vnfs/generic-vnf/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}: get: tags: @@ -33187,7 +41187,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/license" + $ref: "#/getDefinitions/license" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -33196,16 +41196,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ - name: vnf-name in: query description: Name of VNF. @@ -33293,7 +41296,10 @@ paths: tags: - Network summary: create or update an existing license - description: create or update an existing license + description: | + Create or update an existing license. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfLicensesLicense consumes: - application/json @@ -33310,22 +41316,76 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ - name: body in: body - description: license object that needs to be created or updated + description: license object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLicensesLicense.json) required: true schema: $ref: "#/definitions/license" + patch: + tags: + - Network + summary: update an existing license + description: | + Update an existing license + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfLicensesLicense + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: group-uuid + in: path + description: Unique ID for the license group the resource belongs to, should be uuid. + required: true + type: string + example: __GROUP-UUID__ + - name: resource-uuid + in: path + description: Unique ID of a license resource. + required: true + type: string + example: __RESOURCE-UUID__ + - name: body + in: body + description: license object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/license" delete: tags: - Network @@ -33347,16 +41407,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the license group the resource belongs to, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of a license resource. required: true type: string + example: __RESOURCE-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -33376,7 +41439,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/licenses" + $ref: "#/getDefinitions/licenses" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -33385,6 +41448,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -33489,19 +41553,22 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfEntitlementsEntitlement.json) required: true schema: $ref: "#/definitions/relationship" @@ -33526,16 +41593,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ /network/generic-vnfs/generic-vnf/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}: get: tags: @@ -33550,7 +41620,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/entitlement" + $ref: "#/getDefinitions/entitlement" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -33559,16 +41629,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ - name: vnf-name in: query description: Name of VNF. @@ -33656,7 +41729,10 @@ paths: tags: - Network summary: create or update an existing entitlement - description: create or update an existing entitlement + description: | + Create or update an existing entitlement. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnfEntitlementsEntitlement consumes: - application/json @@ -33673,22 +41749,76 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ - name: body in: body - description: entitlement object that needs to be created or updated + description: entitlement object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfEntitlementsEntitlement.json) required: true schema: $ref: "#/definitions/entitlement" + patch: + tags: + - Network + summary: update an existing entitlement + description: | + Update an existing entitlement + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnfEntitlementsEntitlement + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: group-uuid + in: path + description: Unique ID for the entitlement group the resource comes from, should be uuid. + required: true + type: string + example: __GROUP-UUID__ + - name: resource-uuid + in: path + description: Unique ID of an entitlement resource. + required: true + type: string + example: __RESOURCE-UUID__ + - name: body + in: body + description: entitlement object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/entitlement" delete: tags: - Network @@ -33710,16 +41840,19 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: group-uuid in: path description: Unique ID for the entitlement group the resource comes from, should be uuid. required: true type: string + example: __GROUP-UUID__ - name: resource-uuid in: path description: Unique ID of an entitlement resource. required: true type: string + example: __RESOURCE-UUID__ - name: resource-version in: query description: resource-version for concurrency @@ -33739,7 +41872,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/entitlements" + $ref: "#/getDefinitions/entitlements" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -33748,6 +41881,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -33845,7 +41979,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/generic-vnf" + $ref: "#/getDefinitions/generic-vnf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -33854,6 +41988,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: vnf-name in: query description: Name of VNF. @@ -33941,7 +42076,10 @@ paths: tags: - Network summary: create or update an existing generic-vnf - description: create or update an existing generic-vnf + description: | + Create or update an existing generic-vnf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkGenericVnfsGenericVnf consumes: - application/json @@ -33958,12 +42096,52 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: body in: body - description: generic-vnf object that needs to be created or updated + description: generic-vnf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnf.json) required: true schema: $ref: "#/definitions/generic-vnf" + patch: + tags: + - Network + summary: update an existing generic-vnf + description: | + Update an existing generic-vnf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkGenericVnfsGenericVnf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id + in: path + description: Unique id of VNF. This is unique across the graph. + required: true + type: string + example: __VNF-ID__ + - name: body + in: body + description: generic-vnf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/generic-vnf" delete: tags: - Network @@ -33985,6 +42163,7 @@ paths: description: Unique id of VNF. This is unique across the graph. required: true type: string + example: __VNF-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -34004,7 +42183,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/generic-vnfs" + $ref: "#/getDefinitions/generic-vnfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/lag-links/lag-link/{link-name}/relationship-list/relationship: @@ -34028,9 +42207,10 @@ paths: description: Alphabetical concatenation of lag-interface names required: true type: string + example: __LINK-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkLagLinksLagLink.json) required: true schema: $ref: "#/definitions/relationship" @@ -34055,6 +42235,7 @@ paths: description: Alphabetical concatenation of lag-interface names required: true type: string + example: __LINK-NAME__ /network/lag-links/lag-link/{link-name}: get: tags: @@ -34069,7 +42250,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-link" + $ref: "#/getDefinitions/lag-link" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -34078,11 +42259,15 @@ paths: description: Alphabetical concatenation of lag-interface names required: true type: string + example: __LINK-NAME__ put: tags: - Network summary: create or update an existing lag-link - description: create or update an existing lag-link + description: | + Create or update an existing lag-link. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkLagLinksLagLink consumes: - application/json @@ -34099,12 +42284,52 @@ paths: description: Alphabetical concatenation of lag-interface names required: true type: string + example: __LINK-NAME__ - name: body in: body - description: lag-link object that needs to be created or updated + description: lag-link object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkLagLinksLagLink.json) required: true schema: $ref: "#/definitions/lag-link" + patch: + tags: + - Network + summary: update an existing lag-link + description: | + Update an existing lag-link + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkLagLinksLagLink + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: link-name + in: path + description: Alphabetical concatenation of lag-interface names + required: true + type: string + example: __LINK-NAME__ + - name: body + in: body + description: lag-link object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/lag-link" delete: tags: - Network @@ -34126,6 +42351,7 @@ paths: description: Alphabetical concatenation of lag-interface names required: true type: string + example: __LINK-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -34145,7 +42371,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-links" + $ref: "#/getDefinitions/lag-links" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/newvces/newvce/{vnf-id2}/relationship-list/relationship: @@ -34169,9 +42395,10 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvce.json) required: true schema: $ref: "#/definitions/relationship" @@ -34196,6 +42423,7 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship: put: tags: @@ -34217,19 +42445,22 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -34254,16 +42485,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -34285,24 +42519,28 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -34327,21 +42565,25 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -34356,7 +42598,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -34365,21 +42607,25 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -34451,7 +42697,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -34468,27 +42717,88 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id2 + in: path + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + required: true + type: string + example: __VNF-ID2__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -34510,21 +42820,25 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -34551,24 +42865,28 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -34593,21 +42911,25 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -34622,7 +42944,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -34631,21 +42953,25 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -34717,7 +43043,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -34734,27 +43063,88 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id2 + in: path + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + required: true + type: string + example: __VNF-ID2__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -34776,21 +43166,25 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -34810,7 +43204,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -34819,16 +43213,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: vnf-name in: query description: Name of VNF. @@ -34884,7 +43281,10 @@ paths: tags: - Network summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -34901,22 +43301,76 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - Network + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id2 + in: path + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + required: true + type: string + example: __VNF-ID2__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - Network @@ -34938,16 +43392,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -34967,7 +43424,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -34976,11 +43433,13 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -35042,19 +43501,22 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -35079,16 +43541,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -35103,7 +43568,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -35112,16 +43577,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: vnf-name in: query description: Name of VNF. @@ -35186,7 +43654,10 @@ paths: tags: - Network summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -35203,22 +43674,76 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - Network + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id2 + in: path + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + required: true + type: string + example: __VNF-ID2__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - Network @@ -35240,16 +43765,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -35269,7 +43797,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -35278,11 +43806,13 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -35344,14 +43874,16 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -35376,11 +43908,13 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -35402,19 +43936,22 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -35439,16 +43976,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -35463,7 +44003,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -35472,16 +44012,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -35542,7 +44085,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -35559,22 +44105,76 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id2 + in: path + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + required: true + type: string + example: __VNF-ID2__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -35596,16 +44196,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -35632,19 +44235,22 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -35669,16 +44275,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -35693,7 +44302,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -35702,16 +44311,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: vnf-name in: query description: Name of VNF. @@ -35772,7 +44384,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -35789,22 +44404,76 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id2 + in: path + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + required: true + type: string + example: __VNF-ID2__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -35826,16 +44495,19 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -35855,7 +44527,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -35864,11 +44536,13 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vnf-name in: query description: Name of VNF. @@ -35913,7 +44587,10 @@ paths: tags: - Network summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterface consumes: - application/json @@ -35930,17 +44607,64 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - Network + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id2 + in: path + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + required: true + type: string + example: __VNF-ID2__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - Network @@ -35962,11 +44686,13 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -35986,7 +44712,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -35995,6 +44721,7 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: vnf-name in: query description: Name of VNF. @@ -36034,7 +44761,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/newvce" + $ref: "#/getDefinitions/newvce" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -36043,6 +44770,7 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: vnf-name in: query description: Name of VNF. @@ -36072,7 +44800,10 @@ paths: tags: - Network summary: create or update an existing newvce - description: create or update an existing newvce + description: | + Create or update an existing newvce. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkNewvcesNewvce consumes: - application/json @@ -36089,12 +44820,52 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: body in: body - description: newvce object that needs to be created or updated + description: newvce object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvce.json) required: true schema: $ref: "#/definitions/newvce" + patch: + tags: + - Network + summary: update an existing newvce + description: | + Update an existing newvce + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkNewvcesNewvce + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: vnf-id2 + in: path + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + required: true + type: string + example: __VNF-ID2__ + - name: body + in: body + description: newvce object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/newvce" delete: tags: - Network @@ -36116,6 +44887,7 @@ paths: description: Unique id of VNF, can't use same attribute name right now until we promote this new object required: true type: string + example: __VNF-ID2__ - name: resource-version in: query description: resource-version for concurrency @@ -36135,7 +44907,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/newvces" + $ref: "#/getDefinitions/newvces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/pnfs/pnf/{pnf-name}/relationship-list/relationship: @@ -36159,9 +44931,10 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnf.json) required: true schema: $ref: "#/definitions/relationship" @@ -36186,6 +44959,7 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship: put: tags: @@ -36207,14 +44981,16 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -36239,11 +45015,13 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship: put: tags: @@ -36265,19 +45043,22 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf.json) required: true schema: $ref: "#/definitions/relationship" @@ -36302,16 +45083,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}: get: tags: @@ -36326,7 +45110,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-pf" + $ref: "#/getDefinitions/sriov-pf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -36335,16 +45119,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -36359,7 +45146,10 @@ paths: tags: - Network summary: create or update an existing sriov-pf - description: create or update an existing sriov-pf + description: | + Create or update an existing sriov-pf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf consumes: - application/json @@ -36376,22 +45166,76 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: body in: body - description: sriov-pf object that needs to be created or updated + description: sriov-pf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf.json) required: true schema: $ref: "#/definitions/sriov-pf" + patch: + tags: + - Network + summary: update an existing sriov-pf + description: | + Update an existing sriov-pf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pf-pci-id + in: path + description: Identifier for the sriov-pf + required: true + type: string + example: __PF-PCI-ID__ + - name: body + in: body + description: sriov-pf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-pf" delete: tags: - Network @@ -36413,16 +45257,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: pf-pci-id in: path description: Identifier for the sriov-pf required: true type: string + example: __PF-PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -36442,7 +45289,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-pfs" + $ref: "#/getDefinitions/sriov-pfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -36451,11 +45298,13 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -36487,24 +45336,28 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -36529,21 +45382,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -36565,29 +45422,34 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -36612,26 +45474,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -36646,7 +45513,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -36655,26 +45522,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -36731,7 +45603,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -36748,32 +45623,100 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -36795,26 +45738,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -36841,29 +45789,34 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -36888,26 +45841,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -36922,7 +45880,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -36931,26 +45889,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -37007,7 +45970,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -37024,32 +45990,100 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -37071,26 +46105,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -37110,7 +46149,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -37119,21 +46158,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -37174,7 +46217,10 @@ paths: tags: - Network summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -37191,27 +46237,88 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - Network + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - Network @@ -37233,21 +46340,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -37267,7 +46378,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -37276,16 +46387,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -37332,24 +46446,28 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -37374,21 +46492,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -37403,7 +46525,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -37412,21 +46534,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -37476,7 +46602,10 @@ paths: tags: - Network summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -37493,27 +46622,88 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - Network + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - Network @@ -37535,21 +46725,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -37569,7 +46763,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -37578,16 +46772,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -37634,19 +46831,22 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -37671,16 +46871,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -37702,24 +46905,28 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -37744,21 +46951,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -37773,7 +46984,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -37782,21 +46993,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -37842,7 +47057,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -37859,27 +47077,88 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -37901,21 +47180,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -37942,24 +47225,28 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -37984,21 +47271,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -38013,7 +47304,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -38022,21 +47313,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -38082,7 +47377,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -38099,27 +47397,88 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -38141,21 +47500,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -38175,7 +47538,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -38184,16 +47547,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -38223,7 +47589,10 @@ paths: tags: - Network summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface consumes: - application/json @@ -38240,22 +47609,76 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - Network + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - Network @@ -38277,16 +47700,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -38306,7 +47732,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -38315,11 +47741,13 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -38344,7 +47772,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/p-interface" + $ref: "#/getDefinitions/p-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -38353,11 +47781,13 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -38372,7 +47802,10 @@ paths: tags: - Network summary: create or update an existing p-interface - description: create or update an existing p-interface + description: | + Create or update an existing p-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterface consumes: - application/json @@ -38389,17 +47822,64 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: p-interface object that needs to be created or updated + description: p-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterface.json) required: true schema: $ref: "#/definitions/p-interface" + patch: + tags: + - Network + summary: update an existing p-interface + description: | + Update an existing p-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfPInterfacesPInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the physical interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: p-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/p-interface" delete: tags: - Network @@ -38421,11 +47901,13 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the physical interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -38445,7 +47927,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/p-interfaces" + $ref: "#/getDefinitions/p-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -38454,6 +47936,7 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -38480,14 +47963,16 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -38512,11 +47997,13 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship: put: tags: @@ -38538,24 +48025,28 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/relationship" @@ -38580,21 +48071,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -38616,29 +48111,34 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -38663,26 +48163,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -38697,7 +48202,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -38706,26 +48211,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -38787,7 +48297,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList consumes: - application/json @@ -38804,32 +48317,100 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -38851,26 +48432,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -38897,29 +48483,34 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -38944,26 +48535,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -38978,7 +48574,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -38987,26 +48583,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -39068,7 +48669,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList consumes: - application/json @@ -39085,32 +48689,100 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -39132,26 +48804,31 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -39171,7 +48848,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlan" + $ref: "#/getDefinitions/vlan" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -39180,21 +48857,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -39240,7 +48921,10 @@ paths: tags: - Network summary: create or update an existing vlan - description: create or update an existing vlan + description: | + Create or update an existing vlan. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan consumes: - application/json @@ -39257,27 +48941,88 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: body in: body - description: vlan object that needs to be created or updated + description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json) required: true schema: $ref: "#/definitions/vlan" + patch: + tags: + - Network + summary: update an existing vlan + description: | + Update an existing vlan + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: vlan-interface + in: path + description: String that identifies the interface + required: true + type: string + example: __VLAN-INTERFACE__ + - name: body + in: body + description: vlan object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vlan" delete: tags: - Network @@ -39299,21 +49044,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: vlan-interface in: path description: String that identifies the interface required: true type: string + example: __VLAN-INTERFACE__ - name: resource-version in: query description: resource-version for concurrency @@ -39333,7 +49082,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vlans" + $ref: "#/getDefinitions/vlans" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -39342,16 +49091,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -39403,24 +49155,28 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/relationship" @@ -39445,21 +49201,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}: get: tags: @@ -39474,7 +49234,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vf" + $ref: "#/getDefinitions/sriov-vf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -39483,21 +49243,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -39552,7 +49316,10 @@ paths: tags: - Network summary: create or update an existing sriov-vf - description: create or update an existing sriov-vf + description: | + Create or update an existing sriov-vf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf consumes: - application/json @@ -39569,27 +49336,88 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: body in: body - description: sriov-vf object that needs to be created or updated + description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json) required: true schema: $ref: "#/definitions/sriov-vf" + patch: + tags: + - Network + summary: update an existing sriov-vf + description: | + Update an existing sriov-vf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: pci-id + in: path + description: PCI ID used to identify the sriov-vf + required: true + type: string + example: __PCI-ID__ + - name: body + in: body + description: sriov-vf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/sriov-vf" delete: tags: - Network @@ -39611,21 +49439,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: pci-id in: path description: PCI ID used to identify the sriov-vf required: true type: string + example: __PCI-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -39645,7 +49477,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/sriov-vfs" + $ref: "#/getDefinitions/sriov-vfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -39654,16 +49486,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -39715,19 +49550,22 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/relationship" @@ -39752,16 +49590,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship: put: tags: @@ -39783,24 +49624,28 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -39825,21 +49670,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}: get: tags: @@ -39854,7 +49703,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv4-address-list" + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -39863,21 +49712,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -39928,7 +49781,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv4-address-list - description: create or update an existing l3-interface-ipv4-address-list + description: | + Create or update an existing l3-interface-ipv4-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList consumes: - application/json @@ -39945,27 +49801,88 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: body in: body - description: l3-interface-ipv4-address-list object that needs to be created or updated + description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv4-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv4-address-list + description: | + Update an existing l3-interface-ipv4-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv4-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv4-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv4-address-list" delete: tags: - Network @@ -39987,21 +49904,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv4-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV4-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -40028,24 +49949,28 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/relationship" @@ -40070,21 +49995,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}: get: tags: @@ -40099,7 +50028,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l3-interface-ipv6-address-list" + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -40108,21 +50037,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -40173,7 +50106,10 @@ paths: tags: - Network summary: create or update an existing l3-interface-ipv6-address-list - description: create or update an existing l3-interface-ipv6-address-list + description: | + Create or update an existing l3-interface-ipv6-address-list. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList consumes: - application/json @@ -40190,27 +50126,88 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: body in: body - description: l3-interface-ipv6-address-list object that needs to be created or updated + description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json) required: true schema: $ref: "#/definitions/l3-interface-ipv6-address-list" + patch: + tags: + - Network + summary: update an existing l3-interface-ipv6-address-list + description: | + Update an existing l3-interface-ipv6-address-list + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: l3-interface-ipv6-address + in: path + description: IP address + required: true + type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ + - name: body + in: body + description: l3-interface-ipv6-address-list object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l3-interface-ipv6-address-list" delete: tags: - Network @@ -40232,21 +50229,25 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: l3-interface-ipv6-address in: path description: IP address required: true type: string + example: __L3-INTERFACE-IPV6-ADDRESS__ - name: resource-version in: query description: resource-version for concurrency @@ -40266,7 +50267,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -40275,16 +50276,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -40319,7 +50323,10 @@ paths: tags: - Network summary: create or update an existing l-interface - description: create or update an existing l-interface + description: | + Create or update an existing l-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface consumes: - application/json @@ -40336,22 +50343,76 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: l-interface object that needs to be created or updated + description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface.json) required: true schema: $ref: "#/definitions/l-interface" + patch: + tags: + - Network + summary: update an existing l-interface + description: | + Update an existing l-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: interface-name + in: path + description: Name given to the interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: l-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/l-interface" delete: tags: - Network @@ -40373,16 +50434,19 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: interface-name in: path description: Name given to the interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -40402,7 +50466,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/l-interfaces" + $ref: "#/getDefinitions/l-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -40411,11 +50475,13 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -40445,7 +50511,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-interface" + $ref: "#/getDefinitions/lag-interface" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -40454,11 +50520,13 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -40478,7 +50546,10 @@ paths: tags: - Network summary: create or update an existing lag-interface - description: create or update an existing lag-interface + description: | + Create or update an existing lag-interface. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterface consumes: - application/json @@ -40495,17 +50566,64 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: body in: body - description: lag-interface object that needs to be created or updated + description: lag-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterface.json) required: true schema: $ref: "#/definitions/lag-interface" + patch: + tags: + - Network + summary: update an existing lag-interface + description: | + Update an existing lag-interface + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterface + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: interface-name + in: path + description: Name that identifies the link aggregate interface + required: true + type: string + example: __INTERFACE-NAME__ + - name: body + in: body + description: lag-interface object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/lag-interface" delete: tags: - Network @@ -40527,11 +50645,13 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: interface-name in: path description: Name that identifies the link aggregate interface required: true type: string + example: __INTERFACE-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -40551,7 +50671,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/lag-interfaces" + $ref: "#/getDefinitions/lag-interfaces" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -40560,6 +50680,7 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -40579,7 +50700,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/pnf" + $ref: "#/getDefinitions/pnf" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -40588,6 +50709,7 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: inv-status in: query description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. @@ -40597,7 +50719,10 @@ paths: tags: - Network summary: create or update an existing pnf - description: create or update an existing pnf + description: | + Create or update an existing pnf. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPnfsPnf consumes: - application/json @@ -40614,12 +50739,52 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: body in: body - description: pnf object that needs to be created or updated + description: pnf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnf.json) required: true schema: $ref: "#/definitions/pnf" + patch: + tags: + - Network + summary: update an existing pnf + description: | + Update an existing pnf + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPnfsPnf + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: pnf-name + in: path + description: unique name of Physical Network Function. + required: true + type: string + example: __PNF-NAME__ + - name: body + in: body + description: pnf object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/pnf" delete: tags: - Network @@ -40641,6 +50806,7 @@ paths: description: unique name of Physical Network Function. required: true type: string + example: __PNF-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -40660,7 +50826,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/pnfs" + $ref: "#/getDefinitions/pnfs" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/physical-links/physical-link/{link-name}/relationship-list/relationship: @@ -40684,9 +50850,10 @@ paths: description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ required: true type: string + example: __LINK-NAME__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPhysicalLinksPhysicalLink.json) required: true schema: $ref: "#/definitions/relationship" @@ -40711,6 +50878,7 @@ paths: description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ required: true type: string + example: __LINK-NAME__ /network/physical-links/physical-link/{link-name}: get: tags: @@ -40725,7 +50893,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/physical-link" + $ref: "#/getDefinitions/physical-link" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -40734,6 +50902,7 @@ paths: description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ required: true type: string + example: __LINK-NAME__ - name: circuit-id in: query description: Circuit it @@ -40743,7 +50912,10 @@ paths: tags: - Network summary: create or update an existing physical-link - description: create or update an existing physical-link + description: | + Create or update an existing physical-link. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkPhysicalLinksPhysicalLink consumes: - application/json @@ -40760,12 +50932,52 @@ paths: description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ required: true type: string + example: __LINK-NAME__ - name: body in: body - description: physical-link object that needs to be created or updated + description: physical-link object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPhysicalLinksPhysicalLink.json) required: true schema: $ref: "#/definitions/physical-link" + patch: + tags: + - Network + summary: update an existing physical-link + description: | + Update an existing physical-link + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkPhysicalLinksPhysicalLink + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: link-name + in: path + description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ + required: true + type: string + example: __LINK-NAME__ + - name: body + in: body + description: physical-link object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/physical-link" delete: tags: - Network @@ -40787,6 +50999,7 @@ paths: description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ required: true type: string + example: __LINK-NAME__ - name: resource-version in: query description: resource-version for concurrency @@ -40806,7 +51019,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/physical-links" + $ref: "#/getDefinitions/physical-links" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/relationship-list/relationship: @@ -40830,9 +51043,10 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkIpsecConfigurationsIpsecConfiguration.json) required: true schema: $ref: "#/definitions/relationship" @@ -40857,6 +51071,7 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/vig-servers/vig-server/{vig-address-type}/relationship-list/relationship: put: tags: @@ -40878,14 +51093,16 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ - name: vig-address-type in: path description: indicates whether the VIG is for AVPN or INTERNET required: true type: string + example: __VIG-ADDRESS-TYPE__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer.json) required: true schema: $ref: "#/definitions/relationship" @@ -40910,11 +51127,13 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ - name: vig-address-type in: path description: indicates whether the VIG is for AVPN or INTERNET required: true type: string + example: __VIG-ADDRESS-TYPE__ /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/vig-servers/vig-server/{vig-address-type}: get: tags: @@ -40929,7 +51148,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vig-server" + $ref: "#/getDefinitions/vig-server" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -40938,16 +51157,21 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ - name: vig-address-type in: path description: indicates whether the VIG is for AVPN or INTERNET required: true type: string + example: __VIG-ADDRESS-TYPE__ put: tags: - Network summary: create or update an existing vig-server - description: create or update an existing vig-server + description: | + Create or update an existing vig-server. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer consumes: - application/json @@ -40964,17 +51188,64 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ - name: vig-address-type in: path description: indicates whether the VIG is for AVPN or INTERNET required: true type: string + example: __VIG-ADDRESS-TYPE__ - name: body in: body - description: vig-server object that needs to be created or updated + description: vig-server object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer.json) required: true schema: $ref: "#/definitions/vig-server" + patch: + tags: + - Network + summary: update an existing vig-server + description: | + Update an existing vig-server + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: ipsec-configuration-id + in: path + description: UUID of this configuration + required: true + type: string + example: __IPSEC-CONFIGURATION-ID__ + - name: vig-address-type + in: path + description: indicates whether the VIG is for AVPN or INTERNET + required: true + type: string + example: __VIG-ADDRESS-TYPE__ + - name: body + in: body + description: vig-server object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/vig-server" delete: tags: - Network @@ -40996,11 +51267,13 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ - name: vig-address-type in: path description: indicates whether the VIG is for AVPN or INTERNET required: true type: string + example: __VIG-ADDRESS-TYPE__ - name: resource-version in: query description: resource-version for concurrency @@ -41020,7 +51293,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/vig-servers" + $ref: "#/getDefinitions/vig-servers" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -41029,6 +51302,7 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}: get: tags: @@ -41043,7 +51317,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/ipsec-configuration" + $ref: "#/getDefinitions/ipsec-configuration" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -41052,11 +51326,15 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ put: tags: - Network summary: create or update an existing ipsec-configuration - description: create or update an existing ipsec-configuration + description: | + Create or update an existing ipsec-configuration. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfiguration consumes: - application/json @@ -41073,12 +51351,52 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ - name: body in: body - description: ipsec-configuration object that needs to be created or updated + description: ipsec-configuration object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkIpsecConfigurationsIpsecConfiguration.json) required: true schema: $ref: "#/definitions/ipsec-configuration" + patch: + tags: + - Network + summary: update an existing ipsec-configuration + description: | + Update an existing ipsec-configuration + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkIpsecConfigurationsIpsecConfiguration + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: ipsec-configuration-id + in: path + description: UUID of this configuration + required: true + type: string + example: __IPSEC-CONFIGURATION-ID__ + - name: body + in: body + description: ipsec-configuration object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/ipsec-configuration" delete: tags: - Network @@ -41100,6 +51418,7 @@ paths: description: UUID of this configuration required: true type: string + example: __IPSEC-CONFIGURATION-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -41119,7 +51438,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/ipsec-configurations" + $ref: "#/getDefinitions/ipsec-configurations" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/route-table-references/route-table-reference/{route-table-reference-id}/relationship-list/relationship: @@ -41143,9 +51462,10 @@ paths: description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __ROUTE-TABLE-REFERENCE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkRouteTableReferencesRouteTableReference.json) required: true schema: $ref: "#/definitions/relationship" @@ -41170,6 +51490,7 @@ paths: description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __ROUTE-TABLE-REFERENCE-ID__ /network/route-table-references/route-table-reference/{route-table-reference-id}: get: tags: @@ -41184,7 +51505,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/route-table-reference" + $ref: "#/getDefinitions/route-table-reference" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -41193,6 +51514,7 @@ paths: description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __ROUTE-TABLE-REFERENCE-ID__ - name: route-table-reference-fqdn in: query description: FQDN entry in the route table. @@ -41202,7 +51524,10 @@ paths: tags: - Network summary: create or update an existing route-table-reference - description: create or update an existing route-table-reference + description: | + Create or update an existing route-table-reference. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkRouteTableReferencesRouteTableReference consumes: - application/json @@ -41219,12 +51544,52 @@ paths: description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __ROUTE-TABLE-REFERENCE-ID__ - name: body in: body - description: route-table-reference object that needs to be created or updated + description: route-table-reference object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkRouteTableReferencesRouteTableReference.json) required: true schema: $ref: "#/definitions/route-table-reference" + patch: + tags: + - Network + summary: update an existing route-table-reference + description: | + Update an existing route-table-reference + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkRouteTableReferencesRouteTableReference + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: route-table-reference-id + in: path + description: Route Table Reference id, UUID assigned to this instance. + required: true + type: string + example: __ROUTE-TABLE-REFERENCE-ID__ + - name: body + in: body + description: route-table-reference object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/route-table-reference" delete: tags: - Network @@ -41246,6 +51611,7 @@ paths: description: Route Table Reference id, UUID assigned to this instance. required: true type: string + example: __ROUTE-TABLE-REFERENCE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -41265,7 +51631,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/route-table-references" + $ref: "#/getDefinitions/route-table-references" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/instance-groups/instance-group/{id}/relationship-list/relationship: @@ -41289,9 +51655,10 @@ paths: description: Instance Group ID, UUID assigned to this instance. required: true type: string + example: __ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkInstanceGroupsInstanceGroup.json) required: true schema: $ref: "#/definitions/relationship" @@ -41316,6 +51683,7 @@ paths: description: Instance Group ID, UUID assigned to this instance. required: true type: string + example: __ID__ /network/instance-groups/instance-group/{id}: get: tags: @@ -41330,7 +51698,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/instance-group" + $ref: "#/getDefinitions/instance-group" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -41339,6 +51707,7 @@ paths: description: Instance Group ID, UUID assigned to this instance. required: true type: string + example: __ID__ - name: description in: query description: Descriptive text to help identify the usage of this instance-group @@ -41358,7 +51727,10 @@ paths: tags: - Network summary: create or update an existing instance-group - description: create or update an existing instance-group + description: | + Create or update an existing instance-group. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkInstanceGroupsInstanceGroup consumes: - application/json @@ -41375,12 +51747,52 @@ paths: description: Instance Group ID, UUID assigned to this instance. required: true type: string + example: __ID__ - name: body in: body - description: instance-group object that needs to be created or updated + description: instance-group object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkInstanceGroupsInstanceGroup.json) required: true schema: $ref: "#/definitions/instance-group" + patch: + tags: + - Network + summary: update an existing instance-group + description: | + Update an existing instance-group + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkInstanceGroupsInstanceGroup + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: id + in: path + description: Instance Group ID, UUID assigned to this instance. + required: true + type: string + example: __ID__ + - name: body + in: body + description: instance-group object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/instance-group" delete: tags: - Network @@ -41402,6 +51814,7 @@ paths: description: Instance Group ID, UUID assigned to this instance. required: true type: string + example: __ID__ - name: resource-version in: query description: resource-version for concurrency @@ -41421,7 +51834,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/instance-groups" + $ref: "#/getDefinitions/instance-groups" "default": description: Response codes found in [response codes](https://wiki.onap.org/). /network/zones/zone/{zone-id}/relationship-list/relationship: @@ -41445,9 +51858,10 @@ paths: description: Code assigned by AIC to the zone required: true type: string + example: __ZONE-ID__ - name: body in: body - description: relationship object that needs to be created or updated + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkZonesZone.json) required: true schema: $ref: "#/definitions/relationship" @@ -41472,6 +51886,7 @@ paths: description: Code assigned by AIC to the zone required: true type: string + example: __ZONE-ID__ /network/zones/zone/{zone-id}: get: tags: @@ -41486,7 +51901,7 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/zone" + $ref: "#/getDefinitions/zone" "default": description: Response codes found in [response codes](https://wiki.onap.org/). parameters: @@ -41495,6 +51910,7 @@ paths: description: Code assigned by AIC to the zone required: true type: string + example: __ZONE-ID__ - name: design-type in: query description: Design of zone [Medium/Large?] @@ -41509,7 +51925,10 @@ paths: tags: - Network summary: create or update an existing zone - description: create or update an existing zone + description: | + Create or update an existing zone. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below operationId: createOrUpdateNetworkZonesZone consumes: - application/json @@ -41526,12 +51945,52 @@ paths: description: Code assigned by AIC to the zone required: true type: string + example: __ZONE-ID__ - name: body in: body - description: zone object that needs to be created or updated + description: zone object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkZonesZone.json) required: true schema: $ref: "#/definitions/zone" + patch: + tags: + - Network + summary: update an existing zone + description: | + Update an existing zone + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkZonesZone + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: zone-id + in: path + description: Code assigned by AIC to the zone + required: true + type: string + example: __ZONE-ID__ + - name: body + in: body + description: zone object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/zone" delete: tags: - Network @@ -41553,6 +52012,7 @@ paths: description: Code assigned by AIC to the zone required: true type: string + example: __ZONE-ID__ - name: resource-version in: query description: resource-version for concurrency @@ -41572,24 +52032,413 @@ paths: "200": description: successful operation schema: - $ref: "#/definitions/zones" + $ref: "#/getDefinitions/zones" + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + /network/configurations/configuration/{configuration-id}/relationship-list/relationship: + put: + tags: + - Network + summary: see node definition for valid relationships + operationId: createOrUpdateNetworkConfigurationsConfigurationRelationshipListRelationship + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: body + in: body + description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkConfigurationsConfiguration.json) + required: true + schema: + $ref: "#/definitions/relationship" + delete: + tags: + - Network + summary: delete an existing relationship + description: delete an existing relationship + operationId: deleteNetworkConfigurationsConfigurationRelationshipListRelationship + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + /network/configurations/configuration/{configuration-id}/metadata/metadatum/{metaname}: + get: + tags: + - Network + summary: returns metadatum + description: returns metadatum + operationId: getNetworkConfigurationsConfigurationMetadataMetadatum + produces: + - application/json + - application/xml + responses: + "200": + description: successful operation + schema: + $ref: "#/getDefinitions/metadatum" + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: metaname + in: path + required: true + type: string + example: __METANAME__ + - name: model-invariant-id + in: query + description: the ASDC model id for this resource or service model. + required: false + type: string + - name: model-version-id + in: query + description: the ASDC model version for this resource or service model. + required: false + type: string + put: + tags: + - Network + summary: create or update an existing metadatum + description: | + Create or update an existing metadatum. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below + operationId: createOrUpdateNetworkConfigurationsConfigurationMetadataMetadatum + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: metaname + in: path + required: true + type: string + example: __METANAME__ + - name: body + in: body + description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkConfigurationsConfigurationMetadataMetadatum.json) + required: true + schema: + $ref: "#/definitions/metadatum" + patch: + tags: + - Network + summary: update an existing metadatum + description: | + Update an existing metadatum + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkConfigurationsConfigurationMetadataMetadatum + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: metaname + in: path + required: true + type: string + example: __METANAME__ + - name: body + in: body + description: metadatum object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/metadatum" + delete: + tags: + - Network + summary: delete an existing metadatum + description: delete an existing metadatum + operationId: deleteNetworkConfigurationsConfigurationMetadataMetadatum + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: metaname + in: path + required: true + type: string + example: __METANAME__ + - name: resource-version + in: query + description: resource-version for concurrency + required: true + type: string + /network/configurations/configuration/{configuration-id}/metadata: + get: + tags: + - Network + summary: returns metadata + description: returns metadata + operationId: getNetworkConfigurationsConfigurationMetadata + produces: + - application/json + - application/xml + responses: + "200": + description: successful operation + schema: + $ref: "#/getDefinitions/metadata" + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: model-invariant-id + in: query + description: the ASDC model id for this resource or service model. + required: false + type: string + - name: model-version-id + in: query + description: the ASDC model version for this resource or service model. + required: false + type: string + /network/configurations/configuration/{configuration-id}: + get: + tags: + - Network + summary: returns configuration + description: returns configuration + operationId: getNetworkConfigurationsConfiguration + produces: + - application/json + - application/xml + responses: + "200": + description: successful operation + schema: + $ref: "#/getDefinitions/configuration" + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: model-invariant-id + in: query + description: the ASDC model id for this resource or service model. + required: false + type: string + - name: model-version-id + in: query + description: the ASDC model version for this resource or service model. + required: false + type: string + put: + tags: + - Network + summary: create or update an existing configuration + description: | + Create or update an existing configuration. + # + Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement. An example can be found in the [PATCH section] below + operationId: createOrUpdateNetworkConfigurationsConfiguration + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: body + in: body + description: configuration object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkConfigurationsConfiguration.json) + required: true + schema: + $ref: "#/definitions/configuration" + patch: + tags: + - Network + summary: update an existing configuration + description: | + Update an existing configuration + # + Note: Endpoints that are not devoted to object relationships support both PUT and PATCH operations. + The PUT operation will entirely replace an existing object. + The PATCH operation sends a "description of changes" for an existing object. The entire set of changes must be applied. An error result means no change occurs. + # + Other differences between PUT and PATCH are: + # + - For PATCH, you can send any of the values shown in sample REQUEST body. There are no required values. + - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent. + - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this. + operationId: UpdateNetworkConfigurationsConfiguration + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: body + in: body + description: configuration object that needs to be created or updated. + required: true + schema: + $ref: "#/patchDefinitions/configuration" + delete: + tags: + - Network + summary: delete an existing configuration + description: delete an existing configuration + operationId: deleteNetworkConfigurationsConfiguration + consumes: + - application/json + - application/xml + produces: + - application/json + - application/xml + responses: + "default": + description: Response codes found in [response codes](https://wiki.onap.org/). + parameters: + - name: configuration-id + in: path + description: UUID assigned to configuration. + required: true + type: string + example: __CONFIGURATION-ID__ + - name: resource-version + in: query + description: resource-version for concurrency + required: true + type: string + /network/configurations: + get: + tags: + - Network + summary: returns configurations + description: returns configurations + operationId: getNetworkConfigurations + produces: + - application/json + - application/xml + responses: + "200": + description: successful operation + schema: + $ref: "#/getDefinitions/configurations" "default": description: Response codes found in [response codes](https://wiki.onap.org/). definitions: - search: + aai-internal: properties: - edge-tag-query-result: - type: object - $ref: "#/definitions/edge-tag-query-result" - edge-tag-query-request: - type: object - $ref: "#/definitions/edge-tag-query-request" - search-results: - type: object - $ref: "#/definitions/search-results" - sdn-zone-response: - type: object - $ref: "#/definitions/sdn-zone-response" + property-name: + type: string + property-value: + type: string + action: + properties: + action-type: + type: string + action-data: + type: array + items: + $ref: "#/definitions/action-data" + action-data: + properties: + property-name: + type: string + property-value: + type: string actions: description: | APIs that are more action related than REST (e.g., notify, update). @@ -41600,101 +52449,348 @@ definitions: notify: type: object $ref: "#/definitions/notify" - relationship-data: + allotted-resource: + description: | + Represents a slice or partial piece of a resource that gets separately allotted + ###### Related Nodes + - TO allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE) + - TO generic-vnf( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY) + - TO instance-group( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO l3-network( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY) + - TO l-interface( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY) + - TO network-policy( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE) + - TO vlan( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY) + - TO vpn-binding( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY) + - TO service-instance( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - FROM tunnel-xconnect( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE) + - FROM configuration( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY) + - FROM allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE) + - ALLOTTED-RESOURCE is DELETED when these are DELETED TUNNEL-XCONNECT required: - - relationship-key - - relationship-value + - id properties: - relationship-key: + id: type: string - description: A keyword provided by A&AI to indicate an attribute. - relationship-value: + description: Allotted Resource id UUID assigned to this instance. + description: type: string - description: Value of the attribute. - related-to-property: - properties: - property-key: + description: The descriptive information assigned to this allotted resource instance + selflink: type: string - description: Key part of a key/value pair - property-value: + description: Link back to more information in the controller + model-invariant-id: type: string - description: Value part of a key/value pair - relationship: - properties: - related-to: + description: the ASDC model id for this resource or service model. + model-version-id: type: string - description: A keyword provided by A&AI to indicate type of node. - related-link: + description: the ASDC model version for this resource or service model. + persona-model-version: type: string - description: URL to the object in A&AI. - relationship-data: + description: the ASDC model version for this resource or service model. + resource-version: + type: string + description: Concurrency value + orchestration-status: + type: string + description: Orchestration status + operational-status: + type: string + description: Indicator for whether the resource is considered operational + type: + type: string + description: Generic description of the type of allotted resource. + role: + type: string + description: role in the network that this resource will be providing. + tunnel-xconnects: type: array - items: - $ref: "#/definitions/relationship-data" - related-to-property: + items: + $ref: "#/definitions/tunnel-xconnect" + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + allotted-resources: + description: | + This object is used to store slices of services being offered + properties: + allotted-resource: type: array items: - $ref: "#/definitions/related-to-property" - relationship-list: + $ref: "#/definitions/allotted-resource" + availability-zone: + description: | + Availability zone, a collection of compute hosts/pservers + ###### Related Nodes + - TO complex( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO service-capability( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + - TO cloud-region( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - FROM pserver( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE) + - FROM vce( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - AVAILABILITY-ZONE cannot be deleted if linked to CTAG-POOL,DVS-SWITCH,GENERIC-VNF,PSERVER,VCE + required: + - availability-zone-name + - hypervisor-type properties: - relationship: + availability-zone-name: + type: string + description: Name of the availability zone. Unique across a cloud region + hypervisor-type: + type: string + description: Type of hypervisor. Source of truth should define valid values. + operational-status: + type: string + description: State that indicates whether the availability zone should be used, etc. Source of truth should define valid values. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + availability-zones: + description: | + Collection of availability zones + properties: + availability-zone: type: array items: + $ref: "#/definitions/availability-zone" + az-and-dvs-switches: + properties: + dvs-switches: + type: object + $ref: "#/definitions/dvs-switches" + availability-zone: + type: object + $ref: "#/definitions/availability-zone" + business: + description: | + Namespace for business related constructs + properties: + connectors: + type: array + items: + $ref: "#/definitions/connector" + customers: + type: array + items: + $ref: "#/definitions/customer" + lines-of-business: + type: array + items: + $ref: "#/definitions/line-of-business" + owning-entities: + type: array + items: + $ref: "#/definitions/owning-entity" + platforms: + type: array + items: + $ref: "#/definitions/platform" + projects: + type: array + items: + $ref: "#/definitions/project" + class-of-service: + description: | + ###### Related Nodes + - TO site-pair( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE) + required: + - cos + properties: + cos: + type: string + description: unique identifier of probe + probe-id: + type: string + description: identifier of probe + probe-type: + type: string + description: type of probe + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: $ref: "#/definitions/relationship" - ctag-pool: + classes-of-service: description: | - A collection of C tags (vlan tags) grouped for a specific purpose. + class-of-service of probe + properties: + class-of-service: + type: array + items: + $ref: "#/definitions/class-of-service" + cloud-infrastructure: + description: | + Namespace for cloud infrastructure. + properties: + complexes: + type: array + items: + $ref: "#/definitions/complex" + cloud-regions: + type: array + items: + $ref: "#/definitions/cloud-region" + network-profiles: + type: array + items: + $ref: "#/definitions/network-profile" + pservers: + type: array + items: + $ref: "#/definitions/pserver" + virtual-data-centers: + type: array + items: + $ref: "#/definitions/virtual-data-center" + cloud-region: + description: | + cloud-region designates an installation of a cloud cluster or region or instantiation. ###### Related Nodes - - TO availability-zone (Many2Many) - - FROM complex (is composed of ctag-pool) - - FROM vpls-pe - - FROM generic-vnf + - TO esr-system-info (CHILD of cloud-region, cloud-region has esr-system-info, One2Many) + - TO complex( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO l3-network( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - TO zone( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM availability-zone( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM flavor( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM group-assignment( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM image( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM oam-network( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM snapshot( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM volume-group( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY) + - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE) + - CLOUD-REGION cannot be deleted if linked to DVS-SWITCH,FLAVOR,GROUP-ASSIGNMENT,IMAGE,OAM-NETWORK,SNAPSHOT,TENANT,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST,VOLUME-GROUP + - CLOUD-REGION is DELETED when these are DELETED AVAILABILITY-ZONE + - CLOUD-REGION deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO required: - - target-pe - - availability-zone-name - - ctag-pool-purpose + - cloud-owner + - cloud-region-id + - sriov-automation properties: - target-pe: + cloud-owner: type: string - description: The Target provider edge router - availability-zone-name: + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + cloud-region-id: type: string - description: Name of the availability zone - ctag-pool-purpose: + description: Identifier used by the vendor for the region. Second part of composite key + cloud-type: type: string - description: Describes what the intended purpose of this pool is. - ctag-values: + description: Type of the cloud (e.g., openstack) + owner-defined-type: type: string - description: Comma separated list of ctags + description: Cloud-owner defined type indicator (e.g., dcp, lcp) + cloud-region-version: + type: string + description: Software version employed at the site. NOTE - THIS FIELD IS NOT KEPT UP TO DATE. + identity-url: + type: string + description: URL of the keystone identity service + cloud-zone: + type: string + description: Zone where the cloud is homed. NOTE - THIS FIELD IS NOT CORRECTLY POPULATED. + complex-name: + type: string + description: complex name for cloud-region instance. NOTE - THIS FIELD IS NOT CORRECTLY POPULATED. + sriov-automation: + type: boolean + cloud-extra-info: + type: string + description: ESR inputs extra information about the VIM or Cloud which will be decoded by MultiVIM. + cloud-epa-caps: + type: string + description: MultiVIM will discover and expose EPA capabilities. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + volume-groups: + type: array + items: + $ref: "#/definitions/volume-group" + tenants: + type: array + items: + $ref: "#/definitions/tenant" + flavors: + type: array + items: + $ref: "#/definitions/flavor" + group-assignments: + type: array + items: + $ref: "#/definitions/group-assignment" + snapshots: + type: array + items: + $ref: "#/definitions/snapshot" + images: + type: array + items: + $ref: "#/definitions/image" + dvs-switches: + type: array + items: + $ref: "#/definitions/dvs-switch" + oam-networks: + type: array + items: + $ref: "#/definitions/oam-network" + availability-zones: + type: array + items: + $ref: "#/definitions/availability-zone" relationship-list: type: array items: $ref: "#/definitions/relationship" - ctag-pools: + esr-system-info-list: + type: array + items: + $ref: "#/definitions/esr-system-info" + vip-ipv4-address-list: + type: array + items: + $ref: "#/definitions/vip-ipv4-address-list" + vip-ipv6-address-list: + type: array + items: + $ref: "#/definitions/vip-ipv6-address-list" + cloud-regions: properties: - ctag-pool: + cloud-region: type: array items: - $ref: "#/definitions/ctag-pool" + $ref: "#/definitions/cloud-region" complex: description: | Collection of physical locations that can house cloud-regions. ###### Related Nodes - - TO ctag-pool (comprises complex, Many2Many) - - TO l3-network (Many2Many) - - FROM availability-zone - - FROM cloud-region - - FROM oam-network - - FROM pserver - - FROM pnf - - FROM vce - - FROM vpls-pe - - FROM volume-group - - FROM zone - - FROM generic-vnf + - TO l3-network( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM availability-zone( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY) + - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM vce( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - FROM volume-group( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM zone( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - COMPLEX cannot be deleted if linked to AVAILABILITY-ZONE,CLOUD-REGION,GENERIC-VNF,OAM-NETWORK,PNF,PSERVER,VCE,VOLUME-GROUP,VPLS-PE,ZONE + - COMPLEX is DELETED when these are DELETED CTAG-POOL required: - physical-location-id - physical-location-type @@ -41760,41 +52856,59 @@ definitions: type: array items: $ref: "#/definitions/complex" - volume-group: + configuration: description: | - Persistent block-level storage. + Port Mirror Configuration. ###### Related Nodes - - TO complex (Many2Many) - - TO tenant (Many2Many) - - FROM cloud-region (is composed of volume-group) - - FROM vf-module - - FROM generic-vnf + - TO allotted-resource( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE) + - TO logical-link( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - CONFIGURATION is DELETED when these are DELETED METADATUM + - CONFIGURATION deletion means associated objects of these types are also DELETED:ALLOTTED-RESOURCE,LOGICAL-LINK required: - - volume-group-id - - volume-group-name - - vnf-type + - configuration-id + - configuration-type + - configuration-sub-type + - orchestration-status + - operational-status + - configuration-selflink + - model-customization-id properties: - volume-group-id: + configuration-id: type: string - description: Unique ID of volume-group. - volume-group-name: + description: UUID assigned to configuration. + management-option: type: string - description: Name of the volume group. - heat-stack-id: + description: Indicates the entity that will manage this feature. Could be an organization or the name of the application as well. + configuration-name: type: string - description: Heat stack id corresponding to this volume-group - vnf-type: + description: Name of the configuration. + configuration-type: type: string - description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + description: port-mirroring-configuration. + configuration-sub-type: + type: string + description: vprobe, pprobe. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. orchestration-status: type: string - description: Orchestration status of this volume-group - model-customization-id: + description: Orchestration status of the configuration. + operational-status: type: string - description: captures the id of all the configuration used to customize the resource for the service. - vf-module-model-customization-id: + description: Indicator for whether the resource is considered operational. + configuration-selflink: type: string - description: helps relate the volume group to the vf-module whose components will require the volume group + description: URL to endpoint where AAI can get more details from SDN-GC. + model-customization-id: + type: string + description: id of the configuration used to customize the resource resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. @@ -41802,478 +52916,640 @@ definitions: type: array items: $ref: "#/definitions/relationship" - volume-groups: + metadata: + type: array + items: + $ref: "#/definitions/metadatum" + configurations: description: | - Collection of persistent block-level storage. + Collection of configurations properties: - volume-group: + configuration: type: array items: - $ref: "#/definitions/volume-group" - volume: + $ref: "#/definitions/configuration" + connector: description: | - Ephemeral Block storage volume. + Collection of resource instances used to connect a variety of disparate inventory widgets ###### Related Nodes - - FROM vserver (is composed of volume) + - TO virtual-data-center( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY) + - CONNECTOR is DELETED when these are DELETED METADATUM required: - - volume-id - - volume-selflink + - resource-instance-id properties: - volume-id: - type: string - description: Unique ID of block storage volume relative to the vserver. - volume-selflink: + resource-instance-id: type: string - description: URL to endpoint where AAI can get more details + description: Unique id of resource instance. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + widget-model-id: + type: string + description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. + widget-model-version: + type: string + description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. relationship-list: type: array items: $ref: "#/definitions/relationship" - volumes: + metadata: + type: array + items: + $ref: "#/definitions/metadatum" + connectors: description: | - Collection of ephemeral Block storage volumes. + Collection of resource instances used to connect a variety of disparate inventory widgets properties: - volume: + connector: type: array items: - $ref: "#/definitions/volume" - l3-interface-ipv4-address-list: + $ref: "#/definitions/connector" + constrained-element-set: description: | - IPv4 Address Range + This is how we would capture constraints defining allowed sets of elements. ###### Related Nodes - - TO instance-group (Many2Many) - - TO l3-network (Many2Many) - - TO subnet (Many2Many) - - TO vnfc (is composed of l3-interface-ipv4-address-list, Many2One) - - FROM l-interface (is composed of l3-interface-ipv4-address-list) - - FROM vlan (is composed of l3-interface-ipv4-address-list) + - TO model-constraint( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE) + - TO model-element( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM element-choice-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE) + - CONSTRAINED-ELEMENT-SET is DELETED when these are DELETED ELEMENT-CHOICE-SET required: - - l3-interface-ipv4-address + - constrained-element-set-uuid + - constraint-type + - check-type properties: - l3-interface-ipv4-address: + constrained-element-set-uuid: type: string - description: IP address - l3-interface-ipv4-prefix-length: - type: integer - format: int64 - description: Prefix length, 32 for single address - vlan-id-inner: - type: integer - format: int64 - description: Inner VLAN tag - vlan-id-outer: - type: integer - format: int64 - description: Outer VLAN tag - is-floating: - type: boolean - description: Indicator of fixed or floating address - resource-version: + constraint-type: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - neutron-network-id: + check-type: type: string - description: Neutron network id of the interface that address belongs to - neutron-subnet-id: + resource-version: type: string - description: Neutron id of subnet that address belongs to + element-choice-sets: + type: array + items: + $ref: "#/definitions/element-choice-set" relationship-list: type: array items: $ref: "#/definitions/relationship" - l3-interface-ipv6-address-list: + constrained-element-sets: + properties: + constrained-element-set: + type: array + items: + $ref: "#/definitions/constrained-element-set" + ctag-assignment: description: | - IPv6 Address Range ###### Related Nodes - - TO instance-group (Many2Many) - - TO l3-network (Many2Many) - - TO subnet (Many2Many) - - TO vnfc (is composed of l3-interface-ipv6-address-list, Many2One) - - FROM l-interface (is composed of l3-interface-ipv6-address-list) - - FROM vlan (is composed of l3-interface-ipv6-address-list) + - TO l3-network( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY) required: - - l3-interface-ipv6-address + - vlan-id-inner properties: - l3-interface-ipv6-address: - type: string - description: IP address - l3-interface-ipv6-prefix-length: - type: integer - format: int64 - description: Prefix length, 128 for single address vlan-id-inner: type: integer format: int64 - description: Inner VLAN tag - vlan-id-outer: - type: integer - format: int64 - description: Outer VLAN tag - is-floating: - type: boolean - description: Indicator of fixed or floating address + description: id. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - neutron-network-id: - type: string - description: Neutron network id of the interface that address belongs to - neutron-subnet-id: - type: string - description: Neutron id of subnet that address belongs to relationship-list: type: array items: $ref: "#/definitions/relationship" - vlan: + ctag-assignments: + properties: + ctag-assignment: + type: array + items: + $ref: "#/definitions/ctag-assignment" + ctag-pool: description: | - Definition of vlan + A collection of C tags (vlan tags) grouped for a specific purpose. ###### Related Nodes - - TO l3-interface-ipv4-address-list (comprises vlan, Many2Many) - - TO l3-interface-ipv6-address-list (comprises vlan, Many2Many) - - TO multicast-configuration (Many2Many) - - TO logical-link (Many2Many) - - FROM l-interface (is composed of vlan) - - FROM service-instance - - FROM allotted-resource + - TO complex( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE) + - TO availability-zone( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) required: - - vlan-interface - - in-maint - - is-ip-unnumbered + - target-pe + - availability-zone-name + - ctag-pool-purpose properties: - vlan-interface: + target-pe: type: string - description: String that identifies the interface - vlan-id-inner: - type: integer - format: int64 - description: Inner VLAN tag - vlan-id-outer: - type: integer - format: int64 - description: Outer VLAN tag - resource-version: + description: The Target provider edge router + availability-zone-name: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - speed-value: + description: Name of the availability zone + ctag-pool-purpose: type: string - description: Captures the numeric part of the speed - speed-units: + description: Describes what the intended purpose of this pool is. + ctag-values: type: string - description: Captures the units corresponding to the speed - vlan-description: + description: Comma separated list of ctags + resource-version: type: string - description: Used to describe (the service associated with) the vlan - backdoor-connection: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + ctag-pools: + properties: + ctag-pool: + type: array + items: + $ref: "#/definitions/ctag-pool" + customer: + description: | + customer identifiers to provide linkage back to BSS information. + ###### Related Nodes + - FROM service-subscription( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE) + - CUSTOMER is DELETED when these are DELETED SERVICE-SUBSCRIPTION + required: + - global-customer-id + - subscriber-name + - subscriber-type + properties: + global-customer-id: type: string - description: Whether customer is going to use this VLAN for backdoor connection to another customer premise device. - vpn-key: + description: Global customer id used across ECOMP to uniquely identify customer. + subscriber-name: type: string - description: This indicates the customers VPN ID associated with this vlan - orchestration-status: + description: Subscriber name, an alternate way to retrieve a customer. + subscriber-type: type: string - description: Status of a vnf's vlan interface, on which the customer circuit resides, mastered by SDN-C. - in-maint: - type: boolean - prov-status: + description: Subscriber type, a way to provide VID with only the INFRA customers. + resource-version: type: string - description: Prov Status of the VLAN configuration related to a logical interface. Valid values [PREPROV/NVTPROV/PROV]. - is-ip-unnumbered: - type: boolean + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + service-subscriptions: + type: array + items: + $ref: "#/definitions/service-subscription" relationship-list: type: array items: $ref: "#/definitions/relationship" - l3-interface-ipv4-address-list: + customers: + description: | + Collection of customer identifiers to provide linkage back to BSS information. + properties: + customer: type: array items: - $ref: "#/definitions/l3-interface-ipv4-address-list" - l3-interface-ipv6-address-list: + $ref: "#/definitions/customer" + cvlan-tag-entry: + required: + - cvlan-tag + properties: + cvlan-tag: + type: integer + format: int64 + description: See mis-na-virtualization-platform.yang + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: type: array - items: - $ref: "#/definitions/l3-interface-ipv6-address-list" - vlans: + items: + $ref: "#/definitions/relationship" + cvlan-tags: properties: - vlan: + cvlan-tag-entry: type: array items: - $ref: "#/definitions/vlan" - sriov-vf: + $ref: "#/definitions/cvlan-tag-entry" + dvs-switch: description: | - SR-IOV Virtual Function (not to be confused with virtual network function) + Digital virtual switch metadata, used by SDN-C to configure VCEs. A&AI needs to receive this data from the PO deployment team and administer it using the provisioningTool.sh into A&AI. ###### Related Nodes - - TO sriov-pf (Many2One) - - FROM l-interface (is composed of sriov-vf) + - TO cloud-region( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO availability-zone( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) required: - - pci-id + - switch-name + - vcenter-url properties: - pci-id: - type: string - description: PCI ID used to identify the sriov-vf - vf-vlan-filter: - type: string - description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM. - vf-mac-filter: - type: string - description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM. - vf-vlan-strip: - type: boolean - description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM. - vf-vlan-anti-spoof-check: - type: boolean - description: This option ensures anti VLAN spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs. - vf-mac-anti-spoof-check: - type: boolean - description: This option ensures anti MAC spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs. - vf-mirrors: + switch-name: type: string - description: This option defines the set of Mirror objects which essentially mirrors the traffic from source to set of collector VNF Ports. - vf-broadcast-allow: - type: boolean - description: This option, if set to true, sets the VF in promiscuous mode and allows all broadcast traffic to reach the VM - vf-unknown-multicast-allow: - type: boolean - description: This option, if set to true, sets the VF in promiscuous mode and allows unknown multicast traffic to reach the VM - vf-unknown-unicast-allow: - type: boolean - description: This option, if set to true, sets the VF in promiscuous mode and allows unknown unicast traffic to reach the VM - vf-insert-stag: - type: boolean - description: This option, if set to true, instructs to insert outer tag after traffic comes out of VM. - vf-link-status: + description: DVS switch name + vcenter-url: type: string - description: This option is used to set the link status. Valid values as of 1607 are on, off, and auto. + description: URL used to reach the vcenter resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - neutron-network-id: - type: string - description: Neutron network id of the interface relationship-list: type: array items: $ref: "#/definitions/relationship" - sriov-vfs: + dvs-switches: description: | - Collection of SR-IOV Virtual Functions. + Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs. properties: - sriov-vf: + dvs-switch: type: array items: - $ref: "#/definitions/sriov-vf" - l-interface: + $ref: "#/definitions/dvs-switch" + edge-prop-names: description: | - Logical interfaces, e.g., a vnic. - ###### Related Nodes - - TO instance-group (Many2Many) - - TO l3-interface-ipv4-address-list (comprises l-interface, Many2Many) - - TO l3-interface-ipv6-address-list (comprises l-interface, Many2Many) - - TO l-interface (comprises l-interface, One2Many) - - TO logical-link (Many2Many) - - TO vlan (comprises l-interface, Many2Many) - - TO sriov-vf (comprises l-interface, One2One) - - FROM generic-vnf (is composed of l-interface) - - FROM lag-interface (is composed of l-interface) - - FROM newvce (is composed of l-interface) - - FROM p-interface (is composed of l-interface) - - FROM vserver (is composed of l-interface) - - FROM allotted-resource - - FROM l-interface (is composed of l-interface) - required: - - interface-name - - is-port-mirrored - - in-maint - - is-ip-unnumbered + Internal map to define the properties of an edge and interpret the map EdgeRules properties: - interface-name: + edgeLabel: type: string - description: Name given to the interface - interface-role: + direction: type: string - description: E.g., CUSTOMER, UPLINK, etc. - v6-wan-link-ip: + multiplicityRule: type: string - description: Questionably placed - v6 ip addr of this interface (is in vr-lan-interface from Mary B. - selflink: + contains-other-v: type: string - description: URL to endpoint where AAI can get more details - interface-id: + delete-other-v: type: string - description: ID of interface - macaddr: + SVC-INFRA: type: string - description: MAC address for the interface - network-name: + prevent-delete: type: string - description: Name of the network - management-option: + edge-tag-query-request: + properties: + edge-tag: type: string - description: Whether A&AI should be managing this interface of not. Could have value like CUSTOMER - interface-description: + result-detail: type: string - description: Human friendly text regarding this interface. - is-port-mirrored: - type: boolean - resource-version: + start-node-type: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - in-maint: - type: boolean - prov-status: + start-node-filter: + type: array + items: + $ref: "#/definitions/start-node-filter" + include-node-filter: + type: array + items: + $ref: "#/definitions/include-node-filter" + secondary-filter: + type: array + items: + $ref: "#/definitions/secondary-filter" + edge-tag-query-result: + properties: + tagged-inventory-item-list: + type: array + items: + $ref: "#/definitions/tagged-inventory-item-list" + element-choice-set: + description: | + This is how we would capture constraints defining allowed sets of elements. + ###### Related Nodes + - TO constrained-element-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE) + - ELEMENT-CHOICE-SET is DELETED when these are DELETED MODEL-ELEMENT + required: + - element-choice-set-uuid + - element-choice-set-name + properties: + element-choice-set-uuid: type: string - description: Prov Status of the logical interface. Valid values [PREPROV/NVTPROV/PROV]. - is-ip-unnumbered: - type: boolean - allowed-address-pairs: + element-choice-set-name: type: string - description: Freeform field for storing an ip address, list of ip addresses or a subnet block. - vlans: + cardinality: + type: string + resource-version: + type: string + model-elements: type: array items: - $ref: "#/definitions/vlan" - sriov-vfs: + $ref: "#/definitions/model-element" + relationship-list: type: array items: - $ref: "#/definitions/sriov-vf" - l-interfaces: + $ref: "#/definitions/relationship" + element-choice-sets: + properties: + element-choice-set: type: array - items: - $ref: "#/definitions/l-interface" + items: + $ref: "#/definitions/element-choice-set" + entitlement: + description: | + Metadata for entitlement group. + ###### Related Nodes + - TO generic-vnf( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO vce( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + required: + - group-uuid + - resource-uuid + properties: + group-uuid: + type: string + description: Unique ID for the entitlement group the resource comes from, should be uuid. + resource-uuid: + type: string + description: Unique ID of an entitlement resource. + resource-version: + type: string + description: Concurrency value relationship-list: type: array items: $ref: "#/definitions/relationship" - l3-interface-ipv4-address-list: - type: array - items: - $ref: "#/definitions/l3-interface-ipv4-address-list" - l3-interface-ipv6-address-list: + entitlements: + description: | + Entitlements, keyed by group-uuid and resource-uuid, related to license management + properties: + entitlement: type: array items: - $ref: "#/definitions/l3-interface-ipv6-address-list" - l-interfaces: + $ref: "#/definitions/entitlement" + esr-ems: description: | - Collection of logical interfaces. + Persist EMS address information used by EMS driver. + ###### Related Nodes + - TO esr-system-info (CHILD of esr-ems, esr-ems has esr-system-info, One2Many) + - ESR-EMS deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO + required: + - ems-id properties: - l-interface: + ems-id: + type: string + description: Unique ID of EMS. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + esr-system-info-list: + type: object + $ref: "#/definitions/esr-system-info-list" + relationship-list: + type: object + $ref: "#/definitions/relationship-list" + esr-ems-list: + properties: + esr-ems: type: array items: - $ref: "#/definitions/l-interface" - vserver: + $ref: "#/definitions/esr-ems" + esr-system-info: description: | - Virtual Servers, aka virtual machine or VM. + Persist common address information of external systems. ###### Related Nodes - - TO flavor (Many2One) - - TO image (Many2One) - - TO l-interface (comprises vserver, Many2Many) - - TO pserver (Many2One) - - TO volume (comprises vserver, Many2Many) - - TO vnfc (Many2Many) - - TO snapshot (One2One) - - TO vf-module (Many2One) - - FROM generic-vnf - - FROM tenant (is composed of vserver) - - FROM vce + - FROM esr-ems (PARENT of esr-system-info, esr-ems has esr-system-info) + - FROM esr-vnfm (PARENT of esr-system-info, esr-vnfm has esr-system-info) + - FROM esr-thirdparty-sdnc (PARENT of esr-system-info, esr-thirdparty-sdnc has esr-system-info) + - FROM cloud-region (PARENT of esr-system-info, cloud-region has esr-system-info) required: - - vserver-id - - vserver-name - - vserver-selflink - - in-maint - - is-closed-loop-disabled + - esr-system-info-id + - user-name + - password + - system-type properties: - vserver-id: + esr-system-info-id: type: string - description: Unique identifier for this vserver relative to its tenant - vserver-name: + description: Unique ID of esr system info. + system-name: type: string - description: Name of vserver - vserver-name2: + description: name of external system. + type: type: string - description: Alternative name of vserver - prov-status: + description: type of external systems. + vendor: type: string - description: Trigger for operational monitoring of this resource by Service Assurance systems. - vserver-selflink: + description: vendor of external systems. + version: type: string - description: URL to endpoint where AAI can get more details - in-maint: + description: version of external systems. + service-url: + type: string + description: url used to access external systems. + user-name: + type: string + description: username used to access external systems. + password: + type: string + description: password used to access external systems. + system-type: + type: string + description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm. + protocol: + type: string + description: protocol of third party SDNC, for example netconf/snmp. + ssl-cacert: + type: string + description: ca file content if enabled ssl on auth-url. + ssl-insecure: type: boolean - is-closed-loop-disabled: + description: Whether to verify VIM's certificate. + ip-address: + type: string + description: service IP of ftp server. + port: + type: string + description: service port of ftp server. + cloud-domain: + type: string + description: domain info for authentication. + default-tenant: + type: string + description: default tenant of VIM. + passive: type: boolean + description: ftp passive mode or not. + remote-path: + type: string + description: resource or performance data file path. + system-status: + type: string + description: the status of external system. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - volumes: - type: array - items: - $ref: "#/definitions/volume" relationship-list: type: array items: $ref: "#/definitions/relationship" - l-interfaces: + esr-system-info-list: + description: | + Collection of persistent block-level external system auth info. + properties: + esr-system-info: type: array - items: - $ref: "#/definitions/l-interface" - vservers: + items: + $ref: "#/definitions/esr-system-info" + esr-thirdparty-sdnc: description: | - Collection of virtual Servers, aka virtual machines or VMs. + Persist SDNC address information used by ONAP SDNC. + ###### Related Nodes + - TO esr-system-info (CHILD of esr-thirdparty-sdnc, esr-thirdparty-sdnc has esr-system-info, One2One) + - TO pnf( esr-thirdparty-sdnc has pnf, One2Many) + - ESR-THIRDPARTY-SDNC deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO + required: + - thirdparty-sdnc-id properties: - vserver: + thirdparty-sdnc-id: + type: string + description: Unique ID of SDNC. + location: + type: string + description: used for DC type to indicate the location of SDNC, such as Core or Edge. + product-name: + type: string + description: password used to access SDNC server. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + esr-system-info-list: + type: object + $ref: "#/definitions/esr-system-info-list" + relationship-list: + type: object + $ref: "#/definitions/relationship-list" + esr-thirdparty-sdnc-list: + properties: + esr-thirdparty-sdnc: type: array items: - $ref: "#/definitions/vserver" - tenant: + $ref: "#/definitions/esr-thirdparty-sdnc" + esr-vnfm: description: | - Openstack tenant + Persist VNFM address information used by VF-C. ###### Related Nodes - - TO l3-network (Many2Many) - - TO service-subscription (Many2Many) - - TO vserver (comprises tenant, One2Many) - - FROM cloud-region (is composed of tenant) - - FROM group-assignment - - FROM volume-group + - TO esr-system-info (CHILD of esr-vnfm, esr-vnfm has esr-system-info, One2One) + - ESR-VNFM deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO required: - - tenant-id - - tenant-name + - vnfm-id properties: - tenant-id: + vnfm-id: type: string - description: Unique id relative to the cloud-region. - tenant-name: + description: Unique ID of VNFM. + vim-id: type: string - description: Readable name of tenant - tenant-context: + description: indecate the VIM to deploy VNF. + certificate-url: type: string - description: This field will store the tenant context. + description: certificate url of VNFM. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - vservers: + esr-system-info-list: + type: object + $ref: "#/definitions/esr-system-info-list" + relationship-list: + type: object + $ref: "#/definitions/relationship-list" + esr-vnfm-list: + properties: + esr-vnfm: type: array - items: - $ref: "#/definitions/vserver" + items: + $ref: "#/definitions/esr-vnfm" + evc: + description: | + evc object is an optional child object of the Configuration object. + ###### Related Nodes + - TO configuration( evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE) + required: + - evc-id + properties: + evc-id: + type: string + description: Unique/key field for the evc object + forwarding-path-topology: + type: string + description: Point-to-Point, Multi-Point + cir-value: + type: string + description: Commited Information Rate + cir-units: + type: string + description: CIR units + connection-diversity-group-id: + type: string + description: Diversity Group ID + service-hours: + type: string + description: formerly Performance Group + esp-evc-circuit-id: + type: string + description: EVC Circuit ID of ESP EVC + esp-evc-cir-value: + type: string + description: Committed Information Rate (For ESP) + esp-evc-cir-units: + type: string + description: CIR units (For ESP) + esp-itu-code: + type: string + description: Identifies ESP + collector-pop-clli: + type: string + description: Collector POP CLLI (from the hostname of the access pnf) + inter-connect-type-ingress: + type: string + description: Interconnect type on ingress side of EVC. + tagmode-access-ingress: + type: string + description: tagode for collector side of EVC + tagmode-access-egress: + type: string + description: tagMode for network side of EVC relationship-list: type: array items: $ref: "#/definitions/relationship" - tenants: + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + evcs: + properties: + evc: + type: array + items: + $ref: "#/definitions/evc" + external-system: description: | - Collection of openstack tenants. + Namespace for external system. properties: - tenant: + esr-ems-list: + type: object + $ref: "#/definitions/esr-ems-list" + esr-vnfm-list: + type: object + $ref: "#/definitions/esr-vnfm-list" + esr-thirdparty-sdnc-list: + type: object + $ref: "#/definitions/esr-thirdparty-sdnc-list" + extra-properties: + description: | + Extra properties for inventory item for response list + properties: + extra-property: type: array items: - $ref: "#/definitions/tenant" + $ref: "#/definitions/extra-property" + extra-property: + properties: + property-name: + type: string + property-value: + type: string flavor: description: | Openstack flavor. ###### Related Nodes - - FROM cloud-region (is composed of flavor) - - FROM vserver + - TO cloud-region( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vserver( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE) + - FLAVOR cannot be deleted if linked to VSERVER required: - flavor-id - flavor-name @@ -42328,134 +53604,448 @@ definitions: type: array items: $ref: "#/definitions/flavor" - group-assignment: + forwarder: description: | - Openstack group-assignment used to store exclusivity groups (EG). + Entity describing a sequenced segment of forwarding path ###### Related Nodes - - TO tenant (Many2Many) - - TO pserver (One2Many) - - FROM cloud-region (is composed of group-assignment) + - TO forwarding-path( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE) + - TO l-interface( forwarder org.onap.relationships.inventory.ForwardsTo l-interface, MANY2ONE) + - TO configuration( forwarder org.onap.relationships.inventory.Uses configuration, ONE2ONE) + - TO lag-interface( forwarder org.onap.relationships.inventory.ForwardsTo lag-interface, MANY2ONE) + - TO p-interface( forwarder org.onap.relationships.inventory.ForwardsTo p-interface, MANY2ONE) + - FORWARDER deletion means associated objects of these types are also DELETED:CONFIGURATION required: - - group-id - - group-type - - group-name + - sequence properties: - group-id: + sequence: + type: integer + format: int32 + description: Unique ID of this segmentation + forwarder-role: type: string - description: Group id, expected to be unique across cloud-region. - group-type: + description: ingress, intermediate, egress + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + resource-version: type: string - description: Group type - the type of group this instance refers to - group-name: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + forwarder-evc: + description: | + forwarder object is an optional child object of the Configuration object. + ###### Related Nodes + - TO configuration( forwarder-evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE) + required: + - forwarder-evc-id + properties: + forwarder-evc-id: type: string - description: Group name - name assigned to the group - group-description: + description: Key for forwarder-evc object + circuit-id: type: string - description: Group description - description of the group - resource-version: + description: Circuit ID from customer/ESP/ingress end of EVC, or reference to beater circuit on gateway/network/egress end of EVC + ivlan: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + description: Internal VLAN. + svlan: + type: string + description: SVLAN value for ingress of egress forwarder. + cvlan: + type: string + description: CVLAN value for ingress of egress forwarder. relationship-list: type: array items: $ref: "#/definitions/relationship" - group-assignments: + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + forwarder-evcs: + properties: + forwarder-evc: + type: array + items: + $ref: "#/definitions/forwarder-evc" + forwarders: + properties: + forwarder: + type: array + items: + $ref: "#/definitions/forwarder" + forwarding-path: description: | - Collection of openstack group assignments + Entity that describes the sequenced forwarding path between interfaces of services or resources + ###### Related Nodes + - TO service-instance( forwarding-path org.onap.relationships.inventory.AppliesTo service-instance, MANY2ONE) + - TO configuration( forwarding-path org.onap.relationships.inventory.Uses configuration, ONE2ONE) + - FROM forwarder( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE) + - FORWARDING-PATH is DELETED when these are DELETED FORWARDER + - FORWARDING-PATH deletion means associated objects of these types are also DELETED:CONFIGURATION + required: + - forwarding-path-id + - forwarding-path-name properties: - group-assignment: + forwarding-path-id: + type: string + description: Unique ID of this FP + forwarding-path-name: + type: string + description: Name of the FP + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + selflink: + type: string + description: the self link for this FP + forwarders: + type: array + items: + $ref: "#/definitions/forwarder" + forwarding-paths: + properties: + forwarding-path: type: array items: - $ref: "#/definitions/group-assignment" - snapshot: + $ref: "#/definitions/forwarding-path" + generic-vnf: description: | - Openstack snapshot + General purpose VNF ###### Related Nodes - - FROM cloud-region (is composed of snapshot) - - FROM vserver + - TO availability-zone( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - TO complex( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - TO configuration( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - TO ctag-pool( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + - TO instance-group( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO ipsec-configuration( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE) + - TO l3-network( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - TO license-key-resource( generic-vnf org.onap.relationships.inventory.Uses license-key-resource, MANY2MANY) + - TO pnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY) + - TO pserver( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY) + - TO vnf-image( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE) + - TO volume-group( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + - TO vserver( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY) + - TO virtual-data-center( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY) + - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM vnfc( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM lag-interface( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM license( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM network-profile( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY) + - FROM site-pair-set( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM line-of-business( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY) + - FROM platform( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + - GENERIC-VNF is DELETED when these are DELETED ENTITLEMENT,VNFC,LAG-INTERFACE,LICENSE,L-INTERFACE,VF-MODULE + - GENERIC-VNF deletion means associated objects of these types are also DELETED:CONFIGURATION required: - - snapshot-id + - vnf-id + - vnf-instance-id + - vnf-name + - vnf-type + - vnf-package-name + - vnf-discriptor-name + - job-id + - in-maint + - is-closed-loop-disabled properties: - snapshot-id: + vnf-id: type: string - description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. - snapshot-name: + description: Unique id of VNF. This is unique across the graph. + vnf-instance-id: type: string - description: Snapshot name - snapshot-architecture: + description: vnf instance id. + vnf-name: type: string - description: Operating system architecture - snapshot-os-distro: + description: Name of VNF. + vnf-name2: type: string - description: The common name of the operating system distribution in lowercase - snapshot-os-version: + description: Alternate name of VNF. + vnf-type: type: string - description: The operating system version as specified by the distributor. - application: + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + service-id: type: string - description: The application that the image instantiates. - application-vendor: + description: Unique identifier of service, does not necessarily map to ASDC service models. SOON TO BE DEPRECATED + regional-resource-zone: type: string - description: The vendor of the application. - application-version: + description: Regional way of organizing pservers, source of truth should define values + prov-status: type: string - description: The version of the application. - snapshot-selflink: + description: Trigger for operational monitoring of this resource by Service Assurance systems. + operational-status: type: string - description: URL to endpoint where AAI can get more details - prev-snapshot-id: + description: Indicator for whether the resource is considered operational. Valid values are in-service-path and out-of-service-path. + license-key: type: string - description: This field contains the UUID of the previous snapshot (if any). + description: OBSOLETE - do not use + equipment-role: + type: string + description: Client should send valid enumerated value + orchestration-status: + type: string + description: Orchestration status of this VNF, used by MSO. + vnf-package-name: + type: string + vnf-discriptor-name: + type: string + description: vnf discriptor name + job-id: + type: string + description: job id corresponding to vnf + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance, managed by MSO + mso-catalog-key: + type: string + description: Corresponds to the SDN-C catalog id used to configure this VCE + management-option: + type: string + description: identifier of managed by ATT or customer + ipv4-oam-address: + type: string + description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by generic-vnf. + ipv4-loopback0-address: + type: string + description: v4 Loopback0 address + nm-lan-v6-address: + type: string + description: v6 Loopback address + management-v6-address: + type: string + description: v6 management address + vcpu: + type: integer + format: int64 + description: number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE + vcpu-units: + type: string + description: units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE + vmemory: + type: integer + format: int64 + description: number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE + vmemory-units: + type: string + description: units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE + vdisk: + type: integer + format: int64 + description: number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE + vdisk-units: + type: string + description: units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE + nshd: + type: integer + format: int64 + description: number of associated SHD in vnf. + nvm: + type: integer + format: int64 + description: number of vms in vnf. + nnet: + type: integer + format: int64 + description: number of network in vnf. + in-maint: + type: boolean + is-closed-loop-disabled: + type: boolean resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + summary-status: + type: string + description: details regarding the generic-vnf operation, PLEASE DISCONTINUE USE OF THIS FIELD. + encrypted-access-flag: + type: boolean + description: indicates whether generic-vnf access uses SSH + entitlement-assignment-group-uuid: + type: string + description: UUID of the Entitlement group used for licensing VNFs, OBSOLETE - See child relationships. + entitlement-resource-uuid: + type: string + description: UUID of the specific entitlement resource. OBSOLETE - See child relationships. + license-assignment-group-uuid: + type: string + description: UUID of the license assignment group. OBSOLETE - See child relationships. + license-key-uuid: + type: string + description: UUID of the actual license resource. OBSOLETE - See child relationships. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + model-customization-id: + type: string + description: captures the id of all the configuration used to customize the resource for the service. + widget-model-id: + type: string + description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. + widget-model-version: + type: string + description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. + as-number: + type: string + description: as-number of the VNF + regional-resource-subzone: + type: string + description: represents sub zone of the rr plane + nf-type: + type: string + description: Generic description of the type of NF + nf-function: + type: string + description: English description of Network function that the specific VNF deployment is providing + nf-role: + type: string + description: role in the network that this model will be providing + nf-naming-code: + type: string + description: string assigned to this model used for naming purposes + selflink: + type: string + description: Path to the controller object. + ipv4-oam-gateway-address: + type: string + description: Gateway address + ipv4-oam-gateway-address-prefix-length: + type: integer + format: int32 + description: Prefix length for oam-address + vlan-id-outer: + type: integer + format: int64 + description: Temporary location for S-TAG to get to VCE + nm-profile-name: + type: string + description: Network Management profile of this VNF relationship-list: type: array items: $ref: "#/definitions/relationship" - snapshots: + l-interfaces: + type: array + items: + $ref: "#/definitions/l-interface" + lag-interfaces: + type: array + items: + $ref: "#/definitions/lag-interface" + vf-modules: + type: array + items: + $ref: "#/definitions/vf-module" + licenses: + type: array + items: + $ref: "#/definitions/license" + entitlements: + type: array + items: + $ref: "#/definitions/entitlement" + generic-vnfs: description: | - Collection of openstack snapshots + Collection of VNFs properties: - snapshot: + generic-vnf: type: array items: - $ref: "#/definitions/snapshot" - metadatum: + $ref: "#/definitions/generic-vnf" + group-assignment: description: | - Key/value pairs + Openstack group-assignment used to store exclusivity groups (EG). ###### Related Nodes - - FROM configuration (is composed of metadatum) - - FROM image (is composed of metadatum) - - FROM model-ver (is composed of metadatum) - - FROM service-instance (is composed of metadatum) - - FROM connector (is composed of metadatum) + - TO cloud-region( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM pserver( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY) required: - - metaname - - metaval + - group-id + - group-type + - group-name properties: - metaname: + group-id: type: string - metaval: + description: Group id, expected to be unique across cloud-region. + group-type: + type: string + description: Group type - the type of group this instance refers to + group-name: type: string + description: Group name - name assigned to the group + group-description: + type: string + description: Group description - description of the group resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - metadata: + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + group-assignments: description: | - Collection of metadatum (key/value pairs) + Collection of openstack group assignments properties: - metadatum: + group-assignment: type: array items: - $ref: "#/definitions/metadatum" + $ref: "#/definitions/group-assignment" + host-route: + description: | + ###### Related Nodes + - TO subnet( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE) + required: + - host-route-id + - route-prefix + - next-hop + properties: + host-route-id: + type: string + description: host-route id + route-prefix: + type: string + description: subnet prefix + next-hop: + type: string + description: Could be ip-address, hostname, or service-instance + next-hop-type: + type: string + description: Should be ip-address, hostname, or service-instance to match next-hop + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + host-routes: + properties: + host-route: + type: array + items: + $ref: "#/definitions/host-route" image: description: | Openstack image. ###### Related Nodes - - TO metadatum (comprises image, Many2Many) - - FROM cloud-region (is composed of image) - - FROM vserver + - TO cloud-region( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE) + - FROM vserver( vserver org.onap.relationships.inventory.Uses image, MANY2ONE) + - IMAGE cannot be deleted if linked to VSERVER + - IMAGE is DELETED when these are DELETED METADATUM required: - image-id - image-name @@ -42509,106 +54099,224 @@ definitions: type: array items: $ref: "#/definitions/image" - dvs-switch: + include-node-filter: + properties: + include-node-type: + type: string + instance-filter: description: | - Digital virtual switch metadata, used by SDN-C to configure VCEs. A&AI needs to receive this data from the PO deployment team and administer it using the provisioningTool.sh into A&AI. + InstanceFilter for performing a named-query or model query + instance-filters: + description: | + InstanceFilters for performing a named-query or model query + properties: + instance-filter: + type: array + items: + $ref: "#/definitions/instance-filter" + instance-group: + description: | + General mechanism for grouping instances ###### Related Nodes - - TO availability-zone (Many2Many) - - FROM cloud-region (is composed of dvs-switch) + - TO model( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - FROM l3-network( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM l-interface( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM pnf( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM vnfc( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) required: - - switch-name - - vcenter-url + - instance-group-role + - model-invariant-id + - model-version-id + - id + - description + - type properties: - switch-name: + instance-group-role: type: string - description: DVS switch name - vcenter-url: + description: role of the instance group. + model-invariant-id: type: string - description: URL used to reach the vcenter + description: ASDC model id for this resource or service model. + model-version-id: + type: string + description: ASDC model version uid for this resource model. + id: + type: string + description: Instance Group ID, UUID assigned to this instance. + description: + type: string + description: Descriptive text to help identify the usage of this instance-group + type: + type: string + description: Only valid value today is lower case ha for high availability + sub-type: + type: string + description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby] resource-version: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + description: Concurrency value relationship-list: type: array items: $ref: "#/definitions/relationship" - dvs-switches: + instance-groups: description: | - Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs. + Collection of openstack route table references properties: - dvs-switch: + instance-group: type: array items: - $ref: "#/definitions/dvs-switch" - oam-network: - description: | - OAM network, to be deprecated shortly. Do not use for new purposes. - ###### Related Nodes - - TO complex (Many2Many) - - TO service-capability (Many2Many) - - FROM cloud-region (is composed of oam-network) - required: - - network-uuid - - network-name - - cvlan-tag + $ref: "#/definitions/instance-group" + inventory: properties: - network-uuid: + search: + type: object + $ref: "#/definitions/search" + actions: + type: object + $ref: "#/definitions/actions" + cloud-infrastructure: + type: object + $ref: "#/definitions/cloud-infrastructure" + external-system: + type: object + $ref: "#/definitions/external-system" + business: + type: object + $ref: "#/definitions/business" + service-design-and-creation: + type: object + $ref: "#/definitions/service-design-and-creation" + network: + type: object + $ref: "#/definitions/network" + aai-internal: + type: object + $ref: "#/definitions/aai-internal" + nodes: + type: array + items: + $ref: "#/definitions/aai-internal" + inventory-item: + properties: + inventory-item-type: type: string - description: UUID of the network. Unique across a cloud-region - network-name: + inventory-item-link: type: string - description: Name of the network. - cvlan-tag: - type: integer - format: int64 - description: cvlan-id - ipv4-oam-gateway-address: + inventory-item-data: + type: array + items: + $ref: "#/definitions/inventory-item-data" + tagged-inventory-item-list: + type: array + items: + $ref: "#/definitions/tagged-inventory-item-list" + inventory-item-data: + properties: + property-name: type: string - description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network - ipv4-oam-gateway-address-prefix-length: - type: integer - format: int32 - description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network - resource-version: + property-value: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - relationship-list: - type: array - items: - $ref: "#/definitions/relationship" - oam-networks: + inventory-response-item: description: | - Collection of OAM networks, to be deprecated shortly. Do not use for new purposes. + Inventory item for response list properties: - oam-network: + model-name: + type: string + extra-properties: + type: object + $ref: "#/definitions/extra-properties" + inventory-response-items: + type: object + $ref: "#/definitions/inventory-response-items" + inventory-response-items: + description: | + Container for inventory items in response list + properties: + inventory-response-item: type: array items: - $ref: "#/definitions/oam-network" - availability-zone: + $ref: "#/definitions/inventory-response-item" + ipsec-configuration: description: | - Availability zone, a collection of compute hosts/pservers + IPSec configuration node will contain various configuration data for the NMTE VNF. This node will have an edge to the generic-vnf (vnf type = TE). Starting 1607, this data will be populated by SDN-C ###### Related Nodes - - TO complex (Many2Many) - - TO service-capability (Many2Many) - - FROM cloud-region (is composed of availability-zone) - - FROM ctag-pool - - FROM dvs-switch - - FROM generic-vnf - - FROM pserver - - FROM vce + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE) + - FROM vig-server( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE) + - IPSEC-CONFIGURATION is DELETED when these are DELETED VIG-SERVER required: - - availability-zone-name - - hypervisor-type + - ipsec-configuration-id properties: - availability-zone-name: + ipsec-configuration-id: type: string - description: Name of the availability zone. Unique across a cloud region - hypervisor-type: + description: UUID of this configuration + requested-vig-address-type: type: string - description: Type of hypervisor. Source of truth should define valid values. - operational-status: + description: Indicate the type of VIG server like AVPN, INTERNET, BOTH + requested-encryption-strength: type: string - description: State that indicates whether the availability zone should be used, etc. Source of truth should define valid values. + description: Encryption values like 3des-cbc, des-cbc, aes-128-cbc, aes-192-cbc, aes-265-cbc + requested-dmz-type: + type: string + description: ATT can offer a shared DMZ or a DMZ specific to a customer + shared-dmz-network-address: + type: string + description: Network address of shared DMZ + requested-customer-name: + type: string + description: If the DMZ is a custom DMZ, this field will indicate the customer information + ike-version: + type: string + description: can be 1 or 2 + ikev1-authentication: + type: string + description: Contains values like md5, sha1, sha256, sha384 + ikev1-encryption: + type: string + description: Encyption values like 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc + ikev1-dh-group: + type: string + description: Diffie-Hellman group like DH-GROUP2, DH-GROUP5, DH-GROUP14 + ikev1-am-group-id: + type: string + description: Group name defined in VIG for clients using aggressive mode + ikev1-am-password: + type: string + description: pre-shared key for the above group name + ikev1-sa-lifetime: + type: string + description: Lifetime for IKEv1 SA + ipsec-authentication: + type: string + description: md5, sha1, sha256, sha384 + ipsec-encryption: + type: string + description: 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc + ipsec-sa-lifetime: + type: string + description: Life time for IPSec SA + ipsec-pfs: + type: string + description: enable PFS or not + xauth-userid: + type: string + description: user ID for xAuth, sm-user,ucpeHostName,nmteHostName + xauth-user-password: + type: string + description: Encrypted using the Juniper $9$ algorithm + dpd-interval: + type: string + description: The time between DPD probe + dpd-frequency: + type: string + description: Maximum number of DPD before claiming the tunnel is down resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. @@ -42616,115 +54324,139 @@ definitions: type: array items: $ref: "#/definitions/relationship" - availability-zones: - description: | - Collection of availability zones + vig-servers: + type: array + items: + $ref: "#/definitions/vig-server" + ipsec-configurations: properties: - availability-zone: + ipsec-configuration: type: array items: - $ref: "#/definitions/availability-zone" - esr-system-info: + $ref: "#/definitions/ipsec-configuration" + key-data: + properties: + key-name: + type: string + key-value: + type: string + l-interface: description: | - Persist common address information of external systems. + Logical interfaces, e.g., a vnic. ###### Related Nodes - - FROM esr-ems (is composed of esr-system-info) - - FROM esr-vnfm (is composed of esr-system-info) - - FROM esr-thirdparty-sdnc (is composed of esr-system-info) - - FROM cloud-region (is composed of esr-system-info) + - TO generic-vnf( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO lag-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE) + - TO instance-group( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - TO logical-link( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY) + - TO newvce( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE) + - TO p-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE) + - TO vserver( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE) + - FROM vlan( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - L-INTERFACE is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,SRIOV-VF,VLAN + - L-INTERFACE deletion means associated objects of these types are also DELETED:LOGICAL-LINK required: - - esr-system-info-id - - user-name - - password - - system-type + - interface-name + - is-port-mirrored + - in-maint + - is-ip-unnumbered properties: - esr-system-info-id: - type: string - description: Unique ID of esr system info. - system-name: - type: string - description: name of external system. - type: + interface-name: type: string - description: type of external systems. - vendor: + description: Name given to the interface + interface-role: type: string - description: vendor of external systems. - version: + description: E.g., CUSTOMER, UPLINK, etc. + v6-wan-link-ip: type: string - description: version of external systems. - service-url: + description: Questionably placed - v6 ip addr of this interface (is in vr-lan-interface from Mary B. + selflink: type: string - description: url used to access external systems. - user-name: + description: URL to endpoint where AAI can get more details + interface-id: type: string - description: username used to access external systems. - password: + description: ID of interface + macaddr: type: string - description: password used to access external systems. - system-type: + description: MAC address for the interface + network-name: type: string - description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm. - protocol: + description: Name of the network + management-option: type: string - description: protocol of third party SDNC, for example netconf/snmp. - ssl-cacert: + description: Whether A&AI should be managing this interface of not. Could have value like CUSTOMER + interface-description: type: string - description: ca file content if enabled ssl on auth-url. - ssl-insecure: + description: Human friendly text regarding this interface. + is-port-mirrored: type: boolean - description: Whether to verify VIM's certificate. - ip-address: - type: string - description: service IP of ftp server. - port: - type: string - description: service port of ftp server. - cloud-domain: - type: string - description: domain info for authentication. - default-tenant: + resource-version: type: string - description: default tenant of VIM. - passive: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + in-maint: type: boolean - description: ftp passive mode or not. - remote-path: - type: string - description: resource or performance data file path. - system-status: + prov-status: type: string - description: the status of external system. - resource-version: + description: Prov Status of the logical interface. Valid values [PREPROV/NVTPROV/PROV]. + is-ip-unnumbered: + type: boolean + allowed-address-pairs: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + description: Freeform field for storing an ip address, list of ip addresses or a subnet block. + vlans: + type: array + items: + $ref: "#/definitions/vlan" + sriov-vfs: + type: array + items: + $ref: "#/definitions/sriov-vf" + l-interfaces: + type: array + items: + $ref: "#/definitions/l-interface" relationship-list: type: array items: $ref: "#/definitions/relationship" - esr-system-info-list: + l3-interface-ipv4-address-list: + type: array + items: + $ref: "#/definitions/l3-interface-ipv4-address-list" + l3-interface-ipv6-address-list: + type: array + items: + $ref: "#/definitions/l3-interface-ipv6-address-list" + l-interfaces: description: | - Collection of persistent block-level external system auth info. + Collection of logical interfaces. properties: - esr-system-info: + l-interface: type: array items: - $ref: "#/definitions/esr-system-info" - vip-ipv4-address-list: + $ref: "#/definitions/l-interface" + l3-interface-ipv4-address-list: description: | IPv4 Address Range ###### Related Nodes - - TO instance-group (Many2Many) - - TO subnet (Many2Many) - - FROM vnfc - - FROM cloud-region (is composed of vip-ipv4-address-list) + - TO instance-group( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - TO l3-network( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - TO subnet( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - TO l-interface( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - TO vlan( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - TO vnfc( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) required: - - vip-ipv4-address + - l3-interface-ipv4-address properties: - vip-ipv4-address: + l3-interface-ipv4-address: type: string description: IP address - vip-ipv4-prefix-length: + l3-interface-ipv4-prefix-length: type: integer format: int64 description: Prefix length, 32 for single address @@ -42752,21 +54484,23 @@ definitions: type: array items: $ref: "#/definitions/relationship" - vip-ipv6-address-list: + l3-interface-ipv6-address-list: description: | IPv6 Address Range ###### Related Nodes - - TO instance-group (Many2Many) - - TO subnet (Many2Many) - - FROM vnfc - - FROM cloud-region (is composed of vip-ipv6-address-list) + - TO instance-group( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - TO l3-network( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - TO subnet( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - TO l-interface( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - TO vlan( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - TO vnfc( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) required: - - vip-ipv6-address + - l3-interface-ipv6-address properties: - vip-ipv6-address: + l3-interface-ipv6-address: type: string description: IP address - vip-ipv6-prefix-length: + l3-interface-ipv6-prefix-length: type: integer format: int64 description: Prefix length, 128 for single address @@ -42794,130 +54528,816 @@ definitions: type: array items: $ref: "#/definitions/relationship" - cloud-region: + l3-network: description: | - cloud-region designates an installation of a cloud cluster or region or instantiation. + Generic network definition ###### Related Nodes - - TO esr-system-info (comprises cloud-region, One2Many) - - TO complex (Many2One) - - TO l3-network (Many2Many) - - TO tenant (comprises cloud-region, One2Many) - - TO image (comprises cloud-region, One2Many) - - TO flavor (comprises cloud-region, One2Many) - - TO availability-zone (comprises cloud-region, One2Many) - - TO oam-network (comprises cloud-region, One2Many) - - TO dvs-switch (comprises cloud-region, One2Many) - - TO volume-group (comprises cloud-region, One2Many) - - TO group-assignment (comprises cloud-region, One2Many) - - TO snapshot (comprises cloud-region, One2Many) - - TO zone (Many2One) - - TO vip-ipv4-address-list (comprises cloud-region, One2Many) - - TO vip-ipv6-address-list (comprises cloud-region, One2Many) - - FROM pserver - - FROM logical-link + - TO instance-group( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO network-policy( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY) + - TO route-table-reference( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY) + - TO vpn-binding( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY) + - FROM cloud-region( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM complex( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - FROM ctag-assignment( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM segmentation-assignment( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY) + - FROM subnet( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY) + - L3-NETWORK is DELETED when these are DELETED CTAG-ASSIGNMENT,SEGMENTATION-ASSIGNMENT,SUBNET required: - - cloud-owner - - cloud-region-id - - sriov-automation + - network-id + - network-name + - is-bound-to-vpn + - is-provider-network + - is-shared-network + - is-external-network properties: - cloud-owner: + network-id: type: string - description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname - cloud-region-id: + description: Network ID, should be uuid. Unique across A&AI. + network-name: type: string - description: Identifier used by the vendor for the region. Second part of composite key - cloud-type: + description: Name of the network, governed by some naming convention.. + network-type: type: string - description: Type of the cloud (e.g., openstack) - owner-defined-type: + description: Type of the network - who defines these values? + network-role: type: string - description: Cloud-owner defined type indicator (e.g., dcp, lcp) - cloud-region-version: + description: Role the network plans - who defines these values? + network-technology: type: string - description: Software version employed at the site. NOTE - THIS FIELD IS NOT KEPT UP TO DATE. - identity-url: + description: Network technology - who defines these values? + neutron-network-id: type: string - description: URL of the keystone identity service - cloud-zone: + description: Neutron network id of this Interface + is-bound-to-vpn: + type: boolean + service-id: type: string - description: Zone where the cloud is homed. NOTE - THIS FIELD IS NOT CORRECTLY POPULATED. - complex-name: + description: Unique identifier of service from ASDC. Does not strictly map to ASDC services. SOON TO BE DEPRECATED + network-role-instance: + type: integer + format: int64 + description: network role instance + resource-version: type: string - description: complex name for cloud-region instance. NOTE - THIS FIELD IS NOT CORRECTLY POPULATED. - sriov-automation: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by MSO + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance, managed by MSO + mso-catalog-key: + type: string + description: Corresponds to the SDN-C catalog id used to configure this VCE + contrail-network-fqdn: + type: string + description: Contrail FQDN for the network + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + model-customization-id: + type: string + description: captures the id of all the configuration used to customize the resource for the service. + widget-model-id: + type: string + description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. + widget-model-version: + type: string + description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. + physical-network-name: + type: string + description: Name associated with the physical network. + is-provider-network: type: boolean - cloud-extra-info: + is-shared-network: + type: boolean + is-external-network: + type: boolean + selflink: type: string - description: ESR inputs extra information about the VIM or Cloud which will be decoded by MultiVIM. - cloud-epa-caps: + description: Path to the controller object. + operational-status: type: string - description: MultiVIM will discover and expose EPA capabilities. + description: Indicator for whether the resource is considered operational. + subnets: + type: array + items: + $ref: "#/definitions/subnet" + ctag-assignments: + type: array + items: + $ref: "#/definitions/ctag-assignment" + segmentation-assignments: + type: array + items: + $ref: "#/definitions/segmentation-assignment" + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + description: Relates to tenant (or is it a child of tenant), complex, service, vpn-binding + l3-networks: + properties: + l3-network: + type: array + items: + $ref: "#/definitions/l3-network" + lag-interface: + description: | + Link aggregate interface + ###### Related Nodes + - TO generic-vnf( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO lag-link( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY) + - TO logical-link( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - TO p-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY) + - TO pnf( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - TO pserver( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - TO vpls-pe( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE) + - LAG-INTERFACE is DELETED when these are DELETED L-INTERFACE + - LAG-INTERFACE deletion means associated objects of these types are also DELETED:LAG-LINK,LOGICAL-LINK + required: + - interface-name + - in-maint + properties: + interface-name: + type: string + description: Name that identifies the link aggregate interface + interface-description: + type: string + description: Human friendly text regarding this interface. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - volume-groups: + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + interface-id: + type: string + description: ID of interface + interface-role: + type: string + description: Role assigned to this Interface, should use values as defined in ECOMP Yang models. + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + in-maint: + type: boolean + relationship-list: type: array items: - $ref: "#/definitions/volume-group" - tenants: + $ref: "#/definitions/relationship" + l-interfaces: type: array items: - $ref: "#/definitions/tenant" - flavors: + $ref: "#/definitions/l-interface" + lag-interfaces: + description: | + Collection of link aggregate interfaces. + properties: + lag-interface: + type: array + items: + $ref: "#/definitions/lag-interface" + lag-link: + description: | + LAG links can connect lag-interfaces + ###### Related Nodes + - FROM lag-interface( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY) + required: + - link-name + properties: + link-name: + type: string + description: Alphabetical concatenation of lag-interface names + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: type: array items: - $ref: "#/definitions/flavor" - group-assignments: + $ref: "#/definitions/relationship" + lag-links: + description: | + Collection of link aggregation connections + properties: + lag-link: + type: array + items: + $ref: "#/definitions/lag-link" + license: + description: | + Metadata for license group. + ###### Related Nodes + - TO generic-vnf( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO vce( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + required: + - group-uuid + - resource-uuid + properties: + group-uuid: + type: string + description: Unique ID for the license group the resource belongs to, should be uuid. + resource-uuid: + type: string + description: Unique ID of a license resource. + resource-version: + type: string + description: Concurrency value + relationship-list: type: array items: - $ref: "#/definitions/group-assignment" - snapshots: + $ref: "#/definitions/relationship" + licenses: + description: | + Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management + properties: + license: + type: array + items: + $ref: "#/definitions/license" + line-of-business: + description: | + describes a line-of-business + ###### Related Nodes + - TO generic-vnf( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + required: + - line-of-business-name + properties: + line-of-business-name: + type: string + description: Name of the line-of-business (product) + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: type: array items: - $ref: "#/definitions/snapshot" - images: + $ref: "#/definitions/relationship" + lines-of-business: + description: | + Collection of lines-of-business + properties: + line-of-business: + type: array + items: + $ref: "#/definitions/line-of-business" + logical-link: + description: | + Logical links generally connect l-interfaces but are used to express logical connectivity between two points + ###### Related Nodes + - TO cloud-region( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY) + - TO generic-vnf( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY) + - TO lag-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY) + - TO logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - TO pnf( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY) + - TO pserver( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY) + - TO vpn-binding( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - TO virtual-data-center( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM configuration( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - FROM l-interface( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY) + - FROM p-interface( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - FROM vlan( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + required: + - link-name + - in-maint + - link-type + properties: + link-name: + type: string + description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ + in-maint: + type: boolean + link-type: + type: string + description: Type of logical link, e.g., evc + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + ip-version: + type: string + description: v4, v6, or ds for dual stack + routing-protocol: + type: string + description: For example, static or BGP + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + widget-model-id: + type: string + description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. + widget-model-version: + type: string + description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. + operational-status: + type: string + description: Indication of operational status of the logical link. + prov-status: + type: string + description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. + link-role: + type: string + description: Indication of the network use of the logical link. + link-name2: + type: string + description: Alias or alternate name (CLCI or D1 name). + link-id: + type: string + description: UUID of the logical-link, SDNC generates this. + circuit-id: + type: string + description: Circuit id + purpose: + type: string + description: Reason for this entity, role it is playing + relationship-list: type: array items: - $ref: "#/definitions/image" - dvs-switches: + $ref: "#/definitions/relationship" + logical-links: + description: | + Collection of logical connections + properties: + logical-link: + type: array + items: + $ref: "#/definitions/logical-link" + metadata: + description: | + Collection of metadatum (key/value pairs) + properties: + metadatum: + type: array + items: + $ref: "#/definitions/metadatum" + metadatum: + description: | + Key/value pairs + ###### Related Nodes + - TO configuration( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE) + - TO connector( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE) + - TO image( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE) + - TO service-instance( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - TO model-ver( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + required: + - metaname + - metaval + properties: + metaname: + type: string + metaval: + type: string + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model: + description: | + Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version + ###### Related Nodes + - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE) + - FROM instance-group( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY) + - FROM model-ver( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE) + - FROM named-query( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY) + - FROM named-query-element( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE) + - MODEL cannot be deleted if linked to INSTANCE-GROUP,NAMED-QUERY,NAMED-QUERY-ELEMENT + - MODEL is DELETED when these are DELETED MODEL-VER + required: + - model-invariant-id + - model-type + properties: + model-invariant-id: + type: string + description: Unique identifier corresponding to the main definition of a model in ASDC + model-type: + type: string + description: Type of the model, e.g., service, resource, widget, etc. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-vers: type: array items: - $ref: "#/definitions/dvs-switch" - oam-networks: + $ref: "#/definitions/model-ver" + relationship-list: type: array items: - $ref: "#/definitions/oam-network" - availability-zones: + $ref: "#/definitions/relationship" + model-and-named-query-search: + description: | + ModelAndNamedQuerySearch holds query-parameters and instance-properties for performing a named-query or model query + properties: + query-parameters: + type: object + $ref: "#/definitions/query-parameters" + instance-filters: + type: object + $ref: "#/definitions/instance-filters" + secondary-filts: + type: object + $ref: "#/definitions/secondary-filts" + top-node-type: + type: string + secondary-filter-cut-point: + type: string + model-constraint: + description: | + This is how we would capture constraints defining allowed sets of elements. + ###### Related Nodes + - TO model-element( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE) + - MODEL-CONSTRAINT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET + required: + - model-constraint-uuid + - constrained-element-set-uuid-to-replace + properties: + model-constraint-uuid: + type: string + constrained-element-set-uuid-to-replace: + type: string + constrained-element-sets: type: array items: - $ref: "#/definitions/availability-zone" + $ref: "#/definitions/constrained-element-set" + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-constraints: + properties: + model-constraint: + type: array + items: + $ref: "#/definitions/model-constraint" + model-element: + description: | + Defines how other models combine to make up a higher-level model. + ###### Related Nodes + - TO element-choice-set( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE) + - TO model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - TO model-ver( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE) + - TO model-ver( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM model-constraint( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - MODEL-ELEMENT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET,MODEL-CONSTRAINT + required: + - model-element-uuid + - new-data-del-flag + - cardinality + properties: + model-element-uuid: + type: string + new-data-del-flag: + type: string + description: Indicates whether this element was created as part of instantiation from this model + cardinality: + type: string + description: How many of this type of element are required/allowed + linkage-points: + type: string + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-elements: + type: array + items: + $ref: "#/definitions/model-element" + description: Defines how other models combine to make up a higher-level model + model-constraints: + type: array + items: + $ref: "#/definitions/model-constraint" + description: Describes new constraints on this model element that are not part of that model's definition relationship-list: type: array items: $ref: "#/definitions/relationship" - esr-system-info-list: + model-elements: + properties: + model-element: + type: array + items: + $ref: "#/definitions/model-element" + model-ver: + description: | + Subgraph definition provided by ASDC to describe a specific version of an inventory asset and its connections related to ASDC models + ###### Related Nodes + - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + - MODEL-VER cannot be deleted if linked to MODEL-ELEMENT + - MODEL-VER is DELETED when these are DELETED MODEL-ELEMENT,METADATUM + required: + - model-version-id + - model-name + - model-version + properties: + model-version-id: + type: string + description: Unique identifier corresponding to one version of a model in ASDC + model-name: + type: string + description: Name of the model, which can change from version to version. + model-version: + type: string + description: Version + model-description: + type: string + description: Description + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-elements: type: array items: - $ref: "#/definitions/esr-system-info" - vip-ipv4-address-list: + $ref: "#/definitions/model-element" + metadata: + type: array + items: + $ref: "#/definitions/metadatum" + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + model-vers: + properties: + model-ver: type: array items: - $ref: "#/definitions/vip-ipv4-address-list" - vip-ipv6-address-list: + $ref: "#/definitions/model-ver" + models: + description: | + Collection of subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models + properties: + model: type: array items: - $ref: "#/definitions/vip-ipv6-address-list" - cloud-regions: + $ref: "#/definitions/model" + multicast-configuration: + description: | + ###### Related Nodes + - FROM vlan( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY) + required: + - multicast-configuration-id + - multicast-protocol + - rp-type properties: - cloud-region: + multicast-configuration-id: + type: string + description: Unique id of multicast configuration. + multicast-protocol: + type: string + description: protocol of multicast configuration + rp-type: + type: string + description: rp type of multicast configuration + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + multicast-configurations: + description: | + multicast configuration of generic-vnf ip-address + properties: + multicast-configuration: type: array items: - $ref: "#/definitions/cloud-region" + $ref: "#/definitions/multicast-configuration" + named-queries: + properties: + named-query: + type: array + items: + $ref: "#/definitions/named-query" + named-query: + description: | + TBD + ###### Related Nodes + - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE) + - TO model( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY) + - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE) + - NAMED-QUERY is DELETED when these are DELETED NAMED-QUERY-ELEMENT + required: + - named-query-uuid + - named-query-name + - named-query-version + properties: + named-query-uuid: + type: string + named-query-name: + type: string + named-query-version: + type: string + required-input-param: + type: string + description: + type: string + resource-version: + type: string + named-query-elements: + type: array + items: + $ref: "#/definitions/named-query-element" + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + named-query-element: + description: | + TBD + ###### Related Nodes + - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE) + - TO model( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE) + - TO named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - FROM property-constraint( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - FROM related-lookup( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - NAMED-QUERY-ELEMENT is DELETED when these are DELETED PROPERTY-CONSTRAINT,RELATED-LOOKUP + required: + - named-query-element-uuid + properties: + named-query-element-uuid: + type: string + property-collect-list: + type: string + resource-version: + type: string + property-limit-desc: + type: string + do-not-output: + type: string + named-query-elements: + type: array + items: + $ref: "#/definitions/named-query-element" + related-lookups: + type: array + items: + $ref: "#/definitions/related-lookup" + property-constraints: + type: array + items: + $ref: "#/definitions/property-constraint" + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + named-query-elements: + properties: + named-query-element: + type: array + items: + $ref: "#/definitions/named-query-element" + network: + description: | + Namespace for network inventory resources. + properties: + logical-links: + type: array + items: + $ref: "#/definitions/logical-link" + site-pair-sets: + type: array + items: + $ref: "#/definitions/site-pair-set" + vpn-bindings: + type: array + items: + $ref: "#/definitions/vpn-binding" + vpls-pes: + type: array + items: + $ref: "#/definitions/vpls-pe" + multicast-configurations: + type: array + items: + $ref: "#/definitions/multicast-configuration" + vces: + type: array + items: + $ref: "#/definitions/vce" + vnfcs: + type: array + items: + $ref: "#/definitions/vnfc" + l3-networks: + type: array + items: + $ref: "#/definitions/l3-network" + network-policies: + type: array + items: + $ref: "#/definitions/network-policy" + generic-vnfs: + type: array + items: + $ref: "#/definitions/generic-vnf" + lag-links: + type: array + items: + $ref: "#/definitions/lag-link" + newvces: + type: array + items: + $ref: "#/definitions/newvce" + pnfs: + type: array + items: + $ref: "#/definitions/pnf" + physical-links: + type: array + items: + $ref: "#/definitions/physical-link" + ipsec-configurations: + type: array + items: + $ref: "#/definitions/ipsec-configuration" + route-table-references: + type: array + items: + $ref: "#/definitions/route-table-reference" + instance-groups: + type: array + items: + $ref: "#/definitions/instance-group" + zones: + type: array + items: + $ref: "#/definitions/zone" + configurations: + type: array + items: + $ref: "#/definitions/configurations" + network-policies: + properties: + network-policy: + type: array + items: + $ref: "#/definitions/network-policy" + network-policy: + description: | + ###### Related Nodes + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE) + - FROM l3-network( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY) + required: + - network-policy-id + properties: + network-policy-id: + type: string + description: UUID representing unique key to this instance + network-policy-fqdn: + type: string + description: Contrail FQDN for the policy + heat-stack-id: + type: string + description: ID for the openStack Heat instance + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" network-profile: description: | Network profile populated by SDN-GP for SNMP ###### Related Nodes - - FROM generic-vnf + - TO generic-vnf( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) required: - nm-profile-name properties: @@ -42942,18 +55362,155 @@ definitions: type: array items: $ref: "#/definitions/network-profile" - sriov-pf: + newvce: description: | - SR-IOV Physical Function + This object fills in the gaps from vce that were incorporated into generic-vnf. This object will be retired with vce. ###### Related Nodes - - FROM p-interface (is composed of sriov-pf) - - FROM sriov-vf + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE) + - NEWVCE is DELETED when these are DELETED L-INTERFACE required: - - pf-pci-id + - vnf-id2 + - vnf-name + - vnf-type properties: - pf-pci-id: + vnf-id2: type: string - description: Identifier for the sriov-pf + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + vnf-name: + type: string + description: Name of VNF. + vnf-name2: + type: string + description: Alternate name of VNF. + vnf-type: + type: string + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + prov-status: + type: string + description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. + operational-status: + type: string + description: Indicator for whether the resource is considered operational + license-key: + type: string + description: OBSOLETE - do not use + ipv4-oam-address: + type: string + description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address). + equipment-role: + type: string + description: Client should send valid enumerated value. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + ipv4-loopback0-address: + type: string + description: v4 Loopback0 address + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by MSO. + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance, managed by MSO + mso-catalog-key: + type: string + description: Corresponds to the SDN-C catalog id used to configure this VCE + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + l-interfaces: + type: array + items: + $ref: "#/definitions/l-interface" + newvces: + description: | + This object fills in the gaps from vce that were incorporated into generic-vnf. This object will be retired with vce. + properties: + newvce: + type: array + items: + $ref: "#/definitions/newvce" + notification-event: + properties: + cambria.partition: + type: string + notification-event-header: + type: object + $ref: "#/definitions/notification-event-header" + notification-event-header: + properties: + id: + type: string + timestamp: + type: string + source-name: + type: string + domain: + type: string + sequence-number: + type: string + severity: + type: string + event-type: + type: string + version: + type: string + action: + type: string + entity-type: + type: string + top-entity-type: + type: string + entity-link: + type: string + status: + type: string + notify: + required: + - event-id + properties: + event-id: + type: string + node-type: + type: string + event-trigger: + type: string + key-data: + type: array + items: + $ref: "#/definitions/key-data" + selflink: + type: string + oam-network: + description: | + OAM network, to be deprecated shortly. Do not use for new purposes. + ###### Related Nodes + - TO cloud-region( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO complex( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY) + - TO service-capability( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + required: + - network-uuid + - network-name + - cvlan-tag + properties: + network-uuid: + type: string + description: UUID of the network. Unique across a cloud-region + network-name: + type: string + description: Name of the network. + cvlan-tag: + type: integer + format: int64 + description: cvlan-id + ipv4-oam-gateway-address: + type: string + description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network + ipv4-oam-gateway-address-prefix-length: + type: integer + format: int32 + description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. @@ -42961,26 +55518,146 @@ definitions: type: array items: $ref: "#/definitions/relationship" - sriov-pfs: + oam-networks: description: | - Collection of SR-IOV Physical Functions. + Collection of OAM networks, to be deprecated shortly. Do not use for new purposes. properties: - sriov-pf: + oam-network: type: array items: - $ref: "#/definitions/sriov-pf" + $ref: "#/definitions/oam-network" + operational-environment: + description: | + It is a logical partition of the cloud which allows to have multiple environments in the production AIC. + ###### Related Nodes + - TO operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE) + - FROM operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE) + required: + - operational-environment-id + - operational-environment-name + - operational-environment-type + - operational-environment-status + - tenant-context + - workload-context + properties: + operational-environment-id: + type: string + description: UUID of an operational environment + operational-environment-name: + type: string + description: Operational Environment name + operational-environment-type: + type: string + description: Operational Environment Type. + operational-environment-status: + type: string + description: Status + tenant-context: + type: string + description: Tenant Context. + workload-context: + type: string + description: Workload Context. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + operational-environments: + description: | + a logical partition of the cloud which allows to have multiple environments in the production AIC. + properties: + operational-environment: + type: array + items: + $ref: "#/definitions/operational-environment" + overloaded-model: + description: | + Allows for legacy POST of old-style and new-style models + required: + - model-invariant-id + - model-name-version-id + - model-type + - model-name + - model-id + - model-version + properties: + model-invariant-id: + type: string + description: Unique identifier corresponding to the main definition of a model in ASDC + model-name-version-id: + type: string + description: Unique identifier corresponding to one version of a model in ASDC + model-type: + type: string + description: Type of the model, e.g., service, resource, widget, etc. + model-name: + type: string + description: Name of the model, which can change from version to version. + model-id: + type: string + description: Invariant unique ID which does not change from version to version + model-version: + type: string + description: Version + model-description: + type: string + description: Description + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-vers: + type: object + $ref: "#/definitions/model-vers" + relationship-list: + type: object + $ref: "#/definitions/relationship-list" + owning-entities: + description: | + Collection of owning-entities + properties: + owning-entity: + type: array + items: + $ref: "#/definitions/owning-entity" + owning-entity: + description: | + describes an owning-entity + ###### Related Nodes + - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE) + required: + - owning-entity-id + - owning-entity-name + properties: + owning-entity-id: + type: string + description: UUID of an owning entity + owning-entity-name: + type: string + description: Owning entity name + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" p-interface: description: | Physical interface (e.g., nic) ###### Related Nodes - - TO l-interface (comprises p-interface, Many2Many) - - TO physical-link (Many2Many) - - TO logical-link (Many2One) - - TO sriov-pf (comprises p-interface, One2One) - - FROM lag-interface - - FROM pserver (is composed of p-interface) - - FROM pnf (is composed of p-interface) - - FROM vpls-pe (is composed of p-interface) + - TO logical-link( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE) + - TO physical-link( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE) + - TO pnf( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - TO pserver( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - TO vpls-pe( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY) + - FROM l-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE) + - FROM sriov-pf( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE) + - P-INTERFACE is DELETED when these are DELETED L-INTERFACE,SRIOV-PF + - P-INTERFACE deletion means associated objects of these types are also DELETED:PHYSICAL-LINK required: - interface-name - in-maint @@ -43040,78 +55717,329 @@ definitions: type: array items: $ref: "#/definitions/p-interface" - lag-interface: + physical-link: description: | - Link aggregate interface + Collection of physical connections, typically between p-interfaces ###### Related Nodes - - TO logical-link (Many2Many) - - TO lag-link (Many2Many) - - TO p-interface (Many2Many) - - TO l-interface (comprises lag-interface, Many2Many) - - FROM generic-vnf (is composed of lag-interface) - - FROM pserver (is composed of lag-interface) - - FROM pnf (is composed of lag-interface) - - FROM vpls-pe (is composed of lag-interface) + - FROM p-interface( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE) required: - - interface-name + - link-name + properties: + link-name: + type: string + description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + circuit-id: + type: string + description: Circuit it + dual-mode: + type: string + description: Dual access mode (e.g., primary, secondary + management-option: + type: string + description: To provide information on who manages this circuit. A&AI or 3rd party transport provider + service-provider-name: + type: string + description: Name of the service Provider on this link. + service-provider-bandwidth-up-value: + type: integer + format: int32 + description: Upstream Bandwidth value agreed with the service provider + service-provider-bandwidth-up-units: + type: string + description: Units for the upstream BW value + service-provider-bandwidth-down-value: + type: integer + format: int32 + description: Downstream Bandwidth value agreed with the service provider + service-provider-bandwidth-down-units: + type: string + description: Units for downstream BW value + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + physical-links: + description: | + Collection of physical connections, typically between p-interfaces + properties: + physical-link: + type: array + items: + $ref: "#/definitions/physical-link" + platform: + description: | + describes a platform + ###### Related Nodes + - TO generic-vnf( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + required: + - platform-name + properties: + platform-name: + type: string + description: Name of the platform + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + platforms: + description: | + Collection of platforms + properties: + platform: + type: array + items: + $ref: "#/definitions/platform" + pnf: + description: | + PNF represents a physical network function. typically equipment used in the D1 world. in 1607, this will be populated by SDN-C to represent a premises router that a uCPE connects to. But this can be used to represent any physical device that is not an AIC node or uCPE. + ###### Related Nodes + - TO complex( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO instance-group( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO zone( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM esr-thirdparty-sdnc( esr-thirdparty-sdnc has pnf, One2Many) + - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY) + - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - FROM p-interface( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY) + - PNF is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE + required: + - pnf-name - in-maint properties: - interface-name: + pnf-name: type: string - description: Name that identifies the link aggregate interface - interface-description: + description: unique name of Physical Network Function. + pnf-name2: type: string - description: Human friendly text regarding this interface. + description: name of Physical Network Function. + pnf-name2-source: + type: string + description: source of name2 + pnf-id: + type: string + description: id of pnf + equip-type: + type: string + description: Equipment type. Source of truth should define valid values. + equip-vendor: + type: string + description: Equipment vendor. Source of truth should define valid values. + equip-model: + type: string + description: Equipment model. Source of truth should define valid values. + management-option: + type: string + description: identifier of managed by ATT or customer + ipaddress-v4-oam: + type: string + description: ipv4-oam-address with new naming convention for IP addresses + sw-version: + type: string + description: sw-version is the version of SW for the hosted application on the PNF. + in-maint: + type: boolean + frame-id: + type: string + description: ID of the physical frame (relay rack) where pnf is installed. + serial-number: + type: string + description: Serial number of the device + ipaddress-v4-loopback-0: + type: string + description: IPV4 Loopback 0 address + ipaddress-v6-loopback-0: + type: string + description: IPV6 Loopback 0 address + ipaddress-v4-aim: + type: string + description: IPV4 AIM address + ipaddress-v6-aim: + type: string + description: IPV6 AIM address + ipaddress-v6-oam: + type: string + description: IPV6 OAM address + inv-status: + type: string + description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - speed-value: + prov-status: type: string - description: Captures the numeric part of the speed - speed-units: + description: Prov Status of this device (not under canopi control) Valid values [PREPROV/NVTPROV/PROV] + nf-role: type: string - description: Captures the units corresponding to the speed + description: Nf Role is the role performed by this instance in the network. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + p-interfaces: + type: array + items: + $ref: "#/definitions/p-interface" + lag-interfaces: + type: array + items: + $ref: "#/definitions/lag-interface" + pnfs: + description: | + Collection of Physical Network Functions. + properties: + pnf: + type: array + items: + $ref: "#/definitions/pnf" + port-group: + description: | + Used to capture the network interfaces of this VCE + ###### Related Nodes + - TO vce( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM cvlan-tag( cvlan-tag org.onap.relationships.inventory.BelongsTo port-group, MANY2ONE) + - PORT-GROUP is DELETED when these are DELETED CVLAN-TAG + required: + - interface-id + - orchestration-status + properties: interface-id: type: string - description: ID of interface + description: Unique ID of the interface + neutron-network-id: + type: string + description: Neutron network id of this Interface + neutron-network-name: + type: string + description: Neutron network name of this Interface interface-role: type: string description: Role assigned to this Interface, should use values as defined in ECOMP Yang models. - prov-status: + resource-version: type: string - description: Trigger for operational monitoring of this resource by Service Assurance systems. - in-maint: - type: boolean + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + port-group-id: + type: string + description: Unique ID for port group in vmware + port-group-name: + type: string + description: Likely to duplicate value of neutron network name + switch-name: + type: string + description: DVS or standard switch name (should be non-null for port groups associated with DVS) + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by MSO + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance, managed by MSO + mso-catalog-key: + type: string + description: Corresponds to the SDN-C catalog id used to configure this VCE + cvlan-tags: + type: array + items: + $ref: "#/definitions/cvlan-tag-entry" relationship-list: type: array items: $ref: "#/definitions/relationship" - l-interfaces: + port-groups: + properties: + port-group: + type: array + items: + $ref: "#/definitions/port-group" + project: + description: | + describes the project + ###### Related Nodes + - TO service-instance( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY) + required: + - project-name + properties: + project-name: + type: string + description: Name of the project deploying a service + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: type: array items: - $ref: "#/definitions/l-interface" - lag-interfaces: + $ref: "#/definitions/relationship" + projects: description: | - Collection of link aggregate interfaces. + Collection of projects properties: - lag-interface: + project: type: array items: - $ref: "#/definitions/lag-interface" + $ref: "#/definitions/project" + properties: + description: | + Property holder for query properties or instance properties + properties: + property-name: + type: string + property-value: + type: string + property-constraint: + description: | + TBD + ###### Related Nodes + - TO named-query-element( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + required: + - property-constraint-uuid + - constraint-type + - property-name + - property-value + properties: + property-constraint-uuid: + type: string + constraint-type: + type: string + property-name: + type: string + property-value: + type: string + resource-version: + type: string + property-constraints: + properties: + property-constraint: + type: array + items: + $ref: "#/definitions/property-constraint" pserver: description: | Compute host whose hostname must be unique and must exactly match what is sent as a relationship to a vserver. ###### Related Nodes - - TO complex (Many2One) - - TO cloud-region (Many2One) - - TO availability-zone (Many2One) - - TO lag-interface (comprises pserver, Many2Many) - - TO p-interface (comprises pserver, Many2Many) - - TO zone (Many2One) - - FROM generic-vnf - - FROM group-assignment - - FROM vserver - - FROM logical-link + - TO group-assignment( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE) + - TO availability-zone( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE) + - TO cloud-region( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE) + - TO complex( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO zone( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY) + - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - FROM p-interface( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - FROM vserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE) + - PSERVER cannot be deleted if linked to GENERIC-VNF,LOGICAL-LINK,VSERVER + - PSERVER is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE + - PSERVER cannot be deleted if linked to GROUP-ASSIGNMENT required: - hostname - in-maint @@ -43219,361 +56147,407 @@ definitions: type: array items: $ref: "#/definitions/pserver" - virtual-data-center: + query-parameters: description: | - Virtual organization of cloud infrastructure elements in a data center context + QueryParameters for performing a named-query or model query + properties: + named-query: + type: object + $ref: "#/definitions/named-query" + overloaded-model: + type: object + $ref: "#/definitions/overloaded-model" + related-lookup: + description: | + TBD ###### Related Nodes - - TO generic-vnf (Many2Many) - - TO logical-link (Many2Many) - - FROM connector + - TO named-query-element( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) required: - - vdc-id - - vdc-name + - related-lookup-uuid + - source-node-type + - source-node-property + - target-node-type + - target-node-property properties: - vdc-id: + related-lookup-uuid: type: string - description: Unique ID of the vdc - vdc-name: + source-node-type: + type: string + source-node-property: + type: string + target-node-type: + type: string + target-node-property: + type: string + property-collect-list: type: string - description: Name of the virtual data center resource-version: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. relationship-list: type: array items: $ref: "#/definitions/relationship" - virtual-data-centers: - description: | - Virtual organization of cloud infrastructure elements in a data center context + related-lookups: properties: - virtual-data-center: + related-lookup: type: array items: - $ref: "#/definitions/virtual-data-center" - cloud-infrastructure: - description: | - Namespace for cloud infrastructure. + $ref: "#/definitions/related-lookup" + related-to-property: properties: - complexes: - type: array - items: - $ref: "#/definitions/complex" - cloud-regions: - type: array - items: - $ref: "#/definitions/cloud-region" - network-profiles: - type: array - items: - $ref: "#/definitions/network-profile" - pservers: + property-key: + type: string + description: Key part of a key/value pair + property-value: + type: string + description: Value part of a key/value pair + relationship: + properties: + related-to: + type: string + description: A keyword provided by A&AI to indicate type of node. + related-link: + type: string + description: URL to the object in A&AI. + relationship-data: type: array - items: - $ref: "#/definitions/pserver" - virtual-data-centers: + items: + $ref: "#/definitions/relationship-data" + relationship-data: + required: + - relationship-key + - relationship-value + properties: + relationship-key: + type: string + description: A keyword provided by A&AI to indicate an attribute. + relationship-value: + type: string + description: Value of the attribute. + relationship-list: + properties: + relationship: type: array - items: - $ref: "#/definitions/virtual-data-center" - esr-ems: + items: + $ref: "#/definitions/relationship" + reserved-prop-names: description: | - Persist EMS address information used by EMS driver. + Internal map to define some reserved properties of a vertex + properties: + last-mod-source-of-truth: + type: string + aai-node-type: + type: string + aai-created-ts: + type: integer + format: int64 + aai-unique-key: + type: string + aai-last-mod-ts: + type: integer + format: int64 + source-of-truth: + type: string + aai-uri: + type: string + response-list: + description: | + Response container for the results of a named-query or model query + properties: + inventory-response-items: + type: object + $ref: "#/definitions/inventory-response-items" + result-data: + properties: + resource-type: + type: string + description: The specific type of node in the A&AI graph + resource-link: + type: string + description: The URL to the specific resource + route-table-reference: + description: | + Openstack route table reference. ###### Related Nodes - - TO esr-system-info (comprises esr-ems, One2Many) + - FROM l3-network( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY) required: - - ems-id + - route-table-reference-id + - route-table-reference-fqdn properties: - ems-id: + route-table-reference-id: type: string - description: Unique ID of EMS. + description: Route Table Reference id, UUID assigned to this instance. + route-table-reference-fqdn: + type: string + description: FQDN entry in the route table. resource-version: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - esr-system-info-list: - type: array - items: - $ref: "#/definitions/esr-system-info" + description: Concurrency value relationship-list: type: array items: $ref: "#/definitions/relationship" - esr-ems-list: + route-table-references: + description: | + Collection of openstack route table references properties: - esr-ems: + route-table-reference: type: array items: - $ref: "#/definitions/esr-ems" - esr-vnfm: + $ref: "#/definitions/route-table-reference" + route-target: description: | - Persist VNFM address information used by VF-C. + Route target information ###### Related Nodes - - TO esr-system-info (comprises esr-vnfm, One2One) + - TO vpn-binding( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE) required: - - vnfm-id + - global-route-target + - route-target-role properties: - vnfm-id: - type: string - description: Unique ID of VNFM. - vim-id: + global-route-target: type: string - description: indecate the VIM to deploy VNF. - certificate-url: + description: Number used to identify an RT, globally unique in the network + route-target-role: type: string - description: certificate url of VNFM. + description: Role assigned to this route target resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - esr-system-info-list: - type: array - items: - $ref: "#/definitions/esr-system-info" relationship-list: type: array items: $ref: "#/definitions/relationship" - esr-vnfm-list: + route-targets: + description: | + Collection of route target information properties: - esr-vnfm: + route-target: type: array items: - $ref: "#/definitions/esr-vnfm" - esr-thirdparty-sdnc: + $ref: "#/definitions/route-target" + routing-instance: description: | - Persist SDNC address information used by ONAP SDNC. ###### Related Nodes - - TO esr-system-info (comprises esr-thirdparty-sdnc, One2One) - - TO pnf (One2Many) + - TO site-pair-set( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE) + - FROM site-pair( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE) + - ROUTING-INSTANCE is DELETED when these are DELETED SITE-PAIR required: - - thirdparty-sdnc-id + - routing-instance-id properties: - thirdparty-sdnc-id: - type: string - description: Unique ID of SDNC. - location: + routing-instance-id: type: string - description: used for DC type to indicate the location of SDNC, such as Core or Edge. - product-name: + description: Unique id of routing instance + rpm-owner: type: string - description: password used to access SDNC server. + description: rpm owner resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - esr-system-info-list: + site-pairs: type: array items: - $ref: "#/definitions/esr-system-info" + $ref: "#/definitions/site-pair" relationship-list: type: array items: $ref: "#/definitions/relationship" - esr-thirdparty-sdnc-list: + routing-instances: + description: | + set of probes related to generic-vnf routing instance properties: - esr-thirdparty-sdnc: + routing-instance: type: array items: - $ref: "#/definitions/esr-thirdparty-sdnc" - external-system: - description: | - Namespace for external system. + $ref: "#/definitions/routing-instance" + sdn-zone-response: properties: - esr-ems-list: + oam-networks: + type: object + $ref: "#/definitions/oam-networks" + az-and-dvs-switches: type: array - items: - $ref: "#/definitions/esr-ems" - esr-vnfm-list: + items: + $ref: "#/definitions/az-and-dvs-switches" + search: + properties: + edge-tag-query-result: + type: object + $ref: "#/definitions/edge-tag-query-result" + edge-tag-query-request: + type: object + $ref: "#/definitions/edge-tag-query-request" + search-results: + type: object + $ref: "#/definitions/search-results" + sdn-zone-response: + type: object + $ref: "#/definitions/sdn-zone-response" + search-results: + properties: + result-data: type: array - items: - $ref: "#/definitions/esr-vnfm" - esr-thirdparty-sdnc-list: + items: + $ref: "#/definitions/result-data" + secondary-filt: + description: | + SecondaryFilt for performing a named-query or model query + secondary-filter: + properties: + property-name: + type: string + filter-type: + type: string + property-value: + type: string + secondary-filts: + description: | + SecondaryFilts for performing a named-query or model query + properties: + secondary-filt: type: array - items: - $ref: "#/definitions/esr-thirdparty-sdnc" - connector: + items: + $ref: "#/definitions/secondary-filt" + segmentation-assignment: description: | - Collection of resource instances used to connect a variety of disparate inventory widgets + Openstack segmentation assignment. ###### Related Nodes - - TO virtual-data-center (Many2Many) - - TO metadatum (comprises connector, Many2Many) - - FROM service-instance + - TO l3-network( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) required: - - resource-instance-id + - segmentation-id properties: - resource-instance-id: + segmentation-id: type: string - description: Unique id of resource instance. + description: Route Table Reference id, UUID assigned to this instance. resource-version: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - model-invariant-id: - type: string - description: the ASDC model id for this resource or service model. - model-version-id: - type: string - description: the ASDC model version for this resource or service model. - persona-model-version: - type: string - description: the ASDC model version for this resource or service model. - widget-model-id: - type: string - description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. - widget-model-version: - type: string - description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. + description: Concurrency value relationship-list: type: array items: $ref: "#/definitions/relationship" - metadata: - type: array - items: - $ref: "#/definitions/metadatum" - connectors: + segmentation-assignments: description: | - Collection of resource instances used to connect a variety of disparate inventory widgets + Collection of openstack segmentation assignments properties: - connector: + segmentation-assignment: type: array items: - $ref: "#/definitions/connector" - tunnel-xconnect: + $ref: "#/definitions/segmentation-assignment" + service: description: | - Represents the specifics of a tunnel cross connect piece of a resource that gets separately allotted - ###### Related Nodes - - FROM allotted-resource (is composed of tunnel-xconnect) + Stand-in for service model definitions. Likely to be deprecated in favor of models from ASDC. Does not strictly map to ASDC services. required: - - id - - bandwidth-up-wan1 - - bandwidth-down-wan1 - - bandwidth-up-wan2 - - bandwidth-down-wan2 + - service-id + - service-description properties: - id: - type: string - description: Allotted Resource id UUID assigned to this instance. - bandwidth-up-wan1: - type: string - description: The WAN uplink bandwidth for WAN1 - bandwidth-down-wan1: + service-id: type: string - description: The WAN downlink bandwidth for WAN1 - bandwidth-up-wan2: + description: This gets defined by others to provide a unique ID for the service, we accept what is sent. + service-description: type: string - description: The WAN uplink bandwidth for WAN2 - bandwidth-down-wan2: + description: Description of the service + service-selflink: type: string - description: The WAN downlink bandwidth for WAN2 + description: URL to endpoint where AAI can get more details resource-version: type: string - description: Concurrency value + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + service-version: + type: string + description: service version relationship-list: type: array items: $ref: "#/definitions/relationship" - tunnel-xconnects: + service-capabilities: description: | - This object is used to store the specific tunnel cross connect aspects of an allotted resource + Collection of service capabilities. properties: - tunnel-xconnect: + service-capability: type: array items: - $ref: "#/definitions/tunnel-xconnect" - allotted-resource: + $ref: "#/definitions/service-capability" + service-capability: description: | - Represents a slice or partial piece of a resource that gets separately allotted + Early definition of server/resource pairings, likely to be replaced by models. No new use should be made of this. ###### Related Nodes - - TO generic-vnf (Many2Many) - - TO l3-network (Many2Many) - - TO instance-group (Many2Many) - - TO network-policy (One2One) - - TO vlan (Many2Many) - - TO l-interface (One2Many) - - TO tunnel-xconnect (comprises allotted-resource, One2One) - - TO vpn-binding (Many2Many) - - TO allotted-resource (One2One) - - FROM configuration - - FROM service-instance (is composed of allotted-resource) - - FROM service-instance - - FROM allotted-resource + - FROM availability-zone( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + - SERVICE-CAPABILITY cannot be deleted if linked to AVAILABILITY-ZONE,OAM-NETWORK required: - - id + - service-type + - vnf-type properties: - id: - type: string - description: Allotted Resource id UUID assigned to this instance. - description: - type: string - description: The descriptive information assigned to this allotted resource instance - selflink: - type: string - description: Link back to more information in the controller - model-invariant-id: - type: string - description: the ASDC model id for this resource or service model. - model-version-id: + service-type: type: string - description: the ASDC model version for this resource or service model. - persona-model-version: + description: This gets defined by others to provide a unique ID for the service, we accept what is sent. + vnf-type: type: string - description: the ASDC model version for this resource or service model. + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. resource-version: type: string - description: Concurrency value - orchestration-status: - type: string - description: Orchestration status - operational-status: - type: string - description: Indicator for whether the resource is considered operational - type: - type: string - description: Generic description of the type of allotted resource. - role: - type: string - description: role in the network that this resource will be providing. - tunnel-xconnects: - type: array - items: - $ref: "#/definitions/tunnel-xconnect" + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. relationship-list: type: array items: $ref: "#/definitions/relationship" - allotted-resources: + service-design-and-creation: description: | - This object is used to store slices of services being offered + Namespace for objects managed by ASDC properties: - allotted-resource: + vnf-images: type: array - items: - $ref: "#/definitions/allotted-resource" + items: + $ref: "#/definitions/vnf-image" + services: + type: array + items: + $ref: "#/definitions/service" + service-capabilities: + type: array + items: + $ref: "#/definitions/service-capability" + models: + type: array + items: + $ref: "#/definitions/model" + named-queries: + type: array + items: + $ref: "#/definitions/named-query" service-instance: description: | Instance of a service ###### Related Nodes - - TO configuration (One2Many) - - TO zone (Many2One) - - TO cvlan-tag (Many2Many) - - TO pnf (One2Many) - - TO connector (Many2Many) - - TO metadatum (comprises service-instance, Many2Many) - - TO logical-link (Many2Many) - - TO vlan (One2Many) - - TO service-instance (One2Many) - - TO ctag-assignment (One2Many) - - TO instance-group (Many2Many) - - TO allotted-resource (comprises service-instance, Many2Many) - - TO allotted-resource (Many2Many) - - FROM generic-vnf - - FROM l3-network - - FROM owning-entity - - FROM project - - FROM service-subscription (is composed of service-instance) - - FROM vce - - FROM service-instance + - TO generic-vnf( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY) + - TO l3-network( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY) + - TO owning-entity( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE) + - TO allotted-resource( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY) + - TO configuration( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - TO connector( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY) + - TO ctag-assignment( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY) + - TO cvlan-tag( service-instance org.onap.relationships.inventory.ComposedOf cvlan-tag, MANY2MANY) + - TO instance-group( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO logical-link( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - TO pnf( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY) + - TO service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY) + - TO vlan( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY) + - TO zone( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - TO service-subscription( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE) + - TO vce( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY) + - FROM project( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY) + - SERVICE-INSTANCE is DELETED when these are DELETED ALLOTTED-RESOURCE,METADATUM + - SERVICE-INSTANCE deletion means associated objects of these types are also DELETED:LOGICAL-LINK required: - service-instance-id - service-type - service-role + - created-at + - updated-at + - description properties: service-instance-id: type: string @@ -43593,6 +56567,15 @@ definitions: workload-context: type: string description: This field will store the workload context assigned to the service-instance. + created-at: + type: string + description: create time of Network Service. + updated-at: + type: string + description: last update of Network Service. + description: + type: string + description: short description for service-instance. model-invariant-id: type: string description: the ASDC model id for this resource or service model. @@ -43662,9 +56645,10 @@ definitions: description: | Object that group service instances. ###### Related Nodes - - TO service-instance (comprises service-subscription, Many2Many) - - FROM customer (is composed of service-subscription) - - FROM tenant + - TO customer( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE) + - TO tenant( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE) + - SERVICE-SUBSCRIPTION is DELETED when these are DELETED SERVICE-INSTANCE required: - service-type properties: @@ -43693,55 +56677,131 @@ definitions: type: array items: $ref: "#/definitions/service-subscription" - customer: + services: + description: | + Collection of service model definitions. Likely to be deprecated in favor of models from ASDC. + properties: + service: + type: array + items: + $ref: "#/definitions/service" + site-pair: description: | - customer identifiers to provide linkage back to BSS information. ###### Related Nodes - - TO service-subscription (comprises customer, Many2Many) + - TO routing-instance( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE) + - FROM class-of-service( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE) + - SITE-PAIR is DELETED when these are DELETED CLASS-OF-SERVICE required: - - global-customer-id - - subscriber-name - - subscriber-type + - site-pair-id properties: - global-customer-id: + site-pair-id: type: string - description: Global customer id used across ECOMP to uniquely identify customer. - subscriber-name: + description: unique identifier of probe + source-ip: type: string - description: Subscriber name, an alternate way to retrieve a customer. - subscriber-type: + description: Prefix address + destination-ip: type: string - description: Subscriber type, a way to provide VID with only the INFRA customers. + description: Prefix address + ip-version: + type: string + description: ip version, v4, v6 + destination-hostname: + type: string + description: Hostname of the destination equipment to which SLAs are measured against. + destination-equip-type: + type: string + description: The type of destinatination equipment. Could be Router, UCPE, etc. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - service-subscriptions: + classes-of-service: type: array items: - $ref: "#/definitions/service-subscription" + $ref: "#/definitions/class-of-service" relationship-list: type: array items: $ref: "#/definitions/relationship" - customers: + site-pair-set: description: | - Collection of customer identifiers to provide linkage back to BSS information. + Set of instances for probes used to measure service level agreements + ###### Related Nodes + - TO generic-vnf( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + - FROM routing-instance( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE) + - SITE-PAIR-SET is DELETED when these are DELETED ROUTING-INSTANCE + required: + - site-pair-set-id properties: - customer: + site-pair-set-id: + type: string + description: Unique id of site pair set. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + routing-instances: + type: array + items: + $ref: "#/definitions/routing-instance" + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + site-pair-sets: + description: | + Collection of sets of instances for probes related to generic-vnf + properties: + site-pair-set: type: array items: - $ref: "#/definitions/customer" - line-of-business: + $ref: "#/definitions/site-pair-set" + site-pairs: description: | - describes a line-of-business + probe within a set + properties: + site-pair: + type: array + items: + $ref: "#/definitions/site-pair" + snapshot: + description: | + Openstack snapshot ###### Related Nodes - - TO generic-vnf (Many2Many) + - TO cloud-region( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vserver( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE) required: - - line-of-business-name + - snapshot-id properties: - line-of-business-name: + snapshot-id: type: string - description: Name of the line-of-business (product) + description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. + snapshot-name: + type: string + description: Snapshot name + snapshot-architecture: + type: string + description: Operating system architecture + snapshot-os-distro: + type: string + description: The common name of the operating system distribution in lowercase + snapshot-os-version: + type: string + description: The operating system version as specified by the distributor. + application: + type: string + description: The application that the image instantiates. + application-vendor: + type: string + description: The vendor of the application. + application-version: + type: string + description: The version of the application. + snapshot-selflink: + type: string + description: URL to endpoint where AAI can get more details + prev-snapshot-id: + type: string + description: This field contains the UUID of the previous snapshot (if any). resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. @@ -43749,129 +56809,704 @@ definitions: type: array items: $ref: "#/definitions/relationship" - lines-of-business: + snapshots: description: | - Collection of lines-of-business + Collection of openstack snapshots properties: - line-of-business: + snapshot: type: array items: - $ref: "#/definitions/line-of-business" - owning-entity: + $ref: "#/definitions/snapshot" + sriov-pf: description: | - describes an owning-entity + SR-IOV Physical Function ###### Related Nodes - - TO service-instance (One2Many) + - TO p-interface( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE) + - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE) required: - - owning-entity-id - - owning-entity-name + - pf-pci-id properties: - owning-entity-id: + pf-pci-id: type: string - description: UUID of an owning entity - owning-entity-name: + description: Identifier for the sriov-pf + resource-version: type: string - description: Owning entity name + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + sriov-pfs: + description: | + Collection of SR-IOV Physical Functions. + properties: + sriov-pf: + type: array + items: + $ref: "#/definitions/sriov-pf" + sriov-vf: + description: | + SR-IOV Virtual Function (not to be confused with virtual network function) + ###### Related Nodes + - TO l-interface( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE) + - TO sriov-pf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE) + required: + - pci-id + properties: + pci-id: + type: string + description: PCI ID used to identify the sriov-vf + vf-vlan-filter: + type: string + description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM. + vf-mac-filter: + type: string + description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM. + vf-vlan-strip: + type: boolean + description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM. + vf-vlan-anti-spoof-check: + type: boolean + description: This option ensures anti VLAN spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs. + vf-mac-anti-spoof-check: + type: boolean + description: This option ensures anti MAC spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs. + vf-mirrors: + type: string + description: This option defines the set of Mirror objects which essentially mirrors the traffic from source to set of collector VNF Ports. + vf-broadcast-allow: + type: boolean + description: This option, if set to true, sets the VF in promiscuous mode and allows all broadcast traffic to reach the VM + vf-unknown-multicast-allow: + type: boolean + description: This option, if set to true, sets the VF in promiscuous mode and allows unknown multicast traffic to reach the VM + vf-unknown-unicast-allow: + type: boolean + description: This option, if set to true, sets the VF in promiscuous mode and allows unknown unicast traffic to reach the VM + vf-insert-stag: + type: boolean + description: This option, if set to true, instructs to insert outer tag after traffic comes out of VM. + vf-link-status: + type: string + description: This option is used to set the link status. Valid values as of 1607 are on, off, and auto. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + neutron-network-id: + type: string + description: Neutron network id of the interface relationship-list: type: array items: $ref: "#/definitions/relationship" - owning-entities: + sriov-vfs: description: | - Collection of owning-entities + Collection of SR-IOV Virtual Functions. properties: - owning-entity: + sriov-vf: type: array items: - $ref: "#/definitions/owning-entity" - platform: + $ref: "#/definitions/sriov-vf" + start-node-filter: + properties: + property-name: + type: string + property-value: + type: string + subnet: description: | - describes a platform ###### Related Nodes - - TO generic-vnf (Many2Many) + - TO l3-network( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - FROM host-route( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE) + - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - SUBNET cannot be deleted if linked to L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST + - SUBNET is DELETED when these are DELETED HOST-ROUTE required: - - platform-name + - subnet-id + - dhcp-enabled properties: - platform-name: + subnet-id: type: string - description: Name of the platform + description: Subnet ID, should be UUID. + subnet-name: + type: string + description: Name associated with the subnet. + neutron-subnet-id: + type: string + description: Neutron id of this subnet + gateway-address: + type: string + description: gateway ip address + network-start-address: + type: string + description: network start address + cidr-mask: + type: string + description: cidr mask + ip-version: + type: string + description: ip version + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by MSO + dhcp-enabled: + type: boolean + dhcp-start: + type: string + description: the start address reserved for use by dhcp + dhcp-end: + type: string + description: the last address reserved for use by dhcp + subnet-role: + type: string + description: role of the subnet, referenced when assigning IPs + ip-assignment-direction: + type: string + description: ip address assignment direction of the subnet resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + subnet-sequence: + type: integer + format: int32 + description: sequence of the subnet + host-routes: + type: array + items: + $ref: "#/definitions/host-route" relationship-list: type: array items: $ref: "#/definitions/relationship" - platforms: + subnets: + properties: + subnet: + type: array + items: + $ref: "#/definitions/subnet" + tagged-inventory-item-list: + properties: + inventory-item: + type: array + items: + $ref: "#/definitions/inventory-item" + tenant: description: | - Collection of platforms + Openstack tenant + ###### Related Nodes + - TO cloud-region( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO group-assignment( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY) + - TO l3-network( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - TO volume-group( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + - FROM service-subscription( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY) + - FROM vserver( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE) + - TENANT cannot be deleted if linked to VSERVER + required: + - tenant-id + - tenant-name properties: - platform: + tenant-id: + type: string + description: Unique id relative to the cloud-region. + tenant-name: + type: string + description: Readable name of tenant + tenant-context: + type: string + description: This field will store the tenant context. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + vservers: + type: array + items: + $ref: "#/definitions/vserver" + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + tenants: + description: | + Collection of openstack tenants. + properties: + tenant: type: array items: - $ref: "#/definitions/platform" - project: + $ref: "#/definitions/tenant" + tunnel-xconnect: description: | - describes the project + Represents the specifics of a tunnel cross connect piece of a resource that gets separately allotted ###### Related Nodes - - TO service-instance (One2Many) + - TO allotted-resource( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE) required: - - project-name + - id + - bandwidth-up-wan1 + - bandwidth-down-wan1 + - bandwidth-up-wan2 + - bandwidth-down-wan2 properties: - project-name: + id: type: string - description: Name of the project deploying a service + description: Allotted Resource id UUID assigned to this instance. + bandwidth-up-wan1: + type: string + description: The WAN uplink bandwidth for WAN1 + bandwidth-down-wan1: + type: string + description: The WAN downlink bandwidth for WAN1 + bandwidth-up-wan2: + type: string + description: The WAN uplink bandwidth for WAN2 + bandwidth-down-wan2: + type: string + description: The WAN downlink bandwidth for WAN2 + resource-version: + type: string + description: Concurrency value + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + tunnel-xconnects: + description: | + This object is used to store the specific tunnel cross connect aspects of an allotted resource + properties: + tunnel-xconnect: + type: array + items: + $ref: "#/definitions/tunnel-xconnect" + update: + description: | + Serves a PATCH like function. Does not enforce concurrency control. Clear each usage with AAI team. + required: + - update-node-type + properties: + update-node-type: + type: string + update-node-key: + type: array + items: + $ref: "#/definitions/update-node-key" + update-node-uri: + type: string + action: + type: array + items: + $ref: "#/definitions/action" + update-node-key: + properties: + key-name: + type: string + key-value: + type: string + vce: + description: | + Virtual Customer Edge Router, used specifically for Gamma. This object is deprecated. + ###### Related Nodes + - TO availability-zone( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - TO complex( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - TO vserver( vce tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM license( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM port-group( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY) + - VCE is DELETED when these are DELETED ENTITLEMENT,LICENSE,PORT-GROUP + required: + - vnf-id + - vnf-name + - vnf-type + properties: + vnf-id: + type: string + description: Unique id of VNF. This is unique across the graph. + vnf-name: + type: string + description: Name of VNF. + vnf-name2: + type: string + description: Alternate name of VNF. + vnf-type: + type: string + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + service-id: + type: string + description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED. + regional-resource-zone: + type: string + description: Regional way of organizing pservers, source of truth should define values + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + operational-status: + type: string + description: Indicator for whether the resource is considered operational + license-key: + type: string + description: OBSOLETE - do not use + equipment-role: + type: string + description: Network role being played by this VNF + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by MSO + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance, managed by MSO + mso-catalog-key: + type: string + description: Corresponds to the SDN-C catalog id used to configure this VCE + vpe-id: + type: string + description: Unique ID of VPE connected to this VCE. + v6-vce-wan-address: + type: string + description: Valid v6 IP address for the WAN Link on this router. Implied length of /64. + ipv4-oam-address: + type: string + description: Address tail-f uses to configure vce, also used for troubleshooting and is IP used for traps generated by VCE. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + ipv4-loopback0-address: + type: string + description: Loopback0 address + entitlement-resource-uuid: + type: string + description: OBSOLETE - see child relationships + port-groups: + type: array + items: + $ref: "#/definitions/port-group" + licenses: + type: array + items: + $ref: "#/definitions/license" + entitlements: + type: array + items: + $ref: "#/definitions/entitlement" relationship-list: type: array items: $ref: "#/definitions/relationship" - projects: + vces: description: | - Collection of projects + Collection of Virtual Customer Edge Routers, used specifically for Gamma. This object is deprecated. properties: - project: + vce: type: array items: - $ref: "#/definitions/project" - business: + $ref: "#/definitions/vce" + vf-module: description: | - Namespace for business related constructs + a deployment unit of VNFCs + ###### Related Nodes + - TO generic-vnf( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO l3-network( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY) + - TO vnfc( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY) + - TO volume-group( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE) + - TO vserver( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY) + - VF-MODULE cannot be deleted if linked to VNFC + required: + - vf-module-id + - is-base-vf-module properties: - connectors: + vf-module-id: + type: string + description: Unique ID of vf-module. + vf-module-name: + type: string + description: Name of vf-module + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance. + orchestration-status: + type: string + description: orchestration status of this vf-module, mastered by MSO + is-base-vf-module: + type: boolean + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + model-customization-id: + type: string + description: captures the id of all the configuration used to customize the resource for the service. + widget-model-id: + type: string + description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. + widget-model-version: + type: string + description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. + contrail-service-instance-fqdn: + type: string + description: the Contrail unique ID for a service-instance + module-index: + type: integer + format: int32 + description: the index will track the number of modules of a given type that have been deployed in a VNF, starting with 0, and always choosing the lowest available digit + selflink: + type: string + description: Path to the controller object. + relationship-list: type: array items: - $ref: "#/definitions/connector" - customers: + $ref: "#/definitions/relationship" + vf-modules: + description: | + Collection of vf-modules, a deployment unit of VNFCs + properties: + vf-module: + type: array + items: + $ref: "#/definitions/vf-module" + vig-server: + description: | + vig-server contains information about a vig server used for IPSec-configuration. Populated by SDN-C from 1607 + ###### Related Nodes + - TO ipsec-configuration( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE) + required: + - vig-address-type + properties: + vig-address-type: + type: string + description: indicates whether the VIG is for AVPN or INTERNET + ipaddress-v4-vig: + type: string + description: v4 IP of the vig server + ipaddress-v6-vig: + type: string + description: v6 IP of the vig server + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: type: array items: - $ref: "#/definitions/customer" - lines-of-business: + $ref: "#/definitions/relationship" + vig-servers: + properties: + vig-server: + type: array + items: + $ref: "#/definitions/vig-server" + vip-ipv4-address-list: + description: | + IPv4 Address Range + ###### Related Nodes + - TO cloud-region( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO instance-group( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO subnet( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY) + required: + - vip-ipv4-address + properties: + vip-ipv4-address: + type: string + description: IP address + vip-ipv4-prefix-length: + type: integer + format: int64 + description: Prefix length, 32 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + neutron-network-id: + type: string + description: Neutron network id of the interface that address belongs to + neutron-subnet-id: + type: string + description: Neutron id of subnet that address belongs to + relationship-list: type: array items: - $ref: "#/definitions/line-of-business" - owning-entities: + $ref: "#/definitions/relationship" + vip-ipv6-address-list: + description: | + IPv6 Address Range + ###### Related Nodes + - TO cloud-region( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO instance-group( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO subnet( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY) + required: + - vip-ipv6-address + properties: + vip-ipv6-address: + type: string + description: IP address + vip-ipv6-prefix-length: + type: integer + format: int64 + description: Prefix length, 128 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + neutron-network-id: + type: string + description: Neutron network id of the interface that address belongs to + neutron-subnet-id: + type: string + description: Neutron id of subnet that address belongs to + relationship-list: type: array items: - $ref: "#/definitions/owning-entity" - platforms: + $ref: "#/definitions/relationship" + virtual-data-center: + description: | + Virtual organization of cloud infrastructure elements in a data center context + ###### Related Nodes + - FROM connector( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + required: + - vdc-id + - vdc-name + properties: + vdc-id: + type: string + description: Unique ID of the vdc + vdc-name: + type: string + description: Name of the virtual data center + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: type: array items: - $ref: "#/definitions/platform" - projects: + $ref: "#/definitions/relationship" + virtual-data-centers: + description: | + Virtual organization of cloud infrastructure elements in a data center context + properties: + virtual-data-center: + type: array + items: + $ref: "#/definitions/virtual-data-center" + vlan: + description: | + Definition of vlan + ###### Related Nodes + - TO l-interface( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE) + - TO logical-link( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - TO multicast-configuration( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - VLAN is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST + - VLAN deletion means associated objects of these types are also DELETED:LOGICAL-LINK + required: + - vlan-interface + - in-maint + - is-ip-unnumbered + properties: + vlan-interface: + type: string + description: String that identifies the interface + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + vlan-description: + type: string + description: Used to describe (the service associated with) the vlan + backdoor-connection: + type: string + description: Whether customer is going to use this VLAN for backdoor connection to another customer premise device. + vpn-key: + type: string + description: This indicates the customers VPN ID associated with this vlan + orchestration-status: + type: string + description: Status of a vnf's vlan interface, on which the customer circuit resides, mastered by SDN-C. + in-maint: + type: boolean + prov-status: + type: string + description: Prov Status of the VLAN configuration related to a logical interface. Valid values [PREPROV/NVTPROV/PROV]. + is-ip-unnumbered: + type: boolean + relationship-list: type: array items: - $ref: "#/definitions/project" + $ref: "#/definitions/relationship" + l3-interface-ipv4-address-list: + type: array + items: + $ref: "#/definitions/l3-interface-ipv4-address-list" + l3-interface-ipv6-address-list: + type: array + items: + $ref: "#/definitions/l3-interface-ipv6-address-list" + vlans: + properties: + vlan: + type: array + items: + $ref: "#/definitions/vlan" + vnf: + description: | + Abstract vnf class + required: + - vnf-id + properties: + vnf-id: + type: string + description: Unique id of VNF. This is unique across the graph. vnf-image: description: | Image object that pertain to a VNF that doesn't have associated vservers. This is a kludge. ###### Related Nodes - - FROM generic-vnf + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE) + - VNF-IMAGE cannot be deleted if linked to GENERIC-VNF required: - vnf-image-uuid - application @@ -43907,56 +57542,136 @@ definitions: type: array items: $ref: "#/definitions/vnf-image" - service: + vnfc: description: | - Stand-in for service model definitions. Likely to be deprecated in favor of models from ASDC. Does not strictly map to ASDC services. + ###### Related Nodes + - TO generic-vnf( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO instance-group( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO vip-ipv4-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY) + - TO vip-ipv6-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY) + - TO vserver( vnfc tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + - VNFC is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST required: - - service-id - - service-description + - vnfc-name + - nfc-naming-code + - nfc-function + - in-maint + - is-closed-loop-disabled properties: - service-id: + vnfc-name: type: string - description: This gets defined by others to provide a unique ID for the service, we accept what is sent. - service-description: + description: Unique ID of vnfc. + nfc-naming-code: type: string - description: Description of the service - service-selflink: + description: Short code that is used in naming instances of the item being modeled + nfc-function: type: string - description: URL to endpoint where AAI can get more details + description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service + prov-status: + type: string + description: prov status of this vnfc + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by APP-C + ipaddress-v4-oam-vip: + type: string + description: Oam V4 vip address of this vnfc + in-maint: + type: boolean + is-closed-loop-disabled: + type: boolean + group-notation: + type: string + description: Group notation of VNFC + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - service-version: - type: string - description: service version relationship-list: type: array items: $ref: "#/definitions/relationship" - services: + l3-interface-ipv4-address-list: + type: array + items: + $ref: "#/definitions/l3-interface-ipv4-address-list" + l3-interface-ipv6-address-list: + type: array + items: + $ref: "#/definitions/l3-interface-ipv6-address-list" + vnfcs: description: | - Collection of service model definitions. Likely to be deprecated in favor of models from ASDC. + virtual network components associated with a vserver from application controller. properties: - service: + vnfc: type: array items: - $ref: "#/definitions/service" - service-capability: + $ref: "#/definitions/vnfc" + volume: description: | - Early definition of server/resource pairings, likely to be replaced by models. No new use should be made of this. + Ephemeral Block storage volume. ###### Related Nodes - - FROM availability-zone - - FROM oam-network + - FROM vserver (PARENT of volume, vserver tosca.relationships.AttachesTo volume) required: - - service-type + - volume-id + - volume-selflink + properties: + volume-id: + type: string + description: Unique ID of block storage volume relative to the vserver. + volume-selflink: + type: string + description: URL to endpoint where AAI can get more details + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + volume-group: + description: | + Persistent block-level storage. + ###### Related Nodes + - TO cloud-region( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO complex( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + required: + - volume-group-id + - volume-group-name - vnf-type properties: - service-type: + volume-group-id: type: string - description: This gets defined by others to provide a unique ID for the service, we accept what is sent. + description: Unique ID of volume-group. + volume-group-name: + type: string + description: Name of the volume group. + heat-stack-id: + type: string + description: Heat stack id corresponding to this volume-group vnf-type: type: string description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + orchestration-status: + type: string + description: Orchestration status of this volume-group + model-customization-id: + type: string + description: captures the id of all the configuration used to customize the resource for the service. + vf-module-model-customization-id: + type: string + description: helps relate the volume group to the vf-module whose components will require the volume group resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. @@ -43964,53 +57679,637 @@ definitions: type: array items: $ref: "#/definitions/relationship" - service-capabilities: + volume-groups: description: | - Collection of service capabilities. + Collection of persistent block-level storage. properties: - service-capability: + volume-group: type: array items: - $ref: "#/definitions/service-capability" - element-choice-set: + $ref: "#/definitions/volume-group" + volumes: description: | - This is how we would capture constraints defining allowed sets of elements. + Collection of ephemeral Block storage volumes. + properties: + volume: + type: array + items: + $ref: "#/definitions/volume" + vpls-pe: + description: | + VPLS Provider Edge routers. ###### Related Nodes - - TO model-element (comprises element-choice-set, One2Many) - - FROM constrained-element-set (is composed of element-choice-set) + - TO complex( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO ctag-pool( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - FROM p-interface( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - VPLS-PE is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE required: - - element-choice-set-uuid - - element-choice-set-name + - equipment-name properties: - element-choice-set-uuid: + equipment-name: type: string - element-choice-set-name: + prov-status: type: string - cardinality: + description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. + ipv4-oam-address: type: string + description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address). + equipment-role: + type: string + description: Client should send valid enumerated value, e.g., VPLS-PE. + vlan-id-outer: + type: integer + format: int64 + description: Temporary location for stag to get to VCE resource-version: type: string - model-elements: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: type: array items: - $ref: "#/definitions/model-element" + $ref: "#/definitions/relationship" + p-interfaces: + type: array + items: + $ref: "#/definitions/p-interface" + lag-interfaces: + type: array + items: + $ref: "#/definitions/lag-interface" + vpls-pes: + description: | + Collection of VPLS Provider Edge routers + properties: + vpls-pe: + type: array + items: + $ref: "#/definitions/vpls-pe" + vpn-binding: + description: | + VPN binding + ###### Related Nodes + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY) + - FROM l3-network( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - FROM route-target( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE) + - VPN-BINDING cannot be deleted if linked to ALLOTTED-RESOURCE,L3-NETWORK,LOGICAL-LINK + - VPN-BINDING is DELETED when these are DELETED ROUTE-TARGET + required: + - vpn-id + - vpn-name + properties: + vpn-id: + type: string + description: VPN ID, globally unique within A&AI + vpn-name: + type: string + description: VPN Name + vpn-platform: + type: string + description: the platform associated with the VPN example AVPN, Mobility + vpn-type: + type: string + description: Type of the vpn, should be taken from enumerated/valid values + vpn-region: + type: string + description: region of customer vpn + customer-vpn-id: + type: string + description: id for this customer vpn + route-distinguisher: + type: string + description: Used to distinguish the distinct VPN routes of separate customers who connect to the provider in an MPLS network. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + route-targets: + type: array + items: + $ref: "#/definitions/route-target" relationship-list: type: array items: $ref: "#/definitions/relationship" - element-choice-sets: + description: l3-networks relate to vpn-bindings + vpn-bindings: properties: - element-choice-set: + vpn-binding: type: array items: - $ref: "#/definitions/element-choice-set" + $ref: "#/definitions/vpn-binding" + vserver: + description: | + Virtual Servers, aka virtual machine or VM. + ###### Related Nodes + - TO tenant( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE) + - TO flavor( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE) + - TO image( vserver org.onap.relationships.inventory.Uses image, MANY2ONE) + - TO pserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE) + - TO snapshot( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE) + - TO volume (CHILD of vserver, vserver tosca.relationships.AttachesTo volume, ONE2MANY) + - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM vce( vce tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM l-interface( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE) + - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY) + - FROM vnfc( vnfc tosca.relationships.HostedOn vserver, ONE2MANY) + - VSERVER is DELETED when these are DELETED L-INTERFACE + - VSERVER deletion means associated objects of these types are also DELETED:VOLUME + required: + - vserver-id + - vserver-name + - vserver-selflink + - in-maint + - is-closed-loop-disabled + properties: + vserver-id: + type: string + description: Unique identifier for this vserver relative to its tenant + vserver-name: + type: string + description: Name of vserver + vserver-name2: + type: string + description: Alternative name of vserver + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + vserver-selflink: + type: string + description: URL to endpoint where AAI can get more details + in-maint: + type: boolean + is-closed-loop-disabled: + type: boolean + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + volumes: + type: array + items: + $ref: "#/definitions/volume" + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + l-interfaces: + type: array + items: + $ref: "#/definitions/l-interface" + vservers: + description: | + Collection of virtual Servers, aka virtual machines or VMs. + properties: + vserver: + type: array + items: + $ref: "#/definitions/vserver" + zone: + description: | + A zone is a grouping of assets in a location homing to the same connections into the CBB + ###### Related Nodes + - TO complex( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + required: + - zone-id + - zone-name + - design-type + - zone-context + properties: + zone-id: + type: string + description: Code assigned by AIC to the zone + zone-name: + type: string + description: English name associated with the zone + design-type: + type: string + description: Design of zone [Medium/Large?] + zone-context: + type: string + description: Context of zone [production/test] + status: + type: string + description: Status of a zone. + resource-version: + type: string + description: Concurrency value + relationship-list: + type: array + items: + $ref: "#/definitions/relationship" + zones: + description: | + Collection of zones + properties: + zone: + type: array + items: + $ref: "#/definitions/zone" +patchDefinitions: + aai-internal: + properties: + property-name: + type: string + property-value: + type: string + action: + properties: + action-type: + type: string + action-data: + type: array + items: + $ref: "#/patchDefinitions/action-data" + action-data: + properties: + property-name: + type: string + property-value: + type: string + actions: + description: | + APIs that are more action related than REST (e.g., notify, update). + properties: + update: + type: object + $ref: "#/patchDefinitions/update" + notify: + type: object + $ref: "#/patchDefinitions/notify" + allotted-resource: + description: | + Represents a slice or partial piece of a resource that gets separately allotted + ###### Related Nodes + - TO allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE) + - TO generic-vnf( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY) + - TO instance-group( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO l3-network( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY) + - TO l-interface( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY) + - TO network-policy( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE) + - TO vlan( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY) + - TO vpn-binding( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY) + - TO service-instance( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - FROM tunnel-xconnect( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE) + - FROM configuration( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY) + - FROM allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE) + - ALLOTTED-RESOURCE is DELETED when these are DELETED TUNNEL-XCONNECT + required: + - id + properties: + id: + type: string + description: Allotted Resource id UUID assigned to this instance. + description: + type: string + description: The descriptive information assigned to this allotted resource instance + selflink: + type: string + description: Link back to more information in the controller + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + allotted-resources: + description: | + This object is used to store slices of services being offered + properties: + allotted-resource: + type: array + items: + $ref: "#/patchDefinitions/allotted-resource" + availability-zone: + description: | + Availability zone, a collection of compute hosts/pservers + ###### Related Nodes + - TO complex( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO service-capability( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + - TO cloud-region( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - FROM pserver( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE) + - FROM vce( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - AVAILABILITY-ZONE cannot be deleted if linked to CTAG-POOL,DVS-SWITCH,GENERIC-VNF,PSERVER,VCE + required: + - availability-zone-name + - hypervisor-type + properties: + availability-zone-name: + type: string + description: Name of the availability zone. Unique across a cloud region + hypervisor-type: + type: string + description: Type of hypervisor. Source of truth should define valid values. + operational-status: + type: string + description: State that indicates whether the availability zone should be used, etc. Source of truth should define valid values. + availability-zones: + description: | + Collection of availability zones + properties: + availability-zone: + type: array + items: + $ref: "#/patchDefinitions/availability-zone" + az-and-dvs-switches: + properties: + dvs-switches: + type: object + $ref: "#/patchDefinitions/dvs-switches" + availability-zone: + type: object + $ref: "#/patchDefinitions/availability-zone" + business: + description: | + Namespace for business related constructs + properties: + connectors: + type: array + items: + $ref: "#/patchDefinitions/connector" + customers: + type: array + items: + $ref: "#/patchDefinitions/customer" + lines-of-business: + type: array + items: + $ref: "#/patchDefinitions/line-of-business" + owning-entities: + type: array + items: + $ref: "#/patchDefinitions/owning-entity" + platforms: + type: array + items: + $ref: "#/patchDefinitions/platform" + projects: + type: array + items: + $ref: "#/patchDefinitions/project" + class-of-service: + description: | + ###### Related Nodes + - TO site-pair( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE) + required: + - cos + properties: + cos: + type: string + description: unique identifier of probe + probe-id: + type: string + description: identifier of probe + probe-type: + type: string + description: type of probe + classes-of-service: + description: | + class-of-service of probe + properties: + class-of-service: + type: array + items: + $ref: "#/patchDefinitions/class-of-service" + cloud-infrastructure: + description: | + Namespace for cloud infrastructure. + properties: + complexes: + type: array + items: + $ref: "#/patchDefinitions/complex" + cloud-regions: + type: array + items: + $ref: "#/patchDefinitions/cloud-region" + network-profiles: + type: array + items: + $ref: "#/patchDefinitions/network-profile" + pservers: + type: array + items: + $ref: "#/patchDefinitions/pserver" + virtual-data-centers: + type: array + items: + $ref: "#/patchDefinitions/virtual-data-center" + cloud-region: + description: | + cloud-region designates an installation of a cloud cluster or region or instantiation. + ###### Related Nodes + - TO esr-system-info (CHILD of cloud-region, cloud-region has esr-system-info, One2Many) + - TO complex( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO l3-network( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - TO zone( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM availability-zone( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM flavor( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM group-assignment( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM image( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM oam-network( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM snapshot( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM volume-group( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY) + - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE) + - CLOUD-REGION cannot be deleted if linked to DVS-SWITCH,FLAVOR,GROUP-ASSIGNMENT,IMAGE,OAM-NETWORK,SNAPSHOT,TENANT,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST,VOLUME-GROUP + - CLOUD-REGION is DELETED when these are DELETED AVAILABILITY-ZONE + - CLOUD-REGION deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO + required: + - cloud-owner + - cloud-region-id + - sriov-automation + properties: + cloud-owner: + type: string + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + cloud-region-id: + type: string + description: Identifier used by the vendor for the region. Second part of composite key + cloud-type: + type: string + description: Type of the cloud (e.g., openstack) + owner-defined-type: + type: string + description: Cloud-owner defined type indicator (e.g., dcp, lcp) + cloud-region-version: + type: string + description: Software version employed at the site. NOTE - THIS FIELD IS NOT KEPT UP TO DATE. + identity-url: + type: string + description: URL of the keystone identity service + cloud-zone: + type: string + description: Zone where the cloud is homed. NOTE - THIS FIELD IS NOT CORRECTLY POPULATED. + complex-name: + type: string + description: complex name for cloud-region instance. NOTE - THIS FIELD IS NOT CORRECTLY POPULATED. + sriov-automation: + type: boolean + cloud-extra-info: + type: string + description: ESR inputs extra information about the VIM or Cloud which will be decoded by MultiVIM. + cloud-epa-caps: + type: string + description: MultiVIM will discover and expose EPA capabilities. + cloud-regions: + properties: + cloud-region: + type: array + items: + $ref: "#/patchDefinitions/cloud-region" + complex: + description: | + Collection of physical locations that can house cloud-regions. + ###### Related Nodes + - TO l3-network( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM availability-zone( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY) + - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM vce( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - FROM volume-group( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM zone( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - COMPLEX cannot be deleted if linked to AVAILABILITY-ZONE,CLOUD-REGION,GENERIC-VNF,OAM-NETWORK,PNF,PSERVER,VCE,VOLUME-GROUP,VPLS-PE,ZONE + - COMPLEX is DELETED when these are DELETED CTAG-POOL + required: + - physical-location-id + - physical-location-type + - street1 + - city + - postal-code + - country + - region + properties: + physical-location-id: + type: string + description: Unique identifier for physical location, e.g., CLLI + data-center-code: + type: string + description: Data center code which can be an alternate way to identify a complex + complex-name: + type: string + description: Gamma complex name for LCP instance. + identity-url: + type: string + description: URL of the keystone identity service + complexes: + description: | + Collection of physical locations that can house cloud-regions. + properties: + complex: + type: array + items: + $ref: "#/patchDefinitions/complex" + configuration: + description: | + Port Mirror Configuration. + ###### Related Nodes + - TO allotted-resource( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE) + - TO logical-link( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - CONFIGURATION is DELETED when these are DELETED METADATUM + - CONFIGURATION deletion means associated objects of these types are also DELETED:ALLOTTED-RESOURCE,LOGICAL-LINK + required: + - configuration-id + - configuration-type + - configuration-sub-type + - orchestration-status + - operational-status + - configuration-selflink + - model-customization-id + properties: + configuration-id: + type: string + description: UUID assigned to configuration. + management-option: + type: string + description: Indicates the entity that will manage this feature. Could be an organization or the name of the application as well. + configuration-name: + type: string + description: Name of the configuration. + configuration-type: + type: string + description: port-mirroring-configuration. + configuration-sub-type: + type: string + description: vprobe, pprobe. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + orchestration-status: + type: string + description: Orchestration status of the configuration. + operational-status: + type: string + description: Indicator for whether the resource is considered operational. + configuration-selflink: + type: string + description: URL to endpoint where AAI can get more details from SDN-GC. + model-customization-id: + type: string + description: id of the configuration used to customize the resource + configurations: + description: | + Collection of configurations + properties: + configuration: + type: array + items: + $ref: "#/patchDefinitions/configuration" + connector: + description: | + Collection of resource instances used to connect a variety of disparate inventory widgets + ###### Related Nodes + - TO virtual-data-center( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY) + - CONNECTOR is DELETED when these are DELETED METADATUM + required: + - resource-instance-id + properties: + resource-instance-id: + type: string + description: Unique id of resource instance. + connectors: + description: | + Collection of resource instances used to connect a variety of disparate inventory widgets + properties: + connector: + type: array + items: + $ref: "#/patchDefinitions/connector" constrained-element-set: description: | This is how we would capture constraints defining allowed sets of elements. ###### Related Nodes - - TO element-choice-set (comprises constrained-element-set, One2Many) - - FROM model-element (is composed of constrained-element-set) - - FROM model-constraint (is composed of constrained-element-set) + - TO model-constraint( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE) + - TO model-element( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM element-choice-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE) + - CONSTRAINED-ELEMENT-SET is DELETED when these are DELETED ELEMENT-CHOICE-SET required: - constrained-element-set-uuid - constraint-type @@ -44022,28 +58321,1472 @@ definitions: type: string check-type: type: string - resource-version: + constrained-element-sets: + properties: + constrained-element-set: + type: array + items: + $ref: "#/patchDefinitions/constrained-element-set" + ctag-assignment: + description: | + ###### Related Nodes + - TO l3-network( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY) + required: + - vlan-id-inner + properties: + vlan-id-inner: + type: integer + format: int64 + description: id. + ctag-assignments: + properties: + ctag-assignment: + type: array + items: + $ref: "#/patchDefinitions/ctag-assignment" + ctag-pool: + description: | + A collection of C tags (vlan tags) grouped for a specific purpose. + ###### Related Nodes + - TO complex( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE) + - TO availability-zone( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + required: + - target-pe + - availability-zone-name + - ctag-pool-purpose + properties: + target-pe: type: string - element-choice-sets: + description: The Target provider edge router + availability-zone-name: + type: string + description: Name of the availability zone + ctag-pool-purpose: + type: string + description: Describes what the intended purpose of this pool is. + ctag-values: + type: string + description: Comma separated list of ctags + ctag-pools: + properties: + ctag-pool: type: array - items: - $ref: "#/definitions/element-choice-set" - relationship-list: + items: + $ref: "#/patchDefinitions/ctag-pool" + customer: + description: | + customer identifiers to provide linkage back to BSS information. + ###### Related Nodes + - FROM service-subscription( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE) + - CUSTOMER is DELETED when these are DELETED SERVICE-SUBSCRIPTION + required: + - global-customer-id + - subscriber-name + - subscriber-type + properties: + global-customer-id: + type: string + description: Global customer id used across ECOMP to uniquely identify customer. + subscriber-name: + type: string + description: Subscriber name, an alternate way to retrieve a customer. + subscriber-type: + type: string + description: Subscriber type, a way to provide VID with only the INFRA customers. + customers: + description: | + Collection of customer identifiers to provide linkage back to BSS information. + properties: + customer: + type: array + items: + $ref: "#/patchDefinitions/customer" + cvlan-tag-entry: + required: + - cvlan-tag + properties: + cvlan-tag: + type: integer + format: int64 + description: See mis-na-virtualization-platform.yang + cvlan-tags: + properties: + cvlan-tag-entry: + type: array + items: + $ref: "#/patchDefinitions/cvlan-tag-entry" + dvs-switch: + description: | + Digital virtual switch metadata, used by SDN-C to configure VCEs. A&AI needs to receive this data from the PO deployment team and administer it using the provisioningTool.sh into A&AI. + ###### Related Nodes + - TO cloud-region( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO availability-zone( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + required: + - switch-name + - vcenter-url + properties: + switch-name: + type: string + description: DVS switch name + vcenter-url: + type: string + description: URL used to reach the vcenter + dvs-switches: + description: | + Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs. + properties: + dvs-switch: + type: array + items: + $ref: "#/patchDefinitions/dvs-switch" + edge-prop-names: + description: | + Internal map to define the properties of an edge and interpret the map EdgeRules + properties: + edgeLabel: + type: string + direction: + type: string + multiplicityRule: + type: string + contains-other-v: + type: string + delete-other-v: + type: string + SVC-INFRA: + type: string + prevent-delete: + type: string + edge-tag-query-request: + properties: + edge-tag: + type: string + result-detail: + type: string + start-node-type: + type: string + start-node-filter: + type: array + items: + $ref: "#/patchDefinitions/start-node-filter" + include-node-filter: + type: array + items: + $ref: "#/patchDefinitions/include-node-filter" + secondary-filter: + type: array + items: + $ref: "#/patchDefinitions/secondary-filter" + edge-tag-query-result: + properties: + tagged-inventory-item-list: + type: array + items: + $ref: "#/patchDefinitions/tagged-inventory-item-list" + element-choice-set: + description: | + This is how we would capture constraints defining allowed sets of elements. + ###### Related Nodes + - TO constrained-element-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE) + - ELEMENT-CHOICE-SET is DELETED when these are DELETED MODEL-ELEMENT + required: + - element-choice-set-uuid + - element-choice-set-name + properties: + element-choice-set-uuid: + type: string + element-choice-set-name: + type: string + cardinality: + type: string + element-choice-sets: + properties: + element-choice-set: + type: array + items: + $ref: "#/patchDefinitions/element-choice-set" + entitlement: + description: | + Metadata for entitlement group. + ###### Related Nodes + - TO generic-vnf( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO vce( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + required: + - group-uuid + - resource-uuid + properties: + group-uuid: + type: string + description: Unique ID for the entitlement group the resource comes from, should be uuid. + resource-uuid: + type: string + description: Unique ID of an entitlement resource. + entitlements: + description: | + Entitlements, keyed by group-uuid and resource-uuid, related to license management + properties: + entitlement: + type: array + items: + $ref: "#/patchDefinitions/entitlement" + esr-ems: + description: | + Persist EMS address information used by EMS driver. + ###### Related Nodes + - TO esr-system-info (CHILD of esr-ems, esr-ems has esr-system-info, One2Many) + - ESR-EMS deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO + required: + - ems-id + properties: + ems-id: + type: string + description: Unique ID of EMS. + esr-ems-list: + properties: + esr-ems: + type: array + items: + $ref: "#/patchDefinitions/esr-ems" + esr-system-info: + description: | + Persist common address information of external systems. + ###### Related Nodes + - FROM esr-ems (PARENT of esr-system-info, esr-ems has esr-system-info) + - FROM esr-vnfm (PARENT of esr-system-info, esr-vnfm has esr-system-info) + - FROM esr-thirdparty-sdnc (PARENT of esr-system-info, esr-thirdparty-sdnc has esr-system-info) + - FROM cloud-region (PARENT of esr-system-info, cloud-region has esr-system-info) + required: + - esr-system-info-id + - user-name + - password + - system-type + properties: + esr-system-info-id: + type: string + description: Unique ID of esr system info. + system-name: + type: string + description: name of external system. + type: + type: string + description: type of external systems. + vendor: + type: string + description: vendor of external systems. + version: + type: string + description: version of external systems. + service-url: + type: string + description: url used to access external systems. + user-name: + type: string + description: username used to access external systems. + password: + type: string + description: password used to access external systems. + system-type: + type: string + description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm. + protocol: + type: string + description: protocol of third party SDNC, for example netconf/snmp. + ssl-cacert: + type: string + description: ca file content if enabled ssl on auth-url. + ssl-insecure: + type: boolean + description: Whether to verify VIM's certificate. + ip-address: + type: string + description: service IP of ftp server. + port: + type: string + description: service port of ftp server. + cloud-domain: + type: string + description: domain info for authentication. + default-tenant: + type: string + description: default tenant of VIM. + passive: + type: boolean + description: ftp passive mode or not. + remote-path: + type: string + description: resource or performance data file path. + system-status: + type: string + description: the status of external system. + esr-system-info-list: + description: | + Collection of persistent block-level external system auth info. + properties: + esr-system-info: + type: array + items: + $ref: "#/patchDefinitions/esr-system-info" + esr-thirdparty-sdnc: + description: | + Persist SDNC address information used by ONAP SDNC. + ###### Related Nodes + - TO esr-system-info (CHILD of esr-thirdparty-sdnc, esr-thirdparty-sdnc has esr-system-info, One2One) + - TO pnf( esr-thirdparty-sdnc has pnf, One2Many) + - ESR-THIRDPARTY-SDNC deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO + required: + - thirdparty-sdnc-id + properties: + thirdparty-sdnc-id: + type: string + description: Unique ID of SDNC. + location: + type: string + description: used for DC type to indicate the location of SDNC, such as Core or Edge. + product-name: + type: string + description: password used to access SDNC server. + esr-thirdparty-sdnc-list: + properties: + esr-thirdparty-sdnc: + type: array + items: + $ref: "#/patchDefinitions/esr-thirdparty-sdnc" + esr-vnfm: + description: | + Persist VNFM address information used by VF-C. + ###### Related Nodes + - TO esr-system-info (CHILD of esr-vnfm, esr-vnfm has esr-system-info, One2One) + - ESR-VNFM deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO + required: + - vnfm-id + properties: + vnfm-id: + type: string + description: Unique ID of VNFM. + vim-id: + type: string + description: indecate the VIM to deploy VNF. + certificate-url: + type: string + description: certificate url of VNFM. + esr-vnfm-list: + properties: + esr-vnfm: + type: array + items: + $ref: "#/patchDefinitions/esr-vnfm" + evc: + description: | + evc object is an optional child object of the Configuration object. + ###### Related Nodes + - TO configuration( evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE) + required: + - evc-id + properties: + evc-id: + type: string + description: Unique/key field for the evc object + forwarding-path-topology: + type: string + description: Point-to-Point, Multi-Point + cir-value: + type: string + description: Commited Information Rate + cir-units: + type: string + description: CIR units + connection-diversity-group-id: + type: string + description: Diversity Group ID + service-hours: + type: string + description: formerly Performance Group + esp-evc-circuit-id: + type: string + description: EVC Circuit ID of ESP EVC + esp-evc-cir-value: + type: string + description: Committed Information Rate (For ESP) + esp-evc-cir-units: + type: string + description: CIR units (For ESP) + esp-itu-code: + type: string + description: Identifies ESP + collector-pop-clli: + type: string + description: Collector POP CLLI (from the hostname of the access pnf) + inter-connect-type-ingress: + type: string + description: Interconnect type on ingress side of EVC. + tagmode-access-ingress: + type: string + description: tagode for collector side of EVC + tagmode-access-egress: + type: string + description: tagMode for network side of EVC + evcs: + properties: + evc: + type: array + items: + $ref: "#/patchDefinitions/evc" + external-system: + description: | + Namespace for external system. + properties: + esr-ems-list: + type: object + $ref: "#/patchDefinitions/esr-ems-list" + esr-vnfm-list: + type: object + $ref: "#/patchDefinitions/esr-vnfm-list" + esr-thirdparty-sdnc-list: + type: object + $ref: "#/patchDefinitions/esr-thirdparty-sdnc-list" + extra-properties: + description: | + Extra properties for inventory item for response list + properties: + extra-property: + type: array + items: + $ref: "#/patchDefinitions/extra-property" + extra-property: + properties: + property-name: + type: string + property-value: + type: string + flavor: + description: | + Openstack flavor. + ###### Related Nodes + - TO cloud-region( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vserver( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE) + - FLAVOR cannot be deleted if linked to VSERVER + required: + - flavor-id + - flavor-name + - flavor-selflink + properties: + flavor-id: + type: string + description: Flavor id, expected to be unique across cloud-region. + flavor-name: + type: string + description: Flavor name + flavor-vcpus: + type: integer + format: int32 + description: Number of CPUs + flavor-ram: + type: integer + format: int32 + description: Amount of memory + flavor-disk: + type: integer + format: int32 + description: Disk space + flavor-ephemeral: + type: integer + format: int32 + description: Amount of ephemeral disk space + flavor-swap: + type: string + description: amount of swap space allocation + flavor-is-public: + type: boolean + description: whether flavor is available to all users or private to the tenant it was created in. + flavor-selflink: + type: string + description: URL to endpoint where AAI can get more details + flavor-disabled: + type: boolean + description: Boolean as to whether this flavor is no longer enabled + flavors: + description: | + Collection of openstack flavors. + properties: + flavor: + type: array + items: + $ref: "#/patchDefinitions/flavor" + forwarder: + description: | + Entity describing a sequenced segment of forwarding path + ###### Related Nodes + - TO forwarding-path( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE) + - TO l-interface( forwarder org.onap.relationships.inventory.ForwardsTo l-interface, MANY2ONE) + - TO configuration( forwarder org.onap.relationships.inventory.Uses configuration, ONE2ONE) + - TO lag-interface( forwarder org.onap.relationships.inventory.ForwardsTo lag-interface, MANY2ONE) + - TO p-interface( forwarder org.onap.relationships.inventory.ForwardsTo p-interface, MANY2ONE) + - FORWARDER deletion means associated objects of these types are also DELETED:CONFIGURATION + required: + - sequence + properties: + sequence: + type: integer + format: int32 + description: Unique ID of this segmentation + forwarder-role: + type: string + description: ingress, intermediate, egress + forwarder-evc: + description: | + forwarder object is an optional child object of the Configuration object. + ###### Related Nodes + - TO configuration( forwarder-evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE) + required: + - forwarder-evc-id + properties: + forwarder-evc-id: + type: string + description: Key for forwarder-evc object + circuit-id: + type: string + description: Circuit ID from customer/ESP/ingress end of EVC, or reference to beater circuit on gateway/network/egress end of EVC + ivlan: + type: string + description: Internal VLAN. + svlan: + type: string + description: SVLAN value for ingress of egress forwarder. + cvlan: + type: string + description: CVLAN value for ingress of egress forwarder. + forwarder-evcs: + properties: + forwarder-evc: + type: array + items: + $ref: "#/patchDefinitions/forwarder-evc" + forwarders: + properties: + forwarder: + type: array + items: + $ref: "#/patchDefinitions/forwarder" + forwarding-path: + description: | + Entity that describes the sequenced forwarding path between interfaces of services or resources + ###### Related Nodes + - TO service-instance( forwarding-path org.onap.relationships.inventory.AppliesTo service-instance, MANY2ONE) + - TO configuration( forwarding-path org.onap.relationships.inventory.Uses configuration, ONE2ONE) + - FROM forwarder( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE) + - FORWARDING-PATH is DELETED when these are DELETED FORWARDER + - FORWARDING-PATH deletion means associated objects of these types are also DELETED:CONFIGURATION + required: + - forwarding-path-id + - forwarding-path-name + properties: + forwarding-path-id: + type: string + description: Unique ID of this FP + forwarding-path-name: + type: string + description: Name of the FP + forwarding-paths: + properties: + forwarding-path: + type: array + items: + $ref: "#/patchDefinitions/forwarding-path" + generic-vnf: + description: | + General purpose VNF + ###### Related Nodes + - TO availability-zone( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - TO complex( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - TO configuration( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - TO ctag-pool( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + - TO instance-group( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO ipsec-configuration( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE) + - TO l3-network( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - TO license-key-resource( generic-vnf org.onap.relationships.inventory.Uses license-key-resource, MANY2MANY) + - TO pnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY) + - TO pserver( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY) + - TO vnf-image( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE) + - TO volume-group( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + - TO vserver( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY) + - TO virtual-data-center( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY) + - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM vnfc( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM lag-interface( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM license( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM network-profile( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY) + - FROM site-pair-set( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM line-of-business( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY) + - FROM platform( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + - GENERIC-VNF is DELETED when these are DELETED ENTITLEMENT,VNFC,LAG-INTERFACE,LICENSE,L-INTERFACE,VF-MODULE + - GENERIC-VNF deletion means associated objects of these types are also DELETED:CONFIGURATION + required: + - vnf-id + - vnf-instance-id + - vnf-name + - vnf-type + - vnf-package-name + - vnf-discriptor-name + - job-id + - in-maint + - is-closed-loop-disabled + properties: + vnf-id: + type: string + description: Unique id of VNF. This is unique across the graph. + vnf-instance-id: + type: string + description: vnf instance id. + vnf-name: + type: string + description: Name of VNF. + vnf-name2: + type: string + description: Alternate name of VNF. + vnf-type: + type: string + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + service-id: + type: string + description: Unique identifier of service, does not necessarily map to ASDC service models. SOON TO BE DEPRECATED + regional-resource-zone: + type: string + description: Regional way of organizing pservers, source of truth should define values + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + operational-status: + type: string + description: Indicator for whether the resource is considered operational. Valid values are in-service-path and out-of-service-path. + license-key: + type: string + description: OBSOLETE - do not use + equipment-role: + type: string + description: Client should send valid enumerated value + orchestration-status: + type: string + description: Orchestration status of this VNF, used by MSO. + vnf-package-name: + type: string + vnf-discriptor-name: + type: string + description: vnf discriptor name + job-id: + type: string + description: job id corresponding to vnf + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance, managed by MSO + mso-catalog-key: + type: string + description: Corresponds to the SDN-C catalog id used to configure this VCE + management-option: + type: string + description: identifier of managed by ATT or customer + ipv4-oam-address: + type: string + description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by generic-vnf. + ipv4-loopback0-address: + type: string + description: v4 Loopback0 address + nm-lan-v6-address: + type: string + description: v6 Loopback address + management-v6-address: + type: string + description: v6 management address + vcpu: + type: integer + format: int64 + description: number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE + vcpu-units: + type: string + description: units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE + vmemory: + type: integer + format: int64 + description: number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE + vmemory-units: + type: string + description: units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE + vdisk: + type: integer + format: int64 + description: number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE + vdisk-units: + type: string + description: units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE + nshd: + type: integer + format: int64 + description: number of associated SHD in vnf. + nvm: + type: integer + format: int64 + description: number of vms in vnf. + nnet: + type: integer + format: int64 + description: number of network in vnf. + in-maint: + type: boolean + is-closed-loop-disabled: + type: boolean + generic-vnfs: + description: | + Collection of VNFs + properties: + generic-vnf: + type: array + items: + $ref: "#/patchDefinitions/generic-vnf" + group-assignment: + description: | + Openstack group-assignment used to store exclusivity groups (EG). + ###### Related Nodes + - TO cloud-region( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM pserver( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY) + required: + - group-id + - group-type + - group-name + properties: + group-id: + type: string + description: Group id, expected to be unique across cloud-region. + group-type: + type: string + description: Group type - the type of group this instance refers to + group-name: + type: string + description: Group name - name assigned to the group + group-description: + type: string + description: Group description - description of the group + group-assignments: + description: | + Collection of openstack group assignments + properties: + group-assignment: + type: array + items: + $ref: "#/patchDefinitions/group-assignment" + host-route: + description: | + ###### Related Nodes + - TO subnet( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE) + required: + - host-route-id + - route-prefix + - next-hop + properties: + host-route-id: + type: string + description: host-route id + route-prefix: + type: string + description: subnet prefix + next-hop: + type: string + description: Could be ip-address, hostname, or service-instance + next-hop-type: + type: string + description: Should be ip-address, hostname, or service-instance to match next-hop + host-routes: + properties: + host-route: + type: array + items: + $ref: "#/patchDefinitions/host-route" + image: + description: | + Openstack image. + ###### Related Nodes + - TO cloud-region( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE) + - FROM vserver( vserver org.onap.relationships.inventory.Uses image, MANY2ONE) + - IMAGE cannot be deleted if linked to VSERVER + - IMAGE is DELETED when these are DELETED METADATUM + required: + - image-id + - image-name + - image-os-distro + - image-os-version + - image-selflink + properties: + image-id: + type: string + description: Image id, expected to be unique across cloud region + image-name: + type: string + description: Image name + image-architecture: + type: string + description: Operating system architecture. + image-os-distro: + type: string + description: The common name of the operating system distribution in lowercase + image-os-version: + type: string + description: The operating system version as specified by the distributor. + application: + type: string + description: The application that the image instantiates. + application-vendor: + type: string + description: The vendor of the application. + application-version: + type: string + description: The version of the application. + image-selflink: + type: string + description: URL to endpoint where AAI can get more details + images: + description: | + Collectio of Openstack images. + properties: + image: + type: array + items: + $ref: "#/patchDefinitions/image" + include-node-filter: + properties: + include-node-type: + type: string + instance-filter: + description: | + InstanceFilter for performing a named-query or model query + instance-filters: + description: | + InstanceFilters for performing a named-query or model query + properties: + instance-filter: + type: array + items: + $ref: "#/patchDefinitions/instance-filter" + instance-group: + description: | + General mechanism for grouping instances + ###### Related Nodes + - TO model( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - FROM l3-network( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM l-interface( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM pnf( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM vnfc( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + required: + - instance-group-role + - model-invariant-id + - model-version-id + - id + - description + - type + properties: + instance-group-role: + type: string + description: role of the instance group. + model-invariant-id: + type: string + description: ASDC model id for this resource or service model. + model-version-id: + type: string + description: ASDC model version uid for this resource model. + id: + type: string + description: Instance Group ID, UUID assigned to this instance. + description: + type: string + description: Descriptive text to help identify the usage of this instance-group + type: + type: string + description: Only valid value today is lower case ha for high availability + sub-type: + type: string + description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby] + instance-groups: + description: | + Collection of openstack route table references + properties: + instance-group: + type: array + items: + $ref: "#/patchDefinitions/instance-group" + inventory: + properties: + search: + type: object + $ref: "#/patchDefinitions/search" + actions: + type: object + $ref: "#/patchDefinitions/actions" + cloud-infrastructure: + type: object + $ref: "#/patchDefinitions/cloud-infrastructure" + external-system: + type: object + $ref: "#/patchDefinitions/external-system" + business: + type: object + $ref: "#/patchDefinitions/business" + service-design-and-creation: + type: object + $ref: "#/patchDefinitions/service-design-and-creation" + network: + type: object + $ref: "#/patchDefinitions/network" + aai-internal: + type: object + $ref: "#/patchDefinitions/aai-internal" + nodes: type: array items: - $ref: "#/definitions/relationship" - constrained-element-sets: + $ref: "#/patchDefinitions/aai-internal" + inventory-item: properties: - constrained-element-set: + inventory-item-type: + type: string + inventory-item-link: + type: string + inventory-item-data: type: array items: - $ref: "#/definitions/constrained-element-set" + $ref: "#/patchDefinitions/inventory-item-data" + tagged-inventory-item-list: + type: array + items: + $ref: "#/patchDefinitions/tagged-inventory-item-list" + inventory-item-data: + properties: + property-name: + type: string + property-value: + type: string + inventory-response-item: + description: | + Inventory item for response list + properties: + model-name: + type: string + extra-properties: + type: object + $ref: "#/patchDefinitions/extra-properties" + inventory-response-items: + type: object + $ref: "#/patchDefinitions/inventory-response-items" + inventory-response-items: + description: | + Container for inventory items in response list + properties: + inventory-response-item: + type: array + items: + $ref: "#/patchDefinitions/inventory-response-item" + ipsec-configuration: + description: | + IPSec configuration node will contain various configuration data for the NMTE VNF. This node will have an edge to the generic-vnf (vnf type = TE). Starting 1607, this data will be populated by SDN-C + ###### Related Nodes + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE) + - FROM vig-server( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE) + - IPSEC-CONFIGURATION is DELETED when these are DELETED VIG-SERVER + required: + - ipsec-configuration-id + properties: + ipsec-configuration-id: + type: string + description: UUID of this configuration + requested-vig-address-type: + type: string + description: Indicate the type of VIG server like AVPN, INTERNET, BOTH + requested-encryption-strength: + type: string + description: Encryption values like 3des-cbc, des-cbc, aes-128-cbc, aes-192-cbc, aes-265-cbc + requested-dmz-type: + type: string + description: ATT can offer a shared DMZ or a DMZ specific to a customer + shared-dmz-network-address: + type: string + description: Network address of shared DMZ + requested-customer-name: + type: string + description: If the DMZ is a custom DMZ, this field will indicate the customer information + ike-version: + type: string + description: can be 1 or 2 + ikev1-authentication: + type: string + description: Contains values like md5, sha1, sha256, sha384 + ikev1-encryption: + type: string + description: Encyption values like 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc + ikev1-dh-group: + type: string + description: Diffie-Hellman group like DH-GROUP2, DH-GROUP5, DH-GROUP14 + ikev1-am-group-id: + type: string + description: Group name defined in VIG for clients using aggressive mode + ikev1-am-password: + type: string + description: pre-shared key for the above group name + ikev1-sa-lifetime: + type: string + description: Lifetime for IKEv1 SA + ipsec-authentication: + type: string + description: md5, sha1, sha256, sha384 + ipsec-encryption: + type: string + description: 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc + ipsec-sa-lifetime: + type: string + description: Life time for IPSec SA + ipsec-pfs: + type: string + description: enable PFS or not + xauth-userid: + type: string + description: user ID for xAuth, sm-user,ucpeHostName,nmteHostName + xauth-user-password: + type: string + description: Encrypted using the Juniper $9$ algorithm + dpd-interval: + type: string + description: The time between DPD probe + dpd-frequency: + type: string + description: Maximum number of DPD before claiming the tunnel is down + ipsec-configurations: + properties: + ipsec-configuration: + type: array + items: + $ref: "#/patchDefinitions/ipsec-configuration" + key-data: + properties: + key-name: + type: string + key-value: + type: string + l-interface: + description: | + Logical interfaces, e.g., a vnic. + ###### Related Nodes + - TO generic-vnf( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO lag-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE) + - TO instance-group( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - TO logical-link( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY) + - TO newvce( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE) + - TO p-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE) + - TO vserver( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE) + - FROM vlan( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - L-INTERFACE is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,SRIOV-VF,VLAN + - L-INTERFACE deletion means associated objects of these types are also DELETED:LOGICAL-LINK + required: + - interface-name + - is-port-mirrored + - in-maint + - is-ip-unnumbered + properties: + interface-name: + type: string + description: Name given to the interface + interface-role: + type: string + description: E.g., CUSTOMER, UPLINK, etc. + v6-wan-link-ip: + type: string + description: Questionably placed - v6 ip addr of this interface (is in vr-lan-interface from Mary B. + selflink: + type: string + description: URL to endpoint where AAI can get more details + interface-id: + type: string + description: ID of interface + macaddr: + type: string + description: MAC address for the interface + network-name: + type: string + description: Name of the network + management-option: + type: string + description: Whether A&AI should be managing this interface of not. Could have value like CUSTOMER + interface-description: + type: string + description: Human friendly text regarding this interface. + is-port-mirrored: + type: boolean + l-interfaces: + description: | + Collection of logical interfaces. + properties: + l-interface: + type: array + items: + $ref: "#/patchDefinitions/l-interface" + l3-interface-ipv4-address-list: + description: | + IPv4 Address Range + ###### Related Nodes + - TO instance-group( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - TO l3-network( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - TO subnet( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - TO l-interface( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - TO vlan( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - TO vnfc( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + required: + - l3-interface-ipv4-address + properties: + l3-interface-ipv4-address: + type: string + description: IP address + l3-interface-ipv4-prefix-length: + type: integer + format: int64 + description: Prefix length, 32 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + l3-interface-ipv6-address-list: + description: | + IPv6 Address Range + ###### Related Nodes + - TO instance-group( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - TO l3-network( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - TO subnet( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - TO l-interface( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - TO vlan( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - TO vnfc( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + required: + - l3-interface-ipv6-address + properties: + l3-interface-ipv6-address: + type: string + description: IP address + l3-interface-ipv6-prefix-length: + type: integer + format: int64 + description: Prefix length, 128 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + l3-network: + description: | + Generic network definition + ###### Related Nodes + - TO instance-group( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO network-policy( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY) + - TO route-table-reference( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY) + - TO vpn-binding( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY) + - FROM cloud-region( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM complex( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - FROM ctag-assignment( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM segmentation-assignment( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY) + - FROM subnet( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY) + - L3-NETWORK is DELETED when these are DELETED CTAG-ASSIGNMENT,SEGMENTATION-ASSIGNMENT,SUBNET + required: + - network-id + - network-name + - is-bound-to-vpn + - is-provider-network + - is-shared-network + - is-external-network + properties: + network-id: + type: string + description: Network ID, should be uuid. Unique across A&AI. + network-name: + type: string + description: Name of the network, governed by some naming convention.. + network-type: + type: string + description: Type of the network - who defines these values? + network-role: + type: string + description: Role the network plans - who defines these values? + network-technology: + type: string + description: Network technology - who defines these values? + neutron-network-id: + type: string + description: Neutron network id of this Interface + is-bound-to-vpn: + type: boolean + service-id: + type: string + description: Unique identifier of service from ASDC. Does not strictly map to ASDC services. SOON TO BE DEPRECATED + network-role-instance: + type: integer + format: int64 + description: network role instance + l3-networks: + properties: + l3-network: + type: array + items: + $ref: "#/patchDefinitions/l3-network" + lag-interface: + description: | + Link aggregate interface + ###### Related Nodes + - TO generic-vnf( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO lag-link( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY) + - TO logical-link( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - TO p-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY) + - TO pnf( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - TO pserver( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - TO vpls-pe( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE) + - LAG-INTERFACE is DELETED when these are DELETED L-INTERFACE + - LAG-INTERFACE deletion means associated objects of these types are also DELETED:LAG-LINK,LOGICAL-LINK + required: + - interface-name + - in-maint + properties: + interface-name: + type: string + description: Name that identifies the link aggregate interface + interface-description: + type: string + description: Human friendly text regarding this interface. + lag-interfaces: + description: | + Collection of link aggregate interfaces. + properties: + lag-interface: + type: array + items: + $ref: "#/patchDefinitions/lag-interface" + lag-link: + description: | + LAG links can connect lag-interfaces + ###### Related Nodes + - FROM lag-interface( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY) + required: + - link-name + properties: + link-name: + type: string + description: Alphabetical concatenation of lag-interface names + lag-links: + description: | + Collection of link aggregation connections + properties: + lag-link: + type: array + items: + $ref: "#/patchDefinitions/lag-link" + license: + description: | + Metadata for license group. + ###### Related Nodes + - TO generic-vnf( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO vce( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + required: + - group-uuid + - resource-uuid + properties: + group-uuid: + type: string + description: Unique ID for the license group the resource belongs to, should be uuid. + resource-uuid: + type: string + description: Unique ID of a license resource. + licenses: + description: | + Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management + properties: + license: + type: array + items: + $ref: "#/patchDefinitions/license" + line-of-business: + description: | + describes a line-of-business + ###### Related Nodes + - TO generic-vnf( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + required: + - line-of-business-name + properties: + line-of-business-name: + type: string + description: Name of the line-of-business (product) + lines-of-business: + description: | + Collection of lines-of-business + properties: + line-of-business: + type: array + items: + $ref: "#/patchDefinitions/line-of-business" + logical-link: + description: | + Logical links generally connect l-interfaces but are used to express logical connectivity between two points + ###### Related Nodes + - TO cloud-region( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY) + - TO generic-vnf( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY) + - TO lag-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY) + - TO logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - TO pnf( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY) + - TO pserver( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY) + - TO vpn-binding( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - TO virtual-data-center( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM configuration( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - FROM l-interface( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY) + - FROM p-interface( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - FROM vlan( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + required: + - link-name + - in-maint + - link-type + properties: + link-name: + type: string + description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ + in-maint: + type: boolean + link-type: + type: string + description: Type of logical link, e.g., evc + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + ip-version: + type: string + description: v4, v6, or ds for dual stack + routing-protocol: + type: string + description: For example, static or BGP + logical-links: + description: | + Collection of logical connections + properties: + logical-link: + type: array + items: + $ref: "#/patchDefinitions/logical-link" + metadata: + description: | + Collection of metadatum (key/value pairs) + properties: + metadatum: + type: array + items: + $ref: "#/patchDefinitions/metadatum" + metadatum: + description: | + Key/value pairs + ###### Related Nodes + - TO configuration( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE) + - TO connector( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE) + - TO image( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE) + - TO service-instance( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - TO model-ver( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + required: + - metaname + - metaval + properties: + metaname: + type: string + metaval: + type: string + model: + description: | + Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version + ###### Related Nodes + - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE) + - FROM instance-group( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY) + - FROM model-ver( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE) + - FROM named-query( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY) + - FROM named-query-element( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE) + - MODEL cannot be deleted if linked to INSTANCE-GROUP,NAMED-QUERY,NAMED-QUERY-ELEMENT + - MODEL is DELETED when these are DELETED MODEL-VER + required: + - model-invariant-id + - model-type + properties: + model-invariant-id: + type: string + description: Unique identifier corresponding to the main definition of a model in ASDC + model-type: + type: string + description: Type of the model, e.g., service, resource, widget, etc. + model-and-named-query-search: + description: | + ModelAndNamedQuerySearch holds query-parameters and instance-properties for performing a named-query or model query + properties: + query-parameters: + type: object + $ref: "#/patchDefinitions/query-parameters" + instance-filters: + type: object + $ref: "#/patchDefinitions/instance-filters" + secondary-filts: + type: object + $ref: "#/patchDefinitions/secondary-filts" + top-node-type: + type: string + secondary-filter-cut-point: + type: string model-constraint: description: | This is how we would capture constraints defining allowed sets of elements. ###### Related Nodes - - TO constrained-element-set (comprises model-constraint, One2Many) - - FROM model-element (is composed of model-constraint) + - TO model-element( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE) + - MODEL-CONSTRAINT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET required: - model-constraint-uuid - constrained-element-set-uuid-to-replace @@ -44055,27 +59798,25 @@ definitions: constrained-element-sets: type: array items: - $ref: "#/definitions/constrained-element-set" - resource-version: - type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + $ref: "#/patchDefinitions/constrained-element-set" model-constraints: properties: model-constraint: type: array items: - $ref: "#/definitions/model-constraint" + $ref: "#/patchDefinitions/model-constraint" model-element: description: | Defines how other models combine to make up a higher-level model. ###### Related Nodes - - TO model-ver (Many2One) - - TO model-element (comprises model-element, One2Many) - - TO model-constraint (comprises model-element, One2Many) - - TO constrained-element-set (comprises model-element, One2Many) - - FROM model-ver (is composed of model-element) - - FROM element-choice-set (is composed of model-element) - - FROM model-element (is composed of model-element) + - TO element-choice-set( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE) + - TO model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - TO model-ver( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE) + - TO model-ver( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM model-constraint( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - MODEL-ELEMENT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET,MODEL-CONSTRAINT required: - model-element-uuid - new-data-del-flag @@ -44091,37 +59832,22 @@ definitions: description: How many of this type of element are required/allowed linkage-points: type: string - resource-version: - type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - model-elements: - type: array - items: - $ref: "#/definitions/model-element" - description: Defines how other models combine to make up a higher-level model - model-constraints: - type: array - items: - $ref: "#/definitions/model-constraint" - description: Describes new constraints on this model element that are not part of that model's definition - relationship-list: - type: array - items: - $ref: "#/definitions/relationship" model-elements: properties: model-element: type: array items: - $ref: "#/definitions/model-element" + $ref: "#/patchDefinitions/model-element" model-ver: description: | Subgraph definition provided by ASDC to describe a specific version of an inventory asset and its connections related to ASDC models ###### Related Nodes - - TO model-element (comprises model-ver, One2Many) - - TO metadatum (comprises model-ver, One2Many) - - FROM model (is composed of model-ver) - - FROM model-element + - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + - MODEL-VER cannot be deleted if linked to MODEL-ELEMENT + - MODEL-VER is DELETED when these are DELETED MODEL-ELEMENT,METADATUM required: - model-version-id - model-name @@ -44139,105 +59865,719 @@ definitions: model-description: type: string description: Description - resource-version: + model-vers: + properties: + model-ver: + type: array + items: + $ref: "#/patchDefinitions/model-ver" + models: + description: | + Collection of subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models + properties: + model: + type: array + items: + $ref: "#/patchDefinitions/model" + multicast-configuration: + description: | + ###### Related Nodes + - FROM vlan( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY) + required: + - multicast-configuration-id + - multicast-protocol + - rp-type + properties: + multicast-configuration-id: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - model-elements: + description: Unique id of multicast configuration. + multicast-protocol: + type: string + description: protocol of multicast configuration + rp-type: + type: string + description: rp type of multicast configuration + multicast-configurations: + description: | + multicast configuration of generic-vnf ip-address + properties: + multicast-configuration: + type: array + items: + $ref: "#/patchDefinitions/multicast-configuration" + named-queries: + properties: + named-query: + type: array + items: + $ref: "#/patchDefinitions/named-query" + named-query: + description: | + TBD + ###### Related Nodes + - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE) + - TO model( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY) + - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE) + - NAMED-QUERY is DELETED when these are DELETED NAMED-QUERY-ELEMENT + required: + - named-query-uuid + - named-query-name + - named-query-version + properties: + named-query-uuid: + type: string + named-query-name: + type: string + named-query-version: + type: string + required-input-param: + type: string + description: + type: string + named-query-element: + description: | + TBD + ###### Related Nodes + - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE) + - TO model( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE) + - TO named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - FROM property-constraint( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - FROM related-lookup( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - NAMED-QUERY-ELEMENT is DELETED when these are DELETED PROPERTY-CONSTRAINT,RELATED-LOOKUP + required: + - named-query-element-uuid + properties: + named-query-element-uuid: + type: string + property-collect-list: + type: string + named-query-elements: + properties: + named-query-element: + type: array + items: + $ref: "#/patchDefinitions/named-query-element" + network: + description: | + Namespace for network inventory resources. + properties: + logical-links: type: array items: - $ref: "#/definitions/model-element" - metadata: + $ref: "#/patchDefinitions/logical-link" + site-pair-sets: type: array items: - $ref: "#/definitions/metadatum" - relationship-list: + $ref: "#/patchDefinitions/site-pair-set" + vpn-bindings: type: array items: - $ref: "#/definitions/relationship" - model-vers: + $ref: "#/patchDefinitions/vpn-binding" + vpls-pes: + type: array + items: + $ref: "#/patchDefinitions/vpls-pe" + multicast-configurations: + type: array + items: + $ref: "#/patchDefinitions/multicast-configuration" + vces: + type: array + items: + $ref: "#/patchDefinitions/vce" + vnfcs: + type: array + items: + $ref: "#/patchDefinitions/vnfc" + l3-networks: + type: array + items: + $ref: "#/patchDefinitions/l3-network" + network-policies: + type: array + items: + $ref: "#/patchDefinitions/network-policy" + generic-vnfs: + type: array + items: + $ref: "#/patchDefinitions/generic-vnf" + lag-links: + type: array + items: + $ref: "#/patchDefinitions/lag-link" + newvces: + type: array + items: + $ref: "#/patchDefinitions/newvce" + pnfs: + type: array + items: + $ref: "#/patchDefinitions/pnf" + physical-links: + type: array + items: + $ref: "#/patchDefinitions/physical-link" + ipsec-configurations: + type: array + items: + $ref: "#/patchDefinitions/ipsec-configuration" + route-table-references: + type: array + items: + $ref: "#/patchDefinitions/route-table-reference" + instance-groups: + type: array + items: + $ref: "#/patchDefinitions/instance-group" + zones: + type: array + items: + $ref: "#/patchDefinitions/zone" + configurations: + type: array + items: + $ref: "#/patchDefinitions/configurations" + network-policies: properties: - model-ver: + network-policy: type: array items: - $ref: "#/definitions/model-ver" - model: + $ref: "#/patchDefinitions/network-policy" + network-policy: description: | - Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version ###### Related Nodes - - TO model-ver (comprises model, One2Many) - - FROM named-query - - FROM named-query-element - - FROM instance-group + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE) + - FROM l3-network( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY) + required: + - network-policy-id + properties: + network-policy-id: + type: string + description: UUID representing unique key to this instance + network-policy-fqdn: + type: string + description: Contrail FQDN for the policy + heat-stack-id: + type: string + description: ID for the openStack Heat instance + network-profile: + description: | + Network profile populated by SDN-GP for SNMP + ###### Related Nodes + - TO generic-vnf( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + required: + - nm-profile-name + properties: + nm-profile-name: + type: string + description: Unique name of network profile. + community-string: + type: string + description: Encrypted SNMP community string + network-profiles: + description: | + Collection of network profiles + properties: + network-profile: + type: array + items: + $ref: "#/patchDefinitions/network-profile" + newvce: + description: | + This object fills in the gaps from vce that were incorporated into generic-vnf. This object will be retired with vce. + ###### Related Nodes + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE) + - NEWVCE is DELETED when these are DELETED L-INTERFACE + required: + - vnf-id2 + - vnf-name + - vnf-type + properties: + vnf-id2: + type: string + description: Unique id of VNF, can't use same attribute name right now until we promote this new object + vnf-name: + type: string + description: Name of VNF. + vnf-name2: + type: string + description: Alternate name of VNF. + vnf-type: + type: string + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + prov-status: + type: string + description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. + operational-status: + type: string + description: Indicator for whether the resource is considered operational + license-key: + type: string + description: OBSOLETE - do not use + ipv4-oam-address: + type: string + description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address). + equipment-role: + type: string + description: Client should send valid enumerated value. + newvces: + description: | + This object fills in the gaps from vce that were incorporated into generic-vnf. This object will be retired with vce. + properties: + newvce: + type: array + items: + $ref: "#/patchDefinitions/newvce" + notification-event: + properties: + cambria.partition: + type: string + notification-event-header: + type: object + $ref: "#/patchDefinitions/notification-event-header" + notification-event-header: + properties: + id: + type: string + timestamp: + type: string + source-name: + type: string + domain: + type: string + sequence-number: + type: string + severity: + type: string + event-type: + type: string + version: + type: string + action: + type: string + entity-type: + type: string + top-entity-type: + type: string + entity-link: + type: string + status: + type: string + notify: + required: + - event-id + properties: + event-id: + type: string + node-type: + type: string + event-trigger: + type: string + key-data: + type: array + items: + $ref: "#/patchDefinitions/key-data" + selflink: + type: string + oam-network: + description: | + OAM network, to be deprecated shortly. Do not use for new purposes. + ###### Related Nodes + - TO cloud-region( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO complex( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY) + - TO service-capability( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + required: + - network-uuid + - network-name + - cvlan-tag + properties: + network-uuid: + type: string + description: UUID of the network. Unique across a cloud-region + network-name: + type: string + description: Name of the network. + cvlan-tag: + type: integer + format: int64 + description: cvlan-id + ipv4-oam-gateway-address: + type: string + description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network + ipv4-oam-gateway-address-prefix-length: + type: integer + format: int32 + description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network + oam-networks: + description: | + Collection of OAM networks, to be deprecated shortly. Do not use for new purposes. + properties: + oam-network: + type: array + items: + $ref: "#/patchDefinitions/oam-network" + operational-environment: + description: | + It is a logical partition of the cloud which allows to have multiple environments in the production AIC. + ###### Related Nodes + - TO operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE) + - FROM operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE) + required: + - operational-environment-id + - operational-environment-name + - operational-environment-type + - operational-environment-status + - tenant-context + - workload-context + properties: + operational-environment-id: + type: string + description: UUID of an operational environment + operational-environment-name: + type: string + description: Operational Environment name + operational-environment-type: + type: string + description: Operational Environment Type. + operational-environment-status: + type: string + description: Status + tenant-context: + type: string + description: Tenant Context. + workload-context: + type: string + description: Workload Context. + operational-environments: + description: | + a logical partition of the cloud which allows to have multiple environments in the production AIC. + properties: + operational-environment: + type: array + items: + $ref: "#/patchDefinitions/operational-environment" + overloaded-model: + description: | + Allows for legacy POST of old-style and new-style models required: - model-invariant-id + - model-name-version-id - model-type + - model-name + - model-id + - model-version properties: model-invariant-id: type: string description: Unique identifier corresponding to the main definition of a model in ASDC + model-name-version-id: + type: string + description: Unique identifier corresponding to one version of a model in ASDC model-type: type: string description: Type of the model, e.g., service, resource, widget, etc. - resource-version: + model-name: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - model-vers: + description: Name of the model, which can change from version to version. + model-id: + type: string + description: Invariant unique ID which does not change from version to version + model-version: + type: string + description: Version + model-description: + type: string + description: Description + owning-entities: + description: | + Collection of owning-entities + properties: + owning-entity: type: array - items: - $ref: "#/definitions/model-ver" - relationship-list: + items: + $ref: "#/patchDefinitions/owning-entity" + owning-entity: + description: | + describes an owning-entity + ###### Related Nodes + - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE) + required: + - owning-entity-id + - owning-entity-name + properties: + owning-entity-id: + type: string + description: UUID of an owning entity + owning-entity-name: + type: string + description: Owning entity name + p-interface: + description: | + Physical interface (e.g., nic) + ###### Related Nodes + - TO logical-link( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE) + - TO physical-link( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE) + - TO pnf( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - TO pserver( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - TO vpls-pe( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY) + - FROM l-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE) + - FROM sriov-pf( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE) + - P-INTERFACE is DELETED when these are DELETED L-INTERFACE,SRIOV-PF + - P-INTERFACE deletion means associated objects of these types are also DELETED:PHYSICAL-LINK + required: + - interface-name + - in-maint + properties: + interface-name: + type: string + description: Name that identifies the physical interface + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + port-description: + type: string + description: Nature of the services and connectivity on this port. + equipment-identifier: + type: string + description: CLEI or other specification for p-interface hardware. + interface-role: + type: string + description: Role specification for p-interface hardware. + interface-type: + type: string + description: Indicates the physical properties of the interface. + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + mac-addresss: + type: string + description: MAC Address of the p-interface. + p-interfaces: + description: | + Collection of physical interfaces. + properties: + p-interface: type: array - items: - $ref: "#/definitions/relationship" - models: + items: + $ref: "#/patchDefinitions/p-interface" + physical-link: description: | - Collection of subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models + Collection of physical connections, typically between p-interfaces + ###### Related Nodes + - FROM p-interface( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE) + required: + - link-name properties: - model: + link-name: + type: string + description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + circuit-id: + type: string + description: Circuit it + dual-mode: + type: string + description: Dual access mode (e.g., primary, secondary + management-option: + type: string + description: To provide information on who manages this circuit. A&AI or 3rd party transport provider + service-provider-name: + type: string + description: Name of the service Provider on this link. + service-provider-bandwidth-up-value: + type: integer + format: int32 + description: Upstream Bandwidth value agreed with the service provider + service-provider-bandwidth-up-units: + type: string + description: Units for the upstream BW value + service-provider-bandwidth-down-value: + type: integer + format: int32 + description: Downstream Bandwidth value agreed with the service provider + service-provider-bandwidth-down-units: + type: string + description: Units for downstream BW value + physical-links: + description: | + Collection of physical connections, typically between p-interfaces + properties: + physical-link: type: array items: - $ref: "#/definitions/model" - related-lookup: + $ref: "#/patchDefinitions/physical-link" + platform: description: | - TBD + describes a platform ###### Related Nodes - - FROM named-query-element (is composed of related-lookup) + - TO generic-vnf( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) required: - - related-lookup-uuid - - source-node-type - - source-node-property - - target-node-type - - target-node-property + - platform-name properties: - related-lookup-uuid: + platform-name: type: string - source-node-type: + description: Name of the platform + platforms: + description: | + Collection of platforms + properties: + platform: + type: array + items: + $ref: "#/patchDefinitions/platform" + pnf: + description: | + PNF represents a physical network function. typically equipment used in the D1 world. in 1607, this will be populated by SDN-C to represent a premises router that a uCPE connects to. But this can be used to represent any physical device that is not an AIC node or uCPE. + ###### Related Nodes + - TO complex( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO instance-group( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO zone( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM esr-thirdparty-sdnc( esr-thirdparty-sdnc has pnf, One2Many) + - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY) + - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - FROM p-interface( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY) + - PNF is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE + required: + - pnf-name + - in-maint + properties: + pnf-name: type: string - source-node-property: + description: unique name of Physical Network Function. + pnf-name2: type: string - target-node-type: + description: name of Physical Network Function. + pnf-name2-source: type: string - target-node-property: + description: source of name2 + pnf-id: type: string - property-collect-list: + description: id of pnf + equip-type: type: string - resource-version: + description: Equipment type. Source of truth should define valid values. + equip-vendor: type: string - relationship-list: + description: Equipment vendor. Source of truth should define valid values. + equip-model: + type: string + description: Equipment model. Source of truth should define valid values. + management-option: + type: string + description: identifier of managed by ATT or customer + ipaddress-v4-oam: + type: string + description: ipv4-oam-address with new naming convention for IP addresses + sw-version: + type: string + description: sw-version is the version of SW for the hosted application on the PNF. + in-maint: + type: boolean + frame-id: + type: string + description: ID of the physical frame (relay rack) where pnf is installed. + serial-number: + type: string + description: Serial number of the device + ipaddress-v4-loopback-0: + type: string + description: IPV4 Loopback 0 address + ipaddress-v6-loopback-0: + type: string + description: IPV6 Loopback 0 address + ipaddress-v4-aim: + type: string + description: IPV4 AIM address + ipaddress-v6-aim: + type: string + description: IPV6 AIM address + ipaddress-v6-oam: + type: string + description: IPV6 OAM address + inv-status: + type: string + description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. + pnfs: + description: | + Collection of Physical Network Functions. + properties: + pnf: type: array - items: - $ref: "#/definitions/relationship" - related-lookups: + items: + $ref: "#/patchDefinitions/pnf" + port-group: + description: | + Used to capture the network interfaces of this VCE + ###### Related Nodes + - TO vce( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM cvlan-tag( cvlan-tag org.onap.relationships.inventory.BelongsTo port-group, MANY2ONE) + - PORT-GROUP is DELETED when these are DELETED CVLAN-TAG + required: + - interface-id + - orchestration-status properties: - related-lookup: + interface-id: + type: string + description: Unique ID of the interface + neutron-network-id: + type: string + description: Neutron network id of this Interface + neutron-network-name: + type: string + description: Neutron network name of this Interface + interface-role: + type: string + description: Role assigned to this Interface, should use values as defined in ECOMP Yang models. + port-groups: + properties: + port-group: type: array items: - $ref: "#/definitions/related-lookup" + $ref: "#/patchDefinitions/port-group" + project: + description: | + describes the project + ###### Related Nodes + - TO service-instance( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY) + required: + - project-name + properties: + project-name: + type: string + description: Name of the project deploying a service + projects: + description: | + Collection of projects + properties: + project: + type: array + items: + $ref: "#/patchDefinitions/project" + properties: + description: | + Property holder for query properties or instance properties + properties: + property-name: + type: string + property-value: + type: string property-constraint: description: | TBD ###### Related Nodes - - FROM named-query-element (is composed of property-constraint) + - TO named-query-element( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) required: - property-constraint-uuid - constraint-type @@ -44252,96 +60592,393 @@ definitions: type: string property-value: type: string - resource-version: - type: string property-constraints: properties: property-constraint: type: array items: - $ref: "#/definitions/property-constraint" - named-query-element: + $ref: "#/patchDefinitions/property-constraint" + pserver: description: | - TBD + Compute host whose hostname must be unique and must exactly match what is sent as a relationship to a vserver. ###### Related Nodes - - TO named-query-element (comprises named-query-element, Many2Many) - - TO model (Many2One) - - TO property-constraint (comprises named-query-element, One2Many) - - TO related-lookup (comprises named-query-element, One2Many) - - FROM named-query (is composed of named-query-element) - - FROM named-query-element (is composed of named-query-element) + - TO group-assignment( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE) + - TO availability-zone( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE) + - TO cloud-region( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE) + - TO complex( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO zone( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY) + - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - FROM p-interface( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - FROM vserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE) + - PSERVER cannot be deleted if linked to GENERIC-VNF,LOGICAL-LINK,VSERVER + - PSERVER is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE + - PSERVER cannot be deleted if linked to GROUP-ASSIGNMENT required: - - named-query-element-uuid + - hostname + - in-maint properties: - named-query-element-uuid: + hostname: type: string - property-collect-list: + description: Value from executing hostname on the compute node. + ptnii-equip-name: type: string - resource-version: + description: PTNII name + number-of-cpus: + type: integer + format: int32 + description: Number of cpus + disk-in-gigabytes: + type: integer + format: int32 + description: Disk size, in GBs + ram-in-megabytes: + type: integer + format: int32 + description: RAM size, in MBs + equip-type: type: string - property-limit-desc: + description: Equipment type. Source of truth should define valid values. + equip-vendor: type: string - do-not-output: + description: Equipment vendor. Source of truth should define valid values. + equip-model: type: string - named-query-elements: + description: Equipment model. Source of truth should define valid values. + fqdn: + type: string + description: Fully-qualified domain name + pserver-selflink: + type: string + description: URL to endpoint where AAI can get more details + ipv4-oam-address: + type: string + description: Used to configure device, also used for troubleshooting and is IP used for traps generated by device. + serial-number: + type: string + description: Serial number, may be queried + ipaddress-v4-loopback-0: + type: string + description: IPV4 Loopback 0 address + ipaddress-v6-loopback-0: + type: string + description: IPV6 Loopback 0 address + ipaddress-v4-aim: + type: string + description: IPV4 AIM address + ipaddress-v6-aim: + type: string + description: IPV6 AIM address + ipaddress-v6-oam: + type: string + description: IPV6 OAM address + inv-status: + type: string + description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. + pserver-id: + type: string + description: ID of Pserver + internet-topology: + type: string + description: internet topology of Pserver + in-maint: + type: boolean + pservers: + description: | + Collection of compute hosts. + properties: + pserver: type: array - items: - $ref: "#/definitions/named-query-element" - related-lookups: + items: + $ref: "#/patchDefinitions/pserver" + query-parameters: + description: | + QueryParameters for performing a named-query or model query + properties: + named-query: + type: object + $ref: "#/patchDefinitions/named-query" + overloaded-model: + type: object + $ref: "#/patchDefinitions/overloaded-model" + related-lookup: + description: | + TBD + ###### Related Nodes + - TO named-query-element( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + required: + - related-lookup-uuid + - source-node-type + - source-node-property + - target-node-type + - target-node-property + properties: + related-lookup-uuid: + type: string + source-node-type: + type: string + source-node-property: + type: string + target-node-type: + type: string + target-node-property: + type: string + property-collect-list: + type: string + related-lookups: + properties: + related-lookup: type: array - items: - $ref: "#/definitions/related-lookup" - property-constraints: + items: + $ref: "#/patchDefinitions/related-lookup" + related-to-property: + properties: + property-key: + type: string + description: Key part of a key/value pair + property-value: + type: string + description: Value part of a key/value pair + relationship: + properties: + related-to: + type: string + description: A keyword provided by A&AI to indicate type of node. + related-link: + type: string + description: URL to the object in A&AI. + relationship-data: type: array - items: - $ref: "#/definitions/property-constraint" - relationship-list: + items: + $ref: "#/patchDefinitions/relationship-data" + related-to-property: type: array - items: - $ref: "#/definitions/relationship" - named-query-elements: + items: + $ref: "#/patchDefinitions/related-to-property" + relationship-data: + required: + - relationship-key + - relationship-value properties: - named-query-element: + relationship-key: + type: string + description: A keyword provided by A&AI to indicate an attribute. + relationship-value: + type: string + description: Value of the attribute. + reserved-prop-names: + description: | + Internal map to define some reserved properties of a vertex + properties: + last-mod-source-of-truth: + type: string + aai-node-type: + type: string + aai-created-ts: + type: integer + format: int64 + aai-unique-key: + type: string + aai-last-mod-ts: + type: integer + format: int64 + source-of-truth: + type: string + aai-uri: + type: string + response-list: + description: | + Response container for the results of a named-query or model query + properties: + inventory-response-items: + type: object + $ref: "#/patchDefinitions/inventory-response-items" + result-data: + properties: + resource-type: + type: string + description: The specific type of node in the A&AI graph + resource-link: + type: string + description: The URL to the specific resource + route-table-reference: + description: | + Openstack route table reference. + ###### Related Nodes + - FROM l3-network( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY) + required: + - route-table-reference-id + - route-table-reference-fqdn + properties: + route-table-reference-id: + type: string + description: Route Table Reference id, UUID assigned to this instance. + route-table-reference-fqdn: + type: string + description: FQDN entry in the route table. + route-table-references: + description: | + Collection of openstack route table references + properties: + route-table-reference: type: array items: - $ref: "#/definitions/named-query-element" - named-query: + $ref: "#/patchDefinitions/route-table-reference" + route-target: description: | - TBD + Route target information ###### Related Nodes - - TO model (One2Many) - - TO named-query-element (comprises named-query, One2One) + - TO vpn-binding( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE) required: - - named-query-uuid - - named-query-name - - named-query-version + - global-route-target + - route-target-role properties: - named-query-uuid: + global-route-target: type: string - named-query-name: + description: Number used to identify an RT, globally unique in the network + route-target-role: type: string - named-query-version: + description: Role assigned to this route target + route-targets: + description: | + Collection of route target information + properties: + route-target: + type: array + items: + $ref: "#/patchDefinitions/route-target" + routing-instance: + description: | + ###### Related Nodes + - TO site-pair-set( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE) + - FROM site-pair( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE) + - ROUTING-INSTANCE is DELETED when these are DELETED SITE-PAIR + required: + - routing-instance-id + properties: + routing-instance-id: type: string - required-input-param: + description: Unique id of routing instance + rpm-owner: type: string - description: + description: rpm owner + routing-instances: + description: | + set of probes related to generic-vnf routing instance + properties: + routing-instance: + type: array + items: + $ref: "#/patchDefinitions/routing-instance" + sdn-zone-response: + properties: + oam-networks: + type: object + $ref: "#/patchDefinitions/oam-networks" + az-and-dvs-switches: + type: array + items: + $ref: "#/patchDefinitions/az-and-dvs-switches" + search: + properties: + edge-tag-query-result: + type: object + $ref: "#/patchDefinitions/edge-tag-query-result" + edge-tag-query-request: + type: object + $ref: "#/patchDefinitions/edge-tag-query-request" + search-results: + type: object + $ref: "#/patchDefinitions/search-results" + sdn-zone-response: + type: object + $ref: "#/patchDefinitions/sdn-zone-response" + search-results: + properties: + result-data: + type: array + items: + $ref: "#/patchDefinitions/result-data" + secondary-filt: + description: | + SecondaryFilt for performing a named-query or model query + secondary-filter: + properties: + property-name: type: string - resource-version: + filter-type: type: string - named-query-elements: + property-value: + type: string + secondary-filts: + description: | + SecondaryFilts for performing a named-query or model query + properties: + secondary-filt: type: array - items: - $ref: "#/definitions/named-query-element" - relationship-list: + items: + $ref: "#/patchDefinitions/secondary-filt" + segmentation-assignment: + description: | + Openstack segmentation assignment. + ###### Related Nodes + - TO l3-network( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + required: + - segmentation-id + properties: + segmentation-id: + type: string + description: Route Table Reference id, UUID assigned to this instance. + segmentation-assignments: + description: | + Collection of openstack segmentation assignments + properties: + segmentation-assignment: type: array - items: - $ref: "#/definitions/relationship" - named-queries: + items: + $ref: "#/patchDefinitions/segmentation-assignment" + service: + description: | + Stand-in for service model definitions. Likely to be deprecated in favor of models from ASDC. Does not strictly map to ASDC services. + required: + - service-id + - service-description properties: - named-query: + service-id: + type: string + description: This gets defined by others to provide a unique ID for the service, we accept what is sent. + service-description: + type: string + description: Description of the service + service-selflink: + type: string + description: URL to endpoint where AAI can get more details + service-capabilities: + description: | + Collection of service capabilities. + properties: + service-capability: type: array items: - $ref: "#/definitions/named-query" + $ref: "#/patchDefinitions/service-capability" + service-capability: + description: | + Early definition of server/resource pairings, likely to be replaced by models. No new use should be made of this. + ###### Related Nodes + - FROM availability-zone( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + - SERVICE-CAPABILITY cannot be deleted if linked to AVAILABILITY-ZONE,OAM-NETWORK + required: + - service-type + - vnf-type + properties: + service-type: + type: string + description: This gets defined by others to provide a unique ID for the service, we accept what is sent. + vnf-type: + type: string + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. service-design-and-creation: description: | Namespace for objects managed by ASDC @@ -44349,70 +60986,84 @@ definitions: vnf-images: type: array items: - $ref: "#/definitions/vnf-image" + $ref: "#/patchDefinitions/vnf-image" services: type: array items: - $ref: "#/definitions/service" + $ref: "#/patchDefinitions/service" service-capabilities: type: array items: - $ref: "#/definitions/service-capability" + $ref: "#/patchDefinitions/service-capability" models: type: array items: - $ref: "#/definitions/model" + $ref: "#/patchDefinitions/model" named-queries: type: array items: - $ref: "#/definitions/named-query" - logical-link: + $ref: "#/patchDefinitions/named-query" + service-instance: description: | - Logical links generally connect l-interfaces but are used to express logical connectivity between two points + Instance of a service ###### Related Nodes - - TO lag-link (Many2Many) - - TO pnf (Many2Many) - - TO logical-link (One2Many) - - TO generic-vnf (Many2Many) - - TO pserver (Many2Many) - - TO cloud-region (Many2Many) - - TO vpn-binding (Many2Many) - - FROM configuration - - FROM l-interface - - FROM lag-interface - - FROM p-interface - - FROM service-instance - - FROM virtual-data-center - - FROM vlan - - FROM logical-link + - TO generic-vnf( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY) + - TO l3-network( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY) + - TO owning-entity( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE) + - TO allotted-resource( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY) + - TO configuration( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - TO connector( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY) + - TO ctag-assignment( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY) + - TO cvlan-tag( service-instance org.onap.relationships.inventory.ComposedOf cvlan-tag, MANY2MANY) + - TO instance-group( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO logical-link( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - TO pnf( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY) + - TO service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY) + - TO vlan( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY) + - TO zone( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - TO service-subscription( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE) + - TO vce( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY) + - FROM project( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY) + - SERVICE-INSTANCE is DELETED when these are DELETED ALLOTTED-RESOURCE,METADATUM + - SERVICE-INSTANCE deletion means associated objects of these types are also DELETED:LOGICAL-LINK required: - - link-name - - in-maint - - link-type + - service-instance-id + - service-type + - service-role + - created-at + - updated-at + - description properties: - link-name: + service-instance-id: type: string - description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ - in-maint: - type: boolean - link-type: + description: Uniquely identifies this instance of a service + service-instance-name: type: string - description: Type of logical link, e.g., evc - speed-value: + description: This field will store a name assigned to the service-instance. + service-type: type: string - description: Captures the numeric part of the speed - speed-units: + description: String capturing type of service. + service-role: type: string - description: Captures the units corresponding to the speed - ip-version: + description: String capturing the service role. + environment-context: type: string - description: v4, v6, or ds for dual stack - routing-protocol: + description: This field will store the environment context assigned to the service-instance. + workload-context: type: string - description: For example, static or BGP - resource-version: + description: This field will store the workload context assigned to the service-instance. + created-at: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + description: create time of Network Service. + updated-at: + type: string + description: last update of Network Service. + description: + type: string + description: short description for service-instance. model-invariant-id: type: string description: the ASDC model id for this resource or service model. @@ -44428,75 +61079,74 @@ definitions: widget-model-version: type: string description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. - operational-status: + bandwidth-total: type: string - description: Indication of operational status of the logical link. - prov-status: + description: Indicates the total bandwidth to be used for this service. + bandwidth-up-wan1: type: string - description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. - link-role: + description: indicates the upstream bandwidth this service will use on the WAN1 port of the physical device. + bandwidth-down-wan1: type: string - description: Indication of the network use of the logical link. - link-name2: + description: indicates the downstream bandwidth this service will use on the WAN1 port of the physical device. + bandwidth-up-wan2: type: string - description: Alias or alternate name (CLCI or D1 name). - link-id: + description: indicates the upstream bandwidth this service will use on the WAN2 port of the physical device. + bandwidth-down-wan2: type: string - description: UUID of the logical-link, SDNC generates this. - circuit-id: + description: indicates the downstream bandwidth this service will use on the WAN2 port of the physical device. + vhn-portal-url: type: string - description: Circuit id - purpose: + description: URL customers will use to access the vHN Portal. + service-instance-location-id: type: string - description: Reason for this entity, role it is playing - relationship-list: - type: array - items: - $ref: "#/definitions/relationship" - logical-links: + description: An identifier that customers assign to the location where this service is being used. + service-instances: description: | - Collection of logical connections + Collection of service instances properties: - logical-link: + service-instance: type: array items: - $ref: "#/definitions/logical-link" - class-of-service: + $ref: "#/patchDefinitions/service-instance" + service-subscription: description: | + Object that group service instances. ###### Related Nodes - - FROM site-pair (is composed of class-of-service) + - TO customer( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE) + - TO tenant( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE) + - SERVICE-SUBSCRIPTION is DELETED when these are DELETED SERVICE-INSTANCE required: - - cos + - service-type properties: - cos: - type: string - description: unique identifier of probe - probe-id: - type: string - description: identifier of probe - probe-type: + service-type: type: string - description: type of probe - resource-version: + description: Value defined by orchestration to identify this service across ECOMP. + temp-ub-sub-account-id: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - relationship-list: + description: This property will be deleted from A&AI in the near future. Only stop gap solution. + service-subscriptions: + description: | + Collection of objects that group service instances. + properties: + service-subscription: type: array - items: - $ref: "#/definitions/relationship" - classes-of-service: + items: + $ref: "#/patchDefinitions/service-subscription" + services: description: | - class-of-service of probe + Collection of service model definitions. Likely to be deprecated in favor of models from ASDC. properties: - class-of-service: + service: type: array items: - $ref: "#/definitions/class-of-service" + $ref: "#/patchDefinitions/service" site-pair: description: | ###### Related Nodes - - TO class-of-service (comprises site-pair, Many2Many) - - FROM routing-instance (is composed of site-pair) + - TO routing-instance( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE) + - FROM class-of-service( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE) + - SITE-PAIR is DELETED when these are DELETED CLASS-OF-SERVICE required: - site-pair-id properties: @@ -44518,17 +61168,27 @@ definitions: destination-equip-type: type: string description: The type of destinatination equipment. Could be Router, UCPE, etc. - resource-version: + site-pair-set: + description: | + Set of instances for probes used to measure service level agreements + ###### Related Nodes + - TO generic-vnf( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + - FROM routing-instance( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE) + - SITE-PAIR-SET is DELETED when these are DELETED ROUTING-INSTANCE + required: + - site-pair-set-id + properties: + site-pair-set-id: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - classes-of-service: - type: array - items: - $ref: "#/definitions/class-of-service" - relationship-list: + description: Unique id of site pair set. + site-pair-sets: + description: | + Collection of sets of instances for probes related to generic-vnf + properties: + site-pair-set: type: array - items: - $ref: "#/definitions/relationship" + items: + $ref: "#/patchDefinitions/site-pair-set" site-pairs: description: | probe within a set @@ -44536,109 +61196,751 @@ definitions: site-pair: type: array items: - $ref: "#/definitions/site-pair" - routing-instance: + $ref: "#/patchDefinitions/site-pair" + snapshot: description: | + Openstack snapshot ###### Related Nodes - - TO site-pair (comprises routing-instance, Many2Many) - - FROM site-pair-set (is composed of routing-instance) + - TO cloud-region( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vserver( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE) required: - - routing-instance-id + - snapshot-id properties: - routing-instance-id: + snapshot-id: type: string - description: Unique id of routing instance - rpm-owner: + description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. + snapshot-name: type: string - description: rpm owner - resource-version: + description: Snapshot name + snapshot-architecture: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - site-pairs: + description: Operating system architecture + snapshot-os-distro: + type: string + description: The common name of the operating system distribution in lowercase + snapshot-os-version: + type: string + description: The operating system version as specified by the distributor. + application: + type: string + description: The application that the image instantiates. + application-vendor: + type: string + description: The vendor of the application. + application-version: + type: string + description: The version of the application. + snapshot-selflink: + type: string + description: URL to endpoint where AAI can get more details + prev-snapshot-id: + type: string + description: This field contains the UUID of the previous snapshot (if any). + snapshots: + description: | + Collection of openstack snapshots + properties: + snapshot: type: array - items: - $ref: "#/definitions/site-pair" - relationship-list: + items: + $ref: "#/patchDefinitions/snapshot" + sriov-pf: + description: | + SR-IOV Physical Function + ###### Related Nodes + - TO p-interface( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE) + - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE) + required: + - pf-pci-id + properties: + pf-pci-id: + type: string + description: Identifier for the sriov-pf + sriov-pfs: + description: | + Collection of SR-IOV Physical Functions. + properties: + sriov-pf: type: array - items: - $ref: "#/definitions/relationship" - routing-instances: + items: + $ref: "#/patchDefinitions/sriov-pf" + sriov-vf: description: | - set of probes related to generic-vnf routing instance + SR-IOV Virtual Function (not to be confused with virtual network function) + ###### Related Nodes + - TO l-interface( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE) + - TO sriov-pf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE) + required: + - pci-id properties: - routing-instance: + pci-id: + type: string + description: PCI ID used to identify the sriov-vf + vf-vlan-filter: + type: string + description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM. + vf-mac-filter: + type: string + description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM. + vf-vlan-strip: + type: boolean + description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM. + vf-vlan-anti-spoof-check: + type: boolean + description: This option ensures anti VLAN spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs. + vf-mac-anti-spoof-check: + type: boolean + description: This option ensures anti MAC spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs. + vf-mirrors: + type: string + description: This option defines the set of Mirror objects which essentially mirrors the traffic from source to set of collector VNF Ports. + vf-broadcast-allow: + type: boolean + description: This option, if set to true, sets the VF in promiscuous mode and allows all broadcast traffic to reach the VM + vf-unknown-multicast-allow: + type: boolean + description: This option, if set to true, sets the VF in promiscuous mode and allows unknown multicast traffic to reach the VM + vf-unknown-unicast-allow: + type: boolean + description: This option, if set to true, sets the VF in promiscuous mode and allows unknown unicast traffic to reach the VM + vf-insert-stag: + type: boolean + description: This option, if set to true, instructs to insert outer tag after traffic comes out of VM. + vf-link-status: + type: string + description: This option is used to set the link status. Valid values as of 1607 are on, off, and auto. + sriov-vfs: + description: | + Collection of SR-IOV Virtual Functions. + properties: + sriov-vf: type: array items: - $ref: "#/definitions/routing-instance" - site-pair-set: + $ref: "#/patchDefinitions/sriov-vf" + start-node-filter: + properties: + property-name: + type: string + property-value: + type: string + subnet: description: | - Set of instances for probes used to measure service level agreements ###### Related Nodes - - TO routing-instance (comprises site-pair-set, Many2Many) - - FROM generic-vnf + - TO l3-network( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - FROM host-route( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE) + - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - SUBNET cannot be deleted if linked to L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST + - SUBNET is DELETED when these are DELETED HOST-ROUTE required: - - site-pair-set-id + - subnet-id + - dhcp-enabled properties: - site-pair-set-id: + subnet-id: type: string - description: Unique id of site pair set. - resource-version: + description: Subnet ID, should be UUID. + subnet-name: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - routing-instances: + description: Name associated with the subnet. + neutron-subnet-id: + type: string + description: Neutron id of this subnet + gateway-address: + type: string + description: gateway ip address + network-start-address: + type: string + description: network start address + cidr-mask: + type: string + description: cidr mask + ip-version: + type: string + description: ip version + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by MSO + dhcp-enabled: + type: boolean + dhcp-start: + type: string + description: the start address reserved for use by dhcp + dhcp-end: + type: string + description: the last address reserved for use by dhcp + subnet-role: + type: string + description: role of the subnet, referenced when assigning IPs + ip-assignment-direction: + type: string + description: ip address assignment direction of the subnet + subnets: + properties: + subnet: type: array - items: - $ref: "#/definitions/routing-instance" - relationship-list: + items: + $ref: "#/patchDefinitions/subnet" + tagged-inventory-item-list: + properties: + inventory-item: type: array - items: - $ref: "#/definitions/relationship" - site-pair-sets: + items: + $ref: "#/patchDefinitions/inventory-item" + tenant: description: | - Collection of sets of instances for probes related to generic-vnf + Openstack tenant + ###### Related Nodes + - TO cloud-region( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO group-assignment( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY) + - TO l3-network( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - TO volume-group( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + - FROM service-subscription( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY) + - FROM vserver( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE) + - TENANT cannot be deleted if linked to VSERVER + required: + - tenant-id + - tenant-name properties: - site-pair-set: + tenant-id: + type: string + description: Unique id relative to the cloud-region. + tenant-name: + type: string + description: Readable name of tenant + tenant-context: + type: string + description: This field will store the tenant context. + tenants: + description: | + Collection of openstack tenants. + properties: + tenant: type: array items: - $ref: "#/definitions/site-pair-set" - route-target: + $ref: "#/patchDefinitions/tenant" + tunnel-xconnect: description: | - Route target information + Represents the specifics of a tunnel cross connect piece of a resource that gets separately allotted ###### Related Nodes - - FROM vpn-binding (is composed of route-target) + - TO allotted-resource( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE) required: - - global-route-target - - route-target-role + - id + - bandwidth-up-wan1 + - bandwidth-down-wan1 + - bandwidth-up-wan2 + - bandwidth-down-wan2 properties: - global-route-target: + id: type: string - description: Number used to identify an RT, globally unique in the network - route-target-role: + description: Allotted Resource id UUID assigned to this instance. + bandwidth-up-wan1: type: string - description: Role assigned to this route target - resource-version: + description: The WAN uplink bandwidth for WAN1 + bandwidth-down-wan1: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - relationship-list: + description: The WAN downlink bandwidth for WAN1 + bandwidth-up-wan2: + type: string + description: The WAN uplink bandwidth for WAN2 + bandwidth-down-wan2: + type: string + description: The WAN downlink bandwidth for WAN2 + tunnel-xconnects: + description: | + This object is used to store the specific tunnel cross connect aspects of an allotted resource + properties: + tunnel-xconnect: type: array - items: - $ref: "#/definitions/relationship" - route-targets: + items: + $ref: "#/patchDefinitions/tunnel-xconnect" + update: description: | - Collection of route target information + Serves a PATCH like function. Does not enforce concurrency control. Clear each usage with AAI team. + required: + - update-node-type properties: - route-target: + update-node-type: + type: string + update-node-key: type: array items: - $ref: "#/definitions/route-target" + $ref: "#/patchDefinitions/update-node-key" + update-node-uri: + type: string + action: + type: array + items: + $ref: "#/patchDefinitions/action" + update-node-key: + properties: + key-name: + type: string + key-value: + type: string + vce: + description: | + Virtual Customer Edge Router, used specifically for Gamma. This object is deprecated. + ###### Related Nodes + - TO availability-zone( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - TO complex( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - TO vserver( vce tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM license( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM port-group( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY) + - VCE is DELETED when these are DELETED ENTITLEMENT,LICENSE,PORT-GROUP + required: + - vnf-id + - vnf-name + - vnf-type + properties: + vnf-id: + type: string + description: Unique id of VNF. This is unique across the graph. + vnf-name: + type: string + description: Name of VNF. + vnf-name2: + type: string + description: Alternate name of VNF. + vnf-type: + type: string + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + service-id: + type: string + description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED. + regional-resource-zone: + type: string + description: Regional way of organizing pservers, source of truth should define values + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + operational-status: + type: string + description: Indicator for whether the resource is considered operational + license-key: + type: string + description: OBSOLETE - do not use + equipment-role: + type: string + description: Network role being played by this VNF + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by MSO + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance, managed by MSO + mso-catalog-key: + type: string + description: Corresponds to the SDN-C catalog id used to configure this VCE + vpe-id: + type: string + description: Unique ID of VPE connected to this VCE. + v6-vce-wan-address: + type: string + description: Valid v6 IP address for the WAN Link on this router. Implied length of /64. + ipv4-oam-address: + type: string + description: Address tail-f uses to configure vce, also used for troubleshooting and is IP used for traps generated by VCE. + vces: + description: | + Collection of Virtual Customer Edge Routers, used specifically for Gamma. This object is deprecated. + properties: + vce: + type: array + items: + $ref: "#/patchDefinitions/vce" + vf-module: + description: | + a deployment unit of VNFCs + ###### Related Nodes + - TO generic-vnf( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO l3-network( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY) + - TO vnfc( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY) + - TO volume-group( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE) + - TO vserver( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY) + - VF-MODULE cannot be deleted if linked to VNFC + required: + - vf-module-id + - is-base-vf-module + properties: + vf-module-id: + type: string + description: Unique ID of vf-module. + vf-module-name: + type: string + description: Name of vf-module + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance. + orchestration-status: + type: string + description: orchestration status of this vf-module, mastered by MSO + is-base-vf-module: + type: boolean + vf-modules: + description: | + Collection of vf-modules, a deployment unit of VNFCs + properties: + vf-module: + type: array + items: + $ref: "#/patchDefinitions/vf-module" + vig-server: + description: | + vig-server contains information about a vig server used for IPSec-configuration. Populated by SDN-C from 1607 + ###### Related Nodes + - TO ipsec-configuration( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE) + required: + - vig-address-type + properties: + vig-address-type: + type: string + description: indicates whether the VIG is for AVPN or INTERNET + ipaddress-v4-vig: + type: string + description: v4 IP of the vig server + ipaddress-v6-vig: + type: string + description: v6 IP of the vig server + vig-servers: + properties: + vig-server: + type: array + items: + $ref: "#/patchDefinitions/vig-server" + vip-ipv4-address-list: + description: | + IPv4 Address Range + ###### Related Nodes + - TO cloud-region( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO instance-group( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO subnet( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY) + required: + - vip-ipv4-address + properties: + vip-ipv4-address: + type: string + description: IP address + vip-ipv4-prefix-length: + type: integer + format: int64 + description: Prefix length, 32 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + vip-ipv6-address-list: + description: | + IPv6 Address Range + ###### Related Nodes + - TO cloud-region( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO instance-group( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO subnet( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY) + required: + - vip-ipv6-address + properties: + vip-ipv6-address: + type: string + description: IP address + vip-ipv6-prefix-length: + type: integer + format: int64 + description: Prefix length, 128 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + virtual-data-center: + description: | + Virtual organization of cloud infrastructure elements in a data center context + ###### Related Nodes + - FROM connector( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + required: + - vdc-id + - vdc-name + properties: + vdc-id: + type: string + description: Unique ID of the vdc + vdc-name: + type: string + description: Name of the virtual data center + virtual-data-centers: + description: | + Virtual organization of cloud infrastructure elements in a data center context + properties: + virtual-data-center: + type: array + items: + $ref: "#/patchDefinitions/virtual-data-center" + vlan: + description: | + Definition of vlan + ###### Related Nodes + - TO l-interface( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE) + - TO logical-link( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - TO multicast-configuration( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - VLAN is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST + - VLAN deletion means associated objects of these types are also DELETED:LOGICAL-LINK + required: + - vlan-interface + - in-maint + - is-ip-unnumbered + properties: + vlan-interface: + type: string + description: String that identifies the interface + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + vlans: + properties: + vlan: + type: array + items: + $ref: "#/patchDefinitions/vlan" + vnf: + description: | + Abstract vnf class + required: + - vnf-id + properties: + vnf-id: + type: string + description: Unique id of VNF. This is unique across the graph. + vnf-image: + description: | + Image object that pertain to a VNF that doesn't have associated vservers. This is a kludge. + ###### Related Nodes + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE) + - VNF-IMAGE cannot be deleted if linked to GENERIC-VNF + required: + - vnf-image-uuid + - application + - application-vendor + properties: + vnf-image-uuid: + type: string + description: Unique ID of this asset + application: + type: string + description: The application that the image instantiates. + application-vendor: + type: string + description: The vendor of the application. + application-version: + type: string + description: The version of the application. + selflink: + type: string + description: URL to endpoint where AAI can get more details + vnf-images: + description: | + Collection of image objects that pertain to a VNF that doesn't have associated vservers. This is a kludge. + properties: + vnf-image: + type: array + items: + $ref: "#/patchDefinitions/vnf-image" + vnfc: + description: | + ###### Related Nodes + - TO generic-vnf( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO instance-group( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO vip-ipv4-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY) + - TO vip-ipv6-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY) + - TO vserver( vnfc tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + - VNFC is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST + required: + - vnfc-name + - nfc-naming-code + - nfc-function + - in-maint + - is-closed-loop-disabled + properties: + vnfc-name: + type: string + description: Unique ID of vnfc. + nfc-naming-code: + type: string + description: Short code that is used in naming instances of the item being modeled + nfc-function: + type: string + description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service + prov-status: + type: string + description: prov status of this vnfc + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by APP-C + ipaddress-v4-oam-vip: + type: string + description: Oam V4 vip address of this vnfc + in-maint: + type: boolean + is-closed-loop-disabled: + type: boolean + group-notation: + type: string + description: Group notation of VNFC + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + vnfcs: + description: | + virtual network components associated with a vserver from application controller. + properties: + vnfc: + type: array + items: + $ref: "#/patchDefinitions/vnfc" + volume: + description: | + Ephemeral Block storage volume. + ###### Related Nodes + - FROM vserver (PARENT of volume, vserver tosca.relationships.AttachesTo volume) + required: + - volume-id + - volume-selflink + properties: + volume-id: + type: string + description: Unique ID of block storage volume relative to the vserver. + volume-selflink: + type: string + description: URL to endpoint where AAI can get more details + volume-group: + description: | + Persistent block-level storage. + ###### Related Nodes + - TO cloud-region( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO complex( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + required: + - volume-group-id + - volume-group-name + - vnf-type + properties: + volume-group-id: + type: string + description: Unique ID of volume-group. + volume-group-name: + type: string + description: Name of the volume group. + heat-stack-id: + type: string + description: Heat stack id corresponding to this volume-group + vnf-type: + type: string + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + orchestration-status: + type: string + description: Orchestration status of this volume-group + model-customization-id: + type: string + description: captures the id of all the configuration used to customize the resource for the service. + vf-module-model-customization-id: + type: string + description: helps relate the volume group to the vf-module whose components will require the volume group + volume-groups: + description: | + Collection of persistent block-level storage. + properties: + volume-group: + type: array + items: + $ref: "#/patchDefinitions/volume-group" + volumes: + description: | + Collection of ephemeral Block storage volumes. + properties: + volume: + type: array + items: + $ref: "#/patchDefinitions/volume" + vpls-pe: + description: | + VPLS Provider Edge routers. + ###### Related Nodes + - TO complex( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO ctag-pool( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - FROM p-interface( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - VPLS-PE is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE + required: + - equipment-name + properties: + equipment-name: + type: string + prov-status: + type: string + description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. + ipv4-oam-address: + type: string + description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address). + equipment-role: + type: string + description: Client should send valid enumerated value, e.g., VPLS-PE. + vlan-id-outer: + type: integer + format: int64 + description: Temporary location for stag to get to VCE + vpls-pes: + description: | + Collection of VPLS Provider Edge routers + properties: + vpls-pe: + type: array + items: + $ref: "#/patchDefinitions/vpls-pe" vpn-binding: description: | VPN binding ###### Related Nodes - - TO route-target (comprises vpn-binding, One2Many) - - FROM l3-network - - FROM logical-link - - FROM allotted-resource + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY) + - FROM l3-network( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - FROM route-target( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE) + - VPN-BINDING cannot be deleted if linked to ALLOTTED-RESOURCE,L3-NETWORK,LOGICAL-LINK + - VPN-BINDING is DELETED when these are DELETED ROUTE-TARGET required: - vpn-id - vpn-name @@ -44664,106 +61966,796 @@ definitions: route-distinguisher: type: string description: Used to distinguish the distinct VPN routes of separate customers who connect to the provider in an MPLS network. + vpn-bindings: + properties: + vpn-binding: + type: array + items: + $ref: "#/patchDefinitions/vpn-binding" + vserver: + description: | + Virtual Servers, aka virtual machine or VM. + ###### Related Nodes + - TO tenant( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE) + - TO flavor( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE) + - TO image( vserver org.onap.relationships.inventory.Uses image, MANY2ONE) + - TO pserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE) + - TO snapshot( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE) + - TO volume (CHILD of vserver, vserver tosca.relationships.AttachesTo volume, ONE2MANY) + - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM vce( vce tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM l-interface( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE) + - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY) + - FROM vnfc( vnfc tosca.relationships.HostedOn vserver, ONE2MANY) + - VSERVER is DELETED when these are DELETED L-INTERFACE + - VSERVER deletion means associated objects of these types are also DELETED:VOLUME + required: + - vserver-id + - vserver-name + - vserver-selflink + - in-maint + - is-closed-loop-disabled + properties: + vserver-id: + type: string + description: Unique identifier for this vserver relative to its tenant + vserver-name: + type: string + description: Name of vserver + vserver-name2: + type: string + description: Alternative name of vserver + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + vserver-selflink: + type: string + description: URL to endpoint where AAI can get more details + in-maint: + type: boolean + is-closed-loop-disabled: + type: boolean + vservers: + description: | + Collection of virtual Servers, aka virtual machines or VMs. + properties: + vserver: + type: array + items: + $ref: "#/patchDefinitions/vserver" + zone: + description: | + A zone is a grouping of assets in a location homing to the same connections into the CBB + ###### Related Nodes + - TO complex( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + required: + - zone-id + - zone-name + - design-type + - zone-context + properties: + zone-id: + type: string + description: Code assigned by AIC to the zone + zone-name: + type: string + description: English name associated with the zone + design-type: + type: string + description: Design of zone [Medium/Large?] + zone-context: + type: string + description: Context of zone [production/test] + status: + type: string + description: Status of a zone. + zones: + description: | + Collection of zones + properties: + zone: + type: array + items: + $ref: "#/patchDefinitions/zone" +getDefinitions: + aai-internal: + properties: + property-name: + type: string + property-value: + type: string + action: + properties: + action-type: + type: string + action-data: + type: array + items: + $ref: "#/getDefinitions/action-data" + action-data: + properties: + property-name: + type: string + property-value: + type: string + actions: + description: | + APIs that are more action related than REST (e.g., notify, update). + properties: + update: + type: object + $ref: "#/getDefinitions/update" + notify: + type: object + $ref: "#/getDefinitions/notify" + allotted-resource: + description: | + Represents a slice or partial piece of a resource that gets separately allotted + ###### Related Nodes + - TO allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE) + - TO generic-vnf( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY) + - TO instance-group( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO l3-network( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY) + - TO l-interface( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY) + - TO network-policy( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE) + - TO vlan( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY) + - TO vpn-binding( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY) + - TO service-instance( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - FROM tunnel-xconnect( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE) + - FROM configuration( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY) + - FROM allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE) + - ALLOTTED-RESOURCE is DELETED when these are DELETED TUNNEL-XCONNECT + required: + - id + properties: + id: + type: string + description: Allotted Resource id UUID assigned to this instance. + description: + type: string + description: The descriptive information assigned to this allotted resource instance + selflink: + type: string + description: Link back to more information in the controller + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + resource-version: + type: string + description: Concurrency value + orchestration-status: + type: string + description: Orchestration status + operational-status: + type: string + description: Indicator for whether the resource is considered operational + type: + type: string + description: Generic description of the type of allotted resource. + role: + type: string + description: role in the network that this resource will be providing. + tunnel-xconnects: + type: array + items: + $ref: "#/getDefinitions/tunnel-xconnect" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + allotted-resources: + description: | + This object is used to store slices of services being offered + properties: + allotted-resource: + type: array + items: + $ref: "#/getDefinitions/allotted-resource" + availability-zone: + description: | + Availability zone, a collection of compute hosts/pservers + ###### Related Nodes + - TO complex( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO service-capability( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + - TO cloud-region( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - FROM pserver( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE) + - FROM vce( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - AVAILABILITY-ZONE cannot be deleted if linked to CTAG-POOL,DVS-SWITCH,GENERIC-VNF,PSERVER,VCE + required: + - availability-zone-name + - hypervisor-type + properties: + availability-zone-name: + type: string + description: Name of the availability zone. Unique across a cloud region + hypervisor-type: + type: string + description: Type of hypervisor. Source of truth should define valid values. + operational-status: + type: string + description: State that indicates whether the availability zone should be used, etc. Source of truth should define valid values. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - route-targets: + relationship-list: type: array items: - $ref: "#/definitions/route-target" + $ref: "#/getDefinitions/relationship" + availability-zones: + description: | + Collection of availability zones + properties: + availability-zone: + type: array + items: + $ref: "#/getDefinitions/availability-zone" + az-and-dvs-switches: + properties: + dvs-switches: + type: object + $ref: "#/getDefinitions/dvs-switches" + availability-zone: + type: object + $ref: "#/getDefinitions/availability-zone" + business: + description: | + Namespace for business related constructs + properties: + connectors: + type: array + items: + $ref: "#/getDefinitions/connector" + customers: + type: array + items: + $ref: "#/getDefinitions/customer" + lines-of-business: + type: array + items: + $ref: "#/getDefinitions/line-of-business" + owning-entities: + type: array + items: + $ref: "#/getDefinitions/owning-entity" + platforms: + type: array + items: + $ref: "#/getDefinitions/platform" + projects: + type: array + items: + $ref: "#/getDefinitions/project" + class-of-service: + description: | + ###### Related Nodes + - TO site-pair( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE) + required: + - cos + properties: + cos: + type: string + description: unique identifier of probe + probe-id: + type: string + description: identifier of probe + probe-type: + type: string + description: type of probe + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. relationship-list: type: array items: - $ref: "#/definitions/relationship" - description: l3-networks relate to vpn-bindings - vpn-bindings: + $ref: "#/getDefinitions/relationship" + classes-of-service: + description: | + class-of-service of probe properties: - vpn-binding: + class-of-service: type: array items: - $ref: "#/definitions/vpn-binding" - vpls-pe: + $ref: "#/getDefinitions/class-of-service" + cloud-infrastructure: description: | - VPLS Provider Edge routers. + Namespace for cloud infrastructure. + properties: + complexes: + type: array + items: + $ref: "#/getDefinitions/complex" + cloud-regions: + type: array + items: + $ref: "#/getDefinitions/cloud-region" + network-profiles: + type: array + items: + $ref: "#/getDefinitions/network-profile" + pservers: + type: array + items: + $ref: "#/getDefinitions/pserver" + virtual-data-centers: + type: array + items: + $ref: "#/getDefinitions/virtual-data-center" + cloud-region: + description: | + cloud-region designates an installation of a cloud cluster or region or instantiation. ###### Related Nodes - - TO complex (Many2Many) - - TO ctag-pool (Many2Many) - - TO p-interface (comprises vpls-pe, Many2Many) - - TO lag-interface (comprises vpls-pe, Many2Many) + - TO esr-system-info (CHILD of cloud-region, cloud-region has esr-system-info, One2Many) + - TO complex( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO l3-network( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - TO zone( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM availability-zone( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM flavor( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM group-assignment( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM image( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM oam-network( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM snapshot( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM volume-group( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY) + - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE) + - CLOUD-REGION cannot be deleted if linked to DVS-SWITCH,FLAVOR,GROUP-ASSIGNMENT,IMAGE,OAM-NETWORK,SNAPSHOT,TENANT,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST,VOLUME-GROUP + - CLOUD-REGION is DELETED when these are DELETED AVAILABILITY-ZONE + - CLOUD-REGION deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO required: - - equipment-name + - cloud-owner + - cloud-region-id + - sriov-automation properties: - equipment-name: + cloud-owner: type: string - prov-status: + description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname + cloud-region-id: type: string - description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. - ipv4-oam-address: + description: Identifier used by the vendor for the region. Second part of composite key + cloud-type: type: string - description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address). - equipment-role: + description: Type of the cloud (e.g., openstack) + owner-defined-type: type: string - description: Client should send valid enumerated value, e.g., VPLS-PE. - vlan-id-outer: - type: integer - format: int64 - description: Temporary location for stag to get to VCE + description: Cloud-owner defined type indicator (e.g., dcp, lcp) + cloud-region-version: + type: string + description: Software version employed at the site. NOTE - THIS FIELD IS NOT KEPT UP TO DATE. + identity-url: + type: string + description: URL of the keystone identity service + cloud-zone: + type: string + description: Zone where the cloud is homed. NOTE - THIS FIELD IS NOT CORRECTLY POPULATED. + complex-name: + type: string + description: complex name for cloud-region instance. NOTE - THIS FIELD IS NOT CORRECTLY POPULATED. + sriov-automation: + type: boolean + cloud-extra-info: + type: string + description: ESR inputs extra information about the VIM or Cloud which will be decoded by MultiVIM. + cloud-epa-caps: + type: string + description: MultiVIM will discover and expose EPA capabilities. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + volume-groups: + type: array + items: + $ref: "#/getDefinitions/volume-group" + tenants: + type: array + items: + $ref: "#/getDefinitions/tenant" + flavors: + type: array + items: + $ref: "#/getDefinitions/flavor" + group-assignments: + type: array + items: + $ref: "#/getDefinitions/group-assignment" + snapshots: + type: array + items: + $ref: "#/getDefinitions/snapshot" + images: + type: array + items: + $ref: "#/getDefinitions/image" + dvs-switches: + type: array + items: + $ref: "#/getDefinitions/dvs-switch" + oam-networks: + type: array + items: + $ref: "#/getDefinitions/oam-network" + availability-zones: + type: array + items: + $ref: "#/getDefinitions/availability-zone" relationship-list: type: array items: - $ref: "#/definitions/relationship" - p-interfaces: + $ref: "#/getDefinitions/relationship" + esr-system-info-list: type: array items: - $ref: "#/definitions/p-interface" - lag-interfaces: + $ref: "#/getDefinitions/esr-system-info" + vip-ipv4-address-list: + type: array + items: + $ref: "#/getDefinitions/vip-ipv4-address-list" + vip-ipv6-address-list: + type: array + items: + $ref: "#/getDefinitions/vip-ipv6-address-list" + cloud-regions: + properties: + cloud-region: + type: array + items: + $ref: "#/getDefinitions/cloud-region" + complex: + description: | + Collection of physical locations that can house cloud-regions. + ###### Related Nodes + - TO l3-network( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM availability-zone( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY) + - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM vce( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - FROM volume-group( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM zone( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - COMPLEX cannot be deleted if linked to AVAILABILITY-ZONE,CLOUD-REGION,GENERIC-VNF,OAM-NETWORK,PNF,PSERVER,VCE,VOLUME-GROUP,VPLS-PE,ZONE + - COMPLEX is DELETED when these are DELETED CTAG-POOL + required: + - physical-location-id + - physical-location-type + - street1 + - city + - postal-code + - country + - region + properties: + physical-location-id: + type: string + description: Unique identifier for physical location, e.g., CLLI + data-center-code: + type: string + description: Data center code which can be an alternate way to identify a complex + complex-name: + type: string + description: Gamma complex name for LCP instance. + identity-url: + type: string + description: URL of the keystone identity service + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + physical-location-type: + type: string + description: Type, e.g., central office, data center. + street1: + type: string + street2: + type: string + city: + type: string + state: + type: string + postal-code: + type: string + country: + type: string + region: + type: string + latitude: + type: string + longitude: + type: string + elevation: + type: string + lata: + type: string + ctag-pools: type: array items: - $ref: "#/definitions/lag-interface" - vpls-pes: + $ref: "#/getDefinitions/ctag-pool" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + complexes: description: | - Collection of VPLS Provider Edge routers + Collection of physical locations that can house cloud-regions. properties: - vpls-pe: + complex: type: array items: - $ref: "#/definitions/vpls-pe" - multicast-configuration: + $ref: "#/getDefinitions/complex" + configuration: description: | + Port Mirror Configuration. ###### Related Nodes - - FROM vlan + - TO allotted-resource( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE) + - TO logical-link( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - CONFIGURATION is DELETED when these are DELETED METADATUM + - CONFIGURATION deletion means associated objects of these types are also DELETED:ALLOTTED-RESOURCE,LOGICAL-LINK required: - - multicast-configuration-id - - multicast-protocol - - rp-type + - configuration-id + - configuration-type + - configuration-sub-type + - orchestration-status + - operational-status + - configuration-selflink + - model-customization-id properties: - multicast-configuration-id: + configuration-id: type: string - description: Unique id of multicast configuration. - multicast-protocol: + description: UUID assigned to configuration. + management-option: type: string - description: protocol of multicast configuration - rp-type: + description: Indicates the entity that will manage this feature. Could be an organization or the name of the application as well. + configuration-name: type: string - description: rp type of multicast configuration + description: Name of the configuration. + configuration-type: + type: string + description: port-mirroring-configuration. + configuration-sub-type: + type: string + description: vprobe, pprobe. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + orchestration-status: + type: string + description: Orchestration status of the configuration. + operational-status: + type: string + description: Indicator for whether the resource is considered operational. + configuration-selflink: + type: string + description: URL to endpoint where AAI can get more details from SDN-GC. + model-customization-id: + type: string + description: id of the configuration used to customize the resource resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. relationship-list: type: array items: - $ref: "#/definitions/relationship" - multicast-configurations: + $ref: "#/getDefinitions/relationship" + metadata: + type: array + items: + $ref: "#/getDefinitions/metadatum" + configurations: description: | - multicast configuration of generic-vnf ip-address + Collection of configurations properties: - multicast-configuration: + configuration: type: array items: - $ref: "#/definitions/multicast-configuration" + $ref: "#/getDefinitions/configuration" + connector: + description: | + Collection of resource instances used to connect a variety of disparate inventory widgets + ###### Related Nodes + - TO virtual-data-center( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY) + - CONNECTOR is DELETED when these are DELETED METADATUM + required: + - resource-instance-id + properties: + resource-instance-id: + type: string + description: Unique id of resource instance. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + widget-model-id: + type: string + description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. + widget-model-version: + type: string + description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + metadata: + type: array + items: + $ref: "#/getDefinitions/metadatum" + connectors: + description: | + Collection of resource instances used to connect a variety of disparate inventory widgets + properties: + connector: + type: array + items: + $ref: "#/getDefinitions/connector" + constrained-element-set: + description: | + This is how we would capture constraints defining allowed sets of elements. + ###### Related Nodes + - TO model-constraint( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE) + - TO model-element( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM element-choice-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE) + - CONSTRAINED-ELEMENT-SET is DELETED when these are DELETED ELEMENT-CHOICE-SET + required: + - constrained-element-set-uuid + - constraint-type + - check-type + properties: + constrained-element-set-uuid: + type: string + constraint-type: + type: string + check-type: + type: string + resource-version: + type: string + element-choice-sets: + type: array + items: + $ref: "#/getDefinitions/element-choice-set" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + constrained-element-sets: + properties: + constrained-element-set: + type: array + items: + $ref: "#/getDefinitions/constrained-element-set" + ctag-assignment: + description: | + ###### Related Nodes + - TO l3-network( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY) + required: + - vlan-id-inner + properties: + vlan-id-inner: + type: integer + format: int64 + description: id. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + ctag-assignments: + properties: + ctag-assignment: + type: array + items: + $ref: "#/getDefinitions/ctag-assignment" + ctag-pool: + description: | + A collection of C tags (vlan tags) grouped for a specific purpose. + ###### Related Nodes + - TO complex( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE) + - TO availability-zone( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + required: + - target-pe + - availability-zone-name + - ctag-pool-purpose + properties: + target-pe: + type: string + description: The Target provider edge router + availability-zone-name: + type: string + description: Name of the availability zone + ctag-pool-purpose: + type: string + description: Describes what the intended purpose of this pool is. + ctag-values: + type: string + description: Comma separated list of ctags + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + ctag-pools: + properties: + ctag-pool: + type: array + items: + $ref: "#/getDefinitions/ctag-pool" + customer: + description: | + customer identifiers to provide linkage back to BSS information. + ###### Related Nodes + - FROM service-subscription( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE) + - CUSTOMER is DELETED when these are DELETED SERVICE-SUBSCRIPTION + required: + - global-customer-id + - subscriber-name + - subscriber-type + properties: + global-customer-id: + type: string + description: Global customer id used across ECOMP to uniquely identify customer. + subscriber-name: + type: string + description: Subscriber name, an alternate way to retrieve a customer. + subscriber-type: + type: string + description: Subscriber type, a way to provide VID with only the INFRA customers. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + service-subscriptions: + type: array + items: + $ref: "#/getDefinitions/service-subscription" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + customers: + description: | + Collection of customer identifiers to provide linkage back to BSS information. + properties: + customer: + type: array + items: + $ref: "#/getDefinitions/customer" cvlan-tag-entry: required: - cvlan-tag @@ -44778,107 +62770,127 @@ definitions: relationship-list: type: array items: - $ref: "#/definitions/relationship" + $ref: "#/getDefinitions/relationship" cvlan-tags: properties: cvlan-tag-entry: type: array items: - $ref: "#/definitions/cvlan-tag-entry" - port-group: + $ref: "#/getDefinitions/cvlan-tag-entry" + dvs-switch: description: | - Used to capture the network interfaces of this VCE + Digital virtual switch metadata, used by SDN-C to configure VCEs. A&AI needs to receive this data from the PO deployment team and administer it using the provisioningTool.sh into A&AI. ###### Related Nodes - - TO cvlan-tag (comprises port-group, Many2Many) - - FROM vce (is composed of port-group) + - TO cloud-region( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO availability-zone( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY) required: - - interface-id - - orchestration-status + - switch-name + - vcenter-url properties: - interface-id: - type: string - description: Unique ID of the interface - neutron-network-id: - type: string - description: Neutron network id of this Interface - neutron-network-name: + switch-name: type: string - description: Neutron network name of this Interface - interface-role: + description: DVS switch name + vcenter-url: type: string - description: Role assigned to this Interface, should use values as defined in ECOMP Yang models. + description: URL used to reach the vcenter resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - port-group-id: + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + dvs-switches: + description: | + Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs. + properties: + dvs-switch: + type: array + items: + $ref: "#/getDefinitions/dvs-switch" + edge-prop-names: + description: | + Internal map to define the properties of an edge and interpret the map EdgeRules + properties: + edgeLabel: type: string - description: Unique ID for port group in vmware - port-group-name: + direction: type: string - description: Likely to duplicate value of neutron network name - switch-name: + multiplicityRule: type: string - description: DVS or standard switch name (should be non-null for port groups associated with DVS) - orchestration-status: + contains-other-v: type: string - description: Orchestration status of this VNF, mastered by MSO - heat-stack-id: + delete-other-v: type: string - description: Heat stack id corresponding to this instance, managed by MSO - mso-catalog-key: + SVC-INFRA: type: string - description: Corresponds to the SDN-C catalog id used to configure this VCE - cvlan-tags: + prevent-delete: + type: string + edge-tag-query-request: + properties: + edge-tag: + type: string + result-detail: + type: string + start-node-type: + type: string + start-node-filter: type: array - items: - $ref: "#/definitions/cvlan-tag-entry" - relationship-list: + items: + $ref: "#/getDefinitions/start-node-filter" + include-node-filter: type: array - items: - $ref: "#/definitions/relationship" - port-groups: + items: + $ref: "#/getDefinitions/include-node-filter" + secondary-filter: + type: array + items: + $ref: "#/getDefinitions/secondary-filter" + edge-tag-query-result: properties: - port-group: + tagged-inventory-item-list: type: array items: - $ref: "#/definitions/port-group" - license: + $ref: "#/getDefinitions/tagged-inventory-item-list" + element-choice-set: description: | - Metadata for license group. + This is how we would capture constraints defining allowed sets of elements. ###### Related Nodes - - FROM generic-vnf (is composed of license) - - FROM vce (is composed of license) + - TO constrained-element-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE) + - ELEMENT-CHOICE-SET is DELETED when these are DELETED MODEL-ELEMENT required: - - group-uuid - - resource-uuid + - element-choice-set-uuid + - element-choice-set-name properties: - group-uuid: + element-choice-set-uuid: type: string - description: Unique ID for the license group the resource belongs to, should be uuid. - resource-uuid: + element-choice-set-name: + type: string + cardinality: type: string - description: Unique ID of a license resource. resource-version: type: string - description: Concurrency value + model-elements: + type: array + items: + $ref: "#/getDefinitions/model-element" relationship-list: type: array items: - $ref: "#/definitions/relationship" - licenses: - description: | - Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management + $ref: "#/getDefinitions/relationship" + element-choice-sets: properties: - license: + element-choice-set: type: array items: - $ref: "#/definitions/license" + $ref: "#/getDefinitions/element-choice-set" entitlement: description: | Metadata for entitlement group. ###### Related Nodes - - FROM generic-vnf (is composed of entitlement) - - FROM vce (is composed of entitlement) + - TO generic-vnf( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO vce( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) required: - group-uuid - resource-uuid @@ -44895,7 +62907,7 @@ definitions: relationship-list: type: array items: - $ref: "#/definitions/relationship" + $ref: "#/getDefinitions/relationship" entitlements: description: | Entitlements, keyed by group-uuid and resource-uuid, related to license management @@ -44903,26 +62915,496 @@ definitions: entitlement: type: array items: - $ref: "#/definitions/entitlement" - vce: + $ref: "#/getDefinitions/entitlement" + esr-ems: description: | - Virtual Customer Edge Router, used specifically for Gamma. This object is deprecated. + Persist EMS address information used by EMS driver. + ###### Related Nodes + - TO esr-system-info (CHILD of esr-ems, esr-ems has esr-system-info, One2Many) + - ESR-EMS deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO + required: + - ems-id + properties: + ems-id: + type: string + description: Unique ID of EMS. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + esr-system-info-list: + type: object + $ref: "#/getDefinitions/esr-system-info-list" + relationship-list: + type: object + $ref: "#/getDefinitions/relationship-list" + esr-ems-list: + properties: + esr-ems: + type: array + items: + $ref: "#/getDefinitions/esr-ems" + esr-system-info: + description: | + Persist common address information of external systems. + ###### Related Nodes + - FROM esr-ems (PARENT of esr-system-info, esr-ems has esr-system-info) + - FROM esr-vnfm (PARENT of esr-system-info, esr-vnfm has esr-system-info) + - FROM esr-thirdparty-sdnc (PARENT of esr-system-info, esr-thirdparty-sdnc has esr-system-info) + - FROM cloud-region (PARENT of esr-system-info, cloud-region has esr-system-info) + required: + - esr-system-info-id + - user-name + - password + - system-type + properties: + esr-system-info-id: + type: string + description: Unique ID of esr system info. + system-name: + type: string + description: name of external system. + type: + type: string + description: type of external systems. + vendor: + type: string + description: vendor of external systems. + version: + type: string + description: version of external systems. + service-url: + type: string + description: url used to access external systems. + user-name: + type: string + description: username used to access external systems. + password: + type: string + description: password used to access external systems. + system-type: + type: string + description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm. + protocol: + type: string + description: protocol of third party SDNC, for example netconf/snmp. + ssl-cacert: + type: string + description: ca file content if enabled ssl on auth-url. + ssl-insecure: + type: boolean + description: Whether to verify VIM's certificate. + ip-address: + type: string + description: service IP of ftp server. + port: + type: string + description: service port of ftp server. + cloud-domain: + type: string + description: domain info for authentication. + default-tenant: + type: string + description: default tenant of VIM. + passive: + type: boolean + description: ftp passive mode or not. + remote-path: + type: string + description: resource or performance data file path. + system-status: + type: string + description: the status of external system. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + esr-system-info-list: + description: | + Collection of persistent block-level external system auth info. + properties: + esr-system-info: + type: array + items: + $ref: "#/getDefinitions/esr-system-info" + esr-thirdparty-sdnc: + description: | + Persist SDNC address information used by ONAP SDNC. + ###### Related Nodes + - TO esr-system-info (CHILD of esr-thirdparty-sdnc, esr-thirdparty-sdnc has esr-system-info, One2One) + - TO pnf( esr-thirdparty-sdnc has pnf, One2Many) + - ESR-THIRDPARTY-SDNC deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO + required: + - thirdparty-sdnc-id + properties: + thirdparty-sdnc-id: + type: string + description: Unique ID of SDNC. + location: + type: string + description: used for DC type to indicate the location of SDNC, such as Core or Edge. + product-name: + type: string + description: password used to access SDNC server. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + esr-system-info-list: + type: object + $ref: "#/getDefinitions/esr-system-info-list" + relationship-list: + type: object + $ref: "#/getDefinitions/relationship-list" + esr-thirdparty-sdnc-list: + properties: + esr-thirdparty-sdnc: + type: array + items: + $ref: "#/getDefinitions/esr-thirdparty-sdnc" + esr-vnfm: + description: | + Persist VNFM address information used by VF-C. ###### Related Nodes - - TO availability-zone (Many2Many) - - TO complex (Many2Many) - - TO port-group (comprises vce, Many2Many) - - TO vserver (Many2Many) - - TO service-instance (Many2Many) - - TO entitlement (comprises vce, One2Many) - - TO license (comprises vce, One2Many) + - TO esr-system-info (CHILD of esr-vnfm, esr-vnfm has esr-system-info, One2One) + - ESR-VNFM deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO + required: + - vnfm-id + properties: + vnfm-id: + type: string + description: Unique ID of VNFM. + vim-id: + type: string + description: indecate the VIM to deploy VNF. + certificate-url: + type: string + description: certificate url of VNFM. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + esr-system-info-list: + type: object + $ref: "#/getDefinitions/esr-system-info-list" + relationship-list: + type: object + $ref: "#/getDefinitions/relationship-list" + esr-vnfm-list: + properties: + esr-vnfm: + type: array + items: + $ref: "#/getDefinitions/esr-vnfm" + evc: + description: | + evc object is an optional child object of the Configuration object. + ###### Related Nodes + - TO configuration( evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE) + required: + - evc-id + properties: + evc-id: + type: string + description: Unique/key field for the evc object + forwarding-path-topology: + type: string + description: Point-to-Point, Multi-Point + cir-value: + type: string + description: Commited Information Rate + cir-units: + type: string + description: CIR units + connection-diversity-group-id: + type: string + description: Diversity Group ID + service-hours: + type: string + description: formerly Performance Group + esp-evc-circuit-id: + type: string + description: EVC Circuit ID of ESP EVC + esp-evc-cir-value: + type: string + description: Committed Information Rate (For ESP) + esp-evc-cir-units: + type: string + description: CIR units (For ESP) + esp-itu-code: + type: string + description: Identifies ESP + collector-pop-clli: + type: string + description: Collector POP CLLI (from the hostname of the access pnf) + inter-connect-type-ingress: + type: string + description: Interconnect type on ingress side of EVC. + tagmode-access-ingress: + type: string + description: tagode for collector side of EVC + tagmode-access-egress: + type: string + description: tagMode for network side of EVC + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + evcs: + properties: + evc: + type: array + items: + $ref: "#/getDefinitions/evc" + external-system: + description: | + Namespace for external system. + properties: + esr-ems-list: + type: object + $ref: "#/getDefinitions/esr-ems-list" + esr-vnfm-list: + type: object + $ref: "#/getDefinitions/esr-vnfm-list" + esr-thirdparty-sdnc-list: + type: object + $ref: "#/getDefinitions/esr-thirdparty-sdnc-list" + extra-properties: + description: | + Extra properties for inventory item for response list + properties: + extra-property: + type: array + items: + $ref: "#/getDefinitions/extra-property" + extra-property: + properties: + property-name: + type: string + property-value: + type: string + flavor: + description: | + Openstack flavor. + ###### Related Nodes + - TO cloud-region( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vserver( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE) + - FLAVOR cannot be deleted if linked to VSERVER + required: + - flavor-id + - flavor-name + - flavor-selflink + properties: + flavor-id: + type: string + description: Flavor id, expected to be unique across cloud-region. + flavor-name: + type: string + description: Flavor name + flavor-vcpus: + type: integer + format: int32 + description: Number of CPUs + flavor-ram: + type: integer + format: int32 + description: Amount of memory + flavor-disk: + type: integer + format: int32 + description: Disk space + flavor-ephemeral: + type: integer + format: int32 + description: Amount of ephemeral disk space + flavor-swap: + type: string + description: amount of swap space allocation + flavor-is-public: + type: boolean + description: whether flavor is available to all users or private to the tenant it was created in. + flavor-selflink: + type: string + description: URL to endpoint where AAI can get more details + flavor-disabled: + type: boolean + description: Boolean as to whether this flavor is no longer enabled + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + flavors: + description: | + Collection of openstack flavors. + properties: + flavor: + type: array + items: + $ref: "#/getDefinitions/flavor" + forwarder: + description: | + Entity describing a sequenced segment of forwarding path + ###### Related Nodes + - TO forwarding-path( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE) + - TO l-interface( forwarder org.onap.relationships.inventory.ForwardsTo l-interface, MANY2ONE) + - TO configuration( forwarder org.onap.relationships.inventory.Uses configuration, ONE2ONE) + - TO lag-interface( forwarder org.onap.relationships.inventory.ForwardsTo lag-interface, MANY2ONE) + - TO p-interface( forwarder org.onap.relationships.inventory.ForwardsTo p-interface, MANY2ONE) + - FORWARDER deletion means associated objects of these types are also DELETED:CONFIGURATION + required: + - sequence + properties: + sequence: + type: integer + format: int32 + description: Unique ID of this segmentation + forwarder-role: + type: string + description: ingress, intermediate, egress + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + forwarder-evc: + description: | + forwarder object is an optional child object of the Configuration object. + ###### Related Nodes + - TO configuration( forwarder-evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE) + required: + - forwarder-evc-id + properties: + forwarder-evc-id: + type: string + description: Key for forwarder-evc object + circuit-id: + type: string + description: Circuit ID from customer/ESP/ingress end of EVC, or reference to beater circuit on gateway/network/egress end of EVC + ivlan: + type: string + description: Internal VLAN. + svlan: + type: string + description: SVLAN value for ingress of egress forwarder. + cvlan: + type: string + description: CVLAN value for ingress of egress forwarder. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + forwarder-evcs: + properties: + forwarder-evc: + type: array + items: + $ref: "#/getDefinitions/forwarder-evc" + forwarders: + properties: + forwarder: + type: array + items: + $ref: "#/getDefinitions/forwarder" + forwarding-path: + description: | + Entity that describes the sequenced forwarding path between interfaces of services or resources + ###### Related Nodes + - TO service-instance( forwarding-path org.onap.relationships.inventory.AppliesTo service-instance, MANY2ONE) + - TO configuration( forwarding-path org.onap.relationships.inventory.Uses configuration, ONE2ONE) + - FROM forwarder( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE) + - FORWARDING-PATH is DELETED when these are DELETED FORWARDER + - FORWARDING-PATH deletion means associated objects of these types are also DELETED:CONFIGURATION + required: + - forwarding-path-id + - forwarding-path-name + properties: + forwarding-path-id: + type: string + description: Unique ID of this FP + forwarding-path-name: + type: string + description: Name of the FP + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + selflink: + type: string + description: the self link for this FP + forwarders: + type: array + items: + $ref: "#/getDefinitions/forwarder" + forwarding-paths: + properties: + forwarding-path: + type: array + items: + $ref: "#/getDefinitions/forwarding-path" + generic-vnf: + description: | + General purpose VNF + ###### Related Nodes + - TO availability-zone( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - TO complex( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - TO configuration( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - TO ctag-pool( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + - TO instance-group( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO ipsec-configuration( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE) + - TO l3-network( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - TO license-key-resource( generic-vnf org.onap.relationships.inventory.Uses license-key-resource, MANY2MANY) + - TO pnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY) + - TO pserver( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY) + - TO vnf-image( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE) + - TO volume-group( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + - TO vserver( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY) + - TO virtual-data-center( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY) + - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM vnfc( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM lag-interface( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM license( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM network-profile( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY) + - FROM site-pair-set( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - FROM line-of-business( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY) + - FROM platform( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + - GENERIC-VNF is DELETED when these are DELETED ENTITLEMENT,VNFC,LAG-INTERFACE,LICENSE,L-INTERFACE,VF-MODULE + - GENERIC-VNF deletion means associated objects of these types are also DELETED:CONFIGURATION required: - vnf-id + - vnf-instance-id - vnf-name - vnf-type + - vnf-package-name + - vnf-discriptor-name + - job-id + - in-maint + - is-closed-loop-disabled properties: vnf-id: type: string description: Unique id of VNF. This is unique across the graph. + vnf-instance-id: + type: string + description: vnf instance id. vnf-name: type: string description: Name of VNF. @@ -44934,7 +63416,7 @@ definitions: description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. service-id: type: string - description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED. + description: Unique identifier of service, does not necessarily map to ASDC service models. SOON TO BE DEPRECATED regional-resource-zone: type: string description: Regional way of organizing pservers, source of truth should define values @@ -44943,140 +63425,231 @@ definitions: description: Trigger for operational monitoring of this resource by Service Assurance systems. operational-status: type: string - description: Indicator for whether the resource is considered operational + description: Indicator for whether the resource is considered operational. Valid values are in-service-path and out-of-service-path. license-key: type: string description: OBSOLETE - do not use equipment-role: type: string - description: Network role being played by this VNF + description: Client should send valid enumerated value orchestration-status: type: string - description: Orchestration status of this VNF, mastered by MSO + description: Orchestration status of this VNF, used by MSO. + vnf-package-name: + type: string + vnf-discriptor-name: + type: string + description: vnf discriptor name + job-id: + type: string + description: job id corresponding to vnf heat-stack-id: type: string description: Heat stack id corresponding to this instance, managed by MSO mso-catalog-key: type: string description: Corresponds to the SDN-C catalog id used to configure this VCE - vpe-id: - type: string - description: Unique ID of VPE connected to this VCE. - v6-vce-wan-address: + management-option: type: string - description: Valid v6 IP address for the WAN Link on this router. Implied length of /64. + description: identifier of managed by ATT or customer ipv4-oam-address: type: string - description: Address tail-f uses to configure vce, also used for troubleshooting and is IP used for traps generated by VCE. + description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by generic-vnf. + ipv4-loopback0-address: + type: string + description: v4 Loopback0 address + nm-lan-v6-address: + type: string + description: v6 Loopback address + management-v6-address: + type: string + description: v6 management address + vcpu: + type: integer + format: int64 + description: number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE + vcpu-units: + type: string + description: units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE + vmemory: + type: integer + format: int64 + description: number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE + vmemory-units: + type: string + description: units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE + vdisk: + type: integer + format: int64 + description: number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE + vdisk-units: + type: string + description: units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE + nshd: + type: integer + format: int64 + description: number of associated SHD in vnf. + nvm: + type: integer + format: int64 + description: number of vms in vnf. + nnet: + type: integer + format: int64 + description: number of network in vnf. + in-maint: + type: boolean + is-closed-loop-disabled: + type: boolean resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - ipv4-loopback0-address: + summary-status: type: string - description: Loopback0 address + description: details regarding the generic-vnf operation, PLEASE DISCONTINUE USE OF THIS FIELD. + encrypted-access-flag: + type: boolean + description: indicates whether generic-vnf access uses SSH + entitlement-assignment-group-uuid: + type: string + description: UUID of the Entitlement group used for licensing VNFs, OBSOLETE - See child relationships. entitlement-resource-uuid: type: string - description: OBSOLETE - see child relationships - port-groups: + description: UUID of the specific entitlement resource. OBSOLETE - See child relationships. + license-assignment-group-uuid: + type: string + description: UUID of the license assignment group. OBSOLETE - See child relationships. + license-key-uuid: + type: string + description: UUID of the actual license resource. OBSOLETE - See child relationships. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + model-customization-id: + type: string + description: captures the id of all the configuration used to customize the resource for the service. + widget-model-id: + type: string + description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. + widget-model-version: + type: string + description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. + as-number: + type: string + description: as-number of the VNF + regional-resource-subzone: + type: string + description: represents sub zone of the rr plane + nf-type: + type: string + description: Generic description of the type of NF + nf-function: + type: string + description: English description of Network function that the specific VNF deployment is providing + nf-role: + type: string + description: role in the network that this model will be providing + nf-naming-code: + type: string + description: string assigned to this model used for naming purposes + selflink: + type: string + description: Path to the controller object. + ipv4-oam-gateway-address: + type: string + description: Gateway address + ipv4-oam-gateway-address-prefix-length: + type: integer + format: int32 + description: Prefix length for oam-address + vlan-id-outer: + type: integer + format: int64 + description: Temporary location for S-TAG to get to VCE + nm-profile-name: + type: string + description: Network Management profile of this VNF + relationship-list: type: array items: - $ref: "#/definitions/port-group" - licenses: + $ref: "#/getDefinitions/relationship" + l-interfaces: type: array items: - $ref: "#/definitions/license" - entitlements: + $ref: "#/getDefinitions/l-interface" + lag-interfaces: type: array items: - $ref: "#/definitions/entitlement" - relationship-list: + $ref: "#/getDefinitions/lag-interface" + vf-modules: type: array items: - $ref: "#/definitions/relationship" - vces: + $ref: "#/getDefinitions/vf-module" + licenses: + type: array + items: + $ref: "#/getDefinitions/license" + entitlements: + type: array + items: + $ref: "#/getDefinitions/entitlement" + generic-vnfs: description: | - Collection of Virtual Customer Edge Routers, used specifically for Gamma. This object is deprecated. + Collection of VNFs properties: - vce: + generic-vnf: type: array items: - $ref: "#/definitions/vce" - vnfc: + $ref: "#/getDefinitions/generic-vnf" + group-assignment: description: | + Openstack group-assignment used to store exclusivity groups (EG). ###### Related Nodes - - TO instance-group (Many2Many) - - TO vip-ipv4-address-list (Many2Many) - - TO vip-ipv6-address-list (Many2Many) - - FROM vserver - - FROM vf-module - - FROM generic-vnf - - FROM l3-interface-ipv4-address-list (comprises vnfc) - - FROM l3-interface-ipv6-address-list (comprises vnfc) + - TO cloud-region( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM pserver( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY) required: - - vnfc-name - - nfc-naming-code - - nfc-function - - in-maint - - is-closed-loop-disabled + - group-id + - group-type + - group-name properties: - vnfc-name: - type: string - description: Unique ID of vnfc. - nfc-naming-code: - type: string - description: Short code that is used in naming instances of the item being modeled - nfc-function: - type: string - description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service - prov-status: - type: string - description: prov status of this vnfc - orchestration-status: - type: string - description: Orchestration status of this VNF, mastered by APP-C - ipaddress-v4-oam-vip: + group-id: type: string - description: Oam V4 vip address of this vnfc - in-maint: - type: boolean - is-closed-loop-disabled: - type: boolean - group-notation: + description: Group id, expected to be unique across cloud-region. + group-type: type: string - description: Group notation of VNFC - model-invariant-id: + description: Group type - the type of group this instance refers to + group-name: type: string - description: the ASDC model id for this resource or service model. - model-version-id: + description: Group name - name assigned to the group + group-description: type: string - description: the ASDC model version for this resource or service model. + description: Group description - description of the group resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. relationship-list: type: array items: - $ref: "#/definitions/relationship" - l3-interface-ipv4-address-list: - type: array - items: - $ref: "#/definitions/l3-interface-ipv4-address-list" - l3-interface-ipv6-address-list: - type: array - items: - $ref: "#/definitions/l3-interface-ipv6-address-list" - vnfcs: + $ref: "#/getDefinitions/relationship" + group-assignments: description: | - virtual network components associated with a vserver from application controller. + Collection of openstack group assignments properties: - vnfc: + group-assignment: type: array items: - $ref: "#/definitions/vnfc" + $ref: "#/getDefinitions/group-assignment" host-route: description: | ###### Related Nodes - - FROM subnet (is composed of host-route) + - TO subnet( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE) required: - host-route-id - route-prefix @@ -45100,156 +63673,525 @@ definitions: relationship-list: type: array items: - $ref: "#/definitions/relationship" + $ref: "#/getDefinitions/relationship" host-routes: properties: host-route: type: array items: - $ref: "#/definitions/host-route" - subnet: + $ref: "#/getDefinitions/host-route" + image: description: | + Openstack image. ###### Related Nodes - - TO host-route (comprises subnet, One2Many) - - FROM l3-interface-ipv4-address-list - - FROM l3-interface-ipv6-address-list - - FROM l3-network (is composed of subnet) - - FROM vip-ipv4-address-list - - FROM vip-ipv6-address-list + - TO cloud-region( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE) + - FROM vserver( vserver org.onap.relationships.inventory.Uses image, MANY2ONE) + - IMAGE cannot be deleted if linked to VSERVER + - IMAGE is DELETED when these are DELETED METADATUM required: - - subnet-id - - dhcp-enabled + - image-id + - image-name + - image-os-distro + - image-os-version + - image-selflink properties: - subnet-id: + image-id: type: string - description: Subnet ID, should be UUID. - subnet-name: + description: Image id, expected to be unique across cloud region + image-name: type: string - description: Name associated with the subnet. - neutron-subnet-id: + description: Image name + image-architecture: type: string - description: Neutron id of this subnet - gateway-address: + description: Operating system architecture. + image-os-distro: type: string - description: gateway ip address - network-start-address: + description: The common name of the operating system distribution in lowercase + image-os-version: type: string - description: network start address - cidr-mask: + description: The operating system version as specified by the distributor. + application: type: string - description: cidr mask - ip-version: + description: The application that the image instantiates. + application-vendor: type: string - description: ip version - orchestration-status: + description: The vendor of the application. + application-version: type: string - description: Orchestration status of this VNF, mastered by MSO - dhcp-enabled: - type: boolean - dhcp-start: + description: The version of the application. + image-selflink: type: string - description: the start address reserved for use by dhcp - dhcp-end: + description: URL to endpoint where AAI can get more details + resource-version: type: string - description: the last address reserved for use by dhcp - subnet-role: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + metadata: + type: array + items: + $ref: "#/getDefinitions/metadatum" + images: + description: | + Collectio of Openstack images. + properties: + image: + type: array + items: + $ref: "#/getDefinitions/image" + include-node-filter: + properties: + include-node-type: type: string - description: role of the subnet, referenced when assigning IPs - ip-assignment-direction: + instance-filter: + description: | + InstanceFilter for performing a named-query or model query + instance-filters: + description: | + InstanceFilters for performing a named-query or model query + properties: + instance-filter: + type: array + items: + $ref: "#/getDefinitions/instance-filter" + instance-group: + description: | + General mechanism for grouping instances + ###### Related Nodes + - TO model( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - FROM l3-network( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM l-interface( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM pnf( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - FROM vnfc( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + required: + - instance-group-role + - model-invariant-id + - model-version-id + - id + - description + - type + properties: + instance-group-role: type: string - description: ip address assignment direction of the subnet + description: role of the instance group. + model-invariant-id: + type: string + description: ASDC model id for this resource or service model. + model-version-id: + type: string + description: ASDC model version uid for this resource model. + id: + type: string + description: Instance Group ID, UUID assigned to this instance. + description: + type: string + description: Descriptive text to help identify the usage of this instance-group + type: + type: string + description: Only valid value today is lower case ha for high availability + sub-type: + type: string + description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby] resource-version: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - subnet-sequence: - type: integer - format: int32 - description: sequence of the subnet - host-routes: + description: Concurrency value + relationship-list: type: array items: - $ref: "#/definitions/host-route" - relationship-list: + $ref: "#/getDefinitions/relationship" + instance-groups: + description: | + Collection of openstack route table references + properties: + instance-group: + type: array + items: + $ref: "#/getDefinitions/instance-group" + inventory: + properties: + search: + type: object + $ref: "#/getDefinitions/search" + actions: + type: object + $ref: "#/getDefinitions/actions" + cloud-infrastructure: + type: object + $ref: "#/getDefinitions/cloud-infrastructure" + external-system: + type: object + $ref: "#/getDefinitions/external-system" + business: + type: object + $ref: "#/getDefinitions/business" + service-design-and-creation: + type: object + $ref: "#/getDefinitions/service-design-and-creation" + network: + type: object + $ref: "#/getDefinitions/network" + aai-internal: + type: object + $ref: "#/getDefinitions/aai-internal" + nodes: type: array items: - $ref: "#/definitions/relationship" - subnets: + $ref: "#/getDefinitions/aai-internal" + inventory-item: properties: - subnet: + inventory-item-type: + type: string + inventory-item-link: + type: string + inventory-item-data: type: array items: - $ref: "#/definitions/subnet" - ctag-assignment: + $ref: "#/getDefinitions/inventory-item-data" + tagged-inventory-item-list: + type: array + items: + $ref: "#/getDefinitions/tagged-inventory-item-list" + inventory-item-data: + properties: + property-name: + type: string + property-value: + type: string + inventory-response-item: + description: | + Inventory item for response list + properties: + model-name: + type: string + extra-properties: + type: object + $ref: "#/getDefinitions/extra-properties" + inventory-response-items: + type: object + $ref: "#/getDefinitions/inventory-response-items" + inventory-response-items: description: | + Container for inventory items in response list + properties: + inventory-response-item: + type: array + items: + $ref: "#/getDefinitions/inventory-response-item" + ipsec-configuration: + description: | + IPSec configuration node will contain various configuration data for the NMTE VNF. This node will have an edge to the generic-vnf (vnf type = TE). Starting 1607, this data will be populated by SDN-C ###### Related Nodes - - FROM l3-network (is composed of ctag-assignment) - - FROM service-instance + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE) + - FROM vig-server( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE) + - IPSEC-CONFIGURATION is DELETED when these are DELETED VIG-SERVER required: - - vlan-id-inner + - ipsec-configuration-id properties: - vlan-id-inner: - type: integer - format: int64 - description: id. + ipsec-configuration-id: + type: string + description: UUID of this configuration + requested-vig-address-type: + type: string + description: Indicate the type of VIG server like AVPN, INTERNET, BOTH + requested-encryption-strength: + type: string + description: Encryption values like 3des-cbc, des-cbc, aes-128-cbc, aes-192-cbc, aes-265-cbc + requested-dmz-type: + type: string + description: ATT can offer a shared DMZ or a DMZ specific to a customer + shared-dmz-network-address: + type: string + description: Network address of shared DMZ + requested-customer-name: + type: string + description: If the DMZ is a custom DMZ, this field will indicate the customer information + ike-version: + type: string + description: can be 1 or 2 + ikev1-authentication: + type: string + description: Contains values like md5, sha1, sha256, sha384 + ikev1-encryption: + type: string + description: Encyption values like 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc + ikev1-dh-group: + type: string + description: Diffie-Hellman group like DH-GROUP2, DH-GROUP5, DH-GROUP14 + ikev1-am-group-id: + type: string + description: Group name defined in VIG for clients using aggressive mode + ikev1-am-password: + type: string + description: pre-shared key for the above group name + ikev1-sa-lifetime: + type: string + description: Lifetime for IKEv1 SA + ipsec-authentication: + type: string + description: md5, sha1, sha256, sha384 + ipsec-encryption: + type: string + description: 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc + ipsec-sa-lifetime: + type: string + description: Life time for IPSec SA + ipsec-pfs: + type: string + description: enable PFS or not + xauth-userid: + type: string + description: user ID for xAuth, sm-user,ucpeHostName,nmteHostName + xauth-user-password: + type: string + description: Encrypted using the Juniper $9$ algorithm + dpd-interval: + type: string + description: The time between DPD probe + dpd-frequency: + type: string + description: Maximum number of DPD before claiming the tunnel is down resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. relationship-list: type: array items: - $ref: "#/definitions/relationship" - ctag-assignments: + $ref: "#/getDefinitions/relationship" + vig-servers: + type: array + items: + $ref: "#/getDefinitions/vig-server" + ipsec-configurations: properties: - ctag-assignment: + ipsec-configuration: type: array items: - $ref: "#/definitions/ctag-assignment" - segmentation-assignment: + $ref: "#/getDefinitions/ipsec-configuration" + key-data: + properties: + key-name: + type: string + key-value: + type: string + l-interface: description: | - Openstack segmentation assignment. + Logical interfaces, e.g., a vnic. ###### Related Nodes - - FROM l3-network (is composed of segmentation-assignment) + - TO generic-vnf( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO lag-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE) + - TO instance-group( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - TO logical-link( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY) + - TO newvce( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE) + - TO p-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE) + - TO vserver( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE) + - FROM vlan( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - L-INTERFACE is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,SRIOV-VF,VLAN + - L-INTERFACE deletion means associated objects of these types are also DELETED:LOGICAL-LINK required: - - segmentation-id + - interface-name + - is-port-mirrored + - in-maint + - is-ip-unnumbered properties: - segmentation-id: + interface-name: type: string - description: Route Table Reference id, UUID assigned to this instance. + description: Name given to the interface + interface-role: + type: string + description: E.g., CUSTOMER, UPLINK, etc. + v6-wan-link-ip: + type: string + description: Questionably placed - v6 ip addr of this interface (is in vr-lan-interface from Mary B. + selflink: + type: string + description: URL to endpoint where AAI can get more details + interface-id: + type: string + description: ID of interface + macaddr: + type: string + description: MAC address for the interface + network-name: + type: string + description: Name of the network + management-option: + type: string + description: Whether A&AI should be managing this interface of not. Could have value like CUSTOMER + interface-description: + type: string + description: Human friendly text regarding this interface. + is-port-mirrored: + type: boolean resource-version: type: string - description: Concurrency value + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + in-maint: + type: boolean + prov-status: + type: string + description: Prov Status of the logical interface. Valid values [PREPROV/NVTPROV/PROV]. + is-ip-unnumbered: + type: boolean + allowed-address-pairs: + type: string + description: Freeform field for storing an ip address, list of ip addresses or a subnet block. + vlans: + type: array + items: + $ref: "#/getDefinitions/vlan" + sriov-vfs: + type: array + items: + $ref: "#/getDefinitions/sriov-vf" + l-interfaces: + type: array + items: + $ref: "#/getDefinitions/l-interface" relationship-list: type: array items: - $ref: "#/definitions/relationship" - segmentation-assignments: + $ref: "#/getDefinitions/relationship" + l3-interface-ipv4-address-list: + type: array + items: + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" + l3-interface-ipv6-address-list: + type: array + items: + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" + l-interfaces: description: | - Collection of openstack segmentation assignments + Collection of logical interfaces. properties: - segmentation-assignment: + l-interface: type: array items: - $ref: "#/definitions/segmentation-assignment" + $ref: "#/getDefinitions/l-interface" + l3-interface-ipv4-address-list: + description: | + IPv4 Address Range + ###### Related Nodes + - TO instance-group( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - TO l3-network( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - TO subnet( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - TO l-interface( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - TO vlan( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - TO vnfc( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + required: + - l3-interface-ipv4-address + properties: + l3-interface-ipv4-address: + type: string + description: IP address + l3-interface-ipv4-prefix-length: + type: integer + format: int64 + description: Prefix length, 32 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + neutron-network-id: + type: string + description: Neutron network id of the interface that address belongs to + neutron-subnet-id: + type: string + description: Neutron id of subnet that address belongs to + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + l3-interface-ipv6-address-list: + description: | + IPv6 Address Range + ###### Related Nodes + - TO instance-group( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY) + - TO l3-network( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - TO subnet( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - TO l-interface( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE) + - TO vlan( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - TO vnfc( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + required: + - l3-interface-ipv6-address + properties: + l3-interface-ipv6-address: + type: string + description: IP address + l3-interface-ipv6-prefix-length: + type: integer + format: int64 + description: Prefix length, 128 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + neutron-network-id: + type: string + description: Neutron network id of the interface that address belongs to + neutron-subnet-id: + type: string + description: Neutron id of subnet that address belongs to + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" l3-network: description: | Generic network definition ###### Related Nodes - - TO vpn-binding (Many2Many) - - TO instance-group (Many2Many) - - TO subnet (comprises l3-network, Many2Many) - - TO service-instance (Many2Many) - - TO ctag-assignment (comprises l3-network, Many2Many) - - TO network-policy (Many2Many) - - TO segmentation-assignment (comprises l3-network, One2Many) - - TO route-table-reference (Many2Many) - - FROM cloud-region - - FROM complex - - FROM generic-vnf - - FROM l3-interface-ipv4-address-list - - FROM l3-interface-ipv6-address-list - - FROM tenant - - FROM vf-module - - FROM allotted-resource + - TO instance-group( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO network-policy( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY) + - TO route-table-reference( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY) + - TO vpn-binding( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY) + - FROM cloud-region( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM complex( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY) + - FROM ctag-assignment( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM segmentation-assignment( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY) + - FROM subnet( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY) + - L3-NETWORK is DELETED when these are DELETED CTAG-ASSIGNMENT,SEGMENTATION-ASSIGNMENT,SUBNET required: - network-id - network-name @@ -45336,83 +64278,214 @@ definitions: subnets: type: array items: - $ref: "#/definitions/subnet" + $ref: "#/getDefinitions/subnet" ctag-assignments: type: array items: - $ref: "#/definitions/ctag-assignment" + $ref: "#/getDefinitions/ctag-assignment" segmentation-assignments: type: array items: - $ref: "#/definitions/segmentation-assignment" + $ref: "#/getDefinitions/segmentation-assignment" relationship-list: type: array items: - $ref: "#/definitions/relationship" + $ref: "#/getDefinitions/relationship" description: Relates to tenant (or is it a child of tenant), complex, service, vpn-binding l3-networks: properties: l3-network: type: array items: - $ref: "#/definitions/l3-network" - network-policy: + $ref: "#/getDefinitions/l3-network" + lag-interface: description: | + Link aggregate interface ###### Related Nodes - - FROM l3-network - - FROM allotted-resource + - TO generic-vnf( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO lag-link( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY) + - TO logical-link( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - TO p-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY) + - TO pnf( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - TO pserver( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - TO vpls-pe( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE) + - LAG-INTERFACE is DELETED when these are DELETED L-INTERFACE + - LAG-INTERFACE deletion means associated objects of these types are also DELETED:LAG-LINK,LOGICAL-LINK required: - - network-policy-id + - interface-name + - in-maint properties: - network-policy-id: + interface-name: type: string - description: UUID representing unique key to this instance - network-policy-fqdn: + description: Name that identifies the link aggregate interface + interface-description: type: string - description: Contrail FQDN for the policy - heat-stack-id: + description: Human friendly text regarding this interface. + resource-version: type: string - description: ID for the openStack Heat instance + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + interface-id: + type: string + description: ID of interface + interface-role: + type: string + description: Role assigned to this Interface, should use values as defined in ECOMP Yang models. + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + in-maint: + type: boolean + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + l-interfaces: + type: array + items: + $ref: "#/getDefinitions/l-interface" + lag-interfaces: + description: | + Collection of link aggregate interfaces. + properties: + lag-interface: + type: array + items: + $ref: "#/getDefinitions/lag-interface" + lag-link: + description: | + LAG links can connect lag-interfaces + ###### Related Nodes + - FROM lag-interface( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY) + required: + - link-name + properties: + link-name: + type: string + description: Alphabetical concatenation of lag-interface names resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. relationship-list: type: array items: - $ref: "#/definitions/relationship" - network-policies: + $ref: "#/getDefinitions/relationship" + lag-links: + description: | + Collection of link aggregation connections properties: - network-policy: + lag-link: type: array items: - $ref: "#/definitions/network-policy" - vf-module: + $ref: "#/getDefinitions/lag-link" + license: description: | - a deployment unit of VNFCs + Metadata for license group. ###### Related Nodes - - TO volume-group (One2One) - - TO l3-network (Many2Many) - - TO vnfc (One2Many) - - FROM vserver - - FROM generic-vnf (is composed of vf-module) + - TO generic-vnf( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO vce( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) required: - - vf-module-id - - is-base-vf-module + - group-uuid + - resource-uuid properties: - vf-module-id: + group-uuid: type: string - description: Unique ID of vf-module. - vf-module-name: + description: Unique ID for the license group the resource belongs to, should be uuid. + resource-uuid: type: string - description: Name of vf-module - heat-stack-id: + description: Unique ID of a license resource. + resource-version: type: string - description: Heat stack id corresponding to this instance. - orchestration-status: + description: Concurrency value + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + licenses: + description: | + Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management + properties: + license: + type: array + items: + $ref: "#/getDefinitions/license" + line-of-business: + description: | + describes a line-of-business + ###### Related Nodes + - TO generic-vnf( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + required: + - line-of-business-name + properties: + line-of-business-name: type: string - description: orchestration status of this vf-module, mastered by MSO - is-base-vf-module: + description: Name of the line-of-business (product) + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + lines-of-business: + description: | + Collection of lines-of-business + properties: + line-of-business: + type: array + items: + $ref: "#/getDefinitions/line-of-business" + logical-link: + description: | + Logical links generally connect l-interfaces but are used to express logical connectivity between two points + ###### Related Nodes + - TO cloud-region( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY) + - TO generic-vnf( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY) + - TO lag-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY) + - TO logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - TO pnf( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY) + - TO pserver( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY) + - TO vpn-binding( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - TO virtual-data-center( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM configuration( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - FROM l-interface( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY) + - FROM p-interface( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - FROM vlan( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + required: + - link-name + - in-maint + - link-type + properties: + link-name: + type: string + description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ + in-maint: type: boolean + link-type: + type: string + description: Type of logical link, e.g., evc + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + ip-version: + type: string + description: v4, v6, or ds for dual stack + routing-protocol: + type: string + description: For example, static or BGP resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. @@ -45425,292 +64498,519 @@ definitions: persona-model-version: type: string description: the ASDC model version for this resource or service model. - model-customization-id: - type: string - description: captures the id of all the configuration used to customize the resource for the service. widget-model-id: type: string description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. widget-model-version: type: string description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. - contrail-service-instance-fqdn: + operational-status: type: string - description: the Contrail unique ID for a service-instance - module-index: - type: integer - format: int32 - description: the index will track the number of modules of a given type that have been deployed in a VNF, starting with 0, and always choosing the lowest available digit - selflink: + description: Indication of operational status of the logical link. + prov-status: type: string - description: Path to the controller object. + description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. + link-role: + type: string + description: Indication of the network use of the logical link. + link-name2: + type: string + description: Alias or alternate name (CLCI or D1 name). + link-id: + type: string + description: UUID of the logical-link, SDNC generates this. + circuit-id: + type: string + description: Circuit id + purpose: + type: string + description: Reason for this entity, role it is playing relationship-list: type: array items: - $ref: "#/definitions/relationship" - vf-modules: + $ref: "#/getDefinitions/relationship" + logical-links: description: | - Collection of vf-modules, a deployment unit of VNFCs + Collection of logical connections properties: - vf-module: + logical-link: type: array items: - $ref: "#/definitions/vf-module" - generic-vnf: + $ref: "#/getDefinitions/logical-link" + metadata: description: | - General purpose VNF + Collection of metadatum (key/value pairs) + properties: + metadatum: + type: array + items: + $ref: "#/getDefinitions/metadatum" + metadatum: + description: | + Key/value pairs ###### Related Nodes - - TO license-key-resource (Many2Many) - - TO l-interface (comprises generic-vnf, Many2Many) - - TO availability-zone (Many2Many) - - TO lag-interface (comprises generic-vnf, Many2Many) - - TO l3-network (Many2Many) - - TO pserver (Many2Many) - - TO vnf-image (Many2One) - - TO vserver (One2Many) - - TO service-instance (Many2Many) - - TO site-pair-set (Many2Many) - - TO network-profile (Many2Many) - - TO pnf (Many2Many) - - TO ipsec-configuration (Many2One) - - TO configuration (One2Many) - - TO vf-module (comprises generic-vnf, One2Many) - - TO volume-group (One2Many) - - TO vnfc (One2Many) - - TO instance-group (Many2Many) - - TO entitlement (comprises generic-vnf, One2Many) - - TO license (comprises generic-vnf, One2Many) - - TO complex (Many2Many) - - TO ctag-pool (Many2Many) - - FROM line-of-business - - FROM platform - - FROM virtual-data-center - - FROM logical-link - - FROM allotted-resource + - TO configuration( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE) + - TO connector( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE) + - TO image( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE) + - TO service-instance( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - TO model-ver( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) required: - - vnf-id - - vnf-name - - vnf-type - - in-maint - - is-closed-loop-disabled + - metaname + - metaval properties: - vnf-id: - type: string - description: Unique id of VNF. This is unique across the graph. - vnf-name: - type: string - description: Name of VNF. - vnf-name2: - type: string - description: Alternate name of VNF. - vnf-type: - type: string - description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. - service-id: - type: string - description: Unique identifier of service, does not necessarily map to ASDC service models. SOON TO BE DEPRECATED - regional-resource-zone: - type: string - description: Regional way of organizing pservers, source of truth should define values - prov-status: + metaname: type: string - description: Trigger for operational monitoring of this resource by Service Assurance systems. - operational-status: + metaval: type: string - description: Indicator for whether the resource is considered operational. Valid values are in-service-path and out-of-service-path. - license-key: + resource-version: type: string - description: OBSOLETE - do not use - equipment-role: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model: + description: | + Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version + ###### Related Nodes + - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE) + - FROM instance-group( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY) + - FROM model-ver( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE) + - FROM named-query( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY) + - FROM named-query-element( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE) + - MODEL cannot be deleted if linked to INSTANCE-GROUP,NAMED-QUERY,NAMED-QUERY-ELEMENT + - MODEL is DELETED when these are DELETED MODEL-VER + required: + - model-invariant-id + - model-type + properties: + model-invariant-id: type: string - description: Client should send valid enumerated value - orchestration-status: + description: Unique identifier corresponding to the main definition of a model in ASDC + model-type: type: string - description: Orchestration status of this VNF, used by MSO. - heat-stack-id: + description: Type of the model, e.g., service, resource, widget, etc. + resource-version: type: string - description: Heat stack id corresponding to this instance, managed by MSO - mso-catalog-key: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-vers: + type: array + items: + $ref: "#/getDefinitions/model-ver" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + model-and-named-query-search: + description: | + ModelAndNamedQuerySearch holds query-parameters and instance-properties for performing a named-query or model query + properties: + query-parameters: + type: object + $ref: "#/getDefinitions/query-parameters" + instance-filters: + type: object + $ref: "#/getDefinitions/instance-filters" + secondary-filts: + type: object + $ref: "#/getDefinitions/secondary-filts" + top-node-type: type: string - description: Corresponds to the SDN-C catalog id used to configure this VCE - management-option: + secondary-filter-cut-point: type: string - description: identifier of managed by ATT or customer - ipv4-oam-address: + model-constraint: + description: | + This is how we would capture constraints defining allowed sets of elements. + ###### Related Nodes + - TO model-element( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE) + - MODEL-CONSTRAINT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET + required: + - model-constraint-uuid + - constrained-element-set-uuid-to-replace + properties: + model-constraint-uuid: type: string - description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by generic-vnf. - ipv4-loopback0-address: + constrained-element-set-uuid-to-replace: type: string - description: v4 Loopback0 address - nm-lan-v6-address: + constrained-element-sets: + type: array + items: + $ref: "#/getDefinitions/constrained-element-set" + resource-version: type: string - description: v6 Loopback address - management-v6-address: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-constraints: + properties: + model-constraint: + type: array + items: + $ref: "#/getDefinitions/model-constraint" + model-element: + description: | + Defines how other models combine to make up a higher-level model. + ###### Related Nodes + - TO element-choice-set( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE) + - TO model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - TO model-ver( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE) + - TO model-ver( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM model-constraint( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE) + - MODEL-ELEMENT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET,MODEL-CONSTRAINT + required: + - model-element-uuid + - new-data-del-flag + - cardinality + properties: + model-element-uuid: type: string - description: v6 management address - vcpu: - type: integer - format: int64 - description: number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE - vcpu-units: + new-data-del-flag: type: string - description: units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE - vmemory: - type: integer - format: int64 - description: number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE - vmemory-units: + description: Indicates whether this element was created as part of instantiation from this model + cardinality: type: string - description: units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE - vdisk: - type: integer - format: int64 - description: number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE - vdisk-units: + description: How many of this type of element are required/allowed + linkage-points: type: string - description: units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE - in-maint: - type: boolean - is-closed-loop-disabled: - type: boolean resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - summary-status: + model-elements: + type: array + items: + $ref: "#/getDefinitions/model-element" + description: Defines how other models combine to make up a higher-level model + model-constraints: + type: array + items: + $ref: "#/getDefinitions/model-constraint" + description: Describes new constraints on this model element that are not part of that model's definition + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + model-elements: + properties: + model-element: + type: array + items: + $ref: "#/getDefinitions/model-element" + model-ver: + description: | + Subgraph definition provided by ASDC to describe a specific version of an inventory asset and its connections related to ASDC models + ###### Related Nodes + - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE) + - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE) + - MODEL-VER cannot be deleted if linked to MODEL-ELEMENT + - MODEL-VER is DELETED when these are DELETED MODEL-ELEMENT,METADATUM + required: + - model-version-id + - model-name + - model-version + properties: + model-version-id: type: string - description: details regarding the generic-vnf operation, PLEASE DISCONTINUE USE OF THIS FIELD. - encrypted-access-flag: - type: boolean - description: indicates whether generic-vnf access uses SSH - entitlement-assignment-group-uuid: + description: Unique identifier corresponding to one version of a model in ASDC + model-name: type: string - description: UUID of the Entitlement group used for licensing VNFs, OBSOLETE - See child relationships. - entitlement-resource-uuid: + description: Name of the model, which can change from version to version. + model-version: type: string - description: UUID of the specific entitlement resource. OBSOLETE - See child relationships. - license-assignment-group-uuid: + description: Version + model-description: type: string - description: UUID of the license assignment group. OBSOLETE - See child relationships. - license-key-uuid: + description: Description + resource-version: type: string - description: UUID of the actual license resource. OBSOLETE - See child relationships. - model-invariant-id: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-elements: + type: array + items: + $ref: "#/getDefinitions/model-element" + metadata: + type: array + items: + $ref: "#/getDefinitions/metadatum" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + model-vers: + properties: + model-ver: + type: array + items: + $ref: "#/getDefinitions/model-ver" + models: + description: | + Collection of subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models + properties: + model: + type: array + items: + $ref: "#/getDefinitions/model" + multicast-configuration: + description: | + ###### Related Nodes + - FROM vlan( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY) + required: + - multicast-configuration-id + - multicast-protocol + - rp-type + properties: + multicast-configuration-id: type: string - description: the ASDC model id for this resource or service model. - model-version-id: + description: Unique id of multicast configuration. + multicast-protocol: type: string - description: the ASDC model version for this resource or service model. - persona-model-version: + description: protocol of multicast configuration + rp-type: type: string - description: the ASDC model version for this resource or service model. - model-customization-id: + description: rp type of multicast configuration + resource-version: type: string - description: captures the id of all the configuration used to customize the resource for the service. - widget-model-id: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + multicast-configurations: + description: | + multicast configuration of generic-vnf ip-address + properties: + multicast-configuration: + type: array + items: + $ref: "#/getDefinitions/multicast-configuration" + named-queries: + properties: + named-query: + type: array + items: + $ref: "#/getDefinitions/named-query" + named-query: + description: | + TBD + ###### Related Nodes + - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE) + - TO model( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY) + - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE) + - NAMED-QUERY is DELETED when these are DELETED NAMED-QUERY-ELEMENT + required: + - named-query-uuid + - named-query-name + - named-query-version + properties: + named-query-uuid: type: string - description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. - widget-model-version: + named-query-name: type: string - description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. - as-number: + named-query-version: type: string - description: as-number of the VNF - regional-resource-subzone: + required-input-param: type: string - description: represents sub zone of the rr plane - nf-type: + description: type: string - description: Generic description of the type of NF - nf-function: + resource-version: type: string - description: English description of Network function that the specific VNF deployment is providing - nf-role: + named-query-elements: + type: array + items: + $ref: "#/getDefinitions/named-query-element" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + named-query-element: + description: | + TBD + ###### Related Nodes + - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE) + - TO model( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE) + - TO named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - FROM property-constraint( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - FROM related-lookup( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + - NAMED-QUERY-ELEMENT is DELETED when these are DELETED PROPERTY-CONSTRAINT,RELATED-LOOKUP + required: + - named-query-element-uuid + properties: + named-query-element-uuid: type: string - description: role in the network that this model will be providing - nf-naming-code: + property-collect-list: type: string - description: string assigned to this model used for naming purposes - selflink: + resource-version: type: string - description: Path to the controller object. - ipv4-oam-gateway-address: + property-limit-desc: type: string - description: Gateway address - ipv4-oam-gateway-address-prefix-length: - type: integer - format: int32 - description: Prefix length for oam-address - vlan-id-outer: - type: integer - format: int64 - description: Temporary location for S-TAG to get to VCE - nm-profile-name: + do-not-output: type: string - description: Network Management profile of this VNF + named-query-elements: + type: array + items: + $ref: "#/getDefinitions/named-query-element" + related-lookups: + type: array + items: + $ref: "#/getDefinitions/related-lookup" + property-constraints: + type: array + items: + $ref: "#/getDefinitions/property-constraint" relationship-list: type: array items: - $ref: "#/definitions/relationship" - l-interfaces: + $ref: "#/getDefinitions/relationship" + named-query-elements: + properties: + named-query-element: + type: array + items: + $ref: "#/getDefinitions/named-query-element" + network: + description: | + Namespace for network inventory resources. + properties: + logical-links: type: array items: - $ref: "#/definitions/l-interface" - lag-interfaces: + $ref: "#/getDefinitions/logical-link" + site-pair-sets: type: array items: - $ref: "#/definitions/lag-interface" - vf-modules: + $ref: "#/getDefinitions/site-pair-set" + vpn-bindings: type: array items: - $ref: "#/definitions/vf-module" - licenses: + $ref: "#/getDefinitions/vpn-binding" + vpls-pes: type: array items: - $ref: "#/definitions/license" - entitlements: + $ref: "#/getDefinitions/vpls-pe" + multicast-configurations: type: array items: - $ref: "#/definitions/entitlement" - generic-vnfs: - description: | - Collection of VNFs + $ref: "#/getDefinitions/multicast-configuration" + vces: + type: array + items: + $ref: "#/getDefinitions/vce" + vnfcs: + type: array + items: + $ref: "#/getDefinitions/vnfc" + l3-networks: + type: array + items: + $ref: "#/getDefinitions/l3-network" + network-policies: + type: array + items: + $ref: "#/getDefinitions/network-policy" + generic-vnfs: + type: array + items: + $ref: "#/getDefinitions/generic-vnf" + lag-links: + type: array + items: + $ref: "#/getDefinitions/lag-link" + newvces: + type: array + items: + $ref: "#/getDefinitions/newvce" + pnfs: + type: array + items: + $ref: "#/getDefinitions/pnf" + physical-links: + type: array + items: + $ref: "#/getDefinitions/physical-link" + ipsec-configurations: + type: array + items: + $ref: "#/getDefinitions/ipsec-configuration" + route-table-references: + type: array + items: + $ref: "#/getDefinitions/route-table-reference" + instance-groups: + type: array + items: + $ref: "#/getDefinitions/instance-group" + zones: + type: array + items: + $ref: "#/getDefinitions/zone" + configurations: + type: array + items: + $ref: "#/getDefinitions/configurations" + network-policies: properties: - generic-vnf: + network-policy: type: array items: - $ref: "#/definitions/generic-vnf" - lag-link: + $ref: "#/getDefinitions/network-policy" + network-policy: description: | - LAG links can connect lag-interfaces ###### Related Nodes - - FROM lag-interface - - FROM logical-link + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE) + - FROM l3-network( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY) required: - - link-name + - network-policy-id properties: - link-name: + network-policy-id: type: string - description: Alphabetical concatenation of lag-interface names + description: UUID representing unique key to this instance + network-policy-fqdn: + type: string + description: Contrail FQDN for the policy + heat-stack-id: + type: string + description: ID for the openStack Heat instance resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. relationship-list: type: array items: - $ref: "#/definitions/relationship" - lag-links: + $ref: "#/getDefinitions/relationship" + network-profile: description: | - Collection of link aggregation connections + Network profile populated by SDN-GP for SNMP + ###### Related Nodes + - TO generic-vnf( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + required: + - nm-profile-name properties: - lag-link: + nm-profile-name: + type: string + description: Unique name of network profile. + community-string: + type: string + description: Encrypted SNMP community string + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + network-profiles: + description: | + Collection of network profiles + properties: + network-profile: type: array items: - $ref: "#/definitions/lag-link" + $ref: "#/getDefinitions/network-profile" newvce: description: | This object fills in the gaps from vce that were incorporated into generic-vnf. This object will be retired with vce. ###### Related Nodes - - TO l-interface (comprises newvce, Many2Many) + - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE) + - NEWVCE is DELETED when these are DELETED L-INTERFACE required: - vnf-id2 - vnf-name @@ -45761,11 +65061,11 @@ definitions: relationship-list: type: array items: - $ref: "#/definitions/relationship" + $ref: "#/getDefinitions/relationship" l-interfaces: type: array items: - $ref: "#/definitions/l-interface" + $ref: "#/getDefinitions/l-interface" newvces: description: | This object fills in the gaps from vce that were incorporated into generic-vnf. This object will be retired with vce. @@ -45773,20 +65073,391 @@ definitions: newvce: type: array items: - $ref: "#/definitions/newvce" + $ref: "#/getDefinitions/newvce" + notification-event: + properties: + cambria.partition: + type: string + notification-event-header: + type: object + $ref: "#/getDefinitions/notification-event-header" + notification-event-header: + properties: + id: + type: string + timestamp: + type: string + source-name: + type: string + domain: + type: string + sequence-number: + type: string + severity: + type: string + event-type: + type: string + version: + type: string + action: + type: string + entity-type: + type: string + top-entity-type: + type: string + entity-link: + type: string + status: + type: string + notify: + required: + - event-id + properties: + event-id: + type: string + node-type: + type: string + event-trigger: + type: string + key-data: + type: array + items: + $ref: "#/getDefinitions/key-data" + selflink: + type: string + oam-network: + description: | + OAM network, to be deprecated shortly. Do not use for new purposes. + ###### Related Nodes + - TO cloud-region( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO complex( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY) + - TO service-capability( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + required: + - network-uuid + - network-name + - cvlan-tag + properties: + network-uuid: + type: string + description: UUID of the network. Unique across a cloud-region + network-name: + type: string + description: Name of the network. + cvlan-tag: + type: integer + format: int64 + description: cvlan-id + ipv4-oam-gateway-address: + type: string + description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network + ipv4-oam-gateway-address-prefix-length: + type: integer + format: int32 + description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + oam-networks: + description: | + Collection of OAM networks, to be deprecated shortly. Do not use for new purposes. + properties: + oam-network: + type: array + items: + $ref: "#/getDefinitions/oam-network" + operational-environment: + description: | + It is a logical partition of the cloud which allows to have multiple environments in the production AIC. + ###### Related Nodes + - TO operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE) + - FROM operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE) + required: + - operational-environment-id + - operational-environment-name + - operational-environment-type + - operational-environment-status + - tenant-context + - workload-context + properties: + operational-environment-id: + type: string + description: UUID of an operational environment + operational-environment-name: + type: string + description: Operational Environment name + operational-environment-type: + type: string + description: Operational Environment Type. + operational-environment-status: + type: string + description: Status + tenant-context: + type: string + description: Tenant Context. + workload-context: + type: string + description: Workload Context. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + operational-environments: + description: | + a logical partition of the cloud which allows to have multiple environments in the production AIC. + properties: + operational-environment: + type: array + items: + $ref: "#/getDefinitions/operational-environment" + overloaded-model: + description: | + Allows for legacy POST of old-style and new-style models + required: + - model-invariant-id + - model-name-version-id + - model-type + - model-name + - model-id + - model-version + properties: + model-invariant-id: + type: string + description: Unique identifier corresponding to the main definition of a model in ASDC + model-name-version-id: + type: string + description: Unique identifier corresponding to one version of a model in ASDC + model-type: + type: string + description: Type of the model, e.g., service, resource, widget, etc. + model-name: + type: string + description: Name of the model, which can change from version to version. + model-id: + type: string + description: Invariant unique ID which does not change from version to version + model-version: + type: string + description: Version + model-description: + type: string + description: Description + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + model-vers: + type: object + $ref: "#/getDefinitions/model-vers" + relationship-list: + type: object + $ref: "#/getDefinitions/relationship-list" + owning-entities: + description: | + Collection of owning-entities + properties: + owning-entity: + type: array + items: + $ref: "#/getDefinitions/owning-entity" + owning-entity: + description: | + describes an owning-entity + ###### Related Nodes + - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE) + required: + - owning-entity-id + - owning-entity-name + properties: + owning-entity-id: + type: string + description: UUID of an owning entity + owning-entity-name: + type: string + description: Owning entity name + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + p-interface: + description: | + Physical interface (e.g., nic) + ###### Related Nodes + - TO logical-link( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE) + - TO physical-link( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE) + - TO pnf( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - TO pserver( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - TO vpls-pe( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY) + - FROM l-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE) + - FROM sriov-pf( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE) + - P-INTERFACE is DELETED when these are DELETED L-INTERFACE,SRIOV-PF + - P-INTERFACE deletion means associated objects of these types are also DELETED:PHYSICAL-LINK + required: + - interface-name + - in-maint + properties: + interface-name: + type: string + description: Name that identifies the physical interface + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + port-description: + type: string + description: Nature of the services and connectivity on this port. + equipment-identifier: + type: string + description: CLEI or other specification for p-interface hardware. + interface-role: + type: string + description: Role specification for p-interface hardware. + interface-type: + type: string + description: Indicates the physical properties of the interface. + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + mac-addresss: + type: string + description: MAC Address of the p-interface. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + in-maint: + type: boolean + inv-status: + type: string + description: inventory status + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + sriov-pfs: + type: array + items: + $ref: "#/getDefinitions/sriov-pf" + l-interfaces: + type: array + items: + $ref: "#/getDefinitions/l-interface" + p-interfaces: + description: | + Collection of physical interfaces. + properties: + p-interface: + type: array + items: + $ref: "#/getDefinitions/p-interface" + physical-link: + description: | + Collection of physical connections, typically between p-interfaces + ###### Related Nodes + - FROM p-interface( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE) + required: + - link-name + properties: + link-name: + type: string + description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ + speed-value: + type: string + description: Captures the numeric part of the speed + speed-units: + type: string + description: Captures the units corresponding to the speed + circuit-id: + type: string + description: Circuit it + dual-mode: + type: string + description: Dual access mode (e.g., primary, secondary + management-option: + type: string + description: To provide information on who manages this circuit. A&AI or 3rd party transport provider + service-provider-name: + type: string + description: Name of the service Provider on this link. + service-provider-bandwidth-up-value: + type: integer + format: int32 + description: Upstream Bandwidth value agreed with the service provider + service-provider-bandwidth-up-units: + type: string + description: Units for the upstream BW value + service-provider-bandwidth-down-value: + type: integer + format: int32 + description: Downstream Bandwidth value agreed with the service provider + service-provider-bandwidth-down-units: + type: string + description: Units for downstream BW value + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + physical-links: + description: | + Collection of physical connections, typically between p-interfaces + properties: + physical-link: + type: array + items: + $ref: "#/getDefinitions/physical-link" + platform: + description: | + describes a platform + ###### Related Nodes + - TO generic-vnf( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY) + required: + - platform-name + properties: + platform-name: + type: string + description: Name of the platform + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + platforms: + description: | + Collection of platforms + properties: + platform: + type: array + items: + $ref: "#/getDefinitions/platform" pnf: description: | PNF represents a physical network function. typically equipment used in the D1 world. in 1607, this will be populated by SDN-C to represent a premises router that a uCPE connects to. But this can be used to represent any physical device that is not an AIC node or uCPE. ###### Related Nodes - - TO p-interface (comprises pnf, Many2Many) - - TO lag-interface (comprises pnf, One2Many) - - TO complex (Many2One) - - TO instance-group (Many2Many) - - TO zone (Many2One) - - FROM esr-thirdparty-sdnc - - FROM generic-vnf - - FROM logical-link - - FROM service-instance + - TO complex( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO instance-group( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO zone( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM esr-thirdparty-sdnc( esr-thirdparty-sdnc has pnf, One2Many) + - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY) + - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - FROM p-interface( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY) + - PNF is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE required: - pnf-name - in-maint @@ -45859,15 +65530,15 @@ definitions: relationship-list: type: array items: - $ref: "#/definitions/relationship" + $ref: "#/getDefinitions/relationship" p-interfaces: type: array items: - $ref: "#/definitions/p-interface" + $ref: "#/getDefinitions/p-interface" lag-interfaces: type: array items: - $ref: "#/definitions/lag-interface" + $ref: "#/getDefinitions/lag-interface" pnfs: description: | Collection of Physical Network Functions. @@ -45875,189 +65546,377 @@ definitions: pnf: type: array items: - $ref: "#/definitions/pnf" - physical-link: + $ref: "#/getDefinitions/pnf" + port-group: description: | - Collection of physical connections, typically between p-interfaces + Used to capture the network interfaces of this VCE ###### Related Nodes - - FROM p-interface + - TO vce( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM cvlan-tag( cvlan-tag org.onap.relationships.inventory.BelongsTo port-group, MANY2ONE) + - PORT-GROUP is DELETED when these are DELETED CVLAN-TAG required: - - link-name + - interface-id + - orchestration-status properties: - link-name: + interface-id: type: string - description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ - speed-value: + description: Unique ID of the interface + neutron-network-id: type: string - description: Captures the numeric part of the speed - speed-units: + description: Neutron network id of this Interface + neutron-network-name: type: string - description: Captures the units corresponding to the speed - circuit-id: + description: Neutron network name of this Interface + interface-role: type: string - description: Circuit it - dual-mode: + description: Role assigned to this Interface, should use values as defined in ECOMP Yang models. + resource-version: type: string - description: Dual access mode (e.g., primary, secondary - management-option: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + port-group-id: type: string - description: To provide information on who manages this circuit. A&AI or 3rd party transport provider - service-provider-name: + description: Unique ID for port group in vmware + port-group-name: type: string - description: Name of the service Provider on this link. - service-provider-bandwidth-up-value: - type: integer - format: int32 - description: Upstream Bandwidth value agreed with the service provider - service-provider-bandwidth-up-units: + description: Likely to duplicate value of neutron network name + switch-name: type: string - description: Units for the upstream BW value - service-provider-bandwidth-down-value: - type: integer - format: int32 - description: Downstream Bandwidth value agreed with the service provider - service-provider-bandwidth-down-units: + description: DVS or standard switch name (should be non-null for port groups associated with DVS) + orchestration-status: type: string - description: Units for downstream BW value - resource-version: + description: Orchestration status of this VNF, mastered by MSO + heat-stack-id: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + description: Heat stack id corresponding to this instance, managed by MSO + mso-catalog-key: + type: string + description: Corresponds to the SDN-C catalog id used to configure this VCE + cvlan-tags: + type: array + items: + $ref: "#/getDefinitions/cvlan-tag-entry" relationship-list: type: array items: - $ref: "#/definitions/relationship" - physical-links: - description: | - Collection of physical connections, typically between p-interfaces + $ref: "#/getDefinitions/relationship" + port-groups: properties: - physical-link: + port-group: type: array items: - $ref: "#/definitions/physical-link" - vig-server: + $ref: "#/getDefinitions/port-group" + project: description: | - vig-server contains information about a vig server used for IPSec-configuration. Populated by SDN-C from 1607 + describes the project ###### Related Nodes - - FROM ipsec-configuration (is composed of vig-server) + - TO service-instance( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY) required: - - vig-address-type + - project-name properties: - vig-address-type: - type: string - description: indicates whether the VIG is for AVPN or INTERNET - ipaddress-v4-vig: - type: string - description: v4 IP of the vig server - ipaddress-v6-vig: + project-name: type: string - description: v6 IP of the vig server + description: Name of the project deploying a service resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. relationship-list: type: array items: - $ref: "#/definitions/relationship" - vig-servers: + $ref: "#/getDefinitions/relationship" + projects: + description: | + Collection of projects properties: - vig-server: + project: type: array items: - $ref: "#/definitions/vig-server" - ipsec-configuration: + $ref: "#/getDefinitions/project" + properties: description: | - IPSec configuration node will contain various configuration data for the NMTE VNF. This node will have an edge to the generic-vnf (vnf type = TE). Starting 1607, this data will be populated by SDN-C + Property holder for query properties or instance properties + properties: + property-name: + type: string + property-value: + type: string + property-constraint: + description: | + TBD ###### Related Nodes - - TO vig-server (comprises ipsec-configuration, One2Many) - - FROM generic-vnf + - TO named-query-element( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) required: - - ipsec-configuration-id + - property-constraint-uuid + - constraint-type + - property-name + - property-value properties: - ipsec-configuration-id: + property-constraint-uuid: type: string - description: UUID of this configuration - requested-vig-address-type: + constraint-type: type: string - description: Indicate the type of VIG server like AVPN, INTERNET, BOTH - requested-encryption-strength: + property-name: type: string - description: Encryption values like 3des-cbc, des-cbc, aes-128-cbc, aes-192-cbc, aes-265-cbc - requested-dmz-type: + property-value: type: string - description: ATT can offer a shared DMZ or a DMZ specific to a customer - shared-dmz-network-address: + resource-version: type: string - description: Network address of shared DMZ - requested-customer-name: + property-constraints: + properties: + property-constraint: + type: array + items: + $ref: "#/getDefinitions/property-constraint" + pserver: + description: | + Compute host whose hostname must be unique and must exactly match what is sent as a relationship to a vserver. + ###### Related Nodes + - TO group-assignment( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE) + - TO availability-zone( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE) + - TO cloud-region( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE) + - TO complex( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO zone( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY) + - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - FROM p-interface( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE) + - FROM vserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE) + - PSERVER cannot be deleted if linked to GENERIC-VNF,LOGICAL-LINK,VSERVER + - PSERVER is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE + - PSERVER cannot be deleted if linked to GROUP-ASSIGNMENT + required: + - hostname + - in-maint + properties: + hostname: type: string - description: If the DMZ is a custom DMZ, this field will indicate the customer information - ike-version: + description: Value from executing hostname on the compute node. + ptnii-equip-name: type: string - description: can be 1 or 2 - ikev1-authentication: + description: PTNII name + number-of-cpus: + type: integer + format: int32 + description: Number of cpus + disk-in-gigabytes: + type: integer + format: int32 + description: Disk size, in GBs + ram-in-megabytes: + type: integer + format: int32 + description: RAM size, in MBs + equip-type: type: string - description: Contains values like md5, sha1, sha256, sha384 - ikev1-encryption: + description: Equipment type. Source of truth should define valid values. + equip-vendor: type: string - description: Encyption values like 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc - ikev1-dh-group: + description: Equipment vendor. Source of truth should define valid values. + equip-model: type: string - description: Diffie-Hellman group like DH-GROUP2, DH-GROUP5, DH-GROUP14 - ikev1-am-group-id: + description: Equipment model. Source of truth should define valid values. + fqdn: type: string - description: Group name defined in VIG for clients using aggressive mode - ikev1-am-password: + description: Fully-qualified domain name + pserver-selflink: type: string - description: pre-shared key for the above group name - ikev1-sa-lifetime: + description: URL to endpoint where AAI can get more details + ipv4-oam-address: type: string - description: Lifetime for IKEv1 SA - ipsec-authentication: + description: Used to configure device, also used for troubleshooting and is IP used for traps generated by device. + serial-number: type: string - description: md5, sha1, sha256, sha384 - ipsec-encryption: + description: Serial number, may be queried + ipaddress-v4-loopback-0: type: string - description: 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc - ipsec-sa-lifetime: + description: IPV4 Loopback 0 address + ipaddress-v6-loopback-0: type: string - description: Life time for IPSec SA - ipsec-pfs: + description: IPV6 Loopback 0 address + ipaddress-v4-aim: type: string - description: enable PFS or not - xauth-userid: + description: IPV4 AIM address + ipaddress-v6-aim: type: string - description: user ID for xAuth, sm-user,ucpeHostName,nmteHostName - xauth-user-password: + description: IPV6 AIM address + ipaddress-v6-oam: type: string - description: Encrypted using the Juniper $9$ algorithm - dpd-interval: + description: IPV6 OAM address + inv-status: type: string - description: The time between DPD probe - dpd-frequency: + description: CANOPI's inventory status. Only set with values exactly as defined by CANOPI. + pserver-id: type: string - description: Maximum number of DPD before claiming the tunnel is down + description: ID of Pserver + internet-topology: + type: string + description: internet topology of Pserver + in-maint: + type: boolean resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + pserver-name2: + type: string + description: alternative pserver name + purpose: + type: string + description: purpose of pserver + prov-status: + type: string + description: Prov Status of this device (not under canopi control) Valid values [PREPROV/NVTPROV/PROV] + management-option: + type: string + description: Indicates who owns and or manages the device. + host-profile: + type: string + description: The host profile that defines the configuration of the pserver. relationship-list: type: array items: - $ref: "#/definitions/relationship" - vig-servers: + $ref: "#/getDefinitions/relationship" + p-interfaces: type: array items: - $ref: "#/definitions/vig-server" - ipsec-configurations: + $ref: "#/getDefinitions/p-interface" + lag-interfaces: + type: array + items: + $ref: "#/getDefinitions/lag-interface" + pservers: + description: | + Collection of compute hosts. properties: - ipsec-configuration: + pserver: type: array items: - $ref: "#/definitions/ipsec-configuration" + $ref: "#/getDefinitions/pserver" + query-parameters: + description: | + QueryParameters for performing a named-query or model query + properties: + named-query: + type: object + $ref: "#/getDefinitions/named-query" + overloaded-model: + type: object + $ref: "#/getDefinitions/overloaded-model" + related-lookup: + description: | + TBD + ###### Related Nodes + - TO named-query-element( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE) + required: + - related-lookup-uuid + - source-node-type + - source-node-property + - target-node-type + - target-node-property + properties: + related-lookup-uuid: + type: string + source-node-type: + type: string + source-node-property: + type: string + target-node-type: + type: string + target-node-property: + type: string + property-collect-list: + type: string + resource-version: + type: string + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + related-lookups: + properties: + related-lookup: + type: array + items: + $ref: "#/getDefinitions/related-lookup" + related-to-property: + properties: + property-key: + type: string + description: Key part of a key/value pair + property-value: + type: string + description: Value part of a key/value pair + relationship: + properties: + related-to: + type: string + description: A keyword provided by A&AI to indicate type of node. + related-link: + type: string + description: URL to the object in A&AI. + relationship-data: + type: array + items: + $ref: "#/getDefinitions/relationship-data" + related-to-property: + type: array + items: + $ref: "#/getDefinitions/related-to-property" + relationship-data: + required: + - relationship-key + - relationship-value + properties: + relationship-key: + type: string + description: A keyword provided by A&AI to indicate an attribute. + relationship-value: + type: string + description: Value of the attribute. + relationship-list: + properties: + relationship: + type: array + items: + $ref: "#/getDefinitions/relationship" + reserved-prop-names: + description: | + Internal map to define some reserved properties of a vertex + properties: + last-mod-source-of-truth: + type: string + aai-node-type: + type: string + aai-created-ts: + type: integer + format: int64 + aai-unique-key: + type: string + aai-last-mod-ts: + type: integer + format: int64 + source-of-truth: + type: string + aai-uri: + type: string + response-list: + description: | + Response container for the results of a named-query or model query + properties: + inventory-response-items: + type: object + $ref: "#/getDefinitions/inventory-response-items" + result-data: + properties: + resource-type: + type: string + description: The specific type of node in the A&AI graph + resource-link: + type: string + description: The URL to the specific resource route-table-reference: description: | Openstack route table reference. ###### Related Nodes - - FROM l3-network + - FROM l3-network( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY) required: - route-table-reference-id - route-table-reference-fqdn @@ -46074,7 +65933,7 @@ definitions: relationship-list: type: array items: - $ref: "#/definitions/relationship" + $ref: "#/getDefinitions/relationship" route-table-references: description: | Collection of openstack route table references @@ -46082,319 +65941,790 @@ definitions: route-table-reference: type: array items: - $ref: "#/definitions/route-table-reference" - instance-group: + $ref: "#/getDefinitions/route-table-reference" + route-target: description: | - General mechanism for grouping instances + Route target information ###### Related Nodes - - TO model (Many2Many) - - FROM l-interface - - FROM vnfc - - FROM l3-interface-ipv4-address-list - - FROM l3-interface-ipv6-address-list - - FROM l3-network - - FROM pnf - - FROM allotted-resource - - FROM generic-vnf - - FROM service-instance - - FROM vip-ipv4-address-list - - FROM vip-ipv6-address-list + - TO vpn-binding( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE) required: - - instance-group-role - - model-invariant-id - - model-version-id - - id - - description - - type + - global-route-target + - route-target-role properties: - instance-group-role: - type: string - description: role of the instance group. - model-invariant-id: - type: string - description: ASDC model id for this resource or service model. - model-version-id: + global-route-target: type: string - description: ASDC model version uid for this resource model. - id: + description: Number used to identify an RT, globally unique in the network + route-target-role: type: string - description: Instance Group ID, UUID assigned to this instance. - description: + description: Role assigned to this route target + resource-version: type: string - description: Descriptive text to help identify the usage of this instance-group - type: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + route-targets: + description: | + Collection of route target information + properties: + route-target: + type: array + items: + $ref: "#/getDefinitions/route-target" + routing-instance: + description: | + ###### Related Nodes + - TO site-pair-set( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE) + - FROM site-pair( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE) + - ROUTING-INSTANCE is DELETED when these are DELETED SITE-PAIR + required: + - routing-instance-id + properties: + routing-instance-id: type: string - description: Only valid value today is lower case ha for high availability - sub-type: + description: Unique id of routing instance + rpm-owner: type: string - description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby] + description: rpm owner resource-version: type: string - description: Concurrency value + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + site-pairs: + type: array + items: + $ref: "#/getDefinitions/site-pair" relationship-list: type: array items: - $ref: "#/definitions/relationship" - instance-groups: + $ref: "#/getDefinitions/relationship" + routing-instances: description: | - Collection of openstack route table references + set of probes related to generic-vnf routing instance properties: - instance-group: + routing-instance: type: array items: - $ref: "#/definitions/instance-group" - zone: + $ref: "#/getDefinitions/routing-instance" + sdn-zone-response: + properties: + oam-networks: + type: object + $ref: "#/getDefinitions/oam-networks" + az-and-dvs-switches: + type: array + items: + $ref: "#/getDefinitions/az-and-dvs-switches" + search: + properties: + edge-tag-query-result: + type: object + $ref: "#/getDefinitions/edge-tag-query-result" + edge-tag-query-request: + type: object + $ref: "#/getDefinitions/edge-tag-query-request" + search-results: + type: object + $ref: "#/getDefinitions/search-results" + sdn-zone-response: + type: object + $ref: "#/getDefinitions/sdn-zone-response" + search-results: + properties: + result-data: + type: array + items: + $ref: "#/getDefinitions/result-data" + secondary-filt: description: | - A zone is a grouping of assets in a location homing to the same connections into the CBB + SecondaryFilt for performing a named-query or model query + secondary-filter: + properties: + property-name: + type: string + filter-type: + type: string + property-value: + type: string + secondary-filts: + description: | + SecondaryFilts for performing a named-query or model query + properties: + secondary-filt: + type: array + items: + $ref: "#/getDefinitions/secondary-filt" + segmentation-assignment: + description: | + Openstack segmentation assignment. ###### Related Nodes - - TO complex (Many2One) - - FROM cloud-region - - FROM pserver - - FROM pnf - - FROM service-instance + - TO l3-network( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) required: - - zone-id - - zone-name - - design-type - - zone-context + - segmentation-id properties: - zone-id: + segmentation-id: type: string - description: Code assigned by AIC to the zone - zone-name: + description: Route Table Reference id, UUID assigned to this instance. + resource-version: type: string - description: English name associated with the zone - design-type: + description: Concurrency value + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + segmentation-assignments: + description: | + Collection of openstack segmentation assignments + properties: + segmentation-assignment: + type: array + items: + $ref: "#/getDefinitions/segmentation-assignment" + service: + description: | + Stand-in for service model definitions. Likely to be deprecated in favor of models from ASDC. Does not strictly map to ASDC services. + required: + - service-id + - service-description + properties: + service-id: type: string - description: Design of zone [Medium/Large?] - zone-context: + description: This gets defined by others to provide a unique ID for the service, we accept what is sent. + service-description: type: string - description: Context of zone [production/test] - status: + description: Description of the service + service-selflink: type: string - description: Status of a zone. + description: URL to endpoint where AAI can get more details resource-version: type: string - description: Concurrency value + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + service-version: + type: string + description: service version relationship-list: type: array items: - $ref: "#/definitions/relationship" - zones: + $ref: "#/getDefinitions/relationship" + service-capabilities: description: | - Collection of zones + Collection of service capabilities. properties: - zone: + service-capability: type: array items: - $ref: "#/definitions/zone" - network: + $ref: "#/getDefinitions/service-capability" + service-capability: description: | - Namespace for network inventory resources. + Early definition of server/resource pairings, likely to be replaced by models. No new use should be made of this. + ###### Related Nodes + - FROM availability-zone( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY) + - SERVICE-CAPABILITY cannot be deleted if linked to AVAILABILITY-ZONE,OAM-NETWORK + required: + - service-type + - vnf-type properties: - logical-links: + service-type: + type: string + description: This gets defined by others to provide a unique ID for the service, we accept what is sent. + vnf-type: + type: string + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: type: array items: - $ref: "#/definitions/logical-link" - site-pair-sets: + $ref: "#/getDefinitions/relationship" + service-design-and-creation: + description: | + Namespace for objects managed by ASDC + properties: + vnf-images: type: array items: - $ref: "#/definitions/site-pair-set" - vpn-bindings: + $ref: "#/getDefinitions/vnf-image" + services: type: array items: - $ref: "#/definitions/vpn-binding" - vpls-pes: + $ref: "#/getDefinitions/service" + service-capabilities: type: array items: - $ref: "#/definitions/vpls-pe" - multicast-configurations: + $ref: "#/getDefinitions/service-capability" + models: type: array items: - $ref: "#/definitions/multicast-configuration" - vces: + $ref: "#/getDefinitions/model" + named-queries: type: array items: - $ref: "#/definitions/vce" - vnfcs: + $ref: "#/getDefinitions/named-query" + service-instance: + description: | + Instance of a service + ###### Related Nodes + - TO generic-vnf( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY) + - TO l3-network( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY) + - TO owning-entity( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE) + - TO allotted-resource( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY) + - TO configuration( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY) + - TO connector( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY) + - TO ctag-assignment( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY) + - TO cvlan-tag( service-instance org.onap.relationships.inventory.ComposedOf cvlan-tag, MANY2MANY) + - TO instance-group( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO logical-link( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY) + - TO pnf( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY) + - TO service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY) + - TO vlan( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY) + - TO zone( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - TO service-subscription( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE) + - TO vce( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY) + - FROM project( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY) + - SERVICE-INSTANCE is DELETED when these are DELETED ALLOTTED-RESOURCE,METADATUM + - SERVICE-INSTANCE deletion means associated objects of these types are also DELETED:LOGICAL-LINK + required: + - service-instance-id + - service-type + - service-role + - created-at + - updated-at + - description + properties: + service-instance-id: + type: string + description: Uniquely identifies this instance of a service + service-instance-name: + type: string + description: This field will store a name assigned to the service-instance. + service-type: + type: string + description: String capturing type of service. + service-role: + type: string + description: String capturing the service role. + environment-context: + type: string + description: This field will store the environment context assigned to the service-instance. + workload-context: + type: string + description: This field will store the workload context assigned to the service-instance. + created-at: + type: string + description: create time of Network Service. + updated-at: + type: string + description: last update of Network Service. + description: + type: string + description: short description for service-instance. + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. + persona-model-version: + type: string + description: the ASDC model version for this resource or service model. + widget-model-id: + type: string + description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. + widget-model-version: + type: string + description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. + bandwidth-total: + type: string + description: Indicates the total bandwidth to be used for this service. + bandwidth-up-wan1: + type: string + description: indicates the upstream bandwidth this service will use on the WAN1 port of the physical device. + bandwidth-down-wan1: + type: string + description: indicates the downstream bandwidth this service will use on the WAN1 port of the physical device. + bandwidth-up-wan2: + type: string + description: indicates the upstream bandwidth this service will use on the WAN2 port of the physical device. + bandwidth-down-wan2: + type: string + description: indicates the downstream bandwidth this service will use on the WAN2 port of the physical device. + vhn-portal-url: + type: string + description: URL customers will use to access the vHN Portal. + service-instance-location-id: + type: string + description: An identifier that customers assign to the location where this service is being used. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + selflink: + type: string + description: Path to the controller object. + orchestration-status: + type: string + description: Orchestration status of this service. + relationship-list: type: array items: - $ref: "#/definitions/vnfc" - l3-networks: + $ref: "#/getDefinitions/relationship" + metadata: type: array items: - $ref: "#/definitions/l3-network" - network-policies: + $ref: "#/getDefinitions/metadatum" + allotted-resources: type: array items: - $ref: "#/definitions/network-policy" - generic-vnfs: + $ref: "#/getDefinitions/allotted-resource" + service-instances: + description: | + Collection of service instances + properties: + service-instance: type: array - items: - $ref: "#/definitions/generic-vnf" - lag-links: + items: + $ref: "#/getDefinitions/service-instance" + service-subscription: + description: | + Object that group service instances. + ###### Related Nodes + - TO customer( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE) + - TO tenant( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE) + - SERVICE-SUBSCRIPTION is DELETED when these are DELETED SERVICE-INSTANCE + required: + - service-type + properties: + service-type: + type: string + description: Value defined by orchestration to identify this service across ECOMP. + temp-ub-sub-account-id: + type: string + description: This property will be deleted from A&AI in the near future. Only stop gap solution. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + service-instances: type: array items: - $ref: "#/definitions/lag-link" - newvces: + $ref: "#/getDefinitions/service-instance" + relationship-list: type: array items: - $ref: "#/definitions/newvce" - pnfs: + $ref: "#/getDefinitions/relationship" + service-subscriptions: + description: | + Collection of objects that group service instances. + properties: + service-subscription: type: array - items: - $ref: "#/definitions/pnf" - physical-links: + items: + $ref: "#/getDefinitions/service-subscription" + services: + description: | + Collection of service model definitions. Likely to be deprecated in favor of models from ASDC. + properties: + service: type: array - items: - $ref: "#/definitions/physical-link" - ipsec-configurations: + items: + $ref: "#/getDefinitions/service" + site-pair: + description: | + ###### Related Nodes + - TO routing-instance( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE) + - FROM class-of-service( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE) + - SITE-PAIR is DELETED when these are DELETED CLASS-OF-SERVICE + required: + - site-pair-id + properties: + site-pair-id: + type: string + description: unique identifier of probe + source-ip: + type: string + description: Prefix address + destination-ip: + type: string + description: Prefix address + ip-version: + type: string + description: ip version, v4, v6 + destination-hostname: + type: string + description: Hostname of the destination equipment to which SLAs are measured against. + destination-equip-type: + type: string + description: The type of destinatination equipment. Could be Router, UCPE, etc. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + classes-of-service: type: array items: - $ref: "#/definitions/ipsec-configuration" - route-table-references: + $ref: "#/getDefinitions/class-of-service" + relationship-list: type: array items: - $ref: "#/definitions/route-table-reference" - instance-groups: + $ref: "#/getDefinitions/relationship" + site-pair-set: + description: | + Set of instances for probes used to measure service level agreements + ###### Related Nodes + - TO generic-vnf( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY) + - FROM routing-instance( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE) + - SITE-PAIR-SET is DELETED when these are DELETED ROUTING-INSTANCE + required: + - site-pair-set-id + properties: + site-pair-set-id: + type: string + description: Unique id of site pair set. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + routing-instances: type: array items: - $ref: "#/definitions/instance-group" - zones: + $ref: "#/getDefinitions/routing-instance" + relationship-list: type: array items: - $ref: "#/definitions/zone" - inventory: + $ref: "#/getDefinitions/relationship" + site-pair-sets: + description: | + Collection of sets of instances for probes related to generic-vnf properties: - search: - type: object - $ref: "#/definitions/search" - actions: - type: object - $ref: "#/definitions/actions" - cloud-infrastructure: - type: object - $ref: "#/definitions/cloud-infrastructure" - external-system: - type: object - $ref: "#/definitions/external-system" - business: - type: object - $ref: "#/definitions/business" - service-design-and-creation: - type: object - $ref: "#/definitions/service-design-and-creation" - network: - type: object - $ref: "#/definitions/network" - aai-internal: - type: object - $ref: "#/definitions/aai-internal" - nodes: + site-pair-set: type: array - items: - $ref: "#/definitions/" - edge-tag-query-result: + items: + $ref: "#/getDefinitions/site-pair-set" + site-pairs: + description: | + probe within a set properties: - tagged-inventory-item-list: + site-pair: type: array items: - $ref: "#/definitions/tagged-inventory-item-list" - tagged-inventory-item-list: + $ref: "#/getDefinitions/site-pair" + snapshot: + description: | + Openstack snapshot + ###### Related Nodes + - TO cloud-region( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - FROM vserver( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE) + required: + - snapshot-id properties: - inventory-item: + snapshot-id: + type: string + description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots. + snapshot-name: + type: string + description: Snapshot name + snapshot-architecture: + type: string + description: Operating system architecture + snapshot-os-distro: + type: string + description: The common name of the operating system distribution in lowercase + snapshot-os-version: + type: string + description: The operating system version as specified by the distributor. + application: + type: string + description: The application that the image instantiates. + application-vendor: + type: string + description: The vendor of the application. + application-version: + type: string + description: The version of the application. + snapshot-selflink: + type: string + description: URL to endpoint where AAI can get more details + prev-snapshot-id: + type: string + description: This field contains the UUID of the previous snapshot (if any). + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + snapshots: + description: | + Collection of openstack snapshots + properties: + snapshot: type: array items: - $ref: "#/definitions/inventory-item" - inventory-item: + $ref: "#/getDefinitions/snapshot" + sriov-pf: + description: | + SR-IOV Physical Function + ###### Related Nodes + - TO p-interface( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE) + - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE) + required: + - pf-pci-id properties: - inventory-item-type: + pf-pci-id: type: string - inventory-item-link: + description: Identifier for the sriov-pf + resource-version: type: string - inventory-item-data: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: type: array - items: - $ref: "#/definitions/inventory-item-data" - tagged-inventory-item-list: + items: + $ref: "#/getDefinitions/relationship" + sriov-pfs: + description: | + Collection of SR-IOV Physical Functions. + properties: + sriov-pf: type: array items: - $ref: "#/definitions/tagged-inventory-item-list" - inventory-item-data: + $ref: "#/getDefinitions/sriov-pf" + sriov-vf: + description: | + SR-IOV Virtual Function (not to be confused with virtual network function) + ###### Related Nodes + - TO l-interface( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE) + - TO sriov-pf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE) + required: + - pci-id properties: - property-name: + pci-id: type: string - property-value: + description: PCI ID used to identify the sriov-vf + vf-vlan-filter: type: string - edge-tag-query-request: - properties: - edge-tag: + description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM. + vf-mac-filter: type: string - result-detail: + description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM. + vf-vlan-strip: + type: boolean + description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM. + vf-vlan-anti-spoof-check: + type: boolean + description: This option ensures anti VLAN spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs. + vf-mac-anti-spoof-check: + type: boolean + description: This option ensures anti MAC spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs. + vf-mirrors: type: string - start-node-type: + description: This option defines the set of Mirror objects which essentially mirrors the traffic from source to set of collector VNF Ports. + vf-broadcast-allow: + type: boolean + description: This option, if set to true, sets the VF in promiscuous mode and allows all broadcast traffic to reach the VM + vf-unknown-multicast-allow: + type: boolean + description: This option, if set to true, sets the VF in promiscuous mode and allows unknown multicast traffic to reach the VM + vf-unknown-unicast-allow: + type: boolean + description: This option, if set to true, sets the VF in promiscuous mode and allows unknown unicast traffic to reach the VM + vf-insert-stag: + type: boolean + description: This option, if set to true, instructs to insert outer tag after traffic comes out of VM. + vf-link-status: type: string - start-node-filter: - type: array - items: - $ref: "#/definitions/start-node-filter" - include-node-filter: + description: This option is used to set the link status. Valid values as of 1607 are on, off, and auto. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + neutron-network-id: + type: string + description: Neutron network id of the interface + relationship-list: type: array - items: - $ref: "#/definitions/include-node-filter" - secondary-filter: + items: + $ref: "#/getDefinitions/relationship" + sriov-vfs: + description: | + Collection of SR-IOV Virtual Functions. + properties: + sriov-vf: type: array items: - $ref: "#/definitions/secondary-filter" + $ref: "#/getDefinitions/sriov-vf" start-node-filter: properties: property-name: type: string property-value: type: string - include-node-filter: + subnet: + description: | + ###### Related Nodes + - TO l3-network( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY) + - FROM host-route( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE) + - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - SUBNET cannot be deleted if linked to L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST + - SUBNET is DELETED when these are DELETED HOST-ROUTE + required: + - subnet-id + - dhcp-enabled properties: - include-node-type: + subnet-id: type: string - secondary-filter: - properties: - property-name: + description: Subnet ID, should be UUID. + subnet-name: type: string - filter-type: + description: Name associated with the subnet. + neutron-subnet-id: type: string - property-value: + description: Neutron id of this subnet + gateway-address: type: string - search-results: + description: gateway ip address + network-start-address: + type: string + description: network start address + cidr-mask: + type: string + description: cidr mask + ip-version: + type: string + description: ip version + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by MSO + dhcp-enabled: + type: boolean + dhcp-start: + type: string + description: the start address reserved for use by dhcp + dhcp-end: + type: string + description: the last address reserved for use by dhcp + subnet-role: + type: string + description: role of the subnet, referenced when assigning IPs + ip-assignment-direction: + type: string + description: ip address assignment direction of the subnet + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + subnet-sequence: + type: integer + format: int32 + description: sequence of the subnet + host-routes: + type: array + items: + $ref: "#/getDefinitions/host-route" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + subnets: properties: - result-data: + subnet: type: array items: - $ref: "#/definitions/result-data" - result-data: + $ref: "#/getDefinitions/subnet" + tagged-inventory-item-list: properties: - resource-type: + inventory-item: + type: array + items: + $ref: "#/getDefinitions/inventory-item" + tenant: + description: | + Openstack tenant + ###### Related Nodes + - TO cloud-region( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO group-assignment( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY) + - TO l3-network( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY) + - TO volume-group( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + - FROM service-subscription( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY) + - FROM vserver( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE) + - TENANT cannot be deleted if linked to VSERVER + required: + - tenant-id + - tenant-name + properties: + tenant-id: type: string - description: The specific type of node in the A&AI graph - resource-link: + description: Unique id relative to the cloud-region. + tenant-name: type: string - description: The URL to the specific resource - sdn-zone-response: + description: Readable name of tenant + tenant-context: + type: string + description: This field will store the tenant context. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + vservers: + type: array + items: + $ref: "#/getDefinitions/vserver" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + tenants: + description: | + Collection of openstack tenants. properties: - oam-networks: - type: object - $ref: "#/definitions/oam-networks" - az-and-dvs-switches: + tenant: type: array items: - $ref: "#/definitions/az-and-dvs-switches" - az-and-dvs-switches: + $ref: "#/getDefinitions/tenant" + tunnel-xconnect: + description: | + Represents the specifics of a tunnel cross connect piece of a resource that gets separately allotted + ###### Related Nodes + - TO allotted-resource( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE) + required: + - id + - bandwidth-up-wan1 + - bandwidth-down-wan1 + - bandwidth-up-wan2 + - bandwidth-down-wan2 properties: - dvs-switches: - type: object - $ref: "#/definitions/dvs-switches" - availability-zone: - type: object - $ref: "#/definitions/availability-zone" + id: + type: string + description: Allotted Resource id UUID assigned to this instance. + bandwidth-up-wan1: + type: string + description: The WAN uplink bandwidth for WAN1 + bandwidth-down-wan1: + type: string + description: The WAN downlink bandwidth for WAN1 + bandwidth-up-wan2: + type: string + description: The WAN uplink bandwidth for WAN2 + bandwidth-down-wan2: + type: string + description: The WAN downlink bandwidth for WAN2 + resource-version: + type: string + description: Concurrency value + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + tunnel-xconnects: + description: | + This object is used to store the specific tunnel cross connect aspects of an allotted resource + properties: + tunnel-xconnect: + type: array + items: + $ref: "#/getDefinitions/tunnel-xconnect" update: description: | Serves a PATCH like function. Does not enforce concurrency control. Clear each usage with AAI team. @@ -46406,341 +66736,823 @@ definitions: update-node-key: type: array items: - $ref: "#/definitions/update-node-key" + $ref: "#/getDefinitions/update-node-key" update-node-uri: type: string action: type: array items: - $ref: "#/definitions/action" - action: - properties: - action-type: - type: string - action-data: - type: array - items: - $ref: "#/definitions/action-data" - action-data: - properties: - property-name: - type: string - property-value: - type: string + $ref: "#/getDefinitions/action" update-node-key: properties: key-name: type: string key-value: type: string - notify: + vce: + description: | + Virtual Customer Edge Router, used specifically for Gamma. This object is deprecated. + ###### Related Nodes + - TO availability-zone( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY) + - TO complex( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY) + - TO vserver( vce tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM license( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM port-group( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY) + - VCE is DELETED when these are DELETED ENTITLEMENT,LICENSE,PORT-GROUP required: - - event-id + - vnf-id + - vnf-name + - vnf-type properties: - event-id: + vnf-id: type: string - node-type: + description: Unique id of VNF. This is unique across the graph. + vnf-name: type: string - event-trigger: + description: Name of VNF. + vnf-name2: type: string - key-data: - type: array - items: - $ref: "#/definitions/key-data" - selflink: + description: Alternate name of VNF. + vnf-type: type: string - key-data: - properties: - key-name: + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + service-id: type: string - key-value: + description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED. + regional-resource-zone: type: string - configurations: + description: Regional way of organizing pservers, source of truth should define values + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + operational-status: + type: string + description: Indicator for whether the resource is considered operational + license-key: + type: string + description: OBSOLETE - do not use + equipment-role: + type: string + description: Network role being played by this VNF + orchestration-status: + type: string + description: Orchestration status of this VNF, mastered by MSO + heat-stack-id: + type: string + description: Heat stack id corresponding to this instance, managed by MSO + mso-catalog-key: + type: string + description: Corresponds to the SDN-C catalog id used to configure this VCE + vpe-id: + type: string + description: Unique ID of VPE connected to this VCE. + v6-vce-wan-address: + type: string + description: Valid v6 IP address for the WAN Link on this router. Implied length of /64. + ipv4-oam-address: + type: string + description: Address tail-f uses to configure vce, also used for troubleshooting and is IP used for traps generated by VCE. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + ipv4-loopback0-address: + type: string + description: Loopback0 address + entitlement-resource-uuid: + type: string + description: OBSOLETE - see child relationships + port-groups: + type: array + items: + $ref: "#/getDefinitions/port-group" + licenses: + type: array + items: + $ref: "#/getDefinitions/license" + entitlements: + type: array + items: + $ref: "#/getDefinitions/entitlement" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + vces: description: | - Collection of configurations + Collection of Virtual Customer Edge Routers, used specifically for Gamma. This object is deprecated. properties: - configuration: + vce: type: array items: - $ref: "#/definitions/configuration" - configuration: + $ref: "#/getDefinitions/vce" + vf-module: description: | - Port Mirror Configuration. + a deployment unit of VNFCs ###### Related Nodes - - TO logical-link (One2Many) - - TO metadatum (comprises configuration, One2Many) - - TO allotted-resource (One2One) - - FROM service-instance - - FROM generic-vnf + - TO generic-vnf( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO l3-network( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY) + - TO vnfc( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY) + - TO volume-group( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE) + - TO vserver( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY) + - VF-MODULE cannot be deleted if linked to VNFC required: - - configuration-id - - configuration-type - - configuration-sub-type - - orchestration-status - - operational-status - - configuration-selflink - - model-customization-id + - vf-module-id + - is-base-vf-module properties: - management-option: + vf-module-id: type: string - description: Indicates the entity that will manage this feature. Could be an organization or the name of the application as well. - configuration-id: + description: Unique ID of vf-module. + vf-module-name: type: string - description: UUID assigned to configuration. - configuration-name: + description: Name of vf-module + heat-stack-id: type: string - description: Name of the configuration. - configuration-type: + description: Heat stack id corresponding to this instance. + orchestration-status: type: string - description: port-mirroring-configuration. - configuration-sub-type: + description: orchestration status of this vf-module, mastered by MSO + is-base-vf-module: + type: boolean + resource-version: type: string - description: vprobe, pprobe. + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. model-invariant-id: type: string description: the ASDC model id for this resource or service model. model-version-id: type: string description: the ASDC model version for this resource or service model. - orchestration-status: + persona-model-version: type: string - description: Orchestration status of the configuration. - operational-status: + description: the ASDC model version for this resource or service model. + model-customization-id: type: string - description: Indicator for whether the resource is considered operational. - configuration-selflink: + description: captures the id of all the configuration used to customize the resource for the service. + widget-model-id: type: string - description: URL to endpoint where AAI can get more details from SDN-GC. - model-customization-id: + description: the ASDC data dictionary widget model. This maps directly to the A&AI widget. + widget-model-version: type: string - description: id of the configuration used to customize the resource - resource-version: + description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget. + contrail-service-instance-fqdn: type: string - description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + description: the Contrail unique ID for a service-instance + module-index: + type: integer + format: int32 + description: the index will track the number of modules of a given type that have been deployed in a VNF, starting with 0, and always choosing the lowest available digit + selflink: + type: string + description: Path to the controller object. relationship-list: - type: object - $ref: "#/definitions/relationship-list" - metadata: - type: object - $ref: "#/definitions/metadata" - notification-event: + type: array + items: + $ref: "#/getDefinitions/relationship" + vf-modules: + description: | + Collection of vf-modules, a deployment unit of VNFCs properties: - cambria.partition: - type: string - notification-event-header: - type: object - $ref: "#/definitions/notification-event-header" - notification-event-header: + vf-module: + type: array + items: + $ref: "#/getDefinitions/vf-module" + vig-server: + description: | + vig-server contains information about a vig server used for IPSec-configuration. Populated by SDN-C from 1607 + ###### Related Nodes + - TO ipsec-configuration( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE) + required: + - vig-address-type properties: - id: - type: string - timestamp: + vig-address-type: type: string - source-name: + description: indicates whether the VIG is for AVPN or INTERNET + ipaddress-v4-vig: type: string - domain: + description: v4 IP of the vig server + ipaddress-v6-vig: type: string - sequence-number: + description: v6 IP of the vig server + resource-version: type: string - severity: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + vig-servers: + properties: + vig-server: + type: array + items: + $ref: "#/getDefinitions/vig-server" + vip-ipv4-address-list: + description: | + IPv4 Address Range + ###### Related Nodes + - TO cloud-region( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO instance-group( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO subnet( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY) + required: + - vip-ipv4-address + properties: + vip-ipv4-address: type: string - event-type: + description: IP address + vip-ipv4-prefix-length: + type: integer + format: int64 + description: Prefix length, 32 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + resource-version: type: string - version: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + neutron-network-id: type: string - action: + description: Neutron network id of the interface that address belongs to + neutron-subnet-id: type: string - entity-type: + description: Neutron id of subnet that address belongs to + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + vip-ipv6-address-list: + description: | + IPv6 Address Range + ###### Related Nodes + - TO cloud-region( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO instance-group( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO subnet( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY) + - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY) + required: + - vip-ipv6-address + properties: + vip-ipv6-address: type: string - top-entity-type: + description: IP address + vip-ipv6-prefix-length: + type: integer + format: int64 + description: Prefix length, 128 for single address + vlan-id-inner: + type: integer + format: int64 + description: Inner VLAN tag + vlan-id-outer: + type: integer + format: int64 + description: Outer VLAN tag + is-floating: + type: boolean + description: Indicator of fixed or floating address + resource-version: type: string - entity-link: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + neutron-network-id: type: string - status: + description: Neutron network id of the interface that address belongs to + neutron-subnet-id: type: string - reserved-prop-names: + description: Neutron id of subnet that address belongs to + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + virtual-data-center: description: | - Internal map to define some reserved properties of a vertex + Virtual organization of cloud infrastructure elements in a data center context + ###### Related Nodes + - FROM connector( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY) + required: + - vdc-id + - vdc-name properties: - last-mod-source-of-truth: + vdc-id: type: string - aai-node-type: + description: Unique ID of the vdc + vdc-name: type: string - aai-created-ts: + description: Name of the virtual data center + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + virtual-data-centers: + description: | + Virtual organization of cloud infrastructure elements in a data center context + properties: + virtual-data-center: + type: array + items: + $ref: "#/getDefinitions/virtual-data-center" + vlan: + description: | + Definition of vlan + ###### Related Nodes + - TO l-interface( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE) + - TO logical-link( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY) + - TO multicast-configuration( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY) + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY) + - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE) + - VLAN is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST + - VLAN deletion means associated objects of these types are also DELETED:LOGICAL-LINK + required: + - vlan-interface + - in-maint + - is-ip-unnumbered + properties: + vlan-interface: + type: string + description: String that identifies the interface + vlan-id-inner: type: integer format: int64 - aai-unique-key: - type: string - aai-last-mod-ts: + description: Inner VLAN tag + vlan-id-outer: type: integer format: int64 - source-of-truth: + description: Outer VLAN tag + resource-version: type: string - aai-uri: + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + speed-value: type: string - edge-prop-names: - description: | - Internal map to define the properties of an edge and interpret the map EdgeRules - properties: - edgeLabel: + description: Captures the numeric part of the speed + speed-units: type: string - direction: + description: Captures the units corresponding to the speed + vlan-description: type: string - multiplicityRule: + description: Used to describe (the service associated with) the vlan + backdoor-connection: type: string - contains-other-v: + description: Whether customer is going to use this VLAN for backdoor connection to another customer premise device. + vpn-key: type: string - delete-other-v: + description: This indicates the customers VPN ID associated with this vlan + orchestration-status: type: string - SVC-INFRA: + description: Status of a vnf's vlan interface, on which the customer circuit resides, mastered by SDN-C. + in-maint: + type: boolean + prov-status: type: string - prevent-delete: + description: Prov Status of the VLAN configuration related to a logical interface. Valid values [PREPROV/NVTPROV/PROV]. + is-ip-unnumbered: + type: boolean + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + l3-interface-ipv4-address-list: + type: array + items: + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" + l3-interface-ipv6-address-list: + type: array + items: + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" + vlans: + properties: + vlan: + type: array + items: + $ref: "#/getDefinitions/vlan" + vnf: + description: | + Abstract vnf class + required: + - vnf-id + properties: + vnf-id: type: string - model-and-named-query-search: + description: Unique id of VNF. This is unique across the graph. + vnf-image: description: | - ModelAndNamedQuerySearch holds query-parameters and instance-properties for performing a named-query or model query + Image object that pertain to a VNF that doesn't have associated vservers. This is a kludge. + ###### Related Nodes + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE) + - VNF-IMAGE cannot be deleted if linked to GENERIC-VNF + required: + - vnf-image-uuid + - application + - application-vendor properties: - query-parameters: - type: object - $ref: "#/definitions/query-parameters" - instance-filters: - type: object - $ref: "#/definitions/instance-filters" - secondary-filts: - type: object - $ref: "#/definitions/secondary-filts" - top-node-type: + vnf-image-uuid: type: string - secondary-filter-cut-point: + description: Unique ID of this asset + application: type: string - query-parameters: + description: The application that the image instantiates. + application-vendor: + type: string + description: The vendor of the application. + application-version: + type: string + description: The version of the application. + selflink: + type: string + description: URL to endpoint where AAI can get more details + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + vnf-images: description: | - QueryParameters for performing a named-query or model query + Collection of image objects that pertain to a VNF that doesn't have associated vservers. This is a kludge. properties: - named-query: - type: object - $ref: "#/definitions/named-query" - overloaded-model: - type: object - $ref: "#/definitions/overloaded-model" - overloaded-model: + vnf-image: + type: array + items: + $ref: "#/getDefinitions/vnf-image" + vnfc: description: | - Allows for legacy POST of old-style and new-style models + ###### Related Nodes + - TO generic-vnf( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE) + - TO instance-group( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY) + - TO vip-ipv4-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY) + - TO vip-ipv6-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY) + - TO vserver( vnfc tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY) + - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE) + - VNFC is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST required: - - model-invariant-id - - model-name-version-id - - model-type - - model-name - - model-id - - model-version + - vnfc-name + - nfc-naming-code + - nfc-function + - in-maint + - is-closed-loop-disabled properties: - model-invariant-id: + vnfc-name: type: string - description: Unique identifier corresponding to the main definition of a model in ASDC - model-name-version-id: + description: Unique ID of vnfc. + nfc-naming-code: type: string - description: Unique identifier corresponding to one version of a model in ASDC - model-type: + description: Short code that is used in naming instances of the item being modeled + nfc-function: type: string - description: Type of the model, e.g., service, resource, widget, etc. - model-name: + description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service + prov-status: type: string - description: Name of the model, which can change from version to version. - model-id: + description: prov status of this vnfc + orchestration-status: type: string - description: Invariant unique ID which does not change from version to version - model-version: + description: Orchestration status of this VNF, mastered by APP-C + ipaddress-v4-oam-vip: type: string - description: Version - model-description: + description: Oam V4 vip address of this vnfc + in-maint: + type: boolean + is-closed-loop-disabled: + type: boolean + group-notation: type: string - description: Description + description: Group notation of VNFC + model-invariant-id: + type: string + description: the ASDC model id for this resource or service model. + model-version-id: + type: string + description: the ASDC model version for this resource or service model. resource-version: type: string description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. - model-vers: - type: object - $ref: "#/definitions/model-vers" relationship-list: - type: object - $ref: "#/definitions/relationship-list" - instance-filters: + type: array + items: + $ref: "#/getDefinitions/relationship" + l3-interface-ipv4-address-list: + type: array + items: + $ref: "#/getDefinitions/l3-interface-ipv4-address-list" + l3-interface-ipv6-address-list: + type: array + items: + $ref: "#/getDefinitions/l3-interface-ipv6-address-list" + vnfcs: description: | - InstanceFilters for performing a named-query or model query + virtual network components associated with a vserver from application controller. properties: - instance-filter: + vnfc: type: array items: - $ref: "#/definitions/instance-filter" - instance-filter: + $ref: "#/getDefinitions/vnfc" + volume: description: | - InstanceFilter for performing a named-query or model query - secondary-filts: + Ephemeral Block storage volume. + ###### Related Nodes + - FROM vserver (PARENT of volume, vserver tosca.relationships.AttachesTo volume) + required: + - volume-id + - volume-selflink + properties: + volume-id: + type: string + description: Unique ID of block storage volume relative to the vserver. + volume-selflink: + type: string + description: URL to endpoint where AAI can get more details + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + volume-group: description: | - SecondaryFilts for performing a named-query or model query + Persistent block-level storage. + ###### Related Nodes + - TO cloud-region( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE) + - TO complex( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + - FROM vf-module( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE) + - FROM tenant( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY) + required: + - volume-group-id + - volume-group-name + - vnf-type properties: - secondary-filt: + volume-group-id: + type: string + description: Unique ID of volume-group. + volume-group-name: + type: string + description: Name of the volume group. + heat-stack-id: + type: string + description: Heat stack id corresponding to this volume-group + vnf-type: + type: string + description: String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures. + orchestration-status: + type: string + description: Orchestration status of this volume-group + model-customization-id: + type: string + description: captures the id of all the configuration used to customize the resource for the service. + vf-module-model-customization-id: + type: string + description: helps relate the volume group to the vf-module whose components will require the volume group + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + volume-groups: + description: | + Collection of persistent block-level storage. + properties: + volume-group: type: array items: - $ref: "#/definitions/secondary-filt" - secondary-filt: + $ref: "#/getDefinitions/volume-group" + volumes: description: | - SecondaryFilt for performing a named-query or model query - properties: + Collection of ephemeral Block storage volumes. + properties: + volume: + type: array + items: + $ref: "#/getDefinitions/volume" + vpls-pe: description: | - Property holder for query properties or instance properties + VPLS Provider Edge routers. + ###### Related Nodes + - TO complex( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - TO ctag-pool( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY) + - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - FROM p-interface( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE) + - VPLS-PE is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE + required: + - equipment-name properties: - property-name: + equipment-name: type: string - property-value: + prov-status: type: string - response-list: + description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems. + ipv4-oam-address: + type: string + description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address). + equipment-role: + type: string + description: Client should send valid enumerated value, e.g., VPLS-PE. + vlan-id-outer: + type: integer + format: int64 + description: Temporary location for stag to get to VCE + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + p-interfaces: + type: array + items: + $ref: "#/getDefinitions/p-interface" + lag-interfaces: + type: array + items: + $ref: "#/getDefinitions/lag-interface" + vpls-pes: description: | - Response container for the results of a named-query or model query + Collection of VPLS Provider Edge routers properties: - inventory-response-items: - type: object - $ref: "#/definitions/inventory-response-items" - inventory-response-items: + vpls-pe: + type: array + items: + $ref: "#/getDefinitions/vpls-pe" + vpn-binding: description: | - Container for inventory items in response list + VPN binding + ###### Related Nodes + - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY) + - FROM l3-network( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - FROM logical-link( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY) + - FROM route-target( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE) + - VPN-BINDING cannot be deleted if linked to ALLOTTED-RESOURCE,L3-NETWORK,LOGICAL-LINK + - VPN-BINDING is DELETED when these are DELETED ROUTE-TARGET + required: + - vpn-id + - vpn-name properties: - inventory-response-item: + vpn-id: + type: string + description: VPN ID, globally unique within A&AI + vpn-name: + type: string + description: VPN Name + vpn-platform: + type: string + description: the platform associated with the VPN example AVPN, Mobility + vpn-type: + type: string + description: Type of the vpn, should be taken from enumerated/valid values + vpn-region: + type: string + description: region of customer vpn + customer-vpn-id: + type: string + description: id for this customer vpn + route-distinguisher: + type: string + description: Used to distinguish the distinct VPN routes of separate customers who connect to the provider in an MPLS network. + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + route-targets: + type: array + items: + $ref: "#/getDefinitions/route-target" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + description: l3-networks relate to vpn-bindings + vpn-bindings: + properties: + vpn-binding: type: array items: - $ref: "#/definitions/inventory-response-item" - inventory-response-item: + $ref: "#/getDefinitions/vpn-binding" + vserver: description: | - Inventory item for response list + Virtual Servers, aka virtual machine or VM. + ###### Related Nodes + - TO tenant( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE) + - TO flavor( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE) + - TO image( vserver org.onap.relationships.inventory.Uses image, MANY2ONE) + - TO pserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE) + - TO snapshot( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE) + - TO volume (CHILD of vserver, vserver tosca.relationships.AttachesTo volume, ONE2MANY) + - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM vce( vce tosca.relationships.HostedOn vserver, ONE2MANY) + - FROM l-interface( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE) + - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY) + - FROM vnfc( vnfc tosca.relationships.HostedOn vserver, ONE2MANY) + - VSERVER is DELETED when these are DELETED L-INTERFACE + - VSERVER deletion means associated objects of these types are also DELETED:VOLUME + required: + - vserver-id + - vserver-name + - vserver-selflink + - in-maint + - is-closed-loop-disabled properties: - model-name: + vserver-id: type: string - extra-properties: - type: object - $ref: "#/definitions/extra-properties" - inventory-response-items: - type: object - $ref: "#/definitions/inventory-response-items" - extra-properties: + description: Unique identifier for this vserver relative to its tenant + vserver-name: + type: string + description: Name of vserver + vserver-name2: + type: string + description: Alternative name of vserver + prov-status: + type: string + description: Trigger for operational monitoring of this resource by Service Assurance systems. + vserver-selflink: + type: string + description: URL to endpoint where AAI can get more details + in-maint: + type: boolean + is-closed-loop-disabled: + type: boolean + resource-version: + type: string + description: Used for optimistic concurrency. Must be empty on create, valid on update and delete. + volumes: + type: array + items: + $ref: "#/getDefinitions/volume" + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + l-interfaces: + type: array + items: + $ref: "#/getDefinitions/l-interface" + vservers: description: | - Extra properties for inventory item for response list + Collection of virtual Servers, aka virtual machines or VMs. properties: - extra-property: + vserver: type: array items: - $ref: "#/definitions/extra-property" - extra-property: + $ref: "#/getDefinitions/vserver" + zone: + description: | + A zone is a grouping of assets in a location homing to the same connections into the CBB + ###### Related Nodes + - TO complex( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE) + - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + - FROM service-instance( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE) + required: + - zone-id + - zone-name + - design-type + - zone-context properties: - property-name: + zone-id: type: string - property-value: + description: Code assigned by AIC to the zone + zone-name: type: string - vnf: + description: English name associated with the zone + design-type: + type: string + description: Design of zone [Medium/Large?] + zone-context: + type: string + description: Context of zone [production/test] + status: + type: string + description: Status of a zone. + resource-version: + type: string + description: Concurrency value + relationship-list: + type: array + items: + $ref: "#/getDefinitions/relationship" + zones: description: | - Abstract vnf class - required: - - vnf-id + Collection of zones properties: - vnf-id: - type: string - description: Unique id of VNF. This is unique across the graph. + zone: + type: array + items: + $ref: "#/getDefinitions/zone" |