class_docstr: Hook for Google Cloud Dataproc Metastore APIs.
class_docstr_tok: ["Hook","for","Google","Cloud","Dataproc","Metastore","APIs","."]
docstr: Lists backups in a service.
  
  :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
  :param region: Required. The ID of the Google Cloud region that the service belongs to.
  :param service_id:  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 alphanumeric ASCII characters or
      hyphens.
  
      This corresponds to the ``service_id`` field on the ``request`` instance; if ``request`` is
      provided, this should not be set.
  :param page_size: Optional. The maximum number of backups to
      return. The response may contain less than the
      maximum number. If unspecified, no more than 500
      backups are returned. The maximum value is 1000;
      values above 1000 are changed to 1000.
  :param page_token: Optional. A page token, received from a previous
      [DataprocMetastore.ListBackups][google.cloud.metastore.v1.DataprocMetastore.ListBackups]
      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.ListBackups][google.cloud.metastore.v1.DataprocMetastore.ListBackups]
      must match the call that provided the page token.
  :param filter: Optional. The filter to apply to list
      results.
  :param order_by: 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.
  :param retry: Designation of what errors, if any, should be retried.
  :param timeout: The timeout for this request.
  :param metadata: Strings which should be sent along with the request as metadata.
docstr_tok: ["Lists","backups","in","a","service",".",":","param","project_id",":","Required",".","The","ID","of","the","Google","Cloud","project","that","the","service","belongs","to",".",":","param","region",":","Required",".","The","ID","of","the","Google","Cloud","region","that","the","service","belongs","to",".",":","param","service_id",":","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","alphanumeric","ASCII","characters","or","hyphens",".","This","corresponds","to","the","``","service_id","``","field","on","the","``","request","``","instance",";","if","``","request","``","is","provided",",","this","should","not","be","set",".",":","param","page_size",":","Optional",".","The","maximum","number","of","backups","to","return",".","The","response","may","contain","less","than","the","maximum","number",".","If","unspecified",",","no","more","than","500","backups","are","returned",".","The","maximum","value","is","1000",";","values","above","1000","are","changed","to","1000.",":","param","page_token",":","Optional",".","A","page","token",",","received","from","a","previous","[","DataprocMetastore.ListBackups","]","[","google.cloud.metastore.v1.DataprocMetastore.ListBackups","]","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.ListBackups","]","[","google.cloud.metastore.v1.DataprocMetastore.ListBackups","]","must","match","the","call","that","provided","the","page","token",".",":","param","filter",":","Optional",".","The","filter","to","apply","to","list","results",".",":","param","order_by",":","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",".",":","param","retry",":","Designation","of","what","errors",",","if","any",",","should","be","retried",".",":","param","timeout",":","The","timeout","for","this","request",".",":","param","metadata",":","Strings","which","should","be","sent","along","with","the","request","as","metadata","."]
code: def list_backups(
      self,
      project_id: str,
      region: str,
      service_id: str,
      page_size: int | None = None,
      page_token: str | None = None,
      filter: str | None = None,
      order_by: str | None = None,
      retry: Retry | _MethodDefault = DEFAULT,
      timeout: float | None = None,
      metadata: Sequence[tuple[str, str]] = (),
  ):
      """
      Lists backups in a service.
  
      :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
      :param region: Required. The ID of the Google Cloud region that the service belongs to.
      :param service_id:  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 alphanumeric ASCII characters or
          hyphens.
  
          This corresponds to the ``service_id`` field on the ``request`` instance; if ``request`` is
          provided, this should not be set.
      :param page_size: Optional. The maximum number of backups to
          return. The response may contain less than the
          maximum number. If unspecified, no more than 500
          backups are returned. The maximum value is 1000;
          values above 1000 are changed to 1000.
      :param page_token: Optional. A page token, received from a previous
          [DataprocMetastore.ListBackups][google.cloud.metastore.v1.DataprocMetastore.ListBackups]
          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.ListBackups][google.cloud.metastore.v1.DataprocMetastore.ListBackups]
          must match the call that provided the page token.
      :param filter: Optional. The filter to apply to list
          results.
      :param order_by: 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.
      :param retry: Designation of what errors, if any, should be retried.
      :param timeout: The timeout for this request.
      :param metadata: Strings which should be sent along with the request as metadata.
      """
      parent = f"projects/{project_id}/locations/{region}/services/{service_id}/backups"
  
      client = self.get_dataproc_metastore_client()
      result = client.list_backups(
          request={
              "parent": parent,
              "page_size": page_size,
              "page_token": page_token,
              "filter": filter,
              "order_by": order_by,
          },
          retry=retry,
          timeout=timeout,
          metadata=metadata,
      )
      return result
  
imports: from __future__ import annotations
  from typing import TYPE_CHECKING, Any, Sequence
  from google.api_core.client_options import ClientOptions
  from google.api_core.gapic_v1.method import DEFAULT, _MethodDefault
  from google.cloud.metastore_v1 import DataprocMetastoreClient
  from airflow.exceptions import AirflowException
  from airflow.providers.google.common.consts import CLIENT_INFO
  from airflow.providers.google.common.hooks.base_google import GoogleBaseHook
label_desc: Use image node_id 13 for calling the DataprocMetastoreHook obj's underlying member method code with example usage: obj.list_backups(project_id, region, service_id, page_size, page_token, filter, order_by, retry, timeout, metadata) and returns: result