<results>
<status rid="itzL7rkoeQojlvk=" time-ms="34"/>
<hits found="3" start="0">
<hit id="tt1142977">
<field name="rating">6.9</field>
<field name="genres">Animation</field>
<field name="genres">Comedy</field>
<field name="genres">Family</field>
<field name="genres">Horror</field>
<field name="genres">Sci-Fi</field>
<field name="plot">Young Victor conducts a science experiment to
bring his beloved dog Sparky back to life, only
to face unintended, sometimes monstrous, 
consequences.
</field>
<field name="release_date">2012-09-20T00:00:00Z</field>
<field name="title">Frankenweenie</field>
<field name="rank">1462</field>
<field name="running_time_secs">5220</field>
<field name="directors">Tim Burton</field>
<field name="image_url">http://ia.media-imdb.com/images/M/MV5BMjI
xODY3MjEwNV5BMl5BanBnXkFtZTcwOTMzNjc4Nw@@.
_V1_SX400_.jpg
</field>
<field name="year">2012</field>
<field name="actors">Winona Ryder</field>
<field name="actors">Catherine O'Hara</field>
<field name="actors">Martin Short</field>
</hit>
.
.
.
</hits>
</results>
Setting the response format only affects responses to successful requests.The format of an error response
depends on the origin of the error. Errors returned by the search service are always returned in JSON.
5xx errors due to server timeouts and other request routing problems are returned in XML.When a request
returns an error code, the body of the response contains information about the error that occurred. If an
error occurs while the request body is parsed and validated, the error code is set to 400 and the response
body includes a list of the errors and where they occurred.
Search Response Headers
Content-Type
A standard MIME type describing the format of the object data. For more information, see W3C RFC
2616 Section 14.
Valid values: application/json or application/xml
Default: application/json
Content-Length
The length in bytes of the body in the response.
API Version 2013-01-01
255
Amazon CloudSearch Developer Guide
Search
Pdf export bookmarks - add, remove, update PDF bookmarks in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your C# Project with Rapid PDF Internal Navigation Via Bookmark and Outline
auto bookmark pdf; how to create bookmarks in pdf file
Pdf export bookmarks - VB.NET PDF bookmark library: add, remove, update PDF bookmarks in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your VB.NET Project with Rapid PDF Internal Navigation Via Bookmark and Outline
adding bookmarks to pdf reader; excel pdf bookmarks
Search Response Properties (JSON)
status
Contains the resource id (rid) and the time it took to process the request (time-ms).
rid
The encrypted Resource ID.
time-ms
How long it took to process the search request in milliseconds.
hits
Contains the number of matching documents (found), the index of the first document included in
the response (start), and an array (hit) that lists the document IDs and data for each hit.
found
The total number of hits that match the search request after Amazon CloudSearch finished
processing the request.
start
The index of the first hit returned in this response.
hit
An array that lists the document IDs and data for each hit.
id
The unique identifier for a document.
fields
A list of returned fields.
facets
Contains facet information and facet counts.
FACETFIELD
A field for which facets were calculated.
buckets
An array of the calculated facet values and counts.
value
The facet value being counted.
count
The number of hits that contain the facet value in FACETFIELD.
Search Response Elements (XML)
results
Contains the search results. Any errors that occurred while processing the request are returned as
messages in the info element.
status
Contains the resource id (rid) and the time it took to process the request (time-ms).
hits
Contains hit statistics and a collection of hit elements.The found attribute is the total number of
hits that match the search request after Amazon CloudSearch finished processing the results.
The contained hit elements are ordered according to their relevance scores or the sort option
specified in the search request.
hit
A document that matched the search request.The id attribute is the document's unique id.
Contains a d (data) element for each returned field.
field
A field returned from a hit. Hit elements contain a d (data) element for each returned
field.
API Version 2013-01-01
256
Amazon CloudSearch Developer Guide
Search
VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
document file. Remove bookmarks, annotations, watermark, page labels and article threads from PDF while compressing. Also a preview
bookmark template pdf; create bookmark in pdf automatically
C# PDF File Split Library: Split, seperate PDF into multiple files
Split PDF file by top level bookmarks. The following C# codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
create bookmarks pdf file; create bookmarks in pdf
facets
Contains a facet element for each facet requested in the search request.
facet
Contains a bucket element for each value of a field for which a facet count was
calculated.The facet.FIELD size option can be used to specify how many
constraints to return. By default, facet counts are returned for the top 10 constraints.
The facet.FIELD buckets option can be used to explicitly specify which values
to count.
bucket
A facet field value and the number of occurrences (count) of that value within
the search hits.
Submitting Suggest Requests in Amazon
CloudSearch
You submit suggest requests via HTTP GET to your domain's search endpoint at 2013-01-01/suggest.
For information about controlling access to the suggest service, see Configuring Access for Amazon
CloudSearch (p.29).
You must specify the API version in all suggest requests and that version must match the API version
specified when the domain was created.
For example, the following request gets suggestions from the
search-movies-rr2f34ofg56xneuemujamut52i.us-east-1.cloudsearch.amazonaws.com
domain for the query string oce using the suggester called title.
http://search-imdb-hd6ebyouhw2lczkueyuqksnuzu.us-west-2.cloudsearch.amazon 
aws.com/2013-01-01/suggest -d"q=oce&suggester=suggest_title"
You can use any method you want to send GET requests to your domain's search endpoint—you can
enter the request URL directly in a Web browser, use cURL to submit the request, or generate an HTTP
call using your favorite HTTP library.You can also use the Search Tester in the Amazon CloudSearch
console to get suggestions. For more information, see Searching with the Search Tester (p.11).
Important
A domain's document and search endpoints remain the same for the life of the domain.You
should cache the endpoints rather than retrieving them before every upload or search request.
Querying the Amazon CloudSearch configuration service by calling aws cloudsearch
describe-domains or DescribeDomains before every request is likely to result in your
requests being throttled.
By default, Amazon CloudSearch returns the response in JSON.You can get the results formatted in
XML by specifying the format parameter, format=xml. Setting the response format only affects responses
to successful requests.The format of an error response depends on the origin of the error. Errors returned
by the search service are always returned in JSON. 5xx errors due to server timeouts and other request
routing problems are returned in XML.
API Version 2013-01-01
257
Amazon CloudSearch Developer Guide
Submitting Suggest Requests
VB.NET PDF File Split Library: Split, seperate PDF into multiple
Demo Code in VB.NET. The following VB.NET codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
adding bookmarks to a pdf; acrobat split pdf bookmark
C# PDF File Compress Library: Compress reduce PDF size in C#.net
NET framework. Remove bookmarks, annotations, watermark, page labels and article threads from PDF while compressing. C# class demo
create bookmarks pdf files; add bookmark to pdf reader
Suggest
Suggestion Requests
Suggest Syntax in Amazon CloudSearch
GET /2013-01-01/suggest
Suggest Request Headers in Amazon CloudSearch
HOST
The search request endpoint for the domain you're querying.You can use DescribeDomains (p.178)
to retrieve your domain's search request endpoint.
Required:Yes
Suggest Request Parameters in Amazon CloudSearch
q
The string to get suggestions for.
Type: String
Required:Yes
suggester
The name of the suggester to use to find suggested matches.
Type: String
Required:Yes
size
The maximum number of suggestions to return.
Type: Positive integer
Default: 10
Required: No
format
Specifies the content type of the response.
Type: String
Valid Values: json|xml
Default: json
Required: No
Suggest Response
When a request completes successfully, the response body contains the suggestions. By default,
suggestions are returned in JSON. Set the format parameter to xml to get the results in XML.
API Version 2013-01-01
258
Amazon CloudSearch Developer Guide
Suggest
C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net
Export PDF images to HTML images. The HTML document file, converted by C#.NET PDF to HTML SDK, preserves all the original anchors, links, bookmarks and font
export excel to pdf with bookmarks; bookmark pdf in preview
How to C#: Basic SDK Concept of XDoc.PDF for .NET
document. OutLines. This class describes bookmarks in a PDF document. Copyright © <2000-2016> by <RasterEdge.com>. All Rights Reserved.
how to add bookmark in pdf; how to bookmark a pdf document
Setting the response format only affects responses to successful requests.The format of an error response
depends on the origin of the error. Errors returned by the search service are always returned in JSON.
5xx errors due to server timeouts and other request routing problems are returned in XML.When a request
returns an error code, the body of the response contains information about the error that occurred. If an
error occurs while the request body is parsed and validated, the error code is set to 400 and the response
body includes a list of the errors and where they occurred.
The following example shows a JSON response to a request for suggestions:
{
"status": {
"rid": "qOSM5s0oCwr8pVk=",
"time-ms": 2
},
"suggest": {
"query": "oce",
"found": 3,
"suggestions": [
{
"suggestion": "Ocean's Eleven",
"score": 0,
"id": "tt0054135"
},
{
"suggestion": "Ocean's Thirteen",
"score": 0,
"id": "tt0496806"
},
{
"suggestion": "Ocean's Twelve",
"score": 0,
"id": "tt0349903"
}
]
}
}
The following example shows the equivalent XML response:
<results>
<status rid="/pSz580oDQr8pVk=" time-ms="2"/>
<suggest query="oce" found="3">
<suggestions>
<item suggestion="Ocean's Eleven" score="0" id="tt0054135"/>
<item suggestion="Ocean's Thirteen" score="0" id="tt0496806"/>
<item suggestion="Ocean's Twelve" score="0" id="tt0349903"/>
</suggestions>
</suggest>
</results>
Search Service Errors
A search or suggestion request can return three types of status codes:
API Version 2013-01-01
259
Amazon CloudSearch Developer Guide
Search Service Errors
VB.NET PDF: Basic SDK Concept of XDoc.PDF
document. OutLines. This class describes bookmarks in a PDF document. Copyright © <2000-2015> by <RasterEdge.com>. All Rights Reserved.
convert word pdf bookmarks; bookmarks pdf file
C# Create PDF Library SDK to convert PDF from other file formats
file. Create and save editable PDF with a blank page, bookmarks, links, signatures, etc. Create fillable PDF document with fields.
how to bookmark a pdf file; copy pdf bookmarks
• 5xx status codes indicate that there was an internal server error.You should catch and retry all 5xx
error codes as they typically represent transient error conditions. For more information, see Handling
Errors (p.138).
• 4xx status codes indicate that the request was malformed. Correct the error(s) before resubmitting your
request.
• 2xx status codes indicate that the request was processed successfully.
The format of an error response depends on the origin of the error. Errors returned by the search service
are always returned in JSON. 5xx errors due to server timeouts and other request routing problems are
returned in XML.
Errors returned by the search service contain the following information:
error
Contains an error message returned by the search service.The code and msg properties are included
for each error.
code
The error code.
msg
A description of the error that was returned by the search service.
API Version 2013-01-01
260
Amazon CloudSearch Developer Guide
Search Service Errors
Troubleshooting Amazon
CloudSearch
The following topics describe solutions to problems you might encounter when using Amazon CloudSearch.
Topics
• Uploading Documents  (p.261)
• Deleting All Documents in an Amazon CloudSearch Domain (p.262)
• Amazon CloudSearch Domain Not Scaling Down After Deleting Documents (p.262)
• Document Update Latency (p.262)
• Large Number of 5xx Errors When Uploading Documents to an Amazon CloudSearch Domain (p.263)
• Search Latency and Timeouts in Amazon CloudSearch (p.263)
• Search Latency for Faceted Queries in Amazon CloudSearch (p.263)
• Sudden Increase in 5xx Errors When Searching an Amazon CloudSearch Domain (p.263)
• Indexing Failures after Updating Indexing Options in Amazon CloudSearch (p.264)
• Domain Not Found When Submitting Amazon CloudSearch Requests (p.264)
• Number of Searchable Documents Not Returned with Domain Information (p.264)
• Configuration Service Access Policies Not Working in Amazon CloudSearch (p.264)
• Search and Document Service Access Policies Not Working in Amazon CloudSearch (p.265)
• Amazon CloudSearch Console Permissions Errors (p.266)
• Using Wildcards to Search Text Fields Doesn't Produce Expected Results (p.266)
• Inconsistent Results When Using Cursors for Deep Paging (p.266)
Uploading Documents
If your document data is not formatted correctly or contains invalid values, you will get errors when you
attempt to upload it or use it to configure fields for your domain. Here are some common problems and
their solutions:
• Invalid JSON—if you are using JSON, the first thing to do is make sure there are no JSON syntax
errors in your document batch.To do that, run it through a validation tool such as the JSON Validator.
This will identify any fundamental issues with the data.
API Version 2013-01-01
261
Amazon CloudSearch Developer Guide
Uploading Documents
• Invalid XML—document batches must be well-formed XML.You are especially likely to encounter
issues if your fields contain XML data—the data must be XML-encoded or enclosed in CDATA sections.
To identify any problems, run your document batch through a validation tool such as the W3C Markup
Validation Service.
• Not Recognized as a Document Batch—if Amazon CloudSearch doesn’t recognize your data as a
valid document batch when you are uploading data with cs-import-documents or the console,
Amazon CloudSearch generates a valid batch that contains a single content field and generic metadata
fields such as content_encoding, content_type, and resourcename. Since these are not normally
the fields configured for the domain, you get errors stating that the fields don't exist. Similarly, if you
attempt to configure a domain from an invalid batch, Amazon CloudSearch responds with the content
and meta-data fields instead of the fields in the batch.
First, make sure that the batch is valid XML or JSON. If it is, check for invalid document IDs and make
sure you have specified the operation type for each document. For add operations, make sure that the
type, ID, and at least one field are specified for each document. Delete operations only need to specify
the type and ID. For more information about formatting your data, see Creating Document
Batches (p.59).
• Document IDs with bad values—A document ID can contain any letter or number and the following
characters: _ - = # ; : / ? @ &. Document IDs must be at least 1 and no more than 128 characters long.
• Multi-valued fields without a value—when specifying document data in JSON, you cannot specify
an empty array as the value of a field. Multi-valued fields must contain at least one value.
• Bad characters—one problem that can be difficult to detect if you do not filter your data while generating
your document batch is that can contain characters that are invalid in XML. Both JSON and XML
batches can contain only UTF-8 characters that are valid in XML.You can use a validation tool such
as the JSON Validator or W3C Markup Validation Service to identify invalid characters.
Deleting All Documents in an Amazon
CloudSearch Domain
Amazon CloudSearch currently does not provide a mechanism for deleting all of the documents in a
domain.
Amazon CloudSearch Domain Not Scaling Down
After Deleting Documents
If your domain has scaled up to accommodate your index size and you delete a large number of documents,
the domain scales down the next time the full index is rebuilt. Although the index is automatically rebuilt
periodically, to scale down as quickly as possible you can explicitly run indexing (p.91) when you are
done deleting documents.
Document Update Latency
Sending a large volume of single-document batches can increase the amount of time it takes each
document to become searchable. If have a large amount of update traffic, you need to batch your updates.
We recommend using a batch size close to the 5 MB limit. If necessary, you can increase your update
capacity by selecting a larger desired instance type. For more information, see Configuring Scaling
Options (p.39)
API Version 2013-01-01
262
Amazon CloudSearch Developer Guide
Deleting All Documents
Large Number of 5xx Errors When Uploading
Documents to an Amazon CloudSearch Domain
If you parallelize uploads and your domain is on a search.m1.small instance, you might experience an
unacceptably high rate of 504 or 507 errors. Setting the desired instance type to a larger instance type
will increase your update capacity and reduce the error rate. For more information about handling 5xx
errors, see Handling Errors (p.138). For information about prescaling your domain to increase upload
capacity, see Configuring Scaling Options (p.39).
Search Latency and Timeouts in Amazon
CloudSearch
If you are experiencing slow response times, frequently encountering internal server errors (typically 507
or 509 errors), or seeing the number of instance hours your search domain is consuming increase without
a substantial increase in the volume of data you're searching, fine-tuning your search requests to reduce
the processing overhead can help. For more information, see Tuning Search Request Performance in
Amazon CloudSearch (p.112). Increasing the desired replication count can also speed up search request
processing. For more information, see Configuring Scaling Options (p.39).
507 and 509 errors typically indicate that your search service is overloaded.This can be due to the volume
or complexity of search requests that you are submitting. Amazon CloudSearch normally scales
automatically to handle the load. Because it takes some time to deploy additional search instances, we
recommend using an exponential backoff retry policy to temporarily reduce the request rate and minimize
request failures. For more information, see Error Retries and Exponential Backoff.
Certain usage patterns, such as submitting complex search queries to a single small search instance,
can sometimes result in timeouts without triggering automatic scaling. If you repeatedly experience a high
error rate, you can explicitly request additional capacity through the Amazon CloudSearch Service Limit
Request form.
Search Latency for Faceted Queries in Amazon
CloudSearch
If you are bucketing facet information with the buckets option and experiencing slow query performance,
try setting the buckets method to interval. For more information, see Bucketing Facet Information (p.117).
Sudden Increase in 5xx Errors When Searching
an Amazon CloudSearch Domain
If your search domain experiences a sudden spike in traffic, Amazon CloudSearch responds by adding
search instances to your domain to handle the increased load. However, it takes a few minutes to set up
the new instances.You are likely to see a temporary increase in 5xx errors until the new instances are
ready to start processing requests. For more information about handling 5xx errors, see Handling
Errors (p.138). For information about pre-scaling your domain to handle an expected spike in search
requests, see Configuring Scaling Options (p.39).
API Version 2013-01-01
263
Amazon CloudSearch Developer Guide
Large Number of 5xx Errors When Uploading Documents
Indexing Failures after Updating Indexing
Options in Amazon CloudSearch
If you make changes to a domain's index configuration, in certain cases you might encounter Failed to
Validate errors when you run indexing.This means that the index field options you set are not compatible
with the documents that are already in your index. Specifically, you changed the type of an index field,
and there are documents in your index that contain data that is incompatible with that type. For example,
this might happen if you change a literal field to an int field, and some of your documents contain
alphanumeric data in that field.When this happens, Amazon CloudSearch sets the status of ALL fields
that were being processed to the FailedToValidate state. Rolling back the incompatible configuration
change will enable you to successfully rebuild your index. If the change is necessary, you must update
or remove the incompatible documents from your index to use the new configuration. If you can't identify
the change that caused the error or need assistance identifying the incompatible documents, contact
support.
Domain Not Found When Submitting Amazon
CloudSearch Requests
You cannot access a 2013-01-01 domain with the 2011-02-01 command line tools or SDKs. Similarly,
you cannot access a 2011-02-01 domain with the 2013-01-01 command line tools or SDKs. Make sure
you are specifying the correct API version in your request and using the appropriate command line tools
or SDK.
Number of Searchable Documents Not Returned
with Domain Information
The aws cloudsearch describe-domains and DescribeDomains do not return the number of
searchable documents in the domain.To get the number of searchable documents, use the console or
submit a matchall request to your domain's search endpoint.
q=matchall&q.parser=structured&size=0
Configuration Service Access Policies Not
Working in Amazon CloudSearch
If you have both 2011 and 2013 domains, have configured IAM policies for accessing the configuration
service, and are getting not authorized errors, note that the Amazon CloudSearch ARN is different for
the 2011-02-01 API and the 2013-01-01 API.To allow users to access both 2011 and 2013 domains,
you must allow access to both ARNs in the IAM policy. For example:
{
"Statement": [
{
API Version 2013-01-01
264
Amazon CloudSearch Developer Guide
Indexing Failures after Updating Indexing Options
Documents you may be interested
Documents you may be interested