google-cloud-filestore-v1 0.1.3 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d4964f4b34760c52febb9823a7623bd2607d2e6754682e1a32014f31cc3343b1
4
- data.tar.gz: a185f71cb92dd6adaf2d5523166e0f8b21e30a226894cf0e43fc53d3026ba720
3
+ metadata.gz: 25d5ec39faa328c7d9a69abc71d387d19548ba79fac38c8e07d07a523f2d5873
4
+ data.tar.gz: 786349cd3101f9e5603cf53f3a2bdce91fd477fdb04ff709efbabe5c94a93401
5
5
  SHA512:
6
- metadata.gz: 59af272df1e71b5e0985aa83c3cf55f1c6bd945c3c543221801476560a6a444cea2f4127c3f57609a6d52f248daa1c8ea54b7745bee912715c209fd4c0e24fb3
7
- data.tar.gz: 9c2f43be3fb78d9fe4a743f2ff952ef0c608fdb5771c393835744404ee20e551df37f4dff23c07ed1f5cf8c3dc0486e47d7bd8badd79b29fcfe8368fd417b5f5
6
+ metadata.gz: 2547df1a5b51a9f2c67c8e18f5d374d1a1c1d0358e70a25eb2f49f69d13daaaac01582f2665c76ceb16832eb6b5ab6a25b28e8105abe88cf7eb2c5b9a1b148bb
7
+ data.tar.gz: 983f013897094356a78916d0fe296067d6b4b6939f2294282ffca167c89dbfa3352bff087f2bfbf25eca2c3e7431682356fa5b728c2bd9811f8d3fbc396109f6
data/AUTHENTICATION.md CHANGED
@@ -112,7 +112,7 @@ credentials are discovered.
112
112
  To configure your system for this, simply:
113
113
 
114
114
  1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
115
- 2. Authenticate using OAuth 2.0 `$ gcloud auth login`
115
+ 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
116
116
  3. Write code as if already authenticated.
117
117
 
118
118
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
data/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Ruby Client for the Filestore V1 API
2
2
 
3
- API Client library for the Filestore V1 API
3
+ The Cloud Filestore API is used for creating and managing cloud file servers.
4
4
 
5
5
  Filestore instances are fully managed NFS file servers on Google Cloud for use with applications running on Compute Engine virtual machines (VMs) instances or Google Kubernetes Engine clusters.
6
6
 
@@ -37,7 +37,7 @@ request = ::Google::Cloud::Filestore::V1::ListInstancesRequest.new # (request fi
37
37
  response = client.list_instances request
38
38
  ```
39
39
 
40
- View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-filestore-v1/latest)
40
+ View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-filestore-v1/latest)
41
41
  for class and method documentation.
42
42
 
43
43
  See also the [Product Documentation](https://cloud.google.com/filestore/)
@@ -46,7 +46,7 @@ for general usage information.
46
46
  ## Enabling Logging
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
49
+ The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
50
  or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
@@ -69,16 +69,21 @@ module GRPC
69
69
  end
70
70
  ```
71
71
 
72
+
73
+ ## Google Cloud Samples
74
+
75
+ To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
76
+
72
77
  ## Supported Ruby Versions
73
78
 
74
- This library is supported on Ruby 2.5+.
79
+ This library is supported on Ruby 2.6+.
75
80
 
76
81
  Google provides official support for Ruby versions that are actively supported
77
82
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
78
- in security maintenance, and not end of life. Currently, this means Ruby 2.5
79
- and later. Older versions of Ruby _may_ still work, but are unsupported and not
80
- recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
81
- about the Ruby support schedule.
83
+ in security maintenance, and not end of life. Older versions of Ruby _may_
84
+ still work, but are unsupported and not recommended. See
85
+ https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
86
+ support schedule.
82
87
 
83
88
  ## Which client should I use?
84
89
 
@@ -264,13 +264,11 @@ module Google
264
264
  # # Call the list_instances method.
265
265
  # result = client.list_instances request
266
266
  #
267
- # # The returned object is of type Gapic::PagedEnumerable. You can
268
- # # iterate over all elements by calling #each, and the enumerable
269
- # # will lazily make API calls to fetch subsequent pages. Other
270
- # # methods are also available for managing paging directly.
271
- # result.each do |response|
267
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
268
+ # # over elements, and API calls will be issued to fetch pages as needed.
269
+ # result.each do |item|
272
270
  # # Each element is of type ::Google::Cloud::Filestore::V1::Instance.
273
- # p response
271
+ # p item
274
272
  # end
275
273
  #
276
274
  def list_instances request, options = nil
@@ -452,14 +450,14 @@ module Google
452
450
  # # Call the create_instance method.
453
451
  # result = client.create_instance request
454
452
  #
455
- # # The returned object is of type Gapic::Operation. You can use this
456
- # # object to check the status of an operation, cancel it, or wait
457
- # # for results. Here is how to block until completion:
453
+ # # The returned object is of type Gapic::Operation. You can use it to
454
+ # # check the status of an operation, cancel it, or wait for results.
455
+ # # Here is how to wait for a response.
458
456
  # result.wait_until_done! timeout: 60
459
457
  # if result.response?
460
458
  # p result.response
461
459
  # else
462
- # puts "Error!"
460
+ # puts "No response received."
463
461
  # end
464
462
  #
465
463
  def create_instance request, options = nil
@@ -553,14 +551,14 @@ module Google
553
551
  # # Call the update_instance method.
554
552
  # result = client.update_instance request
555
553
  #
556
- # # The returned object is of type Gapic::Operation. You can use this
557
- # # object to check the status of an operation, cancel it, or wait
558
- # # for results. Here is how to block until completion:
554
+ # # The returned object is of type Gapic::Operation. You can use it to
555
+ # # check the status of an operation, cancel it, or wait for results.
556
+ # # Here is how to wait for a response.
559
557
  # result.wait_until_done! timeout: 60
560
558
  # if result.response?
561
559
  # p result.response
562
560
  # else
563
- # puts "Error!"
561
+ # puts "No response received."
564
562
  # end
565
563
  #
566
564
  def update_instance request, options = nil
@@ -657,14 +655,14 @@ module Google
657
655
  # # Call the restore_instance method.
658
656
  # result = client.restore_instance request
659
657
  #
660
- # # The returned object is of type Gapic::Operation. You can use this
661
- # # object to check the status of an operation, cancel it, or wait
662
- # # for results. Here is how to block until completion:
658
+ # # The returned object is of type Gapic::Operation. You can use it to
659
+ # # check the status of an operation, cancel it, or wait for results.
660
+ # # Here is how to wait for a response.
663
661
  # result.wait_until_done! timeout: 60
664
662
  # if result.response?
665
663
  # p result.response
666
664
  # else
667
- # puts "Error!"
665
+ # puts "No response received."
668
666
  # end
669
667
  #
670
668
  def restore_instance request, options = nil
@@ -751,14 +749,14 @@ module Google
751
749
  # # Call the delete_instance method.
752
750
  # result = client.delete_instance request
753
751
  #
754
- # # The returned object is of type Gapic::Operation. You can use this
755
- # # object to check the status of an operation, cancel it, or wait
756
- # # for results. Here is how to block until completion:
752
+ # # The returned object is of type Gapic::Operation. You can use it to
753
+ # # check the status of an operation, cancel it, or wait for results.
754
+ # # Here is how to wait for a response.
757
755
  # result.wait_until_done! timeout: 60
758
756
  # if result.response?
759
757
  # p result.response
760
758
  # else
761
- # puts "Error!"
759
+ # puts "No response received."
762
760
  # end
763
761
  #
764
762
  def delete_instance request, options = nil
@@ -859,13 +857,11 @@ module Google
859
857
  # # Call the list_backups method.
860
858
  # result = client.list_backups request
861
859
  #
862
- # # The returned object is of type Gapic::PagedEnumerable. You can
863
- # # iterate over all elements by calling #each, and the enumerable
864
- # # will lazily make API calls to fetch subsequent pages. Other
865
- # # methods are also available for managing paging directly.
866
- # result.each do |response|
860
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
861
+ # # over elements, and API calls will be issued to fetch pages as needed.
862
+ # result.each do |item|
867
863
  # # Each element is of type ::Google::Cloud::Filestore::V1::Backup.
868
- # p response
864
+ # p item
869
865
  # end
870
866
  #
871
867
  def list_backups request, options = nil
@@ -1049,14 +1045,14 @@ module Google
1049
1045
  # # Call the create_backup method.
1050
1046
  # result = client.create_backup request
1051
1047
  #
1052
- # # The returned object is of type Gapic::Operation. You can use this
1053
- # # object to check the status of an operation, cancel it, or wait
1054
- # # for results. Here is how to block until completion:
1048
+ # # The returned object is of type Gapic::Operation. You can use it to
1049
+ # # check the status of an operation, cancel it, or wait for results.
1050
+ # # Here is how to wait for a response.
1055
1051
  # result.wait_until_done! timeout: 60
1056
1052
  # if result.response?
1057
1053
  # p result.response
1058
1054
  # else
1059
- # puts "Error!"
1055
+ # puts "No response received."
1060
1056
  # end
1061
1057
  #
1062
1058
  def create_backup request, options = nil
@@ -1143,14 +1139,14 @@ module Google
1143
1139
  # # Call the delete_backup method.
1144
1140
  # result = client.delete_backup request
1145
1141
  #
1146
- # # The returned object is of type Gapic::Operation. You can use this
1147
- # # object to check the status of an operation, cancel it, or wait
1148
- # # for results. Here is how to block until completion:
1142
+ # # The returned object is of type Gapic::Operation. You can use it to
1143
+ # # check the status of an operation, cancel it, or wait for results.
1144
+ # # Here is how to wait for a response.
1149
1145
  # result.wait_until_done! timeout: 60
1150
1146
  # if result.response?
1151
1147
  # p result.response
1152
1148
  # else
1153
- # puts "Error!"
1149
+ # puts "No response received."
1154
1150
  # end
1155
1151
  #
1156
1152
  def delete_backup request, options = nil
@@ -1239,14 +1235,14 @@ module Google
1239
1235
  # # Call the update_backup method.
1240
1236
  # result = client.update_backup request
1241
1237
  #
1242
- # # The returned object is of type Gapic::Operation. You can use this
1243
- # # object to check the status of an operation, cancel it, or wait
1244
- # # for results. Here is how to block until completion:
1238
+ # # The returned object is of type Gapic::Operation. You can use it to
1239
+ # # check the status of an operation, cancel it, or wait for results.
1240
+ # # Here is how to wait for a response.
1245
1241
  # result.wait_until_done! timeout: 60
1246
1242
  # if result.response?
1247
1243
  # p result.response
1248
1244
  # else
1249
- # puts "Error!"
1245
+ # puts "No response received."
1250
1246
  # end
1251
1247
  #
1252
1248
  def update_backup request, options = nil
@@ -95,6 +95,9 @@ module Google
95
95
  channel_args: @config.channel_args,
96
96
  interceptors: @config.interceptors
97
97
  )
98
+
99
+ # Used by an LRO wrapper for some methods of this service
100
+ @operations_client = self
98
101
  end
99
102
 
100
103
  # Service calls
@@ -155,13 +158,11 @@ module Google
155
158
  # # Call the list_operations method.
156
159
  # result = client.list_operations request
157
160
  #
158
- # # The returned object is of type Gapic::PagedEnumerable. You can
159
- # # iterate over all elements by calling #each, and the enumerable
160
- # # will lazily make API calls to fetch subsequent pages. Other
161
- # # methods are also available for managing paging directly.
162
- # result.each do |response|
161
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
162
+ # # over elements, and API calls will be issued to fetch pages as needed.
163
+ # result.each do |item|
163
164
  # # Each element is of type ::Google::Longrunning::Operation.
164
- # p response
165
+ # p item
165
166
  # end
166
167
  #
167
168
  def list_operations request, options = nil
@@ -250,14 +251,14 @@ module Google
250
251
  # # Call the get_operation method.
251
252
  # result = client.get_operation request
252
253
  #
253
- # # The returned object is of type Gapic::Operation. You can use this
254
- # # object to check the status of an operation, cancel it, or wait
255
- # # for results. Here is how to block until completion:
254
+ # # The returned object is of type Gapic::Operation. You can use it to
255
+ # # check the status of an operation, cancel it, or wait for results.
256
+ # # Here is how to wait for a response.
256
257
  # result.wait_until_done! timeout: 60
257
258
  # if result.response?
258
259
  # p result.response
259
260
  # else
260
- # puts "Error!"
261
+ # puts "No response received."
261
262
  # end
262
263
  #
263
264
  def get_operation request, options = nil
@@ -537,14 +538,14 @@ module Google
537
538
  # # Call the wait_operation method.
538
539
  # result = client.wait_operation request
539
540
  #
540
- # # The returned object is of type Gapic::Operation. You can use this
541
- # # object to check the status of an operation, cancel it, or wait
542
- # # for results. Here is how to block until completion:
541
+ # # The returned object is of type Gapic::Operation. You can use it to
542
+ # # check the status of an operation, cancel it, or wait for results.
543
+ # # Here is how to wait for a response.
543
544
  # result.wait_until_done! timeout: 60
544
545
  # if result.response?
545
546
  # p result.response
546
547
  # else
547
- # puts "Error!"
548
+ # puts "No response received."
548
549
  # end
549
550
  #
550
551
  def wait_operation request, options = nil