feat(pubsub): update the api

#### pubsub:v1 The following keys were added: - resources.projects.resources.schemas.methods.commit (Total Keys: 12) - resources.projects.resources.schemas.methods.rollback (Total Keys: 12) - schemas.CommitSchemaRequest (Total Keys: 3) - schemas.RollbackSchemaRequest (Total Keys: 2)
googleapis · Jan 24, 2023 · bbeb0f3 · bbeb0f3
1 parent af8e656
commit bbeb0f3
Show file tree

Hide file tree

Showing 4 changed files with 338 additions and 3 deletions.
diff --git a/docs/dyn/pubsub_v1.projects.schemas.html b/docs/dyn/pubsub_v1.projects.schemas.html
@@ -77,12 +77,18 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#close">close()</a></code></p>
 <p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
+  <code><a href="#commit">commit(name, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Commits a new schema revision to an existing schema.</p>
 <p class="toc_element">
   <code><a href="#create">create(parent, body=None, schemaId=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Creates a schema.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Deletes a schema.</p>
+<p class="toc_element">
+  <code><a href="#deleteRevision">deleteRevision(name, revisionId=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Deletes a specific schema revision.</p>
 <p class="toc_element">
   <code><a href="#get">get(name, view=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets a schema.</p>
@@ -92,9 +98,18 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list">list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists schemas in a project.</p>
+<p class="toc_element">
+  <code><a href="#listRevisions">listRevisions(name, pageSize=None, pageToken=None, view=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Lists all schema revisions for the named schema.</p>
+<p class="toc_element">
+  <code><a href="#listRevisions_next">listRevisions_next()</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next()</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#rollback">rollback(name, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a new schema revision that is a copy of the provided revision_id.</p>
 <p class="toc_element">
   <code><a href="#setIamPolicy">setIamPolicy(resource, body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.</p>
@@ -113,6 +128,42 @@ <h3>Method Details</h3>
   <pre>Close httplib2 connections.</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="commit">commit(name, body=None, x__xgafv=None)</code>
+  <pre>Commits a new schema revision to an existing schema.
+
+Args:
+  name: string, Required. The name of the schema we are revising. Format is `projects/{project}/schemas/{schema}`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request for CommitSchema method.
+  &quot;schema&quot;: { # A schema resource. # Required. The schema revision to commit.
+    &quot;definition&quot;: &quot;A String&quot;, # The definition of the schema. This should contain a string representing the full definition of the schema that is a valid schema definition of the type specified in `type`.
+    &quot;name&quot;: &quot;A String&quot;, # Required. Name of the schema. Format is `projects/{project}/schemas/{schema}`.
+    &quot;revisionCreateTime&quot;: &quot;A String&quot;, # Output only. The timestamp that the revision was created.
+    &quot;revisionId&quot;: &quot;A String&quot;, # Output only. Immutable. The revision ID of the schema.
+    &quot;type&quot;: &quot;A String&quot;, # The type of the schema definition.
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A schema resource.
+  &quot;definition&quot;: &quot;A String&quot;, # The definition of the schema. This should contain a string representing the full definition of the schema that is a valid schema definition of the type specified in `type`.
+  &quot;name&quot;: &quot;A String&quot;, # Required. Name of the schema. Format is `projects/{project}/schemas/{schema}`.
+  &quot;revisionCreateTime&quot;: &quot;A String&quot;, # Output only. The timestamp that the revision was created.
+  &quot;revisionId&quot;: &quot;A String&quot;, # Output only. Immutable. The revision ID of the schema.
+  &quot;type&quot;: &quot;A String&quot;, # The type of the schema definition.
+}</pre>
+</div>
+
 <div class="method">
     <code class="details" id="create">create(parent, body=None, schemaId=None, x__xgafv=None)</code>
   <pre>Creates a schema.
@@ -166,6 +217,30 @@ <h3>Method Details</h3>
 }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="deleteRevision">deleteRevision(name, revisionId=None, x__xgafv=None)</code>
+  <pre>Deletes a specific schema revision.
+
+Args:
+  name: string, Required. The name of the schema revision to be deleted, with a revision ID explicitly included. Example: projects/123/schemas/my-schema@c7cfa2a8 (required)
+  revisionId: string, Required. The revision ID to roll back to. It must be a revision of the same schema. Example: c7cfa2a8
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A schema resource.
+  &quot;definition&quot;: &quot;A String&quot;, # The definition of the schema. This should contain a string representing the full definition of the schema that is a valid schema definition of the type specified in `type`.
+  &quot;name&quot;: &quot;A String&quot;, # Required. Name of the schema. Format is `projects/{project}/schemas/{schema}`.
+  &quot;revisionCreateTime&quot;: &quot;A String&quot;, # Output only. The timestamp that the revision was created.
+  &quot;revisionId&quot;: &quot;A String&quot;, # Output only. Immutable. The revision ID of the schema.
+  &quot;type&quot;: &quot;A String&quot;, # The type of the schema definition.
+}</pre>
+</div>
+
 <div class="method">
     <code class="details" id="get">get(name, view=None, x__xgafv=None)</code>
   <pre>Gets a schema.
@@ -264,6 +339,55 @@ <h3>Method Details</h3>
 }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="listRevisions">listRevisions(name, pageSize=None, pageToken=None, view=None, x__xgafv=None)</code>
+  <pre>Lists all schema revisions for the named schema.
+
+Args:
+  name: string, Required. The name of the schema to list revisions for. (required)
+  pageSize: integer, The maximum number of revisions to return per page.
+  pageToken: string, The page token, received from a previous ListSchemaRevisions call. Provide this to retrieve the subsequent page.
+  view: string, The set of Schema fields to return in the response. If not set, returns Schemas with `name` and `type`, but not `definition`. Set to `FULL` to retrieve all fields.
+    Allowed values
+      SCHEMA_VIEW_UNSPECIFIED - The default / unset value. The API will default to the BASIC view.
+      BASIC - Include the name and type of the schema, but not the definition.
+      FULL - Include all Schema object fields.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for the `ListSchemaRevisions` method.
+  &quot;nextPageToken&quot;: &quot;A String&quot;, # A token that can be sent as `page_token` to retrieve the next page. If this field is empty, there are no subsequent pages.
+  &quot;schemas&quot;: [ # The revisions of the schema.
+    { # A schema resource.
+      &quot;definition&quot;: &quot;A String&quot;, # The definition of the schema. This should contain a string representing the full definition of the schema that is a valid schema definition of the type specified in `type`.
+      &quot;name&quot;: &quot;A String&quot;, # Required. Name of the schema. Format is `projects/{project}/schemas/{schema}`.
+      &quot;revisionCreateTime&quot;: &quot;A String&quot;, # Output only. The timestamp that the revision was created.
+      &quot;revisionId&quot;: &quot;A String&quot;, # Output only. Immutable. The revision ID of the schema.
+      &quot;type&quot;: &quot;A String&quot;, # The type of the schema definition.
+    },
+  ],
+}</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="listRevisions_next">listRevisions_next()</code>
+  <pre>Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call &#x27;execute()&#x27; on to request the next
+          page. Returns None if there are no more items in the collection.
+        </pre>
+</div>
+
 <div class="method">
     <code class="details" id="list_next">list_next()</code>
   <pre>Retrieves the next page of results.
@@ -278,6 +402,36 @@ <h3>Method Details</h3>
         </pre>
 </div>
 
+<div class="method">
+    <code class="details" id="rollback">rollback(name, body=None, x__xgafv=None)</code>
+  <pre>Creates a new schema revision that is a copy of the provided revision_id.
+
+Args:
+  name: string, Required. The schema being rolled back with revision id. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request for the `RollbackSchema` method.
+  &quot;revisionId&quot;: &quot;A String&quot;, # Required. The revision ID to roll back to. It must be a revision of the same schema. Example: c7cfa2a8
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A schema resource.
+  &quot;definition&quot;: &quot;A String&quot;, # The definition of the schema. This should contain a string representing the full definition of the schema that is a valid schema definition of the type specified in `type`.
+  &quot;name&quot;: &quot;A String&quot;, # Required. Name of the schema. Format is `projects/{project}/schemas/{schema}`.
+  &quot;revisionCreateTime&quot;: &quot;A String&quot;, # Output only. The timestamp that the revision was created.
+  &quot;revisionId&quot;: &quot;A String&quot;, # Output only. Immutable. The revision ID of the schema.
+  &quot;type&quot;: &quot;A String&quot;, # The type of the schema definition.
+}</pre>
+</div>
+
 <div class="method">
     <code class="details" id="setIamPolicy">setIamPolicy(resource, body=None, x__xgafv=None)</code>
   <pre>Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.