@maxim_mazurok/gapi.client.logging-v2 0.0.20230706 → 0.0.20230720

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: 20230706
+// Revision: 20230720
 
 /// <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;
@@ -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. */
@@ -4144,7 +4144,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"?:
@@ -6603,8 +6603,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. */
@@ -10941,8 +10941,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. */
@@ -14058,8 +14058,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. */
@@ -14697,8 +14697,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. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.logging-v2",
-  "version": "0.0.20230706",
+  "version": "0.0.20230720",
   "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: 20230706
+// Revision: 20230720
 
 gapi.load('client', async () => {
     /** now we can use gapi.client */
@@ -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",
@@ -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",
@@ -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",
@@ -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",