From 730a4f1e1911a98487d49eb58615ababe9965da2 Mon Sep 17 00:00:00 2001 From: Michael Bausor Date: Sat, 16 Sep 2017 16:26:46 -0700 Subject: [PATCH] Refresh GAPICs --- .../V2beta1/Gapic/DlpServiceGapicClient.php | 2 +- .../V2/Gapic/ConfigServiceV2GapicClient.php | 17 ++++----- .../V2/Gapic/LoggingServiceV2GapicClient.php | 36 ++++++++++++------- .../V1/Gapic/DatabaseAdminGapicClient.php | 4 +-- .../V1/Gapic/InstanceAdminGapicClient.php | 4 +-- src/Speech/V1/Gapic/SpeechGapicClient.php | 2 +- .../V1beta1/Gapic/SpeechGapicClient.php | 2 +- .../VideoIntelligenceServiceGapicClient.php | 2 +- .../VideoIntelligenceServiceGapicClient.php | 2 +- 9 files changed, 40 insertions(+), 31 deletions(-) diff --git a/src/Dlp/V2beta1/Gapic/DlpServiceGapicClient.php b/src/Dlp/V2beta1/Gapic/DlpServiceGapicClient.php index fe21da3324b2..e3fb6df64c17 100644 --- a/src/Dlp/V2beta1/Gapic/DlpServiceGapicClient.php +++ b/src/Dlp/V2beta1/Gapic/DlpServiceGapicClient.php @@ -574,7 +574,7 @@ public function redactContent($inspectConfig, $items, $replaceConfigs, $optional * is not set. * } * - * @return \Google\Longrunning\Operation + * @return \Google\GAX\OperationResponse * * @throws \Google\GAX\ApiException if the remote call fails * @experimental diff --git a/src/Logging/V2/Gapic/ConfigServiceV2GapicClient.php b/src/Logging/V2/Gapic/ConfigServiceV2GapicClient.php index 37fae77189a6..9098371ccea9 100644 --- a/src/Logging/V2/Gapic/ConfigServiceV2GapicClient.php +++ b/src/Logging/V2/Gapic/ConfigServiceV2GapicClient.php @@ -575,13 +575,10 @@ public function createSink($parent, $sink, $optionalArgs = []) } /** - * Updates a sink. If the named sink doesn't exist, then this method is - * identical to - * [sinks.create](https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create). - * If the named sink does exist, then this method replaces the following - * fields in the existing sink with values from the new sink: `destination`, - * `filter`, `output_version_format`, `start_time`, and `end_time`. - * The updated filter might also have a new `writer_identity`; see the + * Updates a sink. This method replaces the following fields in the existing + * sink with values from the new sink: `destination`, `filter`, + * `output_version_format`, `start_time`, and `end_time`. + * The updated sink might also have a new `writer_identity`; see the * `unique_writer_identity` field. * * Sample code: @@ -606,8 +603,7 @@ public function createSink($parent, $sink, $optionalArgs = []) * * Example: `"projects/my-project-id/sinks/my-sink-id"`. * @param LogSink $sink Required. The updated sink, whose name is the same identifier that appears - * as part of `sink_name`. If `sink_name` does not exist, then - * this method creates a new sink. + * as part of `sink_name`. * @param array $optionalArgs { * Optional. * @@ -622,7 +618,8 @@ public function createSink($parent, $sink, $optionalArgs = []) * 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 false. + * + It is an error if the old value is true and the new value is + * set to false or defaulted to false. * @type \Google\GAX\RetrySettings $retrySettings * Retry settings to use for this call. If present, then * $timeoutMillis is ignored. diff --git a/src/Logging/V2/Gapic/LoggingServiceV2GapicClient.php b/src/Logging/V2/Gapic/LoggingServiceV2GapicClient.php index 3ca10519b2fa..96beea321d21 100644 --- a/src/Logging/V2/Gapic/LoggingServiceV2GapicClient.php +++ b/src/Logging/V2/Gapic/LoggingServiceV2GapicClient.php @@ -422,7 +422,13 @@ public function deleteLog($logName, $optionalArgs = []) } /** - * Writes log entries to Stackdriver Logging. + * ## Log entry resources. + * + * Writes log entries to Stackdriver Logging. This API method is the + * only way to send log entries to Stackdriver Logging. This method + * is used, directly or indirectly, by the Stackdriver Logging agent + * (fluentd) and all logging libraries configured to use Stackdriver + * Logging. * * Sample code: * ``` @@ -435,21 +441,27 @@ public function deleteLog($logName, $optionalArgs = []) * } * ``` * - * @param LogEntry[] $entries Required. The log entries to write. Values supplied for the fields - * `log_name`, `resource`, and `labels` in this `entries.write` request are - * inserted into those log entries in this list that do not provide their own - * values. + * @param LogEntry[] $entries Required. The log entries to send to Stackdriver Logging. The order of log + * entries in this list does not matter. Values supplied in this method's + * `log_name`, `resource`, and `labels` fields are copied into those log + * entries in this list that do not include values for their corresponding + * fields. For more information, see the [LogEntry][google.logging.v2.LogEntry] type. + * + * If the `timestamp` or `insert_id` fields are missing in log entries, then + * this method supplies the current time or a unique identifier, respectively. + * The supplied values are chosen so that, among the log entries that did not + * supply their own values, the entries earlier in the list will sort before + * the entries later in the list. See the `entries.list` method. * - * Stackdriver Logging also creates and inserts values for `timestamp` and - * `insert_id` if the entries do not provide them. The created `insert_id` for - * the N'th entry in this list will be greater than earlier entries and less - * than later entries. Otherwise, the order of log entries in this list does - * not matter. + * Log entries with timestamps that are more than the + * [logs retention period](https://cloud.google.com/logging/quota-policy) in the past or more than + * 24 hours in the future might be discarded. Discarding does not return + * an error. * * To improve throughput and to avoid exceeding the * [quota limit](https://cloud.google.com/logging/quota-policy) for calls to `entries.write`, - * you should write multiple log entries at once rather than - * calling this method for each individual log entry. + * you should try to include several log entries in this list, + * rather than calling this method for each individual log entry. * @param array $optionalArgs { * Optional. * diff --git a/src/Spanner/Admin/Database/V1/Gapic/DatabaseAdminGapicClient.php b/src/Spanner/Admin/Database/V1/Gapic/DatabaseAdminGapicClient.php index cfa6b2d89acb..1faacf3af681 100644 --- a/src/Spanner/Admin/Database/V1/Gapic/DatabaseAdminGapicClient.php +++ b/src/Spanner/Admin/Database/V1/Gapic/DatabaseAdminGapicClient.php @@ -608,7 +608,7 @@ public function listDatabases($parent, $optionalArgs = []) * is not set. * } * - * @return \Google\Longrunning\Operation + * @return \Google\GAX\OperationResponse * * @throws \Google\GAX\ApiException if the remote call fails * @experimental @@ -768,7 +768,7 @@ public function getDatabase($name, $optionalArgs = []) * is not set. * } * - * @return \Google\Longrunning\Operation + * @return \Google\GAX\OperationResponse * * @throws \Google\GAX\ApiException if the remote call fails * @experimental diff --git a/src/Spanner/Admin/Instance/V1/Gapic/InstanceAdminGapicClient.php b/src/Spanner/Admin/Instance/V1/Gapic/InstanceAdminGapicClient.php index 182b04e1a135..6582d937ab09 100644 --- a/src/Spanner/Admin/Instance/V1/Gapic/InstanceAdminGapicClient.php +++ b/src/Spanner/Admin/Instance/V1/Gapic/InstanceAdminGapicClient.php @@ -895,7 +895,7 @@ public function getInstance($name, $optionalArgs = []) * is not set. * } * - * @return \Google\Longrunning\Operation + * @return \Google\GAX\OperationResponse * * @throws \Google\GAX\ApiException if the remote call fails * @experimental @@ -1019,7 +1019,7 @@ public function createInstance($parent, $instanceId, $instance, $optionalArgs = * is not set. * } * - * @return \Google\Longrunning\Operation + * @return \Google\GAX\OperationResponse * * @throws \Google\GAX\ApiException if the remote call fails * @experimental diff --git a/src/Speech/V1/Gapic/SpeechGapicClient.php b/src/Speech/V1/Gapic/SpeechGapicClient.php index 797cf7e3c7de..601f316b69db 100644 --- a/src/Speech/V1/Gapic/SpeechGapicClient.php +++ b/src/Speech/V1/Gapic/SpeechGapicClient.php @@ -419,7 +419,7 @@ public function recognize($config, $audio, $optionalArgs = []) * is not set. * } * - * @return \Google\Longrunning\Operation + * @return \Google\GAX\OperationResponse * * @throws \Google\GAX\ApiException if the remote call fails * @experimental diff --git a/src/Speech/V1beta1/Gapic/SpeechGapicClient.php b/src/Speech/V1beta1/Gapic/SpeechGapicClient.php index d59c0189aaf4..5111253a5503 100644 --- a/src/Speech/V1beta1/Gapic/SpeechGapicClient.php +++ b/src/Speech/V1beta1/Gapic/SpeechGapicClient.php @@ -415,7 +415,7 @@ public function syncRecognize($config, $audio, $optionalArgs = []) * is not set. * } * - * @return \Google\Longrunning\Operation + * @return \Google\GAX\OperationResponse * * @throws \Google\GAX\ApiException if the remote call fails * @experimental diff --git a/src/VideoIntelligence/V1beta1/Gapic/VideoIntelligenceServiceGapicClient.php b/src/VideoIntelligence/V1beta1/Gapic/VideoIntelligenceServiceGapicClient.php index d9044d7b7558..2b204a75fae7 100644 --- a/src/VideoIntelligence/V1beta1/Gapic/VideoIntelligenceServiceGapicClient.php +++ b/src/VideoIntelligence/V1beta1/Gapic/VideoIntelligenceServiceGapicClient.php @@ -372,7 +372,7 @@ public function __construct($options = []) * is not set. * } * - * @return \Google\Longrunning\Operation + * @return \Google\GAX\OperationResponse * * @throws \Google\GAX\ApiException if the remote call fails * @experimental diff --git a/src/VideoIntelligence/V1beta2/Gapic/VideoIntelligenceServiceGapicClient.php b/src/VideoIntelligence/V1beta2/Gapic/VideoIntelligenceServiceGapicClient.php index b87cb322e9b2..b831c93d8ca6 100644 --- a/src/VideoIntelligence/V1beta2/Gapic/VideoIntelligenceServiceGapicClient.php +++ b/src/VideoIntelligence/V1beta2/Gapic/VideoIntelligenceServiceGapicClient.php @@ -372,7 +372,7 @@ public function __construct($options = []) * is not set. * } * - * @return \Google\Longrunning\Operation + * @return \Google\GAX\OperationResponse * * @throws \Google\GAX\ApiException if the remote call fails * @experimental