feat(file): update the api

yoshi-automation · yoshi-automation · commit 33cc60f6da2e · 2025-11-04T07:10:14.000Z
#### file:v1

The following keys were added:
- resources.projects.resources.locations.resources.operations.methods.list.parameters.returnPartialSuccess (Total Keys: 2)
- schemas.DirectoryServicesConfig (Total Keys: 3)
- schemas.Instance.properties.directoryServices.$ref (Total Keys: 1)
- schemas.LdapConfig (Total Keys: 7)
- schemas.ListOperationsResponse.properties.unreachable (Total Keys: 2)

#### file:v1beta1

The following keys were added:
- resources.projects.resources.locations.resources.operations.methods.list.parameters.returnPartialSuccess (Total Keys: 2)
- schemas.ListOperationsResponse.properties.unreachable (Total Keys: 2)
diff --git a/docs/dyn/file_v1.projects.locations.instances.html b/docs/dyn/file_v1.projects.locations.instances.html
@@ -131,6 +131,16 @@ <h3>Method Details</h3>
   &quot;deletionProtectionEnabled&quot;: True or False, # Optional. Indicates whether the instance is protected against deletion.
   &quot;deletionProtectionReason&quot;: &quot;A String&quot;, # Optional. The reason for enabling deletion protection.
   &quot;description&quot;: &quot;A String&quot;, # The description of the instance (2048 characters or less).
+  &quot;directoryServices&quot;: { # Directory Services configuration for Kerberos-based authentication. # Optional. Directory Services configuration for Kerberos-based authentication. Should only be set if protocol is &quot;NFS_V4_1&quot;.
+    &quot;ldap&quot;: { # LdapConfig contains all the parameters for connecting to LDAP servers. # Configuration for LDAP servers.
+      &quot;domain&quot;: &quot;A String&quot;, # Required. The LDAP domain name in the format of `my-domain.com`.
+      &quot;groupsOu&quot;: &quot;A String&quot;, # Optional. The groups Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.
+      &quot;servers&quot;: [ # Required. The servers names are used for specifying the LDAP servers names. The LDAP servers names can come with two formats: 1. DNS name, for example: `ldap.example1.com`, `ldap.example2.com`. 2. IP address, for example: `10.0.0.1`, `10.0.0.2`, `10.0.0.3`. All servers names must be in the same format: either all DNS names or all IP addresses.
+        &quot;A String&quot;,
+      ],
+      &quot;usersOu&quot;: &quot;A String&quot;, # Optional. The users Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.
+    },
+  },
   &quot;etag&quot;: &quot;A String&quot;, # Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
   &quot;fileShares&quot;: [ # File system shares on the instance. For this version, only a single file share is supported.
     { # File share configuration for the instance.
@@ -305,6 +315,16 @@ <h3>Method Details</h3>
   &quot;deletionProtectionEnabled&quot;: True or False, # Optional. Indicates whether the instance is protected against deletion.
   &quot;deletionProtectionReason&quot;: &quot;A String&quot;, # Optional. The reason for enabling deletion protection.
   &quot;description&quot;: &quot;A String&quot;, # The description of the instance (2048 characters or less).
+  &quot;directoryServices&quot;: { # Directory Services configuration for Kerberos-based authentication. # Optional. Directory Services configuration for Kerberos-based authentication. Should only be set if protocol is &quot;NFS_V4_1&quot;.
+    &quot;ldap&quot;: { # LdapConfig contains all the parameters for connecting to LDAP servers. # Configuration for LDAP servers.
+      &quot;domain&quot;: &quot;A String&quot;, # Required. The LDAP domain name in the format of `my-domain.com`.
+      &quot;groupsOu&quot;: &quot;A String&quot;, # Optional. The groups Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.
+      &quot;servers&quot;: [ # Required. The servers names are used for specifying the LDAP servers names. The LDAP servers names can come with two formats: 1. DNS name, for example: `ldap.example1.com`, `ldap.example2.com`. 2. IP address, for example: `10.0.0.1`, `10.0.0.2`, `10.0.0.3`. All servers names must be in the same format: either all DNS names or all IP addresses.
+        &quot;A String&quot;,
+      ],
+      &quot;usersOu&quot;: &quot;A String&quot;, # Optional. The users Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.
+    },
+  },
   &quot;etag&quot;: &quot;A String&quot;, # Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
   &quot;fileShares&quot;: [ # File system shares on the instance. For this version, only a single file share is supported.
     { # File share configuration for the instance.
@@ -420,6 +440,16 @@ <h3>Method Details</h3>
       &quot;deletionProtectionEnabled&quot;: True or False, # Optional. Indicates whether the instance is protected against deletion.
       &quot;deletionProtectionReason&quot;: &quot;A String&quot;, # Optional. The reason for enabling deletion protection.
       &quot;description&quot;: &quot;A String&quot;, # The description of the instance (2048 characters or less).
+      &quot;directoryServices&quot;: { # Directory Services configuration for Kerberos-based authentication. # Optional. Directory Services configuration for Kerberos-based authentication. Should only be set if protocol is &quot;NFS_V4_1&quot;.
+        &quot;ldap&quot;: { # LdapConfig contains all the parameters for connecting to LDAP servers. # Configuration for LDAP servers.
+          &quot;domain&quot;: &quot;A String&quot;, # Required. The LDAP domain name in the format of `my-domain.com`.
+          &quot;groupsOu&quot;: &quot;A String&quot;, # Optional. The groups Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.
+          &quot;servers&quot;: [ # Required. The servers names are used for specifying the LDAP servers names. The LDAP servers names can come with two formats: 1. DNS name, for example: `ldap.example1.com`, `ldap.example2.com`. 2. IP address, for example: `10.0.0.1`, `10.0.0.2`, `10.0.0.3`. All servers names must be in the same format: either all DNS names or all IP addresses.
+            &quot;A String&quot;,
+          ],
+          &quot;usersOu&quot;: &quot;A String&quot;, # Optional. The users Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.
+        },
+      },
       &quot;etag&quot;: &quot;A String&quot;, # Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
       &quot;fileShares&quot;: [ # File system shares on the instance. For this version, only a single file share is supported.
         { # File share configuration for the instance.
@@ -544,6 +574,16 @@ <h3>Method Details</h3>
   &quot;deletionProtectionEnabled&quot;: True or False, # Optional. Indicates whether the instance is protected against deletion.
   &quot;deletionProtectionReason&quot;: &quot;A String&quot;, # Optional. The reason for enabling deletion protection.
   &quot;description&quot;: &quot;A String&quot;, # The description of the instance (2048 characters or less).
+  &quot;directoryServices&quot;: { # Directory Services configuration for Kerberos-based authentication. # Optional. Directory Services configuration for Kerberos-based authentication. Should only be set if protocol is &quot;NFS_V4_1&quot;.
+    &quot;ldap&quot;: { # LdapConfig contains all the parameters for connecting to LDAP servers. # Configuration for LDAP servers.
+      &quot;domain&quot;: &quot;A String&quot;, # Required. The LDAP domain name in the format of `my-domain.com`.
+      &quot;groupsOu&quot;: &quot;A String&quot;, # Optional. The groups Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.
+      &quot;servers&quot;: [ # Required. The servers names are used for specifying the LDAP servers names. The LDAP servers names can come with two formats: 1. DNS name, for example: `ldap.example1.com`, `ldap.example2.com`. 2. IP address, for example: `10.0.0.1`, `10.0.0.2`, `10.0.0.3`. All servers names must be in the same format: either all DNS names or all IP addresses.
+        &quot;A String&quot;,
+      ],
+      &quot;usersOu&quot;: &quot;A String&quot;, # Optional. The users Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.
+    },
+  },
   &quot;etag&quot;: &quot;A String&quot;, # Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
   &quot;fileShares&quot;: [ # File system shares on the instance. For this version, only a single file share is supported.
     { # File share configuration for the instance.
diff --git a/docs/dyn/file_v1.projects.locations.operations.html b/docs/dyn/file_v1.projects.locations.operations.html
@@ -87,7 +87,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.</p>
 <p class="toc_element">
-  <code><a href="#list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next()</a></code></p>
@@ -176,14 +176,15 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
   <pre>Lists operations that match the specified filter in the request. If the server doesn&#x27;t support this method, it returns `UNIMPLEMENTED`.
 
 Args:
   name: string, The name of the operation&#x27;s parent resource. (required)
   filter: string, The standard list filter.
   pageSize: integer, The standard list page size.
   pageToken: string, The standard list page token.
+  returnPartialSuccess: boolean, When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `&quot;projects/example/locations/-&quot;`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -215,6 +216,9 @@ <h3>Method Details</h3>
       },
     },
   ],
+  &quot;unreachable&quot;: [ # Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.
+    &quot;A String&quot;,
+  ],
 }</pre>
 </div>
 
diff --git a/docs/dyn/file_v1beta1.projects.locations.operations.html b/docs/dyn/file_v1beta1.projects.locations.operations.html
@@ -87,7 +87,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.</p>
 <p class="toc_element">
-  <code><a href="#list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next()</a></code></p>
@@ -176,14 +176,15 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
   <pre>Lists operations that match the specified filter in the request. If the server doesn&#x27;t support this method, it returns `UNIMPLEMENTED`.
 
 Args:
   name: string, The name of the operation&#x27;s parent resource. (required)
   filter: string, The standard list filter.
   pageSize: integer, The standard list page size.
   pageToken: string, The standard list page token.
+  returnPartialSuccess: boolean, When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `&quot;projects/example/locations/-&quot;`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -215,6 +216,9 @@ <h3>Method Details</h3>
       },
     },
   ],
+  &quot;unreachable&quot;: [ # Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.
+    &quot;A String&quot;,
+  ],
 }</pre>
 </div>
 
diff --git a/googleapiclient/discovery_cache/documents/file.v1.json b/googleapiclient/discovery_cache/documents/file.v1.json
@@ -891,6 +891,11 @@
 "description": "The standard list page token.",
 "location": "query",
 "type": "string"
+},
+"returnPartialSuccess": {
+"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
+"location": "query",
+"type": "boolean"
 }
 },
 "path": "v1/{+name}/operations",
@@ -908,7 +913,7 @@
 }
 }
 },
-"revision": "20250929",
+"revision": "20251015",
 "rootUrl": "https://file.googleapis.com/",
 "schemas": {
 "Backup": {
@@ -1113,6 +1118,17 @@
 },
 "type": "object"
 },
+"DirectoryServicesConfig": {
+"description": "Directory Services configuration for Kerberos-based authentication.",
+"id": "DirectoryServicesConfig",
+"properties": {
+"ldap": {
+"$ref": "LdapConfig",
+"description": "Configuration for LDAP servers."
+}
+},
+"type": "object"
+},
 "Empty": {
 "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }",
 "id": "Empty",
@@ -1486,6 +1502,10 @@
 "description": "The description of the instance (2048 characters or less).",
 "type": "string"
 },
+"directoryServices": {
+"$ref": "DirectoryServicesConfig",
+"description": "Optional. Directory Services configuration for Kerberos-based authentication. Should only be set if protocol is \"NFS_V4_1\"."
+},
 "etag": {
 "description": "Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.",
 "type": "string"
@@ -1659,6 +1679,32 @@
 },
 "type": "object"
 },
+"LdapConfig": {
+"description": "LdapConfig contains all the parameters for connecting to LDAP servers.",
+"id": "LdapConfig",
+"properties": {
+"domain": {
+"description": "Required. The LDAP domain name in the format of `my-domain.com`.",
+"type": "string"
+},
+"groupsOu": {
+"description": "Optional. The groups Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.",
+"type": "string"
+},
+"servers": {
+"description": "Required. The servers names are used for specifying the LDAP servers names. The LDAP servers names can come with two formats: 1. DNS name, for example: `ldap.example1.com`, `ldap.example2.com`. 2. IP address, for example: `10.0.0.1`, `10.0.0.2`, `10.0.0.3`. All servers names must be in the same format: either all DNS names or all IP addresses.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"usersOu": {
+"description": "Optional. The users Organizational Unit (OU) is optional. This parameter is a hint to allow faster lookup in the LDAP namespace. In case that this parameter is not provided, Filestore instance will query the whole LDAP namespace.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "ListBackupsResponse": {
 "description": "ListBackupsResponse is the result of ListBackupsRequest.",
 "id": "ListBackupsResponse",
@@ -1741,6 +1787,13 @@
 "$ref": "Operation"
 },
 "type": "array"
+},
+"unreachable": {
+"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.",
+"items": {
+"type": "string"
+},
+"type": "array"
 }
 },
 "type": "object"
diff --git a/googleapiclient/discovery_cache/documents/file.v1beta1.json b/googleapiclient/discovery_cache/documents/file.v1beta1.json
@@ -1114,6 +1114,11 @@
 "description": "The standard list page token.",
 "location": "query",
 "type": "string"
+},
+"returnPartialSuccess": {
+"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
+"location": "query",
+"type": "boolean"
 }
 },
 "path": "v1beta1/{+name}/operations",
@@ -1131,7 +1136,7 @@
 }
 }
 },
-"revision": "20250929",
+"revision": "20251015",
 "rootUrl": "https://file.googleapis.com/",
 "schemas": {
 "Backup": {
@@ -2037,6 +2042,13 @@
 "$ref": "Operation"
 },
 "type": "array"
+},
+"unreachable": {
+"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.",
+"items": {
+"type": "string"
+},
+"type": "array"
 }
 },
 "type": "object"
