Storage Control Update Anywhere Cache

  namespace 
  
 storagecontrol 
  
 = 
  
 google 
 :: 
 cloud 
 :: 
 storagecontrol_v2 
 ; 
 []( 
 storagecontrol 
 :: 
 StorageControlClient 
  
 client 
 , 
  
 std 
 :: 
 string 
  
 const 
&  
 cache_name 
 , 
  
 std 
 :: 
 string 
  
 const 
&  
 admission_policy 
 ) 
  
 { 
  
 google 
 :: 
 storage 
 :: 
 control 
 :: 
 v2 
 :: 
 AnywhereCache 
  
 cache 
 ; 
  
 google 
 :: 
 protobuf 
 :: 
 FieldMask 
  
 field_mask 
 ; 
  
 field_mask 
 . 
 add_paths 
 ( 
 "admission_policy" 
 ); 
  
 cache 
 . 
 set_name 
 ( 
 cache_name 
 ); 
  
 cache 
 . 
 set_admission_policy 
 ( 
 admission_policy 
 ); 
  
 // Start an update operation and block until it completes. Real applications 
  
 // may want to setup a callback, wait on a coroutine, or poll until it 
  
 // completes. 
  
 auto 
  
 anywhere_cache 
  
 = 
  
 client 
 . 
 UpdateAnywhereCache 
 ( 
 cache 
 , 
  
 field_mask 
 ). 
 get 
 (); 
  
 if 
  
 ( 
 ! 
 anywhere_cache 
 ) 
  
 throw 
  
 std 
 :: 
 move 
 ( 
 anywhere_cache 
 ). 
 status 
 (); 
  
 std 
 :: 
 cout 
 << 
 "Updated anywhere cache: " 
 << 
 anywhere_cache 
 - 
> name 
 () 
 << 
 " 
 \n 
 " 
 ; 
 } 
 

  import 
  
 com.google.api.gax.longrunning. OperationFuture 
 
 ; 
 import 
  
 com.google.protobuf. FieldMask 
 
 ; 
 import 
  
 com.google.storage.control.v2. AnywhereCache 
 
 ; 
 import 
  
 com.google.storage.control.v2. StorageControlClient 
 
 ; 
 import 
  
 com.google.storage.control.v2. UpdateAnywhereCacheMetadata 
 
 ; 
 import 
  
 com.google.storage.control.v2. UpdateAnywhereCacheRequest 
 
 ; 
 import 
  
 java.io.IOException 
 ; 
 import 
  
 java.util.concurrent.ExecutionException 
 ; 
 public 
  
 final 
  
 class 
 AnywhereCacheUpdate 
  
 { 
  
 public 
  
 static 
  
 void 
  
 anywhereCacheUpdate 
 ( 
 String 
  
 cacheName 
 , 
  
 String 
  
 admissionPolicy 
 ) 
  
 throws 
  
 InterruptedException 
 , 
  
 ExecutionException 
 , 
  
 IOException 
  
 { 
  
 try 
  
 ( 
  StorageControlClient 
 
  
 storageControl 
  
 = 
  
  StorageControlClient 
 
 . 
 create 
 ()) 
  
 { 
  
  AnywhereCache 
 
  
 pendingUpdate 
  
 = 
  
  AnywhereCache 
 
 . 
 newBuilder 
 (). 
 setName 
 ( 
 cacheName 
 ). 
 setAdmissionPolicy 
 ( 
 admissionPolicy 
 ). 
 build 
 (); 
  
  UpdateAnywhereCacheRequest 
 
  
 request 
  
 = 
  
  UpdateAnywhereCacheRequest 
 
 . 
 newBuilder 
 () 
  
 . 
 setAnywhereCache 
 ( 
 pendingUpdate 
 ) 
  
 . 
 setUpdateMask 
 ( 
  FieldMask 
 
 . 
 newBuilder 
 (). 
  addPaths 
 
 ( 
 "admission_policy" 
 ). 
 build 
 ()) 
  
 . 
 build 
 (); 
  
 // Start a long-running operation (LRO). 
  
 OperationFuture<AnywhereCache 
 , 
  
 UpdateAnywhereCacheMetadata 
>  
 operation 
  
 = 
  
 storageControl 
 . 
  updateAnywhereCacheAsync 
 
 ( 
 request 
 ); 
  
 // Await the LROs completion. 
  
  AnywhereCache 
 
  
 updatedAnywhereCache 
  
 = 
  
 operation 
 . 
 get 
 (); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Updated anywhere cache: %s%n" 
 , 
  
 updatedAnywhereCache 
 . 
  getName 
 
 ()); 
  
 } 
  
 } 
 } 
 

  use Google\Cloud\Storage\Control\V2\AnywhereCache; 
 use Google\Cloud\Storage\Control\V2\Client\StorageControlClient; 
 use Google\Cloud\Storage\Control\V2\UpdateAnywhereCacheRequest; 
 use Google\Protobuf\FieldMask; 
 /** 
 * Updates an Anywhere Cache instance. 
 * 
 * @param string $bucketName The name of your Cloud Storage bucket. 
 *        (e.g. 'my-bucket') 
 * @param string $anywhereCacheId Uniquely identifies the cache. 
 *        (e.g. 'us-east1-b') 
 * @param string $admission_policy The cache's admission policy. 
 *        (e.g. 'admit-on-first-miss') 
 */ 
 function update_anywhere_cache(string $bucketName, string $anywhereCacheId, string $admission_policy): void 
 { 
 $storageControlClient = new StorageControlClient(); 
 // Set project to "_" to signify global bucket 
 $formattedName = $storageControlClient->anywhereCacheName('_', $bucketName, $anywhereCacheId); 
 $anywhereCache = new AnywhereCache([ 
 'name' => $formattedName, 
 'admission_policy' => $admission_policy, 
 ]); 
 $updateMask = new FieldMask([ 
 'paths' => ['admission_policy'], 
 ]); 
 $request = new UpdateAnywhereCacheRequest([ 
 'anywhere_cache' => $anywhereCache, 
 'update_mask' => $updateMask, 
 ]); 
 // Start an update operation. This returns an Operation object which can be polled. 
 $operation = $storageControlClient->updateAnywhereCache($request); 
 printf('Waiting for operation %s to complete...' . PHP_EOL, $operation->getName()); 
 $operation->pollUntilComplete([ 
 'totalPollTimeoutMillis' => 5400000, 
 'initialPollDelayMillis' => 1000, // Start with 1 second delay 
 'pollDelayMultiplier' => 2,      // Double delay each time 
 'maxPollDelayMillis' => 60000,   // Max 60 seconds delay between polls 
 ]); 
 $anywhereCacheResult = $operation->getResult(); 
 printf('Updated anywhere cache: %s', $anywhereCacheResult->getName()); 
 } 
 

  require 
  
 "google/cloud/storage/control" 
 # Updates an existing Anywhere Cache for a specified 
 # bucket. After initiating the update, it polls the cache's status with 
 # exponential backoff until the cache state becomes "running". 
 # 
 # @param bucket_name [String] The name of the GCS bucket containing the cache. 
 # @param anywhere_cache_id [String] The unique identifier for the Anywhere Cache. 
 #   e.g. "us-east1-b" 
 # 
 # @example 
 #   update_anywhere_cache( 
 #     bucket_name: "your-unique-bucket-name", 
 #     anywhere_cache_id: "us-east1-b" 
 #   ) 
 # 
 def 
  
 update_anywhere_cache 
  
 bucket_name 
 :, 
  
 anywhere_cache_id 
 : 
  
 # Create a client object. The client can be reused for multiple calls. 
  
 storage_control_client 
  
 = 
  
 Google 
 :: 
 Cloud 
 :: 
 Storage 
 :: 
 Control 
 . 
 storage_control 
  
 # Set project to "_" to signify global bucket 
  
 parent 
  
 = 
  
 "projects/_/buckets/ 
 #{ 
 bucket_name 
 } 
 " 
  
 name 
  
 = 
  
 " 
 #{ 
 parent 
 } 
 /anywhereCaches/ 
 #{ 
 anywhere_cache_id 
 } 
 " 
  
 ttl_in_seconds 
  
 = 
  
 7200 
  
 anywhere_cache 
  
 = 
  
 Google 
 :: 
 Cloud 
 :: 
 Storage 
 :: 
 Control 
 :: 
 V2 
 :: 
 AnywhereCache 
 . 
 new 
 ( 
  
 name 
 : 
  
 name 
 , 
  
 ttl 
 : 
  
 ttl_in_seconds 
  
 ) 
  
 mask 
  
 = 
  
 Google 
 :: 
 Protobuf 
 :: 
  FieldMask 
 
 . 
 new 
  
 paths 
 : 
  
 [ 
 "ttl" 
 ] 
  
 # Create a request. 
  
 request 
  
 = 
  
 Google 
 :: 
 Cloud 
 :: 
 Storage 
 :: 
 Control 
 :: 
 V2 
 :: 
 UpdateAnywhereCacheRequest 
 . 
 new 
 ( 
  
 anywhere_cache 
 : 
  
 anywhere_cache 
 , 
  
 update_mask 
 : 
  
 mask 
  
 ) 
  
 # The request updates the cache in the specified bucket. 
  
 # The cache is identified by the specified ID. 
  
 begin 
  
 operation 
  
 = 
  
 storage_control_client 
 . 
 update_anywhere_cache 
  
 request 
  
 puts 
  
 "AnywhereCache operation created - 
 #{ 
 operation 
 . 
 name 
 } 
 " 
  
 get_request 
  
 = 
  
 Google 
 :: 
 Cloud 
 :: 
 Storage 
 :: 
 Control 
 :: 
 V2 
 :: 
 GetAnywhereCacheRequest 
 . 
 new 
 ( 
  
 name 
 : 
  
 name 
  
 ) 
  
 result 
  
 = 
  
 storage_control_client 
 . 
 get_anywhere_cache 
  
 get_request 
  
 min_delay 
  
 = 
  
 30 
  
 # 30 seconds 
  
 max_delay 
  
 = 
  
 600 
  
 # 10 minutes 
  
 while 
  
 result 
 . 
 state 
& . 
 downcase 
  
 != 
  
 "running" 
  
 unless 
  
 [ 
 "paused" 
 , 
  
 "disabled" 
 , 
  
 "creating" 
 ]. 
 include? 
  
 result 
 . 
 state 
& . 
 downcase 
  
 raise 
  
 Google 
 :: 
 Cloud 
 :: 
 Error 
 , 
  
 "AnywhereCache operation failed on the backend with state 
 #{ 
 result 
 . 
 state 
& . 
 downcase 
 } 
 ." 
  
 end 
  
 puts 
  
 "Cache not running yet, current state is 
 #{ 
 result 
 . 
 state 
& . 
 downcase 
 } 
 . Retrying in 
 #{ 
 min_delay 
 } 
 seconds." 
  
 sleep 
  
 min_delay 
  
 min_delay 
  
 = 
  
 [ 
 min_delay 
  
 * 
  
 2 
 , 
  
 max_delay 
 ]. 
 min 
  
 # Exponential backoff with a max delay 
  
 result 
  
 = 
  
 storage_control_client 
 . 
 get_anywhere_cache 
  
 get_request 
  
 end 
  
 puts 
  
 "Successfully updated anywhereCache - 
 #{ 
 result 
 . 
 name 
 } 
 ." 
  
 rescue 
  
 Google 
 :: 
 Cloud 
 :: 
 Error 
  
 = 
>  
 e 
  
 puts 
  
 "Failed to update AnywhereCache. Error: 
 #{ 
 e 
 . 
 message 
 } 
 " 
  
 end 
 end