AWS Native is in preview. AWS Classic is fully supported.
aws-native.xray.getSamplingRule
Explore with Pulumi AI
AWS Native is in preview. AWS Classic is fully supported.
This schema provides construct and validation rules for AWS-XRay SamplingRule resource parameters.
Using getSamplingRule
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getSamplingRule(args: GetSamplingRuleArgs, opts?: InvokeOptions): Promise<GetSamplingRuleResult>
function getSamplingRuleOutput(args: GetSamplingRuleOutputArgs, opts?: InvokeOptions): Output<GetSamplingRuleResult>def get_sampling_rule(rule_arn: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetSamplingRuleResult
def get_sampling_rule_output(rule_arn: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetSamplingRuleResult]func LookupSamplingRule(ctx *Context, args *LookupSamplingRuleArgs, opts ...InvokeOption) (*LookupSamplingRuleResult, error)
func LookupSamplingRuleOutput(ctx *Context, args *LookupSamplingRuleOutputArgs, opts ...InvokeOption) LookupSamplingRuleResultOutput> Note: This function is named LookupSamplingRule in the Go SDK.
public static class GetSamplingRule 
{
    public static Task<GetSamplingRuleResult> InvokeAsync(GetSamplingRuleArgs args, InvokeOptions? opts = null)
    public static Output<GetSamplingRuleResult> Invoke(GetSamplingRuleInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetSamplingRuleResult> getSamplingRule(GetSamplingRuleArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: aws-native:xray:getSamplingRule
  arguments:
    # arguments dictionaryThe following arguments are supported:
- RuleArn string
- The sampling rule ARN that was created or updated.
- RuleArn string
- The sampling rule ARN that was created or updated.
- ruleArn String
- The sampling rule ARN that was created or updated.
- ruleArn string
- The sampling rule ARN that was created or updated.
- rule_arn str
- The sampling rule ARN that was created or updated.
- ruleArn String
- The sampling rule ARN that was created or updated.
getSamplingRule Result
The following output properties are available:
- RuleArn string
- The sampling rule ARN that was created or updated.
- RuleName string
- SamplingRule Pulumi.Record Aws Native. XRay. Outputs. Sampling Rule Record 
- SamplingRule Pulumi.Update Aws Native. XRay. Outputs. Sampling Rule Update 
- SamplingRule Pulumi.Value Aws Native. XRay. Outputs. Sampling Rule 
- The sampling rule to be created or updated.
- 
List<Pulumi.Aws Native. Outputs. Tag> 
- An array of key-value pairs to apply to this resource.
- RuleArn string
- The sampling rule ARN that was created or updated.
- RuleName string
- SamplingRule SamplingRule Type 
- The sampling rule to be created or updated.
- SamplingRule SamplingRecord Rule Record 
- SamplingRule SamplingUpdate Rule Update 
- Tag
- An array of key-value pairs to apply to this resource.
- ruleArn String
- The sampling rule ARN that was created or updated.
- ruleName String
- samplingRule SamplingRule 
- The sampling rule to be created or updated.
- samplingRule SamplingRecord Rule Record 
- samplingRule SamplingUpdate Rule Update 
- List<Tag>
- An array of key-value pairs to apply to this resource.
- ruleArn string
- The sampling rule ARN that was created or updated.
- ruleName string
- samplingRule SamplingRule 
- The sampling rule to be created or updated.
- samplingRule SamplingRecord Rule Record 
- samplingRule SamplingUpdate Rule Update 
- Tag[]
- An array of key-value pairs to apply to this resource.
- rule_arn str
- The sampling rule ARN that was created or updated.
- rule_name str
- sampling_rule SamplingRule 
- The sampling rule to be created or updated.
- sampling_rule_ Samplingrecord Rule Record 
- sampling_rule_ Samplingupdate Rule Update 
- Sequence[root_Tag]
- An array of key-value pairs to apply to this resource.
- ruleArn String
- The sampling rule ARN that was created or updated.
- ruleName String
- samplingRule Property Map
- The sampling rule to be created or updated.
- samplingRule Property MapRecord 
- samplingRule Property MapUpdate 
- List<Property Map>
- An array of key-value pairs to apply to this resource.
Supporting Types
SamplingRule 
- FixedRate double
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- Host string
- Matches the hostname from a request URL.
- HttpMethod string
- Matches the HTTP method from a request URL.
- Priority int
- The priority of the sampling rule.
- ReservoirSize int
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- ResourceArn string
- Matches the ARN of the AWS resource on which the service runs.
- ServiceName string
- Matches the name that the service uses to identify itself in segments.
- ServiceType string
- Matches the origin that the service uses to identify its type in segments.
- UrlPath string
- Matches the path from a request URL.
- Attributes Dictionary<string, string>
- Matches attributes derived from the request.
- RuleArn string
- The ARN of the sampling rule. Specify a rule by either name or ARN, but not both. - Specifying a sampling rule by name is recommended, as specifying by ARN will be deprecated in future. 
- RuleName string
- The name of the sampling rule. Specify a rule by either name or ARN, but not both.
- Version int
- The version of the sampling rule format (1)
- FixedRate float64
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- Host string
- Matches the hostname from a request URL.
- HttpMethod string
- Matches the HTTP method from a request URL.
- Priority int
- The priority of the sampling rule.
- ReservoirSize int
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- ResourceArn string
- Matches the ARN of the AWS resource on which the service runs.
- ServiceName string
- Matches the name that the service uses to identify itself in segments.
- ServiceType string
- Matches the origin that the service uses to identify its type in segments.
- UrlPath string
- Matches the path from a request URL.
- Attributes map[string]string
- Matches attributes derived from the request.
- RuleArn string
- The ARN of the sampling rule. Specify a rule by either name or ARN, but not both. - Specifying a sampling rule by name is recommended, as specifying by ARN will be deprecated in future. 
- RuleName string
- The name of the sampling rule. Specify a rule by either name or ARN, but not both.
- Version int
- The version of the sampling rule format (1)
- fixedRate Double
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- host String
- Matches the hostname from a request URL.
- httpMethod String
- Matches the HTTP method from a request URL.
- priority Integer
- The priority of the sampling rule.
- reservoirSize Integer
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- resourceArn String
- Matches the ARN of the AWS resource on which the service runs.
- serviceName String
- Matches the name that the service uses to identify itself in segments.
- serviceType String
- Matches the origin that the service uses to identify its type in segments.
- urlPath String
- Matches the path from a request URL.
- attributes Map<String,String>
- Matches attributes derived from the request.
- ruleArn String
- The ARN of the sampling rule. Specify a rule by either name or ARN, but not both. - Specifying a sampling rule by name is recommended, as specifying by ARN will be deprecated in future. 
- ruleName String
- The name of the sampling rule. Specify a rule by either name or ARN, but not both.
- version Integer
- The version of the sampling rule format (1)
- fixedRate number
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- host string
- Matches the hostname from a request URL.
- httpMethod string
- Matches the HTTP method from a request URL.
- priority number
- The priority of the sampling rule.
- reservoirSize number
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- resourceArn string
- Matches the ARN of the AWS resource on which the service runs.
- serviceName string
- Matches the name that the service uses to identify itself in segments.
- serviceType string
- Matches the origin that the service uses to identify its type in segments.
- urlPath string
- Matches the path from a request URL.
- attributes {[key: string]: string}
- Matches attributes derived from the request.
- ruleArn string
- The ARN of the sampling rule. Specify a rule by either name or ARN, but not both. - Specifying a sampling rule by name is recommended, as specifying by ARN will be deprecated in future. 
- ruleName string
- The name of the sampling rule. Specify a rule by either name or ARN, but not both.
- version number
- The version of the sampling rule format (1)
- fixed_rate float
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- host str
- Matches the hostname from a request URL.
- http_method str
- Matches the HTTP method from a request URL.
- priority int
- The priority of the sampling rule.
- reservoir_size int
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- resource_arn str
- Matches the ARN of the AWS resource on which the service runs.
- service_name str
- Matches the name that the service uses to identify itself in segments.
- service_type str
- Matches the origin that the service uses to identify its type in segments.
- url_path str
- Matches the path from a request URL.
- attributes Mapping[str, str]
- Matches attributes derived from the request.
- rule_arn str
- The ARN of the sampling rule. Specify a rule by either name or ARN, but not both. - Specifying a sampling rule by name is recommended, as specifying by ARN will be deprecated in future. 
- rule_name str
- The name of the sampling rule. Specify a rule by either name or ARN, but not both.
- version int
- The version of the sampling rule format (1)
- fixedRate Number
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- host String
- Matches the hostname from a request URL.
- httpMethod String
- Matches the HTTP method from a request URL.
- priority Number
- The priority of the sampling rule.
- reservoirSize Number
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- resourceArn String
- Matches the ARN of the AWS resource on which the service runs.
- serviceName String
- Matches the name that the service uses to identify itself in segments.
- serviceType String
- Matches the origin that the service uses to identify its type in segments.
- urlPath String
- Matches the path from a request URL.
- attributes Map<String>
- Matches attributes derived from the request.
- ruleArn String
- The ARN of the sampling rule. Specify a rule by either name or ARN, but not both. - Specifying a sampling rule by name is recommended, as specifying by ARN will be deprecated in future. 
- ruleName String
- The name of the sampling rule. Specify a rule by either name or ARN, but not both.
- version Number
- The version of the sampling rule format (1)
SamplingRuleRecord  
- CreatedAt string
- When the rule was created, in Unix time seconds.
- ModifiedAt string
- When the rule was modified, in Unix time seconds.
- SamplingRule Pulumi.Aws Native. XRay. Inputs. Sampling Rule 
- CreatedAt string
- When the rule was created, in Unix time seconds.
- ModifiedAt string
- When the rule was modified, in Unix time seconds.
- SamplingRule SamplingRule Type 
- createdAt String
- When the rule was created, in Unix time seconds.
- modifiedAt String
- When the rule was modified, in Unix time seconds.
- samplingRule SamplingRule 
- createdAt string
- When the rule was created, in Unix time seconds.
- modifiedAt string
- When the rule was modified, in Unix time seconds.
- samplingRule SamplingRule 
- created_at str
- When the rule was created, in Unix time seconds.
- modified_at str
- When the rule was modified, in Unix time seconds.
- sampling_rule SamplingRule 
- createdAt String
- When the rule was created, in Unix time seconds.
- modifiedAt String
- When the rule was modified, in Unix time seconds.
- samplingRule Property Map
SamplingRuleUpdate  
- Attributes Dictionary<string, string>
- Matches attributes derived from the request.
- FixedRate double
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- Host string
- Matches the hostname from a request URL.
- HttpMethod string
- Matches the HTTP method from a request URL.
- Priority int
- The priority of the sampling rule.
- ReservoirSize int
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- ResourceArn string
- Matches the ARN of the AWS resource on which the service runs.
- RuleArn string
- RuleName string
- ServiceName string
- Matches the name that the service uses to identify itself in segments.
- ServiceType string
- Matches the origin that the service uses to identify its type in segments.
- UrlPath string
- Matches the path from a request URL.
- Attributes map[string]string
- Matches attributes derived from the request.
- FixedRate float64
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- Host string
- Matches the hostname from a request URL.
- HttpMethod string
- Matches the HTTP method from a request URL.
- Priority int
- The priority of the sampling rule.
- ReservoirSize int
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- ResourceArn string
- Matches the ARN of the AWS resource on which the service runs.
- RuleArn string
- RuleName string
- ServiceName string
- Matches the name that the service uses to identify itself in segments.
- ServiceType string
- Matches the origin that the service uses to identify its type in segments.
- UrlPath string
- Matches the path from a request URL.
- attributes Map<String,String>
- Matches attributes derived from the request.
- fixedRate Double
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- host String
- Matches the hostname from a request URL.
- httpMethod String
- Matches the HTTP method from a request URL.
- priority Integer
- The priority of the sampling rule.
- reservoirSize Integer
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- resourceArn String
- Matches the ARN of the AWS resource on which the service runs.
- ruleArn String
- ruleName String
- serviceName String
- Matches the name that the service uses to identify itself in segments.
- serviceType String
- Matches the origin that the service uses to identify its type in segments.
- urlPath String
- Matches the path from a request URL.
- attributes {[key: string]: string}
- Matches attributes derived from the request.
- fixedRate number
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- host string
- Matches the hostname from a request URL.
- httpMethod string
- Matches the HTTP method from a request URL.
- priority number
- The priority of the sampling rule.
- reservoirSize number
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- resourceArn string
- Matches the ARN of the AWS resource on which the service runs.
- ruleArn string
- ruleName string
- serviceName string
- Matches the name that the service uses to identify itself in segments.
- serviceType string
- Matches the origin that the service uses to identify its type in segments.
- urlPath string
- Matches the path from a request URL.
- attributes Mapping[str, str]
- Matches attributes derived from the request.
- fixed_rate float
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- host str
- Matches the hostname from a request URL.
- http_method str
- Matches the HTTP method from a request URL.
- priority int
- The priority of the sampling rule.
- reservoir_size int
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- resource_arn str
- Matches the ARN of the AWS resource on which the service runs.
- rule_arn str
- rule_name str
- service_name str
- Matches the name that the service uses to identify itself in segments.
- service_type str
- Matches the origin that the service uses to identify its type in segments.
- url_path str
- Matches the path from a request URL.
- attributes Map<String>
- Matches attributes derived from the request.
- fixedRate Number
- The percentage of matching requests to instrument, after the reservoir is exhausted.
- host String
- Matches the hostname from a request URL.
- httpMethod String
- Matches the HTTP method from a request URL.
- priority Number
- The priority of the sampling rule.
- reservoirSize Number
- A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
- resourceArn String
- Matches the ARN of the AWS resource on which the service runs.
- ruleArn String
- ruleName String
- serviceName String
- Matches the name that the service uses to identify itself in segments.
- serviceType String
- Matches the origin that the service uses to identify its type in segments.
- urlPath String
- Matches the path from a request URL.
Tag
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
AWS Native is in preview. AWS Classic is fully supported.