# REST Resource: locations.global.metricsScopes

- [Resource: MetricsScope](https://docs.cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes#MetricsScope)
  - [JSON representation](https://docs.cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes#MetricsScope.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes#METHODS_SUMMARY)

## Resource: MetricsScope

Represents a [Metrics Scope](https://cloud.google.com/monitoring/settings#concept-scope) in Cloud Monitoring, which specifies one or more Google projects and zero or more AWS accounts to monitor together.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "monitoredProjects": [ { object (`https://docs.cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes.projects#MonitoredProject`) } ] } ``` |

| Fields ||
|---|---|
| `name` | `string` Immutable. The resource name of the Monitoring Metrics Scope. On input, the resource name can be specified with the scoping project ID or number. On output, the resource name is specified with the scoping project number. Example: `locations/global/metricsScopes/{SCOPING_PROJECT_ID_OR_NUMBER}` |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when this `Metrics Scope` was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when this `Metrics Scope` record was last updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `monitoredProjects[]` | ``object (`https://docs.cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes.projects#MonitoredProject`)`` Output only. The list of projects monitored by this `Metrics Scope`. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes/get` | Returns a specific `Metrics Scope`, including the list of projects monitored by the specified `Metrics Scope`. |
| ### `https://docs.cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes/listMetricsScopesByMonitoredProject` | Returns a list of every `Metrics Scope` that a specific `MonitoredProject` has been added to. |