Returns the backups Resource.
alterLocation(service, body=None, x__xgafv=None)
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.
alterTableProperties(service, body=None, x__xgafv=None)
Alter metadata table properties.
Close httplib2 connections.
create(parent, body=None, requestId=None, serviceId=None, x__xgafv=None)
Creates a metastore service in a project and location.
delete(name, requestId=None, x__xgafv=None)
Deletes a single service.
exportMetadata(service, body=None, x__xgafv=None)
Exports metadata from a service.
Gets the details of a single service.
importMetadata(name, body=None, x__xgafv=None)
Imports Metadata into a Dataproc Metastore service.
list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)
Lists services in a project and location.
Retrieves the next page of results.
moveTableToDatabase(service, body=None, x__xgafv=None)
Move a table to another database.
patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)
Updates the parameters of a single service.
queryMetadata(service, body=None, x__xgafv=None)
Query Dataproc Metastore metadata.
restore(service, body=None, x__xgafv=None)
Restores a service from a backup.
alterLocation(service, body=None, x__xgafv=None)
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.
Args:
service: string, Required. The relative resource name of the metastore service to mutate metadata, 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.AlterMetadataResourceLocation.
"locationUri": "A String", # Required. The new location URI for the metadata resource.
"resourceName": "A String", # Required. The relative metadata resource name in the following format.databases/{database_id} or databases/{database_id}/tables/{table_id} or databases/{database_id}/tables/{table_id}/partitions/{partition_id}
}
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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}
alterTableProperties(service, body=None, x__xgafv=None)
Alter metadata table properties.
Args:
service: string, Required. The relative resource name of the Dataproc Metastore service that'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.
"properties": { # 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
"a_key": "A String",
},
"tableName": "A String", # Required. The name of the table containing the properties you're altering in the following format.databases/{database_id}/tables/{table_id}
"updateMask": "A String", # 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: "properties.b", "properties.c"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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}
close()
Close httplib2 connections.
create(parent, body=None, requestId=None, serviceId=None, x__xgafv=None)
Creates a metastore service in a project and location.
Args:
parent: string, Required. The relative resource name of the location in which to create a metastore service, in the following form:projects/{project_number}/locations/{location_id}. (required)
body: object, The request body.
The object takes the form of:
{ # A managed metastore service that serves metadata queries.
"createTime": "A String", # Output only. The time when the metastore service was created.
"encryptionConfig": { # Encryption settings for the service. # Immutable. Information used to configure the Dataproc Metastore service to encrypt customer data at rest. Cannot be updated.
},
"endpoints": [ # Output only. The list of endpoints used to access the metastore service.
{ # An endpoint used to access the metastore service.
"endpointUri": "A String", # Output only. The URI of the endpoint used to access the metastore service.
"region": "A String", # Output only. The region where the endpoint is located.
},
],
"hiveMetastoreConfig": { # Specifies configuration information specific to running Hive metastore software as the metastore service. # Configuration information specific to running Hive metastore software as the metastore service.
"auxiliaryVersions": { # Optional. A mapping of Hive metastore version to the auxiliary version configuration. When specified, a secondary Hive metastore service is created along with the primary service. All auxiliary versions must be less than the service's primary version. The key is the auxiliary service name and it must match the regular expression a-z?. This means that the first character must be a lowercase letter, and all the following characters must be hyphens, lowercase letters, or digits, except the last character, which cannot be a hyphen.
"a_key": { # Configuration information for the auxiliary service versions.
"configOverrides": { # A mapping of Hive metastore configuration key-value pairs to apply to the auxiliary Hive metastore (configured in hive-site.xml) in addition to the primary version's overrides. If keys are present in both the auxiliary version's overrides and the primary version's overrides, the value from the auxiliary version's overrides takes precedence.
"a_key": "A String",
},
"endpoints": [ # Output only. The list of endpoints used to access the auxiliary metastore service, includes version and region data.
{ # An endpoint used to access the metastore service.
"endpointUri": "A String", # Output only. The URI of the endpoint used to access the metastore service.
"region": "A String", # Output only. The region where the endpoint is located.
},
],
"version": "A String", # The Hive metastore version of the auxiliary service. It must be less than the primary Hive metastore service's version.
},
},
"configOverrides": { # Optional. A mapping of Hive metastore configuration key-value pairs to apply to the Hive metastore (configured in hive-site.xml). The mappings override system defaults (some keys cannot be overridden). These overrides are also applied to auxiliary versions and can be further customized in the auxiliary version's AuxiliaryVersionConfig.
"a_key": "A String",
},
"endpointProtocol": "A String", # Optional. The protocol to use for the metastore service endpoint. If unspecified, defaults to GRPC.
"version": "A String", # Immutable. The Hive metastore schema version.
},
"labels": { # User-defined labels for the metastore service.
"a_key": "A String",
},
"metadataIntegration": { # Specifies how metastore metadata should be integrated with external services. # Optional. The setting that defines how metastore metadata should be integrated with external services and systems.
"dataCatalogConfig": { # Specifies how metastore metadata should be integrated with the Data Catalog service. # Optional. The integration config for the Data Catalog service.
"enabled": True or False, # Optional. Defines whether the metastore metadata should be synced to Data Catalog. The default value is to disable syncing metastore metadata to Data Catalog.
},
},
"name": "A String", # Immutable. The relative resource name of the metastore service, in the following format:projects/{project_number}/locations/{location_id}/services/{service_id}.
"scalingConfig": { # Represents the scaling configuration of a metastore service. # Optional. Scaling configuration of the metastore service.
"scalingFactor": 42, # Optional. Scaling factor from 1 to 5, increments of 1.
},
"scheduledBackup": { # This specifies the configuration of scheduled backup. # Optional. The configuration of scheduled backup for the metastore service.
"backupLocation": "A String", # Optional. A Cloud Storage URI of a folder, in the format gs:///. A sub-folder containing backup files will be stored below it.
"cronSchedule": "A String", # Optional. The scheduled interval in Cron format, see https://en.wikipedia.org/wiki/Cron The default is empty: scheduled backup is not enabled. Must be specified to enable scheduled backups.
"enabled": True or False, # Optional. Defines whether the scheduled backup is enabled. The default value is false.
"latestBackup": { # The details of the latest scheduled backup. # Output only. The details of the latest scheduled backup.
"backupId": "A String", # Output only. The ID of an in-progress scheduled backup. Empty if no backup is in progress.
"duration": "A String", # Output only. The duration of the backup completion.
"startTime": "A String", # Output only. The time when the backup was started.
"state": "A String", # Output only. The current state of the backup.
},
"nextScheduledTime": "A String", # Output only. The time when the next backups execution is scheduled to start.
"timeZone": "A String", # Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), e.g. America/Los_Angeles or Africa/Abidjan. If left unspecified, the default is UTC.
},
"state": "A String", # Output only. The current state of the metastore service.
"stateMessage": "A String", # Output only. Additional information about the current state of the metastore service, if available.
"uid": "A String", # Output only. The globally unique resource identifier of the metastore service.
"updateTime": "A String", # Output only. The time when the metastore service was last updated.
"warehouseGcsUri": "A String", # Required. A Cloud Storage URI (starting with gs://) that specifies the default warehouse directory of the Hive Metastore.
}
requestId: string, Optional. A request ID. Specify a unique request ID to allow the server to ignore the request if it has completed. The server will ignore subsequent requests that provide a duplicate request ID for at least 60 minutes after the first request.For example, if an initial request times out, followed by another request with the same request ID, the server ignores the second request to prevent the creation of duplicate commitments.The request ID must be a valid UUID (https://en.wikipedia.org/wiki/Universally_unique_identifier#Format) A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
serviceId: string, Required. The ID of the metastore service, which is used as the final component of the metastore service's name.This value must be between 2 and 63 characters long inclusive, begin with a letter, end with a letter or number, and consist of alpha-numeric ASCII characters or hyphens.
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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}
delete(name, requestId=None, x__xgafv=None)
Deletes a single service.
Args:
name: string, Required. The relative resource name of the metastore service to delete, in the following form:projects/{project_number}/locations/{location_id}/services/{service_id}. (required)
requestId: string, Optional. A request ID. Specify a unique request ID to allow the server to ignore the request if it has completed. The server will ignore subsequent requests that provide a duplicate request ID for at least 60 minutes after the first request.For example, if an initial request times out, followed by another request with the same request ID, the server ignores the second request to prevent the creation of duplicate commitments.The request ID must be a valid UUID (https://en.wikipedia.org/wiki/Universally_unique_identifier#Format) A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}
exportMetadata(service, body=None, x__xgafv=None)
Exports metadata from a service.
Args:
service: string, Required. The relative resource name of the metastore service to run export, in the following form: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.ExportMetadata.
"databaseDumpType": "A String", # Optional. The type of the database dump. If unspecified, defaults to MYSQL.
"destinationGcsFolder": "A String", # A Cloud Storage URI of a folder, in the format gs:///. A sub-folder containing exported files will be created below it.
"requestId": "A String", # Optional. A request ID. Specify a unique request ID to allow the server to ignore the request if it has completed. The server will ignore subsequent requests that provide a duplicate request ID for at least 60 minutes after the first request.For example, if an initial request times out, followed by another request with the same request ID, the server ignores the second request to prevent the creation of duplicate commitments.The request ID must be a valid UUID (https://en.wikipedia.org/wiki/Universally_unique_identifier#Format). A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
}
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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}
get(name, x__xgafv=None)
Gets the details of a single service.
Args:
name: string, Required. The relative resource name of the metastore service to retrieve, in the following form:projects/{project_number}/locations/{location_id}/services/{service_id}. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A managed metastore service that serves metadata queries.
"createTime": "A String", # Output only. The time when the metastore service was created.
"encryptionConfig": { # Encryption settings for the service. # Immutable. Information used to configure the Dataproc Metastore service to encrypt customer data at rest. Cannot be updated.
},
"endpoints": [ # Output only. The list of endpoints used to access the metastore service.
{ # An endpoint used to access the metastore service.
"endpointUri": "A String", # Output only. The URI of the endpoint used to access the metastore service.
"region": "A String", # Output only. The region where the endpoint is located.
},
],
"hiveMetastoreConfig": { # Specifies configuration information specific to running Hive metastore software as the metastore service. # Configuration information specific to running Hive metastore software as the metastore service.
"auxiliaryVersions": { # Optional. A mapping of Hive metastore version to the auxiliary version configuration. When specified, a secondary Hive metastore service is created along with the primary service. All auxiliary versions must be less than the service's primary version. The key is the auxiliary service name and it must match the regular expression a-z?. This means that the first character must be a lowercase letter, and all the following characters must be hyphens, lowercase letters, or digits, except the last character, which cannot be a hyphen.
"a_key": { # Configuration information for the auxiliary service versions.
"configOverrides": { # A mapping of Hive metastore configuration key-value pairs to apply to the auxiliary Hive metastore (configured in hive-site.xml) in addition to the primary version's overrides. If keys are present in both the auxiliary version's overrides and the primary version's overrides, the value from the auxiliary version's overrides takes precedence.
"a_key": "A String",
},
"endpoints": [ # Output only. The list of endpoints used to access the auxiliary metastore service, includes version and region data.
{ # An endpoint used to access the metastore service.
"endpointUri": "A String", # Output only. The URI of the endpoint used to access the metastore service.
"region": "A String", # Output only. The region where the endpoint is located.
},
],
"version": "A String", # The Hive metastore version of the auxiliary service. It must be less than the primary Hive metastore service's version.
},
},
"configOverrides": { # Optional. A mapping of Hive metastore configuration key-value pairs to apply to the Hive metastore (configured in hive-site.xml). The mappings override system defaults (some keys cannot be overridden). These overrides are also applied to auxiliary versions and can be further customized in the auxiliary version's AuxiliaryVersionConfig.
"a_key": "A String",
},
"endpointProtocol": "A String", # Optional. The protocol to use for the metastore service endpoint. If unspecified, defaults to GRPC.
"version": "A String", # Immutable. The Hive metastore schema version.
},
"labels": { # User-defined labels for the metastore service.
"a_key": "A String",
},
"metadataIntegration": { # Specifies how metastore metadata should be integrated with external services. # Optional. The setting that defines how metastore metadata should be integrated with external services and systems.
"dataCatalogConfig": { # Specifies how metastore metadata should be integrated with the Data Catalog service. # Optional. The integration config for the Data Catalog service.
"enabled": True or False, # Optional. Defines whether the metastore metadata should be synced to Data Catalog. The default value is to disable syncing metastore metadata to Data Catalog.
},
},
"name": "A String", # Immutable. The relative resource name of the metastore service, in the following format:projects/{project_number}/locations/{location_id}/services/{service_id}.
"scalingConfig": { # Represents the scaling configuration of a metastore service. # Optional. Scaling configuration of the metastore service.
"scalingFactor": 42, # Optional. Scaling factor from 1 to 5, increments of 1.
},
"scheduledBackup": { # This specifies the configuration of scheduled backup. # Optional. The configuration of scheduled backup for the metastore service.
"backupLocation": "A String", # Optional. A Cloud Storage URI of a folder, in the format gs:///. A sub-folder containing backup files will be stored below it.
"cronSchedule": "A String", # Optional. The scheduled interval in Cron format, see https://en.wikipedia.org/wiki/Cron The default is empty: scheduled backup is not enabled. Must be specified to enable scheduled backups.
"enabled": True or False, # Optional. Defines whether the scheduled backup is enabled. The default value is false.
"latestBackup": { # The details of the latest scheduled backup. # Output only. The details of the latest scheduled backup.
"backupId": "A String", # Output only. The ID of an in-progress scheduled backup. Empty if no backup is in progress.
"duration": "A String", # Output only. The duration of the backup completion.
"startTime": "A String", # Output only. The time when the backup was started.
"state": "A String", # Output only. The current state of the backup.
},
"nextScheduledTime": "A String", # Output only. The time when the next backups execution is scheduled to start.
"timeZone": "A String", # Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), e.g. America/Los_Angeles or Africa/Abidjan. If left unspecified, the default is UTC.
},
"state": "A String", # Output only. The current state of the metastore service.
"stateMessage": "A String", # Output only. Additional information about the current state of the metastore service, if available.
"uid": "A String", # Output only. The globally unique resource identifier of the metastore service.
"updateTime": "A String", # Output only. The time when the metastore service was last updated.
"warehouseGcsUri": "A String", # Required. A Cloud Storage URI (starting with gs://) that specifies the default warehouse directory of the Hive Metastore.
}
importMetadata(name, body=None, x__xgafv=None)
Imports Metadata into a Dataproc Metastore service.
Args:
name: string, Immutable. The relative resource name of the metastore service to run import, in the following form: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.CreateMetadataImport.
"databaseDump": { # A specification of the location of and metadata about a database dump from a relational database management system. # Immutable. A database dump from a pre-existing metastore's database.
"gcsUri": "A String", # Required. A Cloud Storage object or folder URI that specifies the source from which to import metadata. It must begin with gs://.
"type": "A String", # Optional. The type of the database dump. If unspecified, defaults to MYSQL.
},
"description": "A String", # Optional. The description of the metadata import.
"requestId": "A String", # Optional. A request ID. Specify a unique request ID to allow the server to ignore the request if it has completed. The server will ignore subsequent requests that provide a duplicate request ID for at least 60 minutes after the first request.For example, if an initial request times out, followed by another request with the same request ID, the server ignores the second request to prevent the creation of duplicate commitments.The request ID must be a valid UUID (https://en.wikipedia.org/wiki/Universally_unique_identifier#Format). A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
}
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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}
list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)
Lists services in a project and location.
Args:
parent: string, Required. The relative resource name of the location of metastore services to list, in the following form:projects/{project_number}/locations/{location_id}. (required)
filter: string, Optional. The filter to apply to list results.
orderBy: string, Optional. Specify the ordering of results as described in Sorting Order (https://cloud.google.com/apis/design/design_patterns#sorting_order). If not specified, the results will be sorted in the default order.
pageSize: integer, Optional. The maximum number of services to return. The response may contain less than the maximum number. If unspecified, no more than 500 services are returned. The maximum value is 1000; values above 1000 are changed to 1000.
pageToken: string, Optional. A page token, received from a previous DataprocMetastore.ListServices call. Provide this token to retrieve the subsequent page.To retrieve the first page, supply an empty page token.When paginating, other parameters provided to DataprocMetastore.ListServices must match the call that provided the page token.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for DataprocMetastore.ListServices.
"nextPageToken": "A String", # A token that can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
"services": [ # The services in the specified location.
{ # A managed metastore service that serves metadata queries.
"createTime": "A String", # Output only. The time when the metastore service was created.
"encryptionConfig": { # Encryption settings for the service. # Immutable. Information used to configure the Dataproc Metastore service to encrypt customer data at rest. Cannot be updated.
},
"endpoints": [ # Output only. The list of endpoints used to access the metastore service.
{ # An endpoint used to access the metastore service.
"endpointUri": "A String", # Output only. The URI of the endpoint used to access the metastore service.
"region": "A String", # Output only. The region where the endpoint is located.
},
],
"hiveMetastoreConfig": { # Specifies configuration information specific to running Hive metastore software as the metastore service. # Configuration information specific to running Hive metastore software as the metastore service.
"auxiliaryVersions": { # Optional. A mapping of Hive metastore version to the auxiliary version configuration. When specified, a secondary Hive metastore service is created along with the primary service. All auxiliary versions must be less than the service's primary version. The key is the auxiliary service name and it must match the regular expression a-z?. This means that the first character must be a lowercase letter, and all the following characters must be hyphens, lowercase letters, or digits, except the last character, which cannot be a hyphen.
"a_key": { # Configuration information for the auxiliary service versions.
"configOverrides": { # A mapping of Hive metastore configuration key-value pairs to apply to the auxiliary Hive metastore (configured in hive-site.xml) in addition to the primary version's overrides. If keys are present in both the auxiliary version's overrides and the primary version's overrides, the value from the auxiliary version's overrides takes precedence.
"a_key": "A String",
},
"endpoints": [ # Output only. The list of endpoints used to access the auxiliary metastore service, includes version and region data.
{ # An endpoint used to access the metastore service.
"endpointUri": "A String", # Output only. The URI of the endpoint used to access the metastore service.
"region": "A String", # Output only. The region where the endpoint is located.
},
],
"version": "A String", # The Hive metastore version of the auxiliary service. It must be less than the primary Hive metastore service's version.
},
},
"configOverrides": { # Optional. A mapping of Hive metastore configuration key-value pairs to apply to the Hive metastore (configured in hive-site.xml). The mappings override system defaults (some keys cannot be overridden). These overrides are also applied to auxiliary versions and can be further customized in the auxiliary version's AuxiliaryVersionConfig.
"a_key": "A String",
},
"endpointProtocol": "A String", # Optional. The protocol to use for the metastore service endpoint. If unspecified, defaults to GRPC.
"version": "A String", # Immutable. The Hive metastore schema version.
},
"labels": { # User-defined labels for the metastore service.
"a_key": "A String",
},
"metadataIntegration": { # Specifies how metastore metadata should be integrated with external services. # Optional. The setting that defines how metastore metadata should be integrated with external services and systems.
"dataCatalogConfig": { # Specifies how metastore metadata should be integrated with the Data Catalog service. # Optional. The integration config for the Data Catalog service.
"enabled": True or False, # Optional. Defines whether the metastore metadata should be synced to Data Catalog. The default value is to disable syncing metastore metadata to Data Catalog.
},
},
"name": "A String", # Immutable. The relative resource name of the metastore service, in the following format:projects/{project_number}/locations/{location_id}/services/{service_id}.
"scalingConfig": { # Represents the scaling configuration of a metastore service. # Optional. Scaling configuration of the metastore service.
"scalingFactor": 42, # Optional. Scaling factor from 1 to 5, increments of 1.
},
"scheduledBackup": { # This specifies the configuration of scheduled backup. # Optional. The configuration of scheduled backup for the metastore service.
"backupLocation": "A String", # Optional. A Cloud Storage URI of a folder, in the format gs:///. A sub-folder containing backup files will be stored below it.
"cronSchedule": "A String", # Optional. The scheduled interval in Cron format, see https://en.wikipedia.org/wiki/Cron The default is empty: scheduled backup is not enabled. Must be specified to enable scheduled backups.
"enabled": True or False, # Optional. Defines whether the scheduled backup is enabled. The default value is false.
"latestBackup": { # The details of the latest scheduled backup. # Output only. The details of the latest scheduled backup.
"backupId": "A String", # Output only. The ID of an in-progress scheduled backup. Empty if no backup is in progress.
"duration": "A String", # Output only. The duration of the backup completion.
"startTime": "A String", # Output only. The time when the backup was started.
"state": "A String", # Output only. The current state of the backup.
},
"nextScheduledTime": "A String", # Output only. The time when the next backups execution is scheduled to start.
"timeZone": "A String", # Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), e.g. America/Los_Angeles or Africa/Abidjan. If left unspecified, the default is UTC.
},
"state": "A String", # Output only. The current state of the metastore service.
"stateMessage": "A String", # Output only. Additional information about the current state of the metastore service, if available.
"uid": "A String", # Output only. The globally unique resource identifier of the metastore service.
"updateTime": "A String", # Output only. The time when the metastore service was last updated.
"warehouseGcsUri": "A String", # Required. A Cloud Storage URI (starting with gs://) that specifies the default warehouse directory of the Hive Metastore.
},
],
"unreachable": [ # Locations that could not be reached.
"A String",
],
}
list_next()
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 'execute()' on to request the next
page. Returns None if there are no more items in the collection.
moveTableToDatabase(service, body=None, x__xgafv=None)
Move a table to another database.
Args:
service: string, Required. The relative resource name of the metastore service to mutate metadata, 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.MoveTableToDatabase.
"dbName": "A String", # Required. The name of the database where the table resides.
"destinationDbName": "A String", # Required. The name of the database where the table should be moved.
"tableName": "A String", # Required. The name of the table to be moved.
}
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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}
patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)
Updates the parameters of a single service.
Args:
name: string, Immutable. The relative resource name of the metastore service, in the following format:projects/{project_number}/locations/{location_id}/services/{service_id}. (required)
body: object, The request body.
The object takes the form of:
{ # A managed metastore service that serves metadata queries.
"createTime": "A String", # Output only. The time when the metastore service was created.
"encryptionConfig": { # Encryption settings for the service. # Immutable. Information used to configure the Dataproc Metastore service to encrypt customer data at rest. Cannot be updated.
},
"endpoints": [ # Output only. The list of endpoints used to access the metastore service.
{ # An endpoint used to access the metastore service.
"endpointUri": "A String", # Output only. The URI of the endpoint used to access the metastore service.
"region": "A String", # Output only. The region where the endpoint is located.
},
],
"hiveMetastoreConfig": { # Specifies configuration information specific to running Hive metastore software as the metastore service. # Configuration information specific to running Hive metastore software as the metastore service.
"auxiliaryVersions": { # Optional. A mapping of Hive metastore version to the auxiliary version configuration. When specified, a secondary Hive metastore service is created along with the primary service. All auxiliary versions must be less than the service's primary version. The key is the auxiliary service name and it must match the regular expression a-z?. This means that the first character must be a lowercase letter, and all the following characters must be hyphens, lowercase letters, or digits, except the last character, which cannot be a hyphen.
"a_key": { # Configuration information for the auxiliary service versions.
"configOverrides": { # A mapping of Hive metastore configuration key-value pairs to apply to the auxiliary Hive metastore (configured in hive-site.xml) in addition to the primary version's overrides. If keys are present in both the auxiliary version's overrides and the primary version's overrides, the value from the auxiliary version's overrides takes precedence.
"a_key": "A String",
},
"endpoints": [ # Output only. The list of endpoints used to access the auxiliary metastore service, includes version and region data.
{ # An endpoint used to access the metastore service.
"endpointUri": "A String", # Output only. The URI of the endpoint used to access the metastore service.
"region": "A String", # Output only. The region where the endpoint is located.
},
],
"version": "A String", # The Hive metastore version of the auxiliary service. It must be less than the primary Hive metastore service's version.
},
},
"configOverrides": { # Optional. A mapping of Hive metastore configuration key-value pairs to apply to the Hive metastore (configured in hive-site.xml). The mappings override system defaults (some keys cannot be overridden). These overrides are also applied to auxiliary versions and can be further customized in the auxiliary version's AuxiliaryVersionConfig.
"a_key": "A String",
},
"endpointProtocol": "A String", # Optional. The protocol to use for the metastore service endpoint. If unspecified, defaults to GRPC.
"version": "A String", # Immutable. The Hive metastore schema version.
},
"labels": { # User-defined labels for the metastore service.
"a_key": "A String",
},
"metadataIntegration": { # Specifies how metastore metadata should be integrated with external services. # Optional. The setting that defines how metastore metadata should be integrated with external services and systems.
"dataCatalogConfig": { # Specifies how metastore metadata should be integrated with the Data Catalog service. # Optional. The integration config for the Data Catalog service.
"enabled": True or False, # Optional. Defines whether the metastore metadata should be synced to Data Catalog. The default value is to disable syncing metastore metadata to Data Catalog.
},
},
"name": "A String", # Immutable. The relative resource name of the metastore service, in the following format:projects/{project_number}/locations/{location_id}/services/{service_id}.
"scalingConfig": { # Represents the scaling configuration of a metastore service. # Optional. Scaling configuration of the metastore service.
"scalingFactor": 42, # Optional. Scaling factor from 1 to 5, increments of 1.
},
"scheduledBackup": { # This specifies the configuration of scheduled backup. # Optional. The configuration of scheduled backup for the metastore service.
"backupLocation": "A String", # Optional. A Cloud Storage URI of a folder, in the format gs:///. A sub-folder containing backup files will be stored below it.
"cronSchedule": "A String", # Optional. The scheduled interval in Cron format, see https://en.wikipedia.org/wiki/Cron The default is empty: scheduled backup is not enabled. Must be specified to enable scheduled backups.
"enabled": True or False, # Optional. Defines whether the scheduled backup is enabled. The default value is false.
"latestBackup": { # The details of the latest scheduled backup. # Output only. The details of the latest scheduled backup.
"backupId": "A String", # Output only. The ID of an in-progress scheduled backup. Empty if no backup is in progress.
"duration": "A String", # Output only. The duration of the backup completion.
"startTime": "A String", # Output only. The time when the backup was started.
"state": "A String", # Output only. The current state of the backup.
},
"nextScheduledTime": "A String", # Output only. The time when the next backups execution is scheduled to start.
"timeZone": "A String", # Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), e.g. America/Los_Angeles or Africa/Abidjan. If left unspecified, the default is UTC.
},
"state": "A String", # Output only. The current state of the metastore service.
"stateMessage": "A String", # Output only. Additional information about the current state of the metastore service, if available.
"uid": "A String", # Output only. The globally unique resource identifier of the metastore service.
"updateTime": "A String", # Output only. The time when the metastore service was last updated.
"warehouseGcsUri": "A String", # Required. A Cloud Storage URI (starting with gs://) that specifies the default warehouse directory of the Hive Metastore.
}
requestId: string, Optional. A request ID. Specify a unique request ID to allow the server to ignore the request if it has completed. The server will ignore subsequent requests that provide a duplicate request ID for at least 60 minutes after the first request.For example, if an initial request times out, followed by another request with the same request ID, the server ignores the second request to prevent the creation of duplicate commitments.The request ID must be a valid UUID (https://en.wikipedia.org/wiki/Universally_unique_identifier#Format) A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
updateMask: string, Required. A field mask used to specify the fields to be overwritten in the metastore service resource 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.
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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}
queryMetadata(service, body=None, x__xgafv=None)
Query Dataproc Metastore metadata.
Args:
service: string, Required. The relative resource name of the metastore service to query metadata, 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.QueryMetadata.
"query": "A String", # Required. A read-only SQL query to execute against the metadata database. The query cannot change or mutate the data.
}
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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}
restore(service, body=None, x__xgafv=None)
Restores a service from a backup.
Args:
service: string, Required. The relative resource name of the metastore service to run restore, in the following form: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.Restore.
"backup": "A String", # Optional. 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}. Mutually exclusive with backup_location, and exactly one of the two must be set.
"backupLocation": "A String", # Optional. A Cloud Storage URI specifying the location of the backup artifacts, namely - backup avro files under "avro/", backup_metastore.json and service.json, in the following form:gs://. Mutually exclusive with backup, and exactly one of the two must be set.
"requestId": "A String", # Optional. A request ID. Specify a unique request ID to allow the server to ignore the request if it has completed. The server will ignore subsequent requests that provide a duplicate request ID for at least 60 minutes after the first request.For example, if an initial request times out, followed by another request with the same request ID, the server ignores the second request to prevent the creation of duplicate commitments.The request ID must be a valid UUID (https://en.wikipedia.org/wiki/Universally_unique_identifier#Format). A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
"restoreType": "A String", # Optional. The type of restore. If unspecified, defaults to METADATA_ONLY.
}
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.
"done": 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.
"error": { # 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.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # 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.
},
"metadata": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
"name": "A String", # 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}.
"response": { # 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.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
}