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à.
# GetObject (API SOAP)
**Nota**
Le API SOAP per Amazon S3 non sono disponibili per i nuovi clienti, con la fine del ciclo di vita prevista per il 31 agosto 2025. Ti consigliamo di utilizzare l'API REST o gli AWS SDK.
L'`GetObject`operazione restituisce la versione corrente di un oggetto. Se si tenta di utilizzare `GetObject` un oggetto con un indicatore di eliminazione come versione corrente, S3 restituisce un errore 404. Non è possibile utilizzare l'API SOAP per recuperare una versione specificata di un oggetto. Per farlo, usa l'API REST. Per ulteriori informazioni, vedere Controllo [ delle versioni](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html). Per ulteriori opzioni, utilizzare l'[GetObjectExtended (API SOAP)](SOAPGetObjectExtended.md)operazione.
**Nota**
I nomi delle chiavi dell'oggetto con il valore "soap" non sono supportati per [richieste in stile hosting virtuale](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access). Per i valori dei nomi delle chiavi dell'oggetto in cui viene utilizzato "soap", deve invece essere usato un [URL in stile percorso](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access).
**Example**
Questo esempio ottiene l'oggetto «Nelson» dal bucket «quotes».
`Sample Request`
```
1.
2. quotes
3. Nelson
4. true
5. true
6. true
7. AKIAIOSFODNN7EXAMPLE
8. 2006-03-01T12:00:00.183Z
9. Iuyz3d3P0aTou39dzbqaEXAMPLE=
10.
```
`Sample Response`
```
1.
2.
3.
4. 200
5. OK
6.
7.
8. Content-Type
9. text/plain
10.
11.
12. family
13. Muntz
14.
15. aGEtaGE=
16. 2006-01-01T12:00:00.000Z
17. "828ef3fdfa96f00ad9f27c383fc9ac7f"
18.
19.
```
## Elementi
+ `Bucket:`Il bucket da cui recuperare l'oggetto.
+ `Key:`La chiave che identifica l'oggetto.
+ `GetMetadata:`I metadati vengono restituiti con l'oggetto se ciò è vero.
+ `GetData:`I dati dell'oggetto vengono restituiti se questo è vero.
+ `InlineData:`Se questo è vero, i dati vengono restituiti, con codifica in base 64, come parte del corpo SOAP della risposta. Se false, i dati vengono restituiti come allegato SOAP. L' InlineData opzione non è adatta all'uso con oggetti di grandi dimensioni. Il sistema limita questa operazione a lavorare con 1 MB di dati o meno. Una GetObject richiesta con il InlineData flag impostato avrà esito negativo con il codice di `InlineDataTooLargeError` stato se il parametro Data risultante è stato codificato per più di 1 MB. Per scaricare oggetti di grandi dimensioni, valuta la possibilità di chiamare GetObject senza impostare il InlineData flag o di utilizzare invece l'API REST.
## Elementi restituiti
+ `Metadata:`I metadati associati nome-valore memorizzati con l'oggetto.
+ `Data:`Se InlineData era vero nella richiesta, contiene i dati dell'oggetto codificati in base 64.
+ `LastModified:`L'ora in cui l'oggetto è stato archiviato in Amazon S3.
+ `ETag:`Il tag di entità dell'oggetto. Si tratta di un hash dell'oggetto che può essere utilizzato per eseguire risultati condizionali. L'ETag riflette solo le modifiche al contenuto di un oggetto, non i suoi metadati.
## Controllo degli accessi
Puoi leggere un oggetto solo se ti è stato concesso `READ` l'accesso all'oggetto.
## Download SOAP suddivisi in blocchi e ripristinabili
Per offrire `GET` flessibilità, Amazon S3 supporta download in blocchi e ripristinabili.
Seleziona tra le seguenti opzioni:
+ Per i download di oggetti di grandi dimensioni, potresti volerli suddividere in blocchi più piccoli. Per ulteriori informazioni, consulta [Intervallo GET](#SOAPRangeGETs)
+ Per `GET` le operazioni che falliscono, puoi progettare l'applicazione in modo che scarichi il resto anziché l'intero file. Per ulteriori informazioni, consulta [Ripristino degli errori REST GET](#SOAPGETErrorRecovery)
### Intervallo GET
Per alcuni clienti, potresti voler suddividere i download di grandi dimensioni in download più piccoli. Per suddividere un GET in unità più piccole, usa Range.
Prima di poter suddividere un GET in unità più piccole, è necessario determinarne le dimensioni. Ad esempio, la richiesta seguente ottiene la dimensione dell'oggetto bigfile.
```
1.
2. bigbucket
3. bigfile
4. 1
5. AKIAIOSFODNN7EXAMPLE
6. 2006-03-01T12:00:00.183Z
7. Iuyz3d3P0aTou39dzbqaEXAMPLE=
8.
```
Amazon S3 restituisce la seguente risposta.
```
1.
2. quotes
3. N
4. 1
5. false
6.
7. bigfile
8. 2006-01-01T12:00:00.000Z
9. "828ef3fdfa96f00ad9f27c383fc9ac7f"
10. 2023276
11. STANDARD
12.
13. bcaf1ffd86f41161ca5fb16fd081034f
14. bigfile
15.
16.
17.
```
Segue una richiesta che scarica il primo megabyte dall'oggetto bigfile.
```
1.
2. bigbucket
3. bigfile
4. true
5. true
6. true
7. 0
8. 1048576
9. AKIAIOSFODNN7EXAMPLE
10. 2006-03-01T12:00:00.183Z
11. Iuyz3d3P0aTou39dzbqaEXAMPLE=
12.
```
Amazon S3 restituisce il primo megabyte del file e l'Etag del file.
```
1.
2.
3.
4. 200
5. OK
6.
7.
8. Content-Type
9. text/plain
10.
11.
12. family
13. Muntz
14.
15. --first megabyte of bigfile--
16. 2006-01-01T12:00:00.000Z
17. "828ef3fdfa96f00ad9f27c383fc9ac7f"
18.
19.
```
Per assicurarti che il file non sia cambiato dopo il download della parte precedente, specifica l'elemento. IfMatch Sebbene l' IfMatch elemento non sia obbligatorio, è consigliato per contenuti suscettibili di modifiche.
Quella che segue è una richiesta che ottiene il resto del file, utilizzando l'intestazione della IfMatch richiesta.
```
1.
2. bigbucket
3. bigfile
4. true
5. true
6. true
7. 10485761
8. 2023276
9. "828ef3fdfa96f00ad9f27c383fc9ac7f"
10. AKIAIOSFODNN7EXAMPLE
11. 2006-03-01T12:00:00.183Z
12. Iuyz3d3P0aTou39dzbqaEXAMPLE=
13.
```
Amazon S3 restituisce la seguente risposta e il resto del file.
```
1.
2.
3.
4. 200
5. OK
6.
7.
8. Content-Type
9. text/plain
10.
11.
12. family
13. >Muntz
14.
15. --remainder of bigfile--
16. 2006-01-01T12:00:00.000Z
17. "828ef3fdfa96f00ad9f27c383fc9ac7f"
18.
19.
```
### Con versione GetObject
La seguente richiesta restituisce la versione specificata dell'oggetto nel bucket.
```
1.
2. quotes
3. Nelson
4. true
5. true
6. true
7. AKIAIOSFODNN7EXAMPLE
8. 2006-03-01T12:00:00.183Z
9. Iuyz3d3P0aTou39dzbqaEXAMPLE=
10.
```
Risposta di esempio
```
1.
2.
3.
4. 200
5. OK
6.
7.
8. Content-Type
9. text/plain
10.
11.
12. family
13. Muntz
14.
15. aGEtaGE=
16. 2006-01-01T12:00:00.000Z
17. "828ef3fdfa96f00ad9f27c383fc9ac7f"
18.
19.
```
### Ripristino degli errori REST GET
Se un oggetto GET fallisce, puoi recuperare il resto del file specificando l'intervallo da scaricare. A tale scopo, è necessario ottenere la dimensione dell'oggetto utilizzando `ListBucket` ed eseguire un intervallo `GET` sul resto del file. Per ulteriori informazioni, consulta [GetObjectExtended (API SOAP)](SOAPGetObjectExtended.md).
### Risorse correlate
[Operazioni sugli oggetti (API SOAP)](SOAPObjectsOps.md)