google-apis-logging_v2 0.39.0 → 0.41.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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