Uso del etiquetado - Guía para desarrolladores de aplicaciones de Amazon Kinesis Data Analytics para SQL
Adición de etiquetas al crear una aplicaciónAdición o actualización de etiquetas en una aplicación existenteMostrar las etiquetas de una aplicaciónEliminación de etiquetas de una aplicación

Para proyectos nuevos, le recomendamos que utilice el nuevo servicio gestionado para Apache Flink Studio en lugar de aplicaciones de Kinesis Data Analytics para SQL. El servicio gestionado para Apache Flink Studio combina la facilidad de uso con capacidades analíticas avanzadas, lo que le permite crear aplicaciones sofisticadas de procesamiento de flujos en cuestión de minutos.

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.

Uso del etiquetado

En esta sección, se describe cómo añadir etiquetas de metadatos de clave-valor a las aplicaciones de Kinesis Data Analytics. Estas etiquetas se pueden utilizar para lo siguiente:

  • Determinar la facturación de las aplicaciones individuales de Kinesis Data Analytics. Para obtener más información, consulte Uso de etiquetas de asignación de costos en la AWSGuía de administración de costos y facturación.

  • Controlar el acceso a los recursos de la aplicación en función de las etiquetas. Para obtener más información, consulte Control del acceso mediante etiquetas en la Guía del usuario.

  • Fines definidos por el usuario. Puede definir la funcionalidad de la aplicación en función de la presencia de etiquetas del usuario.

Tenga en cuenta la siguiente información sobre el etiquetado:

  • El número máximo de etiquetas incluye las etiquetas del sistema. El número máximo de etiquetas de la aplicación definidas por el usuario es 50.

  • Si una acción incluye una lista de etiquetas que tiene valores Key duplicados, el servicio genera una excepción de tipo InvalidArgumentException.

Adición de etiquetas al crear una aplicación

Puede añadir etiquetas al crear una aplicación utilizando el parámetro tags de la acción CreateApplication.

En la siguiente solicitud de ejemplo, se muestra el nodo Tags de una solicitud CreateApplication:

"Tags": [ 
    { 
        "Key": "Key1",
        "Value": "Value1"
    },
    { 
        "Key": "Key2",
        "Value": "Value2"
    }
]

Adición o actualización de etiquetas en una aplicación existente

Puede añadir etiquetas a una aplicación utilizando la acción TagResource. No se pueden agregar etiquetas a una aplicación utilizando la acción UpdateApplication.

Para actualizar una etiqueta existente, añada otra etiqueta con la misma clave.

En la siguiente solicitud de ejemplo de la acción TagResource, se añaden nuevas etiquetas o se actualizan las etiquetas existentes:

{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "NewTagKey",
         "Value": "NewTagValue"
      },
      { 
         "Key": "ExistingKeyOfTagToUpdate",
         "Value": "NewValueForExistingTag"
      }
   ]
}

Mostrar las etiquetas de una aplicación

Para obtener una lista de las etiquetas existentes, utilice la acción ListTagsForResource.

En la siguiente solicitud de ejemplo de la acción ListTagsForResource, se muestran las etiquetas de una aplicación:

{
   "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication"
}

Eliminación de etiquetas de una aplicación

Para eliminar las etiquetas de una aplicación, use la acción UntagResource.

En la siguiente solicitud de ejemplo de la acción UntagResource, se eliminan etiquetas de una aplicación:

{
   "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication",
   "TagKeys": [ "KeyOfFirstTagToRemove", "KeyOfSecondTagToRemove" ]
}