---
title: "POST /v1alpha/{+parent}/ipamAdminScopes"
method: POST
path: "/v1alpha/{+parent}/ipamAdminScopes"
tags: ["projects"]
---

# POST /v1alpha/{+parent}/ipamAdminScopes

`POST /v1alpha/{+parent}/ipamAdminScopes`

Creates a new IpamAdminScope in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `ipamAdminScopeId` string
- `requestId` string

## Request body

- IpamAdminScope — An IpamAdminScope defines the administrative boundary for IP address discovery and management. It configures which platforms and organizational scopes are enabled for IP tracking.
  - `createTime` string, google-datetime — Output only. The time at which the IpamAdminScope was created.
  - `name` string — Required. Identifier. The resource name of the IpamAdminScope.
  - `scopes` string[] — Required. Administrative scopes enabled for IP address discovery and management. For example, "organizations/1234567890". Minimum of 1 scope is required. In preview, only one organization scope is allowed.
  - `enabledAddonPlatforms` string[] — Required. Add-on platforms that are enabled for this IpamAdminScope. Cloud Number Registry only discovers the IP addresses from the enabled platforms.
  - `updateTime` string, google-datetime — Output only. The time at which the IpamAdminScope was last updated.
  - `state` 'DISCOVERY_PIPELINE_STATE_UNSPECIFIED' | 'INTERNAL_FAILURE' | 'FAILED' | 'SETUP_IN_PROGRESS' | 'READY_FOR_USE' | 'DELETING_IN_PROGRESS' | 'UPDATING' | 'RECOVERING' | 'DISABLED' | 'DELETION_COMPLETED' | 'CLEANUP_IN_PROGRESS' | 'READY_FOR_DELETION' — Output only. State of resource discovery pipeline.
  - `labels` object — Optional. User-defined labels.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/cloudnumberregistry.md) · [All operations](https://skmtc.dev/google/apis/cloudnumberregistry/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/cloudnumberregistry/revisions/19ff6b3b34e9/schema)