I am looking for clarity on intended use and differences between the following properties in Port schema:
All three properties are writable. The first two are Boolean and LinkState is an Enum with the values “Enabled” or “Disabled”.
From the property description it is unclear to me what functional change each property should have on a port. And it is unclear how the port should behave by setting different permutations of the three (2 enabled & 1 disabled, or the other way around).
I agree those need some clarity in the descriptions to better explain their usage. InterfaceEnabled and LinkState were both added to support ports on fabric adapters, so that may help explain the intent. Enabled was an original property for this schema, and therefore is likely the first one you should support - with the others perhaps not being relevant for many types of ports / adapters...
I've opened an issue for the group to take a look at these descriptions - but note that our next meeting is after the holidays, so it will be about two weeks before I can get you a better answer...