Skip to content

Commit 09c7d2f

Browse files
authored
Update protocol values in known-issues document (#148)
* Clarify support for new protocol in known issues Updated issue summary to clarify support for new protocol values in security group rules and network ACL rules. * Update known-issues.md Signed-off-by: Astha Jain <astha.jain@ibm.com> * Update known-issues.md Signed-off-by: Astha Jain <astha.jain@ibm.com> --------- Signed-off-by: Astha Jain <astha.jain@ibm.com>
1 parent b7baa8a commit 09c7d2f

File tree

1 file changed

+16
-17
lines changed

1 file changed

+16
-17
lines changed

known-issues.md

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,33 @@
11
# Known Issues for vpc-go-sdk
22

3-
## Security Group Rules and Network ACL Rules - discriminator issue
3+
## Security Group Rules and Network ACL Rules - backward compatibility issue
44
#### Publication date - "2025-12-18"
55

6-
### Patch fix versions available in the following versions -
7-
[v0.76.5](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.76.5)
8-
[v0.75.1](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.75.1)
9-
[v0.74.2](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.74.2)
10-
[v0.73.1](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.73.1)
11-
[v0.72.1](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.72.1)
12-
[v0.71.2](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.71.2)
13-
[v0.70.2](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.70.2)
14-
[v0.69.2](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.69.2)
15-
[v0.68.1](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.68.1)
16-
and later versions
17-
186
### Affected component
197
vpc-go-sdk
208

219
### Affected operations
2210
Security group rules and Network ACL rules
2311

2412
### Issue Summary
25-
#### Support for `any` Protocol in Security Group Rules and Network ACL Rules
26-
Security Group rules and Network ACL rules now support the new protocol value `any`. Earlier versions of SDK could result in following error reading a rule with an unsupported protocol value.
13+
#### Golang SDK Backward compatibility with new protocols in Network Access Controls and Security Group rules
14+
Following the new support for [all IPv4 protocols for ACL and Security Group rules](https://cloud.ibm.com/docs/vpc?topic=vpc-release-notes#vpc-dec1225), earlier versions of the Golang SDK must be updated to avoid the following parsing error when handling rules with the new protocols:
15+
2716
```
2817
error unmarshalling vpcv1.SecurityGroupCollection: error unmarshalling property 'security_groups' as []vpcv1.SecurityGroup: error unmarshalling property 'rules' as []vpcv1.SecurityGroupRuleIntf: unrecognized value for discriminator property 'protocol': any
2918
```
3019

31-
Fix aligns fallback behavior and error identifiers with the correct model name ( e.g. NetworkACLRule instead of NetworkACLRuleItem).
20+
The patched SDKs implement the correct fallback behavior and error identifiers with the correct model name (e.g. NetworkACLRule instead of NetworkACLRuleItem).
3221

3322
### Migration & mitigation
34-
Migrate to one of the patched versions, or update the SDK to the [latest version](https://github.com/IBM/vpc-go-sdk/releases)
23+
To mitigate this issue, migrate the `vpc-go-sdk` to the latest version ([v0.78.0](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.78.0)) or any of the patched versions below:
24+
[v0.77](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.77.0)
25+
[v0.76](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.76.5)
26+
[v0.75](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.75.1)
27+
[v0.74](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.74.2)
28+
[v0.73](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.73.1)
29+
[v0.72](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.72.1)
30+
[v0.71](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.71.2)
31+
[v0.70](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.70.2)
32+
[v0.69](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.69.2)
33+
[v0.68](https://github.com/IBM/vpc-go-sdk/releases/tag/v0.68.1)

0 commit comments

Comments
 (0)