Interface WebCrawlerConfiguration.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<WebCrawlerConfiguration.Builder,
,WebCrawlerConfiguration> SdkBuilder<WebCrawlerConfiguration.Builder,
,WebCrawlerConfiguration> SdkPojo
- Enclosing class:
WebCrawlerConfiguration
-
Method Summary
Modifier and TypeMethodDescriptiondefault WebCrawlerConfiguration.Builder
authenticationConfiguration
(Consumer<AuthenticationConfiguration.Builder> authenticationConfiguration) Configuration information required to connect to websites using authentication.authenticationConfiguration
(AuthenticationConfiguration authenticationConfiguration) Configuration information required to connect to websites using authentication.crawlDepth
(Integer crawlDepth) The 'depth' or number of levels from the seed level to crawl.maxContentSizePerPageInMegaBytes
(Float maxContentSizePerPageInMegaBytes) The maximum size (in MB) of a web page or attachment to crawl.maxLinksPerPage
(Integer maxLinksPerPage) The maximum number of URLs on a web page to include when crawling a website.maxUrlsPerMinuteCrawlRate
(Integer maxUrlsPerMinuteCrawlRate) The maximum number of URLs crawled per website host per minute.default WebCrawlerConfiguration.Builder
proxyConfiguration
(Consumer<ProxyConfiguration.Builder> proxyConfiguration) Configuration information required to connect to your internal websites via a web proxy.proxyConfiguration
(ProxyConfiguration proxyConfiguration) Configuration information required to connect to your internal websites via a web proxy.urlExclusionPatterns
(String... urlExclusionPatterns) A list of regular expression patterns to exclude certain URLs to crawl.urlExclusionPatterns
(Collection<String> urlExclusionPatterns) A list of regular expression patterns to exclude certain URLs to crawl.urlInclusionPatterns
(String... urlInclusionPatterns) A list of regular expression patterns to include certain URLs to crawl.urlInclusionPatterns
(Collection<String> urlInclusionPatterns) A list of regular expression patterns to include certain URLs to crawl.default WebCrawlerConfiguration.Builder
urls
(Consumer<Urls.Builder> urls) Specifies the seed or starting point URLs of the websites or the sitemap URLs of the websites you want to crawl.Specifies the seed or starting point URLs of the websites or the sitemap URLs of the websites you want to crawl.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
urls
Specifies the seed or starting point URLs of the websites or the sitemap URLs of the websites you want to crawl.
You can include website subdomains. You can list up to 100 seed URLs and up to three sitemap URLs.
You can only crawl websites that use the secure communication protocol, Hypertext Transfer Protocol Secure (HTTPS). If you receive an error when crawling a website, it could be that the website is blocked from crawling.
When selecting websites to index, you must adhere to the Amazon Acceptable Use Policy and all other Amazon terms. Remember that you must only use Amazon Kendra Web Crawler to index your own web pages, or web pages that you have authorization to index.
- Parameters:
urls
- Specifies the seed or starting point URLs of the websites or the sitemap URLs of the websites you want to crawl.You can include website subdomains. You can list up to 100 seed URLs and up to three sitemap URLs.
You can only crawl websites that use the secure communication protocol, Hypertext Transfer Protocol Secure (HTTPS). If you receive an error when crawling a website, it could be that the website is blocked from crawling.
When selecting websites to index, you must adhere to the Amazon Acceptable Use Policy and all other Amazon terms. Remember that you must only use Amazon Kendra Web Crawler to index your own web pages, or web pages that you have authorization to index.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
urls
Specifies the seed or starting point URLs of the websites or the sitemap URLs of the websites you want to crawl.
You can include website subdomains. You can list up to 100 seed URLs and up to three sitemap URLs.
You can only crawl websites that use the secure communication protocol, Hypertext Transfer Protocol Secure (HTTPS). If you receive an error when crawling a website, it could be that the website is blocked from crawling.
When selecting websites to index, you must adhere to the Amazon Acceptable Use Policy and all other Amazon terms. Remember that you must only use Amazon Kendra Web Crawler to index your own web pages, or web pages that you have authorization to index.
This is a convenience method that creates an instance of theUrls.Builder
avoiding the need to create one manually viaUrls.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tourls(Urls)
.- Parameters:
urls
- a consumer that will call methods onUrls.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
crawlDepth
The 'depth' or number of levels from the seed level to crawl. For example, the seed URL page is depth 1 and any hyperlinks on this page that are also crawled are depth 2.
- Parameters:
crawlDepth
- The 'depth' or number of levels from the seed level to crawl. For example, the seed URL page is depth 1 and any hyperlinks on this page that are also crawled are depth 2.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
maxLinksPerPage
The maximum number of URLs on a web page to include when crawling a website. This number is per web page.
As a website’s web pages are crawled, any URLs the web pages link to are also crawled. URLs on a web page are crawled in order of appearance.
The default maximum links per page is 100.
- Parameters:
maxLinksPerPage
- The maximum number of URLs on a web page to include when crawling a website. This number is per web page.As a website’s web pages are crawled, any URLs the web pages link to are also crawled. URLs on a web page are crawled in order of appearance.
The default maximum links per page is 100.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
maxContentSizePerPageInMegaBytes
WebCrawlerConfiguration.Builder maxContentSizePerPageInMegaBytes(Float maxContentSizePerPageInMegaBytes) The maximum size (in MB) of a web page or attachment to crawl.
Files larger than this size (in MB) are skipped/not crawled.
The default maximum size of a web page or attachment is set to 50 MB.
- Parameters:
maxContentSizePerPageInMegaBytes
- The maximum size (in MB) of a web page or attachment to crawl.Files larger than this size (in MB) are skipped/not crawled.
The default maximum size of a web page or attachment is set to 50 MB.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
maxUrlsPerMinuteCrawlRate
The maximum number of URLs crawled per website host per minute.
A minimum of one URL is required.
The default maximum number of URLs crawled per website host per minute is 300.
- Parameters:
maxUrlsPerMinuteCrawlRate
- The maximum number of URLs crawled per website host per minute.A minimum of one URL is required.
The default maximum number of URLs crawled per website host per minute is 300.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
urlInclusionPatterns
A list of regular expression patterns to include certain URLs to crawl. URLs that match the patterns are included in the index. URLs that don't match the patterns are excluded from the index. If a URL matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the URL file isn't included in the index.
- Parameters:
urlInclusionPatterns
- A list of regular expression patterns to include certain URLs to crawl. URLs that match the patterns are included in the index. URLs that don't match the patterns are excluded from the index. If a URL matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the URL file isn't included in the index.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
urlInclusionPatterns
A list of regular expression patterns to include certain URLs to crawl. URLs that match the patterns are included in the index. URLs that don't match the patterns are excluded from the index. If a URL matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the URL file isn't included in the index.
- Parameters:
urlInclusionPatterns
- A list of regular expression patterns to include certain URLs to crawl. URLs that match the patterns are included in the index. URLs that don't match the patterns are excluded from the index. If a URL matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the URL file isn't included in the index.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
urlExclusionPatterns
A list of regular expression patterns to exclude certain URLs to crawl. URLs that match the patterns are excluded from the index. URLs that don't match the patterns are included in the index. If a URL matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the URL file isn't included in the index.
- Parameters:
urlExclusionPatterns
- A list of regular expression patterns to exclude certain URLs to crawl. URLs that match the patterns are excluded from the index. URLs that don't match the patterns are included in the index. If a URL matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the URL file isn't included in the index.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
urlExclusionPatterns
A list of regular expression patterns to exclude certain URLs to crawl. URLs that match the patterns are excluded from the index. URLs that don't match the patterns are included in the index. If a URL matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the URL file isn't included in the index.
- Parameters:
urlExclusionPatterns
- A list of regular expression patterns to exclude certain URLs to crawl. URLs that match the patterns are excluded from the index. URLs that don't match the patterns are included in the index. If a URL matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the URL file isn't included in the index.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
proxyConfiguration
Configuration information required to connect to your internal websites via a web proxy.
You must provide the website host name and port number. For example, the host name of https://a.example.com/page1.html is "a.example.com" and the port is 443, the standard port for HTTPS.
Web proxy credentials are optional and you can use them to connect to a web proxy server that requires basic authentication. To store web proxy credentials, you use a secret in Secrets Manager.
- Parameters:
proxyConfiguration
- Configuration information required to connect to your internal websites via a web proxy.You must provide the website host name and port number. For example, the host name of https://a.example.com/page1.html is "a.example.com" and the port is 443, the standard port for HTTPS.
Web proxy credentials are optional and you can use them to connect to a web proxy server that requires basic authentication. To store web proxy credentials, you use a secret in Secrets Manager.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
proxyConfiguration
default WebCrawlerConfiguration.Builder proxyConfiguration(Consumer<ProxyConfiguration.Builder> proxyConfiguration) Configuration information required to connect to your internal websites via a web proxy.
You must provide the website host name and port number. For example, the host name of https://a.example.com/page1.html is "a.example.com" and the port is 443, the standard port for HTTPS.
Web proxy credentials are optional and you can use them to connect to a web proxy server that requires basic authentication. To store web proxy credentials, you use a secret in Secrets Manager.
This is a convenience method that creates an instance of theProxyConfiguration.Builder
avoiding the need to create one manually viaProxyConfiguration.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toproxyConfiguration(ProxyConfiguration)
.- Parameters:
proxyConfiguration
- a consumer that will call methods onProxyConfiguration.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
authenticationConfiguration
WebCrawlerConfiguration.Builder authenticationConfiguration(AuthenticationConfiguration authenticationConfiguration) Configuration information required to connect to websites using authentication.
You can connect to websites using basic authentication of user name and password. You use a secret in Secrets Manager to store your authentication credentials.
You must provide the website host name and port number. For example, the host name of https://a.example.com/page1.html is "a.example.com" and the port is 443, the standard port for HTTPS.
- Parameters:
authenticationConfiguration
- Configuration information required to connect to websites using authentication.You can connect to websites using basic authentication of user name and password. You use a secret in Secrets Manager to store your authentication credentials.
You must provide the website host name and port number. For example, the host name of https://a.example.com/page1.html is "a.example.com" and the port is 443, the standard port for HTTPS.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
authenticationConfiguration
default WebCrawlerConfiguration.Builder authenticationConfiguration(Consumer<AuthenticationConfiguration.Builder> authenticationConfiguration) Configuration information required to connect to websites using authentication.
You can connect to websites using basic authentication of user name and password. You use a secret in Secrets Manager to store your authentication credentials.
You must provide the website host name and port number. For example, the host name of https://a.example.com/page1.html is "a.example.com" and the port is 443, the standard port for HTTPS.
This is a convenience method that creates an instance of theAuthenticationConfiguration.Builder
avoiding the need to create one manually viaAuthenticationConfiguration.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toauthenticationConfiguration(AuthenticationConfiguration)
.- Parameters:
authenticationConfiguration
- a consumer that will call methods onAuthenticationConfiguration.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-