Known issues
Known issues might change over time, so check back occasionally.
VPC Metadata API known issues
vcpu.manufacturer property returns an empty string value
Issue: When retrieving an instance, the value of the vcpu.manufacturer property is an empty string "".
VPC Identity API known issues
The /instance_identity methods return incorrect HTTP status
Issue: When a version query parameter of 2025-08-25 or earlier is used from bare metal servers, an incorrect HTTP response of 404 is returned for /instance_identity methods
that are used to create an identity token, create an identity certificate, and create an IAM token.
The behavior is correct when a version query parameter of 2025-08-26 or later is used.
When a beta version query parameter of 2025-07-14 or earlier from bare metal servers is used, an incorrect HTTP response of 404 is returned for all /instance_identity methods.
Confidential computing known issues
Select availability
TDX virtual servers are supported in Washington DC (us-east) and Frankfurt (eu-de) regions only
Issue: All confidential computing profiles support both Intel® Software Guard Extensions (SGX) and Intel® Trusted Domain Extensions (TDX). When you use the API to list instance profiles, such as with GET /instance/profiles or GET /instance/profiles/{name}, the response indicates that all confidential computing profiles support SGX and TDX. However, TDX is available in the Washington DC (us-east) and Frankfurt (eu-de) regions only. If you want
to create a virtual server instance with a confidential computing profile and TDX, you can create that virtual server instance in only the Washington DC (us-east) and Frankfurt (eu-de) regions. You can’t create a virtual server instance
with TDX in any other region, including Dallas (us-south).
s390x profiles don't include 'values' property
Issue: When listing instance profiles or retrieving an instance profile, s390x instance profiles don't include the required
values property in the confidential_compute_modes object. See s390x instance profiles for a complete list of profiles.
Image known issues
Checksum not available for some public images
Issue: When you use the API or CLI to list images, some public stock images might not include a checksum. The checksum is for informational purposes only for stock images. No fix is available.
A custom image that is created from a boot volume that was provisioned from an unencrypted image is bigger than the original image
Issue: If your custom image is not encrypted and the image is under 100 GB virtual disk size, deploying that image to an instance and creating a custom image from that instance's boot volume results in a minimum_provisioned_size of 100 GB. No fix is available.
Custom images in a private catalog known issue
Issue: If you imported one or more images into a virtual server image for VPC catalog product offering version and you edit that version, an extra version that ends in "draft" is created. You can't provision an instance
from this draft version. Draft versions might appear on the virtual server instance creation page in the console or in the output of the CLI command ibmcloud is catalog-image-offering.
Instance known issues and limitations
Default profile on POST /instances
Issue: When an instance is created without a profile specified by the user, it defaults to the bx2-2x8 profile instead of bxf-2x8.
Bare metal servers known issues and limitations
iPXE network boot known timing issue
Issue: When you use the iPXE network boot on a Bare Metal Server on VPC, the network configuration process might still be incomplete when the iPXE script starts running. When this issue occurs, the DHCP command might fail or you might see a timeout error. A fix for this issue is planned.
Workaround: From the VNC console, manually run the iPXE commands. Or, add the following content to your iPXE script instead of the DHCP command.
:retry_dhcp
dhcp || goto retry_dhcp
sleep 2
Issue: Flow log collectors are not integrated with bare metal servers. As a result, if you create a flow log collector for a VPC, traffic that flows to and from bare metal servers in that VPC aren't logged.
Issue: Network load balancers are not integrated with bare metal servers. As a result, if you create a network load balancer, you can't target a bare metal server as a load balancer pool member target.
Issue: You can't delete a subnet when you delete a bare metal server. Wait ~2 minutes after bare metal deletion before you delete the subnet.
Because all bare metal profiles are VMware® certified, the supported_image_flags image property and required_image_flags profile property that expressed this ability during the beta period are discontinued. These
properties might still be visible to API and CLI consumers, but they aren't supported and must not be used. These properties are planned to be removed in a future release.
Extra authorizations beyond the authorizations defined in the API specification
Issue: Some API implementations require authorizations that are different from the authorization requirements that are defined in the API specification. The following table lists these APIs and the extra permissions that are required that are in addition to what are defined in the specification. This table is updated as these issues are resolved.
| API | Additional access requirements | Action name |
|---|---|---|
PATCH /instances/{instance-id} |
Dedicated Host Operator, Dedicated Host Group Operator | is.dedicated-host.dedicated-host-group.operate (conditional)is.dedicated-host.dedicated-host.operate (conditional) |
POST /instances |
Subnet Editor | is.subnet.subnet.update (conditional) |
POST /instances/{instance-id}/actions |
Instance Editor | is.instance.instance.update |
POST /instances/{instance-id}/volume/_attachments |
Instance Editor | is.instance.instance.update |
DELETE /instances/{instance-id}/volume_attachments/{vol-attach-id} |
Instance Editor | is.instance.instance.update |
GET /network_acls/{nacl-id} |
VPC Viewer | is.vpc.vpc.read |
POST /network_acls/{nacl-id}/rules |
VPC Viewer | is.vpc.vpc.read |
GET /subnets/{subnet-id}/network_acl |
VPC Viewer | is.vpc.vpc.read |
PUT /subnets/{subnet-id}/network_acl |
VPC Viewer | is.vpc.vpc.read |
PATCH /floating_ips/{id} |
Subnet Operator | is.subnet.subnet.operate |
Storage known issues
Fast restore snapshots with customer-managed encryption issue
Issue: When you restore a volume from a snapshot by using the fast restore feature, you can use a different encryption key for the snapshot and for the new volume. If you delete the snapshot encryption key from the key management service, the volume might still become inaccessible when it is attached or reattached to a virtual server instance.
Workaround: To recover the snapshot encryption key, use the key recovery procedure. When the key is recovered, the volume becomes accessible.
Volumes and snapshots omit the catalog offering information for unbilled catalog offering versions
Issue: When you retrieve a volume or snapshot that was originally provisioned as a boot volume in an instance with a billed catalog offering and without a billing plan, the response does not include the catalog_offering property.
File share replication snapshots
When replication occurs between the source share and its replica, the system creates temporary snapshots in the .snapshot directory to support the data synchronization. These system-managed snapshots are named by using the word
"replication" and the associated creation timestamp rather than a fingerprint. These snapshots are automatically released and deleted when they are no longer needed. These snapshots are not visible in the console, in the CLI or
API responses.
File share snapshot directory visible property in API response
The property snapshot_directory_visible is included in the API response for the methods that are listing, creating, deleting, retrieving, or updating a file share. This field is not recommended for use, and it is planned to be
removed.
When a cross-regional replica is created, the displayed href value of the parent snapshot is incorrect
When you retrieve information about your cross-regional replica share, the source snapshot's href value is incorrect in the API response. Refer to the source snapshot ID or source snapshot CRN instead.
File share accessor_bindings missing in share API response
When creating, retrieving, listing, updating, or deleting file shares, accessor_bindings may be absent from the share API response.
File share more_info does not return URL of issue
When an error is reported while making share API requests, the more_info property does not return an error topic URL for the issue encountered. The more_info property returns information on how to resolve the issue
encountered instead.
Backup plan ID property in the API response
When details of a snapshot are retrieved, the API response shows the property name backup_plan_id instead of backup_policy_plan. A fix for this issue is planned.
Multi-volume backup creation requests create consistency group snapshots without second-generation volumes
Multi-volume snapshots are not supported for second-generation volumes. When you try to create a consistency group of snapshots of a mix of first and second-generation volumes, the API request appears successful as snapshots of Gen 1 volumes
are created. However, the Gen 2, sdp volumes are skipped.
The Bandwidth property of first-generation volumes profiles incorrectly displays dependent_range
When details of first-generation volume profiles are retrieved, the responses show the bandwidth type incorrectly as dependent_range. The correct value is dependent because the bandwidth value is automatically assigned
by the system, and that value can't be changed manually or programmatically.
Private context-based restriction rules for Backups are not working in Montreal (ca-mon) and Chennai (in-che) MZRs.
Enabling private CBR rules for backup operations that create and manage automated snapshots of block volumes and file shares in Montreal and Chennai is not supported.
Block volume snapshot is greater in the remote region than the original snapshot
The first time that you create a cross-regional copy, that snapshot is a full copy of the parent volume's data. Subsequent copies can be incremental or full copies. Whether the remote copy is incremental depends on the immediately preceding snapshot in the chain. If the immediately preceding snapshot exists in the destination region, the copy can be incremental. If the immediately preceding snapshot is not found or it's not stable in the remote region, a new full-copy is created. When a full remote copy is generated from an incremental snapshot, it creates a discrepancy in the billing.
Snapshot encryption in regional Object Storage in Chennai region
A local Key Protect instance is not available in Chennai. First-generation block volume snapshots that are taken in Chennai are routed to a regional Object Storage bucket that is encrypted by using a Key Protect instance from the London (eu-gb)
region temporarily. When the KMS service becomes available in Chennai, the snapshots service will switch to use the Chennai-based Key Protect instance for encryption, so both storage and key management are handled within the same region.
Cross-regional copy of block storage snapshots in Chennai
A cross-regional copy of block storage volume snapshots is not supported in the Chennai region. It can't be selected as a source or target region.
Networking known issues
Security Group and Network ACL rules support for any protocol including issues with older SDKs, CLIs and Terraform providers
Warning: Do NOT create a rule with a previously unsupported protocol value in your production environments until further notice. Creating a rule with these new protocol values anywhere in your VPC can break your
existing Kubernetes and OpenShift clusters. They can also break any other components that make security group or network ACL API requests via an SDK, or via a custom API client that does not handle these new protocol values properly. Work
is ongoing to resolve these issues. Until the known issues have been resolved, the UI and the current latest version of CLI will not allow rules with previously unsupported protocol values to be created.
When a security group or network ACL rule is created with a protocol value that was previously unsupported, there is an issue with old versions of some tools that use the API. The following tools may experience an error (crash)
when retrieving or listing rules with a previously unsupported protocol value:
- The IBM Cloud VPC Go SDK. For troubleshooting information, see the known issues.
- The
vpc-infrastructureplugin for the IBM Cloud CLI. To prevent errors, update to the latest version of thevpc-infrastructureplugin.
Security Group and Network ACL rules with ESP protocol issue
Network traffic with the ESP protocol is currently supported by instances with generation 2 profiles. Instances with newer generation profiles, and all bare metal servers, do not currently support ESP traffic.
Configuring a security group rule with a protocol value of esp or any will not allow ESP traffic when the security group targets a network interface for an instance with a newer generation profile or
a bare metal server.
To avoid confusion about where ESP traffic is supported, the ESP protocol is not shown in the IBM Cloud console options for security group and network ACL rules. Support for ESP traffic on newer generation instance profiles and on bare metal servers may be available in a future release.
Known Issues for vpc-go-sdk
Security Group rules and Network ACL rules backward compatibility issue
Publication date: 2025-12-18
Affected component: vpc-go-sdk
Affected operations: Security group rules and Network ACL rules
Issue Summary: Following the new support for all IPv4 protocols for ACL and Security Group rules, earlier versions of the Golang SDK must be updated to avoid the following parsing error when handling rules with the new protocols:
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
The patched SDKs implement the correct fallback behavior and error identifiers with the correct model name (for example, NetworkACLRule instead of NetworkACLRuleItem).
Migration and mitigation: To mitigate this issue, migrate the vpc-go-sdk to the latest version (v0.78.0) or any of the following patched versions:
v0.77, v0.76, v0.75, v0.74, v0.73, v0.72, v0.71, v0.70, v0.69, or v0.68.