All Products
Search
Document Center

E-MapReduce:ListDoctorComputeSummary

Last Updated:Jun 11, 2026

Mengambil informasi tentang Penggunaan sumber daya berdasarkan tipe Sumber daya di kluster pada E-MapReduce (EMR) Doctor.

Deskripsi operasi

list Doctor analysis result of cluster engine queue view

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

emr:ListDoctorComputeSummary

list

*All Resource

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID wilayah.

cn-hangzhou

ClusterId

string

Yes

ID kluster.

c-b933c5aac8fe****

NextToken

string

No

Token paginasi yang digunakan di permintaan untuk mengambil halaman hasil baru.

DD6B1B2A-5837-5237-ABE4-FF0C89568980

MaxResults

integer

No

Jumlah maksimum entri yang dikembalikan pada setiap halaman.

20

DateTime

string

Yes

Tentukan tanggal dalam standar ISO 8601. Misalnya, 2023-01-01 mewakili 1 Januari 2023.

2023-01-01

ComponentTypes

array

No

Tipe Sumber daya yang digunakan untuk memfilter hasil kueri. Nilai valid:

  • engine: memfilter hasil berdasarkan engine.

  • queue: memfilter hasil berdasarkan Antrian.

  • cluster: menampilkan hasil di tingkat kluster.

Jika Anda tidak menentukan parameter ini, informasi di tingkat kluster akan ditampilkan secara default. Saat ini, hanya satu tipe Sumber daya yang didukung. Jika Anda menentukan beberapa tipe Sumber daya, tipe Sumber daya pertama akan digunakan secara default.

null

string

No

The resource type.

queue

OrderType

string

No

Pesanan pengurutan hasil kueri yang diinginkan. Nilai valid:

  • ASC: urutan menaik.

  • DESC: urutan menurun.

ASC

OrderBy

string

No

Dasar pengurutan hasil kueri yang diinginkan. Nilai valid:

  1. vcoreSeconds: total konsumsi CPU selama pengatur waktu dalam detik.

  2. memSeconds: total konsumsi memori selama pengatur waktu dalam detik.

  3. vcoreUtilization: utilisasi CPU rata-rata. Maknanya sama dengan parameter %CPU pada keluaran perintah top di Linux.

  4. memUtilization: penggunaan memori rata-rata.

  5. vcoreSecondsDayGrowthRatio: laju pertumbuhan harian dari total konsumsi CPU selama pengatur waktu dalam detik.

  6. memSecondsDayGrowthRatio: laju pertumbuhan harian dari total konsumsi memori selama pengatur waktu dalam detik.

  7. readSize: total jumlah data yang dibaca dari sistem file.

  8. writeSize: total jumlah data yang ditulis ke sistem file.

  9. healthyJobCount: total jumlah job yang sehat.

  10. subHealthyJobCount: total jumlah job yang kurang sehat.

  11. unhealthyJobCount: total jumlah job yang tidak sehat.

  12. needAttentionJobCount: total jumlah job yang memerlukan perhatian.

  13. score: skor untuk job.

  14. scoreDayGrowthRatio: laju pertumbuhan harian dari skor untuk job.

score

Elemen respons

Element

Type

Description

Example

object

The response parameters.

Data

array<object>

The details of resource usage.

array<object>

ComponentName

string

The name of the resource whose details are obtained based on the value of ComponentTypes. For example, if the value of ComponentTypes is Queue, the value of this parameter is a queue, such as DW.

DW

Metrics

object

The metric information.

VcoreSeconds

object

The total CPU consumption over time in seconds.

Name

string

The name of the metric.

vcoreSeconds

Value

integer

The value of the metric.

1231412

Unit

string

The unit of the metric.

VCores * Sec

Description

string

The description of the metric.

Total vcore usage over time in seconds

MemSeconds

object

The total memory consumption over time in seconds.

Name

string

The name of the metric.

memSeconds

Value

integer

The value of the metric.

12312312

Unit

string

The unit of the metric.

MB * Sec

Description

string

The description of the metric.

Total memory usage over time in seconds

VcoreUtilization

object

The average CPU utilization. The meaning is the same as the %CPU parameter in the output of the top command in Linux.

Name

string

The name of the metric.

vcoreUtilization

Value

number

The value of the metric.

32.1

Unit

string

The unit of the metric.

“”

Description

string

The description of the metric.

Ratio of used vcore to total available cores

MemUtilization

object

The average memory usage.

Name

string

The name of the metric.

memUtilization

Value

number

The value of the metric.

0.82

Unit

string

The unit of the metric.

“”

Description

string

The description of the metric.

Ratio of used memory to total available memory

VcoreSecondsDayGrowthRatio

object

The day-to-day growth rate of the total CPU consumption over time in seconds.

Name

string

The name of the metric.

vcoreSecondsDayGrowthRatio

Value

number

The value of the metric.

0.22

Unit

string

The unit of the metric.

“”

Description

string

The description of the metric.

Growth ratio of virtual core usage in seconds per day

MemSecondsDayGrowthRatio

object

The day-to-day growth rate of the total memory consumption over time in seconds.

Name

string

The name of the metric.

memSecondsDayGrowthRatio

Value

number

The value of the metric.

0.36

Unit

string

The unit of the metric.

“”

Description

string

The description of the metric.

Growth ratio of memory usage in seconds per day

ReadSize

object

The total amount of data read from the file system.

Name

string

The name of the metric.

readSize

Value

integer

The value of the metric.

504888659968

Unit

string

The unit of the metric.

MB

Description

string

The description of the metric.

Total cumulative size of data read in megabytes (MB)

WriteSize

object

The total amount of data written to the file system.

Name

string

The name of the metric.

writeSize

Value

integer

The value of the metric.

6294093393920

Unit

string

The unit of the metric.

MB

Description

string

The description of the metric.

Total cumulative size of data written in megabytes (MB)

Analysis

object

The resource analysis results.

HealthyJobCount

integer

The total number of healthy jobs.

3

SubHealthyJobCount

integer

The total number of sub-healthy jobs.

13

UnhealthyJobCount

integer

The total number of unhealthy jobs.

123

NeedAttentionJobCount

integer

The total number of jobs that require attention.

23

Score

integer

The score for jobs.

56

ScoreDayGrowthRatio

number

The day-to-day growth rate of the score for jobs.

0.03

RequestId

string

The request ID.

DD6B1B2A-5837-5237-ABE4-FF0C8944****

NextToken

string

A pagination token.

DD6B1B2A-5837-5237-ABE4-FF0C89568980

MaxResults

integer

The maximum number of entries that are returned.

20

TotalCount

integer

The total number of entries returned.

200

Contoh

Respons sukses

JSONformat

{
  "Data": [
    {
      "ComponentName": "DW",
      "Metrics": {
        "VcoreSeconds": {
          "Name": "vcoreSeconds",
          "Value": 1231412,
          "Unit": "VCores * Sec",
          "Description": "Total vcore usage over time in seconds\n"
        },
        "MemSeconds": {
          "Name": "memSeconds",
          "Value": 12312312,
          "Unit": "MB * Sec",
          "Description": "Total memory usage over time in seconds"
        },
        "VcoreUtilization": {
          "Name": "vcoreUtilization",
          "Value": 32.1,
          "Unit": "“”",
          "Description": "Ratio of used vcore to total available cores\n"
        },
        "MemUtilization": {
          "Name": "memUtilization",
          "Value": 0.82,
          "Unit": "“”",
          "Description": "Ratio of used memory to total available memory\n"
        },
        "VcoreSecondsDayGrowthRatio": {
          "Name": "vcoreSecondsDayGrowthRatio\n",
          "Value": 0.22,
          "Unit": "“”",
          "Description": "Growth ratio of virtual core usage in seconds per day\n"
        },
        "MemSecondsDayGrowthRatio": {
          "Name": "memSecondsDayGrowthRatio",
          "Value": 0.36,
          "Unit": "“”",
          "Description": "Growth ratio of memory usage in seconds per day\n"
        },
        "ReadSize": {
          "Name": "readSize",
          "Value": 504888659968,
          "Unit": "MB",
          "Description": "Total cumulative size of data read in megabytes (MB)\n"
        },
        "WriteSize": {
          "Name": "writeSize\n",
          "Value": 6294093393920,
          "Unit": "MB\n",
          "Description": "Total cumulative size of data written in megabytes (MB)"
        }
      },
      "Analysis": {
        "HealthyJobCount": 3,
        "SubHealthyJobCount": 13,
        "UnhealthyJobCount": 123,
        "NeedAttentionJobCount": 23,
        "Score": 56,
        "ScoreDayGrowthRatio": 0.03
      }
    }
  ],
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "NextToken": "DD6B1B2A-5837-5237-ABE4-FF0C89568980",
  "MaxResults": 20,
  "TotalCount": 200
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 ConflictParameters Parameters that must not be used together. %s
400 IncompleteSignature The request signature is invalid.
400 InvalidAction The action %s requested is invalid.
400 InvalidParameter The specified parameter %s is not valid.
400 InvalidParameterValue The input parameter %s is invalid or out of range.
400 MissingAction The action %s requested is missing.
400 MissingParameter The input parameter %s that is mandatory for processing this request is not supplied.
400 NotAuthorized You do not have permission to perform this action. %s
400 ThrottlingException The request was denied due to request throttling. %s
500 InternalError The request processing has failed due to some unknown error, exception or failure.
404 ResourceNotFound The resource not found by %s.
503 ServiceFailure The request has failed due to a temporary failure of %s service.
503 ServiceUnavailable The request has failed due to a temporary failure of the server.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.