aws_sdk_glue/client/
get_catalogs.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`GetCatalogs`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`parent_catalog_id(impl Into<String>)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::parent_catalog_id) / [`set_parent_catalog_id(Option<String>)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::set_parent_catalog_id):<br>required: **false**<br><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><br>
7    ///   - [`next_token(impl Into<String>)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::next_token) / [`set_next_token(Option<String>)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::set_next_token):<br>required: **false**<br><p>A continuation token, if this is a continuation call.</p><br>
8    ///   - [`max_results(i32)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::max_results) / [`set_max_results(Option<i32>)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::set_max_results):<br>required: **false**<br><p>The maximum number of catalogs to return in one response.</p><br>
9    ///   - [`recursive(bool)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::recursive) / [`set_recursive(Option<bool>)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::set_recursive):<br>required: **false**<br><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><br>
10    ///   - [`include_root(bool)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::include_root) / [`set_include_root(Option<bool>)`](crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::set_include_root):<br>required: **false**<br><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><br>
11    /// - On success, responds with [`GetCatalogsOutput`](crate::operation::get_catalogs::GetCatalogsOutput) with field(s):
12    ///   - [`catalog_list(Vec::<Catalog>)`](crate::operation::get_catalogs::GetCatalogsOutput::catalog_list): <p>An array of <code>Catalog</code> objects. A list of <code>Catalog</code> objects from the specified parent catalog.</p>
13    ///   - [`next_token(Option<String>)`](crate::operation::get_catalogs::GetCatalogsOutput::next_token): <p>A continuation token for paginating the returned list of tokens, returned if the current segment of the list is not the last.</p>
14    /// - On failure, responds with [`SdkError<GetCatalogsError>`](crate::operation::get_catalogs::GetCatalogsError)
15    pub fn get_catalogs(&self) -> crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder {
16        crate::operation::get_catalogs::builders::GetCatalogsFluentBuilder::new(self.handle.clone())
17    }
18}