Add support to the Runtime Defined Entities (RDE) framework with Defined Interfaces (1/3)

[adambarreiro]

Overview

This PR implements the foundations to onboard the RDE framework to the Terraform VCD Provider, by adding CRUD capabilities of Defined Interfaces.

Detailed description

This PR adds the following features:

• Adds the following new methods to the generic VCDClient:
  • CreateDefinedInterface to create a Defined Interface.
  • GetAllDefinedInterfaces to get all Defined Interfaces, supports parameters like filtering.
  • GetDefinedInterface gets a Defined Interface with its vendor+nss+version combination which is unique.
  • GetDefinedInterfaceById gets a Defined Interface with its URN, which is a combination of its vendor+nss+version underneath.
• Adds the following methods to the new DefinedInterface type:
  • Update updates a Defined Interface with the given input. At the moment, only the name can be updated. If other parameters are set, they are simply ignored.
  • Update deletes a Defined Interface. The interface can't be deleted if it's referenced by some RDE type.

Tests

The test in defined_interface_test.go checks the behaviour for both a System administrator and a tenant user.
While System admins have access to all CRUD methods, tenant users can only read Defined Interfaces. This characteristic is tested.

Found quirks

• Added the function amendDefinedInterfaceError to amend a bug in VCD ≤ v10.3.0 that causes GET calls to return a 400 instead of a 403 when the Defined Entity does not exist. This bug seems fixed in versions higher than 10.3.0. For example, in VCD 10.3.1 I cannot reproduce it even if the request is done with v36.0.

[Didainius]

A few tiny ones. And just a check on API elevation makes any sense. I am good in general. Will approve both after checking out in Terraform PR