google-cloud-gke_hub-v1 0.3.0 → 0.4.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 +4 -4
 - data/AUTHENTICATION.md +1 -1
 - data/README.md +1 -1
 - data/lib/google/cloud/gke_hub/v1/gke_hub/client.rb +32 -36
 - data/lib/google/cloud/gke_hub/v1/gke_hub/operations.rb +12 -14
 - data/lib/google/cloud/gke_hub/v1/gke_hub/rest/client.rb +1302 -0
 - data/lib/google/cloud/gke_hub/v1/gke_hub/rest/operations.rb +793 -0
 - data/lib/google/cloud/gke_hub/v1/gke_hub/rest/service_stub.rb +701 -0
 - data/lib/google/cloud/gke_hub/v1/gke_hub/rest.rb +66 -0
 - data/lib/google/cloud/gke_hub/v1/gke_hub.rb +7 -1
 - data/lib/google/cloud/gke_hub/v1/rest.rb +37 -0
 - data/lib/google/cloud/gke_hub/v1/version.rb +1 -1
 - data/lib/google/cloud/gke_hub/v1.rb +7 -2
 - data/proto_docs/google/api/client.rb +318 -0
 - data/proto_docs/google/api/launch_stage.rb +71 -0
 - data/proto_docs/google/protobuf/empty.rb +0 -2
 - data/proto_docs/google/rpc/status.rb +4 -2
 - metadata +14 -7
 
    
        checksums.yaml
    CHANGED
    
    | 
         @@ -1,7 +1,7 @@ 
     | 
|
| 
       1 
1 
     | 
    
         
             
            ---
         
     | 
| 
       2 
2 
     | 
    
         
             
            SHA256:
         
     | 
| 
       3 
     | 
    
         
            -
              metadata.gz:  
     | 
| 
       4 
     | 
    
         
            -
              data.tar.gz:  
     | 
| 
      
 3 
     | 
    
         
            +
              metadata.gz: e211e3671a0c7c0ffae2b48a5da58e845d6157c309f8850f1ea8c27baf24a750
         
     | 
| 
      
 4 
     | 
    
         
            +
              data.tar.gz: 51aa70f26d9cdc2c05a4d1722256079f1fdb71b8b8032d947c4c862cb10bd586
         
     | 
| 
       5 
5 
     | 
    
         
             
            SHA512:
         
     | 
| 
       6 
     | 
    
         
            -
              metadata.gz:  
     | 
| 
       7 
     | 
    
         
            -
              data.tar.gz:  
     | 
| 
      
 6 
     | 
    
         
            +
              metadata.gz: e33bb17ef24514e8a6fe326da7dcc3764aa066d9478522d4caa9f8768bc186e8e2ff9645ca60e76e0972a106ccf2f5a7e15caa844ee9021e7cc47db00cbefa64
         
     | 
| 
      
 7 
     | 
    
         
            +
              data.tar.gz: b70f7a2fec748e8194c03356fe72b3ba1d316261ee8ce3cf72f5165371904c35e4ff167e5aa42ce7b53bf26c567cb1a9070ace63fc0470813731b50948280602
         
     | 
    
        data/AUTHENTICATION.md
    CHANGED
    
    | 
         @@ -114,7 +114,7 @@ credentials are discovered. 
     | 
|
| 
       114 
114 
     | 
    
         
             
            To configure your system for this, simply:
         
     | 
| 
       115 
115 
     | 
    
         | 
| 
       116 
116 
     | 
    
         
             
            1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
         
     | 
| 
       117 
     | 
    
         
            -
            2. Authenticate using OAuth 2.0 `$ gcloud auth login`
         
     | 
| 
      
 117 
     | 
    
         
            +
            2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
         
     | 
| 
       118 
118 
     | 
    
         
             
            3. Write code as if already authenticated.
         
     | 
| 
       119 
119 
     | 
    
         | 
| 
       120 
120 
     | 
    
         
             
            **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
         
     | 
    
        data/README.md
    CHANGED
    
    | 
         @@ -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/ 
     | 
| 
      
 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.
         
     | 
| 
         @@ -249,13 +249,11 @@ module Google 
     | 
|
| 
       249 
249 
     | 
    
         
             
                        #   # Call the list_memberships method.
         
     | 
| 
       250 
250 
     | 
    
         
             
                        #   result = client.list_memberships request
         
     | 
| 
       251 
251 
     | 
    
         
             
                        #
         
     | 
| 
       252 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::PagedEnumerable. You can
         
     | 
| 
       253 
     | 
    
         
            -
                        #   #  
     | 
| 
       254 
     | 
    
         
            -
                        #    
     | 
| 
       255 
     | 
    
         
            -
                        #   # methods are also available for managing paging directly.
         
     | 
| 
       256 
     | 
    
         
            -
                        #   result.each do |response|
         
     | 
| 
      
 252 
     | 
    
         
            +
                        #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
         
     | 
| 
      
 253 
     | 
    
         
            +
                        #   # over elements, and API calls will be issued to fetch pages as needed.
         
     | 
| 
      
 254 
     | 
    
         
            +
                        #   result.each do |item|
         
     | 
| 
       257 
255 
     | 
    
         
             
                        #     # Each element is of type ::Google::Cloud::GkeHub::V1::Membership.
         
     | 
| 
       258 
     | 
    
         
            -
                        #     p  
     | 
| 
      
 256 
     | 
    
         
            +
                        #     p item
         
     | 
| 
       259 
257 
     | 
    
         
             
                        #   end
         
     | 
| 
       260 
258 
     | 
    
         
             
                        #
         
     | 
| 
       261 
259 
     | 
    
         
             
                        def list_memberships request, options = nil
         
     | 
| 
         @@ -370,13 +368,11 @@ module Google 
     | 
|
| 
       370 
368 
     | 
    
         
             
                        #   # Call the list_features method.
         
     | 
| 
       371 
369 
     | 
    
         
             
                        #   result = client.list_features request
         
     | 
| 
       372 
370 
     | 
    
         
             
                        #
         
     | 
| 
       373 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::PagedEnumerable. You can
         
     | 
| 
       374 
     | 
    
         
            -
                        #   #  
     | 
| 
       375 
     | 
    
         
            -
                        #    
     | 
| 
       376 
     | 
    
         
            -
                        #   # methods are also available for managing paging directly.
         
     | 
| 
       377 
     | 
    
         
            -
                        #   result.each do |response|
         
     | 
| 
      
 371 
     | 
    
         
            +
                        #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
         
     | 
| 
      
 372 
     | 
    
         
            +
                        #   # over elements, and API calls will be issued to fetch pages as needed.
         
     | 
| 
      
 373 
     | 
    
         
            +
                        #   result.each do |item|
         
     | 
| 
       378 
374 
     | 
    
         
             
                        #     # Each element is of type ::Google::Cloud::GkeHub::V1::Feature.
         
     | 
| 
       379 
     | 
    
         
            -
                        #     p  
     | 
| 
      
 375 
     | 
    
         
            +
                        #     p item
         
     | 
| 
       380 
376 
     | 
    
         
             
                        #   end
         
     | 
| 
       381 
377 
     | 
    
         
             
                        #
         
     | 
| 
       382 
378 
     | 
    
         
             
                        def list_features request, options = nil
         
     | 
| 
         @@ -665,14 +661,14 @@ module Google 
     | 
|
| 
       665 
661 
     | 
    
         
             
                        #   # Call the create_membership method.
         
     | 
| 
       666 
662 
     | 
    
         
             
                        #   result = client.create_membership request
         
     | 
| 
       667 
663 
     | 
    
         
             
                        #
         
     | 
| 
       668 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::Operation. You can use  
     | 
| 
       669 
     | 
    
         
            -
                        #   #  
     | 
| 
       670 
     | 
    
         
            -
                        #   #  
     | 
| 
      
 664 
     | 
    
         
            +
                        #   # The returned object is of type Gapic::Operation. You can use it to
         
     | 
| 
      
 665 
     | 
    
         
            +
                        #   # check the status of an operation, cancel it, or wait for results.
         
     | 
| 
      
 666 
     | 
    
         
            +
                        #   # Here is how to wait for a response.
         
     | 
| 
       671 
667 
     | 
    
         
             
                        #   result.wait_until_done! timeout: 60
         
     | 
| 
       672 
668 
     | 
    
         
             
                        #   if result.response?
         
     | 
| 
       673 
669 
     | 
    
         
             
                        #     p result.response
         
     | 
| 
       674 
670 
     | 
    
         
             
                        #   else
         
     | 
| 
       675 
     | 
    
         
            -
                        #     puts " 
     | 
| 
      
 671 
     | 
    
         
            +
                        #     puts "No response received."
         
     | 
| 
       676 
672 
     | 
    
         
             
                        #   end
         
     | 
| 
       677 
673 
     | 
    
         
             
                        #
         
     | 
| 
       678 
674 
     | 
    
         
             
                        def create_membership request, options = nil
         
     | 
| 
         @@ -777,14 +773,14 @@ module Google 
     | 
|
| 
       777 
773 
     | 
    
         
             
                        #   # Call the create_feature method.
         
     | 
| 
       778 
774 
     | 
    
         
             
                        #   result = client.create_feature request
         
     | 
| 
       779 
775 
     | 
    
         
             
                        #
         
     | 
| 
       780 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::Operation. You can use  
     | 
| 
       781 
     | 
    
         
            -
                        #   #  
     | 
| 
       782 
     | 
    
         
            -
                        #   #  
     | 
| 
      
 776 
     | 
    
         
            +
                        #   # The returned object is of type Gapic::Operation. You can use it to
         
     | 
| 
      
 777 
     | 
    
         
            +
                        #   # check the status of an operation, cancel it, or wait for results.
         
     | 
| 
      
 778 
     | 
    
         
            +
                        #   # Here is how to wait for a response.
         
     | 
| 
       783 
779 
     | 
    
         
             
                        #   result.wait_until_done! timeout: 60
         
     | 
| 
       784 
780 
     | 
    
         
             
                        #   if result.response?
         
     | 
| 
       785 
781 
     | 
    
         
             
                        #     p result.response
         
     | 
| 
       786 
782 
     | 
    
         
             
                        #   else
         
     | 
| 
       787 
     | 
    
         
            -
                        #     puts " 
     | 
| 
      
 783 
     | 
    
         
            +
                        #     puts "No response received."
         
     | 
| 
       788 
784 
     | 
    
         
             
                        #   end
         
     | 
| 
       789 
785 
     | 
    
         
             
                        #
         
     | 
| 
       790 
786 
     | 
    
         
             
                        def create_feature request, options = nil
         
     | 
| 
         @@ -889,14 +885,14 @@ module Google 
     | 
|
| 
       889 
885 
     | 
    
         
             
                        #   # Call the delete_membership method.
         
     | 
| 
       890 
886 
     | 
    
         
             
                        #   result = client.delete_membership request
         
     | 
| 
       891 
887 
     | 
    
         
             
                        #
         
     | 
| 
       892 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::Operation. You can use  
     | 
| 
       893 
     | 
    
         
            -
                        #   #  
     | 
| 
       894 
     | 
    
         
            -
                        #   #  
     | 
| 
      
 888 
     | 
    
         
            +
                        #   # The returned object is of type Gapic::Operation. You can use it to
         
     | 
| 
      
 889 
     | 
    
         
            +
                        #   # check the status of an operation, cancel it, or wait for results.
         
     | 
| 
      
 890 
     | 
    
         
            +
                        #   # Here is how to wait for a response.
         
     | 
| 
       895 
891 
     | 
    
         
             
                        #   result.wait_until_done! timeout: 60
         
     | 
| 
       896 
892 
     | 
    
         
             
                        #   if result.response?
         
     | 
| 
       897 
893 
     | 
    
         
             
                        #     p result.response
         
     | 
| 
       898 
894 
     | 
    
         
             
                        #   else
         
     | 
| 
       899 
     | 
    
         
            -
                        #     puts " 
     | 
| 
      
 895 
     | 
    
         
            +
                        #     puts "No response received."
         
     | 
| 
       900 
896 
     | 
    
         
             
                        #   end
         
     | 
| 
       901 
897 
     | 
    
         
             
                        #
         
     | 
| 
       902 
898 
     | 
    
         
             
                        def delete_membership request, options = nil
         
     | 
| 
         @@ -1001,14 +997,14 @@ module Google 
     | 
|
| 
       1001 
997 
     | 
    
         
             
                        #   # Call the delete_feature method.
         
     | 
| 
       1002 
998 
     | 
    
         
             
                        #   result = client.delete_feature request
         
     | 
| 
       1003 
999 
     | 
    
         
             
                        #
         
     | 
| 
       1004 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::Operation. You can use  
     | 
| 
       1005 
     | 
    
         
            -
                        #   #  
     | 
| 
       1006 
     | 
    
         
            -
                        #   #  
     | 
| 
      
 1000 
     | 
    
         
            +
                        #   # The returned object is of type Gapic::Operation. You can use it to
         
     | 
| 
      
 1001 
     | 
    
         
            +
                        #   # check the status of an operation, cancel it, or wait for results.
         
     | 
| 
      
 1002 
     | 
    
         
            +
                        #   # Here is how to wait for a response.
         
     | 
| 
       1007 
1003 
     | 
    
         
             
                        #   result.wait_until_done! timeout: 60
         
     | 
| 
       1008 
1004 
     | 
    
         
             
                        #   if result.response?
         
     | 
| 
       1009 
1005 
     | 
    
         
             
                        #     p result.response
         
     | 
| 
       1010 
1006 
     | 
    
         
             
                        #   else
         
     | 
| 
       1011 
     | 
    
         
            -
                        #     puts " 
     | 
| 
      
 1007 
     | 
    
         
            +
                        #     puts "No response received."
         
     | 
| 
       1012 
1008 
     | 
    
         
             
                        #   end
         
     | 
| 
       1013 
1009 
     | 
    
         
             
                        #
         
     | 
| 
       1014 
1010 
     | 
    
         
             
                        def delete_feature request, options = nil
         
     | 
| 
         @@ -1120,14 +1116,14 @@ module Google 
     | 
|
| 
       1120 
1116 
     | 
    
         
             
                        #   # Call the update_membership method.
         
     | 
| 
       1121 
1117 
     | 
    
         
             
                        #   result = client.update_membership request
         
     | 
| 
       1122 
1118 
     | 
    
         
             
                        #
         
     | 
| 
       1123 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::Operation. You can use  
     | 
| 
       1124 
     | 
    
         
            -
                        #   #  
     | 
| 
       1125 
     | 
    
         
            -
                        #   #  
     | 
| 
      
 1119 
     | 
    
         
            +
                        #   # The returned object is of type Gapic::Operation. You can use it to
         
     | 
| 
      
 1120 
     | 
    
         
            +
                        #   # check the status of an operation, cancel it, or wait for results.
         
     | 
| 
      
 1121 
     | 
    
         
            +
                        #   # Here is how to wait for a response.
         
     | 
| 
       1126 
1122 
     | 
    
         
             
                        #   result.wait_until_done! timeout: 60
         
     | 
| 
       1127 
1123 
     | 
    
         
             
                        #   if result.response?
         
     | 
| 
       1128 
1124 
     | 
    
         
             
                        #     p result.response
         
     | 
| 
       1129 
1125 
     | 
    
         
             
                        #   else
         
     | 
| 
       1130 
     | 
    
         
            -
                        #     puts " 
     | 
| 
      
 1126 
     | 
    
         
            +
                        #     puts "No response received."
         
     | 
| 
       1131 
1127 
     | 
    
         
             
                        #   end
         
     | 
| 
       1132 
1128 
     | 
    
         
             
                        #
         
     | 
| 
       1133 
1129 
     | 
    
         
             
                        def update_membership request, options = nil
         
     | 
| 
         @@ -1239,14 +1235,14 @@ module Google 
     | 
|
| 
       1239 
1235 
     | 
    
         
             
                        #   # Call the update_feature method.
         
     | 
| 
       1240 
1236 
     | 
    
         
             
                        #   result = client.update_feature request
         
     | 
| 
       1241 
1237 
     | 
    
         
             
                        #
         
     | 
| 
       1242 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::Operation. You can use  
     | 
| 
       1243 
     | 
    
         
            -
                        #   #  
     | 
| 
       1244 
     | 
    
         
            -
                        #   #  
     | 
| 
      
 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 " 
     | 
| 
      
 1245 
     | 
    
         
            +
                        #     puts "No response received."
         
     | 
| 
       1250 
1246 
     | 
    
         
             
                        #   end
         
     | 
| 
       1251 
1247 
     | 
    
         
             
                        #
         
     | 
| 
       1252 
1248 
     | 
    
         
             
                        def update_feature request, options = nil
         
     | 
| 
         @@ -158,13 +158,11 @@ module Google 
     | 
|
| 
       158 
158 
     | 
    
         
             
                        #   # Call the list_operations method.
         
     | 
| 
       159 
159 
     | 
    
         
             
                        #   result = client.list_operations request
         
     | 
| 
       160 
160 
     | 
    
         
             
                        #
         
     | 
| 
       161 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::PagedEnumerable. You can
         
     | 
| 
       162 
     | 
    
         
            -
                        #   #  
     | 
| 
       163 
     | 
    
         
            -
                        #    
     | 
| 
       164 
     | 
    
         
            -
                        #   # methods are also available for managing paging directly.
         
     | 
| 
       165 
     | 
    
         
            -
                        #   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|
         
     | 
| 
       166 
164 
     | 
    
         
             
                        #     # Each element is of type ::Google::Longrunning::Operation.
         
     | 
| 
       167 
     | 
    
         
            -
                        #     p  
     | 
| 
      
 165 
     | 
    
         
            +
                        #     p item
         
     | 
| 
       168 
166 
     | 
    
         
             
                        #   end
         
     | 
| 
       169 
167 
     | 
    
         
             
                        #
         
     | 
| 
       170 
168 
     | 
    
         
             
                        def list_operations request, options = nil
         
     | 
| 
         @@ -253,14 +251,14 @@ module Google 
     | 
|
| 
       253 
251 
     | 
    
         
             
                        #   # Call the get_operation method.
         
     | 
| 
       254 
252 
     | 
    
         
             
                        #   result = client.get_operation request
         
     | 
| 
       255 
253 
     | 
    
         
             
                        #
         
     | 
| 
       256 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::Operation. You can use  
     | 
| 
       257 
     | 
    
         
            -
                        #   #  
     | 
| 
       258 
     | 
    
         
            -
                        #   #  
     | 
| 
      
 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.
         
     | 
| 
       259 
257 
     | 
    
         
             
                        #   result.wait_until_done! timeout: 60
         
     | 
| 
       260 
258 
     | 
    
         
             
                        #   if result.response?
         
     | 
| 
       261 
259 
     | 
    
         
             
                        #     p result.response
         
     | 
| 
       262 
260 
     | 
    
         
             
                        #   else
         
     | 
| 
       263 
     | 
    
         
            -
                        #     puts " 
     | 
| 
      
 261 
     | 
    
         
            +
                        #     puts "No response received."
         
     | 
| 
       264 
262 
     | 
    
         
             
                        #   end
         
     | 
| 
       265 
263 
     | 
    
         
             
                        #
         
     | 
| 
       266 
264 
     | 
    
         
             
                        def get_operation request, options = nil
         
     | 
| 
         @@ -540,14 +538,14 @@ module Google 
     | 
|
| 
       540 
538 
     | 
    
         
             
                        #   # Call the wait_operation method.
         
     | 
| 
       541 
539 
     | 
    
         
             
                        #   result = client.wait_operation request
         
     | 
| 
       542 
540 
     | 
    
         
             
                        #
         
     | 
| 
       543 
     | 
    
         
            -
                        #   # The returned object is of type Gapic::Operation. You can use  
     | 
| 
       544 
     | 
    
         
            -
                        #   #  
     | 
| 
       545 
     | 
    
         
            -
                        #   #  
     | 
| 
      
 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.
         
     | 
| 
       546 
544 
     | 
    
         
             
                        #   result.wait_until_done! timeout: 60
         
     | 
| 
       547 
545 
     | 
    
         
             
                        #   if result.response?
         
     | 
| 
       548 
546 
     | 
    
         
             
                        #     p result.response
         
     | 
| 
       549 
547 
     | 
    
         
             
                        #   else
         
     | 
| 
       550 
     | 
    
         
            -
                        #     puts " 
     | 
| 
      
 548 
     | 
    
         
            +
                        #     puts "No response received."
         
     | 
| 
       551 
549 
     | 
    
         
             
                        #   end
         
     | 
| 
       552 
550 
     | 
    
         
             
                        #
         
     | 
| 
       553 
551 
     | 
    
         
             
                        def wait_operation request, options = nil
         
     |