**To update a sampling rule**
The following ``update-sampling-rule`` example modifies a sampling rule's configuration. The rules are consumed from a JSON file. Only the fields being updated are required. ::
aws xray update-sampling-rule \
--cli-input-json file://1000-default.json
Contents of ``1000-default.json``::
{
"SamplingRuleUpdate": {
"RuleName": "Default",
"FixedRate": 0.01,
"ReservoirSize": 0
}
}
Output::
{
"SamplingRuleRecords": [
{
"SamplingRule": {
"RuleName": "Default",
"RuleARN": "arn:aws:xray:us-west-2:123456789012:sampling-rule/Default",
"ResourceARN": "*",
"Priority": 10000,
"FixedRate": 0.01,
"ReservoirSize": 0,
"ServiceName": "*",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1,
"Attributes": {}
},
"CreatedAt": 0.0,
"ModifiedAt": 1529959993.0
}
]
}
For more information, see `Configuring Sampling, Groups, and Encryption Settings with the AWS X-Ray API <https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html#xray-api-configuration-sampling>`__ in the *AWS X-Ray Developer Guide*.
| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| batch-traces-get.rst | File | 2.73 KB | 0644 |
|
| create-group.rst | File | 875 B | 0644 |
|
| create-sampling-rule.rst | File | 1.73 KB | 0644 |
|
| delete-group.rst | File | 553 B | 0644 |
|
| delete-sampling-rule.rst | File | 1.23 KB | 0644 |
|
| get-encryption-config.rst | File | 623 B | 0644 |
|
| get-group.rst | File | 895 B | 0644 |
|
| get-groups.rst | File | 900 B | 0644 |
|
| get-sampling-rules.rst | File | 2.54 KB | 0644 |
|
| get-sampling-targets.rst | File | 1.35 KB | 0644 |
|
| get-service-graph.rst | File | 3.1 KB | 0644 |
|
| get-trace-summaries.rst | File | 917 B | 0644 |
|
| put-encryption-config.rst | File | 746 B | 0644 |
|
| put-trace-segments.rst | File | 1.03 KB | 0644 |
|
| update-group.rst | File | 914 B | 0644 |
|
| update-sampling-rule.rst | File | 1.49 KB | 0644 |
|