Skip to content

Commit b3ec456

Browse files
1 parent 103450a commit b3ec456

11 files changed

+151
-30
lines changed

src/CloudFilestore.php

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -277,6 +277,16 @@ public function __construct($clientOrConfig = [], $rootUrl = null)
277277
'type' => 'string',
278278
],
279279
],
280+
],'pauseReplica' => [
281+
'path' => 'v1/{+name}:pauseReplica',
282+
'httpMethod' => 'POST',
283+
'parameters' => [
284+
'name' => [
285+
'location' => 'path',
286+
'type' => 'string',
287+
'required' => true,
288+
],
289+
],
280290
],'promoteReplica' => [
281291
'path' => 'v1/{+name}:promoteReplica',
282292
'httpMethod' => 'POST',
@@ -297,6 +307,16 @@ public function __construct($clientOrConfig = [], $rootUrl = null)
297307
'required' => true,
298308
],
299309
],
310+
],'resumeReplica' => [
311+
'path' => 'v1/{+name}:resumeReplica',
312+
'httpMethod' => 'POST',
313+
'parameters' => [
314+
'name' => [
315+
'location' => 'path',
316+
'type' => 'string',
317+
'required' => true,
318+
],
319+
],
300320
],'revert' => [
301321
'path' => 'v1/{+name}:revert',
302322
'httpMethod' => 'POST',

src/CloudFilestore/Instance.php

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -128,7 +128,8 @@ class Instance extends \Google\Collection
128128
public const TIER_REGIONAL = 'REGIONAL';
129129
protected $collection_key = 'suspensionReasons';
130130
/**
131-
* Output only. The increase/decrease capacity step size in GB.
131+
* Output only. The incremental increase or decrease in capacity, designated
132+
* in some number of GB.
132133
*
133134
* @var string
134135
*/
@@ -189,13 +190,13 @@ class Instance extends \Google\Collection
189190
*/
190191
public $labels;
191192
/**
192-
* Output only. The max capacity of the instance in GB.
193+
* Output only. The maximum capacity of the instance in GB.
193194
*
194195
* @var string
195196
*/
196197
public $maxCapacityGb;
197198
/**
198-
* Output only. The min capacity of the instance in GB.
199+
* Output only. The minimum capacity of the instance in GB.
199200
*
200201
* @var string
201202
*/
@@ -275,7 +276,8 @@ class Instance extends \Google\Collection
275276
public $tier;
276277

277278
/**
278-
* Output only. The increase/decrease capacity step size in GB.
279+
* Output only. The incremental increase or decrease in capacity, designated
280+
* in some number of GB.
279281
*
280282
* @param string $capacityStepSizeGb
281283
*/
@@ -456,7 +458,7 @@ public function getLabels()
456458
return $this->labels;
457459
}
458460
/**
459-
* Output only. The max capacity of the instance in GB.
461+
* Output only. The maximum capacity of the instance in GB.
460462
*
461463
* @param string $maxCapacityGb
462464
*/
@@ -472,7 +474,7 @@ public function getMaxCapacityGb()
472474
return $this->maxCapacityGb;
473475
}
474476
/**
475-
* Output only. The min capacity of the instance in GB.
477+
* Output only. The minimum capacity of the instance in GB.
476478
*
477479
* @param string $minCapacityGb
478480
*/

src/CloudFilestore/ListOperationsResponse.php

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,9 @@ class ListOperationsResponse extends \Google\Collection
3030
protected $operationsDataType = 'array';
3131
/**
3232
* Unordered list. Unreachable resources. Populated when the request sets
33-
* `ListOperationsRequest.return_partial_success` and reads across collections
34-
* e.g. when attempting to list all resources across all supported locations.
33+
* `ListOperationsRequest.return_partial_success` and reads across
34+
* collections. For example, when attempting to list all resources across all
35+
* supported locations.
3536
*
3637
* @var string[]
3738
*/
@@ -71,8 +72,9 @@ public function getOperations()
7172
}
7273
/**
7374
* Unordered list. Unreachable resources. Populated when the request sets
74-
* `ListOperationsRequest.return_partial_success` and reads across collections
75-
* e.g. when attempting to list all resources across all supported locations.
75+
* `ListOperationsRequest.return_partial_success` and reads across
76+
* collections. For example, when attempting to list all resources across all
77+
* supported locations.
7678
*
7779
* @param string[] $unreachable
7880
*/
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
<?php
2+
/*
3+
* Copyright 2014 Google Inc.
4+
*
5+
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
6+
* use this file except in compliance with the License. You may obtain a copy of
7+
* the License at
8+
*
9+
* http://www.apache.org/licenses/LICENSE-2.0
10+
*
11+
* Unless required by applicable law or agreed to in writing, software
12+
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
13+
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
14+
* License for the specific language governing permissions and limitations under
15+
* the License.
16+
*/
17+
18+
namespace Google\Service\CloudFilestore;
19+
20+
class PauseReplicaRequest extends \Google\Model
21+
{
22+
}
23+
24+
// Adding a class alias for backwards compatibility with the previous class name.
25+
class_alias(PauseReplicaRequest::class, 'Google_Service_CloudFilestore_PauseReplicaRequest');

src/CloudFilestore/PerformanceLimits.php

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -20,38 +20,38 @@
2020
class PerformanceLimits extends \Google\Model
2121
{
2222
/**
23-
* Output only. The max IOPS.
23+
* Output only. The maximum IOPS.
2424
*
2525
* @var string
2626
*/
2727
public $maxIops;
2828
/**
29-
* Output only. The max read IOPS.
29+
* Output only. The maximum read IOPS.
3030
*
3131
* @var string
3232
*/
3333
public $maxReadIops;
3434
/**
35-
* Output only. The max read throughput in bytes per second.
35+
* Output only. The maximum read throughput in bytes per second.
3636
*
3737
* @var string
3838
*/
3939
public $maxReadThroughputBps;
4040
/**
41-
* Output only. The max write IOPS.
41+
* Output only. The maximum write IOPS.
4242
*
4343
* @var string
4444
*/
4545
public $maxWriteIops;
4646
/**
47-
* Output only. The max write throughput in bytes per second.
47+
* Output only. The maximum write throughput in bytes per second.
4848
*
4949
* @var string
5050
*/
5151
public $maxWriteThroughputBps;
5252

5353
/**
54-
* Output only. The max IOPS.
54+
* Output only. The maximum IOPS.
5555
*
5656
* @param string $maxIops
5757
*/
@@ -67,7 +67,7 @@ public function getMaxIops()
6767
return $this->maxIops;
6868
}
6969
/**
70-
* Output only. The max read IOPS.
70+
* Output only. The maximum read IOPS.
7171
*
7272
* @param string $maxReadIops
7373
*/
@@ -83,7 +83,7 @@ public function getMaxReadIops()
8383
return $this->maxReadIops;
8484
}
8585
/**
86-
* Output only. The max read throughput in bytes per second.
86+
* Output only. The maximum read throughput in bytes per second.
8787
*
8888
* @param string $maxReadThroughputBps
8989
*/
@@ -99,7 +99,7 @@ public function getMaxReadThroughputBps()
9999
return $this->maxReadThroughputBps;
100100
}
101101
/**
102-
* Output only. The max write IOPS.
102+
* Output only. The maximum write IOPS.
103103
*
104104
* @param string $maxWriteIops
105105
*/
@@ -115,7 +115,7 @@ public function getMaxWriteIops()
115115
return $this->maxWriteIops;
116116
}
117117
/**
118-
* Output only. The max write throughput in bytes per second.
118+
* Output only. The maximum write throughput in bytes per second.
119119
*
120120
* @param string $maxWriteThroughputBps
121121
*/

src/CloudFilestore/ReplicaConfig.php

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,9 @@ class ReplicaConfig extends \Google\Collection
6666
*/
6767
public $lastActiveSyncTime;
6868
/**
69-
* Optional. The peer instance.
69+
* Optional. The name of the source instance for the replica, in the format
70+
* `projects/{project}/locations/{location}/instances/{instance}`. This field
71+
* is required when creating a replica.
7072
*
7173
* @var string
7274
*/
@@ -109,7 +111,9 @@ public function getLastActiveSyncTime()
109111
return $this->lastActiveSyncTime;
110112
}
111113
/**
112-
* Optional. The peer instance.
114+
* Optional. The name of the source instance for the replica, in the format
115+
* `projects/{project}/locations/{location}/instances/{instance}`. This field
116+
* is required when creating a replica.
113117
*
114118
* @param string $peerInstance
115119
*/

src/CloudFilestore/Replication.php

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,8 @@ class Replication extends \Google\Collection
3737
protected $replicasType = ReplicaConfig::class;
3838
protected $replicasDataType = 'array';
3939
/**
40-
* Optional. The replication role.
40+
* Optional. The replication role. When creating a new replica, this field
41+
* must be set to `STANDBY`.
4142
*
4243
* @var string
4344
*/
@@ -61,7 +62,8 @@ public function getReplicas()
6162
return $this->replicas;
6263
}
6364
/**
64-
* Optional. The replication role.
65+
* Optional. The replication role. When creating a new replica, this field
66+
* must be set to `STANDBY`.
6567
*
6668
* Accepted values: ROLE_UNSPECIFIED, ACTIVE, STANDBY
6769
*

src/CloudFilestore/Resource/ProjectsLocations.php

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -52,9 +52,9 @@ public function get($name, $optParams = [])
5252
* applicable.
5353
* @param array $optParams Optional parameters.
5454
*
55-
* @opt_param string extraLocationTypes Optional. Unless explicitly documented
56-
* otherwise, don't use this unsupported field which is primarily intended for
57-
* internal usage.
55+
* @opt_param string extraLocationTypes Optional. Do not use this field. It is
56+
* unsupported and is ignored unless explicitly documented otherwise. This is
57+
* primarily for internal usage.
5858
* @opt_param string filter A filter to narrow down results to a preferred
5959
* subset. The filtering language accepts strings like `"displayName=tokyo"`,
6060
* and is documented in more detail in [AIP-160](https://google.aip.dev/160).

src/CloudFilestore/Resource/ProjectsLocationsInstances.php

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,10 @@
2020
use Google\Service\CloudFilestore\Instance;
2121
use Google\Service\CloudFilestore\ListInstancesResponse;
2222
use Google\Service\CloudFilestore\Operation;
23+
use Google\Service\CloudFilestore\PauseReplicaRequest;
2324
use Google\Service\CloudFilestore\PromoteReplicaRequest;
2425
use Google\Service\CloudFilestore\RestoreInstanceRequest;
26+
use Google\Service\CloudFilestore\ResumeReplicaRequest;
2527
use Google\Service\CloudFilestore\RevertInstanceRequest;
2628

2729
/**
@@ -139,6 +141,26 @@ public function patch($name, Instance $postBody, $optParams = [])
139141
$params = array_merge($params, $optParams);
140142
return $this->call('patch', [$params], Operation::class);
141143
}
144+
/**
145+
* Pause the standby instance (replica). WARNING: This operation makes the
146+
* standby instance's NFS filesystem writable. Any data written to the standby
147+
* instance while paused will be lost when the replica is resumed or promoted.
148+
* (instances.pauseReplica)
149+
*
150+
* @param string $name Required. The resource name of the instance, in the
151+
* format
152+
* `projects/{project_id}/locations/{location_id}/instances/{instance_id}`.
153+
* @param PauseReplicaRequest $postBody
154+
* @param array $optParams Optional parameters.
155+
* @return Operation
156+
* @throws \Google\Service\Exception
157+
*/
158+
public function pauseReplica($name, PauseReplicaRequest $postBody, $optParams = [])
159+
{
160+
$params = ['name' => $name, 'postBody' => $postBody];
161+
$params = array_merge($params, $optParams);
162+
return $this->call('pauseReplica', [$params], Operation::class);
163+
}
142164
/**
143165
* Promote the standby instance (replica). (instances.promoteReplica)
144166
*
@@ -176,6 +198,25 @@ public function restore($name, RestoreInstanceRequest $postBody, $optParams = []
176198
$params = array_merge($params, $optParams);
177199
return $this->call('restore', [$params], Operation::class);
178200
}
201+
/**
202+
* Resume the standby instance (replica). WARNING: Any data written to the
203+
* standby instance while paused will be lost when the replica is resumed.
204+
* (instances.resumeReplica)
205+
*
206+
* @param string $name Required. The resource name of the instance, in the
207+
* format
208+
* `projects/{project_id}/locations/{location_id}/instances/{instance_id}`.
209+
* @param ResumeReplicaRequest $postBody
210+
* @param array $optParams Optional parameters.
211+
* @return Operation
212+
* @throws \Google\Service\Exception
213+
*/
214+
public function resumeReplica($name, ResumeReplicaRequest $postBody, $optParams = [])
215+
{
216+
$params = ['name' => $name, 'postBody' => $postBody];
217+
$params = array_merge($params, $optParams);
218+
return $this->call('resumeReplica', [$params], Operation::class);
219+
}
179220
/**
180221
* Revert an existing instance's file system to a specified snapshot.
181222
* (instances.revert)

src/CloudFilestore/Resource/ProjectsLocationsOperations.php

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -101,9 +101,9 @@ public function get($name, $optParams = [])
101101
* @opt_param string pageToken The standard list page token.
102102
* @opt_param bool returnPartialSuccess When set to `true`, operations that are
103103
* reachable are returned as normal, and those that are unreachable are returned
104-
* in the [ListOperationsResponse.unreachable] field. This can only be `true`
105-
* when reading across collections e.g. when `parent` is set to
106-
* `"projects/example/locations/-"`. This field is not by default supported and
104+
* in the ListOperationsResponse.unreachable field. This can only be `true` when
105+
* reading across collections. For example, when `parent` is set to
106+
* `"projects/example/locations/-"`. This field is not supported by default and
107107
* will result in an `UNIMPLEMENTED` error if set unless explicitly documented
108108
* otherwise in service or product specific documentation.
109109
* @return ListOperationsResponse

0 commit comments

Comments
 (0)