Skip to content

Commit 25fa0e2

Browse files
feat(healthcare): update the api
#### healthcare:v1 The following keys were added: - resources.projects.resources.locations.resources.datasets.resources.hl7V2Stores.methods.export (Total Keys: 12) - resources.projects.resources.locations.resources.datasets.resources.hl7V2Stores.methods.import (Total Keys: 12) - schemas.ExportMessagesRequest (Total Keys: 7) - schemas.ExportMessagesResponse (Total Keys: 2) - schemas.GcsDestination (Total Keys: 5) - schemas.GcsSource (Total Keys: 3) - schemas.ImportMessagesRequest (Total Keys: 3) - schemas.ImportMessagesResponse (Total Keys: 2)
1 parent 3c29322 commit 25fa0e2

File tree

3 files changed

+254
-2
lines changed

3 files changed

+254
-2
lines changed

docs/dyn/healthcare_v1.projects.locations.datasets.hl7V2Stores.html

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,12 +88,18 @@ <h2>Instance Methods</h2>
8888
<p class="toc_element">
8989
<code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
9090
<p class="firstline">Deletes the specified HL7v2 store and removes all messages that it contains.</p>
91+
<p class="toc_element">
92+
<code><a href="#export">export(name, body=None, x__xgafv=None)</a></code></p>
93+
<p class="firstline">Exports the messages to a destination. To filter messages to be exported, define a filter using the start and end time, relative to the message generation time (MSH.7). This API returns an Operation that can be used to track the status of the job by calling GetOperation. Immediate fatal errors appear in the error field. Otherwise, when the operation finishes, a detailed response of type ExportMessagesResponse is returned in the response field. The metadata field type for this operation is OperationMetadata.</p>
9194
<p class="toc_element">
9295
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
9396
<p class="firstline">Gets the specified HL7v2 store.</p>
9497
<p class="toc_element">
9598
<code><a href="#getIamPolicy">getIamPolicy(resource, options_requestedPolicyVersion=None, x__xgafv=None)</a></code></p>
9699
<p class="firstline">Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.</p>
100+
<p class="toc_element">
101+
<code><a href="#import_">import_(name, body=None, x__xgafv=None)</a></code></p>
102+
<p class="firstline">Import messages to the HL7v2 store by loading data from the specified sources. This method is optimized to load large quantities of data using import semantics that ignore some HL7v2 store configuration options and are not suitable for all use cases. It is primarily intended to load data into an empty HL7v2 store that is not being used by other clients. An existing message will be overwritten if a duplicate message is imported. A duplicate message is a message with the same raw bytes as a message that already exists in this HL7v2 store. When a message is overwritten, its labels will also be overwritten. The import operation is idempotent unless the input data contains multiple valid messages with the same raw bytes but different labels. In that case, after the import completes, the store contains exactly one message with those raw bytes but there is no ordering guarantee on which version of the labels it has. The operation result counters do not count duplicated raw bytes as an error and count one success for each message in the input, which might result in a success count larger than the number of messages in the HL7v2 store. If some messages fail to import, for example due to parsing errors, successfully imported messages are not rolled back. This method returns an Operation that can be used to track the status of the import by calling GetOperation. Immediate fatal errors appear in the error field, errors are also logged to Cloud Logging (see [Viewing error logs in Cloud Logging](https://cloud.google.com/healthcare/docs/how-tos/logging)). Otherwise, when the operation finishes, a response of type ImportMessagesResponse is returned in the response field. The metadata field type for this operation is OperationMetadata.</p>
97103
<p class="toc_element">
98104
<code><a href="#list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
99105
<p class="firstline">Lists the HL7v2 stores in the given dataset.</p>
@@ -306,6 +312,54 @@ <h3>Method Details</h3>
306312
}</pre>
307313
</div>
308314

315+
<div class="method">
316+
<code class="details" id="export">export(name, body=None, x__xgafv=None)</code>
317+
<pre>Exports the messages to a destination. To filter messages to be exported, define a filter using the start and end time, relative to the message generation time (MSH.7). This API returns an Operation that can be used to track the status of the job by calling GetOperation. Immediate fatal errors appear in the error field. Otherwise, when the operation finishes, a detailed response of type ExportMessagesResponse is returned in the response field. The metadata field type for this operation is OperationMetadata.
318+
319+
Args:
320+
name: string, The name of the source HL7v2 store, in the format `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7v2Stores/{hl7v2_store_id}` (required)
321+
body: object, The request body.
322+
The object takes the form of:
323+
324+
{ # Request to schedule an export.
325+
&quot;endTime&quot;: &quot;A String&quot;, # The end of the range in `send_time` (MSH.7, https://www.hl7.org/documentcenter/public_temp_2E58C1F9-1C23-BA17-0C6126475344DA9D/wg/conf/HL7MSH.htm) to process. If not specified, the time when the export is scheduled is used. This value has to come after the `start_time` defined below. Only messages whose `send_time` lies in the range `start_time` (inclusive) to `end_time` (exclusive) are exported.
326+
&quot;gcsDestination&quot;: { # The Cloud Storage output destination. The Cloud Healthcare Service Agent requires the `roles/storage.objectAdmin` Cloud IAM roles on the Cloud Storage location. # Export to a Cloud Storage destination.
327+
&quot;contentStructure&quot;: &quot;A String&quot;, # The format of the exported HL7v2 message files.
328+
&quot;messageView&quot;: &quot;A String&quot;, # Specifies the parts of the Message resource to include in the export. If not specified, FULL is used.
329+
&quot;uriPrefix&quot;: &quot;A String&quot;, # URI of an existing Cloud Storage directory where the server writes result files, in the format `gs://{bucket-id}/{path/to/destination/dir}`. If there is no trailing slash, the service appends one when composing the object path.
330+
},
331+
&quot;startTime&quot;: &quot;A String&quot;, # The start of the range in `send_time` (MSH.7, https://www.hl7.org/documentcenter/public_temp_2E58C1F9-1C23-BA17-0C6126475344DA9D/wg/conf/HL7MSH.htm) to process. If not specified, the UNIX epoch (1970-01-01T00:00:00Z) is used. This value has to come before the `end_time` defined below. Only messages whose `send_time` lies in the range `start_time` (inclusive) to `end_time` (exclusive) are exported.
332+
}
333+
334+
x__xgafv: string, V1 error format.
335+
Allowed values
336+
1 - v1 error format
337+
2 - v2 error format
338+
339+
Returns:
340+
An object of the form:
341+
342+
{ # This resource represents a long-running operation that is the result of a network API call.
343+
&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.
344+
&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.
345+
&quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
346+
&quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
347+
{
348+
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
349+
},
350+
],
351+
&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.
352+
},
353+
&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.
354+
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
355+
},
356+
&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}`.
357+
&quot;response&quot;: { # The normal response of the operation in case of success. 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`.
358+
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
359+
},
360+
}</pre>
361+
</div>
362+
309363
<div class="method">
310364
<code class="details" id="get">get(name, x__xgafv=None)</code>
311365
<pre>Gets the specified HL7v2 store.
@@ -446,6 +500,50 @@ <h3>Method Details</h3>
446500
}</pre>
447501
</div>
448502

503+
<div class="method">
504+
<code class="details" id="import_">import_(name, body=None, x__xgafv=None)</code>
505+
<pre>Import messages to the HL7v2 store by loading data from the specified sources. This method is optimized to load large quantities of data using import semantics that ignore some HL7v2 store configuration options and are not suitable for all use cases. It is primarily intended to load data into an empty HL7v2 store that is not being used by other clients. An existing message will be overwritten if a duplicate message is imported. A duplicate message is a message with the same raw bytes as a message that already exists in this HL7v2 store. When a message is overwritten, its labels will also be overwritten. The import operation is idempotent unless the input data contains multiple valid messages with the same raw bytes but different labels. In that case, after the import completes, the store contains exactly one message with those raw bytes but there is no ordering guarantee on which version of the labels it has. The operation result counters do not count duplicated raw bytes as an error and count one success for each message in the input, which might result in a success count larger than the number of messages in the HL7v2 store. If some messages fail to import, for example due to parsing errors, successfully imported messages are not rolled back. This method returns an Operation that can be used to track the status of the import by calling GetOperation. Immediate fatal errors appear in the error field, errors are also logged to Cloud Logging (see [Viewing error logs in Cloud Logging](https://cloud.google.com/healthcare/docs/how-tos/logging)). Otherwise, when the operation finishes, a response of type ImportMessagesResponse is returned in the response field. The metadata field type for this operation is OperationMetadata.
506+
507+
Args:
508+
name: string, The name of the target HL7v2 store, in the format `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7v2Stores/{hl7v2_store_id}` (required)
509+
body: object, The request body.
510+
The object takes the form of:
511+
512+
{ # Request to import messages.
513+
&quot;gcsSource&quot;: { # Specifies the configuration for importing data from Cloud Storage. # Cloud Storage source data location and import configuration. The Cloud Healthcare Service Agent requires the `roles/storage.objectViewer` Cloud IAM roles on the Cloud Storage location.
514+
&quot;uri&quot;: &quot;A String&quot;, # Points to a Cloud Storage URI containing file(s) to import. The URI must be in the following format: `gs://{bucket_id}/{object_id}`. The URI can include wildcards in `object_id` and thus identify multiple files. Supported wildcards: * `*` to match 0 or more non-separator characters * `**` to match 0 or more characters (including separators). Must be used at the end of a path and with no other wildcards in the path. Can also be used with a file extension (such as .ndjson), which imports all files with the extension in the specified directory and its sub-directories. For example, `gs://my-bucket/my-directory/**.ndjson` imports all files with `.ndjson` extensions in `my-directory/` and its sub-directories. * `?` to match 1 character Files matching the wildcard are expected to contain content only, no metadata.
515+
},
516+
}
517+
518+
x__xgafv: string, V1 error format.
519+
Allowed values
520+
1 - v1 error format
521+
2 - v2 error format
522+
523+
Returns:
524+
An object of the form:
525+
526+
{ # This resource represents a long-running operation that is the result of a network API call.
527+
&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.
528+
&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.
529+
&quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
530+
&quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
531+
{
532+
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
533+
},
534+
],
535+
&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.
536+
},
537+
&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.
538+
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
539+
},
540+
&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}`.
541+
&quot;response&quot;: { # The normal response of the operation in case of success. 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`.
542+
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
543+
},
544+
}</pre>
545+
</div>
546+
449547
<div class="method">
450548
<code class="details" id="list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
451549
<pre>Lists the HL7v2 stores in the given dataset.

0 commit comments

Comments
 (0)