@maxim_mazurok/gapi.client.accesscontextmanager-v1 0.4.20261011 → 0.4.20261108

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 +80 -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: 20261011
12
+ // Revision: 20261108
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 projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. 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 projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, 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,11 +277,11 @@ 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;
@@ -291,7 +291,7 @@ declare namespace gapi.client {
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 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 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,13 +347,13 @@ 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
- /** Fully qualified name of the configured enforced perimeter. Format: `accessPolicies/{policy_id}/servicePerimeters/{perimeter_name}` This field is empty if no enforced perimeter applies. */
354
+ /** Fully qualified name of the configured enforced perimeter. This field is empty if no enforced perimeter applies. Format: `accessPolicies/{policy_id}/servicePerimeters/{perimeter_name}` */
355
355
  servicePerimeter?: string;
356
- /** Fully qualified name of the configured dry-run perimeter. Format: `accessPolicies/{policy_id}/servicePerimeters/{perimeter_name}` This field is empty if no dry-run perimeter configuration applies. */
356
+ /** Fully qualified name of the configured dry-run perimeter. This field is empty if no dry-run perimeter configuration applies. Format: `accessPolicies/{policy_id}/servicePerimeters/{perimeter_name}` */
357
357
  servicePerimeterDryRun?: string;
358
358
  }
359
359
  interface MethodSelector {
@@ -391,7 +391,7 @@ declare namespace gapi.client {
391
391
  | 'GOOGLEBOOK_OS'
392
392
  | 'ANDROID'
393
393
  | 'IOS';
394
- /** 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. */
395
395
  requireVerifiedChromeOs?: boolean;
396
396
  }
397
397
  interface Policy {
@@ -407,7 +407,7 @@ declare namespace gapi.client {
407
407
  interface Principal {
408
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. */
409
409
  federatedPrincipal?: string;
410
- /** 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. */
411
411
  serviceAccount?: string;
412
412
  /** Immutable. Cloud project number used to assign policies to all service accounts owned by the project. */
413
413
  serviceAccountProjectNumber?: string;
@@ -441,17 +441,17 @@ declare namespace gapi.client {
441
441
  servicePerimeters?: ServicePerimeter[];
442
442
  }
443
443
  interface ScopedAccessSettings {
444
- /** 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. */
445
445
  activeSettings?: AccessSettings;
446
- /** 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. */
447
447
  dryRunSettings?: AccessSettings;
448
- /** 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. */
449
449
  scope?: AccessScope;
450
450
  }
451
451
  interface ServicePattern {
452
452
  /** Modifiers to apply to the requests that match the URL pattern. */
453
453
  modifiers?: Modifier[];
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
+ /** URL pattern to allow. Only patterns of `".googleapis.com/*"`, `"www.googleapis.com//*"`, and `"*.appspot.com/*"` forms are supported, where `` should be an alphanumeric name. */
455
455
  pattern?: string;
456
456
  /** Supported service to allow. */
457
457
  service?: string;
@@ -463,15 +463,15 @@ declare namespace gapi.client {
463
463
  etag?: string;
464
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`. */
465
465
  name?: string;
466
- /** 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. */
467
467
  perimeterType?: 'PERIMETER_TYPE_REGULAR' | 'PERIMETER_TYPE_BRIDGE';
468
- /** 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. */
469
469
  spec?: ServicePerimeterConfig;
470
- /** 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. */
471
471
  status?: ServicePerimeterConfig;
472
472
  /** Human readable title. Must be unique within the Policy. */
473
473
  title?: string;
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 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. */
475
475
  useExplicitDryRunSpec?: boolean;
476
476
  }
477
477
  interface ServicePerimeterConfig {
@@ -491,17 +491,17 @@ declare namespace gapi.client {
491
491
  interface SessionSettings {
492
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. */
493
493
  maxInactivity?: string;
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` 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. */
495
495
  sessionLength?: string;
496
- /** 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`. */
497
497
  sessionLengthEnabled?: boolean;
498
- /** Optional. Session method when user's Google Cloud session is up. */
498
+ /** Optional. Session challenge method when a user's Google Cloud session expires. */
499
499
  sessionReauthMethod?:
500
500
  | 'SESSION_REAUTH_METHOD_UNSPECIFIED'
501
501
  | 'LOGIN'
502
502
  | 'SECURITY_KEY'
503
503
  | 'PASSWORD';
504
- /** 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. */
505
505
  useOidcMaxAge?: boolean;
506
506
  }
507
507
  interface SetIamPolicyRequest {
@@ -528,7 +528,7 @@ declare namespace gapi.client {
528
528
  /** The support stage of the service. */
529
529
  serviceSupportStage?:
530
530
  'SERVICE_SUPPORT_STAGE_UNSPECIFIED' | 'GA' | 'PREVIEW' | 'DEPRECATED';
531
- /** 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. */
532
532
  supportedMethods?: MethodSelector[];
533
533
  /** The support stage of the service. */
534
534
  supportStage?:
@@ -540,7 +540,7 @@ declare namespace gapi.client {
540
540
  | 'BETA'
541
541
  | 'GA'
542
542
  | 'DEPRECATED';
543
- /** The name of the supported product, such as 'Cloud Product API'. */
543
+ /** The name of the supported product, such as `'Cloud Product API'`. */
544
544
  title?: string;
545
545
  }
546
546
  interface TestIamPermissionsRequest {
@@ -554,9 +554,9 @@ declare namespace gapi.client {
554
554
  interface VpcAccessibleServices {
555
555
  /** Specifies which Google services are allowed to be accessed from VPC networks in the service perimeter. */
556
556
  allowedServicePatterns?: ServicePattern[];
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
+ /** 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. */
558
558
  allowedServices?: string[];
559
- /** 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`. */
560
560
  enableRestriction?: boolean;
561
561
  /** Defines the enforcement scopes of service patterns. */
562
562
  servicePatternsEnforcementScopes?:
@@ -570,7 +570,7 @@ declare namespace gapi.client {
570
570
  interface VpcSubNetwork {
571
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` */
572
572
  network?: string;
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 (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. */
574
574
  vpcIpSubnetworks?: string[];
575
575
  }
576
576
  interface AccessLevelsResource {
@@ -665,7 +665,7 @@ declare namespace gapi.client {
665
665
  '$.xgafv'?: '1' | '2';
666
666
  /** OAuth access token. */
667
667
  access_token?: string;
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
+ /** 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`. */
669
669
  accessLevelFormat?: 'LEVEL_FORMAT_UNSPECIFIED' | 'AS_DEFINED' | 'CEL';
670
670
  /** Data format for response. */
671
671
  alt?: 'json' | 'media' | 'proto';
@@ -694,7 +694,7 @@ declare namespace gapi.client {
694
694
  '$.xgafv'?: '1' | '2';
695
695
  /** OAuth access token. */
696
696
  access_token?: string;
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
+ /** 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. */
698
698
  accessLevelFormat?: 'LEVEL_FORMAT_UNSPECIFIED' | 'AS_DEFINED' | 'CEL';
699
699
  /** Data format for response. */
700
700
  alt?: 'json' | 'media' | 'proto';
@@ -783,7 +783,7 @@ declare namespace gapi.client {
783
783
  },
784
784
  body: AccessLevel,
785
785
  ): Request<Operation>;
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 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. */
787
787
  replaceAll(request: {
788
788
  /** V1 error format. */
789
789
  '$.xgafv'?: '1' | '2';
@@ -873,7 +873,7 @@ declare namespace gapi.client {
873
873
  ): Request<TestIamPermissionsResponse>;
874
874
  }
875
875
  interface AuthorizedOrgsDescsResource {
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 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. */
877
877
  create(request: {
878
878
  /** V1 error format. */
879
879
  '$.xgafv'?: '1' | '2';
@@ -945,7 +945,7 @@ declare namespace gapi.client {
945
945
  fields?: string;
946
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. */
947
947
  key?: string;
948
- /** 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}` */
949
949
  name: string;
950
950
  /** OAuth 2.0 token for the current user. */
951
951
  oauth_token?: string;
@@ -972,7 +972,7 @@ declare namespace gapi.client {
972
972
  fields?: string;
973
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. */
974
974
  key?: string;
975
- /** 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}` */
976
976
  name: string;
977
977
  /** OAuth 2.0 token for the current user. */
978
978
  oauth_token?: string;
@@ -1016,7 +1016,7 @@ declare namespace gapi.client {
1016
1016
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
1017
1017
  uploadType?: string;
1018
1018
  }): Request<ListAuthorizedOrgsDescsResponse>;
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 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. */
1020
1020
  patch(request: {
1021
1021
  /** V1 error format. */
1022
1022
  '$.xgafv'?: '1' | '2';
@@ -1080,7 +1080,7 @@ declare namespace gapi.client {
1080
1080
  ): Request<Operation>;
1081
1081
  }
1082
1082
  interface ServicePerimetersResource {
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
+ /** 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. */
1084
1084
  commit(request: {
1085
1085
  /** V1 error format. */
1086
1086
  '$.xgafv'?: '1' | '2';
@@ -1242,7 +1242,7 @@ declare namespace gapi.client {
1242
1242
  fields?: string;
1243
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. */
1244
1244
  key?: string;
1245
- /** 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}` */
1246
1246
  name: string;
1247
1247
  /** OAuth 2.0 token for the current user. */
1248
1248
  oauth_token?: string;
@@ -1363,7 +1363,7 @@ declare namespace gapi.client {
1363
1363
  },
1364
1364
  body: ServicePerimeter,
1365
1365
  ): Request<Operation>;
1366
- /** 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`. */
1367
1367
  replaceAll(request: {
1368
1368
  /** V1 error format. */
1369
1369
  '$.xgafv'?: '1' | '2';
@@ -1521,7 +1521,7 @@ declare namespace gapi.client {
1521
1521
  fields?: string;
1522
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. */
1523
1523
  key?: string;
1524
- /** 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}` */
1525
1525
  name: string;
1526
1526
  /** OAuth 2.0 token for the current user. */
1527
1527
  oauth_token?: string;
@@ -1548,7 +1548,7 @@ declare namespace gapi.client {
1548
1548
  fields?: string;
1549
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. */
1550
1550
  key?: string;
1551
- /** 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}` */
1552
1552
  name: string;
1553
1553
  /** OAuth 2.0 token for the current user. */
1554
1554
  oauth_token?: string;
@@ -1749,7 +1749,7 @@ declare namespace gapi.client {
1749
1749
  servicePerimeters: ServicePerimetersResource;
1750
1750
  }
1751
1751
  interface FoldersResource {
1752
- /** Looks up the configured service perimeter for a given resource Format: ['projects/{projectNumber}', 'folders/{folderNumber}']. */
1752
+ /** Looks up the configured ServicePerimeter for a given resource. */
1753
1753
  lookupConfiguredServicePerimeter(request?: {
1754
1754
  /** V1 error format. */
1755
1755
  '$.xgafv'?: '1' | '2';
@@ -1769,7 +1769,7 @@ declare namespace gapi.client {
1769
1769
  prettyPrint?: boolean;
1770
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. */
1771
1771
  quotaUser?: string;
1772
- /** Required. The Resource to resolve (e.g. "projects/123", "folders/456"). */
1772
+ /** Required. The resource name. Format: `projects/{project_number}` or `folders/{folder_number}` (for example, `projects/123` or `folders/456`) */
1773
1773
  resource: string;
1774
1774
  /** Upload protocol for media (e.g. "raw", "multipart"). */
1775
1775
  upload_protocol?: string;
@@ -2051,7 +2051,7 @@ declare namespace gapi.client {
2051
2051
  callback?: string;
2052
2052
  /** Selector specifying which fields to include in a partial response. */
2053
2053
  fields?: string;
2054
- /** 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. */
2055
2055
  filter?: string;
2056
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. */
2057
2057
  key?: string;
@@ -2080,7 +2080,7 @@ declare namespace gapi.client {
2080
2080
  access_token?: string;
2081
2081
  /** Data format for response. */
2082
2082
  alt?: 'json' | 'media' | 'proto';
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
+ /** 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`. */
2084
2084
  append?: boolean;
2085
2085
  /** JSONP */
2086
2086
  callback?: string;
@@ -2088,7 +2088,7 @@ declare namespace gapi.client {
2088
2088
  fields?: string;
2089
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. */
2090
2090
  key?: string;
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
+ /** 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"` */
2092
2092
  name: string;
2093
2093
  /** OAuth 2.0 token for the current user. */
2094
2094
  oauth_token?: string;
@@ -2096,7 +2096,7 @@ declare namespace gapi.client {
2096
2096
  prettyPrint?: boolean;
2097
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. */
2098
2098
  quotaUser?: string;
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
+ /** 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" } */
2100
2100
  updateMask?: string;
2101
2101
  /** Upload protocol for media (e.g. "raw", "multipart"). */
2102
2102
  upload_protocol?: string;
@@ -2113,7 +2113,7 @@ declare namespace gapi.client {
2113
2113
  access_token?: string;
2114
2114
  /** Data format for response. */
2115
2115
  alt?: 'json' | 'media' | 'proto';
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
+ /** 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`. */
2117
2117
  append?: boolean;
2118
2118
  /** JSONP */
2119
2119
  callback?: string;
@@ -2121,7 +2121,7 @@ declare namespace gapi.client {
2121
2121
  fields?: string;
2122
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. */
2123
2123
  key?: string;
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
+ /** 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"` */
2125
2125
  name: string;
2126
2126
  /** OAuth 2.0 token for the current user. */
2127
2127
  oauth_token?: string;
@@ -2129,7 +2129,7 @@ declare namespace gapi.client {
2129
2129
  prettyPrint?: boolean;
2130
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. */
2131
2131
  quotaUser?: string;
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
+ /** 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" } */
2133
2133
  updateMask?: string;
2134
2134
  /** Upload protocol for media (e.g. "raw", "multipart"). */
2135
2135
  upload_protocol?: string;
@@ -2159,7 +2159,7 @@ declare namespace gapi.client {
2159
2159
  key?: string;
2160
2160
  /** OAuth 2.0 token for the current user. */
2161
2161
  oauth_token?: string;
2162
- /** 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. */
2163
2163
  pageSize?: number;
2164
2164
  /** Optional. Use this token to retrieve a specific page of results. Default is the first page. */
2165
2165
  pageToken?: string;
@@ -2174,7 +2174,7 @@ declare namespace gapi.client {
2174
2174
  }): Request<ListSupportedPermissionsResponse>;
2175
2175
  }
2176
2176
  interface ProjectsResource {
2177
- /** Looks up the configured service perimeter for a given resource Format: ['projects/{projectNumber}', 'folders/{folderNumber}']. */
2177
+ /** Looks up the configured ServicePerimeter for a given resource. */
2178
2178
  lookupConfiguredServicePerimeter(request?: {
2179
2179
  /** V1 error format. */
2180
2180
  '$.xgafv'?: '1' | '2';
@@ -2194,7 +2194,7 @@ declare namespace gapi.client {
2194
2194
  prettyPrint?: boolean;
2195
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. */
2196
2196
  quotaUser?: string;
2197
- /** Required. The Resource to resolve (e.g. "projects/123", "folders/456"). */
2197
+ /** Required. The resource name. Format: `projects/{project_number}` or `folders/{folder_number}` (for example, `projects/123` or `folders/456`) */
2198
2198
  resource: string;
2199
2199
  /** Upload protocol for media (e.g. "raw", "multipart"). */
2200
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.20261011",
3
+ "version": "0.4.20261108",
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 ServicePerimeter for a given resource.
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 ServicePerimeter for a given resource.
169
169
  */
170
170
  await gapi.client.accesscontextmanager.projects.lookupConfiguredServicePerimeter(
171
171
  {resource: 'resource'},