We recommend new projects start with resources from the AWS provider.
aws-native.xray.getSamplingRule
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
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 dictionary
The following arguments are supported:
- Rule
Arn string - The sampling rule ARN that was created or updated.
- Rule
Arn string - The sampling rule ARN that was created or updated.
- rule
Arn String - The sampling rule ARN that was created or updated.
- rule
Arn string - The sampling rule ARN that was created or updated.
- rule_
arn str - The sampling rule ARN that was created or updated.
- rule
Arn String - The sampling rule ARN that was created or updated.
getSamplingRule Result
The following output properties are available:
- Rule
Arn string - The sampling rule ARN that was created or updated.
- Rule
Name string - Sampling
Rule Pulumi.Record Aws Native. XRay. Outputs. Sampling Rule Record - Sampling
Rule Pulumi.Update Aws Native. XRay. Outputs. Sampling Rule Update - Sampling
Rule 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.
- Rule
Arn string - The sampling rule ARN that was created or updated.
- Rule
Name string - Sampling
Rule SamplingRule Type - The sampling rule to be created or updated.
- Sampling
Rule SamplingRecord Rule Record - Sampling
Rule SamplingUpdate Rule Update - Tag
- An array of key-value pairs to apply to this resource.
- rule
Arn String - The sampling rule ARN that was created or updated.
- rule
Name String - sampling
Rule SamplingRule - The sampling rule to be created or updated.
- sampling
Rule SamplingRecord Rule Record - sampling
Rule SamplingUpdate Rule Update - List<Tag>
- An array of key-value pairs to apply to this resource.
- rule
Arn string - The sampling rule ARN that was created or updated.
- rule
Name string - sampling
Rule SamplingRule - The sampling rule to be created or updated.
- sampling
Rule SamplingRecord Rule Record - sampling
Rule 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.
- rule
Arn String - The sampling rule ARN that was created or updated.
- rule
Name String - sampling
Rule Property Map - The sampling rule to be created or updated.
- sampling
Rule Property MapRecord - sampling
Rule Property MapUpdate - List<Property Map>
- An array of key-value pairs to apply to this resource.
Supporting Types
SamplingRule
- Fixed
Rate double - The percentage of matching requests to instrument, after the reservoir is exhausted.
- Host string
- Matches the hostname from a request URL.
- Http
Method string - 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 string - Matches the ARN of the AWS resource on which the service runs.
- Service
Name string - Matches the name that the service uses to identify itself in segments.
- Service
Type string - Matches the origin that the service uses to identify its type in segments.
- Url
Path string - Matches the path from a request URL.
- Attributes Dictionary<string, string>
- Matches attributes derived from the request.
- Rule
Arn 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.
- Rule
Name 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)
- Fixed
Rate float64 - The percentage of matching requests to instrument, after the reservoir is exhausted.
- Host string
- Matches the hostname from a request URL.
- Http
Method string - 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 string - Matches the ARN of the AWS resource on which the service runs.
- Service
Name string - Matches the name that the service uses to identify itself in segments.
- Service
Type string - Matches the origin that the service uses to identify its type in segments.
- Url
Path string - Matches the path from a request URL.
- Attributes map[string]string
- Matches attributes derived from the request.
- Rule
Arn 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.
- Rule
Name 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)
- fixed
Rate Double - The percentage of matching requests to instrument, after the reservoir is exhausted.
- host String
- Matches the hostname from a request URL.
- http
Method String - Matches the HTTP method from a request URL.
- priority Integer
- The priority of the sampling rule.
- reservoir
Size 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.
- resource
Arn String - Matches the ARN of the AWS resource on which the service runs.
- service
Name String - Matches the name that the service uses to identify itself in segments.
- service
Type String - Matches the origin that the service uses to identify its type in segments.
- url
Path String - Matches the path from a request URL.
- attributes Map<String,String>
- Matches attributes derived from the request.
- rule
Arn 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.
- rule
Name 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)
- fixed
Rate number - The percentage of matching requests to instrument, after the reservoir is exhausted.
- host string
- Matches the hostname from a request URL.
- http
Method string - Matches the HTTP method from a request URL.
- priority number
- The priority of the sampling rule.
- reservoir
Size 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.
- resource
Arn string - Matches the ARN of the AWS resource on which the service runs.
- service
Name string - Matches the name that the service uses to identify itself in segments.
- service
Type string - Matches the origin that the service uses to identify its type in segments.
- url
Path string - Matches the path from a request URL.
- attributes {[key: string]: string}
- Matches attributes derived from the request.
- rule
Arn 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.
- rule
Name 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)
- fixed
Rate Number - The percentage of matching requests to instrument, after the reservoir is exhausted.
- host String
- Matches the hostname from a request URL.
- http
Method String - Matches the HTTP method from a request URL.
- priority Number
- The priority of the sampling rule.
- reservoir
Size 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.
- resource
Arn String - Matches the ARN of the AWS resource on which the service runs.
- service
Name String - Matches the name that the service uses to identify itself in segments.
- service
Type String - Matches the origin that the service uses to identify its type in segments.
- url
Path String - Matches the path from a request URL.
- attributes Map<String>
- Matches attributes derived from the request.
- rule
Arn 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.
- rule
Name 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
- Created
At string - When the rule was created, in Unix time seconds.
- Modified
At string - When the rule was modified, in Unix time seconds.
- Sampling
Rule Pulumi.Aws Native. XRay. Inputs. Sampling Rule
- Created
At string - When the rule was created, in Unix time seconds.
- Modified
At string - When the rule was modified, in Unix time seconds.
- Sampling
Rule SamplingRule Type
- created
At String - When the rule was created, in Unix time seconds.
- modified
At String - When the rule was modified, in Unix time seconds.
- sampling
Rule SamplingRule
- created
At string - When the rule was created, in Unix time seconds.
- modified
At string - When the rule was modified, in Unix time seconds.
- sampling
Rule 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
- created
At String - When the rule was created, in Unix time seconds.
- modified
At String - When the rule was modified, in Unix time seconds.
- sampling
Rule Property Map
SamplingRuleUpdate
- Attributes Dictionary<string, string>
- Matches attributes derived from the request.
- Fixed
Rate double - The percentage of matching requests to instrument, after the reservoir is exhausted.
- Host string
- Matches the hostname from a request URL.
- Http
Method string - 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 string - Matches the ARN of the AWS resource on which the service runs.
- Rule
Arn string - Rule
Name string - Service
Name string - Matches the name that the service uses to identify itself in segments.
- Service
Type string - Matches the origin that the service uses to identify its type in segments.
- Url
Path string - Matches the path from a request URL.
- Attributes map[string]string
- Matches attributes derived from the request.
- Fixed
Rate float64 - The percentage of matching requests to instrument, after the reservoir is exhausted.
- Host string
- Matches the hostname from a request URL.
- Http
Method string - 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 string - Matches the ARN of the AWS resource on which the service runs.
- Rule
Arn string - Rule
Name string - Service
Name string - Matches the name that the service uses to identify itself in segments.
- Service
Type string - Matches the origin that the service uses to identify its type in segments.
- Url
Path string - Matches the path from a request URL.
- attributes Map<String,String>
- Matches attributes derived from the request.
- fixed
Rate Double - The percentage of matching requests to instrument, after the reservoir is exhausted.
- host String
- Matches the hostname from a request URL.
- http
Method String - Matches the HTTP method from a request URL.
- priority Integer
- The priority of the sampling rule.
- reservoir
Size 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.
- resource
Arn String - Matches the ARN of the AWS resource on which the service runs.
- rule
Arn String - rule
Name String - service
Name String - Matches the name that the service uses to identify itself in segments.
- service
Type String - Matches the origin that the service uses to identify its type in segments.
- url
Path String - Matches the path from a request URL.
- attributes {[key: string]: string}
- Matches attributes derived from the request.
- fixed
Rate number - The percentage of matching requests to instrument, after the reservoir is exhausted.
- host string
- Matches the hostname from a request URL.
- http
Method string - Matches the HTTP method from a request URL.
- priority number
- The priority of the sampling rule.
- reservoir
Size 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.
- resource
Arn string - Matches the ARN of the AWS resource on which the service runs.
- rule
Arn string - rule
Name string - service
Name string - Matches the name that the service uses to identify itself in segments.
- service
Type string - Matches the origin that the service uses to identify its type in segments.
- url
Path 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.
- fixed
Rate Number - The percentage of matching requests to instrument, after the reservoir is exhausted.
- host String
- Matches the hostname from a request URL.
- http
Method String - Matches the HTTP method from a request URL.
- priority Number
- The priority of the sampling rule.
- reservoir
Size 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.
- resource
Arn String - Matches the ARN of the AWS resource on which the service runs.
- rule
Arn String - rule
Name String - service
Name String - Matches the name that the service uses to identify itself in segments.
- service
Type String - Matches the origin that the service uses to identify its type in segments.
- url
Path String - Matches the path from a request URL.
Tag
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.