|
1 | 1 | # Known Issues for vpc-go-sdk |
2 | 2 |
|
3 | | -## Security Group Rules and Network ACL Rules - discriminator issue |
| 3 | +## Security Group Rules and Network ACL Rules - backward compatibility issue |
4 | 4 | #### Publication date - "2025-12-18" |
5 | 5 |
|
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 | | - |
18 | 6 | ### Affected component |
19 | 7 | vpc-go-sdk |
20 | 8 |
|
21 | 9 | ### Affected operations |
22 | 10 | Security group rules and Network ACL rules |
23 | 11 |
|
24 | 12 | ### 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 | + |
27 | 16 | ``` |
28 | 17 | 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 |
29 | 18 | ``` |
30 | 19 |
|
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). |
32 | 21 |
|
33 | 22 | ### 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