DescribeStorageSystemResourceMetrics - AWS DataSync
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriEsempiVedi anche

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

DescribeStorageSystemResourceMetrics

Restituisce informazioni, inclusi i dati sulle prestazioni e l'utilizzo della capacità, che DataSync Discovery raccoglie su una risorsa specifica nel sistema di storage locale.

Sintassi della richiesta

{
   "DiscoveryJobArn": "string",
   "EndTime": number,
   "MaxResults": number,
   "NextToken": "string",
   "ResourceId": "string",
   "ResourceType": "string",
   "StartTime": number
}

Parametri della richiesta

Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

DiscoveryJobArn

Il nome della risorsa Amazon (ARN) del processo di processo di processo di processo che raccoglie informazioni sul sistema di processo di processo di processo in cui raccogliere informazioni sul sistema di storage in locale.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 256.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Campo obbligatorio: sì

EndTime

Specifica un intervallo di tempo compreso nella durata totale dell'esecuzione del processo di rilevamento. Per visualizzare le informazioni raccolte durante un determinato periodo di tempo, usa questo parametro conStartTime.

Tipo: Timestamp

Required: No

MaxResults

Specifica il numero di risultati che desideri nella risposta.

Tipo: integer

Intervallo valido: valore minimo di 1. valore massimo pari a 100.

Required: No

NextToken

Specifica una stringa opaca che indica la posizione in cui iniziare il successivo elenco di risultati nella risposta.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 65535.

Modello: [a-zA-Z0-9=_-]+

Required: No

ResourceId

Specifica l'identificatore univoco universale (UUID) della risorsa del sistema di storage su cui si desidera ottenere informazioni.

Tipo: stringa

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Campo obbligatorio: sì

ResourceType

Specifica il tipo di risorsa del sistema di storage su cui si desidera ottenere informazioni.

Tipo: String

Valori validi: SVM | VOLUME | CLUSTER

Campo obbligatorio: sì

StartTime

Specifica un intervallo di tempo compreso nella durata totale dell'esecuzione del processo di rilevamento. Per visualizzare le informazioni raccolte durante un determinato periodo di tempo, usa questo parametro conEndTime.

Tipo: Timestamp

Required: No

Sintassi della risposta

{
   "Metrics": [ 
      { 
         "Capacity": { 
            "LogicalUsed": number,
            "Provisioned": number,
            "Used": number
         },
         "P95Metrics": { 
            "IOPS": { 
               "Other": number,
               "Read": number,
               "Total": number,
               "Write": number
            },
            "Latency": { 
               "Other": number,
               "Read": number,
               "Write": number
            },
            "Throughput": { 
               "Other": number,
               "Read": number,
               "Total": number,
               "Write": number
            }
         },
         "ResourceId": "string",
         "ResourceType": "string",
         "Timestamp": number
      }
   ],
   "NextToken": "string"
}

Elementi di risposta

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

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

Metrics

I dettagli raccolti dal processo di rilevamento sulla risorsa del sistema di storage.

Tipo: matrice di oggetti ResourceMetrics

NextToken

La stringa opaca che indica la posizione in cui iniziare il successivo elenco di risultati nella risposta.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 65535.

Pattern: [a-zA-Z0-9=_-]+

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InternalException

Questa eccezione viene generata quando si verifica un errore nel AWS DataSync servizio.

Codice di stato HTTP: 500

InvalidRequestException

Questa eccezione viene generata quando il client invia una richiesta non valida.

Codice di stato HTTP: 400

Esempi

Richiesta di esempio

L'esempio seguente richiede informazioni su un volume in un sistema di storage locale.

{
    "DiscoveryJobArn": "arn:aws:datasync:us-east-1:123456789012:system/storage-system-abcdef01234567890/job/discovery-job-12345678-90ab-cdef-0abc-021345abcdef6",
    "ResourceType": "VOLUME",
    "ResourceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Risposta di esempio

La risposta di esempio seguente include informazioni sulle prestazioni e sulla capacità del volume.

{
    "Metrics": [
        {
            "Timestamp": "2023-01-10T13:54:11-05:00",
            "P95Metrics": {
                "IOPS": {
                    "Read": 251.0,
                    "Write": 44.0,
                    "Other": 17.0,
                    "Total": 345.0
                },
                "Throughput": {
                    "Read": 2.06,
                    "Write": 0.88,
                    "Other": 0.11,
                    "Total": 2.17
                },
                "Latency": {
                    "Read": 0.06,
                    "Write": 0.07,
                    "Other": 0.13
                }
            },
            "Capacity": {
                "Used": 409600,
                "Provisioned": 1099511627776
            },
            "ResourceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "ResourceType": "VOLUME"
        }
    ]
}

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: