feat(file): update the api

yoshi-automation · yoshi-automation · commit 0c890d872f0f · 2024-05-28T07:08:45.000Z
#### file:v1

The following keys were added:
- schemas.Instance.properties.replication.$ref (Total Keys: 1)
- schemas.ReplicaConfig (Total Keys: 11)
- schemas.Replication (Total Keys: 5)

#### file:v1beta1

The following keys were added:
- schemas.Instance.properties.replication.$ref (Total Keys: 1)
- schemas.ReplicaConfig (Total Keys: 8)
- schemas.Replication (Total Keys: 5)
diff --git a/docs/dyn/file_v1.projects.locations.instances.html b/docs/dyn/file_v1.projects.locations.instances.html
@@ -161,6 +161,19 @@ <h3>Method Details</h3>
       &quot;reservedIpRange&quot;: &quot;A String&quot;, # Optional, reserved_ip_range can have one of the following two types of values. * CIDR range value when using DIRECT_PEERING connect mode. * [Allocated IP address range](https://cloud.google.com/compute/docs/ip-addresses/reserve-static-internal-ip-address) when using PRIVATE_SERVICE_ACCESS connect mode. When the name of an allocated IP address range is specified, it must be one of the ranges associated with the private service access connection. When specified as a direct CIDR value, it must be a /29 CIDR block for Basic tier, a /24 CIDR block for High Scale tier, or a /26 CIDR block for Enterprise tier in one of the [internal IP address ranges](https://www.arin.net/reference/research/statistics/address_filters/) that identifies the range of IP addresses reserved for this instance. For example, 10.0.0.0/29, 192.168.0.0/24 or 192.168.0.0/26, respectively. The range you specify can&#x27;t overlap with either existing subnets or assigned IP address ranges for other Filestore instances in the selected VPC network.
     },
   ],
+  &quot;replication&quot;: { # Replication specifications. # Optional. Replicaition configuration.
+    &quot;replicas&quot;: [ # Optional. Replicas configuration on the instance. For now, only a single replica config is supported.
+      { # Replica configuration for the instance.
+        &quot;lastActiveSyncTime&quot;: &quot;A String&quot;, # Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.
+        &quot;peerInstance&quot;: &quot;A String&quot;, # Optional. The peer instance.
+        &quot;state&quot;: &quot;A String&quot;, # Output only. The replica state.
+        &quot;stateReasons&quot;: [ # Output only. Additional information about the replication state, if available.
+          &quot;A String&quot;,
+        ],
+      },
+    ],
+    &quot;role&quot;: &quot;A String&quot;, # Optional. The replication role.
+  },
   &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
   &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
   &quot;state&quot;: &quot;A String&quot;, # Output only. The instance state.
@@ -291,6 +304,19 @@ <h3>Method Details</h3>
       &quot;reservedIpRange&quot;: &quot;A String&quot;, # Optional, reserved_ip_range can have one of the following two types of values. * CIDR range value when using DIRECT_PEERING connect mode. * [Allocated IP address range](https://cloud.google.com/compute/docs/ip-addresses/reserve-static-internal-ip-address) when using PRIVATE_SERVICE_ACCESS connect mode. When the name of an allocated IP address range is specified, it must be one of the ranges associated with the private service access connection. When specified as a direct CIDR value, it must be a /29 CIDR block for Basic tier, a /24 CIDR block for High Scale tier, or a /26 CIDR block for Enterprise tier in one of the [internal IP address ranges](https://www.arin.net/reference/research/statistics/address_filters/) that identifies the range of IP addresses reserved for this instance. For example, 10.0.0.0/29, 192.168.0.0/24 or 192.168.0.0/26, respectively. The range you specify can&#x27;t overlap with either existing subnets or assigned IP address ranges for other Filestore instances in the selected VPC network.
     },
   ],
+  &quot;replication&quot;: { # Replication specifications. # Optional. Replicaition configuration.
+    &quot;replicas&quot;: [ # Optional. Replicas configuration on the instance. For now, only a single replica config is supported.
+      { # Replica configuration for the instance.
+        &quot;lastActiveSyncTime&quot;: &quot;A String&quot;, # Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.
+        &quot;peerInstance&quot;: &quot;A String&quot;, # Optional. The peer instance.
+        &quot;state&quot;: &quot;A String&quot;, # Output only. The replica state.
+        &quot;stateReasons&quot;: [ # Output only. Additional information about the replication state, if available.
+          &quot;A String&quot;,
+        ],
+      },
+    ],
+    &quot;role&quot;: &quot;A String&quot;, # Optional. The replication role.
+  },
   &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
   &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
   &quot;state&quot;: &quot;A String&quot;, # Output only. The instance state.
@@ -362,6 +388,19 @@ <h3>Method Details</h3>
           &quot;reservedIpRange&quot;: &quot;A String&quot;, # Optional, reserved_ip_range can have one of the following two types of values. * CIDR range value when using DIRECT_PEERING connect mode. * [Allocated IP address range](https://cloud.google.com/compute/docs/ip-addresses/reserve-static-internal-ip-address) when using PRIVATE_SERVICE_ACCESS connect mode. When the name of an allocated IP address range is specified, it must be one of the ranges associated with the private service access connection. When specified as a direct CIDR value, it must be a /29 CIDR block for Basic tier, a /24 CIDR block for High Scale tier, or a /26 CIDR block for Enterprise tier in one of the [internal IP address ranges](https://www.arin.net/reference/research/statistics/address_filters/) that identifies the range of IP addresses reserved for this instance. For example, 10.0.0.0/29, 192.168.0.0/24 or 192.168.0.0/26, respectively. The range you specify can&#x27;t overlap with either existing subnets or assigned IP address ranges for other Filestore instances in the selected VPC network.
         },
       ],
+      &quot;replication&quot;: { # Replication specifications. # Optional. Replicaition configuration.
+        &quot;replicas&quot;: [ # Optional. Replicas configuration on the instance. For now, only a single replica config is supported.
+          { # Replica configuration for the instance.
+            &quot;lastActiveSyncTime&quot;: &quot;A String&quot;, # Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.
+            &quot;peerInstance&quot;: &quot;A String&quot;, # Optional. The peer instance.
+            &quot;state&quot;: &quot;A String&quot;, # Output only. The replica state.
+            &quot;stateReasons&quot;: [ # Output only. Additional information about the replication state, if available.
+              &quot;A String&quot;,
+            ],
+          },
+        ],
+        &quot;role&quot;: &quot;A String&quot;, # Optional. The replication role.
+      },
       &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
       &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
       &quot;state&quot;: &quot;A String&quot;, # Output only. The instance state.
@@ -442,6 +481,19 @@ <h3>Method Details</h3>
       &quot;reservedIpRange&quot;: &quot;A String&quot;, # Optional, reserved_ip_range can have one of the following two types of values. * CIDR range value when using DIRECT_PEERING connect mode. * [Allocated IP address range](https://cloud.google.com/compute/docs/ip-addresses/reserve-static-internal-ip-address) when using PRIVATE_SERVICE_ACCESS connect mode. When the name of an allocated IP address range is specified, it must be one of the ranges associated with the private service access connection. When specified as a direct CIDR value, it must be a /29 CIDR block for Basic tier, a /24 CIDR block for High Scale tier, or a /26 CIDR block for Enterprise tier in one of the [internal IP address ranges](https://www.arin.net/reference/research/statistics/address_filters/) that identifies the range of IP addresses reserved for this instance. For example, 10.0.0.0/29, 192.168.0.0/24 or 192.168.0.0/26, respectively. The range you specify can&#x27;t overlap with either existing subnets or assigned IP address ranges for other Filestore instances in the selected VPC network.
     },
   ],
+  &quot;replication&quot;: { # Replication specifications. # Optional. Replicaition configuration.
+    &quot;replicas&quot;: [ # Optional. Replicas configuration on the instance. For now, only a single replica config is supported.
+      { # Replica configuration for the instance.
+        &quot;lastActiveSyncTime&quot;: &quot;A String&quot;, # Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.
+        &quot;peerInstance&quot;: &quot;A String&quot;, # Optional. The peer instance.
+        &quot;state&quot;: &quot;A String&quot;, # Output only. The replica state.
+        &quot;stateReasons&quot;: [ # Output only. Additional information about the replication state, if available.
+          &quot;A String&quot;,
+        ],
+      },
+    ],
+    &quot;role&quot;: &quot;A String&quot;, # Optional. The replication role.
+  },
   &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
   &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
   &quot;state&quot;: &quot;A String&quot;, # Output only. The instance state.
diff --git a/docs/dyn/file_v1beta1.projects.locations.instances.html b/docs/dyn/file_v1beta1.projects.locations.instances.html
@@ -184,6 +184,19 @@ <h3>Method Details</h3>
     },
   ],
   &quot;protocol&quot;: &quot;A String&quot;, # Immutable. The protocol indicates the access protocol for all shares in the instance. This field is immutable and it cannot be changed after the instance has been created. Default value: `NFS_V3`.
+  &quot;replication&quot;: { # Replication specifications. # Optional. Replicaition configuration.
+    &quot;replicas&quot;: [ # Replicas configuration on the instance. For now, only a single replica config is supported.
+      { # Replica configuration for the instance.
+        &quot;lastActiveSyncTime&quot;: &quot;A String&quot;, # Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.
+        &quot;peerInstance&quot;: &quot;A String&quot;, # The peer instance.
+        &quot;state&quot;: &quot;A String&quot;, # Output only. The replica state.
+        &quot;stateReasons&quot;: [ # Output only. Additional information about the replication state, if available.
+          &quot;A String&quot;,
+        ],
+      },
+    ],
+    &quot;role&quot;: &quot;A String&quot;, # Output only. The replication role.
+  },
   &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
   &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
   &quot;state&quot;: &quot;A String&quot;, # Output only. The instance state.
@@ -329,6 +342,19 @@ <h3>Method Details</h3>
     },
   ],
   &quot;protocol&quot;: &quot;A String&quot;, # Immutable. The protocol indicates the access protocol for all shares in the instance. This field is immutable and it cannot be changed after the instance has been created. Default value: `NFS_V3`.
+  &quot;replication&quot;: { # Replication specifications. # Optional. Replicaition configuration.
+    &quot;replicas&quot;: [ # Replicas configuration on the instance. For now, only a single replica config is supported.
+      { # Replica configuration for the instance.
+        &quot;lastActiveSyncTime&quot;: &quot;A String&quot;, # Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.
+        &quot;peerInstance&quot;: &quot;A String&quot;, # The peer instance.
+        &quot;state&quot;: &quot;A String&quot;, # Output only. The replica state.
+        &quot;stateReasons&quot;: [ # Output only. Additional information about the replication state, if available.
+          &quot;A String&quot;,
+        ],
+      },
+    ],
+    &quot;role&quot;: &quot;A String&quot;, # Output only. The replication role.
+  },
   &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
   &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
   &quot;state&quot;: &quot;A String&quot;, # Output only. The instance state.
@@ -415,6 +441,19 @@ <h3>Method Details</h3>
         },
       ],
       &quot;protocol&quot;: &quot;A String&quot;, # Immutable. The protocol indicates the access protocol for all shares in the instance. This field is immutable and it cannot be changed after the instance has been created. Default value: `NFS_V3`.
+      &quot;replication&quot;: { # Replication specifications. # Optional. Replicaition configuration.
+        &quot;replicas&quot;: [ # Replicas configuration on the instance. For now, only a single replica config is supported.
+          { # Replica configuration for the instance.
+            &quot;lastActiveSyncTime&quot;: &quot;A String&quot;, # Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.
+            &quot;peerInstance&quot;: &quot;A String&quot;, # The peer instance.
+            &quot;state&quot;: &quot;A String&quot;, # Output only. The replica state.
+            &quot;stateReasons&quot;: [ # Output only. Additional information about the replication state, if available.
+              &quot;A String&quot;,
+            ],
+          },
+        ],
+        &quot;role&quot;: &quot;A String&quot;, # Output only. The replication role.
+      },
       &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
       &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
       &quot;state&quot;: &quot;A String&quot;, # Output only. The instance state.
@@ -510,6 +549,19 @@ <h3>Method Details</h3>
     },
   ],
   &quot;protocol&quot;: &quot;A String&quot;, # Immutable. The protocol indicates the access protocol for all shares in the instance. This field is immutable and it cannot be changed after the instance has been created. Default value: `NFS_V3`.
+  &quot;replication&quot;: { # Replication specifications. # Optional. Replicaition configuration.
+    &quot;replicas&quot;: [ # Replicas configuration on the instance. For now, only a single replica config is supported.
+      { # Replica configuration for the instance.
+        &quot;lastActiveSyncTime&quot;: &quot;A String&quot;, # Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.
+        &quot;peerInstance&quot;: &quot;A String&quot;, # The peer instance.
+        &quot;state&quot;: &quot;A String&quot;, # Output only. The replica state.
+        &quot;stateReasons&quot;: [ # Output only. Additional information about the replication state, if available.
+          &quot;A String&quot;,
+        ],
+      },
+    ],
+    &quot;role&quot;: &quot;A String&quot;, # Output only. The replication role.
+  },
   &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
   &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
   &quot;state&quot;: &quot;A String&quot;, # Output only. The instance state.
diff --git a/googleapiclient/discovery_cache/documents/file.v1.json b/googleapiclient/discovery_cache/documents/file.v1.json
@@ -874,7 +874,7 @@
 }
 }
 },
-"revision": "20240307",
+"revision": "20240511",
 "rootUrl": "https://file.googleapis.com/",
 "schemas": {
 "Backup": {
@@ -1413,6 +1413,10 @@
 },
 "type": "array"
 },
+"replication": {
+"$ref": "Replication",
+"description": "Optional. Replicaition configuration."
+},
 "satisfiesPzi": {
 "description": "Output only. Reserved for future use.",
 "readOnly": true,
@@ -1890,6 +1894,86 @@
 },
 "type": "object"
 },
+"ReplicaConfig": {
+"description": "Replica configuration for the instance.",
+"id": "ReplicaConfig",
+"properties": {
+"lastActiveSyncTime": {
+"description": "Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"peerInstance": {
+"description": "Optional. The peer instance.",
+"type": "string"
+},
+"state": {
+"description": "Output only. The replica state.",
+"enum": [
+"STATE_UNSPECIFIED",
+"CREATING",
+"READY",
+"REMOVING",
+"FAILED"
+],
+"enumDescriptions": [
+"State not set.",
+"The replica is being created.",
+"The replica is ready.",
+"The replica is being removed.",
+"The replica is experiencing an issue and might be unusable. You can get further details from the `stateReasons` field of the `ReplicaConfig` object."
+],
+"readOnly": true,
+"type": "string"
+},
+"stateReasons": {
+"description": "Output only. Additional information about the replication state, if available.",
+"items": {
+"enum": [
+"STATE_REASON_UNSPECIFIED",
+"PEER_INSTANCE_UNREACHABLE"
+],
+"enumDescriptions": [
+"Reason not specified.",
+"The peer instance is unreachable."
+],
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+}
+},
+"type": "object"
+},
+"Replication": {
+"description": "Replication specifications.",
+"id": "Replication",
+"properties": {
+"replicas": {
+"description": "Optional. Replicas configuration on the instance. For now, only a single replica config is supported.",
+"items": {
+"$ref": "ReplicaConfig"
+},
+"type": "array"
+},
+"role": {
+"description": "Optional. The replication role.",
+"enum": [
+"ROLE_UNSPECIFIED",
+"ACTIVE",
+"STANDBY"
+],
+"enumDescriptions": [
+"Role not set.",
+"The instance is a Active replication member, functions as the replication source instance.",
+"The instance is a Standby replication member, functions as the replication destination instance."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "RestoreInstanceRequest": {
 "description": "RestoreInstanceRequest restores an existing instance's file share from a backup.",
 "id": "RestoreInstanceRequest",
diff --git a/googleapiclient/discovery_cache/documents/file.v1beta1.json b/googleapiclient/discovery_cache/documents/file.v1beta1.json
@@ -1069,7 +1069,7 @@
 }
 }
 },
-"revision": "20240307",
+"revision": "20240511",
 "rootUrl": "https://file.googleapis.com/",
 "schemas": {
 "Backup": {
@@ -1663,6 +1663,10 @@
 ],
 "type": "string"
 },
+"replication": {
+"$ref": "Replication",
+"description": "Optional. Replicaition configuration."
+},
 "satisfiesPzi": {
 "description": "Output only. Reserved for future use.",
 "readOnly": true,
@@ -2209,6 +2213,83 @@
 "properties": {},
 "type": "object"
 },
+"ReplicaConfig": {
+"description": "Replica configuration for the instance.",
+"id": "ReplicaConfig",
+"properties": {
+"lastActiveSyncTime": {
+"description": "Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely.",
+"format": "google-datetime",
+"type": "string"
+},
+"peerInstance": {
+"description": "The peer instance.",
+"type": "string"
+},
+"state": {
+"description": "Output only. The replica state.",
+"enum": [
+"STATE_UNSPECIFIED",
+"CREATING",
+"READY",
+"REMOVING",
+"FAILED"
+],
+"enumDescriptions": [
+"State not set.",
+"The replica is being created.",
+"The replica is ready.",
+"The replica is being removed.",
+"The replica is experiencing an issue and might be unusable. You can get further details from the `stateReasons` field of the `ReplicaConfig` object."
+],
+"type": "string"
+},
+"stateReasons": {
+"description": "Output only. Additional information about the replication state, if available.",
+"items": {
+"enum": [
+"STATE_REASON_UNSPECIFIED",
+"PEER_INSTANCE_UNREACHABLE"
+],
+"enumDescriptions": [
+"Reason not specified.",
+"The peer instance is unreachable."
+],
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"Replication": {
+"description": "Replication specifications.",
+"id": "Replication",
+"properties": {
+"replicas": {
+"description": "Replicas configuration on the instance. For now, only a single replica config is supported.",
+"items": {
+"$ref": "ReplicaConfig"
+},
+"type": "array"
+},
+"role": {
+"description": "Output only. The replication role.",
+"enum": [
+"ROLE_UNSPECIFIED",
+"ACTIVE",
+"STANDBY"
+],
+"enumDescriptions": [
+"Role not set.",
+"The instance is a Active replication member, functions as the replication source instance.",
+"The instance is a Standby replication member, functions as the replication destination instance."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "RestoreInstanceRequest": {
 "description": "RestoreInstanceRequest restores an existing instance's file share from a backup.",
 "id": "RestoreInstanceRequest",
