AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a rule to control sampling behavior for instrumented applications. Services retrieve rules with GetSamplingRules, and evaluate each rule in ascending order of priority for each request. If a rule matches, the service records a trace, borrowing it from the reservoir size. After 10 seconds, the service reports back to X-Ray with GetSamplingTargets to get updated versions of each in-use rule. The updated rule contains a trace quota that the service can use instead of borrowing from the reservoir.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateSamplingRuleAsync.

Namespace: Amazon.XRay
Assembly: AWSSDK.XRay.dll
Version: 3.x.y.z

Syntax

C#
public virtual CreateSamplingRuleResponse CreateSamplingRule(
         CreateSamplingRuleRequest request
)

Parameters

request
Type: Amazon.XRay.Model.CreateSamplingRuleRequest

Container for the necessary parameters to execute the CreateSamplingRule service method.

Return Value


The response from the CreateSamplingRule service method, as returned by XRay.

Exceptions

ExceptionCondition
InvalidRequestException The request is missing required parameters or has invalid parameters.
RuleLimitExceededException You have reached the maximum number of sampling rules.
ThrottledException The request exceeds the maximum number of requests per second.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also