

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.

# Búsqueda de instancias DICOM en HealthImaging
<a name="dicomweb-search-instances"></a>

[Utilice la `SearchDICOMInstances` API para buscar instancias DICOM en un almacén de datos. HealthImaging ](getting-started-concepts.md#concept-data-store) Para buscar instancias de DICOM, cree una URL que incluya los elementos de datos DICOM (atributos) compatibles. HealthImaging Los resultados de la instancia se devuelven en formato JSON, ordenados de forma ascendente (del más antiguo al más reciente).

**Para buscar instancias DICOM**  


1.  HealthImaging `region`Recopila y `datastoreId` valora. Para obtener más información, consulte [Obtención de propiedades de los almacenes de datos](get-data-store.md).

1. Recopila valores para `StudyInstanceUID` y`SeriesInstanceUID`. Para obtener más información, consulte [Obtención de metadatos de conjuntos de imágenes](get-image-set-metadata.md).

1. Cree una URL para la solicitud, que incluya todos los elementos de búsqueda aplicables. Para ver la ruta URL completa en el siguiente ejemplo, desplázate sobre el botón **Copiar**. La URL tiene el siguiente formato:

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]
   ```  
**Elementos de instancia para `SearchDICOMInstances`**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/healthimaging/latest/devguide/dicomweb-search-instances.html)

   HealthImaging utiliza el elemento DICOM [(0008,1196)](https://dicom.nema.org/dicom/2013/output/chtml/part18/sect_6.6.html#sect_6.6.1.3.2.1.1) para conservar los códigos de advertencia de importación. Los códigos de advertencia de importación se pueden buscar a nivel de instancia. Los códigos de advertencia de importación se pueden buscar con caracteres comodín o códigos de advertencia específicos. Consulte [HealthImaging Códigos de advertencia](reference-warning-codes.md).

1. Prepara y envía tu solicitud. `SearchDICOMInstances`utiliza una solicitud HTTP GET con el protocolo de [AWS firma Signature versión 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). En el siguiente ejemplo, se utiliza la herramienta de línea de `curl` comandos para buscar información sobre las instancias DICOM.

------
#### [ curl ]

   ```
   curl --request GET \
     "https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]"
     --aws-sigv4 'aws:amz:us-east-1:medical-imaging' \
     --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
     --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
     --header 'Accept: application/dicom+json' \
     --output results.json
   ```

   Los resultados de la búsqueda de instancias se devuelven en formato JSON, ordenados `Instance Number (0020,0013)` en orden ascendente (de la más antigua a la más reciente)

------