Perfiles de configuración del etiquetador de recursos en AMS Accelerate - Guía del usuario de AMS Accelerate
Sintaxis y estructura

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.

Perfiles de configuración del etiquetador de recursos en AMS Accelerate

Los perfiles de configuración ayudan a garantizar que las etiquetas se apliquen de manera uniforme a los recursos durante toda su vida útil.

Sintaxis y estructura

Un perfil de configuración es un objeto JSON con la siguiente estructura:

{
   "Options": {
      "ReadOnly": false
   },
   "ResourceType": {
      "ConfigurationID": {
			   "Enabled": true,
			   "Filter": { ... },
			   "Tags": [  ...  ]
      },
      "ConfigurationID": {
			   ...
      }
   },
   "ResourceType": {
		   ...
   }
}

Opciones: (opcional) Especifique las opciones sobre cómo desea que se comporte. ResourceTagger Omitir el bloque equivale a configurar todas las opciones con sus valores predeterminados. Consulte a continuación los ajustes de opciones disponibles:

  • ReadOnly: (opcional, el valor predeterminado es falso): especifica el ReadOnly modo del etiquetador de recursos. Configúrelo en true ReadOnly para deshabilitar la creación o eliminación de etiquetas de Resource Tagger en los recursos de AWS. Para obtener más información, consulte Impedir que Resource Tagger modifique los recursos.

ResourceType: Esta clave debe ser una de las siguientes cadenas admitidas y representa toda la configuración relacionada con el tipo de recurso indicado:

  • AWS::AutoScaling::AutoScalingGrupo

  • AWS::DynamoDB::Table

  • AWS::EC2::Instance

  • AWS::EC2::NatGateway

  • AWS:EC2:: VPNConnection

  • AWS::EFS::FileSystem

  • AWS::EKS::Cluster

  • AWS::ElasticLoadBalancing::LoadBalancer

  • AWS::ElasticLoadBalancingV2::LoadBalancer

  • AWS::Elasticsearch::Domain

  • AWS::FSx::FileSystem

  • AWS::OpenSearch::Domain

  • AWS: :RDS: DBCluster

  • AWS: :RDS: DBInstance

  • AWS::Redshift::Cluster

  • AWS::S3::Bucket

  • AWS::Synthetics::Canary

ID de configuración: esta clave debe ser única en el documento de perfil y debe dar un nombre exclusivo al siguiente bloque de configuración. Si dos bloques de configuración del mismo ResourceTypebloque tienen el mismo ID de configuración, surtirá efecto el que aparezca en último lugar en el perfil. Si especifica un ID de configuración en el perfil de personalización que sea el mismo que el especificado en el documento por defecto, surtirá efecto el bloque de configuración definido en el perfil de personalización.

importante

El ID de configuración debe notsuperponerse al perfil AMS Accelerate; por ejemplo, no debe ser AMSMonitoringLinux o AMSMonitoringWindows; de lo contrario, deshabilita la configuración correspondiente del perfil de configuración de Tags. AMSManaged

Habilitado (opcional, el valor predeterminado es true): especifica si el bloque de configuración entra en vigor. Establézcalo en false para deshabilitar un bloque de configuración. Un bloque de configuración desactivado no tiene ningún efecto.

Filtro: especifica los recursos a los que se aplica la configuración. Cada objeto de filtro puede tener uno (pero solo uno) de los siguientes campos:

  • AWS::AutoScaling::AutoScalingGrupo:

    • AutoScalingGroupName: El nombre del grupo de escalado automático. Este campo admite la coincidencia de caracteres comodín.

  • AWS::DynamoDB::Table:

    • TableName: el nombre de la tabla de DynamoDB. Este campo admite la coincidencia de caracteres comodín.

  • AWS::EC2::Instance:

    • AvailabilityZone: el filtro coincide con una EC2 instancia de la zona de disponibilidad especificada. Este campo admite la coincidencia de comodines, por lo que *a coincide con us-east-1a, ap-northeast-1a, etc.

    • InstanceId: El filtro hace coincidir una instancia con el ID de instancia especificado. EC2 Este campo admite la coincidencia de caracteres comodín, por lo que i-00000* coincidiría con cualquier instancia que tenga un ID de instancia que comience por i-00000.

    • Plataforma: el filtro hace coincidir una EC2 instancia con la plataforma especificada. Los valores válidos son Windows, Linux o el comodín * (para que coincidan con cualquier plataforma).

  • AWS::EC2::NatGateway:

    • NatGatewayId: El ID de la puerta de enlace NAT. Este campo admite la coincidencia de caracteres comodín.

    • Estado: el estado de la puerta de enlace NAT (pendiente, fallido, disponible, borrado, eliminado o con el carácter comodín «*»)

    • VpcId: el ID de la VPC en la que reside la puerta de enlace NAT. Este campo admite la coincidencia de caracteres comodín.

    • SubnetId: el ID de la subred en la que reside la puerta de enlace NAT. Este campo admite la coincidencia de caracteres comodín

  • AWS:EC2:: VPNConnection:

    • VpnConnectionId: El ID de la conexión. Este campo admite la coincidencia de caracteres comodín.

  • AWS::EFS::FileSystem:

    • FileSystemId: el ID del sistema de archivos EFS. Este campo admite la coincidencia de caracteres comodín.

  • AWS::EKS::Cluster:

    • ClusterName: el nombre del clúster. Este campo admite la coincidencia de caracteres comodín.

  • AWS::ElasticLoadBalancing::LoadBalancer (Classic Load Balancer):

    • LoadBalancerName: El LoadBalancer nombre. Este campo admite la coincidencia de caracteres comodín.

    • Esquema: puede ser «orientado a Internet», «interno» o comodín «*».

    • VPCId: El campo VPCId en el que se despliega el balanceador de carga puede ser el comodín «*».

  • AWS::ElasticLoadBalancingV2::LoadBalancer (Application Load Balancer (ALB)):

    • LoadBalancerArn: El nombre del recurso de LoadBalancer Amazon (ARN).

    • DNSName: El DNSName de. LoadBalancer Este campo admite la coincidencia de caracteres comodín.

    • LoadBalancerName: El LoadBalancer nombre. Este campo admite la coincidencia de caracteres comodín.

  • AWS::Elasticsearch::Domain:

    • DomainId: El DomainId del ElasticSearch recurso. Este campo admite la coincidencia de caracteres comodín.

    • DomainName: El DomainName del ElasticSearch recurso. Este campo admite la coincidencia de caracteres comodín.

    • HasMasterNode: valor booleano verdadero o falso. Coincide si el dominio tiene un nodo maestro dedicado.

    • HasKmsKeyValor booleano verdadero o falso. Coincide si el dominio tiene una clave KMS para el cifrado en reposo.

  • AWS::FSx::FileSystem:

    • FileSystemId: el ID del sistema de FSx archivos. Este campo admite la coincidencia de caracteres comodín.

  • AWS::OpenSearch::Domain:

    • DomainId: El DomainId del OpenSearch recurso. Este campo admite la coincidencia de caracteres comodín.

    • DomainName: El DomainName del OpenSearch recurso. Este campo admite la coincidencia de caracteres comodín.

    • HasMasterNode: booleano; si el dominio tiene un nodo maestro dedicado, se puede establecer en verdadero.

    • HasKmsKey: Si el dominio tiene una clave KMS para el cifrado en reposo, se puede establecer en true.

  • AWS: :RDS:: DBCluster

    • DBClusterIdentificador: el filtro hace coincidir un identificador de clúster de RDS con el identificador especificado. Este campo no admite la coincidencia de caracteres comodín, por lo que se debe especificar un identificador de clúster.

    • Motor: el motor que utiliza la instancia RDS. Este campo admite la coincidencia de caracteres comodín.

    • EngineVersion: La versión del motor. Este campo admite la coincidencia de caracteres comodín.

  • AWS: :RDS:: DBInstance

    • DBInstanceIdentificador: el filtro hace coincidir una instancia de RDS con el ID de instancia especificado. Este campo no admite la coincidencia de caracteres comodín, por lo que se debe especificar un identificador de instancia.

    • Motor: el motor que utiliza la instancia RDS. Este campo admite la coincidencia de caracteres comodín.

    • EngineVersion: La versión del motor. Este campo admite la coincidencia de caracteres comodín.

  • AWS::Redshift::Cluster:

    • ClusterIdentifier: el identificador del clúster. Este campo admite la coincidencia de caracteres comodín.

  • AWS::S3::Bucket:

    • BucketName: el nombre del depósito de S3. Este campo admite la coincidencia de caracteres comodín.

  • AWS::Synthetics::Canary:

    • CanaryName: El nombre del canario Synthetics.

Otras propiedades del filtro:

  • Etiqueta: el filtro se aplica a cualquier recurso que ya tenga aplicada la etiqueta indicada. El valor de esta propiedad debe ser un objeto JSON con los siguientes campos:

    • Clave: debe ser una cadena exacta y especifica que los recursos deben tener una etiqueta con esa clave exacta.

    • Valor: especifica el valor coincidente de la etiqueta. Admite caracteres comodín, por lo que el valor de Sample coincide con cualquier valor que termine en la cadena Sample.

  • Fn: :AND: matriz JSON de objetos JSON. Cada objeto sigue las mismas reglas que el bloque de configuración del filtro. Esto especifica que el filtro coincide con cualquier recurso que coincida con todos los subfiltros.

  • Fn: :OR: Una matriz JSON de objetos JSON. Cada objeto sigue las mismas reglas que el bloque de configuración del filtro. Esto especifica que el filtro coincide con cualquier recurso que coincida con cualquiera de los subfiltros.

  • Fn: :NOT: un objeto JSON que sigue las mismas reglas que el bloque de configuración del filtro. Esto especifica que el filtro no coincide explícitamente con ningún recurso que coincida con el subfiltro. Utilícelo para especificar las exclusiones de sus reglas de etiquetado.

Etiquetas: las etiquetas que se van a aplicar a los recursos coincidentes. (Consulte Convenciones de denominación y uso de las etiquetas). Este campo es una matriz de pares clave-valor:

  • Clave: la clave de la etiqueta que se va a aplicar.

  • Valor: el valor de la etiqueta que se va a aplicar.

nota

Las etiquetas que aplica Resource Tagger siempre tienen claves que comienzan por ams:rt:. Si no especificas este prefijo en tu perfil, Resource Tagger lo insertará automáticamente. Así es como Resource Tagger distingue las etiquetas que posee y administra de las etiquetas utilizadas por otras herramientas para otros fines.