Skip to content

Commit

Permalink
feat(metastore): update the api
Browse files Browse the repository at this point in the history
#### metastore:v1

The following keys were deleted:
- schemas.Restore.properties.backupLocation.type (Total Keys: 1)

The following keys were added:
- resources.projects.resources.locations.resources.services.methods.alterTableProperties (Total Keys: 12)
- schemas.AlterTablePropertiesRequest (Total Keys: 7)

#### metastore:v1alpha

The following keys were deleted:
- schemas.Restore.properties.backupLocation.type (Total Keys: 1)

The following keys were added:
- resources.projects.resources.locations.resources.services.methods.alterTableProperties (Total Keys: 12)
- schemas.AlterTablePropertiesRequest (Total Keys: 7)

#### metastore:v1beta

The following keys were deleted:
- schemas.Restore.properties.backupLocation.type (Total Keys: 1)

The following keys were added:
- resources.projects.resources.locations.resources.services.methods.alterTableProperties (Total Keys: 12)
- schemas.AlterTablePropertiesRequest (Total Keys: 7)
  • Loading branch information
yoshi-automation committed Dec 12, 2023
1 parent 14b8076 commit 03d9f29
Show file tree
Hide file tree
Showing 9 changed files with 303 additions and 36 deletions.
Expand Up @@ -185,7 +185,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down Expand Up @@ -376,7 +375,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down Expand Up @@ -555,7 +553,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down
53 changes: 49 additions & 4 deletions docs/dyn/metastore_v1.projects.locations.services.html
Expand Up @@ -87,6 +87,9 @@ <h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#alterLocation">alterLocation(service, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Alter metadata resource location. The metadata resource can be a database, table, or partition. This functionality only updates the parent directory for the respective metadata resource and does not transfer any existing data to the new location.</p>
<p class="toc_element">
<code><a href="#alterTableProperties">alterTableProperties(service, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Alter metadata table properties.</p>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
Expand Down Expand Up @@ -173,6 +176,52 @@ <h3>Method Details</h3>
}</pre>
</div>

<div class="method">
<code class="details" id="alterTableProperties">alterTableProperties(service, body=None, x__xgafv=None)</code>
<pre>Alter metadata table properties.

Args:
service: string, Required. The relative resource name of the Dataproc Metastore service that&#x27;s being used to mutate metadata table properties, in the following format:projects/{project_id}/locations/{location_id}/services/{service_id}. (required)
body: object, The request body.
The object takes the form of:

{ # Request message for DataprocMetastore.AlterTableProperties.
&quot;properties&quot;: { # A map that describes the desired values to mutate. If update_mask is empty, the properties will not update. Otherwise, the properties only alters the value whose associated paths exist in the update mask
&quot;a_key&quot;: &quot;A String&quot;,
},
&quot;tableName&quot;: &quot;A String&quot;, # Required. The name of the table containing the properties you&#x27;re altering in the following format.databases/{database_id}/tables/{table_id}
&quot;updateMask&quot;: &quot;A String&quot;, # A field mask that specifies the metadata table properties that are overwritten by the update. Fields specified in the update_mask are relative to the resource (not to the full request). A field is overwritten if it is in the mask.For example, given the target properties: properties { a: 1 b: 2 } And an update properties: properties { a: 2 b: 3 c: 4 } then if the field mask is:paths: &quot;properties.b&quot;, &quot;properties.c&quot;then the result will be: properties { a: 1 b: 3 c: 4 }
}

x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format

Returns:
An object of the form:

{ # This resource represents a long-running operation that is the result of a network API call.
&quot;done&quot;: True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
&quot;error&quot;: { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
&quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
&quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
},
],
&quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
},
&quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
},
&quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}.
&quot;response&quot;: { # The normal, successful response of the operation. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
},
}</pre>
</div>

<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
Expand Down Expand Up @@ -251,7 +300,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down Expand Up @@ -476,7 +524,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down Expand Up @@ -646,7 +693,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down Expand Up @@ -819,7 +865,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down
Expand Up @@ -196,7 +196,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down Expand Up @@ -396,7 +395,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down Expand Up @@ -584,7 +582,6 @@ <h3>Method Details</h3>
&quot;restores&quot;: [ # Output only. The latest restores of the metastore service.
{ # The details of a metadata restore operation.
&quot;backup&quot;: &quot;A String&quot;, # Output only. The relative resource name of the metastore service backup to restore from, in the following form:projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
&quot;backupLocation&quot;: &quot;A String&quot;, # Optional. A Cloud Storage URI specifying where the backup artifacts are stored, in the format gs:///.
&quot;details&quot;: &quot;A String&quot;, # Output only. The restore details containing the revision of the service to be restored to, in format of JSON.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time when the restore ended.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. The time when the restore started.
Expand Down

0 comments on commit 03d9f29

Please sign in to comment.