{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"To create a new access point on an NFS share, send a POST request to\n`/v2/nfs/shares/{share_id}/access_points`.\n\nA successful request will return the newly created access point and an action object.\n\nThe parent share must be in `ACTIVE` or `INACTIVE` status. Validation failures and\nprecondition errors (such as an ineligible share state) return `400 Bad Request`.\nDuplicate name or path conflicts return `409 Conflict`.\n","properties":{"path":{"type":"object","properties":{"share_id":{"type":"string","format":"uuid","examples":["baf4827c-6fa9-456f-9dbd-9ddfcacd0720"],"description":"The unique identifier of the NFS share."}},"required":["share_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/access_point_request","examples":[{"name":"other-vpc","path":"/other-vpc","vpc_id":"3f34cdb2-1e4f-4100-b5c7-f55f2762085f","access_policy":{"anonuid":65534,"anongid":65534,"protocols":["NFS4","NFS"],"squash_config":"ROOT_SQUASH","identity_enforcement_enabled":false}}]}},"required":["path","body"],"additionalProperties":false,"definitions":{"access_point_request":{"type":"object","description":"Payload for creating a new access point on a share.","properties":{"name":{"type":"string","description":"The name for the access point. Must be unique per share. Must be 2–63\ncharacters and match `^[a-zA-Z0-9][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$`.\nThe name `default` is reserved (case-insensitive) for the implicit default\naccess point created with each share.\n","examples":["other-vpc"]},"path":{"type":"string","description":"The export sub-path. Must start with `/`, must not be exactly `/` (reserved\nfor the default access point), must be at most 1024 characters, may contain\nonly alphanumerics, `-`, `_`, `.`, and `/`, and must not contain `..` path\nsegments.\n","examples":["/other-vpc"]},"access_policy":{"$ref":"#/definitions/access_policy"},"vpc_id":{"type":"string","description":"Required. The VPC this access point will be pinned to. A storage gateway is\nprovisioned (or reused) in this VPC, and the access point becomes mountable from\nthis VPC regardless of whether the parent share is currently attached to it.\n","examples":["3f34cdb2-1e4f-4100-b5c7-f55f2762085f"]}},"required":["name","path","access_policy","vpc_id"]},"access_policy":{"type":"object","description":"Provider-agnostic NFS access policy for an access point. Network CIDRs are\nmanaged by attach, detach, and managed-access workflows and are not part of\nthis policy.\n","properties":{"anonuid":{"type":"integer","description":"UID used for squashed users. Currently only 65534 is supported.","examples":[65534]},"anongid":{"type":"integer","description":"GID used for squashed users. Currently only 65534 is supported.","examples":[65534]},"protocols":{"type":"array","items":{"type":"string","enum":["NFS4","NFS"]},"description":"Allowed NFS protocols for this export.","examples":[["NFS4","NFS"]]},"squash_config":{"type":"string","enum":["NO_SQUASH","ROOT_SQUASH","ALL_SQUASH"],"description":"The squash mode applied to the access point export.","examples":["ROOT_SQUASH"]},"identity_enforcement_enabled":{"type":"boolean","description":"Whether identity enforcement is enabled for this export.","examples":[false]}},"required":["anonuid","anongid","protocols","squash_config","identity_enforcement_enabled"]}}},"name":"Create an NFS access point","id":"digitalocean.nfs_create_access_point","example":{"path":{"share_id":"baf4827c-6fa9-456f-9dbd-9ddfcacd0720"},"body":{"name":"other-vpc","path":"/other-vpc","access_policy":{"anonuid":65534,"anongid":65534,"protocols":["NFS4","NFS"],"squash_config":"ROOT_SQUASH","identity_enforcement_enabled":false},"vpc_id":"3f34cdb2-1e4f-4100-b5c7-f55f2762085f"}},"maxRequests":1,"summary":false}}