---
title: "PATCH /v1/{+name}"
method: PATCH
path: "/v1/{+name}"
tags: ["projects"]
---

# PATCH /v1/{+name}

`PATCH /v1/{+name}`

Updates a single Data Fusion instance.

## Path parameters

- `name` string, required

## Query parameters

- `updateMask` string

## Request body

- Instance — Represents a Data Fusion instance.
  - `createTime` string, google-datetime — Output only. The time the instance was created.
  - `maintenancePolicy` MaintenancePolicy — Maintenance policy of the instance.
    - `maintenanceWindow` MaintenanceWindow — Maintenance window of the instance.
      - `recurringTimeWindow` RecurringTimeWindow — Represents an arbitrary window of time that recurs.
        - `window` TimeWindow — Represents an arbitrary window of time.
          - `startTime` string, google-datetime — Required. The start time of the time window provided in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. Example: "2024-01-01T12:04:06-04:00"
          - `endTime` string, google-datetime — Required. The end time of the time window provided in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. The end time should take place after the start time. Example: "2024-01-02T12:04:06-06:00"
        - `recurrence` string — Required. An RRULE with format [RFC-5545](https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how this window reccurs. They go on for the span of time between the start and end time. The only supported FREQ value is "WEEKLY". To have something repeat every weekday, use: "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR". This specifies how frequently the window starts. To have a 9 am - 5 pm UTC-4 window every weekday, use something like: ``` start time = 2019-01-01T09:00:00-0400 end time = 2019-01-01T17:00:00-0400 recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR ```
    - `maintenanceExclusionWindow` TimeWindow — Represents an arbitrary window of time.
      - `startTime` string, google-datetime — Required. The start time of the time window provided in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. Example: "2024-01-01T12:04:06-04:00"
      - `endTime` string, google-datetime — Required. The end time of the time window provided in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. The end time should take place after the start time. Example: "2024-01-02T12:04:06-06:00"
  - `workforceIdentityServiceEndpoint` string — Output only. Endpoint on which the Data Fusion UI is accessible to third-party users
  - `name` string — Output only. The name of this instance is in the form of projects/{project}/locations/{location}/instances/{instance}.
  - `monitoringConfig` MonitoringConfig — Monitoring configuration for a Data Fusion instance.
    - `enableInstanceV2Metrics` boolean — Optional. Option to enable the instance v2 metrics for this instance. This field is supported only in CDF versions 6.11.1.1 and above.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'FAILED' | 'DELETING' | 'UPGRADING' | 'RESTARTING' | 'UPDATING' | 'AUTO_UPDATING' | 'AUTO_UPGRADING' | 'DISABLED' | 'ENABLING' — Output only. The current state of this Data Fusion instance.
  - `description` string — Optional. A description of this instance.
  - `zone` string — Optional. Name of the zone in which the Data Fusion instance will be created. Only DEVELOPER instances use this field.
  - `maintenanceEvents` MaintenanceEvent[] — Output only. The maintenance events for this instance.
    - `state` 'STATE_UNSPECIFIED' | 'SCHEDULED' | 'STARTED' | 'COMPLETED' — Output only. The state of the maintenance event.
    - `endTime` string, google-datetime — Output only. The end time of the maintenance event provided in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. Example: "2024-01-02T12:04:06-06:00" This field will be empty if the maintenance event is not yet complete.
    - `startTime` string, google-datetime — Output only. The start time of the maintenance event provided in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. Example: "2024-01-01T12:04:06-04:00"
  - `patchRevision` string — Optional. Current patch revision of the Data Fusion.
  - `loggingConfig` LoggingConfig — Logging configuration for a Data Fusion instance.
    - `enableInstanceV2Logs` boolean — Optional. Option to enable the InstanceV2 logging for this instance. This field is supported only in CDF patch revision versions 6.11.1.1 and above.
    - `instanceCloudLoggingDisabled` boolean — Optional. Option to determine whether instance logs should be written to Cloud Logging. By default, instance logs are written to Cloud Logging.
  - `tags` object — Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing"
  - `satisfiesPzi` boolean — Output only. Reserved for future use.
  - `gcsBucket` string — Output only. Cloud Storage bucket generated by Data Fusion in the customer project.
  - `serviceAccount` string — Output only. Deprecated. Use tenant_project_id instead to extract the tenant project ID.
  - `dataplexDataLineageIntegrationEnabled` boolean — Optional. Option to enable the Dataplex Lineage Integration feature.
  - `tenantProjectId` string — Output only. The name of the tenant project.
  - `cryptoKeyConfig` CryptoKeyConfig — The crypto key configuration. This field is used by the Customer-managed encryption keys (CMEK) feature.
    - `keyReference` string — Optional. The name of the key which is used to encrypt/decrypt customer data. For key in Cloud KMS, the key should be in the format of `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
  - `availableVersion` Version[] — Output only. Available versions that the instance can be upgraded to using UpdateInstanceRequest.
    - `versionNumber` string — The version number of the Data Fusion instance, such as '6.0.1.0'.
    - `availableFeatures` string[] — Represents a list of available feature names for a given version.
    - `defaultVersion` boolean — Whether this is currently the default version for Cloud Data Fusion
    - `type` 'TYPE_UNSPECIFIED' | 'TYPE_PREVIEW' | 'TYPE_GENERAL_AVAILABILITY' | 'TYPE_DEPRECATED' — Type represents the release availability of the version
  - `satisfiesPzs` boolean — Output only. Reserved for future use.
  - `enableStackdriverMonitoring` boolean — Optional. Option to enable Stackdriver Monitoring.
  - `enableRbac` boolean — Optional. Option to enable granular role-based access control.
  - `updateTime` string, google-datetime — Output only. The time the instance was last updated.
  - `stateMessage` string — Output only. Additional information about the current state of this Data Fusion instance if available.
  - `eventPublishConfig` EventPublishConfig — Confirguration of PubSubEventWriter.
    - `enabled` boolean — Required. Option to enable Event Publishing.
    - `topic` string — Required. The resource name of the Pub/Sub topic. Format: projects/{project_id}/topics/{topic_id}
  - `privateInstance` boolean — Optional. Specifies whether the Data Fusion instance should be private. If set to true, all Data Fusion nodes will have private IP addresses and will not be able to access the public internet.
  - `serviceEndpoint` string — Output only. Endpoint on which the Data Fusion UI is accessible.
  - `options` object — Optional. Map of additional options used to configure the behavior of Data Fusion instance.
  - `dataprocServiceAccount` string — Optional. User-managed service account to set on Dataproc when Cloud Data Fusion creates Dataproc to run data processing pipelines. This allows users to have fine-grained access control on Dataproc's accesses to cloud resources.
  - `type` 'TYPE_UNSPECIFIED' | 'BASIC' | 'ENTERPRISE' | 'DEVELOPER' — Required. Instance type.
  - `networkConfig` NetworkConfig — Network configuration for a Data Fusion instance. These configurations are used for peering with the customer network. Configurations are optional when a public Data Fusion instance is to be created. However, providing these configurations allows several benefits, such as reduced network latency while accessing the customer resources from managed Data Fusion instance nodes, as well as access to the customer on-prem resources.
    - `network` string — Optional. Name of the network in the customer project with which the Tenant Project will be peered for executing pipelines. In case of shared VPC where the network resides in another host project the network should specified in the form of projects/{host-project-id}/global/networks/{network}. This is only required for connectivity type VPC_PEERING.
    - `connectionType` 'CONNECTION_TYPE_UNSPECIFIED' | 'VPC_PEERING' | 'PRIVATE_SERVICE_CONNECT_INTERFACES' — Optional. Type of connection for establishing private IP connectivity between the Data Fusion customer project VPC and the corresponding tenant project from a predefined list of available connection modes. If this field is unspecified for a private instance, VPC peering is used.
    - `ipAllocation` string — Optional. The IP range in CIDR notation to use for the managed Data Fusion instance nodes. This range must not overlap with any other ranges used in the Data Fusion instance network. This is required only when using connection type VPC_PEERING. Format: a.b.c.d/22 Example: 192.168.0.0/22
    - `privateServiceConnectConfig` PrivateServiceConnectConfig — Configuration for using Private Service Connect to establish connectivity between the Data Fusion consumer project and the corresponding tenant project.
      - `effectiveUnreachableCidrBlock` string — Output only. The CIDR block to which the CDF instance can't route traffic to in the consumer project VPC. The size of this block is /25. The format of this field is governed by RFC 4632. Example: 240.0.0.0/25
      - `networkAttachment` string — Required. The reference to the network attachment used to establish private connectivity. It will be of the form projects/{project-id}/regions/{region}/networkAttachments/{network-attachment-id}.
      - `unreachableCidrBlock` string — Optional. Input only. The CIDR block to which the CDF instance can't route traffic to in the consumer project VPC. The size of this block should be at least /25. This range should not overlap with the primary address range of any subnetwork used by the network attachment. This range can be used for other purposes in the consumer VPC as long as there is no requirement for CDF to reach destinations using these addresses. If this value is not provided, the server chooses a non RFC 1918 address range. The format of this field is governed by RFC 4632. Example: 192.168.0.0/25
  - `labels` object — The resource labels for instance to use to annotate any related underlying resources such as Compute Engine VMs. The character '=' is not allowed to be used within the labels.
  - `enableZoneSeparation` boolean — Output only. Option to enable granular zone separation.
  - `enableStackdriverLogging` boolean — Optional. Option to enable Dataproc Stackdriver Logging.
  - `accelerators` Accelerator[] — Output only. List of accelerators enabled for this CDF instance.
    - `state` 'STATE_UNSPECIFIED' | 'ENABLED' | 'DISABLED' | 'UNKNOWN' — Output only. The state of the accelerator.
    - `acceleratorType` 'ACCELERATOR_TYPE_UNSPECIFIED' | 'CDC' | 'HEALTHCARE' | 'CCAI_INSIGHTS' | 'CLOUDSEARCH' — Optional. The type of an accelator for a Cloud Data Fusion instance.
  - `p4ServiceAccount` string — Output only. Service agent for the customer project.
  - `displayName` string — Optional. Display name for an instance.
  - `apiEndpoint` string — Output only. Endpoint on which the REST APIs is accessible.
  - `version` string — Optional. Current version of the Data Fusion. Only specifiable in Update.
  - `disabledReason` string[] — Output only. If the instance state is DISABLED, the reason for disabling the instance.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/datafusion.md) · [All operations](https://skmtc.dev/google/apis/datafusion/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/datafusion/revisions/c0785fabc6f4/schema)