DescribeStorageSystemResourceMetrics - AWS DataSync
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanContohLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

DescribeStorageSystemResourceMetrics

Mengembalikan informasi, termasuk data kinerja dan penggunaan kapasitas, yang dikumpulkan DataSync Discovery tentang sumber daya tertentu dalam sistem penyimpanan tempat Anda.

Sintaksis Permintaan

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

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam JSON format.

DiscoveryJobArn

Menentukan Nama Sumber Daya Amazon (ARN) dari pekerjaan pencarian yang mengumpulkan informasi tentang sistem penyimpanan lokal Anda.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: ^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}$

Wajib: Ya

EndTime

Menentukan waktu dalam total durasi pekerjaan penemuan dijalankan. Untuk melihat informasi yang dikumpulkan selama jangka waktu tertentu, gunakan parameter ini denganStartTime.

Tipe: Timestamp

Wajib: Tidak

MaxResults

Menentukan berapa banyak hasil yang Anda inginkan dalam respon.

Jenis: Integer

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 100.

Wajib: Tidak

NextToken

Menentukan string buram yang menunjukkan posisi untuk memulai daftar berikutnya dari hasil dalam respon.

Tipe: String

Batasan Panjang: Panjang maksimum 65535.

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

Wajib: Tidak

ResourceId

Menentukan identifier (UUID) unik universal dari sumber daya sistem penyimpanan yang Anda inginkan informasi tentang.

Tipe: String

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

Wajib: Ya

ResourceType

Menentukan jenis sumber daya sistem penyimpanan yang Anda inginkan informasi tentang.

Tipe: String

Nilai yang Valid: SVM | VOLUME | CLUSTER

Wajib: Ya

StartTime

Menentukan waktu dalam total durasi pekerjaan penemuan dijalankan. Untuk melihat informasi yang dikumpulkan selama jangka waktu tertentu, gunakan parameter ini denganEndTime.

Tipe: Timestamp

Wajib: Tidak

Sintaksis Respons

{
   "Metrics": [ 
      { 
         "Capacity": { 
            "ClusterCloudStorageUsed": number,
            "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"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

Metrics

Detail yang dikumpulkan oleh pekerjaan penemuan Anda tentang sumber daya sistem penyimpanan Anda.

Tipe: Array objek ResourceMetrics

NextToken

String buram yang menunjukkan posisi untuk memulai daftar hasil berikutnya dalam respons.

Tipe: String

Batasan Panjang: Panjang maksimum 65535.

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

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InternalException

Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync .

HTTPKode Status: 500

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

HTTPKode Status: 400

Contoh

Permintaan Sampel

Contoh berikut meminta informasi tentang volume dalam sistem penyimpanan lokal.

{
    "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"
}

Contoh Respons

Contoh respons berikut mencakup informasi kinerja dan kapasitas tentang 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"
        }
    ]
}

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: