How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Amazon X-Ray TraceSummaries API

The TraceSummaries API from Amazon X-Ray — 1 operation(s) for tracesummaries.

Amazon X-Ray TraceSummaries API is one of 32 APIs that Amazon X-Ray publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include TraceSummaries. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, pricing, a getting-started guide, authentication docs, and 1 JSON Schema.

This API exposes 1 operation across 1 path, and defines 50 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 4 base URLs: http://xray.{region}.amazonaws.com, https://xray.{region}.amazonaws.com, http://xray.{region}.amazonaws.com.cn, https://xray.{region}.amazonaws.com.cn.

1 operations 1 paths 50 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://xray.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Amazon X-Ray TraceSummaries API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

TraceSummaries 1
POST
/TraceSummaries
Amazon X-Ray Get Trace Summaries
GetTraceSummaries 8 params body → 200480481

Schemas 50

The contract defines 50 schemas that model the data the API accepts and returns. The most detailed are TraceSummary (20 properties), FaultRootCauseService (6 properties), ErrorRootCauseService (6 properties), ResponseTimeRootCauseService (6 properties). Each schema is shown below with its type and property counts.

AvailabilityZoneDetail
object
A list of Availability Zones corresponding to the segments in a trace.
1 property
ErrorRootCauseServices
array
ServiceNames
array
NullableBoolean
boolean
ServiceIds
array
TraceId
string
RootCauseException
object
The exception associated with a root cause.
2 properties
InvalidRequestException
RootCauseExceptions
array
ErrorRootCauseEntity
object
A collection of segments and corresponding subsegments associated to a trace summary error.
3 properties
FaultRootCauseServices
array
ErrorRootCauseEntityPath
array
ValueWithServiceIds
object
Information about a segment annotation.
2 properties
FaultRootCauseEntity
object
A collection of segments and corresponding subsegments associated to a trace summary fault error.
3 properties
TraceInstanceIds
array
Annotations
object
TraceSummary
object
Metadata generated from the segment documents in a trace.
20 properties
InstanceIdDetail
object
A list of EC2 instance IDs corresponding to the segments in a trace.
1 property
ResponseTimeRootCause
object
The root cause information for a response time warning.
2 properties
Http
object
Information about an HTTP request.
5 properties
NullableLong
integer
TraceUser
object
Information about a user recorded in segment documents.
2 properties
TraceAvailabilityZones
array
GetTraceSummariesResult
object
4 properties
FaultRootCauses
array
ResponseTimeRootCauses
array
TraceUsers
array
FaultRootCause
object
The root cause information for a trace summary fault.
2 properties
ResponseTimeRootCauseEntityPath
array
ThrottledException
FaultRootCauseEntityPath
array
Timestamp
string
ResourceARNDetail
object
A list of resources ARNs corresponding to the segments in a trace.
1 property
TraceResourceARNs
array
ErrorRootCause
object
The root cause of a trace summary error.
2 properties
AnnotationValue
object
Value of a segment annotation. Has one of three value types: Number, Boolean, or String.
3 properties
NullableInteger
integer
SamplingStrategyName
string
String
string
ResponseTimeRootCauseServices
array
ResponseTimeRootCauseService
object
A collection of fields identifying the service in a response time warning.
6 properties
NullableDouble
number
ValuesWithServiceIds
array
Integer
integer
ErrorRootCauses
array
ResponseTimeRootCauseEntity
object
A collection of segments and corresponding subsegments associated to a response time warning.
3 properties
ErrorRootCauseService
object
A collection of fields identifying the services in a trace summary error.
6 properties
ServiceId
object
4 properties
FaultRootCauseService
object
A collection of fields identifying the services in a trace summary fault.
6 properties
TraceSummaryList
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

amazon-xray-tracesummaries-api-openapi.yml Raw ↑

Other APIs Amazon X-Ray publishes across the network.

Amazon X-Ray CreateGroup API
Amazon X-Ray CreateSamplingRule API
Amazon X-Ray DeleteGroup API
Amazon X-Ray DeleteResourcePolicy API
Amazon X-Ray DeleteSamplingRule API
Amazon X-Ray EncryptionConfig API
Amazon X-Ray GetGroup API
Amazon X-Ray GetSamplingRules API
Amazon X-Ray Groups API
Amazon X-Ray Insight API
Amazon X-Ray InsightEvents API
Amazon X-Ray InsightImpactGraph API
Where this information came from

This is an independent, third-party profile of Amazon X-Ray TraceSummaries API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.