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

# GetSeries
<a name="CloudWatch-PromQL-API-GetSeries"></a>

`GetSeries`Operasi mengembalikan daftar deret waktu yang labelnya cocok dengan satu atau lebih pemilih.

Kata kerja HTTP yang valid  
`GET`, `POST`

URI yang valid  
`/api/v1/series`

URL permintaan lengkap menggabungkan host CloudWatch pemantauan untuk AWS Wilayah dengan jalur operasi, misalnya`https://monitoring.{{AWS Region}}.amazonaws.com/api/v1/series`. Untuk informasi tentang titik akhir, penandatanganan, dan izin IAM yang diperlukan, lihat. [Kueri PromQL](CloudWatch-PromQL-Querying.md)

## Parameter kueri URL
<a name="CloudWatch-PromQL-API-GetSeries-Parameters"></a>

Parameter berikut diteruskan dalam string kueri URL untuk `GET` permintaan, atau sebagai bidang isi yang dikodekan formulir untuk permintaan. `POST`


| Parameter | Deskripsi | 
| --- | --- | 
| `match[]` | Wajib. Pemilih seri yang menyaring deret waktu untuk kembali. Setiap pemilih harus menyertakan pencocokan persis (`=`) pada nama metrik — misalnya, `{"http.server.active_requests"}` atau`{__name__="http.server.active_requests"}`. Selector tanpa metric-name equal matcher tidak didukung. Selain kecocokan persis, pencocokan label juga mendukung not equal (`!=`), regex match (), dan negative regex match (`=~`). `!~` Tentukan `match[]` satu kali atau lebih untuk menggabungkan penyeleksi. Untuk informasi selengkapnya tentang sintaks pemilih, lihat. [Kueri PromQL](CloudWatch-PromQL-Querying.md) | 
| `start` | Wajib. Mulai dari rentang waktu untuk dipertimbangkan, sebagai stempel waktu RFC 3339 atau stempel waktu Unix. | 
| `end` | Wajib. Akhir rentang waktu yang perlu dipertimbangkan, sebagai stempel waktu RFC 3339 atau stempel waktu Unix. | 
| `limit` | Tidak wajib. Jumlah maksimum deret waktu unik untuk dikembalikan, dari `1` ke`10000`. Jika Anda tidak menentukan`limit`, CloudWatch mengembalikan hingga maksimum (10.000). Lihat [Batas hasil](#CloudWatch-PromQL-API-GetSeries-Limits). | 

## Izin IAM yang diperlukan
<a name="CloudWatch-PromQL-API-GetSeries-IAM"></a>

Untuk menelepon`GetSeries`, identitas panggilan harus memiliki tindakan IAM berikut:
+ `cloudwatch:ListMetrics`

Untuk pemetaan tindakan IAM lengkap untuk semua operasi PromQL, lihat. [Izin IAM untuk PromQL](CloudWatch-PromQL.md#CloudWatch-PromQL-IAM)

## Batas hasil
<a name="CloudWatch-PromQL-API-GetSeries-Limits"></a>

Satu `/api/v1/series` respons dapat mengembalikan hingga **10.000 deret waktu unik**. Untuk meminta hasil yang lebih sedikit, berikan `limit` parameter dengan nilai dari `1` ke`10000`. Jika Anda tidak menentukan`limit`, CloudWatch kembali hingga maksimum.

Ketika seri yang cocok melebihi batas, respons terpotong dan pesan disertakan dalam bidang Prometheus standar. `warnings` Kode status HTTP tetap ada`200`.

Untuk daftar lengkap batas PromQL, termasuk TPS, konkurensi, dan jendela pemindaian 24 jam, lihat. [Batas dan batasan PromQL](CloudWatch-PromQL.md#CloudWatch-PromQL-Limits)

## Permintaan sampel
<a name="CloudWatch-PromQL-API-GetSeries-Sample"></a>

`POST`Permintaan berikut menggunakan pemilih kecocokan persis. Pemilih,`start`, dan diteruskan sebagai bidang `end` yang dikodekan formulir di badan permintaan. Karakter khusus seperti`{`,, `}``"`, dan `,` dikodekan persen. `match[]`Nilai decoded adalah. `{"http.server.active_requests","@resource.service.name"="myservice"}`

```
POST /api/v1/series HTTP/1.1
Host: monitoring.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
Authorization: AUTHPARAMS
X-Amz-Date: 20260605T193725Z
User-Agent: awscurl/0.36

match%5B%5D=%7B%22http.server.active_requests%22%2C%22%40resource.service.name%22%3D%22myservice%22%7D&start=1780662000&end=1780665600
```

`POST`Permintaan berikut menggunakan pemilih kecocokan regex. `match[]`Nilai decoded adalah. `{"http.server.active_requests","@aws.region"=~"us-.*"}`

```
POST /api/v1/series HTTP/1.1
Host: monitoring.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
Authorization: AUTHPARAMS
X-Amz-Date: 20260605T193725Z
User-Agent: awscurl/0.36

match%5B%5D=%7B%22http.server.active_requests%22%2C%22%40aws.region%22%3D~%22us-.*%22%7D&start=1780662000&end=1780665600
```

Panggilan yang sama dengan`awscurl`:

```
awscurl --service monitoring --region us-east-1 \
    -X POST 'https://monitoring.us-east-1.amazonaws.com/api/v1/series' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'match[]={"http.server.active_requests","@aws.region"=~"us-.*"}&start=1780662000&end=1780665600'
```

## Respons sampel
<a name="CloudWatch-PromQL-API-GetSeries-Response"></a>

Respons yang berhasil menggunakan amplop Prometheus JSON standar. `data`Bidang ini adalah array peta label, satu per seri yang cocok.

```
HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Type: application/json

{
    "status": "success",
    "data": [
        {
            "__name__": "http.server.active_requests",
            "@resource.service.name": "myservice",
            "@aws.region": "us-east-1"
        },
        {
            "__name__": "http.server.active_requests",
            "@resource.service.name": "myservice",
            "@aws.region": "us-west-2"
        }
    ]
}
```