google-apis-logging_v2 0.39.0 → 0.41.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -440,6 +440,47 @@ module Google
440
440
  execute_or_queue_command(command, &block)
441
441
  end
442
442
 
443
+ # Creates a log bucket asynchronously that can be used to store log entries.
444
+ # After a bucket has been created, the bucket's location cannot be changed.
445
+ # @param [String] parent
446
+ # Required. The resource in which to create the log bucket: "projects/[
447
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
448
+ # locations/global"
449
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
450
+ # @param [String] bucket_id
451
+ # Required. A client-assigned identifier such as "my-bucket". Identifiers are
452
+ # limited to 100 characters and can include only letters, digits, underscores,
453
+ # hyphens, and periods.
454
+ # @param [String] fields
455
+ # Selector specifying which fields to include in a partial response.
456
+ # @param [String] quota_user
457
+ # Available to use for quota purposes for server-side applications. Can be any
458
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
459
+ # @param [Google::Apis::RequestOptions] options
460
+ # Request-specific options
461
+ #
462
+ # @yield [result, err] Result & error if block supplied
463
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
464
+ # @yieldparam err [StandardError] error object if request failed
465
+ #
466
+ # @return [Google::Apis::LoggingV2::Operation]
467
+ #
468
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
469
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
470
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
471
+ def create_billing_account_location_bucket_async(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
472
+ command = make_simple_command(:post, 'v2/{+parent}/buckets:createAsync', options)
473
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
474
+ command.request_object = log_bucket_object
475
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
476
+ command.response_class = Google::Apis::LoggingV2::Operation
477
+ command.params['parent'] = parent unless parent.nil?
478
+ command.query['bucketId'] = bucket_id unless bucket_id.nil?
479
+ command.query['fields'] = fields unless fields.nil?
480
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
481
+ execute_or_queue_command(command, &block)
482
+ end
483
+
443
484
  # Deletes a log bucket.Changes the bucket's lifecycle_state to the
444
485
  # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
445
486
  # entries in the bucket will be permanently deleted.
@@ -558,11 +599,8 @@ module Google
558
599
  execute_or_queue_command(command, &block)
559
600
  end
560
601
 
561
- # Updates a log bucket. This method replaces the following fields in the
562
- # existing bucket with values from the new bucket: retention_periodIf the
563
- # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
564
- # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
565
- # FAILED_PRECONDITION will be returned.After a bucket has been created, the
602
+ # Updates a log bucket.If the bucket has a lifecycle_state of DELETE_REQUESTED,
603
+ # then FAILED_PRECONDITION will be returned.After a bucket has been created, the
566
604
  # bucket's location cannot be changed.
567
605
  # @param [String] name
568
606
  # Required. The full resource name of the bucket to update. "projects/[
@@ -648,6 +686,210 @@ module Google
648
686
  execute_or_queue_command(command, &block)
649
687
  end
650
688
 
689
+ # Updates a log bucket asynchronously.If the bucket has a lifecycle_state of
690
+ # DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has
691
+ # been created, the bucket's location cannot be changed.
692
+ # @param [String] name
693
+ # Required. The full resource name of the bucket to update. "projects/[
694
+ # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
695
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
696
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
697
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
698
+ # my-project/locations/global/buckets/my-bucket"
699
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
700
+ # @param [String] update_mask
701
+ # Required. Field mask that specifies the fields in bucket that need an update.
702
+ # A bucket field will be overwritten if, and only if, it is in the update mask.
703
+ # name and output only fields cannot be updated.For a detailed FieldMask
704
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
705
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
706
+ # retention_days
707
+ # @param [String] fields
708
+ # Selector specifying which fields to include in a partial response.
709
+ # @param [String] quota_user
710
+ # Available to use for quota purposes for server-side applications. Can be any
711
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
712
+ # @param [Google::Apis::RequestOptions] options
713
+ # Request-specific options
714
+ #
715
+ # @yield [result, err] Result & error if block supplied
716
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
717
+ # @yieldparam err [StandardError] error object if request failed
718
+ #
719
+ # @return [Google::Apis::LoggingV2::Operation]
720
+ #
721
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
722
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
723
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
724
+ def update_billing_account_location_bucket_async(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
725
+ command = make_simple_command(:post, 'v2/{+name}:updateAsync', options)
726
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
727
+ command.request_object = log_bucket_object
728
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
729
+ command.response_class = Google::Apis::LoggingV2::Operation
730
+ command.params['name'] = name unless name.nil?
731
+ command.query['updateMask'] = update_mask unless update_mask.nil?
732
+ command.query['fields'] = fields unless fields.nil?
733
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
734
+ execute_or_queue_command(command, &block)
735
+ end
736
+
737
+ # Asynchronously creates linked dataset in BigQuery which makes it possible to
738
+ # use BugQuery to read the logs stored in the bucket. A bucket may currently
739
+ # only contain one link.
740
+ # @param [String] parent
741
+ # Required. The full resource name of the bucket to create a link for. "projects/
742
+ # [PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
743
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
744
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
745
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
746
+ # @param [Google::Apis::LoggingV2::Link] link_object
747
+ # @param [String] link_id
748
+ # Required. The ID to use for the link. The link_id can have up to 100
749
+ # characters. A valid link_id must only have alphanumeric characters and
750
+ # underscores within it.
751
+ # @param [String] fields
752
+ # Selector specifying which fields to include in a partial response.
753
+ # @param [String] quota_user
754
+ # Available to use for quota purposes for server-side applications. Can be any
755
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
756
+ # @param [Google::Apis::RequestOptions] options
757
+ # Request-specific options
758
+ #
759
+ # @yield [result, err] Result & error if block supplied
760
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
761
+ # @yieldparam err [StandardError] error object if request failed
762
+ #
763
+ # @return [Google::Apis::LoggingV2::Operation]
764
+ #
765
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
766
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
767
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
768
+ def create_billing_account_location_bucket_link(parent, link_object = nil, link_id: nil, fields: nil, quota_user: nil, options: nil, &block)
769
+ command = make_simple_command(:post, 'v2/{+parent}/links', options)
770
+ command.request_representation = Google::Apis::LoggingV2::Link::Representation
771
+ command.request_object = link_object
772
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
773
+ command.response_class = Google::Apis::LoggingV2::Operation
774
+ command.params['parent'] = parent unless parent.nil?
775
+ command.query['linkId'] = link_id unless link_id.nil?
776
+ command.query['fields'] = fields unless fields.nil?
777
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
778
+ execute_or_queue_command(command, &block)
779
+ end
780
+
781
+ # Deletes a link. This will also delete the corresponding BigQuery linked
782
+ # dataset.
783
+ # @param [String] name
784
+ # Required. The full resource name of the link to delete."projects/PROJECT_ID/
785
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/
786
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
787
+ # billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
788
+ # links/LINK_ID" "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
789
+ # links/LINK_ID"
790
+ # @param [String] fields
791
+ # Selector specifying which fields to include in a partial response.
792
+ # @param [String] quota_user
793
+ # Available to use for quota purposes for server-side applications. Can be any
794
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
795
+ # @param [Google::Apis::RequestOptions] options
796
+ # Request-specific options
797
+ #
798
+ # @yield [result, err] Result & error if block supplied
799
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
800
+ # @yieldparam err [StandardError] error object if request failed
801
+ #
802
+ # @return [Google::Apis::LoggingV2::Operation]
803
+ #
804
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
805
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
806
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
807
+ def delete_billing_account_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
808
+ command = make_simple_command(:delete, 'v2/{+name}', options)
809
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
810
+ command.response_class = Google::Apis::LoggingV2::Operation
811
+ command.params['name'] = name unless name.nil?
812
+ command.query['fields'] = fields unless fields.nil?
813
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
814
+ execute_or_queue_command(command, &block)
815
+ end
816
+
817
+ # Gets a link.
818
+ # @param [String] name
819
+ # Required. The resource name of the link:"projects/PROJECT_ID/locations/
820
+ # LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/ORGANIZATION_ID/
821
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/
822
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
823
+ # folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
824
+ # @param [String] fields
825
+ # Selector specifying which fields to include in a partial response.
826
+ # @param [String] quota_user
827
+ # Available to use for quota purposes for server-side applications. Can be any
828
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
829
+ # @param [Google::Apis::RequestOptions] options
830
+ # Request-specific options
831
+ #
832
+ # @yield [result, err] Result & error if block supplied
833
+ # @yieldparam result [Google::Apis::LoggingV2::Link] parsed result object
834
+ # @yieldparam err [StandardError] error object if request failed
835
+ #
836
+ # @return [Google::Apis::LoggingV2::Link]
837
+ #
838
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
839
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
840
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
841
+ def get_billing_account_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
842
+ command = make_simple_command(:get, 'v2/{+name}', options)
843
+ command.response_representation = Google::Apis::LoggingV2::Link::Representation
844
+ command.response_class = Google::Apis::LoggingV2::Link
845
+ command.params['name'] = name unless name.nil?
846
+ command.query['fields'] = fields unless fields.nil?
847
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
848
+ execute_or_queue_command(command, &block)
849
+ end
850
+
851
+ # Lists links.
852
+ # @param [String] parent
853
+ # Required. The parent resource whose links are to be listed:"projects/
854
+ # PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/" "organizations/
855
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/
856
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "folders/
857
+ # FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
858
+ # @param [Fixnum] page_size
859
+ # Optional. The maximum number of results to return from this request.
860
+ # @param [String] page_token
861
+ # Optional. If present, then retrieve the next batch of results from the
862
+ # preceding call to this method. pageToken must be the value of nextPageToken
863
+ # from the previous response.
864
+ # @param [String] fields
865
+ # Selector specifying which fields to include in a partial response.
866
+ # @param [String] quota_user
867
+ # Available to use for quota purposes for server-side applications. Can be any
868
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
869
+ # @param [Google::Apis::RequestOptions] options
870
+ # Request-specific options
871
+ #
872
+ # @yield [result, err] Result & error if block supplied
873
+ # @yieldparam result [Google::Apis::LoggingV2::ListLinksResponse] parsed result object
874
+ # @yieldparam err [StandardError] error object if request failed
875
+ #
876
+ # @return [Google::Apis::LoggingV2::ListLinksResponse]
877
+ #
878
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
879
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
880
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
881
+ def list_billing_account_location_bucket_links(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
882
+ command = make_simple_command(:get, 'v2/{+parent}/links', options)
883
+ command.response_representation = Google::Apis::LoggingV2::ListLinksResponse::Representation
884
+ command.response_class = Google::Apis::LoggingV2::ListLinksResponse
885
+ command.params['parent'] = parent unless parent.nil?
886
+ command.query['pageSize'] = page_size unless page_size.nil?
887
+ command.query['pageToken'] = page_token unless page_token.nil?
888
+ command.query['fields'] = fields unless fields.nil?
889
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
890
+ execute_or_queue_command(command, &block)
891
+ end
892
+
651
893
  # Creates a view over log entries in a log bucket. A bucket may contain a
652
894
  # maximum of 30 views.
653
895
  # @param [String] parent
@@ -2149,6 +2391,47 @@ module Google
2149
2391
  execute_or_queue_command(command, &block)
2150
2392
  end
2151
2393
 
2394
+ # Creates a log bucket asynchronously that can be used to store log entries.
2395
+ # After a bucket has been created, the bucket's location cannot be changed.
2396
+ # @param [String] parent
2397
+ # Required. The resource in which to create the log bucket: "projects/[
2398
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
2399
+ # locations/global"
2400
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2401
+ # @param [String] bucket_id
2402
+ # Required. A client-assigned identifier such as "my-bucket". Identifiers are
2403
+ # limited to 100 characters and can include only letters, digits, underscores,
2404
+ # hyphens, and periods.
2405
+ # @param [String] fields
2406
+ # Selector specifying which fields to include in a partial response.
2407
+ # @param [String] quota_user
2408
+ # Available to use for quota purposes for server-side applications. Can be any
2409
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2410
+ # @param [Google::Apis::RequestOptions] options
2411
+ # Request-specific options
2412
+ #
2413
+ # @yield [result, err] Result & error if block supplied
2414
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
2415
+ # @yieldparam err [StandardError] error object if request failed
2416
+ #
2417
+ # @return [Google::Apis::LoggingV2::Operation]
2418
+ #
2419
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2420
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2421
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2422
+ def create_folder_location_bucket_async(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2423
+ command = make_simple_command(:post, 'v2/{+parent}/buckets:createAsync', options)
2424
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
2425
+ command.request_object = log_bucket_object
2426
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
2427
+ command.response_class = Google::Apis::LoggingV2::Operation
2428
+ command.params['parent'] = parent unless parent.nil?
2429
+ command.query['bucketId'] = bucket_id unless bucket_id.nil?
2430
+ command.query['fields'] = fields unless fields.nil?
2431
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2432
+ execute_or_queue_command(command, &block)
2433
+ end
2434
+
2152
2435
  # Deletes a log bucket.Changes the bucket's lifecycle_state to the
2153
2436
  # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
2154
2437
  # entries in the bucket will be permanently deleted.
@@ -2267,11 +2550,8 @@ module Google
2267
2550
  execute_or_queue_command(command, &block)
2268
2551
  end
2269
2552
 
2270
- # Updates a log bucket. This method replaces the following fields in the
2271
- # existing bucket with values from the new bucket: retention_periodIf the
2272
- # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
2273
- # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
2274
- # FAILED_PRECONDITION will be returned.After a bucket has been created, the
2553
+ # Updates a log bucket.If the bucket has a lifecycle_state of DELETE_REQUESTED,
2554
+ # then FAILED_PRECONDITION will be returned.After a bucket has been created, the
2275
2555
  # bucket's location cannot be changed.
2276
2556
  # @param [String] name
2277
2557
  # Required. The full resource name of the bucket to update. "projects/[
@@ -2357,17 +2637,24 @@ module Google
2357
2637
  execute_or_queue_command(command, &block)
2358
2638
  end
2359
2639
 
2360
- # Creates a view over log entries in a log bucket. A bucket may contain a
2361
- # maximum of 30 views.
2362
- # @param [String] parent
2363
- # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
2364
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
2365
- # locations/global/buckets/my-bucket"
2366
- # @param [Google::Apis::LoggingV2::LogView] log_view_object
2367
- # @param [String] view_id
2368
- # Required. A client-assigned identifier such as "my-view". Identifiers are
2369
- # limited to 100 characters and can include only letters, digits, underscores,
2370
- # hyphens, and periods.
2640
+ # Updates a log bucket asynchronously.If the bucket has a lifecycle_state of
2641
+ # DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has
2642
+ # been created, the bucket's location cannot be changed.
2643
+ # @param [String] name
2644
+ # Required. The full resource name of the bucket to update. "projects/[
2645
+ # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2646
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2647
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
2648
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2649
+ # my-project/locations/global/buckets/my-bucket"
2650
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2651
+ # @param [String] update_mask
2652
+ # Required. Field mask that specifies the fields in bucket that need an update.
2653
+ # A bucket field will be overwritten if, and only if, it is in the update mask.
2654
+ # name and output only fields cannot be updated.For a detailed FieldMask
2655
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
2656
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2657
+ # retention_days
2371
2658
  # @param [String] fields
2372
2659
  # Selector specifying which fields to include in a partial response.
2373
2660
  # @param [String] quota_user
@@ -2377,15 +2664,212 @@ module Google
2377
2664
  # Request-specific options
2378
2665
  #
2379
2666
  # @yield [result, err] Result & error if block supplied
2380
- # @yieldparam result [Google::Apis::LoggingV2::LogView] parsed result object
2667
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
2381
2668
  # @yieldparam err [StandardError] error object if request failed
2382
2669
  #
2383
- # @return [Google::Apis::LoggingV2::LogView]
2670
+ # @return [Google::Apis::LoggingV2::Operation]
2384
2671
  #
2385
2672
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2386
2673
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2387
2674
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2388
- def create_folder_location_bucket_view(parent, log_view_object = nil, view_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2675
+ def update_folder_location_bucket_async(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2676
+ command = make_simple_command(:post, 'v2/{+name}:updateAsync', options)
2677
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
2678
+ command.request_object = log_bucket_object
2679
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
2680
+ command.response_class = Google::Apis::LoggingV2::Operation
2681
+ command.params['name'] = name unless name.nil?
2682
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2683
+ command.query['fields'] = fields unless fields.nil?
2684
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2685
+ execute_or_queue_command(command, &block)
2686
+ end
2687
+
2688
+ # Asynchronously creates linked dataset in BigQuery which makes it possible to
2689
+ # use BugQuery to read the logs stored in the bucket. A bucket may currently
2690
+ # only contain one link.
2691
+ # @param [String] parent
2692
+ # Required. The full resource name of the bucket to create a link for. "projects/
2693
+ # [PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2694
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2695
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
2696
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
2697
+ # @param [Google::Apis::LoggingV2::Link] link_object
2698
+ # @param [String] link_id
2699
+ # Required. The ID to use for the link. The link_id can have up to 100
2700
+ # characters. A valid link_id must only have alphanumeric characters and
2701
+ # underscores within it.
2702
+ # @param [String] fields
2703
+ # Selector specifying which fields to include in a partial response.
2704
+ # @param [String] quota_user
2705
+ # Available to use for quota purposes for server-side applications. Can be any
2706
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2707
+ # @param [Google::Apis::RequestOptions] options
2708
+ # Request-specific options
2709
+ #
2710
+ # @yield [result, err] Result & error if block supplied
2711
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
2712
+ # @yieldparam err [StandardError] error object if request failed
2713
+ #
2714
+ # @return [Google::Apis::LoggingV2::Operation]
2715
+ #
2716
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2717
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2718
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2719
+ def create_folder_location_bucket_link(parent, link_object = nil, link_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2720
+ command = make_simple_command(:post, 'v2/{+parent}/links', options)
2721
+ command.request_representation = Google::Apis::LoggingV2::Link::Representation
2722
+ command.request_object = link_object
2723
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
2724
+ command.response_class = Google::Apis::LoggingV2::Operation
2725
+ command.params['parent'] = parent unless parent.nil?
2726
+ command.query['linkId'] = link_id unless link_id.nil?
2727
+ command.query['fields'] = fields unless fields.nil?
2728
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2729
+ execute_or_queue_command(command, &block)
2730
+ end
2731
+
2732
+ # Deletes a link. This will also delete the corresponding BigQuery linked
2733
+ # dataset.
2734
+ # @param [String] name
2735
+ # Required. The full resource name of the link to delete."projects/PROJECT_ID/
2736
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/
2737
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
2738
+ # billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
2739
+ # links/LINK_ID" "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
2740
+ # links/LINK_ID"
2741
+ # @param [String] fields
2742
+ # Selector specifying which fields to include in a partial response.
2743
+ # @param [String] quota_user
2744
+ # Available to use for quota purposes for server-side applications. Can be any
2745
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2746
+ # @param [Google::Apis::RequestOptions] options
2747
+ # Request-specific options
2748
+ #
2749
+ # @yield [result, err] Result & error if block supplied
2750
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
2751
+ # @yieldparam err [StandardError] error object if request failed
2752
+ #
2753
+ # @return [Google::Apis::LoggingV2::Operation]
2754
+ #
2755
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2756
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2757
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2758
+ def delete_folder_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
2759
+ command = make_simple_command(:delete, 'v2/{+name}', options)
2760
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
2761
+ command.response_class = Google::Apis::LoggingV2::Operation
2762
+ command.params['name'] = name unless name.nil?
2763
+ command.query['fields'] = fields unless fields.nil?
2764
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2765
+ execute_or_queue_command(command, &block)
2766
+ end
2767
+
2768
+ # Gets a link.
2769
+ # @param [String] name
2770
+ # Required. The resource name of the link:"projects/PROJECT_ID/locations/
2771
+ # LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/ORGANIZATION_ID/
2772
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/
2773
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
2774
+ # folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
2775
+ # @param [String] fields
2776
+ # Selector specifying which fields to include in a partial response.
2777
+ # @param [String] quota_user
2778
+ # Available to use for quota purposes for server-side applications. Can be any
2779
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2780
+ # @param [Google::Apis::RequestOptions] options
2781
+ # Request-specific options
2782
+ #
2783
+ # @yield [result, err] Result & error if block supplied
2784
+ # @yieldparam result [Google::Apis::LoggingV2::Link] parsed result object
2785
+ # @yieldparam err [StandardError] error object if request failed
2786
+ #
2787
+ # @return [Google::Apis::LoggingV2::Link]
2788
+ #
2789
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2790
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2791
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2792
+ def get_folder_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
2793
+ command = make_simple_command(:get, 'v2/{+name}', options)
2794
+ command.response_representation = Google::Apis::LoggingV2::Link::Representation
2795
+ command.response_class = Google::Apis::LoggingV2::Link
2796
+ command.params['name'] = name unless name.nil?
2797
+ command.query['fields'] = fields unless fields.nil?
2798
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2799
+ execute_or_queue_command(command, &block)
2800
+ end
2801
+
2802
+ # Lists links.
2803
+ # @param [String] parent
2804
+ # Required. The parent resource whose links are to be listed:"projects/
2805
+ # PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/" "organizations/
2806
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/
2807
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "folders/
2808
+ # FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
2809
+ # @param [Fixnum] page_size
2810
+ # Optional. The maximum number of results to return from this request.
2811
+ # @param [String] page_token
2812
+ # Optional. If present, then retrieve the next batch of results from the
2813
+ # preceding call to this method. pageToken must be the value of nextPageToken
2814
+ # from the previous response.
2815
+ # @param [String] fields
2816
+ # Selector specifying which fields to include in a partial response.
2817
+ # @param [String] quota_user
2818
+ # Available to use for quota purposes for server-side applications. Can be any
2819
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2820
+ # @param [Google::Apis::RequestOptions] options
2821
+ # Request-specific options
2822
+ #
2823
+ # @yield [result, err] Result & error if block supplied
2824
+ # @yieldparam result [Google::Apis::LoggingV2::ListLinksResponse] parsed result object
2825
+ # @yieldparam err [StandardError] error object if request failed
2826
+ #
2827
+ # @return [Google::Apis::LoggingV2::ListLinksResponse]
2828
+ #
2829
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2830
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2831
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2832
+ def list_folder_location_bucket_links(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2833
+ command = make_simple_command(:get, 'v2/{+parent}/links', options)
2834
+ command.response_representation = Google::Apis::LoggingV2::ListLinksResponse::Representation
2835
+ command.response_class = Google::Apis::LoggingV2::ListLinksResponse
2836
+ command.params['parent'] = parent unless parent.nil?
2837
+ command.query['pageSize'] = page_size unless page_size.nil?
2838
+ command.query['pageToken'] = page_token unless page_token.nil?
2839
+ command.query['fields'] = fields unless fields.nil?
2840
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2841
+ execute_or_queue_command(command, &block)
2842
+ end
2843
+
2844
+ # Creates a view over log entries in a log bucket. A bucket may contain a
2845
+ # maximum of 30 views.
2846
+ # @param [String] parent
2847
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
2848
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
2849
+ # locations/global/buckets/my-bucket"
2850
+ # @param [Google::Apis::LoggingV2::LogView] log_view_object
2851
+ # @param [String] view_id
2852
+ # Required. A client-assigned identifier such as "my-view". Identifiers are
2853
+ # limited to 100 characters and can include only letters, digits, underscores,
2854
+ # hyphens, and periods.
2855
+ # @param [String] fields
2856
+ # Selector specifying which fields to include in a partial response.
2857
+ # @param [String] quota_user
2858
+ # Available to use for quota purposes for server-side applications. Can be any
2859
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2860
+ # @param [Google::Apis::RequestOptions] options
2861
+ # Request-specific options
2862
+ #
2863
+ # @yield [result, err] Result & error if block supplied
2864
+ # @yieldparam result [Google::Apis::LoggingV2::LogView] parsed result object
2865
+ # @yieldparam err [StandardError] error object if request failed
2866
+ #
2867
+ # @return [Google::Apis::LoggingV2::LogView]
2868
+ #
2869
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2870
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2871
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2872
+ def create_folder_location_bucket_view(parent, log_view_object = nil, view_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2389
2873
  command = make_simple_command(:post, 'v2/{+parent}/views', options)
2390
2874
  command.request_representation = Google::Apis::LoggingV2::LogView::Representation
2391
2875
  command.request_object = log_view_object
@@ -3209,6 +3693,47 @@ module Google
3209
3693
  execute_or_queue_command(command, &block)
3210
3694
  end
3211
3695
 
3696
+ # Creates a log bucket asynchronously that can be used to store log entries.
3697
+ # After a bucket has been created, the bucket's location cannot be changed.
3698
+ # @param [String] parent
3699
+ # Required. The resource in which to create the log bucket: "projects/[
3700
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
3701
+ # locations/global"
3702
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3703
+ # @param [String] bucket_id
3704
+ # Required. A client-assigned identifier such as "my-bucket". Identifiers are
3705
+ # limited to 100 characters and can include only letters, digits, underscores,
3706
+ # hyphens, and periods.
3707
+ # @param [String] fields
3708
+ # Selector specifying which fields to include in a partial response.
3709
+ # @param [String] quota_user
3710
+ # Available to use for quota purposes for server-side applications. Can be any
3711
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3712
+ # @param [Google::Apis::RequestOptions] options
3713
+ # Request-specific options
3714
+ #
3715
+ # @yield [result, err] Result & error if block supplied
3716
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
3717
+ # @yieldparam err [StandardError] error object if request failed
3718
+ #
3719
+ # @return [Google::Apis::LoggingV2::Operation]
3720
+ #
3721
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3722
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3723
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3724
+ def create_location_bucket_async(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3725
+ command = make_simple_command(:post, 'v2/{+parent}/buckets:createAsync', options)
3726
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
3727
+ command.request_object = log_bucket_object
3728
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
3729
+ command.response_class = Google::Apis::LoggingV2::Operation
3730
+ command.params['parent'] = parent unless parent.nil?
3731
+ command.query['bucketId'] = bucket_id unless bucket_id.nil?
3732
+ command.query['fields'] = fields unless fields.nil?
3733
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3734
+ execute_or_queue_command(command, &block)
3735
+ end
3736
+
3212
3737
  # Deletes a log bucket.Changes the bucket's lifecycle_state to the
3213
3738
  # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
3214
3739
  # entries in the bucket will be permanently deleted.
@@ -3327,11 +3852,8 @@ module Google
3327
3852
  execute_or_queue_command(command, &block)
3328
3853
  end
3329
3854
 
3330
- # Updates a log bucket. This method replaces the following fields in the
3331
- # existing bucket with values from the new bucket: retention_periodIf the
3332
- # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
3333
- # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
3334
- # FAILED_PRECONDITION will be returned.After a bucket has been created, the
3855
+ # Updates a log bucket.If the bucket has a lifecycle_state of DELETE_REQUESTED,
3856
+ # then FAILED_PRECONDITION will be returned.After a bucket has been created, the
3335
3857
  # bucket's location cannot be changed.
3336
3858
  # @param [String] name
3337
3859
  # Required. The full resource name of the bucket to update. "projects/[
@@ -3417,17 +3939,24 @@ module Google
3417
3939
  execute_or_queue_command(command, &block)
3418
3940
  end
3419
3941
 
3420
- # Creates a view over log entries in a log bucket. A bucket may contain a
3421
- # maximum of 30 views.
3422
- # @param [String] parent
3423
- # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
3424
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
3425
- # locations/global/buckets/my-bucket"
3426
- # @param [Google::Apis::LoggingV2::LogView] log_view_object
3427
- # @param [String] view_id
3428
- # Required. A client-assigned identifier such as "my-view". Identifiers are
3429
- # limited to 100 characters and can include only letters, digits, underscores,
3430
- # hyphens, and periods.
3942
+ # Updates a log bucket asynchronously.If the bucket has a lifecycle_state of
3943
+ # DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has
3944
+ # been created, the bucket's location cannot be changed.
3945
+ # @param [String] name
3946
+ # Required. The full resource name of the bucket to update. "projects/[
3947
+ # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3948
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3949
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
3950
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3951
+ # my-project/locations/global/buckets/my-bucket"
3952
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3953
+ # @param [String] update_mask
3954
+ # Required. Field mask that specifies the fields in bucket that need an update.
3955
+ # A bucket field will be overwritten if, and only if, it is in the update mask.
3956
+ # name and output only fields cannot be updated.For a detailed FieldMask
3957
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
3958
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
3959
+ # retention_days
3431
3960
  # @param [String] fields
3432
3961
  # Selector specifying which fields to include in a partial response.
3433
3962
  # @param [String] quota_user
@@ -3437,34 +3966,41 @@ module Google
3437
3966
  # Request-specific options
3438
3967
  #
3439
3968
  # @yield [result, err] Result & error if block supplied
3440
- # @yieldparam result [Google::Apis::LoggingV2::LogView] parsed result object
3969
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
3441
3970
  # @yieldparam err [StandardError] error object if request failed
3442
3971
  #
3443
- # @return [Google::Apis::LoggingV2::LogView]
3972
+ # @return [Google::Apis::LoggingV2::Operation]
3444
3973
  #
3445
3974
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3446
3975
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3447
3976
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3448
- def create_location_bucket_view(parent, log_view_object = nil, view_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3449
- command = make_simple_command(:post, 'v2/{+parent}/views', options)
3450
- command.request_representation = Google::Apis::LoggingV2::LogView::Representation
3451
- command.request_object = log_view_object
3452
- command.response_representation = Google::Apis::LoggingV2::LogView::Representation
3453
- command.response_class = Google::Apis::LoggingV2::LogView
3454
- command.params['parent'] = parent unless parent.nil?
3455
- command.query['viewId'] = view_id unless view_id.nil?
3977
+ def update_location_bucket_async(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3978
+ command = make_simple_command(:post, 'v2/{+name}:updateAsync', options)
3979
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
3980
+ command.request_object = log_bucket_object
3981
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
3982
+ command.response_class = Google::Apis::LoggingV2::Operation
3983
+ command.params['name'] = name unless name.nil?
3984
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3456
3985
  command.query['fields'] = fields unless fields.nil?
3457
3986
  command.query['quotaUser'] = quota_user unless quota_user.nil?
3458
3987
  execute_or_queue_command(command, &block)
3459
3988
  end
3460
3989
 
3461
- # Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this
3462
- # indicates that system is not in a state where it can delete the view. If this
3463
- # occurs, please try again in a few minutes.
3464
- # @param [String] name
3465
- # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
3466
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
3467
- # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
3990
+ # Asynchronously creates linked dataset in BigQuery which makes it possible to
3991
+ # use BugQuery to read the logs stored in the bucket. A bucket may currently
3992
+ # only contain one link.
3993
+ # @param [String] parent
3994
+ # Required. The full resource name of the bucket to create a link for. "projects/
3995
+ # [PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3996
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3997
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
3998
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
3999
+ # @param [Google::Apis::LoggingV2::Link] link_object
4000
+ # @param [String] link_id
4001
+ # Required. The ID to use for the link. The link_id can have up to 100
4002
+ # characters. A valid link_id must only have alphanumeric characters and
4003
+ # underscores within it.
3468
4004
  # @param [String] fields
3469
4005
  # Selector specifying which fields to include in a partial response.
3470
4006
  # @param [String] quota_user
@@ -3474,29 +4010,36 @@ module Google
3474
4010
  # Request-specific options
3475
4011
  #
3476
4012
  # @yield [result, err] Result & error if block supplied
3477
- # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
4013
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
3478
4014
  # @yieldparam err [StandardError] error object if request failed
3479
4015
  #
3480
- # @return [Google::Apis::LoggingV2::Empty]
4016
+ # @return [Google::Apis::LoggingV2::Operation]
3481
4017
  #
3482
4018
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3483
4019
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3484
4020
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3485
- def delete_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
3486
- command = make_simple_command(:delete, 'v2/{+name}', options)
3487
- command.response_representation = Google::Apis::LoggingV2::Empty::Representation
3488
- command.response_class = Google::Apis::LoggingV2::Empty
3489
- command.params['name'] = name unless name.nil?
4021
+ def create_location_bucket_link(parent, link_object = nil, link_id: nil, fields: nil, quota_user: nil, options: nil, &block)
4022
+ command = make_simple_command(:post, 'v2/{+parent}/links', options)
4023
+ command.request_representation = Google::Apis::LoggingV2::Link::Representation
4024
+ command.request_object = link_object
4025
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
4026
+ command.response_class = Google::Apis::LoggingV2::Operation
4027
+ command.params['parent'] = parent unless parent.nil?
4028
+ command.query['linkId'] = link_id unless link_id.nil?
3490
4029
  command.query['fields'] = fields unless fields.nil?
3491
4030
  command.query['quotaUser'] = quota_user unless quota_user.nil?
3492
4031
  execute_or_queue_command(command, &block)
3493
4032
  end
3494
4033
 
3495
- # Gets a view on a log bucket..
4034
+ # Deletes a link. This will also delete the corresponding BigQuery linked
4035
+ # dataset.
3496
4036
  # @param [String] name
3497
- # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
3498
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
3499
- # project/locations/global/buckets/my-bucket/views/my-view"
4037
+ # Required. The full resource name of the link to delete."projects/PROJECT_ID/
4038
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/
4039
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
4040
+ # billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
4041
+ # links/LINK_ID" "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
4042
+ # links/LINK_ID"
3500
4043
  # @param [String] fields
3501
4044
  # Selector specifying which fields to include in a partial response.
3502
4045
  # @param [String] quota_user
@@ -3506,7 +4049,190 @@ module Google
3506
4049
  # Request-specific options
3507
4050
  #
3508
4051
  # @yield [result, err] Result & error if block supplied
3509
- # @yieldparam result [Google::Apis::LoggingV2::LogView] parsed result object
4052
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
4053
+ # @yieldparam err [StandardError] error object if request failed
4054
+ #
4055
+ # @return [Google::Apis::LoggingV2::Operation]
4056
+ #
4057
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4058
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4059
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4060
+ def delete_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
4061
+ command = make_simple_command(:delete, 'v2/{+name}', options)
4062
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
4063
+ command.response_class = Google::Apis::LoggingV2::Operation
4064
+ command.params['name'] = name unless name.nil?
4065
+ command.query['fields'] = fields unless fields.nil?
4066
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4067
+ execute_or_queue_command(command, &block)
4068
+ end
4069
+
4070
+ # Gets a link.
4071
+ # @param [String] name
4072
+ # Required. The resource name of the link:"projects/PROJECT_ID/locations/
4073
+ # LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/ORGANIZATION_ID/
4074
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/
4075
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
4076
+ # folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
4077
+ # @param [String] fields
4078
+ # Selector specifying which fields to include in a partial response.
4079
+ # @param [String] quota_user
4080
+ # Available to use for quota purposes for server-side applications. Can be any
4081
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4082
+ # @param [Google::Apis::RequestOptions] options
4083
+ # Request-specific options
4084
+ #
4085
+ # @yield [result, err] Result & error if block supplied
4086
+ # @yieldparam result [Google::Apis::LoggingV2::Link] parsed result object
4087
+ # @yieldparam err [StandardError] error object if request failed
4088
+ #
4089
+ # @return [Google::Apis::LoggingV2::Link]
4090
+ #
4091
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4092
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4093
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4094
+ def get_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
4095
+ command = make_simple_command(:get, 'v2/{+name}', options)
4096
+ command.response_representation = Google::Apis::LoggingV2::Link::Representation
4097
+ command.response_class = Google::Apis::LoggingV2::Link
4098
+ command.params['name'] = name unless name.nil?
4099
+ command.query['fields'] = fields unless fields.nil?
4100
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4101
+ execute_or_queue_command(command, &block)
4102
+ end
4103
+
4104
+ # Lists links.
4105
+ # @param [String] parent
4106
+ # Required. The parent resource whose links are to be listed:"projects/
4107
+ # PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/" "organizations/
4108
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/
4109
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "folders/
4110
+ # FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
4111
+ # @param [Fixnum] page_size
4112
+ # Optional. The maximum number of results to return from this request.
4113
+ # @param [String] page_token
4114
+ # Optional. If present, then retrieve the next batch of results from the
4115
+ # preceding call to this method. pageToken must be the value of nextPageToken
4116
+ # from the previous response.
4117
+ # @param [String] fields
4118
+ # Selector specifying which fields to include in a partial response.
4119
+ # @param [String] quota_user
4120
+ # Available to use for quota purposes for server-side applications. Can be any
4121
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4122
+ # @param [Google::Apis::RequestOptions] options
4123
+ # Request-specific options
4124
+ #
4125
+ # @yield [result, err] Result & error if block supplied
4126
+ # @yieldparam result [Google::Apis::LoggingV2::ListLinksResponse] parsed result object
4127
+ # @yieldparam err [StandardError] error object if request failed
4128
+ #
4129
+ # @return [Google::Apis::LoggingV2::ListLinksResponse]
4130
+ #
4131
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4132
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4133
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4134
+ def list_location_bucket_links(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4135
+ command = make_simple_command(:get, 'v2/{+parent}/links', options)
4136
+ command.response_representation = Google::Apis::LoggingV2::ListLinksResponse::Representation
4137
+ command.response_class = Google::Apis::LoggingV2::ListLinksResponse
4138
+ command.params['parent'] = parent unless parent.nil?
4139
+ command.query['pageSize'] = page_size unless page_size.nil?
4140
+ command.query['pageToken'] = page_token unless page_token.nil?
4141
+ command.query['fields'] = fields unless fields.nil?
4142
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4143
+ execute_or_queue_command(command, &block)
4144
+ end
4145
+
4146
+ # Creates a view over log entries in a log bucket. A bucket may contain a
4147
+ # maximum of 30 views.
4148
+ # @param [String] parent
4149
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
4150
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
4151
+ # locations/global/buckets/my-bucket"
4152
+ # @param [Google::Apis::LoggingV2::LogView] log_view_object
4153
+ # @param [String] view_id
4154
+ # Required. A client-assigned identifier such as "my-view". Identifiers are
4155
+ # limited to 100 characters and can include only letters, digits, underscores,
4156
+ # hyphens, and periods.
4157
+ # @param [String] fields
4158
+ # Selector specifying which fields to include in a partial response.
4159
+ # @param [String] quota_user
4160
+ # Available to use for quota purposes for server-side applications. Can be any
4161
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4162
+ # @param [Google::Apis::RequestOptions] options
4163
+ # Request-specific options
4164
+ #
4165
+ # @yield [result, err] Result & error if block supplied
4166
+ # @yieldparam result [Google::Apis::LoggingV2::LogView] parsed result object
4167
+ # @yieldparam err [StandardError] error object if request failed
4168
+ #
4169
+ # @return [Google::Apis::LoggingV2::LogView]
4170
+ #
4171
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4172
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4173
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4174
+ def create_location_bucket_view(parent, log_view_object = nil, view_id: nil, fields: nil, quota_user: nil, options: nil, &block)
4175
+ command = make_simple_command(:post, 'v2/{+parent}/views', options)
4176
+ command.request_representation = Google::Apis::LoggingV2::LogView::Representation
4177
+ command.request_object = log_view_object
4178
+ command.response_representation = Google::Apis::LoggingV2::LogView::Representation
4179
+ command.response_class = Google::Apis::LoggingV2::LogView
4180
+ command.params['parent'] = parent unless parent.nil?
4181
+ command.query['viewId'] = view_id unless view_id.nil?
4182
+ command.query['fields'] = fields unless fields.nil?
4183
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4184
+ execute_or_queue_command(command, &block)
4185
+ end
4186
+
4187
+ # Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this
4188
+ # indicates that system is not in a state where it can delete the view. If this
4189
+ # occurs, please try again in a few minutes.
4190
+ # @param [String] name
4191
+ # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
4192
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
4193
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
4194
+ # @param [String] fields
4195
+ # Selector specifying which fields to include in a partial response.
4196
+ # @param [String] quota_user
4197
+ # Available to use for quota purposes for server-side applications. Can be any
4198
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4199
+ # @param [Google::Apis::RequestOptions] options
4200
+ # Request-specific options
4201
+ #
4202
+ # @yield [result, err] Result & error if block supplied
4203
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
4204
+ # @yieldparam err [StandardError] error object if request failed
4205
+ #
4206
+ # @return [Google::Apis::LoggingV2::Empty]
4207
+ #
4208
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4209
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4210
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4211
+ def delete_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
4212
+ command = make_simple_command(:delete, 'v2/{+name}', options)
4213
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
4214
+ command.response_class = Google::Apis::LoggingV2::Empty
4215
+ command.params['name'] = name unless name.nil?
4216
+ command.query['fields'] = fields unless fields.nil?
4217
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4218
+ execute_or_queue_command(command, &block)
4219
+ end
4220
+
4221
+ # Gets a view on a log bucket..
4222
+ # @param [String] name
4223
+ # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
4224
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
4225
+ # project/locations/global/buckets/my-bucket/views/my-view"
4226
+ # @param [String] fields
4227
+ # Selector specifying which fields to include in a partial response.
4228
+ # @param [String] quota_user
4229
+ # Available to use for quota purposes for server-side applications. Can be any
4230
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4231
+ # @param [Google::Apis::RequestOptions] options
4232
+ # Request-specific options
4233
+ #
4234
+ # @yield [result, err] Result & error if block supplied
4235
+ # @yieldparam result [Google::Apis::LoggingV2::LogView] parsed result object
3510
4236
  # @yieldparam err [StandardError] error object if request failed
3511
4237
  #
3512
4238
  # @return [Google::Apis::LoggingV2::LogView]
@@ -4352,6 +5078,47 @@ module Google
4352
5078
  execute_or_queue_command(command, &block)
4353
5079
  end
4354
5080
 
5081
+ # Creates a log bucket asynchronously that can be used to store log entries.
5082
+ # After a bucket has been created, the bucket's location cannot be changed.
5083
+ # @param [String] parent
5084
+ # Required. The resource in which to create the log bucket: "projects/[
5085
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
5086
+ # locations/global"
5087
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
5088
+ # @param [String] bucket_id
5089
+ # Required. A client-assigned identifier such as "my-bucket". Identifiers are
5090
+ # limited to 100 characters and can include only letters, digits, underscores,
5091
+ # hyphens, and periods.
5092
+ # @param [String] fields
5093
+ # Selector specifying which fields to include in a partial response.
5094
+ # @param [String] quota_user
5095
+ # Available to use for quota purposes for server-side applications. Can be any
5096
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5097
+ # @param [Google::Apis::RequestOptions] options
5098
+ # Request-specific options
5099
+ #
5100
+ # @yield [result, err] Result & error if block supplied
5101
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
5102
+ # @yieldparam err [StandardError] error object if request failed
5103
+ #
5104
+ # @return [Google::Apis::LoggingV2::Operation]
5105
+ #
5106
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5107
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5108
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5109
+ def create_organization_location_bucket_async(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
5110
+ command = make_simple_command(:post, 'v2/{+parent}/buckets:createAsync', options)
5111
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
5112
+ command.request_object = log_bucket_object
5113
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
5114
+ command.response_class = Google::Apis::LoggingV2::Operation
5115
+ command.params['parent'] = parent unless parent.nil?
5116
+ command.query['bucketId'] = bucket_id unless bucket_id.nil?
5117
+ command.query['fields'] = fields unless fields.nil?
5118
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5119
+ execute_or_queue_command(command, &block)
5120
+ end
5121
+
4355
5122
  # Deletes a log bucket.Changes the bucket's lifecycle_state to the
4356
5123
  # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
4357
5124
  # entries in the bucket will be permanently deleted.
@@ -4450,47 +5217,248 @@ module Google
4450
5217
  # Request-specific options
4451
5218
  #
4452
5219
  # @yield [result, err] Result & error if block supplied
4453
- # @yieldparam result [Google::Apis::LoggingV2::ListBucketsResponse] parsed result object
5220
+ # @yieldparam result [Google::Apis::LoggingV2::ListBucketsResponse] parsed result object
5221
+ # @yieldparam err [StandardError] error object if request failed
5222
+ #
5223
+ # @return [Google::Apis::LoggingV2::ListBucketsResponse]
5224
+ #
5225
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5226
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5227
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5228
+ def list_organization_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5229
+ command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
5230
+ command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
5231
+ command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
5232
+ command.params['parent'] = parent unless parent.nil?
5233
+ command.query['pageSize'] = page_size unless page_size.nil?
5234
+ command.query['pageToken'] = page_token unless page_token.nil?
5235
+ command.query['fields'] = fields unless fields.nil?
5236
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5237
+ execute_or_queue_command(command, &block)
5238
+ end
5239
+
5240
+ # Updates a log bucket.If the bucket has a lifecycle_state of DELETE_REQUESTED,
5241
+ # then FAILED_PRECONDITION will be returned.After a bucket has been created, the
5242
+ # bucket's location cannot be changed.
5243
+ # @param [String] name
5244
+ # Required. The full resource name of the bucket to update. "projects/[
5245
+ # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5246
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5247
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
5248
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5249
+ # my-project/locations/global/buckets/my-bucket"
5250
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
5251
+ # @param [String] update_mask
5252
+ # Required. Field mask that specifies the fields in bucket that need an update.
5253
+ # A bucket field will be overwritten if, and only if, it is in the update mask.
5254
+ # name and output only fields cannot be updated.For a detailed FieldMask
5255
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
5256
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
5257
+ # retention_days
5258
+ # @param [String] fields
5259
+ # Selector specifying which fields to include in a partial response.
5260
+ # @param [String] quota_user
5261
+ # Available to use for quota purposes for server-side applications. Can be any
5262
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5263
+ # @param [Google::Apis::RequestOptions] options
5264
+ # Request-specific options
5265
+ #
5266
+ # @yield [result, err] Result & error if block supplied
5267
+ # @yieldparam result [Google::Apis::LoggingV2::LogBucket] parsed result object
5268
+ # @yieldparam err [StandardError] error object if request failed
5269
+ #
5270
+ # @return [Google::Apis::LoggingV2::LogBucket]
5271
+ #
5272
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5273
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5274
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5275
+ def patch_organization_location_bucket(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
5276
+ command = make_simple_command(:patch, 'v2/{+name}', options)
5277
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
5278
+ command.request_object = log_bucket_object
5279
+ command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
5280
+ command.response_class = Google::Apis::LoggingV2::LogBucket
5281
+ command.params['name'] = name unless name.nil?
5282
+ command.query['updateMask'] = update_mask unless update_mask.nil?
5283
+ command.query['fields'] = fields unless fields.nil?
5284
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5285
+ execute_or_queue_command(command, &block)
5286
+ end
5287
+
5288
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
5289
+ # the grace period of 7 days.
5290
+ # @param [String] name
5291
+ # Required. The full resource name of the bucket to undelete. "projects/[
5292
+ # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5293
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5294
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
5295
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5296
+ # my-project/locations/global/buckets/my-bucket"
5297
+ # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
5298
+ # @param [String] fields
5299
+ # Selector specifying which fields to include in a partial response.
5300
+ # @param [String] quota_user
5301
+ # Available to use for quota purposes for server-side applications. Can be any
5302
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5303
+ # @param [Google::Apis::RequestOptions] options
5304
+ # Request-specific options
5305
+ #
5306
+ # @yield [result, err] Result & error if block supplied
5307
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
5308
+ # @yieldparam err [StandardError] error object if request failed
5309
+ #
5310
+ # @return [Google::Apis::LoggingV2::Empty]
5311
+ #
5312
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5313
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5314
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5315
+ def undelete_organization_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5316
+ command = make_simple_command(:post, 'v2/{+name}:undelete', options)
5317
+ command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation
5318
+ command.request_object = undelete_bucket_request_object
5319
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
5320
+ command.response_class = Google::Apis::LoggingV2::Empty
5321
+ command.params['name'] = name unless name.nil?
5322
+ command.query['fields'] = fields unless fields.nil?
5323
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5324
+ execute_or_queue_command(command, &block)
5325
+ end
5326
+
5327
+ # Updates a log bucket asynchronously.If the bucket has a lifecycle_state of
5328
+ # DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has
5329
+ # been created, the bucket's location cannot be changed.
5330
+ # @param [String] name
5331
+ # Required. The full resource name of the bucket to update. "projects/[
5332
+ # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5333
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5334
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
5335
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5336
+ # my-project/locations/global/buckets/my-bucket"
5337
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
5338
+ # @param [String] update_mask
5339
+ # Required. Field mask that specifies the fields in bucket that need an update.
5340
+ # A bucket field will be overwritten if, and only if, it is in the update mask.
5341
+ # name and output only fields cannot be updated.For a detailed FieldMask
5342
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
5343
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
5344
+ # retention_days
5345
+ # @param [String] fields
5346
+ # Selector specifying which fields to include in a partial response.
5347
+ # @param [String] quota_user
5348
+ # Available to use for quota purposes for server-side applications. Can be any
5349
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5350
+ # @param [Google::Apis::RequestOptions] options
5351
+ # Request-specific options
5352
+ #
5353
+ # @yield [result, err] Result & error if block supplied
5354
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
5355
+ # @yieldparam err [StandardError] error object if request failed
5356
+ #
5357
+ # @return [Google::Apis::LoggingV2::Operation]
5358
+ #
5359
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5360
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5361
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5362
+ def update_organization_location_bucket_async(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
5363
+ command = make_simple_command(:post, 'v2/{+name}:updateAsync', options)
5364
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
5365
+ command.request_object = log_bucket_object
5366
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
5367
+ command.response_class = Google::Apis::LoggingV2::Operation
5368
+ command.params['name'] = name unless name.nil?
5369
+ command.query['updateMask'] = update_mask unless update_mask.nil?
5370
+ command.query['fields'] = fields unless fields.nil?
5371
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5372
+ execute_or_queue_command(command, &block)
5373
+ end
5374
+
5375
+ # Asynchronously creates linked dataset in BigQuery which makes it possible to
5376
+ # use BugQuery to read the logs stored in the bucket. A bucket may currently
5377
+ # only contain one link.
5378
+ # @param [String] parent
5379
+ # Required. The full resource name of the bucket to create a link for. "projects/
5380
+ # [PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5381
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5382
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
5383
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
5384
+ # @param [Google::Apis::LoggingV2::Link] link_object
5385
+ # @param [String] link_id
5386
+ # Required. The ID to use for the link. The link_id can have up to 100
5387
+ # characters. A valid link_id must only have alphanumeric characters and
5388
+ # underscores within it.
5389
+ # @param [String] fields
5390
+ # Selector specifying which fields to include in a partial response.
5391
+ # @param [String] quota_user
5392
+ # Available to use for quota purposes for server-side applications. Can be any
5393
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5394
+ # @param [Google::Apis::RequestOptions] options
5395
+ # Request-specific options
5396
+ #
5397
+ # @yield [result, err] Result & error if block supplied
5398
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
5399
+ # @yieldparam err [StandardError] error object if request failed
5400
+ #
5401
+ # @return [Google::Apis::LoggingV2::Operation]
5402
+ #
5403
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5404
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5405
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5406
+ def create_organization_location_bucket_link(parent, link_object = nil, link_id: nil, fields: nil, quota_user: nil, options: nil, &block)
5407
+ command = make_simple_command(:post, 'v2/{+parent}/links', options)
5408
+ command.request_representation = Google::Apis::LoggingV2::Link::Representation
5409
+ command.request_object = link_object
5410
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
5411
+ command.response_class = Google::Apis::LoggingV2::Operation
5412
+ command.params['parent'] = parent unless parent.nil?
5413
+ command.query['linkId'] = link_id unless link_id.nil?
5414
+ command.query['fields'] = fields unless fields.nil?
5415
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5416
+ execute_or_queue_command(command, &block)
5417
+ end
5418
+
5419
+ # Deletes a link. This will also delete the corresponding BigQuery linked
5420
+ # dataset.
5421
+ # @param [String] name
5422
+ # Required. The full resource name of the link to delete."projects/PROJECT_ID/
5423
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/
5424
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
5425
+ # billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
5426
+ # links/LINK_ID" "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
5427
+ # links/LINK_ID"
5428
+ # @param [String] fields
5429
+ # Selector specifying which fields to include in a partial response.
5430
+ # @param [String] quota_user
5431
+ # Available to use for quota purposes for server-side applications. Can be any
5432
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5433
+ # @param [Google::Apis::RequestOptions] options
5434
+ # Request-specific options
5435
+ #
5436
+ # @yield [result, err] Result & error if block supplied
5437
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
4454
5438
  # @yieldparam err [StandardError] error object if request failed
4455
5439
  #
4456
- # @return [Google::Apis::LoggingV2::ListBucketsResponse]
5440
+ # @return [Google::Apis::LoggingV2::Operation]
4457
5441
  #
4458
5442
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4459
5443
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4460
5444
  # @raise [Google::Apis::AuthorizationError] Authorization is required
4461
- def list_organization_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4462
- command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
4463
- command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
4464
- command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
4465
- command.params['parent'] = parent unless parent.nil?
4466
- command.query['pageSize'] = page_size unless page_size.nil?
4467
- command.query['pageToken'] = page_token unless page_token.nil?
5445
+ def delete_organization_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
5446
+ command = make_simple_command(:delete, 'v2/{+name}', options)
5447
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
5448
+ command.response_class = Google::Apis::LoggingV2::Operation
5449
+ command.params['name'] = name unless name.nil?
4468
5450
  command.query['fields'] = fields unless fields.nil?
4469
5451
  command.query['quotaUser'] = quota_user unless quota_user.nil?
4470
5452
  execute_or_queue_command(command, &block)
4471
5453
  end
4472
5454
 
4473
- # Updates a log bucket. This method replaces the following fields in the
4474
- # existing bucket with values from the new bucket: retention_periodIf the
4475
- # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
4476
- # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
4477
- # FAILED_PRECONDITION will be returned.After a bucket has been created, the
4478
- # bucket's location cannot be changed.
5455
+ # Gets a link.
4479
5456
  # @param [String] name
4480
- # Required. The full resource name of the bucket to update. "projects/[
4481
- # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4482
- # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4483
- # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
4484
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4485
- # my-project/locations/global/buckets/my-bucket"
4486
- # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
4487
- # @param [String] update_mask
4488
- # Required. Field mask that specifies the fields in bucket that need an update.
4489
- # A bucket field will be overwritten if, and only if, it is in the update mask.
4490
- # name and output only fields cannot be updated.For a detailed FieldMask
4491
- # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
4492
- # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4493
- # retention_days
5457
+ # Required. The resource name of the link:"projects/PROJECT_ID/locations/
5458
+ # LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/ORGANIZATION_ID/
5459
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/
5460
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
5461
+ # folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
4494
5462
  # @param [String] fields
4495
5463
  # Selector specifying which fields to include in a partial response.
4496
5464
  # @param [String] quota_user
@@ -4500,37 +5468,37 @@ module Google
4500
5468
  # Request-specific options
4501
5469
  #
4502
5470
  # @yield [result, err] Result & error if block supplied
4503
- # @yieldparam result [Google::Apis::LoggingV2::LogBucket] parsed result object
5471
+ # @yieldparam result [Google::Apis::LoggingV2::Link] parsed result object
4504
5472
  # @yieldparam err [StandardError] error object if request failed
4505
5473
  #
4506
- # @return [Google::Apis::LoggingV2::LogBucket]
5474
+ # @return [Google::Apis::LoggingV2::Link]
4507
5475
  #
4508
5476
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4509
5477
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4510
5478
  # @raise [Google::Apis::AuthorizationError] Authorization is required
4511
- def patch_organization_location_bucket(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
4512
- command = make_simple_command(:patch, 'v2/{+name}', options)
4513
- command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
4514
- command.request_object = log_bucket_object
4515
- command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
4516
- command.response_class = Google::Apis::LoggingV2::LogBucket
5479
+ def get_organization_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
5480
+ command = make_simple_command(:get, 'v2/{+name}', options)
5481
+ command.response_representation = Google::Apis::LoggingV2::Link::Representation
5482
+ command.response_class = Google::Apis::LoggingV2::Link
4517
5483
  command.params['name'] = name unless name.nil?
4518
- command.query['updateMask'] = update_mask unless update_mask.nil?
4519
5484
  command.query['fields'] = fields unless fields.nil?
4520
5485
  command.query['quotaUser'] = quota_user unless quota_user.nil?
4521
5486
  execute_or_queue_command(command, &block)
4522
5487
  end
4523
5488
 
4524
- # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
4525
- # the grace period of 7 days.
4526
- # @param [String] name
4527
- # Required. The full resource name of the bucket to undelete. "projects/[
4528
- # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4529
- # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4530
- # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
4531
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4532
- # my-project/locations/global/buckets/my-bucket"
4533
- # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
5489
+ # Lists links.
5490
+ # @param [String] parent
5491
+ # Required. The parent resource whose links are to be listed:"projects/
5492
+ # PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/" "organizations/
5493
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/
5494
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "folders/
5495
+ # FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
5496
+ # @param [Fixnum] page_size
5497
+ # Optional. The maximum number of results to return from this request.
5498
+ # @param [String] page_token
5499
+ # Optional. If present, then retrieve the next batch of results from the
5500
+ # preceding call to this method. pageToken must be the value of nextPageToken
5501
+ # from the previous response.
4534
5502
  # @param [String] fields
4535
5503
  # Selector specifying which fields to include in a partial response.
4536
5504
  # @param [String] quota_user
@@ -4540,21 +5508,21 @@ module Google
4540
5508
  # Request-specific options
4541
5509
  #
4542
5510
  # @yield [result, err] Result & error if block supplied
4543
- # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
5511
+ # @yieldparam result [Google::Apis::LoggingV2::ListLinksResponse] parsed result object
4544
5512
  # @yieldparam err [StandardError] error object if request failed
4545
5513
  #
4546
- # @return [Google::Apis::LoggingV2::Empty]
5514
+ # @return [Google::Apis::LoggingV2::ListLinksResponse]
4547
5515
  #
4548
5516
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4549
5517
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4550
5518
  # @raise [Google::Apis::AuthorizationError] Authorization is required
4551
- def undelete_organization_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
4552
- command = make_simple_command(:post, 'v2/{+name}:undelete', options)
4553
- command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation
4554
- command.request_object = undelete_bucket_request_object
4555
- command.response_representation = Google::Apis::LoggingV2::Empty::Representation
4556
- command.response_class = Google::Apis::LoggingV2::Empty
4557
- command.params['name'] = name unless name.nil?
5519
+ def list_organization_location_bucket_links(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5520
+ command = make_simple_command(:get, 'v2/{+parent}/links', options)
5521
+ command.response_representation = Google::Apis::LoggingV2::ListLinksResponse::Representation
5522
+ command.response_class = Google::Apis::LoggingV2::ListLinksResponse
5523
+ command.params['parent'] = parent unless parent.nil?
5524
+ command.query['pageSize'] = page_size unless page_size.nil?
5525
+ command.query['pageToken'] = page_token unless page_token.nil?
4558
5526
  command.query['fields'] = fields unless fields.nil?
4559
5527
  command.query['quotaUser'] = quota_user unless quota_user.nil?
4560
5528
  execute_or_queue_command(command, &block)
@@ -5689,6 +6657,47 @@ module Google
5689
6657
  execute_or_queue_command(command, &block)
5690
6658
  end
5691
6659
 
6660
+ # Creates a log bucket asynchronously that can be used to store log entries.
6661
+ # After a bucket has been created, the bucket's location cannot be changed.
6662
+ # @param [String] parent
6663
+ # Required. The resource in which to create the log bucket: "projects/[
6664
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
6665
+ # locations/global"
6666
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
6667
+ # @param [String] bucket_id
6668
+ # Required. A client-assigned identifier such as "my-bucket". Identifiers are
6669
+ # limited to 100 characters and can include only letters, digits, underscores,
6670
+ # hyphens, and periods.
6671
+ # @param [String] fields
6672
+ # Selector specifying which fields to include in a partial response.
6673
+ # @param [String] quota_user
6674
+ # Available to use for quota purposes for server-side applications. Can be any
6675
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6676
+ # @param [Google::Apis::RequestOptions] options
6677
+ # Request-specific options
6678
+ #
6679
+ # @yield [result, err] Result & error if block supplied
6680
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
6681
+ # @yieldparam err [StandardError] error object if request failed
6682
+ #
6683
+ # @return [Google::Apis::LoggingV2::Operation]
6684
+ #
6685
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6686
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6687
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6688
+ def create_project_location_bucket_async(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
6689
+ command = make_simple_command(:post, 'v2/{+parent}/buckets:createAsync', options)
6690
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
6691
+ command.request_object = log_bucket_object
6692
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
6693
+ command.response_class = Google::Apis::LoggingV2::Operation
6694
+ command.params['parent'] = parent unless parent.nil?
6695
+ command.query['bucketId'] = bucket_id unless bucket_id.nil?
6696
+ command.query['fields'] = fields unless fields.nil?
6697
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6698
+ execute_or_queue_command(command, &block)
6699
+ end
6700
+
5692
6701
  # Deletes a log bucket.Changes the bucket's lifecycle_state to the
5693
6702
  # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
5694
6703
  # entries in the bucket will be permanently deleted.
@@ -5807,11 +6816,8 @@ module Google
5807
6816
  execute_or_queue_command(command, &block)
5808
6817
  end
5809
6818
 
5810
- # Updates a log bucket. This method replaces the following fields in the
5811
- # existing bucket with values from the new bucket: retention_periodIf the
5812
- # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
5813
- # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
5814
- # FAILED_PRECONDITION will be returned.After a bucket has been created, the
6819
+ # Updates a log bucket.If the bucket has a lifecycle_state of DELETE_REQUESTED,
6820
+ # then FAILED_PRECONDITION will be returned.After a bucket has been created, the
5815
6821
  # bucket's location cannot be changed.
5816
6822
  # @param [String] name
5817
6823
  # Required. The full resource name of the bucket to update. "projects/[
@@ -5897,6 +6903,210 @@ module Google
5897
6903
  execute_or_queue_command(command, &block)
5898
6904
  end
5899
6905
 
6906
+ # Updates a log bucket asynchronously.If the bucket has a lifecycle_state of
6907
+ # DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has
6908
+ # been created, the bucket's location cannot be changed.
6909
+ # @param [String] name
6910
+ # Required. The full resource name of the bucket to update. "projects/[
6911
+ # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
6912
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
6913
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
6914
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
6915
+ # my-project/locations/global/buckets/my-bucket"
6916
+ # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
6917
+ # @param [String] update_mask
6918
+ # Required. Field mask that specifies the fields in bucket that need an update.
6919
+ # A bucket field will be overwritten if, and only if, it is in the update mask.
6920
+ # name and output only fields cannot be updated.For a detailed FieldMask
6921
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
6922
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6923
+ # retention_days
6924
+ # @param [String] fields
6925
+ # Selector specifying which fields to include in a partial response.
6926
+ # @param [String] quota_user
6927
+ # Available to use for quota purposes for server-side applications. Can be any
6928
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6929
+ # @param [Google::Apis::RequestOptions] options
6930
+ # Request-specific options
6931
+ #
6932
+ # @yield [result, err] Result & error if block supplied
6933
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
6934
+ # @yieldparam err [StandardError] error object if request failed
6935
+ #
6936
+ # @return [Google::Apis::LoggingV2::Operation]
6937
+ #
6938
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6939
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6940
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6941
+ def update_project_location_bucket_async(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
6942
+ command = make_simple_command(:post, 'v2/{+name}:updateAsync', options)
6943
+ command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
6944
+ command.request_object = log_bucket_object
6945
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
6946
+ command.response_class = Google::Apis::LoggingV2::Operation
6947
+ command.params['name'] = name unless name.nil?
6948
+ command.query['updateMask'] = update_mask unless update_mask.nil?
6949
+ command.query['fields'] = fields unless fields.nil?
6950
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6951
+ execute_or_queue_command(command, &block)
6952
+ end
6953
+
6954
+ # Asynchronously creates linked dataset in BigQuery which makes it possible to
6955
+ # use BugQuery to read the logs stored in the bucket. A bucket may currently
6956
+ # only contain one link.
6957
+ # @param [String] parent
6958
+ # Required. The full resource name of the bucket to create a link for. "projects/
6959
+ # [PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
6960
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
6961
+ # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
6962
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
6963
+ # @param [Google::Apis::LoggingV2::Link] link_object
6964
+ # @param [String] link_id
6965
+ # Required. The ID to use for the link. The link_id can have up to 100
6966
+ # characters. A valid link_id must only have alphanumeric characters and
6967
+ # underscores within it.
6968
+ # @param [String] fields
6969
+ # Selector specifying which fields to include in a partial response.
6970
+ # @param [String] quota_user
6971
+ # Available to use for quota purposes for server-side applications. Can be any
6972
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6973
+ # @param [Google::Apis::RequestOptions] options
6974
+ # Request-specific options
6975
+ #
6976
+ # @yield [result, err] Result & error if block supplied
6977
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
6978
+ # @yieldparam err [StandardError] error object if request failed
6979
+ #
6980
+ # @return [Google::Apis::LoggingV2::Operation]
6981
+ #
6982
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6983
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6984
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6985
+ def create_project_location_bucket_link(parent, link_object = nil, link_id: nil, fields: nil, quota_user: nil, options: nil, &block)
6986
+ command = make_simple_command(:post, 'v2/{+parent}/links', options)
6987
+ command.request_representation = Google::Apis::LoggingV2::Link::Representation
6988
+ command.request_object = link_object
6989
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
6990
+ command.response_class = Google::Apis::LoggingV2::Operation
6991
+ command.params['parent'] = parent unless parent.nil?
6992
+ command.query['linkId'] = link_id unless link_id.nil?
6993
+ command.query['fields'] = fields unless fields.nil?
6994
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6995
+ execute_or_queue_command(command, &block)
6996
+ end
6997
+
6998
+ # Deletes a link. This will also delete the corresponding BigQuery linked
6999
+ # dataset.
7000
+ # @param [String] name
7001
+ # Required. The full resource name of the link to delete."projects/PROJECT_ID/
7002
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/
7003
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
7004
+ # billingAccounts/BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
7005
+ # links/LINK_ID" "folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
7006
+ # links/LINK_ID"
7007
+ # @param [String] fields
7008
+ # Selector specifying which fields to include in a partial response.
7009
+ # @param [String] quota_user
7010
+ # Available to use for quota purposes for server-side applications. Can be any
7011
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7012
+ # @param [Google::Apis::RequestOptions] options
7013
+ # Request-specific options
7014
+ #
7015
+ # @yield [result, err] Result & error if block supplied
7016
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
7017
+ # @yieldparam err [StandardError] error object if request failed
7018
+ #
7019
+ # @return [Google::Apis::LoggingV2::Operation]
7020
+ #
7021
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7022
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7023
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7024
+ def delete_project_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
7025
+ command = make_simple_command(:delete, 'v2/{+name}', options)
7026
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
7027
+ command.response_class = Google::Apis::LoggingV2::Operation
7028
+ command.params['name'] = name unless name.nil?
7029
+ command.query['fields'] = fields unless fields.nil?
7030
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7031
+ execute_or_queue_command(command, &block)
7032
+ end
7033
+
7034
+ # Gets a link.
7035
+ # @param [String] name
7036
+ # Required. The resource name of the link:"projects/PROJECT_ID/locations/
7037
+ # LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "organizations/ORGANIZATION_ID/
7038
+ # locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "billingAccounts/
7039
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID" "
7040
+ # folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/LINK_ID
7041
+ # @param [String] fields
7042
+ # Selector specifying which fields to include in a partial response.
7043
+ # @param [String] quota_user
7044
+ # Available to use for quota purposes for server-side applications. Can be any
7045
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7046
+ # @param [Google::Apis::RequestOptions] options
7047
+ # Request-specific options
7048
+ #
7049
+ # @yield [result, err] Result & error if block supplied
7050
+ # @yieldparam result [Google::Apis::LoggingV2::Link] parsed result object
7051
+ # @yieldparam err [StandardError] error object if request failed
7052
+ #
7053
+ # @return [Google::Apis::LoggingV2::Link]
7054
+ #
7055
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7056
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7057
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7058
+ def get_project_location_bucket_link(name, fields: nil, quota_user: nil, options: nil, &block)
7059
+ command = make_simple_command(:get, 'v2/{+name}', options)
7060
+ command.response_representation = Google::Apis::LoggingV2::Link::Representation
7061
+ command.response_class = Google::Apis::LoggingV2::Link
7062
+ command.params['name'] = name unless name.nil?
7063
+ command.query['fields'] = fields unless fields.nil?
7064
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7065
+ execute_or_queue_command(command, &block)
7066
+ end
7067
+
7068
+ # Lists links.
7069
+ # @param [String] parent
7070
+ # Required. The parent resource whose links are to be listed:"projects/
7071
+ # PROJECT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/links/" "organizations/
7072
+ # ORGANIZATION_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "billingAccounts/
7073
+ # BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/" "folders/
7074
+ # FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/
7075
+ # @param [Fixnum] page_size
7076
+ # Optional. The maximum number of results to return from this request.
7077
+ # @param [String] page_token
7078
+ # Optional. If present, then retrieve the next batch of results from the
7079
+ # preceding call to this method. pageToken must be the value of nextPageToken
7080
+ # from the previous response.
7081
+ # @param [String] fields
7082
+ # Selector specifying which fields to include in a partial response.
7083
+ # @param [String] quota_user
7084
+ # Available to use for quota purposes for server-side applications. Can be any
7085
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7086
+ # @param [Google::Apis::RequestOptions] options
7087
+ # Request-specific options
7088
+ #
7089
+ # @yield [result, err] Result & error if block supplied
7090
+ # @yieldparam result [Google::Apis::LoggingV2::ListLinksResponse] parsed result object
7091
+ # @yieldparam err [StandardError] error object if request failed
7092
+ #
7093
+ # @return [Google::Apis::LoggingV2::ListLinksResponse]
7094
+ #
7095
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7096
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7097
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7098
+ def list_project_location_bucket_links(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
7099
+ command = make_simple_command(:get, 'v2/{+parent}/links', options)
7100
+ command.response_representation = Google::Apis::LoggingV2::ListLinksResponse::Representation
7101
+ command.response_class = Google::Apis::LoggingV2::ListLinksResponse
7102
+ command.params['parent'] = parent unless parent.nil?
7103
+ command.query['pageSize'] = page_size unless page_size.nil?
7104
+ command.query['pageToken'] = page_token unless page_token.nil?
7105
+ command.query['fields'] = fields unless fields.nil?
7106
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7107
+ execute_or_queue_command(command, &block)
7108
+ end
7109
+
5900
7110
  # Creates a view over log entries in a log bucket. A bucket may contain a
5901
7111
  # maximum of 30 views.
5902
7112
  # @param [String] parent