Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# GetImages
<a name="API_reader_GetImages"></a>

Il supporto gestito per le immagini offre un modo completamente gestito per ottenere immagini dai dati video trasmessi e archiviati in Kinesis Video Streams. Puoi utilizzare le immagini per eseguire carichi di lavoro di machine learning (ML) come il rilevamento di persone, animali domestici o veicoli. Le immagini possono anche essere utilizzate per aggiungere elementi interattivi alla riproduzione, come anteprime delle immagini per eventi di movimento e scorrimento per un videoclip. 

GetImages recupera anche un elenco di immagini corrispondenti a ciascun timestamp per un determinato intervallo di tempo, intervallo di campionamento e configurazione del formato dell'immagine.

**Nota**  
Devi prima chiamare l'`GetDataEndpoint`API per ottenere un endpoint. Quindi invia le `GetImages` richieste a questo endpoint utilizzando il parametro [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). 

 [Requisiti della traccia di riproduzione video.](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html)

## Sintassi della richiesta
<a name="API_reader_GetImages_RequestSyntax"></a>

```
POST /getImages HTTP/1.1
Content-type: application/json

{
   "EndTimestamp": number,
   "Format": "string",
   "FormatConfig": { 
      "string" : "string" 
   },
   "HeightPixels": number,
   "ImageSelectorType": "string",
   "MaxResults": number,
   "NextToken": "string",
   "SamplingInterval": number,
   "StartTimestamp": number,
   "StreamARN": "string",
   "StreamName": "string",
   "WidthPixels": number
}
```

## Parametri della richiesta URI:
<a name="API_reader_GetImages_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_reader_GetImages_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [EndTimestamp](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-EndTimestamp"></a>
Il timestamp di fine dell'intervallo di immagini da generare. Se l'intervallo di tempo compreso tra `StartTimestamp` e `EndTimestamp` supera i 300 secondi`StartTimestamp`, riceverai un. `IllegalArgumentException`  
Tipo: Timestamp  
Obbligatorio: sì

 ** [Format](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-Format"></a>
Il formato che verrà utilizzato per codificare l'immagine.  
Tipo: String  
Valori validi: `JPEG | PNG`   
Obbligatorio: sì

 ** [FormatConfig](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-FormatConfig"></a>
L'elenco di una struttura di coppie chiave-valore che contiene parametri aggiuntivi che possono essere applicati quando viene generata l'immagine. La `FormatConfig` chiave è la`JPEGQuality`, che indica la chiave di qualità JPEG da utilizzare per generare l'immagine. Il `FormatConfig` valore accetta int da 1 a 100. Se il valore è 1, l'immagine verrà generata con una qualità inferiore e la compressione migliore. Se il valore è 100, l'immagine verrà generata con la migliore qualità e una compressione inferiore. Se non viene fornito alcun valore, il valore predefinito della `JPEGQuality` chiave verrà impostato su 80.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 1 elemento.  
Chiavi valide: `JPEGQuality`   
Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello di valore: `^[a-zA-Z_0-9]+`   
Obbligatorio: no

 ** [HeightPixels](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-HeightPixels"></a>
L'altezza dell'immagine di output utilizzata insieme al parametro. `WidthPixels` Quando vengono forniti entrambi `HeightPixels` i `WidthPixels` parametri, l'immagine verrà allungata per adattarsi alle proporzioni specificate. Se viene fornito solo il `HeightPixels` parametro, per calcolare il rapporto verranno utilizzate le `WidthPixels` proporzioni originali. Se non viene fornito alcun parametro, verrà restituita la dimensione originale dell'immagine.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 2160.  
Obbligatorio: no

 ** [ImageSelectorType](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-ImageSelectorType"></a>
L'origine dei timestamp del Server o del Produttore da utilizzare per generare le immagini.  
Tipo: String  
Valori validi: `PRODUCER_TIMESTAMP | SERVER_TIMESTAMP`   
Obbligatorio: sì

 ** [MaxResults](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-MaxResults"></a>
Il numero massimo di immagini che l'API deve restituire.   
Il limite predefinito è di 25 immagini per risposta API. Fornendo un valore `MaxResults` superiore a questo si otterrà una dimensione della pagina di 25. Eventuali risultati aggiuntivi verranno suddivisi in pagine. 
Tipo: long  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [NextToken](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-NextToken"></a>
Un token che specifica da dove iniziare a impaginare il prossimo set di immagini. Questo è il risultato di una `GetImages:NextToken` risposta precedentemente troncata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 4096.  
Modello: `[a-zA-Z0-9+/]+={0,2}`   
Obbligatorio: no

 ** [SamplingInterval](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-SamplingInterval"></a>
L'intervallo di tempo in millisecondi (ms) in cui le immagini devono essere generate dallo stream. Il valore minimo che può essere fornito è 200 ms (5 immagini al secondo). Se l'intervallo del timestamp è inferiore all'intervallo di campionamento, l'immagine da `startTimestamp` verrà restituita, se disponibile.   
Tipo: Integer  
Obbligatorio: no

 ** [StartTimestamp](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-StartTimestamp"></a>
Il punto di partenza da cui devono essere generate le immagini. Affinché un'immagine possa essere restituita, questo `StartTimestamp` deve rientrare in un intervallo completo di timestamp.  
Tipo: Timestamp  
Obbligatorio: sì

 ** [StreamARN](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-StreamARN"></a>
L'Amazon Resource Name (ARN) dello stream da cui recuperare le immagini. Devi specificare il `StreamName` o il. `StreamARN`  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.  
Modello: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
Obbligatorio: no

 ** [StreamName](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-StreamName"></a>
Il nome dello stream da cui recuperare le immagini. È necessario specificare il `StreamName` o il`StreamARN`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `[a-zA-Z0-9_.-]+`   
Obbligatorio: no

 ** [WidthPixels](#API_reader_GetImages_RequestSyntax) **   <a name="KinesisVideo-reader_GetImages-request-WidthPixels"></a>
La larghezza dell'immagine di output utilizzata insieme al `HeightPixels` parametro. Quando vengono forniti entrambi `WidthPixels` i `HeightPixels` parametri, l'immagine verrà allungata per adattarsi alle proporzioni specificate. Se viene fornito solo il `WidthPixels` parametro o se `HeightPixels` viene fornito solo il, `ValidationException` verrà generato un. Se non viene fornito nessun parametro, verrà restituita la dimensione dell'immagine originale dello stream.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 3840.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_reader_GetImages_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Images": [ 
      { 
         "Error": "string",
         "ImageContent": "string",
         "TimeStamp": number
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_reader_GetImages_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Images](#API_reader_GetImages_ResponseSyntax) **   <a name="KinesisVideo-reader_GetImages-response-Images"></a>
L'elenco delle immagini generate dal flusso video. Se non è disponibile alcun supporto per il timestamp specificato, l'`NO_MEDIA`errore verrà elencato nell'output. Se si verifica un errore durante la generazione dell'immagine, `MEDIA_ERROR` questo verrà elencato nell'output come causa dell'immagine mancante.   
Tipo: matrice di oggetti [Image](API_reader_Image.md)

 ** [NextToken](#API_reader_GetImages_ResponseSyntax) **   <a name="KinesisVideo-reader_GetImages-response-NextToken"></a>
Il token crittografato utilizzato nella richiesta per ottenere altre immagini.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 4096.  
Modello: `[a-zA-Z0-9+/]+={0,2}` 

## Errori
<a name="API_reader_GetImages_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** ClientLimitExceededException **   
Kinesis Video Streams ha limitato la richiesta perché hai superato un limite. Prova a effettuare la chiamata più tardi. Per informazioni sui limiti, consulta la sezione [Quote di Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html).  
Codice di stato HTTP: 400

 ** InvalidArgumentException **   
Un parametro specificato supera le restrizioni, non è supportato o non può essere utilizzato.  
Codice di stato HTTP: 400

 ** NoDataRetentionException **   
 `GetImages`è stato richiesto per uno stream che non conserva dati (ovvero ha un valore `DataRetentionInHours` pari a 0).   
Codice di stato HTTP: 400

 ** NotAuthorizedException **   
Codice di stato: 403, il chiamante non è autorizzato a eseguire un'operazione sullo stream specificato o il token è scaduto.  
Codice di stato HTTP: 401

 ** ResourceNotFoundException **   
 `GetImages`genererà questo errore quando Kinesis Video Streams non riesce a trovare lo stream specificato.  
 `GetHLSStreamingSessionURL`e `GetDASHStreamingSessionURL` genera questo errore se `LIVE_REPLAY` viene richiesta una sessione con un `PlaybackMode` of `ON_DEMAND` o per uno stream che non contiene frammenti nell'intervallo di tempo richiesto, o se `LIVE` viene richiesta una sessione con un `PlaybackMode` of per uno stream che non contiene frammenti negli ultimi 30 secondi.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_reader_GetImages_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetImages) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetImages) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetImages) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetImages) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetImages) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetImages) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetImages) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetImages) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetImages) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetImages)