docs: Mark revision_id in CommitSchemaRevisionRequest as deprecated (#…

…861)

* docs: Mark revision_id in CommitSchemaRevisionRequest deprecated

PiperOrigin-RevId: 508076213

Source-Link: googleapis/googleapis@3b9ae88

Source-Link: googleapis/googleapis-gen@d5e2649
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZDVlMjY0OTJkZTkxMDBlYjJjZjY4NmVhN2JjY2YyNDk4YjY2MDBkNCJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

google/pubsub_v1/services/schema_service/async_client.py

@@ -931,7 +931,6 @@ async def sample_delete_schema_revision():
  # Initialize request argument(s)
  request = pubsub_v1.DeleteSchemaRevisionRequest(
  name="name_value",
- revision_id="revision_id_value",
  )
 
  # Make the request
@@ -945,20 +944,18 @@ async def sample_delete_schema_revision():
  The request object. Request for the
  `DeleteSchemaRevision` method.
  name (:class:`str`):
- Required. The name of the schema
- revision to be deleted, with a revision
- ID explicitly included.
- Example:
- projects/123/schemas/my-schema@c7cfa2a8
+ Required. The name of the schema revision to be deleted,
+ with a revision ID explicitly included.
+
+ Example: ``projects/123/schemas/my-schema@c7cfa2a8``
 
  This corresponds to the ``name`` field
  on the ``request`` instance; if ``request`` is provided, this
  should not be set.
  revision_id (:class:`str`):
- Required. The revision ID to roll
- back to. It must be a revision of the
- same schema.
- Example: c7cfa2a8
+ Optional. This field is deprecated and should not be
+ used for specifying the revision ID. The revision ID
+ should be specified via the ``name`` parameter.
 
  This corresponds to the ``revision_id`` field
  on the ``request`` instance; if ``request`` is provided, this

google/pubsub_v1/services/schema_service/client.py

@@ -1163,7 +1163,6 @@ def sample_delete_schema_revision():
  # Initialize request argument(s)
  request = pubsub_v1.DeleteSchemaRevisionRequest(
  name="name_value",
- revision_id="revision_id_value",
  )
 
  # Make the request
@@ -1177,20 +1176,18 @@ def sample_delete_schema_revision():
  The request object. Request for the
  `DeleteSchemaRevision` method.
  name (str):
- Required. The name of the schema
- revision to be deleted, with a revision
- ID explicitly included.
- Example:
- projects/123/schemas/my-schema@c7cfa2a8
+ Required. The name of the schema revision to be deleted,
+ with a revision ID explicitly included.
+
+ Example: ``projects/123/schemas/my-schema@c7cfa2a8``
 
  This corresponds to the ``name`` field
  on the ``request`` instance; if ``request`` is provided, this
  should not be set.
  revision_id (str):
- Required. The revision ID to roll
- back to. It must be a revision of the
- same schema.
- Example: c7cfa2a8
+ Optional. This field is deprecated and should not be
+ used for specifying the revision ID. The revision ID
+ should be specified via the ``name`` parameter.
 
  This corresponds to the ``revision_id`` field
  on the ``request`` instance; if ``request`` is provided, this

google/pubsub_v1/types/schema.py

@@ -385,15 +385,14 @@ class DeleteSchemaRevisionRequest(proto.Message):
 
  Attributes:
  name (str):
- Required. The name of the schema revision to
- be deleted, with a revision ID explicitly
- included.
- Example: projects/123/schemas/my-schema@c7cfa2a8
- revision_id (str):
- Required. The revision ID to roll back to.
- It must be a revision of the same schema.
+ Required. The name of the schema revision to be deleted,
+ with a revision ID explicitly included.
 
- Example: c7cfa2a8
+ Example: ``projects/123/schemas/my-schema@c7cfa2a8``
+ revision_id (str):
+ Optional. This field is deprecated and should not be used
+ for specifying the revision ID. The revision ID should be
+ specified via the ``name`` parameter.
  """
 
  name: str = proto.Field(

samples/generated_samples/pubsub_v1_generated_schema_service_delete_schema_revision_async.py

@@ -41,7 +41,6 @@ async def sample_delete_schema_revision():
  # Initialize request argument(s)
  request = pubsub_v1.DeleteSchemaRevisionRequest(
  name="name_value",
- revision_id="revision_id_value",
  )
 
  # Make the request

samples/generated_samples/pubsub_v1_generated_schema_service_delete_schema_revision_sync.py

@@ -41,7 +41,6 @@ def sample_delete_schema_revision():
  # Initialize request argument(s)
  request = pubsub_v1.DeleteSchemaRevisionRequest(
  name="name_value",
- revision_id="revision_id_value",
  )
 
  # Make the request

samples/generated_samples/snippet_metadata_google.pubsub.v1.json

@@ -1845,12 +1845,12 @@
  "regionTag": "pubsub_v1_generated_SchemaService_DeleteSchemaRevision_async",
  "segments": [
  {
- "end": 52,
+ "end": 51,
  "start": 27,
  "type": "FULL"
  },
  {
- "end": 52,
+ "end": 51,
  "start": 27,
  "type": "SHORT"
  },
@@ -1860,18 +1860,18 @@
  "type": "CLIENT_INITIALIZATION"
  },
  {
- "end": 46,
+ "end": 45,
  "start": 41,
  "type": "REQUEST_INITIALIZATION"
  },
  {
- "end": 49,
- "start": 47,
+ "end": 48,
+ "start": 46,
  "type": "REQUEST_EXECUTION"
  },
  {
- "end": 53,
- "start": 50,
+ "end": 52,
+ "start": 49,
  "type": "RESPONSE_HANDLING"
  }
  ],
@@ -1929,12 +1929,12 @@
  "regionTag": "pubsub_v1_generated_SchemaService_DeleteSchemaRevision_sync",
  "segments": [
  {
- "end": 52,
+ "end": 51,
  "start": 27,
  "type": "FULL"
  },
  {
- "end": 52,
+ "end": 51,
  "start": 27,
  "type": "SHORT"
  },
@@ -1944,18 +1944,18 @@
  "type": "CLIENT_INITIALIZATION"
  },
  {
- "end": 46,
+ "end": 45,
  "start": 41,
  "type": "REQUEST_INITIALIZATION"
  },
  {
- "end": 49,
- "start": 47,
+ "end": 48,
+ "start": 46,
  "type": "REQUEST_EXECUTION"
  },
  {
- "end": 53,
- "start": 50,
+ "end": 52,
+ "start": 49,
  "type": "RESPONSE_HANDLING"
  }
  ],