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. # Etiquetado de almacenes HealthLake de datos Puede asignar metadatos a los almacenes HealthLake de datos en forma de etiquetas. Cada etiqueta es una marca que consta de una clave y un valor definidos por el usuario. Las etiquetas le ayudan a administrar, identificar, organizar, buscar y filtrar los almacenes de datos. **Importante** No almacene información de identificación personal (PII), información médica protegida (PHI) ni otra información confidencial en las etiquetas. Las etiquetas no se han diseñado para usarse con información privada o confidencial. En los temas siguientes se describe cómo utilizar las operaciones de HealthLake etiquetado mediante las letras Consola de administración de AWS AWS CLI, y AWS SDKs. *Para obtener más información, consulte [Etiquetar AWS los recursos](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html) en la Referencia general de AWS Guía.* **Topics** + [Etiquetar un almacén de datos HealthLake](#tagresource) + [Listar etiquetas para un almacén HealthLake de datos](#listtagsforresource) + [Eliminar el etiquetado de un almacén de datos HealthLake](#untagresource) ## Etiquetar un almacén de datos HealthLake Se utiliza `TagResource` para etiquetar un banco HealthLake de datos. Los menús siguientes proporcionan un procedimiento Consola de administración de AWS y ejemplos de código para AWS CLI y AWS SDKs. Para obtener más información, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_TagResource.html.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_TagResource.html.html) en la *AWS HealthLake Referencia de la API de *. **Para etiquetar un HealthLake banco de datos** Elija un menú en función de sus preferencias de acceso a AWS HealthLake. ### AWS CLI y SDKs ------ #### [ CLI ] **AWS CLI** **Agregación de una etiqueta al almacén de datos** En el siguiente ejemplo de `tag-resource`, se muestra cómo agregar una etiqueta a un almacén de datos. ``` aws healthlake tag-resource \ --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe" \ --tags '[{"Key": "key1", "Value": "value1"}]' ``` Este comando no genera ninguna salida. Para obtener más información, consulte [Añadir una etiqueta a un banco de datos](https://docs.aws.amazon.com/healthlake/latest/devguide/add-a-tag.html) en la *Guía para AWS HealthLake desarrolladores.* . + Para obtener más información sobre la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/tag-resource.html)la *Referencia de AWS CLI comandos*. ------ #### [ Python ] **SDK para Python (Boto3)** ``` @classmethod def from_client(cls) -> "HealthLakeWrapper": """ Creates a HealthLakeWrapper instance with a default AWS HealthLake client. :return: An instance of HealthLakeWrapper initialized with the default HealthLake client. """ health_lake_client = boto3.client("healthlake") return cls(health_lake_client) def tag_resource(self, resource_arn: str, tags: list[dict[str, str]]) -> None: """ Tags a HealthLake resource. :param resource_arn: The resource ARN. :param tags: The tags to add to the resource. """ try: self.health_lake_client.tag_resource(ResourceARN=resource_arn, Tags=tags) except ClientError as err: logger.exception( "Couldn't tag resource %s. Here's why %s", resource_arn, err.response["Error"]["Message"], ) raise ``` + Para obtener más información sobre la API, consulta [TagResource](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/TagResource)la *AWS Referencia de API de SDK for Python (Boto3*). Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/hll#code-examples). ``` TRY. " iv_resource_arn = 'arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6' lo_hll->tagresource( iv_resourcearn = iv_resource_arn it_tags = it_tags ). MESSAGE 'Resource tagged successfully.' TYPE 'I'. CATCH /aws1/cx_hllvalidationex INTO DATA(lo_validation_ex). DATA(lv_error) = |Validation error: { lo_validation_ex->av_err_code }-{ lo_validation_ex->av_err_msg }|. MESSAGE lv_error TYPE 'I'. RAISE EXCEPTION lo_validation_ex. CATCH /aws1/cx_hllresourcenotfoundex INTO DATA(lo_notfound_ex). lv_error = |Resource not found: { lo_notfound_ex->av_err_code }-{ lo_notfound_ex->av_err_msg }|. MESSAGE lv_error TYPE 'I'. RAISE EXCEPTION lo_notfound_ex. ENDTRY. ``` + Para obtener más información sobre la API, consulte [TagResource](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ **Ejemplo de disponibilidad** ¿No encuentra lo que necesita? Solicita un ejemplo de código mediante el enlace **Enviar comentarios** que aparece en la barra lateral derecha de esta página. ### AWS Consola 1. Inicie sesión en la página [de almacenes de datos](https://console.aws.amazon.com/healthlake/home#/list-datastores) de la HealthLake consola. 1. Elija un almacén de datos. Se abrirá la página de **Detalles del almacén de datos**. 1. En la sección **Etiquetas**, elija **Administrar etiquetas**. Se abrirá la página de **Administrar etiquetas**. 1. Elija **Añadir nueva etiqueta**. 1. Ingrese una **clave** y un **valor** (opcional). 1. Seleccione **Save**. ## Listar etiquetas para un almacén HealthLake de datos Se utiliza `ListTagsForResource` para enumerar las etiquetas de un HealthLake banco de datos. Los menús siguientes proporcionan un procedimiento Consola de administración de AWS y ejemplos de código para AWS CLI y AWS SDKs. Para obtener más información, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListTagsForResource.html.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListTagsForResource.html.html) en la *AWS HealthLake Referencia de la API de *. **Para enumerar las etiquetas de un HealthLake banco de datos** Elija un menú en función de sus preferencias de acceso a AWS HealthLake. ### AWS CLI y SDKs ------ #### [ CLI ] **AWS CLI** **Muestra de las etiquetas para un almacén de datos** En el siguiente ejemplo de `list-tags-for-resource`, se muestran las etiquetas asociadas al almacén de datos especificado: ``` aws healthlake list-tags-for-resource \ --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe" ``` Salida: ``` { "tags": { "key": "value", "key1": "value1" } } ``` Para obtener más información, consulta Cómo [etiquetar los recursos AWS HealthLake en](https://docs.aws.amazon.com/healthlake/latest/devguide/tagging.html) la Guía para AWS HealthLake desarrolladores. + Para obtener más información sobre la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/list-tags-for-resource.html)la *Referencia de AWS CLI comandos*. ------ #### [ Python ] **SDK para Python (Boto3)** ``` @classmethod def from_client(cls) -> "HealthLakeWrapper": """ Creates a HealthLakeWrapper instance with a default AWS HealthLake client. :return: An instance of HealthLakeWrapper initialized with the default HealthLake client. """ health_lake_client = boto3.client("healthlake") return cls(health_lake_client) def list_tags_for_resource(self, resource_arn: str) -> dict[str, str]: """ Lists the tags for a HealthLake resource. :param resource_arn: The resource ARN. :return: The tags for the resource. """ try: response = self.health_lake_client.list_tags_for_resource( ResourceARN=resource_arn ) return response["Tags"] except ClientError as err: logger.exception( "Couldn't list tags for resource %s. Here's why %s", resource_arn, err.response["Error"]["Message"], ) raise ``` + Para obtener más información sobre la API, consulta [ListTagsForResource](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/ListTagsForResource)la *AWS Referencia de API de SDK for Python (Boto3*). Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/hll#code-examples). ``` TRY. " iv_resource_arn = 'arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6' DATA(lo_result) = lo_hll->listtagsforresource( iv_resourcearn = iv_resource_arn ). ot_tags = lo_result->get_tags( ). DATA(lv_tag_count) = lines( ot_tags ). MESSAGE |Found { lv_tag_count } tag(s).| TYPE 'I'. CATCH /aws1/cx_hllvalidationex INTO DATA(lo_validation_ex). DATA(lv_error) = |Validation error: { lo_validation_ex->av_err_code }-{ lo_validation_ex->av_err_msg }|. MESSAGE lv_error TYPE 'I'. RAISE EXCEPTION lo_validation_ex. CATCH /aws1/cx_hllresourcenotfoundex INTO DATA(lo_notfound_ex). lv_error = |Resource not found: { lo_notfound_ex->av_err_code }-{ lo_notfound_ex->av_err_msg }|. MESSAGE lv_error TYPE 'I'. RAISE EXCEPTION lo_notfound_ex. ENDTRY. ``` + Para obtener más información sobre la API, consulte [ListTagsForResource](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ **Ejemplo de disponibilidad** ¿No encuentra lo que necesita? Solicita un ejemplo de código mediante el enlace **Enviar comentarios** que aparece en la barra lateral derecha de esta página. ### AWS Consola 1. Inicie sesión en la página [de almacenes de datos](https://console.aws.amazon.com/healthlake/home#/list-datastores) de la HealthLake consola. 1. Elija un almacén de datos. Se abrirá la página de **Detalles del almacén de datos**. En la sección **Etiquetas**, se muestran todas las etiquetas del almacén de datos. ## Eliminar el etiquetado de un almacén de datos HealthLake Se utiliza `UntagResource` para eliminar una etiqueta de un banco de HealthLake datos. Los menús siguientes proporcionan un procedimiento Consola de administración de AWS y ejemplos de código para AWS CLI y AWS SDKs. Para obtener más información, consulta [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_UntagResource.html.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_UntagResource.html.html) en la *AWS HealthLake Referencia de la API de *. **Para quitar la etiqueta de un banco HealthLake de datos** Elija un menú en función de sus preferencias de acceso a AWS HealthLake. ### AWS CLI y SDKs ------ #### [ CLI ] **AWS CLI** **Eliminación de etiquetas de un almacén de datos.** En el siguiente ejemplo de `untag-resource`, se muestra cómo eliminar etiquetas de un almacén de datos. ``` aws healthlake untag-resource \ --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/b91723d65c6fdeb1d26543a49d2ed1fa" \ --tag-keys '["key1"]' ``` Este comando no genera ninguna salida. Para obtener más información, consulte [Eliminar etiquetas de un banco de datos](https://docs.aws.amazon.com/healthlake/latest/devguide/remove-tags.html) en la *Guía para AWS HealthLake desarrolladores*. + Para obtener más información sobre la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/untag-resource.html)la *Referencia de AWS CLI comandos*. ------ #### [ Python ] **SDK para Python (Boto3)** ``` @classmethod def from_client(cls) -> "HealthLakeWrapper": """ Creates a HealthLakeWrapper instance with a default AWS HealthLake client. :return: An instance of HealthLakeWrapper initialized with the default HealthLake client. """ health_lake_client = boto3.client("healthlake") return cls(health_lake_client) def untag_resource(self, resource_arn: str, tag_keys: list[str]) -> None: """ Untags a HealthLake resource. :param resource_arn: The resource ARN. :param tag_keys: The tag keys to remove from the resource. """ try: self.health_lake_client.untag_resource( ResourceARN=resource_arn, TagKeys=tag_keys ) except ClientError as err: logger.exception( "Couldn't untag resource %s. Here's why %s", resource_arn, err.response["Error"]["Message"], ) raise ``` + Para obtener más información sobre la API, consulta [UntagResource](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/UntagResource)la *AWS Referencia de API de SDK for Python (Boto3*). Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/hll#code-examples). ``` TRY. " iv_resource_arn = 'arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6' lo_hll->untagresource( iv_resourcearn = iv_resource_arn it_tagkeys = it_tag_keys ). MESSAGE 'Resource untagged successfully.' TYPE 'I'. CATCH /aws1/cx_hllvalidationex INTO DATA(lo_validation_ex). DATA(lv_error) = |Validation error: { lo_validation_ex->av_err_code }-{ lo_validation_ex->av_err_msg }|. MESSAGE lv_error TYPE 'I'. RAISE EXCEPTION lo_validation_ex. CATCH /aws1/cx_hllresourcenotfoundex INTO DATA(lo_notfound_ex). lv_error = |Resource not found: { lo_notfound_ex->av_err_code }-{ lo_notfound_ex->av_err_msg }|. MESSAGE lv_error TYPE 'I'. RAISE EXCEPTION lo_notfound_ex. ENDTRY. ``` + Para obtener más información sobre la API, consulte [UntagResource](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ **Ejemplo de disponibilidad** ¿No encuentra lo que necesita? Solicita un ejemplo de código mediante el enlace **Enviar comentarios** que aparece en la barra lateral derecha de esta página. ### AWS Consola 1. Inicie sesión en la página [de almacenes de datos](https://console.aws.amazon.com/healthlake/home#/list-datastores) de la HealthLake consola. 1. Elija un almacén de datos. Se abrirá la página de **Detalles del almacén de datos**. 1. En la sección **Etiquetas**, elija **Administrar etiquetas**. Se abrirá la página de **Administrar etiquetas**. 1. Elija **Eliminar** junto a la etiqueta que desea eliminar. 1. Seleccione **Save**.