Skip to content

GetCatalogsRequest

Source code in docs_src/capo_glue/types/get_catalogs_request.py
class GetCatalogsRequest(TypedDict, closed=True):
    parent_catalog_id: NotRequired["capo_glue.types.catalog_id_string.CatalogIdString"]
    """<p>The ID of the parent catalog in which the catalog resides. If none is provided, the Amazon Web Services Account Number is used by default.</p>"""
    next_token: NotRequired["capo_glue.types.token.Token"]
    """<p>A continuation token, if this is a continuation call.</p>"""
    max_results: NotRequired["capo_glue.types.page_size.PageSize"]
    """<p>The maximum number of catalogs to return in one response.</p>"""
    recursive: "capo_glue.types.boolean.Boolean"
    """<p>Whether to list all catalogs across the catalog hierarchy, starting from the <code>ParentCatalogId</code>. Defaults to <code>false</code> . When <code>true</code>, all catalog objects in the <code>ParentCatalogID</code> hierarchy are enumerated in the response.</p>"""
    include_root: NotRequired["capo_glue.types.nullable_boolean.NullableBoolean"]
    """<p>Whether to list the default catalog in the account and region in the response. Defaults to <code>false</code>. When <code>true</code> and <code>ParentCatalogId = NULL | Amazon Web Services Account ID</code>, all catalogs and the default catalog are enumerated in the response.</p> <p>When the <code>ParentCatalogId</code> is not equal to null, and this attribute is passed as <code>false</code> or <code>true</code>, an <code>InvalidInputException</code> is thrown.</p>"""
    has_databases: NotRequired["capo_glue.types.nullable_boolean.NullableBoolean"]
    """<p>When <code>true</code>, the response only includes catalogs that can contain databases. Some catalogs are organizational containers that hold only other catalogs, not databases. When this parameter is set to <code>true</code>, those container-only catalogs are excluded, and only catalogs capable of containing databases are returned. Defaults to <code>false</code>.</p>"""

has_databases instance-attribute

has_databases: NotRequired[NullableBoolean]

When true, the response only includes catalogs that can contain databases. Some catalogs are organizational containers that hold only other catalogs, not databases. When this parameter is set to true, those container-only catalogs are excluded, and only catalogs capable of containing databases are returned. Defaults to false.

include_root instance-attribute

include_root: NotRequired[NullableBoolean]

Whether to list the default catalog in the account and region in the response. Defaults to false. When true and ParentCatalogId = NULL | Amazon Web Services Account ID, all catalogs and the default catalog are enumerated in the response.

When the ParentCatalogId is not equal to null, and this attribute is passed as false or true, an InvalidInputException is thrown.

max_results instance-attribute

max_results: NotRequired[PageSize]

The maximum number of catalogs to return in one response.

next_token instance-attribute

next_token: NotRequired[Token]

A continuation token, if this is a continuation call.

parent_catalog_id instance-attribute

parent_catalog_id: NotRequired[CatalogIdString]

The ID of the parent catalog in which the catalog resides. If none is provided, the Amazon Web Services Account Number is used by default.

recursive instance-attribute

recursive: Boolean

Whether to list all catalogs across the catalog hierarchy, starting from the ParentCatalogId. Defaults to false . When true, all catalog objects in the ParentCatalogID hierarchy are enumerated in the response.