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

# POST /v2/{+parent}/nfsShares

`POST /v2/{+parent}/nfsShares`

Create an NFS share.

## Path parameters

- `parent` string, required

## Request body

- NfsShare — An NFS share.
  - `requestedSizeGib` string, int64 — The requested size, in GiB.
  - `allowedClients` AllowedClient[] — List of allowed access points.
    - `allowSuid` boolean — Allow the setuid flag.
    - `allowDev` boolean — Allow dev flag. Which controls whether to allow creation of devices.
    - `shareIp` string — Output only. The IP address of the share on this network. Assigned automatically during provisioning based on the network's services_cidr.
    - `nfsPath` string — Output only. The path to access NFS, in format shareIP:/InstanceID InstanceID is the generated ID instead of customer provided name. example like "10.0.0.0:/g123456789-nfs001"
    - `network` string — The network the access point sits on.
    - `noRootSquash` boolean — Disable root squashing, which is a feature of NFS. Root squash is a special mapping of the remote superuser (root) identity when using identity authentication.
    - `allowedClientsCidr` string — The subnet of IP addresses permitted to access the share.
    - `mountPermissions` 'MOUNT_PERMISSIONS_UNSPECIFIED' | 'READ' | 'READ_WRITE' — Mount permissions.
  - `storageType` 'STORAGE_TYPE_UNSPECIFIED' | 'SSD' | 'HDD' — Immutable. The storage type of the underlying volume.
  - `state` 'STATE_UNSPECIFIED' | 'PROVISIONED' | 'CREATING' | 'UPDATING' | 'DELETING' — Output only. The state of the NFS share.
  - `name` string — Immutable. The name of the NFS share.
  - `labels` object — Labels as key value pairs.
  - `nfsShareId` string — Output only. An identifier for the NFS share, generated by the backend. This field will be deprecated in the future, use `id` instead.
  - `volume` string — Output only. The underlying volume of the share. Created automatically during provisioning.
  - `pod` string — Immutable. Pod name. Pod is an independent part of infrastructure. NFSShare can only be connected to the assets (networks, instances) allocated in the same pod.
  - `id` string — Output only. An identifier for the NFS share, generated by the backend. This is the same value as nfs_share_id and will replace it in the future.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/baremetalsolution.md) · [All operations](https://skmtc.net/google/apis/baremetalsolution/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/baremetalsolution/versions/7c6ae0857ec6/schema)