ec2_describe_tags {aws.ecx} | R Documentation |
Describe Tags
Description
Describe Tags
Usage
ec2_describe_tags(
DryRun = NULL,
Filter = NULL,
MaxResults = NULL,
NextToken = NULL,
simplify = TRUE,
others = list(),
print_on_error = aws_get_print_on_error(),
retry_time = aws_get_retry_time(),
network_timeout = aws_get_network_timeout(),
region = aws_get_region()
)
Arguments
DryRun |
Logical. Checks whether you have the required permissions for the action, without actually making the request,...[optional] |
Filter |
Named list where the name is the filter name and the value is the filter's value. The value can be a vector or a list object (see below)[optional] |
MaxResults |
Integer. The maximum number of results to return in a single call.[optional] |
NextToken |
Characters. The token for the next page of results[optional] |
simplify |
Logical. Whether to simplify the result and handle |
others |
Named list. The parameters that are not included in the function parameters and need to be added into the request[optional] |
print_on_error |
Logical. Whether to show an error message when a network error occurs. |
retry_time |
Integer. Number of retries for a REST request when encounter the
network issue. If the request has been sent |
network_timeout |
Numeric. Number of seconds to wait for a REST response until giving up. Can not be less than 1 ms. |
region |
Character. The region of the AWS service. |
Value
A list object or a character vector
DryRun
Checks whether
you have the required permissions for the action, without actually
making the request, and provides an error response. If you have the
required permissions, the error response is DryRunOperation
.
Otherwise, it is UnauthorizedOperation
.
Filter
The filters.
-
key
- The tag key. -
resource-id
- The ID of the resource. -
resource-type
- The resource type (customer-gateway
\|dedicated-host
\|dhcp-options
\|elastic-ip
\|fleet
\|fpga-image
\|host-reservation
\|image
\|instance
\|internet-gateway
\|key-pair
\|launch-template
\|natgateway
\|network-acl
\|network-interface
\|placement-group
\|reserved-instances
\|route-table
\|security-group
\|snapshot
\|spot-instances-request
\|subnet
\|volume
\|vpc
\|vpc-endpoint
\|vpc-endpoint-service
\|vpc-peering-connection
\|vpn-connection
\|vpn-gateway
). -
tag
:\ - The key/value combination of the tag. For example, specify \'tag:Owner\' for the filter name and \'TeamA\' for the filter value to find resources with the tag \'Owner=TeamA\'. -
value
- The tag value.
MaxResults
The maximum number of results to return in a single
call. This value can be between 5 and 1000. To retrieve the remaining
results, make another call with the returned NextToken
value.