Riferimento API per Storage Gateway - AWSStorage Gateway

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à.

Riferimento API per Storage Gateway

Oltre a usare la console, puoi usare l'API di AWS Storage Gateway per configurare e gestire i gateway a livello di programmazione. Questa sezione descrive le operazioni AWS Storage Gateway, la firma delle richieste per l'autenticazione e la gestione degli errori. Per informazioni sulle regioni e sugli endpoint disponibili per Storage Gateway, consultaAWS Storage GatewayEndpoint e quotenellaAWSRiferimenti generali.

Nota

È possibile utilizzare anche l'AWSSDK durante lo sviluppo di applicazioni con Storage Gateway. LaAWSGli SDK per Java, .NET e PHP integrano l'API di Storage Gateway sottostante, semplificando le attività di programmazione. Per ulteriori informazioni sul download delle librerie SDK, consulta Librerie e codice di esempio.

AWS Storage GatewayIntestazioni obbligatorie delle richieste

Questa sezione descrive le intestazioni obbligatorie che devi inviare con ogni richiesta POST aAWS Storage Gateway. Devi includere intestazioni HTTP per identificare le informazioni principali sulla richiesta, tra cui l'operazione che vuoi richiamare, la data della richiesta e le informazioni che indicano la tua autorizzazione come mittente della richiesta. Le intestazioni fanno distinzione tra maiuscole e minuscole, ma l'ordine delle intestazioni non è importante.

L'esempio seguente mostra le intestazioni usate nell'operazione ActivateGateway.

POST / HTTP/1.1 Host: storagegateway.us-east-2.amazonaws.com Content-Type: application/x-amz-json-1.1 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120425/us-east-2/storagegateway/aws4_request, SignedHeaders=content-type;host;x-amz-date;x-amz-target, Signature=9cd5a3584d1d67d57e61f120f35102d6b3649066abdd4bf4bbcf05bd9f2f8fe2 x-amz-date: 20120912T120000Z x-amz-target: StorageGateway_20120630.ActivateGateway

Le intestazioni seguenti devono essere incluse con le richieste POST diAWS Storage Gateway. Le intestazioni mostrate di seguito che iniziano con «x-amz» sonoAWSintestazioni specifiche. Tutte le altre intestazioni elencate sono intestazioni comuni usate in transazioni HTTP.

Intestazione Descrizione
Authorization

L'intestazione di autorizzazione contiene diverse informazioni sulla richiesta che consentonoAWS Storage Gatewayper determinare se la richiesta è un'operazione valida per il richiedente. Il formato di questa intestazione è il seguente (con l'aggiunta di interruzioni di riga ai fini della leggibilità):

Authorization: AWS4-HMAC_SHA456 Credentials=YourAccessKey/yyymmdd/region/storagegateway/aws4_request, SignedHeaders=content-type;host;x-amz-date;x-amz-target, Signature=CalculatedSignature

Nella sintassi precedente abbiamo specificato YourAccessKey, l'anno, il mese e il giorno (yyyymmdd), la regione e CalculatedSignature. Il formato dell'intestazione di autorizzazione è determinato dai requisiti dellaAWSProcesso di firma V4. I dettagli sulla firma vengono approfonditi nell'argomento Firmare le richieste.

Content-Type

Utilizzaapplication/x-amz-json-1.1come tipo di contenuto per tutte le richieste aAWS Storage Gateway.

Content-Type: application/x-amz-json-1.1
Host

Utilizzare l'intestazione host per specificare l'AWS Storage Gatewayendpoint in cui invii la richiesta. Ad esempio:storagegateway.us-east-2.amazonaws.comè l'endpoint della regione Stati Uniti orientali (Ohio). Per ulteriori informazioni sugli endpoint disponibili perAWS Storage Gateway, consultaAWS Storage GatewayEndpoint e quotenellaAWSRiferimenti generali.

Host: storagegateway.region.amazonaws.com
x-amz-date

È necessario fornire il timestamp nell'intestazione HTTP Date o nell'intestazione AWS x-amz-date. (Alcune librerie client HTTP non consentono di impostare l'intestazione Date) Quando unx-amz-dateintestazione è presente, ilAWS Storage Gatewayignore qualsiasiDateintestazione durante l'autenticazione della richiesta. x-amz-date deve avere il formato di base ISO8601, ovvero AAAAMMGG'T'HHMMSS'Z'. Se le intestazioni Date e x-amz-date vengono usate entrambe, il formato dell'intestazione Date non deve essere ISO8601.

x-amz-date: YYYYMMDD'T'HHMMSS'Z'
x-amz-target

Questa intestazione specifica la versione dell'API e l'operazione richiesta. I valori dell'intestazione target sono formati concatenando la versione API con il nome API e usano il formato seguente.

x-amz-target: StorageGateway_APIversion.operationName

Il valore di operationName, ad esempio "ActivateGateway", è disponibile nell'elenco delle API, Riferimento API per Storage Gateway.

Firmare le richieste

Storage Gateway richiede l'autenticazione con firma di ogni richiesta inviata. Per firmare una richiesta, devi calcolare una firma digitale utilizzando una funzione hash crittografica. Una funzione hash crittografica è una funzione che restituisce un valore hash univoco basato sull'input. L'input alla funzione hash include il testo della richiesta e la tua Secret Access Key. La funzione hash restituisce un valore hash che includi nella richiesta come firma. La firma è parte dell'intestazione Authorization della richiesta.

Dopo aver ricevuto la richiesta, Storage Gateway ricalcola la firma utilizzando la stessa funzione hash e lo stesso input utilizzati per firmare la richiesta. Se la firma risultante corrisponde alla firma nella richiesta, Storage Gateway elabora la richiesta. In caso contrario, la richiesta viene respinta.

Storage Gateway supporta l'autenticazione conAWSSignature Version 4. La procedura per il calcolo di una firma può essere suddivisa in tre fasi:

  • Task 1: Creazione di una richiesta canonica

    Riorganizza la richiesta HTTP in un formato canonico. L'utilizzo di un formato canonico è necessario in quanto Storage Gateway utilizza lo stesso formato quando ricalcola una firma da confrontare con quella che hai inviato.

  • Task 2: Creazione di una stringa di firma

    Crea una stringa che utilizzerai come uno dei valori di input per la funzione hash crittografica. La stringa, denominata stringa di firma, è una concatenazione del nome dell'algoritmo hash, della data della richiesta, di una stringa di ambito credenziali e della richiesta in formato canonico creata nella fase precedente. La stringa di ambito credenziali è anch'essa una concatenazione di data, regione e informazioni sul servizio.

  • Task 3: Creazione di una firma

    Crea una firma per la tua richiesta utilizzando una funzione hash crittografica che accetta due stringhe di input: la tua stringa di firma e una chiave derivata. La chiave derivata viene calcolata a partire dalla chiave di accesso segreta e utilizzando la stringa di ambito credenziali per creare una serie di codici di autenticazione dei messaggi basati su hash (HMAC).

Esempio di calcolo di firma

L'esempio in questa sezione mostra come creare una firma per ListGateways. L'esempio può essere utilizzato come riferimento per verificare il metodo di calcolo della firma. Altri calcoli di riferimento sono descritti in Suite di test Signature Version 4 nel glossario di Amazon Web Services.

L'esempio presuppone quanto segue:

  • Il timestamp della richiesta è "Mon, 10 Sep 2012 00:00:00" GMT.

  • L'endpoint è la regione Stati Uniti orientali (Ohio).

La sintassi generale della richiesta (incluso il corpo JSON) è:

POST / HTTP/1.1 Host: storagegateway.us-east-2.amazonaws.com x-amz-Date: 20120910T000000Z Authorization: SignatureToBeCalculated Content-type: application/x-amz-json-1.1 x-amz-target: StorageGateway_20120630.ListGateways {}

Il formato canonico della richiesta calcolata per è:

POST / content-type:application/x-amz-json-1.1 host:storagegateway.us-east-2.amazonaws.com x-amz-date:20120910T000000Z x-amz-target:StorageGateway_20120630.ListGateways content-type;host;x-amz-date;x-amz-target 44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a

L'ultima riga della richiesta canonica è l'hash del corpo della richiesta. Nota inoltre la terza riga vuota nella richiesta canonica. Ciò è dovuto alla mancanza di parametri di query per questa API (o qualsiasi API Storage Gateway).

La stringa di firma per è:

AWS4-HMAC-SHA256 20120910T000000Z 20120910/us-east-2/storagegateway/aws4_request 92c0effa6f9224ac752ca179a04cecbede3038b0959666a8160ab452c9e51b3e

La prima riga della stringa di firma è l'algoritmo, la seconda è il timestamp, la terza è l'ambito credenziali e l'ultima è un hash del formato della richiesta canonica in Fase 1.

Per , la chiave derivata può essere rappresentata come segue:

derived key = HMAC(HMAC(HMAC(HMAC("AWS4" + YourSecretAccessKey,"20120910"),"us-east-2"),"storagegateway"),"aws4_request")

Se viene utilizzata la chiave di accesso segreta, wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY, la firma calcolata è:

6d4c40b8f2257534dbdca9f326f147a0a7a419b63aff349d9d9c737c9a0f4c81

La fase finale consiste nel creare l'intestazione Authorization. Per la chiave di accesso AKIAIOSFODN7EXAMPLE, l'intestazione (con interruzioni di riga aggiunte per facilitare la lettura) è:

Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120910/us-east-2/storagegateway/aws4_request, SignedHeaders=content-type;host;x-amz-date;x-amz-target, Signature=6d4c40b8f2257534dbdca9f326f147a0a7a419b63aff349d9d9c737c9a0f4c81

Risposte agli errori

Questa sezione fornisce informazioni di riferimento sugli errori di AWS Storage Gateway. Questi errori sono rappresentati da un'eccezione di errore e da un codice di errore dell'operazione. L'eccezione di errore InvalidSignatureException, ad esempio, viene restituita da qualsiasi risposta API in caso di problema con la firma della richiesta. Tuttavia, il codice di errore dell'operazione ActivationKeyInvalid viene restituito solo per l'API ActivateGateway.

A seconda del tipo di errore, Storage Gateway può restituire solo un'eccezione, oppure sia un'eccezione che un codice di errore dell'operazione. In Risposte agli errori vengono forniti esempi di risposte di errore.

Eccezioni

La tabella seguente elenca le eccezioni dell'API di AWS Storage Gateway. Quando un'operazione di AWS Storage Gateway restituisce una risposta di errore, il corpo della risposta contiene una di queste eccezioni. InternalServerError e InvalidGatewayRequestException restituiscono uno dei messaggi Codici di errore delle operazioni dei codici di errore delle operazioni che forniscono il codice di errore dell'operazione specifico.

Eccezione Messaggio Codice di stato HTTP
IncompleteSignatureException La firma specificata non è completa. 400 Richiesta non valida
InternalFailure L'elaborazione della richiesta non è riuscita a causa di un errore, un'eccezione o un guasto sconosciuto. 500 - Errore interno del server
InternalServerError Uno dei messaggi dei codici di errore delle operazioni in Codici di errore delle operazioni. 500 - Errore interno del server
InvalidAction L'azione o operazione richiesta non è valida. 400 Richiesta non valida
InvalidClientTokenId Il certificato X.509 oAWSL'ID chiave di accesso fornito non esiste nei nostri record. 403 Non consentito
InvalidGatewayRequestException Uno dei messaggi dei codici di errore delle operazioni in Codici di errore delle operazioni. 400 Richiesta non valida
InvalidSignatureException La firma di richiesta che abbiamo calcolato non corrisponde alla firma che hai fornito. Verifica la tuaAWSChiave di accesso e metodo di firma. 400 Richiesta non valida
MissingAction Nella richiesta manca un parametro di un'azione o un'operazione. 400 Richiesta non valida
MissingAuthenticationToken La richiesta deve contenere una valida (registrata)AWSID chiave di accesso o certificato X.509. 403 Non consentito
RequestExpired La richiesta ha superato la data di scadenza o la data della richiesta (con margine di 15 minuti) oppure la data della richiesta è oltre 15 minuti nel futuro. 400 Richiesta non valida
SerializationException Si è verificato un errore durante la serializzazione. Controllare che il formato del payload JSON sia corretto. 400 Richiesta non valida
ServiceUnavailable La richiesta non è riuscita a causa di un errore temporaneo del server. 503 Service Unavailable (503 Servizio non disponibile)
SubscriptionRequiredException LaAWSAccess Key Id necessita di una sottoscrizione per il servizio. 400 Richiesta non valida
ThrottlingException Velocità superata. 400 Richiesta non valida
UnknownOperationException È stata specificata un'operazione sconosciuta. Le operazioni valide sono elencate in Operazioni in Storage Gateway. 400 Richiesta non valida
UnrecognizedClientException Il token di sicurezza incluso nella richiesta non è valido. 400 Richiesta non valida
ValidationException Il valore di un parametro di input è errato o non compreso nell'intervallo. 400 Richiesta non valida

Codici di errore delle operazioni

La tabella seguente mostra la mappatura tra i codici di errore delle operazioni di AWS Storage Gateway e le API che possono restituire i codici. Tutti i codici di errore delle operazioni vengono restituiti con una delle due eccezioni generali InternalServerError e InvalidGatewayRequestException descritte in Eccezioni.

Codice di errore dell'operazione Messaggio Operazioni che restituiscono questo codice di errore
ActivationKeyExpired La chiave di attivazione specificata è scaduta. ActivateGateway
ActivationKeyInvalid La chiave di attivazione specificata non è valida. ActivateGateway
ActivationKeyNotFound La chiave di attivazione specificata non è stata trovata. ActivateGateway
BandwidthThrottleScheduleNotFound La limitazione di larghezza di banda specificata non è stata trovata. DeleteBandwidthRateLimit
CannotExportSnapshot Lo snapshot specificato non può essere esportato.

CreateCachediSCSIVolume

CreateStorediSCSIVolume

InitiatorNotFound L'iniziatore specificato non è stato trovato. DeleteChapCredentials
DiskAlreadyAllocated Il disco specificato è già allocato.

AddCache

AddUploadBuffer

AddWorkingStorage

CreateStorediSCSIVolume

DiskDoesNotExist Il disco specificato non esiste.

AddCache

AddUploadBuffer

AddWorkingStorage

CreateStorediSCSIVolume

DiskSizeNotGigAligned Il disco specificato non è allineato ai gigabyte.

CreateStorediSCSIVolume

DiskSizeGreaterThanVolumeMaxSize La dimensione del disco specificata è superiore alla dimensione massima del volume. CreateStorediSCSIVolume
DiskSizeLessThanVolumeSize La dimensione del disco specificata è inferiore alla dimensione del volume. CreateStorediSCSIVolume
DuplicateCertificateInfo Le informazioni sul certificato specificate sono duplicate. ActivateGateway
Conflitto di configurazione endpoint associazione file system

La configurazione dell'endpoint esistente dell'associazione file system è in conflitto con la configurazione specificata.

File system associato
Indirizzo di punta per l'associazione di file system già in uso

L'indirizzo IP dell'endpoint specificato è già in uso.

File system associato
Indirizzo IP del punto finale dell'associazione file system mancante

L'indirizzo IP dell'endpoint dell'associazione file system è mancante.

File system associato
Associazione file system non trovata

L'associazione del file system specificata non è stata trovata.

Aggiorna l'associazione file system

Dissociate file system

Descrivi le associazioni di file system

File system non trovato

Il file system specificato non è stato trovato.

File system associato
GatewayInternalError Si è verificato un errore interno del gateway.

AddCache

AddUploadBuffer

AddWorkingStorage

CreateCachediSCSIVolume

CreateSnapshot

CreateStorediSCSIVolume

CreateSnapshotFromVolumeRecoveryPoint

DeleteBandwidthRateLimit

DeleteChapCredentials

DeleteVolume

DescribeBandwidthRateLimit

DescribeCache

DescribeCachediSCSIVolumes

DescribeChapCredentials

DescribeGatewayInformation

DescribeMaintenanceStartTime

DescribeSnapshotSchedule

DescribeStorediSCSIVolumes

DescribeWorkingStorage

ListLocalDisks

ListVolumes

ListVolumeRecoveryPoints

ShutdownGateway

StartGateway

UpdateBandwidthRateLimit

UpdateChapCredentials

UpdateMaintenanceStartTime

UpdateGatewaySoftwareNow

UpdateSnapshotSchedule

GatewayNotConnected Il gateway specificato non è connesso.

AddCache

AddUploadBuffer

AddWorkingStorage

CreateCachediSCSIVolume

CreateSnapshot

CreateStorediSCSIVolume

CreateSnapshotFromVolumeRecoveryPoint

DeleteBandwidthRateLimit

DeleteChapCredentials

DeleteVolume

DescribeBandwidthRateLimit

DescribeCache

DescribeCachediSCSIVolumes

DescribeChapCredentials

DescribeGatewayInformation

DescribeMaintenanceStartTime

DescribeSnapshotSchedule

DescribeStorediSCSIVolumes

DescribeWorkingStorage

ListLocalDisks

ListVolumes

ListVolumeRecoveryPoints

ShutdownGateway

StartGateway

UpdateBandwidthRateLimit

UpdateChapCredentials

UpdateMaintenanceStartTime

UpdateGatewaySoftwareNow

UpdateSnapshotSchedule

GatewayNotFound Il gateway specificato non è stato trovato.

AddCache

AddUploadBuffer

AddWorkingStorage

CreateCachediSCSIVolume

CreateSnapshot

CreateSnapshotFromVolumeRecoveryPoint

CreateStorediSCSIVolume

DeleteBandwidthRateLimit

DeleteChapCredentials

DeleteGateway

DeleteVolume

DescribeBandwidthRateLimit

DescribeCache

DescribeCachediSCSIVolumes

DescribeChapCredentials

DescribeGatewayInformation

DescribeMaintenanceStartTime

DescribeSnapshotSchedule

DescribeStorediSCSIVolumes

DescribeWorkingStorage

ListLocalDisks

ListVolumes

ListVolumeRecoveryPoints

ShutdownGateway

StartGateway

UpdateBandwidthRateLimit

UpdateChapCredentials

UpdateMaintenanceStartTime

UpdateGatewaySoftwareNow

UpdateSnapshotSchedule

GatewayProxyNetworkConnectionBusy La connessione di rete proxy gateway specificata è occupata.

AddCache

AddUploadBuffer

AddWorkingStorage

CreateCachediSCSIVolume

CreateSnapshot

CreateSnapshotFromVolumeRecoveryPoint

CreateStorediSCSIVolume

DeleteBandwidthRateLimit

DeleteChapCredentials

DeleteVolume

DescribeBandwidthRateLimit

DescribeCache

DescribeCachediSCSIVolumes

DescribeChapCredentials

DescribeGatewayInformation

DescribeMaintenanceStartTime

DescribeSnapshotSchedule

DescribeStorediSCSIVolumes

DescribeWorkingStorage

ListLocalDisks

ListVolumes

ListVolumeRecoveryPoints

ShutdownGateway

StartGateway

UpdateBandwidthRateLimit

UpdateChapCredentials

UpdateMaintenanceStartTime

UpdateGatewaySoftwareNow

UpdateSnapshotSchedule

InternalError Si è verificato un errore interno.

ActivateGateway

AddCache

AddUploadBuffer

AddWorkingStorage

CreateCachediSCSIVolume

CreateSnapshot

CreateSnapshotFromVolumeRecoveryPoint

CreateStorediSCSIVolume

DeleteBandwidthRateLimit

DeleteChapCredentials

DeleteGateway

DeleteVolume

DescribeBandwidthRateLimit

DescribeCache

DescribeCachediSCSIVolumes

DescribeChapCredentials

DescribeGatewayInformation

DescribeMaintenanceStartTime

DescribeSnapshotSchedule

DescribeStorediSCSIVolumes

DescribeWorkingStorage

ListLocalDisks

ListGateways

ListVolumes

ListVolumeRecoveryPoints

ShutdownGateway

StartGateway

UpdateBandwidthRateLimit

UpdateChapCredentials

UpdateMaintenanceStartTime

UpdateGatewayInformation

UpdateGatewaySoftwareNow

UpdateSnapshotSchedule

InvalidParameters La richiesta specificata contiene parametri non validi.

ActivateGateway

AddCache

AddUploadBuffer

AddWorkingStorage

CreateCachediSCSIVolume

CreateSnapshot

CreateSnapshotFromVolumeRecoveryPoint

CreateStorediSCSIVolume

DeleteBandwidthRateLimit

DeleteChapCredentials

DeleteGateway

DeleteVolume

DescribeBandwidthRateLimit

DescribeCache

DescribeCachediSCSIVolumes

DescribeChapCredentials

DescribeGatewayInformation

DescribeMaintenanceStartTime

DescribeSnapshotSchedule

DescribeStorediSCSIVolumes

DescribeWorkingStorage

ListLocalDisks

ListGateways

ListVolumes

ListVolumeRecoveryPoints

ShutdownGateway

StartGateway

UpdateBandwidthRateLimit

UpdateChapCredentials

UpdateMaintenanceStartTime

UpdateGatewayInformation

UpdateGatewaySoftwareNow

UpdateSnapshotSchedule

LocalStorageLimitExceeded Il limite di storage locale è stato superato.

AddCache

AddUploadBuffer

AddWorkingStorage

LunInvalid Il LUN specificato non è valido. CreateStorediSCSIVolume
MaximumVolumeCountExceeded Il numero massimo di volumi è stato superato.

CreateCachediSCSIVolume

CreateStorediSCSIVolume

DescribeCachediSCSIVolumes

DescribeStorediSCSIVolumes

NetworkConfigurationChanged La configurazione di rete del gateway è stata modificata.

CreateCachediSCSIVolume

CreateStorediSCSIVolume

NotSupported L'operazione specificata non è supportata.

ActivateGateway

AddCache

AddUploadBuffer

AddWorkingStorage

CreateCachediSCSIVolume

CreateSnapshot

CreateSnapshotFromVolumeRecoveryPoint

CreateStorediSCSIVolume

DeleteBandwidthRateLimit

DeleteChapCredentials

DeleteGateway

DeleteVolume

DescribeBandwidthRateLimit

DescribeCache

DescribeCachediSCSIVolumes

DescribeChapCredentials

DescribeGatewayInformation

DescribeMaintenanceStartTime

DescribeSnapshotSchedule

DescribeStorediSCSIVolumes

DescribeWorkingStorage

ListLocalDisks

ListGateways

ListVolumes

ListVolumeRecoveryPoints

ShutdownGateway

StartGateway

UpdateBandwidthRateLimit

UpdateChapCredentials

UpdateMaintenanceStartTime

UpdateGatewayInformation

UpdateGatewaySoftwareNow

UpdateSnapshotSchedule

OutdatedGateway Il gateway specificato non è aggiornato. ActivateGateway
SnapshotInProgressException Lo snapshot specificato è in corso. DeleteVolume
SnapshotIdInvalid Lo snapshot specificato non è valido.

CreateCachediSCSIVolume

CreateStorediSCSIVolume

StagingAreaFull L'area di gestione temporanea è piena.

CreateCachediSCSIVolume

CreateStorediSCSIVolume

TargetAlreadyExists La destinazione specificata esiste già.

CreateCachediSCSIVolume

CreateStorediSCSIVolume

TargetInvalid La destinazione specificata non è valida.

CreateCachediSCSIVolume

CreateStorediSCSIVolume

DeleteChapCredentials

DescribeChapCredentials

UpdateChapCredentials

TargetNotFound La destinazione specificata non è stata trovata.

CreateCachediSCSIVolume

CreateStorediSCSIVolume

DeleteChapCredentials

DescribeChapCredentials

DeleteVolume

UpdateChapCredentials

UnsupportedOperationForGatewayType L'operazione specificata non è valida per il tipo di gateway.

AddCache

AddWorkingStorage

CreateCachediSCSIVolume

CreateSnapshotFromVolumeRecoveryPoint

CreateStorediSCSIVolume

DeleteSnapshotSchedule

DescribeCache

DescribeCachediSCSIVolumes

DescribeStorediSCSIVolumes

DescribeUploadBuffer

DescribeWorkingStorage

ListVolumeRecoveryPoints

VolumeAlreadyExists Il volume specificato esiste già.

CreateCachediSCSIVolume

CreateStorediSCSIVolume

VolumeIdInvalid Il volume specificato non è valido. DeleteVolume
VolumeInUse Il volume specificato è già in uso. DeleteVolume
VolumeNotFound Il volume specificato non è stato trovato.

CreateSnapshot

CreateSnapshotFromVolumeRecoveryPoint

DeleteVolume

DescribeCachediSCSIVolumes

DescribeSnapshotSchedule

DescribeStorediSCSIVolumes

UpdateSnapshotSchedule

VolumeNotReady Il volume specificato non è pronto.

CreateSnapshot

CreateSnapshotFromVolumeRecoveryPoint

Risposte agli errori

Quando si verifica un errore, le informazioni dell'intestazione della risposta contengono:

  • Content-Type: application/x-amz-json-1.1

  • Un codice di stato HTTP 4xx o 5xx appropriato

Il corpo di una risposta di errore contiene informazioni relative all'errore. La risposta di errore di esempio seguente mostra la sintassi di output degli elementi della risposta comuni a tutte le risposte di errore.

{ "__type": "String", "message": "String", "error": { "errorCode": "String", "errorDetails": "String" } }

La tabella seguente illustra i campi della risposta di errore JSON mostrata nella sintassi precedente.

__type

Una delle eccezioni elencate in Eccezioni.

Type: Stringa

error

Contiene dettagli dell'errore specifici dell'API. Negli errori generali, ovvero non specifici di un'API, queste informazioni sull'errore non vengono visualizzate.

Type: Raccolta

errorCode

Uno dei codici di errore delle operazioni .

Type: Stringa

errorDetails

Questo campo non viene usato nella versione corrente dell'API.

Type: Stringa

message

Uno dei messaggi dei codici di errore delle operazioni in .

Type: Stringa

Esempi di risposta di errore

Il seguente corpo JSON viene restituito se si utilizza l'API DescribeStorediSCSIVolumes e si specifica un input di richiesta ARN del gateway che non esiste.

{ "__type": "InvalidGatewayRequestException", "message": "The specified volume was not found.", "error": { "errorCode": "VolumeNotFound" } }

Il corpo JSON seguente viene restituito se Storage Gateway calcola una firma che non corrisponde alla firma inviata con una richiesta.

{   "__type": "InvalidSignatureException",   "message": "The request signature we calculated does not match the signature you provided." }

Operazioni in Storage Gateway

Per un elenco delle operazioni di Storage Gateway, consultaOperazioninellaAWS Storage GatewayDocumentazione di riferimento API.