# Tagging a HealthImaging image set using an AWS SDK
The following code examples show how to tag a HealthImaging image set.
------
#### [ Java ]
**SDK for Java 2.x**
To tag an image set.
```
final String imageSetArn = "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/12345678901234567890123456789012";
TagResource.tagMedicalImagingResource(medicalImagingClient, imageSetArn,
ImmutableMap.of("Deployment", "Development"));
```
The utility function for tagging a resource.
```
public static void tagMedicalImagingResource(MedicalImagingClient medicalImagingClient,
String resourceArn,
Map tags) {
try {
TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
.resourceArn(resourceArn)
.tags(tags)
.build();
medicalImagingClient.tagResource(tagResourceRequest);
System.out.println("Tags have been added to the resource.");
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
To list tags for an image set.
```
final String imageSetArn = "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/12345678901234567890123456789012";
ListTagsForResourceResponse result = ListTagsForResource.listMedicalImagingResourceTags(
medicalImagingClient,
imageSetArn);
if (result != null) {
System.out.println("Tags for resource: " + result.tags());
}
```
The utility function for listing a resource's tags.
```
public static ListTagsForResourceResponse listMedicalImagingResourceTags(MedicalImagingClient medicalImagingClient,
String resourceArn) {
try {
ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder()
.resourceArn(resourceArn)
.build();
return medicalImagingClient.listTagsForResource(listTagsForResourceRequest);
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
```
To untag an image set.
```
final String imageSetArn = "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/12345678901234567890123456789012";
UntagResource.untagMedicalImagingResource(medicalImagingClient, imageSetArn,
Collections.singletonList("Deployment"));
```
The utility function for untagging a resource.
```
public static void untagMedicalImagingResource(MedicalImagingClient medicalImagingClient,
String resourceArn,
Collection tagKeys) {
try {
UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder()
.resourceArn(resourceArn)
.tagKeys(tagKeys)
.build();
medicalImagingClient.untagResource(untagResourceRequest);
System.out.println("Tags have been removed from the resource.");
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
+ For API details, see the following topics in *AWS SDK for Java 2.x API Reference*.
+ [ListTagsForResource](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/ListTagsForResource)
+ [TagResource](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/TagResource)
+ [UntagResource](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/UntagResource)
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples).
------
#### [ JavaScript ]
**SDK for JavaScript (v3)**
To tag an image set.
```
try {
const imagesetArn =
"arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/12345678901234567890123456789012";
const tags = {
Deployment: "Development",
};
await tagResource(imagesetArn, tags);
} catch (e) {
console.log(e);
}
```
The utility function for tagging a resource.
```
import { TagResourceCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} resourceArn - The Amazon Resource Name (ARN) for the data store or image set.
* @param {Record} tags - The tags to add to the resource as JSON.
* - For example: {"Deployment" : "Development"}
*/
export const tagResource = async (
resourceArn = "arn:aws:medical-imaging:us-east-1:xxxxxx:datastore/xxxxx/imageset/xxx",
tags = {},
) => {
const response = await medicalImagingClient.send(
new TagResourceCommand({ resourceArn: resourceArn, tags: tags }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 204,
// requestId: '8a6de9a3-ec8e-47ef-8643-473518b19d45',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// }
// }
return response;
};
```
To list tags for an image set.
```
try {
const imagesetArn =
"arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/12345678901234567890123456789012";
const { tags } = await listTagsForResource(imagesetArn);
console.log(tags);
} catch (e) {
console.log(e);
}
```
The utility function for listing a resource's tags.
```
import { ListTagsForResourceCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} resourceArn - The Amazon Resource Name (ARN) for the data store or image set.
*/
export const listTagsForResource = async (
resourceArn = "arn:aws:medical-imaging:us-east-1:abc:datastore/def/imageset/ghi",
) => {
const response = await medicalImagingClient.send(
new ListTagsForResourceCommand({ resourceArn: resourceArn }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '008fc6d3-abec-4870-a155-20fa3631e645',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// tags: { Deployment: 'Development' }
// }
return response;
};
```
To untag an image set.
```
try {
const imagesetArn =
"arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/12345678901234567890123456789012";
const keys = ["Deployment"];
await untagResource(imagesetArn, keys);
} catch (e) {
console.log(e);
}
```
The utility function for untagging a resource.
```
import { UntagResourceCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
/**
* @param {string} resourceArn - The Amazon Resource Name (ARN) for the data store or image set.
* @param {string[]} tagKeys - The keys of the tags to remove.
*/
export const untagResource = async (
resourceArn = "arn:aws:medical-imaging:us-east-1:xxxxxx:datastore/xxxxx/imageset/xxx",
tagKeys = [],
) => {
const response = await medicalImagingClient.send(
new UntagResourceCommand({ resourceArn: resourceArn, tagKeys: tagKeys }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 204,
// requestId: '8a6de9a3-ec8e-47ef-8643-473518b19d45',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// }
// }
return response;
};
```
+ For API details, see the following topics in *AWS SDK for JavaScript API Reference*.
+ [ListTagsForResource](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/ListTagsForResourceCommand)
+ [TagResource](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/TagResourceCommand)
+ [UntagResource](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/UntagResourceCommand)
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
#### [ Python ]
**SDK for Python (Boto3)**
To tag an image set.
```
an_image_set_arn = (
"arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/"
"imageset/12345678901234567890123456789012"
)
medical_imaging_wrapper.tag_resource(image_set_arn, {"Deployment": "Development"})
```
The utility function for tagging a resource.
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def tag_resource(self, resource_arn, tags):
"""
Tag a resource.
:param resource_arn: The ARN of the resource.
:param tags: The tags to apply.
"""
try:
self.health_imaging_client.tag_resource(resourceArn=resource_arn, tags=tags)
except ClientError as err:
logger.error(
"Couldn't tag resource. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
To list tags for an image set.
```
an_image_set_arn = (
"arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/"
"imageset/12345678901234567890123456789012"
)
medical_imaging_wrapper.list_tags_for_resource(image_set_arn)
```
The utility function for listing a resource's tags.
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def list_tags_for_resource(self, resource_arn):
"""
List the tags for a resource.
:param resource_arn: The ARN of the resource.
:return: The list of tags.
"""
try:
tags = self.health_imaging_client.list_tags_for_resource(
resourceArn=resource_arn
)
except ClientError as err:
logger.error(
"Couldn't list tags for resource. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return tags["tags"]
```
To untag an image set.
```
an_image_set_arn = (
"arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/"
"imageset/12345678901234567890123456789012"
)
medical_imaging_wrapper.untag_resource(image_set_arn, ["Deployment"])
```
The utility function for untagging a resource.
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def untag_resource(self, resource_arn, tag_keys):
"""
Untag a resource.
:param resource_arn: The ARN of the resource.
:param tag_keys: The tag keys to remove.
"""
try:
self.health_imaging_client.untag_resource(
resourceArn=resource_arn, tagKeys=tag_keys
)
except ClientError as err:
logger.error(
"Couldn't untag resource. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
The following code instantiates the MedicalImagingWrapper object.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ For API details, see the following topics in *AWS SDK for Python (Boto3) API Reference*.
+ [ListTagsForResource](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/ListTagsForResource)
+ [TagResource](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/TagResource)
+ [UntagResource](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/UntagResource)
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples).
------
For a complete list of AWS SDK developer guides and code examples, see [Using this service with an AWS SDK](sdk-general-information-section.md). This topic also includes information about getting started and details about previous SDK versions.