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.
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
public virtual CreateSamplingRuleResponse CreateSamplingRule( CreateSamplingRuleRequest request )
Container for the necessary parameters to execute the CreateSamplingRule service method.
Exception | Condition |
---|---|
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. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5