Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Marquage des magasins de HealthLake données Vous pouvez attribuer des métadonnées aux HealthLake banques de données sous forme de balises. Chaque balise est une étiquette composée d’une clé définie par l’utilisateur et d’une valeur. Les balises vous aident à gérer, identifier, organiser, rechercher et filtrer les banques de données. **Important** Ne stockez pas d'informations de santé protégées (PHI), d'informations personnelles identifiables (PII) ou d'autres informations confidentielles ou sensibles dans des balises. Les étiquettes ne sont pas destinées à être utilisées pour des données privées ou sensibles. Les rubriques suivantes décrivent comment utiliser les opérations de HealthLake balisage à l'aide des AWS Management Console touches AWS CLI, et AWS SDKs. Pour plus d'informations, consultez la section [Marquage de vos AWS ressources](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html) dans le *Références générales AWS guide*. **Topics** + [Marquage d'un magasin de HealthLake données](#tagresource) + [Répertorier les balises d'un magasin HealthLake de données](#listtagsforresource) + [Débalisage d'un magasin de données HealthLake](#untagresource) ## Marquage d'un magasin de HealthLake données `TagResource`À utiliser pour étiqueter un magasin de HealthLake données. Les menus suivants fournissent une procédure AWS Management Console et des exemples de code pour le AWS CLI et AWS SDKs. Pour plus d’informations, consultez [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_TagResource.html.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_TagResource.html.html) dans la *Référence d’API AWS HealthLake *. **Pour étiqueter un magasin HealthLake de données** Choisissez un menu en fonction de vos préférences d'accès à AWS HealthLake. ### AWS CLI et SDKs ------ #### [ CLI ] **AWS CLI** **Pour ajouter une balise au magasin de données** L’exemple `tag-resource` suivant montre comment ajouter une balise au magasin de données. ``` aws healthlake tag-resource \ --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe" \ --tags '[{"Key": "key1", "Value": "value1"}]' ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez la section [Ajout d'une balise à un magasin de données](https://docs.aws.amazon.com/healthlake/latest/devguide/add-a-tag.html) dans le *Guide du AWS HealthLake développeur.* . + Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/tag-resource.html)à la section *Référence des AWS CLI commandes*. ------ #### [ Python ] **Kit SDK for 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 ``` + Pour plus de détails sur l'API, consultez [TagResource](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/TagResource)le *AWS manuel de référence de l'API SDK for Python (Boto3*). Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples). ------ #### [ SAP ABAP ] **Kit SDK pour SAP ABAP** Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code 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. ``` + Pour plus de détails sur l'API, reportez-vous [TagResource](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)à la section de référence du *AWS SDK pour l'API SAP ABAP*. ------ **Exemple de disponibilité** Vous n’avez pas trouvé ce dont vous avez besoin ? Demandez un exemple de code à l'aide du lien **Fournir des commentaires** dans la barre latérale droite de cette page. ### AWS Console 1. Connectez-vous à la page [Data stores](https://console.aws.amazon.com/healthlake/home#/list-datastores) de la HealthLake console. 1. Choisissez un magasin de données. La page de **détails du magasin de données** s'ouvre. 1. Dans la section **Balises**, choisissez **Gérer les balises**. La page **Gérer les balises** s'ouvre. 1. Sélectionnez **Ajouter une nouvelle balise**. 1. Entrez une **clé** et une **valeur** (facultatif). 1. Choisissez **Enregistrer**. ## Répertorier les balises d'un magasin HealthLake de données `ListTagsForResource`À utiliser pour répertorier les balises d'un magasin de HealthLake données. Les menus suivants fournissent une procédure AWS Management Console et des exemples de code pour le AWS CLI et AWS SDKs. Pour plus d’informations, consultez [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListTagsForResource.html.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ListTagsForResource.html.html) dans la *Référence d’API AWS HealthLake *. **Pour répertorier les balises d'un magasin HealthLake de données** Choisissez un menu en fonction de vos préférences d'accès à AWS HealthLake. ### AWS CLI et SDKs ------ #### [ CLI ] **AWS CLI** **Pour répertorier les balises d’un magasin de données** L’exemple `list-tags-for-resource` suivant répertorie les balises associées au magasin de données spécifié. ``` aws healthlake list-tags-for-resource \ --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe" ``` Sortie : ``` { "tags": { "key": "value", "key1": "value1" } } ``` Pour plus d'informations, consultez la section consacrée au [balisage des ressources AWS HealthLake dans](https://docs.aws.amazon.com/healthlake/latest/devguide/tagging.html) le guide du AWS HealthLake développeur. + Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*. ------ #### [ Python ] **Kit SDK for 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 ``` + Pour plus de détails sur l'API, consultez [ListTagsForResource](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/ListTagsForResource)le *AWS manuel de référence de l'API SDK for Python (Boto3*). Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples). ------ #### [ SAP ABAP ] **Kit SDK pour SAP ABAP** Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code 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. ``` + Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)à la section de référence du *AWS SDK pour l'API SAP ABAP*. ------ **Exemple de disponibilité** Vous n’avez pas trouvé ce dont vous avez besoin ? Demandez un exemple de code à l'aide du lien **Fournir des commentaires** dans la barre latérale droite de cette page. ### AWS Console 1. Connectez-vous à la page [Data stores](https://console.aws.amazon.com/healthlake/home#/list-datastores) de la HealthLake console. 1. Choisissez un magasin de données. La page de **détails du magasin de données** s'ouvre. Dans la section **Balises**, toutes les balises du magasin de données sont répertoriées. ## Débalisage d'un magasin de données HealthLake `UntagResource`À utiliser pour supprimer une étiquette d'un magasin de HealthLake données. Les menus suivants fournissent une procédure AWS Management Console et des exemples de code pour le AWS CLI et AWS SDKs. Pour plus d’informations, consultez [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_UntagResource.html.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_UntagResource.html.html) dans la *Référence d’API AWS HealthLake *. **Pour supprimer le balisage d'un magasin HealthLake de données** Choisissez un menu en fonction de vos préférences d'accès à AWS HealthLake. ### AWS CLI et SDKs ------ #### [ CLI ] **AWS CLI** **Pour supprimer des balises d’un magasin de données.** L’exemple `untag-resource` suivant montre comment supprimer des balises d’un magasin de données. ``` aws healthlake untag-resource \ --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/b91723d65c6fdeb1d26543a49d2ed1fa" \ --tag-keys '["key1"]' ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez la section [Suppression de balises d'un magasin de données](https://docs.aws.amazon.com/healthlake/latest/devguide/remove-tags.html) dans le *Guide du AWS HealthLake développeur*. + Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/untag-resource.html)à la section *Référence des AWS CLI commandes*. ------ #### [ Python ] **Kit SDK for 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 ``` + Pour plus de détails sur l'API, consultez [UntagResource](https://docs.aws.amazon.com/goto/boto3/healthlake-2017-07-01/UntagResource)le *AWS manuel de référence de l'API SDK for Python (Boto3*). Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/healthlake#code-examples). ------ #### [ SAP ABAP ] **Kit SDK pour SAP ABAP** Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code 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. ``` + Pour plus de détails sur l'API, reportez-vous [UntagResource](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)à la section de référence du *AWS SDK pour l'API SAP ABAP*. ------ **Exemple de disponibilité** Vous n’avez pas trouvé ce dont vous avez besoin ? Demandez un exemple de code à l'aide du lien **Fournir des commentaires** dans la barre latérale droite de cette page. ### AWS Console 1. Connectez-vous à la page [Data stores](https://console.aws.amazon.com/healthlake/home#/list-datastores) de la HealthLake console. 1. Choisissez un magasin de données. La page de **détails du magasin de données** s'ouvre. 1. Dans la section **Balises**, choisissez **Gérer les balises**. La page **Gérer les balises** s'ouvre. 1. Choisissez **Supprimer** à côté du tag que vous souhaitez supprimer. 1. Choisissez **Enregistrer**.