# Use `ListDatastores` with an AWS SDK or CLI
The following code examples show how to use `ListDatastores`.
------
#### [ Bash ]
**AWS CLI with Bash script**
```
###############################################################################
# function errecho
#
# This function outputs everything sent to it to STDERR (standard error output).
###############################################################################
function errecho() {
printf "%s\n" "$*" 1>&2
}
###############################################################################
# function imaging_list_datastores
#
# List the HealthImaging data stores in the account.
#
# Returns:
# [[datastore_name, datastore_id, datastore_status]]
# And:
# 0 - If successful.
# 1 - If it fails.
###############################################################################
function imaging_list_datastores() {
local option OPTARG # Required to use getopts command in a function.
local error_code
# bashsupport disable=BP5008
function usage() {
echo "function imaging_list_datastores"
echo "Lists the AWS HealthImaging data stores in the account."
echo ""
}
# Retrieve the calling parameters.
while getopts "h" option; do
case "${option}" in
h)
usage
return 0
;;
\?)
echo "Invalid parameter"
usage
return 1
;;
esac
done
export OPTIND=1
local response
response=$(aws medical-imaging list-datastores \
--output text \
--query "datastoreSummaries[*][datastoreName, datastoreId, datastoreStatus]")
error_code=${?}
if [[ $error_code -ne 0 ]]; then
aws_cli_error_log $error_code
errecho "ERROR: AWS reports list-datastores operation failed.$response"
return 1
fi
echo "$response"
return 0
}
```
+ For API details, see [ListDatastores](https://docs.aws.amazon.com/goto/aws-cli/medical-imaging-2023-07-19/ListDatastores) in *AWS CLI Command Reference*.
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/aws-cli/bash-linux/medical-imaging#code-examples).
------
#### [ CLI ]
**AWS CLI**
**To list data stores**
The following `list-datastores` code example lists available data stores.
```
aws medical-imaging list-datastores
```
Output:
```
{
"datastoreSummaries": [
{
"datastoreId": "12345678901234567890123456789012",
"datastoreName": "TestDatastore123",
"datastoreStatus": "ACTIVE",
"datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012",
"createdAt": "2022-11-15T23:33:09.643000+00:00",
"updatedAt": "2022-11-15T23:33:09.643000+00:00"
}
]
}
```
+ For API details, see [ListDatastores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-datastores.html) in *AWS CLI Command Reference*.
------
#### [ Java ]
**SDK for Java 2.x**
```
public static List listMedicalImagingDatastores(MedicalImagingClient medicalImagingClient) {
try {
ListDatastoresRequest datastoreRequest = ListDatastoresRequest.builder()
.build();
ListDatastoresIterable responses = medicalImagingClient.listDatastoresPaginator(datastoreRequest);
List datastoreSummaries = new ArrayList<>();
responses.stream().forEach(response -> datastoreSummaries.addAll(response.datastoreSummaries()));
return datastoreSummaries;
} catch (MedicalImagingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
```
+ For API details, see [ListDatastores](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/ListDatastores) in *AWS SDK for Java 2.x API Reference*.
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)**
```
import { paginateListDatastores } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
export const listDatastores = async () => {
const paginatorConfig = {
client: medicalImagingClient,
pageSize: 50,
};
const commandParams = {};
const paginator = paginateListDatastores(paginatorConfig, commandParams);
/**
* @type {import("@aws-sdk/client-medical-imaging").DatastoreSummary[]}
*/
const datastoreSummaries = [];
for await (const page of paginator) {
// Each page contains a list of `jobSummaries`. The list is truncated if is larger than `pageSize`.
datastoreSummaries.push(...page.datastoreSummaries);
console.log(page);
}
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '6aa99231-d9c2-4716-a46e-edb830116fa3',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// datastoreSummaries: [
// {
// createdAt: 2023-08-04T18:49:54.429Z,
// datastoreArn: 'arn:aws:medical-imaging:us-east-1:xxxxxxxxx:datastore/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// datastoreName: 'my_datastore',
// datastoreStatus: 'ACTIVE',
// updatedAt: 2023-08-04T18:49:54.429Z
// }
// ...
// ]
// }
return datastoreSummaries;
};
```
+ For API details, see [ListDatastores](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/ListDatastoresCommand) in *AWS SDK for JavaScript API Reference*.
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)**
```
class MedicalImagingWrapper:
def __init__(self, health_imaging_client):
self.health_imaging_client = health_imaging_client
def list_datastores(self):
"""
List the data stores.
:return: The list of data stores.
"""
try:
paginator = self.health_imaging_client.get_paginator("list_datastores")
page_iterator = paginator.paginate()
datastore_summaries = []
for page in page_iterator:
datastore_summaries.extend(page["datastoreSummaries"])
except ClientError as err:
logger.error(
"Couldn't list data stores. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return datastore_summaries
```
The following code instantiates the MedicalImagingWrapper object.
```
client = boto3.client("medical-imaging")
medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+ For API details, see [ListDatastores](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/ListDatastores) in *AWS SDK for Python (Boto3) API Reference*.
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/python/example_code/medical-imaging#code-examples).
------
#### [ SAP ABAP ]
**SDK for SAP ABAP**
```
TRY.
oo_result = lo_mig->listdatastores( ).
DATA(lt_datastores) = oo_result->get_datastoresummaries( ).
DATA(lv_count) = lines( lt_datastores ).
MESSAGE |Found { lv_count } data stores.| TYPE 'I'.
CATCH /aws1/cx_migaccessdeniedex.
MESSAGE 'Access denied.' TYPE 'I'.
CATCH /aws1/cx_miginternalserverex.
MESSAGE 'Internal server error.' TYPE 'I'.
CATCH /aws1/cx_migthrottlingex.
MESSAGE 'Request throttled.' TYPE 'I'.
CATCH /aws1/cx_migvalidationex.
MESSAGE 'Validation error.' TYPE 'I'.
ENDTRY.
```
+ For API details, see [ListDatastores](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP API reference*.
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/sap-abap/services/mig#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.