@maxim_mazurok/gapi.client.logging-v2 0.0.20230714 → 0.0.20230727

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://logging.googleapis.com/$discovery/rest?version=v2
-// Revision: 20230714
+// Revision: 20230727
 
 /// <reference types="gapi.client" />
 
@@ -39,9 +39,9 @@ declare namespace gapi.client {
             usePartitionedTables?:
                 boolean;
             /**
-             * Output only. True if new timestamp column based partitioning is in use, false if legacy ingestion-time partitioning is in use.All new sinks will have this field set true and will
-             * use timestamp column based partitioning. If use_partitioned_tables is false, this value has no meaning and will be false. Legacy sinks using partitioned tables will have this field
-             * set to false.
+             * Output only. True if new timestamp column based partitioning is in use, false if legacy ingress-time partitioning is in use.All new sinks will have this field set true and will use
+             * timestamp column based partitioning. If use_partitioned_tables is false, this value has no meaning and will be false. Legacy sinks using partitioned tables will have this field set
+             * to false.
              */
             usesTimestampColumnPartitioning?:
                 boolean;
@@ -593,7 +593,7 @@ declare namespace gapi.client {
              * corresponding PROJECT_ID internally and the log_name field will contain PROJECT_ID in queries and exports.[LOG_ID] must be URL-encoded within log_name. Example:
              * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".[LOG_ID] must be less than 512 characters long and can only include the following characters: upper
              * and lower case alphanumeric characters, forward-slash, underscore, hyphen, and period.For backward compatibility, if log_name begins with a forward-slash, such as /projects/...,
-             * then the log entry is ingested as usual, but the forward-slash is removed. Listing the log entry will not show the leading slash and filtering for a log name with a leading slash
+             * then the log entry is processed as usual, but the forward-slash is removed. Listing the log entry will not show the leading slash and filtering for a log name with a leading slash
              * will never return any results.
              */
             logName?:
@@ -647,7 +647,7 @@ declare namespace gapi.client {
              * Optional. The time the event described by the log entry occurred. This time is used to compute the log entry's age and to enforce the logs retention period. If this field is omitted
              * in a new log entry, then Logging assigns it the current time. Timestamps have nanosecond accuracy, but trailing zeros in the fractional seconds might be omitted when the timestamp
              * is displayed.Incoming log entries must have timestamps that don't exceed the logs retention period (https://cloud.google.com/logging/quotas#logs_retention_periods) in the past, and
-             * that don't exceed 24 hours in the future. Log entries outside those time boundaries aren't ingested by Logging.
+             * that don't exceed 24 hours in the future. Log entries outside those time boundaries are rejected by Logging.
              */
             timestamp?:
                 string;
@@ -823,9 +823,9 @@ declare namespace gapi.client {
                 string;
             /**
              * Required. The export destination: "storage.googleapis.com/[GCS_BUCKET]" "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
-             * "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]" "logging.googleapis.com/projects/[PROJECT_ID]" The sink's writer_identity, set when the sink is created, must have
-             * permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs with Sinks
-             * (https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
+             * "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]" "logging.googleapis.com/projects/[PROJECT_ID]"
+             * "logging.googleapis.com/projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" The sink's writer_identity, set when the sink is created, must have permission to write to
+             * the destination or else the log entries are not exported. For more information, see Exporting Logs with Sinks (https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
              */
             destination?:
                 string;
@@ -1197,8 +1197,8 @@ declare namespace gapi.client {
         }
         interface Settings {
             /**
-             * Optional. If set to true, the _Default sink in newly created projects and folders will created in a disabled state. This can be used to automatically disable log ingestion if there
-             * is already an aggregated sink configured in the hierarchy. The _Default sink can be re-enabled manually if needed.
+             * Optional. If set to true, the _Default sink in newly created projects and folders will created in a disabled state. This can be used to automatically disable log storage if there is
+             * already an aggregated sink configured in the hierarchy. The _Default sink can be re-enabled manually if needed.
              */
             disableDefaultSink?:
                 boolean;
@@ -1878,7 +1878,7 @@ declare namespace gapi.client {
                 /**
                  * Required. The resource name of the link:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  */
                 name:
                     string;
@@ -1928,9 +1928,9 @@ declare namespace gapi.client {
                 pageToken?:
                     string;
                 /**
-                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/"
-                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
+                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
                  */
                 parent:
                     string;
@@ -2149,7 +2149,7 @@ declare namespace gapi.client {
                 uploadType?:
                     string;
             }): Request<{}>;
-            /** Gets a view on a log bucket.. */
+            /** Gets a view on a log bucket. */
             get(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -3355,8 +3355,8 @@ declare namespace gapi.client {
         }
         interface SinksResource {
             /**
-             * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted
-             * to write to the destination. A sink can export log entries only from the resource owning the sink.
+             * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+             * sink can export log entries only from the resource owning the sink.
              */
             create(request: {
                 /** V1 error format. */
@@ -3402,7 +3402,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -3460,7 +3461,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -3659,8 +3661,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -3726,8 +3728,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -3795,8 +3797,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -3862,8 +3864,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -4144,7 +4146,7 @@ declare namespace gapi.client {
                     string;
             },
             body: ListLogEntriesRequest): Request<ListLogEntriesResponse>;
-            /** Streaming read of log entries as they are ingested. Until the stream is terminated, it will continue reading logs. */
+            /** Streaming read of log entries as they are received. Until the stream is terminated, it will continue reading logs. */
             tail(request: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -5126,7 +5128,7 @@ declare namespace gapi.client {
                 /**
                  * Required. The resource name of the link:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  */
                 name:
                     string;
@@ -5176,9 +5178,9 @@ declare namespace gapi.client {
                 pageToken?:
                     string;
                 /**
-                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/"
-                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
+                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
                  */
                 parent:
                     string;
@@ -5397,7 +5399,7 @@ declare namespace gapi.client {
                 uploadType?:
                     string;
             }): Request<{}>;
-            /** Gets a view on a log bucket.. */
+            /** Gets a view on a log bucket. */
             get(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -6603,8 +6605,8 @@ declare namespace gapi.client {
         }
         interface SinksResource {
             /**
-             * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted
-             * to write to the destination. A sink can export log entries only from the resource owning the sink.
+             * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+             * sink can export log entries only from the resource owning the sink.
              */
             create(request: {
                 /** V1 error format. */
@@ -6650,7 +6652,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -6708,7 +6711,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -6907,8 +6911,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -6974,8 +6978,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -7043,8 +7047,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -7110,8 +7114,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -7507,7 +7511,7 @@ declare namespace gapi.client {
                 /**
                  * Required. The resource name of the link:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  */
                 name:
                     string;
@@ -7557,9 +7561,9 @@ declare namespace gapi.client {
                 pageToken?:
                     string;
                 /**
-                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/"
-                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
+                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
                  */
                 parent:
                     string;
@@ -7716,7 +7720,7 @@ declare namespace gapi.client {
                 uploadType?:
                     string;
             }): Request<{}>;
-            /** Gets a view on a log bucket.. */
+            /** Gets a view on a log bucket. */
             get(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -9464,7 +9468,7 @@ declare namespace gapi.client {
                 /**
                  * Required. The resource name of the link:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  */
                 name:
                     string;
@@ -9514,9 +9518,9 @@ declare namespace gapi.client {
                 pageToken?:
                     string;
                 /**
-                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/"
-                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
+                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
                  */
                 parent:
                     string;
@@ -9735,7 +9739,7 @@ declare namespace gapi.client {
                 uploadType?:
                     string;
             }): Request<{}>;
-            /** Gets a view on a log bucket.. */
+            /** Gets a view on a log bucket. */
             get(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -10941,8 +10945,8 @@ declare namespace gapi.client {
         }
         interface SinksResource {
             /**
-             * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted
-             * to write to the destination. A sink can export log entries only from the resource owning the sink.
+             * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+             * sink can export log entries only from the resource owning the sink.
              */
             create(request: {
                 /** V1 error format. */
@@ -10988,7 +10992,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -11046,7 +11051,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -11245,8 +11251,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -11312,8 +11318,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -11381,8 +11387,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -11448,8 +11454,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -12282,7 +12288,7 @@ declare namespace gapi.client {
                 /**
                  * Required. The resource name of the link:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID"
                  */
                 name:
                     string;
@@ -12332,9 +12338,9 @@ declare namespace gapi.client {
                 pageToken?:
                     string;
                 /**
-                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/"
-                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/"
-                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
+                 * Required. The parent resource whose links are to be listed:"projects/PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "organizations/ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID" "billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
+                 * "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID"
                  */
                 parent:
                     string;
@@ -12553,7 +12559,7 @@ declare namespace gapi.client {
                 uploadType?:
                     string;
             }): Request<{}>;
-            /** Gets a view on a log bucket.. */
+            /** Gets a view on a log bucket. */
             get(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -14058,8 +14064,8 @@ declare namespace gapi.client {
         }
         interface SinksResource {
             /**
-             * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted
-             * to write to the destination. A sink can export log entries only from the resource owning the sink.
+             * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+             * sink can export log entries only from the resource owning the sink.
              */
             create(request: {
                 /** V1 error format. */
@@ -14105,7 +14111,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -14163,7 +14170,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -14362,8 +14370,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -14429,8 +14437,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -14498,8 +14506,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -14565,8 +14573,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -14697,8 +14705,8 @@ declare namespace gapi.client {
         }
         interface SinksResource {
             /**
-             * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted
-             * to write to the destination. A sink can export log entries only from the resource owning the sink.
+             * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+             * sink can export log entries only from the resource owning the sink.
              */
             create(request: {
                 /** V1 error format. */
@@ -14744,7 +14752,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -14802,7 +14811,8 @@ declare namespace gapi.client {
                  * Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then
                  * the value returned as writer_identity is the same group or service account used by Cloud Logging before the addition of writer identities to this API. The sink's destination
                  * must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of
-                 * writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+                 * writer_identity will be a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents) used by the sinks with the same parent. For more information,
+                 * see writer_identity in LogSink.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -15001,8 +15011,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;
@@ -15068,8 +15078,8 @@ declare namespace gapi.client {
                 /**
                  * Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both
                  * the old and new values of this field: If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity. If the old
-                 * value is false and the new value is true, then writer_identity is changed to a unique service account. It is an error if the old value is true and the new value is set to false
-                 * or defaulted to false.
+                 * value is false and the new value is true, then writer_identity is changed to a service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents)) owned by
+                 * Cloud Logging. It is an error if the old value is true and the new value is set to false or defaulted to false.
                  */
                 uniqueWriterIdentity?:
                     boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.logging-v2",
-  "version": "0.0.20230714",
+  "version": "0.0.20230727",
   "description": "TypeScript typings for Cloud Logging API v2",
   "license": "MIT",
   "author": {

package/readme.md

@@ -99,7 +99,7 @@ Lists log entries. Use this method to retrieve log entries that originated from
 await gapi.client.logging.entries.list({  });
 
 /*
-Streaming read of log entries as they are ingested. Until the stream is terminated, it will continue reading logs.
+Streaming read of log entries as they are received. Until the stream is terminated, it will continue reading logs.
 */
 await gapi.client.logging.entries.tail({  });
 
@@ -204,7 +204,7 @@ Gets the Log Router settings for the given resource.Note: Settings for the Log R
 await gapi.client.logging.projects.getSettings({ name: "name",  });
 
 /*
-Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.
+Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.
 */
 await gapi.client.logging.sinks.create({ parent: "parent",  });
 

package/tests.ts

@@ -3,7 +3,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 
-// Revision: 20230714
+// Revision: 20230727
 
 gapi.load('client', async () => {
     /** now we can use gapi.client */
@@ -294,7 +294,7 @@ gapi.load('client', async () => {
         await gapi.client.logging.billingAccounts.locations.buckets.views.delete({
             name: "Test string",
         });
-        /** Gets a view on a log bucket.. */
+        /** Gets a view on a log bucket. */
         await gapi.client.logging.billingAccounts.locations.buckets.views.get({
             name: "Test string",
         });
@@ -361,8 +361,8 @@ gapi.load('client', async () => {
             resourceNames: "Test string",
         });
         /**
-         * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted to
-         * write to the destination. A sink can export log entries only from the resource owning the sink.
+         * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+         * sink can export log entries only from the resource owning the sink.
          */
         await gapi.client.logging.billingAccounts.sinks.create({
             customWriterIdentity: "Test string",
@@ -502,7 +502,7 @@ gapi.load('client', async () => {
                 "Test string"
             ],
         });
-        /** Streaming read of log entries as they are ingested. Until the stream is terminated, it will continue reading logs. */
+        /** Streaming read of log entries as they are received. Until the stream is terminated, it will continue reading logs. */
         await gapi.client.logging.entries.tail({
         }, {
             bufferWindow: "Test string",
@@ -910,7 +910,7 @@ gapi.load('client', async () => {
         await gapi.client.logging.folders.locations.buckets.views.delete({
             name: "Test string",
         });
-        /** Gets a view on a log bucket.. */
+        /** Gets a view on a log bucket. */
         await gapi.client.logging.folders.locations.buckets.views.get({
             name: "Test string",
         });
@@ -977,8 +977,8 @@ gapi.load('client', async () => {
             resourceNames: "Test string",
         });
         /**
-         * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted to
-         * write to the destination. A sink can export log entries only from the resource owning the sink.
+         * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+         * sink can export log entries only from the resource owning the sink.
          */
         await gapi.client.logging.folders.sinks.create({
             customWriterIdentity: "Test string",
@@ -1298,7 +1298,7 @@ gapi.load('client', async () => {
         await gapi.client.logging.locations.buckets.views.delete({
             name: "Test string",
         });
-        /** Gets a view on a log bucket.. */
+        /** Gets a view on a log bucket. */
         await gapi.client.logging.locations.buckets.views.get({
             name: "Test string",
         });
@@ -1651,7 +1651,7 @@ gapi.load('client', async () => {
         await gapi.client.logging.organizations.locations.buckets.views.delete({
             name: "Test string",
         });
-        /** Gets a view on a log bucket.. */
+        /** Gets a view on a log bucket. */
         await gapi.client.logging.organizations.locations.buckets.views.get({
             name: "Test string",
         });
@@ -1718,8 +1718,8 @@ gapi.load('client', async () => {
             resourceNames: "Test string",
         });
         /**
-         * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted to
-         * write to the destination. A sink can export log entries only from the resource owning the sink.
+         * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+         * sink can export log entries only from the resource owning the sink.
          */
         await gapi.client.logging.organizations.sinks.create({
             customWriterIdentity: "Test string",
@@ -2092,7 +2092,7 @@ gapi.load('client', async () => {
         await gapi.client.logging.projects.locations.buckets.views.delete({
             name: "Test string",
         });
-        /** Gets a view on a log bucket.. */
+        /** Gets a view on a log bucket. */
         await gapi.client.logging.projects.locations.buckets.views.get({
             name: "Test string",
         });
@@ -2291,8 +2291,8 @@ gapi.load('client', async () => {
             version: "Test string",
         });
         /**
-         * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted to
-         * write to the destination. A sink can export log entries only from the resource owning the sink.
+         * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+         * sink can export log entries only from the resource owning the sink.
          */
         await gapi.client.logging.projects.sinks.create({
             customWriterIdentity: "Test string",
@@ -2409,8 +2409,8 @@ gapi.load('client', async () => {
             writerIdentity: "Test string",
         });
         /**
-         * Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted to
-         * write to the destination. A sink can export log entries only from the resource owning the sink.
+         * Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A
+         * sink can export log entries only from the resource owning the sink.
          */
         await gapi.client.logging.sinks.create({
             customWriterIdentity: "Test string",