Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Úselo DescribeTags
con un o AWS SDK CLI
En los siguientes ejemplos de código, se muestra cómo utilizar DescribeTags
.
- CLI
-
- AWS CLI
-
Ejemplo 1: Para describir todas las etiquetas de un único recurso
En el siguiente
describe-tags
ejemplo, se describen las etiquetas de la instancia especificada.aws ec2 describe-tags \ --filters
"Name=resource-id,Values=i-1234567890abcdef8"
Salida:
{ "Tags": [ { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef8", "Value": "Test", "Key": "Stack" }, { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef8", "Value": "Beta Server", "Key": "Name" } ] }
Ejemplo 2: Para describir todas las etiquetas de un tipo de recurso
En el siguiente
describe-tags
ejemplo, se describen las etiquetas de los volúmenes.aws ec2 describe-tags \ --filters
"Name=resource-type,Values=volume"
Salida:
{ "Tags": [ { "ResourceType": "volume", "ResourceId": "vol-1234567890abcdef0", "Value": "Project1", "Key": "Purpose" }, { "ResourceType": "volume", "ResourceId": "vol-049df61146c4d7901", "Value": "Logs", "Key": "Purpose" } ] }
Ejemplo 3: Para describir todas las etiquetas
En el siguiente
describe-tags
ejemplo, se describen las etiquetas de todos los recursos.aws ec2 describe-tags
Ejemplo 4: Para describir las etiquetas de los recursos en función de una clave de etiqueta
En el siguiente
describe-tags
ejemplo, se describen las etiquetas de los recursos que tienen una etiqueta con la claveStack
.aws ec2 describe-tags \ --filters
Name=key,Values=Stack
Salida:
{ "Tags": [ { "ResourceType": "volume", "ResourceId": "vol-027552a73f021f3b", "Value": "Production", "Key": "Stack" }, { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef8", "Value": "Test", "Key": "Stack" } ] }
Ejemplo 5: Para describir las etiquetas de sus recursos en función de una clave de etiqueta y un valor de etiqueta
En el siguiente
describe-tags
ejemplo, se describen las etiquetas de los recursos que tienen la etiquetaStack=Test
.aws ec2 describe-tags \ --filters
Name=key,Values=Stack
Name=value,Values=Test
Salida:
{ "Tags": [ { "ResourceType": "image", "ResourceId": "ami-3ac336533f021f3bd", "Value": "Test", "Key": "Stack" }, { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef8", "Value": "Test", "Key": "Stack" } ] }
En el siguiente
describe-tags
ejemplo, se utiliza una sintaxis alternativa para describir los recursos con la etiquetaStack=Test
.aws ec2 describe-tags \ --filters
"Name=tag:Stack,Values=Test"
En el siguiente
describe-tags
ejemplo, se describen las etiquetas de todas las instancias que tienen una etiqueta con la clavePurpose
y sin ningún valor.aws ec2 describe-tags \ --filters
"Name=resource-type,Values=instance"
"Name=key,Values=Purpose"
"Name=value,Values="
Salida:
{ "Tags": [ { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef5", "Value": null, "Key": "Purpose" } ] }
-
Para API obtener más información, consulta DescribeTags
la Referencia de AWS CLI comandos.
-
- PowerShell
-
- Herramientas para PowerShell
-
Ejemplo 1: En este ejemplo se obtienen las etiquetas del tipo de recurso «imagen»
Get-EC2Tag -Filter @{Name="resource-type";Values="image"}
Salida:
Key ResourceId ResourceType Value --- ---------- ------------ ----- Name ami-0a123b4ccb567a8ea image Win7-Imported auto-delete ami-0a123b4ccb567a8ea image never
Ejemplo 2: Este ejemplo busca todas las etiquetas de todos los recursos y las agrupa por tipo de recurso
Get-EC2Tag | Group-Object resourcetype
Salida:
Count Name Group ----- ---- ----- 9 subnet {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...} 53 instance {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...} 3 route-table {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription} 5 security-group {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...} 30 volume {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...} 1 internet-gateway {Amazon.EC2.Model.TagDescription} 3 network-interface {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription} 4 elastic-ip {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription} 1 dhcp-options {Amazon.EC2.Model.TagDescription} 2 image {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription} 3 vpc {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription}
Ejemplo 3: Este ejemplo muestra todos los recursos con la etiqueta 'eliminación automática' con el valor 'no' para la región dada
Get-EC2Tag -Region eu-west-1 -Filter @{Name="tag:auto-delete";Values="no"}
Salida:
Key ResourceId ResourceType Value --- ---------- ------------ ----- auto-delete i-0f1bce234d5dd678b instance no auto-delete vol-01d234aa5678901a2 volume no auto-delete vol-01234bfb5def6f7b8 volume no auto-delete vol-01ccb23f4c5e67890 volume no
Ejemplo 4: Este ejemplo obtiene todos los recursos con la etiqueta «eliminación automática» con el valor «no» y más filtros en el siguiente tubo para analizar solo los tipos de recursos de «instancia» y, finalmente, crea la etiqueta «ThisInstance» para cada recurso de la instancia, cuyo valor es el propio identificador de la instancia.
Get-EC2Tag -Region eu-west-1 -Filter @{Name="tag:auto-delete";Values="no"} | Where-Object ResourceType -eq "instance" | ForEach-Object {New-EC2Tag -ResourceId $_.ResourceId -Tag @{Key="ThisInstance";Value=$_.ResourceId}}
Ejemplo 5: Este ejemplo busca las etiquetas de todos los recursos de la instancia, así como las teclas de «Nombre», y las muestra en formato de tabla
Get-EC2Tag -Filter @{Name="resource-type";Values="instance"},@{Name="key";Values="Name"} | Select-Object ResourceId, @{Name="Name-Tag";Expression={$PSItem.Value}} | Format-Table -AutoSize
Salida:
ResourceId Name-Tag ---------- -------- i-012e3cb4df567e1aa jump1 i-01c23a45d6fc7a89f repro-3
-
Para API obtener más información, consulta DescribeTags AWS Tools for PowerShellCmdlet Reference.
-