@maxim_mazurok/gapi.client.accesscontextmanager-v1 0.4.20260929 → 0.4.20261027

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/index.d.ts +81 -80
  2. package/package.json +1 -1
  3. package/readme.md +2 -2
package/index.d.ts CHANGED
@@ -9,7 +9,7 @@
9
9
  // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
10
10
  // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
11
11
  // Generated from: https://accesscontextmanager.googleapis.com/$discovery/rest?version=v1
12
- // Revision: 20260929
12
+ // Revision: 20261027
13
13
 
14
14
  /// <reference types="gapi.client" />
15
15
 
@@ -38,19 +38,19 @@ declare namespace gapi.client {
38
38
  description?: string;
39
39
  /** Identifier. Resource name for the `AccessLevel`. Format: `accessPolicies/{access_policy}/accessLevels/{access_level}`. The `access_level` component must begin with a letter, followed by alphanumeric characters or `_`. Its maximum length is 50 characters. After you create an `AccessLevel`, you cannot change its `name`. */
40
40
  name?: string;
41
- /** Human readable title. Must be unique within the Policy. */
41
+ /** Human-readable title. Must be unique within the policy. */
42
42
  title?: string;
43
43
  }
44
44
  interface AccessPolicy {
45
- /** Output only. An opaque identifier for the current version of the `AccessPolicy`. This will always be a strongly validated etag, meaning that two Access Policies will be identical if and only if their etags are identical. Clients should not expect this to be in any specific format. */
45
+ /** Output only. An opaque identifier for the current version of the `AccessPolicy`. This will always be a strongly validated etag, meaning that two access policies will be identical if and only if their etags are identical. Clients should not expect this to be in any specific format. */
46
46
  etag?: string;
47
47
  /** Output only. Identifier. Resource name of the `AccessPolicy`. Format: `accessPolicies/{access_policy}` */
48
48
  name?: string;
49
49
  /** Required. The parent of this `AccessPolicy` in the Cloud Resource Hierarchy. Currently immutable once created. Format: `organizations/{organization_id}` */
50
50
  parent?: string;
51
- /** The scopes of the AccessPolicy. Scopes define which resources a policy can restrict and where its resources can be referenced. For example, policy A with `scopes=["folders/123"]` has the following behavior: - ServicePerimeter can only restrict projects within `folders/123`. - ServicePerimeter within policy A can only reference access levels defined within policy A. - Only one policy can include a given scope; thus, attempting to create a second policy which includes `folders/123` will result in an error. If no scopes are provided, then any resource within the organization can be restricted. Scopes cannot be modified after a policy is created. Policies can only have a single scope. Format: list of `folders/{folder_number}` or `projects/{project_number}` */
51
+ /** The scopes of the AccessPolicy. Scopes define which resources a policy can restrict and where its resources can be referenced. For example, policy A with `scopes=["folders/123"]` has the following behavior: - ServicePerimeter can only restrict projects within `folders/123`. - ServicePerimeter within policy A can only reference access levels defined within policy A. - Only one policy can include a given scope; thus, attempting to create a second policy that includes `folders/123` will result in an error. If no scopes are provided, then any resource within the organization can be restricted. Scopes cannot be modified after a policy is created. Policies can only have a single scope. Format: list of `folders/{folder_number}` or `projects/{project_number}` */
52
52
  scopes?: string[];
53
- /** Required. Human readable title. Does not affect behavior. */
53
+ /** Required. Human-readable title. Does not affect behavior. */
54
54
  title?: string;
55
55
  }
56
56
  interface AccessScope {
@@ -58,9 +58,9 @@ declare namespace gapi.client {
58
58
  clientScope?: ClientScope;
59
59
  }
60
60
  interface AccessSettings {
61
- /** Optional. Access level that a user must have to be granted access. Only one access level is supported, not multiple. This repeated field must have exactly one element. Example: "accessPolicies/9522/accessLevels/device_trusted" */
61
+ /** Optional. Access level that a user must have to be granted access. Only one access level is supported, not multiple. This repeated field must have exactly one element. Example: `"accessPolicies/9522/accessLevels/device_trusted"` */
62
62
  accessLevels?: string[];
63
- /** Optional. Session settings applied to user access on a given AccessScope. */
63
+ /** Optional. Session settings applied to user access on a given `AccessScope`. */
64
64
  sessionSettings?: SessionSettings;
65
65
  }
66
66
  interface AddRequestHeader {
@@ -95,12 +95,12 @@ declare namespace gapi.client {
95
95
  'LOG_TYPE_UNSPECIFIED' | 'ADMIN_READ' | 'DATA_WRITE' | 'DATA_READ';
96
96
  }
97
97
  interface AuthorizedOrgsDesc {
98
- /** The asset type of this authorized orgs desc. Valid values are `ASSET_TYPE_DEVICE`, and `ASSET_TYPE_CREDENTIAL_STRENGTH`. */
98
+ /** The asset type of this authorized orgs desc. Valid values are `ASSET_TYPE_DEVICE` and `ASSET_TYPE_CREDENTIAL_STRENGTH`. */
99
99
  assetType?:
100
100
  | 'ASSET_TYPE_UNSPECIFIED'
101
101
  | 'ASSET_TYPE_DEVICE'
102
102
  | 'ASSET_TYPE_CREDENTIAL_STRENGTH';
103
- /** The direction of the authorization relationship between this organization and the organizations listed in the `orgs` field. The valid values for this field include the following: `AUTHORIZATION_DIRECTION_FROM`: Allows this organization to evaluate traffic in the organizations listed in the `orgs` field. `AUTHORIZATION_DIRECTION_TO`: Allows the organizations listed in the `orgs` field to evaluate the traffic in this organization. For the authorization relationship to take effect, all of the organizations must authorize and specify the appropriate relationship direction. For example, if organization A authorized organization B and C to evaluate its traffic, by specifying `AUTHORIZATION_DIRECTION_TO` as the authorization direction, organizations B and C must specify `AUTHORIZATION_DIRECTION_FROM` as the authorization direction in their `AuthorizedOrgsDesc` resource. */
103
+ /** The direction of the authorization relationship between this organization and the organizations listed in the `orgs` field. The valid values for this field include the following: `AUTHORIZATION_DIRECTION_FROM`: Allows this organization to evaluate traffic in the organizations listed in the `orgs` field. `AUTHORIZATION_DIRECTION_TO`: Allows the organizations listed in the `orgs` field to evaluate the traffic in this organization. For the authorization relationship to take effect, all of the organizations must authorize and specify the appropriate relationship direction. For example, if organization A authorizes organizations B and C to evaluate its traffic by specifying `AUTHORIZATION_DIRECTION_TO` as the authorization direction, organizations B and C must specify `AUTHORIZATION_DIRECTION_FROM` as the authorization direction in their `AuthorizedOrgsDesc` resource. */
104
104
  authorizationDirection?:
105
105
  | 'AUTHORIZATION_DIRECTION_UNSPECIFIED'
106
106
  | 'AUTHORIZATION_DIRECTION_TO'
@@ -110,11 +110,11 @@ declare namespace gapi.client {
110
110
  'AUTHORIZATION_TYPE_UNSPECIFIED' | 'AUTHORIZATION_TYPE_TRUST';
111
111
  /** Identifier. Resource name for the `AuthorizedOrgsDesc`. Format: `accessPolicies/{access_policy}/authorizedOrgsDescs/{authorized_orgs_desc}`. The `authorized_orgs_desc` component must begin with a letter, followed by alphanumeric characters or `_`. After you create an `AuthorizedOrgsDesc`, you cannot change its `name`. */
112
112
  name?: string;
113
- /** The list of organization ids in this AuthorizedOrgsDesc. Format: `organizations/` Example: `organizations/123456` */
113
+ /** The list of organization IDs in this `AuthorizedOrgsDesc`. Format: `organizations/{org_number}` Example: `organizations/123456` */
114
114
  orgs?: string[];
115
115
  }
116
116
  interface BasicLevel {
117
- /** How the `conditions` list should be combined to determine if a request is granted this `AccessLevel`. If AND is used, each `Condition` in `conditions` must be satisfied for the `AccessLevel` to be applied. If OR is used, at least one `Condition` in `conditions` must be satisfied for the `AccessLevel` to be applied. Default behavior is AND. */
117
+ /** How the `conditions` list should be combined to determine if a request is granted this `AccessLevel`. If `AND` is used, each `Condition` in `conditions` must be satisfied for the `AccessLevel` to be applied. If `OR` is used, at least one `Condition` in `conditions` must be satisfied for the `AccessLevel` to be applied. Default behavior is `AND`. */
118
118
  combiningFunction?: 'AND' | 'OR';
119
119
  /** Required. A list of requirements for the `AccessLevel` to be granted. */
120
120
  conditions?: Condition[];
@@ -143,17 +143,17 @@ declare namespace gapi.client {
143
143
  servicePerimeters?: ServicePerimeter[];
144
144
  }
145
145
  interface Condition {
146
- /** Device specific restrictions, all restrictions must hold for the Condition to be true. If not specified, all devices are allowed. */
146
+ /** Device-specific restrictions. All restrictions must hold for the `Condition` to be true. If not specified, all devices are allowed. */
147
147
  devicePolicy?: DevicePolicy;
148
- /** CIDR block IP subnetwork specification. May be IPv4 or IPv6. Note that for a CIDR IP address block, the specified IP address portion must be properly truncated (i.e. all the host bits must be zero) or the input is considered malformed. For example, "192.0.2.0/24" is accepted but "192.0.2.1/24" is not. Similarly, for IPv6, "2001:db8::/32" is accepted whereas "2001:db8::1/32" is not. The originating IP of a request must be in one of the listed subnets in order for this Condition to be true. If empty, all IP addresses are allowed. */
148
+ /** CIDR block IP subnetwork specification. May be IPv4 or IPv6. Note that for a CIDR IP address block, the specified IP address portion must be properly truncated (that is, all the host bits must be zero) or the input is considered malformed. For example, `"192.0.2.0/24"` is accepted, but `"192.0.2.1/24"` is not. Similarly, for IPv6, `"2001:db8::/32"` is accepted, whereas `"2001:db8::1/32"` is not. The originating IP of a request must be in one of the listed subnets in order for this `Condition` to be true. If empty, all IP addresses are allowed. */
149
149
  ipSubnetworks?: string[];
150
150
  /** The request must be made by one of the provided user or service accounts. Groups are not supported. Syntax: `user:{emailid}` `serviceAccount:{emailid}` If not specified, a request may come from any user. */
151
151
  members?: string[];
152
- /** Whether to negate the Condition. If true, the Condition becomes a NAND over its non-empty fields. Any non-empty field criteria evaluating to false will result in the Condition to be satisfied. Defaults to false. */
152
+ /** Whether to negate the `Condition`. If `true`, the `Condition` becomes a NAND over its non-empty fields. Any non-empty field criteria evaluating to `false` will result in the `Condition` being satisfied. Defaults to `false`. */
153
153
  negate?: boolean;
154
154
  /** The request must originate from one of the provided countries/regions. Must be valid ISO 3166-1 alpha-2 codes. */
155
155
  regions?: string[];
156
- /** A list of other access levels defined in the same `Policy`, referenced by resource name. Referencing an `AccessLevel` which does not exist is an error. All access levels listed must be granted for the Condition to be true. Example: "`accessPolicies/MY_POLICY/accessLevels/LEVEL_NAME"` */
156
+ /** A list of other access levels defined in the same `Policy`, referenced by resource name. Referencing an `AccessLevel` that does not exist is an error. All access levels listed must be granted for the `Condition` to be true. Example: `"accessPolicies/MY_POLICY/accessLevels/LEVEL_NAME"` */
157
157
  requiredAccessLevels?: string[];
158
158
  /** The request must originate from one of the provided VPC networks in Google Cloud. Cannot specify this field together with `ip_subnetworks`. */
159
159
  vpcNetworkSources?: VpcNetworkSource[];
@@ -163,22 +163,22 @@ declare namespace gapi.client {
163
163
  expr?: Expr;
164
164
  }
165
165
  interface DevicePolicy {
166
- /** Allowed device management levels, an empty list allows all management levels. */
166
+ /** Allowed device management levels. An empty list allows all management levels. */
167
167
  allowedDeviceManagementLevels?:
168
168
  'MANAGEMENT_UNSPECIFIED' | 'NONE' | 'BASIC' | 'COMPLETE'[];
169
- /** Allowed encryptions statuses, an empty list allows all statuses. */
169
+ /** Allowed encryption statuses. An empty list allows all statuses. */
170
170
  allowedEncryptionStatuses?:
171
171
  | 'ENCRYPTION_UNSPECIFIED'
172
172
  | 'ENCRYPTION_UNSUPPORTED'
173
173
  | 'UNENCRYPTED'
174
174
  | 'ENCRYPTED'[];
175
- /** Allowed OS versions, an empty list allows all types and all versions. */
175
+ /** Allowed OS versions. An empty list allows all types and all versions. */
176
176
  osConstraints?: OsConstraint[];
177
177
  /** Whether the device needs to be approved by the customer admin. */
178
178
  requireAdminApproval?: boolean;
179
- /** Whether the device needs to be corp owned. */
179
+ /** Whether the device needs to be corp-owned. */
180
180
  requireCorpOwned?: boolean;
181
- /** Whether or not screenlock is required for the DevicePolicy to be true. Defaults to `false`. */
181
+ /** Whether or not screenlock is required for the `DevicePolicy` to be true. Defaults to `false`. */
182
182
  requireScreenlock?: boolean;
183
183
  }
184
184
  interface EgressFrom {
@@ -190,7 +190,7 @@ declare namespace gapi.client {
190
190
  | 'ANY_IDENTITY'
191
191
  | 'ANY_USER_ACCOUNT'
192
192
  | 'ANY_SERVICE_ACCOUNT';
193
- /** Whether to enforce traffic restrictions based on `sources` field. If the `sources` fields is non-empty, then this field must be set to `SOURCE_RESTRICTION_ENABLED`. */
193
+ /** Whether to enforce traffic restrictions based on `sources` field. If the `sources` field is not empty, then this field must be set to `SOURCE_RESTRICTION_ENABLED`. */
194
194
  sourceRestriction?:
195
195
  | 'SOURCE_RESTRICTION_UNSPECIFIED'
196
196
  | 'SOURCE_RESTRICTION_ENABLED'
@@ -203,7 +203,7 @@ declare namespace gapi.client {
203
203
  egressFrom?: EgressFrom;
204
204
  /** Defines the conditions on the ApiOperation and destination resources that cause this EgressPolicy to apply. */
205
205
  egressTo?: EgressTo;
206
- /** Optional. Human-readable title for the egress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters. */
206
+ /** Optional. Human-readable title for the egress rule. The title must be unique within the perimeter and cannot exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters. */
207
207
  title?: string;
208
208
  }
209
209
  interface EgressSource {
@@ -211,17 +211,17 @@ declare namespace gapi.client {
211
211
  accessLevel?: string;
212
212
  /** A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in. */
213
213
  pscEndpoint?: PrivateServiceConnectEndpoint;
214
- /** A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources. */
214
+ /** A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`. You can't use `*` in this field to allow all Google Cloud resources. */
215
215
  resource?: string;
216
216
  }
217
217
  interface EgressTo {
218
- /** A list of external resources that are allowed to be accessed. Only AWS and Azure resources are supported. For Amazon S3, the supported formats are s3://BUCKET_NAME, s3a://BUCKET_NAME, and s3n://BUCKET_NAME. For Azure Storage, the supported format is azure://myaccount.blob.core.windows.net/CONTAINER_NAME. A request matches if it contains an external resource in this list (Example: s3://bucket/path). Currently '*' is not allowed. */
218
+ /** A list of external resources that are allowed to be accessed. Only AWS and Azure resources are supported. For Amazon S3, the supported formats are `s3://BUCKET_NAME`, `s3a://BUCKET_NAME`, and `s3n://BUCKET_NAME`. For Azure Storage, the supported format is `azure://myaccount.blob.core.windows.net/CONTAINER_NAME`. A request matches if it contains an external resource in this list (Example: `s3://bucket/path`). Currently `'*'` is not allowed. */
219
219
  externalResources?: string[];
220
220
  /** A list of ApiOperations allowed to be performed by the sources specified in the corresponding EgressFrom. A request matches if it uses an operation/service in this list. */
221
221
  operations?: ApiOperation[];
222
- /** A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter. */
222
+ /** A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter. */
223
223
  resources?: string[];
224
- /** IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter. */
224
+ /** IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom are allowed to perform in this ServicePerimeter. */
225
225
  roles?: string[];
226
226
  }
227
227
  interface Empty {}
@@ -236,13 +236,13 @@ declare namespace gapi.client {
236
236
  title?: string;
237
237
  }
238
238
  interface GcpUserAccessBinding {
239
- /** Optional. Access level that a user must have to be granted access. Only one access level is supported, not multiple. This repeated field must have exactly one element. Example: "accessPolicies/9522/accessLevels/device_trusted" */
239
+ /** Optional. Access level that a user must have to be granted access. Only one access level is supported, not multiple. This repeated field must have exactly one element. Example: `"accessPolicies/9522/accessLevels/device_trusted"` */
240
240
  accessLevels?: string[];
241
- /** Optional. Dry run access level that will be evaluated but will not be enforced. The access denial based on dry run policy will be logged. Only one access level is supported, not multiple. This list must have exactly one element. Example: "accessPolicies/9522/accessLevels/device_trusted" */
241
+ /** Optional. Dry-run access level that is evaluated, but not enforced. Any access denial based on the dry-run policy is logged. Only one access level is supported, not multiple. This list must have exactly one element. Example: `"accessPolicies/9522/accessLevels/device_trusted"` */
242
242
  dryRunAccessLevels?: string[];
243
- /** Optional. Immutable. Google Group id whose users are subject to this binding's restrictions. See "id" in the [Google Workspace Directory API's Group Resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: "01d520gv4vjcrht" */
243
+ /** Optional. Immutable. Google Group ID whose users are subject to this binding's restrictions. See "id" in the [Google Workspace Directory API's Group Resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address or alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: `"01d520gv4vjcrht"` */
244
244
  groupKey?: string;
245
- /** Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N" */
245
+ /** Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: `"organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"` */
246
246
  name?: string;
247
247
  /** Optional. Immutable. The principal that is subject to the access policies in this policy binding. */
248
248
  principal?: Principal;
@@ -277,21 +277,21 @@ declare namespace gapi.client {
277
277
  ingressFrom?: IngressFrom;
278
278
  /** Defines the conditions on the ApiOperation and request destination that cause this IngressPolicy to apply. */
279
279
  ingressTo?: IngressTo;
280
- /** Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters. */
280
+ /** Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and cannot exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters. */
281
281
  title?: string;
282
282
  }
283
283
  interface IngressSource {
284
- /** An AccessLevel resource name that allow resources within the ServicePerimeters to be accessed from the internet. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If no AccessLevel names are listed, resources within the perimeter can only be accessed via Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all IngressSources will be allowed. */
284
+ /** An AccessLevel resource name that allows resources within the ServicePerimeters to be accessed from the internet. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If no AccessLevel names are listed, resources within the perimeter can only be accessed via Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all IngressSources will be allowed. */
285
285
  accessLevel?: string;
286
286
  /** A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in. */
287
287
  pscEndpoint?: PrivateServiceConnectEndpoint;
288
- /** A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported. */
288
+ /** A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported. */
289
289
  resource?: string;
290
290
  }
291
291
  interface IngressTo {
292
292
  /** A list of ApiOperations allowed to be performed by the sources specified in corresponding IngressFrom in this ServicePerimeter. */
293
293
  operations?: ApiOperation[];
294
- /** A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed. */
294
+ /** A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter is allowed. */
295
295
  resources?: string[];
296
296
  /** IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter. */
297
297
  roles?: string[];
@@ -347,9 +347,9 @@ declare namespace gapi.client {
347
347
  supportedServices?: SupportedService[];
348
348
  }
349
349
  interface LookupConfiguredServicePerimeterResponse {
350
- /** The resource (e.g. "projects/123", "folders/456") that directly owns/is restricted by the enforced perimeter. */
350
+ /** The resource (for example, `projects/123` or `folders/456`) that directly owns or is restricted by the enforced perimeter. */
351
351
  restrictedResource?: string;
352
- /** The resource (e.g. "projects/123", "folders/456") that directly owns/is restricted by the dry-run perimeter. */
352
+ /** The resource (for example, `projects/123` or `folders/456`) that directly owns or is restricted by the dry-run perimeter. */
353
353
  restrictedResourceDryRun?: string;
354
354
  /** Fully qualified name of the configured enforced perimeter. Format: `accessPolicies/{policy_id}/servicePerimeters/{perimeter_name}` This field is empty if no enforced perimeter applies. */
355
355
  servicePerimeter?: string;
@@ -388,9 +388,10 @@ declare namespace gapi.client {
388
388
  | 'DESKTOP_WINDOWS'
389
389
  | 'DESKTOP_LINUX'
390
390
  | 'DESKTOP_CHROME_OS'
391
+ | 'GOOGLEBOOK_OS'
391
392
  | 'ANDROID'
392
393
  | 'IOS';
393
- /** Only allows requests from devices with a verified Chrome OS. Verifications includes requirements that the device is enterprise-managed, conformant to domain policies, and the caller has permission to call the API targeted by the request. */
394
+ /** Only allows requests from devices with a verified Chrome OS. Verification includes requirements that the device is enterprise-managed, conforms to domain policies, and the caller has permission to call the API targeted by the request. */
394
395
  requireVerifiedChromeOs?: boolean;
395
396
  }
396
397
  interface Policy {
@@ -406,7 +407,7 @@ declare namespace gapi.client {
406
407
  interface Principal {
407
408
  /** Immutable. The IAM principal identifier of the federated workforce or workload to assign the policy to. Examples include the following: * Single principal: `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}` * All workloads in a workload identity pool: `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*` * All Workforce Pools in a Google Cloud organization: `principalSet://cloudresourcemanager.googleapis.com/organizations/{organization_id}/type/WorkforcePool` Bindings created for all Workforce Pools in a Google Cloud organization support only `scoped_access_settings` with the `restricted_project` client scope and active `session_settings`. No other configurations are allowed. */
408
409
  federatedPrincipal?: string;
409
- /** Immutable. Service account email used to assign policies to a specific service account. If a service account is subject to multiple policies (e.g., if there is a policy for all service accounts in a project and a policy for the service account), the closest (i.e. the most specific) dry-run policy will be used for the dry-run functionality and the closest enforcement policy will be used for the enforcement. */
410
+ /** Immutable. Service account email used to assign policies to a specific service account. If a service account is subject to multiple policies (for example, if there is a policy for all service accounts in a project and a policy for the service account), the closest (that is, the most specific) dry-run policy is used for the dry-run functionality and the closest enforcement policy is used for enforcement. */
410
411
  serviceAccount?: string;
411
412
  /** Immutable. Cloud project number used to assign policies to all service accounts owned by the project. */
412
413
  serviceAccountProjectNumber?: string;
@@ -440,17 +441,17 @@ declare namespace gapi.client {
440
441
  servicePerimeters?: ServicePerimeter[];
441
442
  }
442
443
  interface ScopedAccessSettings {
443
- /** Optional. Access settings for this scoped access settings. This field may be empty if dry_run_settings is set. */
444
+ /** Optional. Access settings for this `ScopedAccessSettings`. This field may be empty if `dry_run_settings` is set. */
444
445
  activeSettings?: AccessSettings;
445
- /** Optional. Dry-run access settings for this scoped access settings. This field may be empty if active_settings is set. */
446
+ /** Optional. Dry-run access settings for this `ScopedAccessSettings`. This field may be empty if `active_settings` is set. */
446
447
  dryRunSettings?: AccessSettings;
447
- /** Optional. Application, etc. to which the access settings will be applied to. Implicitly, this is the scoped access settings key; as such, it must be unique and non-empty. */
448
+ /** Optional. Application or other resource to which the access settings are applied. Implicitly, this is the scoped access settings key; as such, it must be unique and non-empty. */
448
449
  scope?: AccessScope;
449
450
  }
450
451
  interface ServicePattern {
451
452
  /** Modifiers to apply to the requests that match the URL pattern. */
452
453
  modifiers?: Modifier[];
453
- /** URL pattern to allow. Only patterns of ".googleapis.com/*", "www.googleapis.com//*" and "*.appspot.com/* forms are supported, where should be an alphanumeric name. */
454
+ /** URL pattern to allow. Only patterns of `".googleapis.com/*"`, `"www.googleapis.com//*"`, and `"*.appspot.com/*"` forms are supported, where `` should be an alphanumeric name. */
454
455
  pattern?: string;
455
456
  /** Supported service to allow. */
456
457
  service?: string;
@@ -462,15 +463,15 @@ declare namespace gapi.client {
462
463
  etag?: string;
463
464
  /** Identifier. Resource name for the `ServicePerimeter`. Format: `accessPolicies/{access_policy}/servicePerimeters/{service_perimeter}`. The `service_perimeter` component must begin with a letter, followed by alphanumeric characters or `_`. After you create a `ServicePerimeter`, you cannot change its `name`. */
464
465
  name?: string;
465
- /** Perimeter type indicator. A single project or VPC network is allowed to be a member of single regular perimeter, but multiple service perimeter bridges. A project cannot be a included in a perimeter bridge without being included in regular perimeter. For perimeter bridges, the restricted service list as well as access level lists must be empty. */
466
+ /** Perimeter type indicator. A single project or VPC network is allowed to be a member of a single regular perimeter, but multiple service perimeter bridges. A project cannot be included in a perimeter bridge without being included in a regular perimeter. For perimeter bridges, the restricted service list as well as access level lists must be empty. */
466
467
  perimeterType?: 'PERIMETER_TYPE_REGULAR' | 'PERIMETER_TYPE_BRIDGE';
467
- /** Proposed (or dry run) ServicePerimeter configuration. This configuration allows to specify and test ServicePerimeter configuration without enforcing actual access restrictions. Only allowed to be set when the "use_explicit_dry_run_spec" flag is set. */
468
+ /** Proposed (or dry run) ServicePerimeter configuration. This configuration allows you to specify and test ServicePerimeter configuration without enforcing actual access restrictions. Only allowed to be set when the `use_explicit_dry_run_spec` flag is set. */
468
469
  spec?: ServicePerimeterConfig;
469
- /** Current ServicePerimeter configuration. Specifies sets of resources, restricted services and access levels that determine perimeter content and boundaries. */
470
+ /** Current ServicePerimeter configuration. Specifies sets of resources, restricted services, and access levels that determine perimeter content and boundaries. */
470
471
  status?: ServicePerimeterConfig;
471
472
  /** Human readable title. Must be unique within the Policy. */
472
473
  title?: string;
473
- /** Use explicit dry run spec flag. Ordinarily, a dry-run spec implicitly exists for all Service Perimeters, and that spec is identical to the status for those Service Perimeters. When this flag is set, it inhibits the generation of the implicit spec, thereby allowing the user to explicitly provide a configuration ("spec") to use in a dry-run version of the Service Perimeter. This allows the user to test changes to the enforced config ("status") without actually enforcing them. This testing is done through analyzing the differences between currently enforced and suggested restrictions. use_explicit_dry_run_spec must bet set to True if any of the fields in the spec are set to non-default values. */
474
+ /** Use explicit dry run spec flag. Ordinarily, a dry-run spec implicitly exists for all Service Perimeters, and that spec is identical to the status for those Service Perimeters. When this flag is set, it inhibits the generation of the implicit spec, thereby allowing the user to explicitly provide a configuration ("spec") to use in a dry-run version of the Service Perimeter. This allows the user to test changes to the enforced config ("status") without actually enforcing them. This testing is done through analyzing the differences between currently enforced and suggested restrictions. `use_explicit_dry_run_spec` must be set to `true` if any of the fields in the spec are set to non-default values. */
474
475
  useExplicitDryRunSpec?: boolean;
475
476
  }
476
477
  interface ServicePerimeterConfig {
@@ -480,7 +481,7 @@ declare namespace gapi.client {
480
481
  egressPolicies?: EgressPolicy[];
481
482
  /** List of IngressPolicies to apply to the perimeter. A perimeter may have multiple IngressPolicies, each of which is evaluated separately. Access is granted if any Ingress Policy grants it. Must be empty for a perimeter bridge. */
482
483
  ingressPolicies?: IngressPolicy[];
483
- /** A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. */
484
+ /** A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. */
484
485
  resources?: string[];
485
486
  /** Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions. */
486
487
  restrictedServices?: string[];
@@ -490,17 +491,17 @@ declare namespace gapi.client {
490
491
  interface SessionSettings {
491
492
  /** Optional. How long a user is allowed to take between actions before a new access token must be issued. Only set for Google Cloud apps. */
492
493
  maxInactivity?: string;
493
- /** Optional. The session length. Setting this field to zero allows for sessions that are active indefinitely. Also, setting `session_length_enabled` to `false` disregards session limits, which means that sessions never expire. If `use_oidc_max_age` is `true`, for OIDC apps, the session length will be the minimum of this field and the OIDC `max_age` param. If this field is set to zero, `session_length_enabled` must be set to `false` or left unset. */
494
+ /** Optional. The session length. Setting this field to zero allows for sessions that are active indefinitely. Also, setting `session_length_enabled` to `false` disregards session limits, which means that sessions never expire. If `use_oidc_max_age` is `true`, for OIDC apps, the session length will be the minimum of this field and the OIDC `max_age` parameter. If this field is set to zero, `session_length_enabled` must be set to `false` or left unset. */
494
495
  sessionLength?: string;
495
- /** Optional. This field enables or disables Google Cloud session length. When false, all fields set above will be disregarded and the session length is basically infinite. If `session_length` is set to zero, this field must be set to false. */
496
+ /** Optional. This field enables or disables Google Cloud session length. When `false`, all fields set above are disregarded and the session length is effectively infinite. If `session_length` is set to zero, this field must be set to `false`. */
496
497
  sessionLengthEnabled?: boolean;
497
- /** Optional. Session method when user's Google Cloud session is up. */
498
+ /** Optional. Session challenge method when a user's Google Cloud session expires. */
498
499
  sessionReauthMethod?:
499
500
  | 'SESSION_REAUTH_METHOD_UNSPECIFIED'
500
501
  | 'LOGIN'
501
502
  | 'SECURITY_KEY'
502
503
  | 'PASSWORD';
503
- /** Optional. Only useful for OIDC apps. When false, the OIDC max_age param, if passed in the authentication request will be ignored. When true, the re-auth period will be the minimum of the session_length field and the max_age OIDC param. */
504
+ /** Optional. Only useful for OIDC apps. When `false`, the OIDC `max_age` parameter, if passed in the authentication request, is ignored. When `true`, the re-authentication period is the minimum of the `session_length` field and the `max_age` OIDC parameter. */
504
505
  useOidcMaxAge?: boolean;
505
506
  }
506
507
  interface SetIamPolicyRequest {
@@ -527,7 +528,7 @@ declare namespace gapi.client {
527
528
  /** The support stage of the service. */
528
529
  serviceSupportStage?:
529
530
  'SERVICE_SUPPORT_STAGE_UNSPECIFIED' | 'GA' | 'PREVIEW' | 'DEPRECATED';
530
- /** The list of the supported methods. This field exists only in response to GetSupportedService */
531
+ /** The list of supported methods. This field exists only in response to GetSupportedService. */
531
532
  supportedMethods?: MethodSelector[];
532
533
  /** The support stage of the service. */
533
534
  supportStage?:
@@ -539,7 +540,7 @@ declare namespace gapi.client {
539
540
  | 'BETA'
540
541
  | 'GA'
541
542
  | 'DEPRECATED';
542
- /** The name of the supported product, such as 'Cloud Product API'. */
543
+ /** The name of the supported product, such as `'Cloud Product API'`. */
543
544
  title?: string;
544
545
  }
545
546
  interface TestIamPermissionsRequest {
@@ -553,9 +554,9 @@ declare namespace gapi.client {
553
554
  interface VpcAccessibleServices {
554
555
  /** Specifies which Google services are allowed to be accessed from VPC networks in the service perimeter. */
555
556
  allowedServicePatterns?: ServicePattern[];
556
- /** The list of APIs usable within the Service Perimeter. Must be empty unless 'enable_restriction' is True. You can specify a list of individual services, as well as include the 'RESTRICTED-SERVICES' value, which automatically includes all of the services protected by the perimeter. */
557
+ /** The list of APIs usable within the Service Perimeter. Must be empty unless `enable_restriction` is `true`. You can specify a list of individual services, as well as include the `'RESTRICTED-SERVICES'` value, which automatically includes all of the services protected by the perimeter. */
557
558
  allowedServices?: string[];
558
- /** Whether to restrict API calls within the Service Perimeter to the list of APIs specified in 'allowed_services'. */
559
+ /** Whether to restrict API calls within the Service Perimeter to the list of APIs specified in `allowed_services`. */
559
560
  enableRestriction?: boolean;
560
561
  /** Defines the enforcement scopes of service patterns. */
561
562
  servicePatternsEnforcementScopes?:
@@ -569,7 +570,7 @@ declare namespace gapi.client {
569
570
  interface VpcSubNetwork {
570
571
  /** Required. Network name. If the network is not part of the organization, the `compute.network.get` permission must be granted to the caller. Format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NETWORK_NAME}` Example: `//compute.googleapis.com/projects/my-project/global/networks/network-1` */
571
572
  network?: string;
572
- /** CIDR block IP subnetwork specification. The IP address must be an IPv4 address and can be a public or private IP address. Note that for a CIDR IP address block, the specified IP address portion must be properly truncated (i.e. all the host bits must be zero) or the input is considered malformed. For example, "192.0.2.0/24" is accepted but "192.0.2.1/24" is not. If empty, all IP addresses are allowed. */
573
+ /** CIDR block IP subnetwork specification. The IP address must be an IPv4 address and can be a public or private IP address. Note that for a CIDR IP address block, the specified IP address portion must be properly truncated (that is, all the host bits must be zero) or the input is considered malformed. For example, `"192.0.2.0/24"` is accepted, but `"192.0.2.1/24"` is not. If empty, all IP addresses are allowed. */
573
574
  vpcIpSubnetworks?: string[];
574
575
  }
575
576
  interface AccessLevelsResource {
@@ -664,7 +665,7 @@ declare namespace gapi.client {
664
665
  '$.xgafv'?: '1' | '2';
665
666
  /** OAuth access token. */
666
667
  access_token?: string;
667
- /** Whether to return `BasicLevels` in the Cloud Common Expression Language rather than as `BasicLevels`. Defaults to AS_DEFINED, where Access Levels are returned as `BasicLevels` or `CustomLevels` based on how they were created. If set to CEL, all Access Levels are returned as `CustomLevels`. In the CEL case, `BasicLevels` are translated to equivalent `CustomLevels`. */
668
+ /** Whether to return `BasicLevels` in the Cloud Common Expression Language rather than as `BasicLevels`. Defaults to `AS_DEFINED`, where Access Levels are returned as `BasicLevels` or `CustomLevels` based on how they were created. If set to `CEL`, all Access Levels are returned as `CustomLevels`. In the `CEL` case, `BasicLevels` are translated to equivalent `CustomLevels`. */
668
669
  accessLevelFormat?: 'LEVEL_FORMAT_UNSPECIFIED' | 'AS_DEFINED' | 'CEL';
669
670
  /** Data format for response. */
670
671
  alt?: 'json' | 'media' | 'proto';
@@ -693,7 +694,7 @@ declare namespace gapi.client {
693
694
  '$.xgafv'?: '1' | '2';
694
695
  /** OAuth access token. */
695
696
  access_token?: string;
696
- /** Whether to return `BasicLevels` in the Cloud Common Expression language, as `CustomLevels`, rather than as `BasicLevels`. Defaults to returning `AccessLevels` in the format they were defined. */
697
+ /** Whether to return `BasicLevels` in the Cloud Common Expression Language, as `CustomLevels`, rather than as `BasicLevels`. Defaults to returning `AccessLevels` in the format they were defined. */
697
698
  accessLevelFormat?: 'LEVEL_FORMAT_UNSPECIFIED' | 'AS_DEFINED' | 'CEL';
698
699
  /** Data format for response. */
699
700
  alt?: 'json' | 'media' | 'proto';
@@ -782,7 +783,7 @@ declare namespace gapi.client {
782
783
  },
783
784
  body: AccessLevel,
784
785
  ): Request<Operation>;
785
- /** Replaces all existing access levels in an access policy with the access levels provided. This is done atomically. The long-running operation from this RPC has a successful status after all replacements propagate to long-lasting storage. If the replacement contains errors, an error response is returned for the first error encountered. Upon error, the replacement is cancelled, and existing access levels are not affected. The Operation.response field contains ReplaceAccessLevelsResponse. Removing access levels contained in existing service perimeters result in an error. */
786
+ /** Replaces all existing access levels in an access policy with the access levels provided. This is done atomically. The long-running operation from this RPC has a successful status after all replacements propagate to long-lasting storage. If the replacement contains errors, an error response is returned for the first error encountered. Upon error, the replacement is cancelled, and existing access levels are not affected. The `Operation.response` field contains `ReplaceAccessLevelsResponse`. Removing access levels contained in existing service perimeters results in an error. */
786
787
  replaceAll(request: {
787
788
  /** V1 error format. */
788
789
  '$.xgafv'?: '1' | '2';
@@ -872,7 +873,7 @@ declare namespace gapi.client {
872
873
  ): Request<TestIamPermissionsResponse>;
873
874
  }
874
875
  interface AuthorizedOrgsDescsResource {
875
- /** Creates an authorized orgs desc. The long-running operation from this RPC has a successful status after the authorized orgs desc propagates to long-lasting storage. If a authorized orgs desc contains errors, an error response is returned for the first error encountered. The name of this `AuthorizedOrgsDesc` will be assigned during creation. */
876
+ /** Creates an authorized orgs desc. The long-running operation from this RPC has a successful status after the authorized orgs desc propagates to long-lasting storage. If an authorized orgs desc contains errors, an error response is returned for the first error encountered. The name of this `AuthorizedOrgsDesc` will be assigned during creation. */
876
877
  create(request: {
877
878
  /** V1 error format. */
878
879
  '$.xgafv'?: '1' | '2';
@@ -944,7 +945,7 @@ declare namespace gapi.client {
944
945
  fields?: string;
945
946
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
946
947
  key?: string;
947
- /** Required. Resource name for the Authorized Orgs Desc. Format: `accessPolicies/{policy_id}/authorizedOrgsDesc/{authorized_orgs_desc_id}` */
948
+ /** Required. Resource name for the Authorized Orgs Desc. Format: `accessPolicies/{policy_id}/authorizedOrgsDescs/{authorized_orgs_desc_id}` */
948
949
  name: string;
949
950
  /** OAuth 2.0 token for the current user. */
950
951
  oauth_token?: string;
@@ -971,7 +972,7 @@ declare namespace gapi.client {
971
972
  fields?: string;
972
973
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
973
974
  key?: string;
974
- /** Required. Resource name for the Authorized Orgs Desc. Format: `accessPolicies/{policy_id}/authorizedOrgsDescs/{authorized_orgs_descs_id}` */
975
+ /** Required. Resource name for the Authorized Orgs Desc. Format: `accessPolicies/{policy_id}/authorizedOrgsDescs/{authorized_orgs_desc_id}` */
975
976
  name: string;
976
977
  /** OAuth 2.0 token for the current user. */
977
978
  oauth_token?: string;
@@ -1015,7 +1016,7 @@ declare namespace gapi.client {
1015
1016
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
1016
1017
  uploadType?: string;
1017
1018
  }): Request<ListAuthorizedOrgsDescsResponse>;
1018
- /** Updates an authorized orgs desc. The long-running operation from this RPC has a successful status after the authorized orgs desc propagates to long-lasting storage. If a authorized orgs desc contains errors, an error response is returned for the first error encountered. Only the organization list in `AuthorizedOrgsDesc` can be updated. The name, authorization_type, asset_type and authorization_direction cannot be updated. */
1019
+ /** Updates an authorized orgs desc. The long-running operation from this RPC has a successful status after the authorized orgs desc propagates to long-lasting storage. If an authorized orgs desc contains errors, an error response is returned for the first error encountered. Only the organization list in `AuthorizedOrgsDesc` can be updated. The `name`, `authorization_type`, `asset_type`, and `authorization_direction` cannot be updated. */
1019
1020
  patch(request: {
1020
1021
  /** V1 error format. */
1021
1022
  '$.xgafv'?: '1' | '2';
@@ -1079,7 +1080,7 @@ declare namespace gapi.client {
1079
1080
  ): Request<Operation>;
1080
1081
  }
1081
1082
  interface ServicePerimetersResource {
1082
- /** Commits the dry-run specification for all the service perimeters in an access policy. A commit operation on a service perimeter involves copying its `spec` field to the `status` field of the service perimeter. Only service perimeters with `use_explicit_dry_run_spec` field set to true are affected by a commit operation. The long-running operation from this RPC has a successful status after the dry-run specifications for all the service perimeters have been committed. If a commit fails, it causes the long-running operation to return an error response and the entire commit operation is cancelled. When successful, the Operation.response field contains CommitServicePerimetersResponse. The `dry_run` and the `spec` fields are cleared after a successful commit operation. */
1083
+ /** Commits the dry-run specification for all the service perimeters in an access policy. A commit operation on a service perimeter involves copying its `spec` field to the `status` field of the service perimeter. Only service perimeters with `use_explicit_dry_run_spec` field set to true are affected by a commit operation. The long-running operation from this RPC has a successful status after the dry-run specifications for all the service perimeters have been committed. If a commit fails, it causes the long-running operation to return an error response and the entire commit operation is cancelled. When successful, the `Operation.response` field contains `CommitServicePerimetersResponse`. The `dry_run` and the `spec` fields are cleared after a successful commit operation. */
1083
1084
  commit(request: {
1084
1085
  /** V1 error format. */
1085
1086
  '$.xgafv'?: '1' | '2';
@@ -1241,7 +1242,7 @@ declare namespace gapi.client {
1241
1242
  fields?: string;
1242
1243
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
1243
1244
  key?: string;
1244
- /** Required. Resource name for the Service Perimeter. Format: `accessPolicies/{policy_id}/servicePerimeters/{service_perimeters_id}` */
1245
+ /** Required. Resource name for the Service Perimeter. Format: `accessPolicies/{policy_id}/servicePerimeters/{service_perimeter_id}` */
1245
1246
  name: string;
1246
1247
  /** OAuth 2.0 token for the current user. */
1247
1248
  oauth_token?: string;
@@ -1362,7 +1363,7 @@ declare namespace gapi.client {
1362
1363
  },
1363
1364
  body: ServicePerimeter,
1364
1365
  ): Request<Operation>;
1365
- /** Replace all existing service perimeters in an access policy with the service perimeters provided. This is done atomically. The long-running operation from this RPC has a successful status after all replacements propagate to long-lasting storage. Replacements containing errors result in an error response for the first error encountered. Upon an error, replacements are cancelled and existing service perimeters are not affected. The Operation.response field contains ReplaceServicePerimetersResponse. */
1366
+ /** Replaces all existing service perimeters in an access policy with the service perimeters provided. This is done atomically. The long-running operation from this RPC has a successful status after all replacements propagate to long-lasting storage. Replacements containing errors result in an error response for the first error encountered. Upon an error, replacements are cancelled and existing service perimeters are not affected. The `Operation.response` field contains `ReplaceServicePerimetersResponse`. */
1366
1367
  replaceAll(request: {
1367
1368
  /** V1 error format. */
1368
1369
  '$.xgafv'?: '1' | '2';
@@ -1520,7 +1521,7 @@ declare namespace gapi.client {
1520
1521
  fields?: string;
1521
1522
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
1522
1523
  key?: string;
1523
- /** Required. Resource name for the access policy to delete. Format `accessPolicies/{policy_id}` */
1524
+ /** Required. Resource name for the access policy to delete. Format: `accessPolicies/{policy_id}` */
1524
1525
  name: string;
1525
1526
  /** OAuth 2.0 token for the current user. */
1526
1527
  oauth_token?: string;
@@ -1547,7 +1548,7 @@ declare namespace gapi.client {
1547
1548
  fields?: string;
1548
1549
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
1549
1550
  key?: string;
1550
- /** Required. Resource name for the access policy to get. Format `accessPolicies/{policy_id}` */
1551
+ /** Required. Resource name for the access policy to get. Format: `accessPolicies/{policy_id}` */
1551
1552
  name: string;
1552
1553
  /** OAuth 2.0 token for the current user. */
1553
1554
  oauth_token?: string;
@@ -1748,7 +1749,7 @@ declare namespace gapi.client {
1748
1749
  servicePerimeters: ServicePerimetersResource;
1749
1750
  }
1750
1751
  interface FoldersResource {
1751
- /** Looks up the configured service perimeter for a given resource Format: ['projects/{projectNumber}', 'folders/{folderNumber}']. */
1752
+ /** Looks up the configured service perimeter for a given resource. Format: `['projects/{projectNumber}', 'folders/{folderNumber}']`. */
1752
1753
  lookupConfiguredServicePerimeter(request?: {
1753
1754
  /** V1 error format. */
1754
1755
  '$.xgafv'?: '1' | '2';
@@ -1768,7 +1769,7 @@ declare namespace gapi.client {
1768
1769
  prettyPrint?: boolean;
1769
1770
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
1770
1771
  quotaUser?: string;
1771
- /** Required. The Resource to resolve (e.g. "projects/123", "folders/456"). */
1772
+ /** Required. The resource to resolve (for example, `projects/123` or `folders/456`). */
1772
1773
  resource: string;
1773
1774
  /** Upload protocol for media (e.g. "raw", "multipart"). */
1774
1775
  upload_protocol?: string;
@@ -2050,7 +2051,7 @@ declare namespace gapi.client {
2050
2051
  callback?: string;
2051
2052
  /** Selector specifying which fields to include in a partial response. */
2052
2053
  fields?: string;
2053
- /** Optional. The literal filter to apply to the results returned. See https://google.aip.dev/160 for more details. Accepts values: * `principal:group_key` * `principal:service_account` OR `principal:service_account_project_number`. If this field is empty or not one of the above, the default value is `"principal:group_key"`. */
2054
+ /** Optional. Filters the results by principal type. Uses the [AIP-160](https://google.aip.dev/160) filter syntax. Only the following filters are supported: * `principal:group_key`: bindings for groups. This is the default when the filter is empty. * `principal:service_account OR principal:service_account_project_number`: bindings for service accounts. * `principal:federated_principal`: bindings for federated principals. Values can be in snake_case or camelCase. Whitespace and the order of `OR` terms don't matter. Any other filter returns an `INVALID_ARGUMENT` error. */
2054
2055
  filter?: string;
2055
2056
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
2056
2057
  key?: string;
@@ -2079,7 +2080,7 @@ declare namespace gapi.client {
2079
2080
  access_token?: string;
2080
2081
  /** Data format for response. */
2081
2082
  alt?: 'json' | 'media' | 'proto';
2082
- /** Optional. This field controls whether or not certain repeated settings in the update request overwrite or append to existing settings on the binding. If true, then append. Otherwise overwrite. So far, only scoped_access_settings with session_settings supports appending. Global access_levels, access_levels in scoped_access_settings, dry_run_access_levels, and session_settings are not compatible with append functionality, and the request will return an error if append=true when these settings are in the update_mask. The request will also return an error if append=true when "scoped_access_settings" is not set in the update_mask. */
2083
+ /** Optional. This field controls whether or not certain repeated settings in the update request overwrite or append to existing settings on the binding. If true, then append. Otherwise overwrite. So far, only `scoped_access_settings` with `session_settings` supports appending. Global `access_levels`, `access_levels` in `scoped_access_settings`, `dry_run_access_levels`, and `session_settings` are not compatible with append functionality, and the request will return an error if `append=true` when these settings are in the `update_mask`. The request will also return an error if `append=true` when `"scoped_access_settings"` is not set in the `update_mask`. */
2083
2084
  append?: boolean;
2084
2085
  /** JSONP */
2085
2086
  callback?: string;
@@ -2087,7 +2088,7 @@ declare namespace gapi.client {
2087
2088
  fields?: string;
2088
2089
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
2089
2090
  key?: string;
2090
- /** Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N" */
2091
+ /** Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: `"organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"` */
2091
2092
  name: string;
2092
2093
  /** OAuth 2.0 token for the current user. */
2093
2094
  oauth_token?: string;
@@ -2095,7 +2096,7 @@ declare namespace gapi.client {
2095
2096
  prettyPrint?: boolean;
2096
2097
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
2097
2098
  quotaUser?: string;
2098
- /** Required. Only the fields specified in this mask are updated. Because name and group_key cannot be changed, update_mask is required and may only contain the following fields: `access_levels`, `dry_run_access_levels`, `session_settings`, `scoped_access_settings`. update_mask { paths: "access_levels" } */
2099
+ /** Required. Only the fields specified in this mask are updated. Because `name` and `group_key` cannot be changed, `update_mask` is required and may only contain the following fields: `access_levels`, `dry_run_access_levels`, `session_settings`, `scoped_access_settings`. update_mask { paths: "access_levels" } */
2099
2100
  updateMask?: string;
2100
2101
  /** Upload protocol for media (e.g. "raw", "multipart"). */
2101
2102
  upload_protocol?: string;
@@ -2112,7 +2113,7 @@ declare namespace gapi.client {
2112
2113
  access_token?: string;
2113
2114
  /** Data format for response. */
2114
2115
  alt?: 'json' | 'media' | 'proto';
2115
- /** Optional. This field controls whether or not certain repeated settings in the update request overwrite or append to existing settings on the binding. If true, then append. Otherwise overwrite. So far, only scoped_access_settings with session_settings supports appending. Global access_levels, access_levels in scoped_access_settings, dry_run_access_levels, and session_settings are not compatible with append functionality, and the request will return an error if append=true when these settings are in the update_mask. The request will also return an error if append=true when "scoped_access_settings" is not set in the update_mask. */
2116
+ /** Optional. This field controls whether or not certain repeated settings in the update request overwrite or append to existing settings on the binding. If true, then append. Otherwise overwrite. So far, only `scoped_access_settings` with `session_settings` supports appending. Global `access_levels`, `access_levels` in `scoped_access_settings`, `dry_run_access_levels`, and `session_settings` are not compatible with append functionality, and the request will return an error if `append=true` when these settings are in the `update_mask`. The request will also return an error if `append=true` when `"scoped_access_settings"` is not set in the `update_mask`. */
2116
2117
  append?: boolean;
2117
2118
  /** JSONP */
2118
2119
  callback?: string;
@@ -2120,7 +2121,7 @@ declare namespace gapi.client {
2120
2121
  fields?: string;
2121
2122
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
2122
2123
  key?: string;
2123
- /** Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N" */
2124
+ /** Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: `"organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"` */
2124
2125
  name: string;
2125
2126
  /** OAuth 2.0 token for the current user. */
2126
2127
  oauth_token?: string;
@@ -2128,7 +2129,7 @@ declare namespace gapi.client {
2128
2129
  prettyPrint?: boolean;
2129
2130
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
2130
2131
  quotaUser?: string;
2131
- /** Required. Only the fields specified in this mask are updated. Because name and group_key cannot be changed, update_mask is required and may only contain the following fields: `access_levels`, `dry_run_access_levels`, `session_settings`, `scoped_access_settings`. update_mask { paths: "access_levels" } */
2132
+ /** Required. Only the fields specified in this mask are updated. Because `name` and `group_key` cannot be changed, `update_mask` is required and may only contain the following fields: `access_levels`, `dry_run_access_levels`, `session_settings`, `scoped_access_settings`. update_mask { paths: "access_levels" } */
2132
2133
  updateMask?: string;
2133
2134
  /** Upload protocol for media (e.g. "raw", "multipart"). */
2134
2135
  upload_protocol?: string;
@@ -2158,7 +2159,7 @@ declare namespace gapi.client {
2158
2159
  key?: string;
2159
2160
  /** OAuth 2.0 token for the current user. */
2160
2161
  oauth_token?: string;
2161
- /** Optional. This flag specifies the maximum number of services to return per page. Default value is 100. */
2162
+ /** Optional. This flag specifies the maximum number of permissions to return per page. Default value is 100. */
2162
2163
  pageSize?: number;
2163
2164
  /** Optional. Use this token to retrieve a specific page of results. Default is the first page. */
2164
2165
  pageToken?: string;
@@ -2173,7 +2174,7 @@ declare namespace gapi.client {
2173
2174
  }): Request<ListSupportedPermissionsResponse>;
2174
2175
  }
2175
2176
  interface ProjectsResource {
2176
- /** Looks up the configured service perimeter for a given resource Format: ['projects/{projectNumber}', 'folders/{folderNumber}']. */
2177
+ /** Looks up the configured service perimeter for a given resource. Format: `['projects/{projectNumber}', 'folders/{folderNumber}']`. */
2177
2178
  lookupConfiguredServicePerimeter(request?: {
2178
2179
  /** V1 error format. */
2179
2180
  '$.xgafv'?: '1' | '2';
@@ -2193,7 +2194,7 @@ declare namespace gapi.client {
2193
2194
  prettyPrint?: boolean;
2194
2195
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
2195
2196
  quotaUser?: string;
2196
- /** Required. The Resource to resolve (e.g. "projects/123", "folders/456"). */
2197
+ /** Required. The resource to resolve (for example, `projects/123` or `folders/456`). */
2197
2198
  resource: string;
2198
2199
  /** Upload protocol for media (e.g. "raw", "multipart"). */
2199
2200
  upload_protocol?: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@maxim_mazurok/gapi.client.accesscontextmanager-v1",
3
- "version": "0.4.20260929",
3
+ "version": "0.4.20261027",
4
4
  "description": "TypeScript typings for Access Context Manager API v1",
5
5
  "repository": {
6
6
  "type": "git",
package/readme.md CHANGED
@@ -133,7 +133,7 @@ await gapi.client.accesscontextmanager.accessPolicies.testIamPermissions({
133
133
  });
134
134
 
135
135
  /*
136
- Looks up the configured service perimeter for a given resource Format: ['projects/{projectNumber}', 'folders/{folderNumber}'].
136
+ Looks up the configured service perimeter for a given resource. Format: `['projects/{projectNumber}', 'folders/{folderNumber}']`.
137
137
  */
138
138
  await gapi.client.accesscontextmanager.folders.lookupConfiguredServicePerimeter(
139
139
  {resource: 'resource'},
@@ -165,7 +165,7 @@ Lists all supported permissions in VPC Service Controls ingress and egress rules
165
165
  await gapi.client.accesscontextmanager.permissions.list({});
166
166
 
167
167
  /*
168
- Looks up the configured service perimeter for a given resource Format: ['projects/{projectNumber}', 'folders/{folderNumber}'].
168
+ Looks up the configured service perimeter for a given resource. Format: `['projects/{projectNumber}', 'folders/{folderNumber}']`.
169
169
  */
170
170
  await gapi.client.accesscontextmanager.projects.lookupConfiguredServicePerimeter(
171
171
  {resource: 'resource'},