google-apis-cloudsupport_v2beta 0.23.0 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f41218600f3a5e02a1782d768812e60a8e4e110a09d9ec57dda24ce2541773d6
-  data.tar.gz: a5e983fa053298ca67f4e2b0bd9efc74de13d973766961a5d127cd20402a11f3
+  metadata.gz: 5542ebc619e24bb450b22f7094204f398a06d1bf07f836f2301b027939cb7bbc
+  data.tar.gz: a47a1a4d0df4585a63907c652ea7e918b892e15fbcb19d3fbe262146b0168eea
 SHA512:
-  metadata.gz: 30a765690307d61cfbc49e82466043f6d944485236aa60e6258356a28bcd889269e8fbdcbbd3305817ac3a04a7f40657efe1c4c9b5776c0996e1b08dde6867c4
-  data.tar.gz: bd7de8b7fe88e5f3e29e0f0e4030efc784aeb1944675e5c5b809cd454a5937ff4ca163817347eff8b0dee71fb28652a4cf387dd3867dae3e9990c40ae038edd1
+  metadata.gz: d1d41b562d7d926ff405c04778c31c229c0359d16c1da9414f4a213e722e06de8b5efde0bd2c0e1d42d189cd41b568baf4a96cd4b7cee58702a3aeaea3e59a34
+  data.tar.gz: f4e652d7a9456265ebff380d94275834f6eb3e98ae5706edcfe8291b5da41ef3061b4eaa67c5831eab9e7ae9b57ba48b151c05a26ab752fa8caf7912cb376f2d

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-cloudsupport_v2beta
 
+### v0.25.0 (2023-08-03)
+
+* Regenerated from discovery document revision 20230725
+
+### v0.24.0 (2023-07-02)
+
+* Regenerated from discovery document revision 20230626
+
 ### v0.23.0 (2023-06-18)
 
 * Regenerated from discovery document revision 20230614

data/lib/google/apis/cloudsupport_v2beta/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudsupportV2beta
       # Version of the google-apis-cloudsupport_v2beta gem
-      GEM_VERSION = "0.23.0"
+      GEM_VERSION = "0.25.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230614"
+      REVISION = "20230725"
     end
   end
 end

data/lib/google/apis/cloudsupport_v2beta/service.rb

@@ -54,10 +54,13 @@ module Google
         # classications are hierarchical, with each classification containing all levels
         # of the hierarchy, separated by `" > "`. For example `"Technical Issue >
         # Compute > Compute Engine"`. Classification IDs returned by `
-        # caseClassifications.search` are guaranteed to be valid for at least 6 months.
-        # If a given classification is deactiveated, it will immediately stop being
-        # returned. After 6 months, `case.create` requests using the classification ID
-        # will fail.
+        # caseClassifications.search` are guaranteed to be valid for at least six months.
+        # If a given classification is deactivated, it immediately stops being returned.
+        # After six months, `case.create` requests using the classification ID will
+        # fail. Here is an example of calling this endpoint using cURL: ```shell curl \ -
+        # -header "Authorization: Bearer $(gcloud auth print-access-token)" \ 'https://
+        # cloudsupport.googleapis.com/v2/caseClassifications:search?query=display_name:"*
+        # Compute%20Engine*"' ```
         # @param [Fixnum] page_size
         #   The maximum number of cases fetched with each request.
         # @param [String] page_token
@@ -96,7 +99,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Close the specified case.
+        # Close the specified case. Here is an example of calling this endpoint using
+        # cURL: ```shell case="projects/some-project/cases/43595344" curl \ --request
+        # POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "
+        # https://cloudsupport.googleapis.com/v2/$case:close" ```
         # @param [String] name
         #   Required. The fully qualified name of the case resource to be closed.
         # @param [Google::Apis::CloudsupportV2beta::CloseCaseRequest] close_case_request_object
@@ -131,7 +137,16 @@ module Google
         
         # Create a new case and associate it with the given Google Cloud Resource. The
         # case object must have the following fields set: `display_name`, `description`,
-        # `classification`, and `priority`.
+        # `classification`, and `priority`. Here is an example of calling this endpoint
+        # using cURL: ```shell parent="projects/some-project" curl \ --request POST \ --
+        # header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header '
+        # Content-Type: application/json' \ --data '` "display_name": "Test case created
+        # by me.", "description": "a random test case, feel free to close", "
+        # classification": ` "id": "
+        # 1BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8"
+        # `, "time_zone": "-07:00", "subscriber_email_addresses": [ "foo@domain.com", "
+        # bar@domain.com" ], "testCase": true, "priority": "P3" `' \ "https://
+        # cloudsupport.googleapis.com/v2/$parent/cases" ```
         # @param [String] parent
         #   Required. The name of the Google Cloud Resource under which the case should be
         #   created.
@@ -165,11 +180,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Escalate a case. Escalating a case will initiate the Google Cloud Support
+        # Escalate a case. Escalating a case initiates the Google Cloud Support
         # escalation management process. This operation is only available to certain
-        # Customer Care tiers. Go to https://cloud.google.com/support and look for '
-        # Technical support escalations' in the feature list to find out which tiers are
-        # able to perform escalations.
+        # Customer Care support services. Go to https://cloud.google.com/support and
+        # look for 'Technical support escalations' in the feature list to find out which
+        # support services let you perform escalations. Here is an example of calling
+        # this endpoint using cURL: ```shell case="projects/some-project/cases/43595344"
+        # curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-
+        # access-token)" \ --header "Content-Type: application/json" \ --data '` "
+        # escalation": ` "reason": "BUSINESS_IMPACT", "justification": "This is a test
+        # escalation." ` `' \ "https://cloudsupport.googleapis.com/v2/$case:escalate" ```
         # @param [String] name
         #   Required. The fully qualified name of the Case resource to be escalated.
         # @param [Google::Apis::CloudsupportV2beta::EscalateCaseRequest] escalate_case_request_object
@@ -202,7 +222,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieve the specified case.
+        # Retrieve the specified case. Here is an example of calling this endpoint using
+        # cURL: ```shell case="projects/some-project/cases/16033687" curl \ --header "
+        # Authorization: Bearer $(gcloud auth print-access-token)" \ "https://
+        # cloudsupport.googleapis.com/v2/$case" ```
         # @param [String] name
         #   Required. The fully qualified name of a case to be retrieved.
         # @param [String] fields
@@ -233,9 +256,12 @@ module Google
         end
         
         # Retrieve all cases under the specified parent. Note: Listing cases under an
-        # Organization returns only the cases directly parented by that organization. To
+        # organization returns only the cases directly parented by that organization. To
         # retrieve all cases under an organization, including cases parented by projects
-        # under that organization, use `cases.search`.
+        # under that organization, use `cases.search`. Here is an example of calling
+        # this endpoint using cURL: ```shell parent="projects/some-project" curl \ --
+        # header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://
+        # cloudsupport.googleapis.com/v2/$parent/cases" ```
         # @param [String] parent
         #   Required. The fully qualified name of parent resource to list cases under.
         # @param [String] filter
@@ -283,7 +309,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update the specified case. Only a subset of fields can be updated.
+        # Update the specified case. Only a subset of fields can be updated. Here is an
+        # example of calling this endpoint using cURL: ```shell case="projects/some-
+        # project/cases/43595344" curl \ --request PATCH \ --header "Authorization:
+        # Bearer $(gcloud auth print-access-token)" \ --header "Content-Type:
+        # application/json" \ --data '` "priority": "P1" `' \ "https://cloudsupport.
+        # googleapis.com/v2/$case?updateMask=priority" ```
         # @param [String] name
         #   The resource name for the case.
         # @param [Google::Apis::CloudsupportV2beta::Case] case_object
@@ -325,13 +356,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Search cases using the specified query.
+        # Search cases using the specified query. Here is an example of calling this
+        # endpoint using cURL: ```shell parent="projects/some-project" curl \ --header "
+        # Authorization: Bearer $(gcloud auth print-access-token)" \ "https://
+        # cloudsupport.googleapis.com/v2/$parent/cases:search" ```
         # @param [Fixnum] page_size
         #   The maximum number of cases fetched with each request. The default page size
         #   is 10.
         # @param [String] page_token
         #   A token identifying the page of results to return. If unspecified, the first
         #   page is retrieved.
+        # @param [String] parent
+        #   The fully qualified name of parent resource to search cases under.
         # @param [String] query
         #   An expression written in filter language. A query uses the following fields
         #   with the operators equals (`=`) and `AND`: - `organization`: An organization
@@ -370,19 +406,23 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def search_cases(page_size: nil, page_token: nil, query: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def search_cases(page_size: nil, page_token: nil, parent: nil, query: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v2beta/cases:search', options)
           command.response_representation = Google::Apis::CloudsupportV2beta::SearchCasesResponse::Representation
           command.response_class = Google::Apis::CloudsupportV2beta::SearchCasesResponse
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['parent'] = parent unless parent.nil?
           command.query['query'] = query unless query.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieve all attachments associated with a support case.
+        # Retrieve all attachments associated with a support case. Here is an example of
+        # calling this endpoint using cURL: ```shell case="projects/some-project/cases/
+        # 23598314" curl \ --header "Authorization: Bearer $(gcloud auth print-access-
+        # token)" \ "https://cloudsupport.googleapis.com/v2/$case/attachments" ```
         # @param [String] parent
         #   Required. The resource name of Case object for which attachments should be
         #   listed.
@@ -422,7 +462,11 @@ module Google
         end
         
         # Add a new comment to the specified Case. The comment object must have the
-        # following fields set: body.
+        # following fields set: body. Here is an example of calling this endpoint using
+        # cURL: ```shell case="projects/some-project/cases/43591344" curl \ --request
+        # POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --
+        # header 'Content-Type: application/json' \ --data '` "body": "This is a test
+        # comment." `' \ "https://cloudsupport.googleapis.com/v2/$case/comments" ```
         # @param [String] parent
         #   Required. The resource name of Case to which this comment should be added.
         # @param [Google::Apis::CloudsupportV2beta::Comment] comment_object
@@ -455,7 +499,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieve all Comments associated with the Case object.
+        # Retrieve all comments associated with the Case object. Here is an example of
+        # calling this endpoint using cURL: ```shell case="projects/cloud-support-qa-
+        # premium/cases/43595344" curl \ --header "Authorization: Bearer $(gcloud auth
+        # print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/comments"
+        # ```
         # @param [String] parent
         #   Required. The resource name of Case object for which comments should be listed.
         # @param [Fixnum] page_size
@@ -493,7 +541,11 @@ module Google
         end
         
         # Download a file attachment on a case. Note: HTTP requests must append "?alt=
-        # media" to the URL.
+        # media" to the URL. Here is an example of calling this endpoint using cURL: ```
+        # shell name="projects/some-project/cases/43594844/attachments/
+        # 0674M00000WijAnZAJ" curl \ --header "Authorization: Bearer $(gcloud auth print-
+        # access-token)" \ "https://cloudsupport.googleapis.com/v2/$name:download?alt=
+        # media" ```
         # @param [String] name
         #   The resource name of the attachment to be downloaded.
         # @param [String] fields
@@ -531,7 +583,13 @@ module Google
         end
         
         # Create a file attachment on a case or Cloud resource. The attachment object
-        # must have the following fields set: filename.
+        # must have the following fields set: filename. Here is an example of calling
+        # this endpoint using cURL: ```shell echo "This text is in a file I'm uploading
+        # using CSAPI." \ > "./example_file.txt" case="projects/some-project/cases/
+        # 43594844" curl \ --header "Authorization: Bearer $(gcloud auth print-access-
+        # token)" \ --data-binary @"./example_file.txt" \ "https://cloudsupport.
+        # googleapis.com/upload/v2beta/$case/attachments?attachment.filename=
+        # uploaded_via_curl.txt" ```
         # @param [String] parent
         #   Required. The resource name of the case (or case parent) to which the
         #   attachment should be attached.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudsupport_v2beta
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-18 00:00:00.000000000 Z
+date: 2023-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudsupport_v2beta/v0.23.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudsupport_v2beta/v0.25.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2beta
 post_install_message: 
 rdoc_options: []