acceleratorTypes3

addresses8

advice3

autoscalers8

backendBuckets14

backendServices17

crossSiteNetworks5

disks20

diskTypes3

externalVpnGateways6

firewallPolicies18

firewalls7

forwardingRules8

futureReservations7

globalAddresses7

globalForwardingRules7

globalFrontendSettings2

globalNetworkEndpointGroups7

globalOperations5

globalOrganizationOperations3

globalPublicDelegatedPrefixes5

globalVmExtensionPolicies6

healthChecks8

hosts3

httpHealthChecks7

httpsHealthChecks7

imageFamilyViews1

images11

imageViews2

instanceGroupManagerResizeRequests5

instanceGroupManagers24

instanceGroups10

instances51

instanceSettings2

instanceTemplates8

instantSnapshotGroups7

instantSnapshots9

interconnectAttachmentGroups9

interconnectAttachments7

interconnectGroups10

interconnectLocations2

interconnectRemoteLocations2

interconnects8

licenseCodes4

licenses8

machineImages8

machineTypes3

managedRulesets2

networkAttachments9

networkEdgeSecurityServices5

networkEndpointGroups9

networkFirewallPolicies21

networkProfiles2

networks13

nodeGroups15

nodeTemplates8

nodeTypes3

organizationSecurityPolicies16

packetMirrorings7

previewFeatures3

projects14

projectViews1

publicAdvertisedPrefixes7

publicDelegatedPrefixes8

regionAutoscalers7

regionBackendBuckets9

regionBackendServices12

regionCommitments5

regionCompositeHealthChecks8

regionDisks18

regionDiskTypes2

regionHealthAggregationPolicies7

regionHealthChecks7

regionHealthCheckServices7

regionHealthSources8

regionInstanceGroupManagerResizeRequests5

regionInstanceGroupManagers23

regionInstanceGroups5

regionInstances1

regionInstanceTemplates4

regionInstantSnapshotGroups7

regionInstantSnapshots8

regionNetworkEndpointGroups7

regionNetworkFirewallPolicies18

regionNotificationEndpoints6

regionOperations4

regions2

regionSecurityPolicies10

regionSnapshots9

regionSnapshotSettings2

regionSslCertificates4

regionSslPolicies6

regionTargetHttpProxies5

regionTargetHttpsProxies7

regionTargetTcpProxies4

regionUrlMaps7

regionZones1

reliabilityRisks2

reservationBlocks6

reservations11

reservationSlots5

reservationSubBlocks8

resourcePolicies9

rolloutPlans4

rollouts7

routers22

routes5

securityPolicies12

serviceAttachments9

snapshots9

snapshotSettings2

sslCertificates5

sslPolicies7

storagePools10

storagePoolTypes3

subnetworks12

targetGrpcProxies5

targetHttpProxies7

targetHttpsProxies11

targetInstances7

targetPools13

targetSslProxies10

targetTcpProxies8

targetVpnGateways6

urlMaps10

vpnGateways8

vpnTunnels6

wireGroups5

zoneOperations4

zones2

zoneVmExtensionPolicies5

instances

PATCH /projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface

Changed on Oct 30, 2026

Updates an instance's network interface. This method can only update an interface's alias IP range and attached network. See Modifying alias IP ranges for an existing instance for instructions on changing alias IP ranges. See Migrating a VM between networks for instructions on migrating an interface. This method follows PATCH semantics.

Request

Base URL
https://compute.googleapis.com/compute/v1
URL
https://compute.googleapis.com/compute/v1/projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface
Auth
- OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/cloud-platform
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/cloud-platform
- or OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/compute
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/compute

Path parameters

projectstring required

Project ID for this request.

zonestring required

The name of the zone for this request.

instancestring required

The instance name for this request.

Query parameters

networkInterfacestring required

The name of the network interface to update.

requestIdstring

An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.

For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Request body

enableVpcScopedDnsboolean

Optional. If true, DNS resolution will be enabled over this interface. Only valid with network_attachment.

fingerprintstring byte

Fingerprint hash of contents stored in this network interface. This field will be ignored when inserting an Instance or adding a NetworkInterface. An up-to-date fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.

igmpQuery'IGMP_QUERY_DISABLED' | 'IGMP_QUERY_V2'

Indicate whether igmp query is enabled on the network interface or not. If enabled, also indicates the version of IGMP supported.

internalIpv6PrefixLengthinteger

The prefix length of the primary internal IPv6 range.

ipv6AccessType'EXTERNAL' | 'INTERNAL'

Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be accessed from the Internet. This field is always inherited from its subnetwork.

Valid only if stackType is IPV4_IPV6.

ipv6Addressstring

An IPv6 internal network address for this network interface. To use a static internal IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an internal IPv6 address from the instance's subnetwork.

kindstring

Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.

namestring

[Output Only] The name of the network interface, which is generated by the server. For a VM, the network interface uses the nicN naming format. Where N is a value between 0 and7. The default interface value is nic0.

networkstring

URL of the VPC network resource for this instance. When creating an instance, if neither the network nor the subnetwork is specified, the default network global/networks/default is used. If the selected project doesn't have the default network, you must specify a network or subnet. If the network is not specified but the subnetwork is specified, the network is inferred.

If you specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs:

  - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
  - projects/project/global/networks/network
  - global/networks/default

networkAttachmentstring

The URL of the network attachment that this interface should connect to in the following format: projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.

networkIPstring

An IPv4 internal IP address to assign to the instance for this network interface. If not specified by the user, an unused internal IP is assigned by the system.

The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.

parentNicNamestring

Name of the parent network interface of a dynamic network interface.

queueCountinteger

The networking queue count that's specified by users for the network interface. Both Rx and Tx queues will be set to this number. It'll be empty if not specified by the users.

serviceClassIdstring

Optional. Producer Service's Service class Id for the region of this network interface. Can only be used with network_attachment. It is not possible to use on its own however, network_attachment can be used without service_class_id.

stackType'IPV4_IPV6' | 'IPV4_ONLY' | 'IPV6_ONLY'

The stack type for this network interface. To assign only IPv4 addresses, use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.

This field can be both set at instance creation and update network interface operations.

subnetworkstring

The URL of the Subnetwork resource for this instance. If the network resource is inlegacy mode, do not specify this field. If the network is in auto subnet mode, specifying the subnetwork is optional. If the network is in custom subnet mode, specifying the subnetwork is required. If you specify this field, you can specify the subnetwork as a full or partial URL. For example, the following are all valid URLs:

  - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork

regions/region/subnetworks/subnetwork

vlaninteger

VLAN tag of a dynamic network interface, must be an integer in the range from 2 to 255 inclusively.

Response

Successful response

clientOperationIdstring

[Output Only] The value of requestId if you provided it in the request. Not present otherwise.

creationTimestampstring

[Deprecated] This field is deprecated.

descriptionstring

[Output Only] A textual description of the operation, which is set when the operation is created.

endTimestring

[Output Only] The time that this operation was completed. This value is inRFC3339 text format.

httpErrorMessagestring

[Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.

httpErrorStatusCodeinteger

[Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.

idstring uint64

[Output Only] The unique identifier for the operation. This identifier is defined by the server.

insertTimestring

[Output Only] The time that this operation was requested. This value is inRFC3339 text format.

kindstring

Output only. [Output Only] Type of the resource. Always compute#operation for Operation resources.

namestring

[Output Only] Name of the operation.

operationGroupIdstring

Output only. [Output Only] An ID that represents a group of operations, such as when a group of operations results from a bulkInsert API request.

operationTypestring

[Output Only] The type of operation, such as insert, update, or delete, and so on.

progressinteger

[Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.

regionstring

[Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.

selfLinkstring

[Output Only] Server-defined URL for the resource.

startTimestring

[Output Only] The time that this operation was started by the server. This value is inRFC3339 text format.

status'DONE' | 'PENDING' | 'RUNNING'

[Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.

statusMessagestring

[Output Only] An optional textual description of the current status of the operation.

targetIdstring uint64

[Output Only] The unique target ID, which identifies a specific incarnation of the target resource.

targetLinkstring

[Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.

userstring

[Output Only] User who requested the operation, for example: user@example.com or alice_smith_identifier (global/workforcePools/example-com-us-employees).

zonestring

[Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.

Changes

Oct 30, 20268b85e897d3dc Revision changes
- info
  the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2
- info
  the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c
- info
  the security scope https://www.googleapis.com/auth/compute was removed from the endpoint's security scheme Oauth2
- info
  the security scope https://www.googleapis.com/auth/compute was removed from the endpoint's security scheme Oauth2c
Oct 23, 202648929bf89eeb Revision changes
- info
  the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2
- info
  the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c
- info
  the security scope https://www.googleapis.com/auth/compute was removed from the endpoint's security scheme Oauth2
- info
  the security scope https://www.googleapis.com/auth/compute was removed from the endpoint's security scheme Oauth2c

Operation history (4 revisions)