APIRiferimento per Storage Gateway

Oltre a utilizzare la console, è possibile utilizzarla per configurare e AWS Storage Gateway API gestire i gateway in modo programmatico. Questa sezione descrive AWS Storage Gateway le operazioni, la richiesta di firma per l'autenticazione e la gestione degli errori. Per ulteriori informazioni sulle regioni e sugli endpoint disponibili per Storage Gateway, consulta Endpoint e quote AWS Storage Gateway nella Riferimenti generali di AWS.

Nota

È inoltre possibile utilizzare AWS SDKs il per sviluppare applicazioni con AWS Storage Gateway. Il AWS SDKs per Java,. NETe PHP racchiude le informazioni sottostanti AWS Storage Gateway API, semplificando le attività di programmazione. Per informazioni sul download delle SDK librerie, vedete Sample Code Libraries.

Argomenti

• Intestazioni obbligatorie delle richieste in Storage Gateway

• Firmare le richieste

• Risposte agli errori

• Azioni

Intestazioni obbligatorie delle richieste in Storage Gateway

Questa sezione descrive le intestazioni richieste da inviare con ogni POST richiesta a Storage Gateway. Sono incluse HTTP intestazioni per identificare le informazioni chiave sulla richiesta, tra cui l'operazione che si desidera richiamare, la data della richiesta e le informazioni che indicano l'autorizzazione dell'utente 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 utilizzate 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

Di seguito sono riportate le intestazioni da includere nelle POST richieste a Storage Gateway. Le intestazioni mostrate di seguito che iniziano con «x-amz» sono intestazioni specifiche. AWS Tutte le altre intestazioni elencate sono intestazioni comuni utilizzate nelle transazioni. HTTP

Header	Descrizione
Authorization	L'intestazione di autorizzazione contiene diverse informazioni sulla richiesta, che permettono a Storage Gateway di 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, si specificano l'anno YourAccessKey, il mese e il giorno (aaaammgg), la regione e il. CalculatedSignature Il formato dell'intestazione di autorizzazione è dettato dai requisiti del processo di firma V4. AWS I dettagli sulla firma vengono approfonditi nell'argomento Firmare le richieste.
Content-Type	Usa application/x-amz-json-1.1 come tipo di contenuto per tutte le richieste a Storage Gateway. Content-Type: application/x-amz-json-1.1
Host	Usa l'intestazione host per specificare l'endpoint Storage Gateway in cui invii la richiesta. Ad esempio, storagegateway.us-east-2.amazonaws.com è l’endpoint per la regione Stati Uniti orientali (Ohio). Per ulteriori informazioni sugli endpoint disponibili per Storage Gateway, consulta Endpoint e quote AWS Storage Gateway nella Riferimenti generali di AWS. Host: storagegateway.region.amazonaws.com
x-amz-date	È necessario fornire il timestamp nell'intestazione o nell'HTTPDateintestazione. AWS x-amz-date (Alcune librerie HTTP client non consentono di impostare l'Dateintestazione.) Quando è presente un'intestazione x-amz-date, Storage Gateway ignora qualsiasi intestazione Date durante l'autenticazione della richiesta. Il x-amz-date formato deve essere ISO86 01 Basic nel formato YYYYMMDD 'T' HHMMSS 'Z'. Se vengono utilizzati Date sia l'x-amz-dateintestazione che l'intestazione, il formato dell'intestazione Date non deve essere ISO86 01. x-amz-date: YYYYMMDD'T'HHMMSS'Z'
x-amz-target	Questa intestazione specifica la versione API e l'operazione richiesta. I valori di intestazione di destinazione sono formati concatenando la API versione con il API nome e sono nel seguente formato. x-amz-target: StorageGateway_APIversion.operationName Il operationNamevalore (ad esempio "ActivateGateway«) può essere trovato dall'elenco,. API APIRiferimento per Storage Gateway

Firmare le richieste

Storage Gateway richiede l'autenticazione con firma di ogni richiesta inviata. Per firmare una richiesta, è necessario 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 chiave di accesso segreta. 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 con AWS Signature Version 4. La procedura per il calcolo di una firma può essere suddivisa in tre fasi:

• Fase 1. Creazione di una richiesta canonica

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

• Fase 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.

• Fase 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 partendo dalla chiave di accesso segreta e utilizzando la stringa Credential Scope per creare una serie di codici di autenticazione dei messaggi basati su Hash (). HMACs

Esempio di calcolo di firma

L'esempio seguente illustra i dettagli della creazione di 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 è «Lun, 10 settembre 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. Questo perché non esistono parametri di interrogazione per questo API (o per alcun Storage GatewayAPIs).

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, wJalr XUtnFEMI /K7MDENG/bPxRfiCYEXAMPLEKEY, la firma calcolata è:

6d4c40b8f2257534dbdca9f326f147a0a7a419b63aff349d9d9c737c9a0f4c81

La fase finale consiste nel creare l'intestazione Authorization. Per la chiave di accesso dimostrativaAKIAIOSFODNN7EXAMPLE, l'intestazione (con interruzioni di riga aggiunte per motivi di leggibilità) è:

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. AWS Storage Gateway Questi errori sono rappresentati da un'eccezione di errore e da un codice di errore dell'operazione. Ad esempio, l'eccezione di errore InvalidSignatureException viene restituita da qualsiasi API risposta in caso di problemi con la firma della richiesta. Tuttavia, il codice di errore dell'operazione ActivationKeyInvalid viene restituito solo per ActivateGatewayAPI.

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

Nella tabella seguente sono elencate le AWS Storage Gateway API eccezioni. Quando un' AWS Storage Gateway operazione 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	HTTPCodice di stato
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 l'operazione richiesta non è valida.	400 Richiesta non valida
InvalidClientTokenId	Il certificato X.509 o AWS l'ID della chiave di accesso fornito non esiste nei nostri archivi.	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. Controlla la tua chiave di AWS accesso e il 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 un ID chiave di AWS accesso valido (registrato) o un 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. Verifica che il tuo JSON payload sia ben formato.	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	L' AWS Access Key Id richiede un abbonamento per il servizio.	400 Richiesta non valida
ThrottlingException	Velocità superata.	400 Richiesta non valida
TooManyRequests	Troppe richieste.	429 Troppe richieste
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 AWS Storage Gateway operativi e APIs che può 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
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 corretti.	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 valore specificato non LUN è corretto.	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:

• Tipo di contenuto: application/ -1.1 x-amz-json

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

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 JSON di risposta agli errori mostrati nella sintassi precedente.

__type

Una delle eccezioni elencate in Eccezioni.

▬Tipo: stringa

error

Contiene dettagli API sull'errore specifici. In caso di errori generali (ossia non specificiAPI), queste informazioni sull'errore non vengono visualizzate.

Tipo: raccolta

errorCode

Uno dei codici di errore delle operazioni .

▬Tipo: stringa

errorDetails

Questo campo non è utilizzato nella versione corrente diAPI.

▬Tipo: stringa

message

Uno dei messaggi dei codici di errore delle operazioni.

▬Tipo: stringa

Esempi di risposta di errore

Il seguente JSON corpo viene restituito se si utilizza DescribeStoredi SCSIVolumes API e si specifica un input di ARN richiesta gateway che non esiste.

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

Il seguente JSON corpo 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 dello Storage Gateway, vedere Azioni nel AWS Storage Gateway APIriferimento.