published on Tuesday, Aug 18, 2026 by OVHcloud
published on Tuesday, Aug 18, 2026 by OVHcloud
Creates an access rule (ACL) on a public cloud file storage share, controlling which IP addresses can access it. The region is inherited from the parent share.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as ovh from "@ovhcloud/pulumi-ovh";
const share = new ovh.CloudStorageFileShare("share", {
serviceName: "<Public cloud project id>",
name: "my-share",
size: 150,
region: "GRA1",
protocol: "NFS",
shareType: "STANDARD_1AZ",
});
const acl = new ovh.CloudStorageFileShareAcl("acl", {
serviceName: share.serviceName,
shareId: share.id,
accessTo: "10.0.0.0/24",
accessLevel: "READ_WRITE",
});
import pulumi
import pulumi_ovh as ovh
share = ovh.CloudStorageFileShare("share",
service_name="<Public cloud project id>",
name="my-share",
size=150,
region="GRA1",
protocol="NFS",
share_type="STANDARD_1AZ")
acl = ovh.CloudStorageFileShareAcl("acl",
service_name=share.service_name,
share_id=share.id,
access_to="10.0.0.0/24",
access_level="READ_WRITE")
package main
import (
"github.com/ovh/pulumi-ovh/sdk/v2/go/ovh"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
share, err := ovh.NewCloudStorageFileShare(ctx, "share", &ovh.CloudStorageFileShareArgs{
ServiceName: pulumi.String("<Public cloud project id>"),
Name: pulumi.String("my-share"),
Size: pulumi.Int(150),
Region: pulumi.String("GRA1"),
Protocol: pulumi.String("NFS"),
ShareType: pulumi.String("STANDARD_1AZ"),
})
if err != nil {
return err
}
_, err = ovh.NewCloudStorageFileShareAcl(ctx, "acl", &ovh.CloudStorageFileShareAclArgs{
ServiceName: share.ServiceName,
ShareId: share.ID(),
AccessTo: pulumi.String("10.0.0.0/24"),
AccessLevel: pulumi.String("READ_WRITE"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ovh = Pulumi.Ovh;
return await Deployment.RunAsync(() =>
{
var share = new Ovh.CloudStorageFileShare("share", new()
{
ServiceName = "<Public cloud project id>",
Name = "my-share",
Size = 150,
Region = "GRA1",
Protocol = "NFS",
ShareType = "STANDARD_1AZ",
});
var acl = new Ovh.CloudStorageFileShareAcl("acl", new()
{
ServiceName = share.ServiceName,
ShareId = share.Id,
AccessTo = "10.0.0.0/24",
AccessLevel = "READ_WRITE",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.ovhcloud.pulumi.ovh.CloudStorageFileShare;
import com.ovhcloud.pulumi.ovh.CloudStorageFileShareArgs;
import com.ovhcloud.pulumi.ovh.CloudStorageFileShareAcl;
import com.ovhcloud.pulumi.ovh.CloudStorageFileShareAclArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var share = new CloudStorageFileShare("share", CloudStorageFileShareArgs.builder()
.serviceName("<Public cloud project id>")
.name("my-share")
.size(150)
.region("GRA1")
.protocol("NFS")
.shareType("STANDARD_1AZ")
.build());
var acl = new CloudStorageFileShareAcl("acl", CloudStorageFileShareAclArgs.builder()
.serviceName(share.serviceName())
.shareId(share.id())
.accessTo("10.0.0.0/24")
.accessLevel("READ_WRITE")
.build());
}
}
resources:
share:
type: ovh:CloudStorageFileShare
properties:
serviceName: <Public cloud project id>
name: my-share
size: 150
region: GRA1
protocol: NFS
shareType: STANDARD_1AZ
acl:
type: ovh:CloudStorageFileShareAcl
properties:
serviceName: ${share.serviceName}
shareId: ${share.id}
accessTo: 10.0.0.0/24
accessLevel: READ_WRITE
Example coming soon!
Create CloudStorageFileShareAcl Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new CloudStorageFileShareAcl(name: string, args: CloudStorageFileShareAclArgs, opts?: CustomResourceOptions);@overload
def CloudStorageFileShareAcl(resource_name: str,
args: CloudStorageFileShareAclArgs,
opts: Optional[ResourceOptions] = None)
@overload
def CloudStorageFileShareAcl(resource_name: str,
opts: Optional[ResourceOptions] = None,
access_level: Optional[str] = None,
access_to: Optional[str] = None,
service_name: Optional[str] = None,
share_id: Optional[str] = None)func NewCloudStorageFileShareAcl(ctx *Context, name string, args CloudStorageFileShareAclArgs, opts ...ResourceOption) (*CloudStorageFileShareAcl, error)public CloudStorageFileShareAcl(string name, CloudStorageFileShareAclArgs args, CustomResourceOptions? opts = null)
public CloudStorageFileShareAcl(String name, CloudStorageFileShareAclArgs args)
public CloudStorageFileShareAcl(String name, CloudStorageFileShareAclArgs args, CustomResourceOptions options)
type: ovh:CloudStorageFileShareAcl
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "ovh_cloud_storage_file_share_acl" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args CloudStorageFileShareAclArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args CloudStorageFileShareAclArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args CloudStorageFileShareAclArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args CloudStorageFileShareAclArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args CloudStorageFileShareAclArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var cloudStorageFileShareAclResource = new Ovh.CloudStorageFileShareAcl("cloudStorageFileShareAclResource", new()
{
AccessLevel = "string",
AccessTo = "string",
ServiceName = "string",
ShareId = "string",
});
example, err := ovh.NewCloudStorageFileShareAcl(ctx, "cloudStorageFileShareAclResource", &ovh.CloudStorageFileShareAclArgs{
AccessLevel: pulumi.String("string"),
AccessTo: pulumi.String("string"),
ServiceName: pulumi.String("string"),
ShareId: pulumi.String("string"),
})
resource "ovh_cloud_storage_file_share_acl" "cloudStorageFileShareAclResource" {
lifecycle {
create_before_destroy = true
}
access_level = "string"
access_to = "string"
service_name = "string"
share_id = "string"
}
var cloudStorageFileShareAclResource = new CloudStorageFileShareAcl("cloudStorageFileShareAclResource", CloudStorageFileShareAclArgs.builder()
.accessLevel("string")
.accessTo("string")
.serviceName("string")
.shareId("string")
.build());
cloud_storage_file_share_acl_resource = ovh.CloudStorageFileShareAcl("cloudStorageFileShareAclResource",
access_level="string",
access_to="string",
service_name="string",
share_id="string")
const cloudStorageFileShareAclResource = new ovh.CloudStorageFileShareAcl("cloudStorageFileShareAclResource", {
accessLevel: "string",
accessTo: "string",
serviceName: "string",
shareId: "string",
});
type: ovh:CloudStorageFileShareAcl
properties:
accessLevel: string
accessTo: string
serviceName: string
shareId: string
CloudStorageFileShareAcl Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The CloudStorageFileShareAcl resource accepts the following input properties:
- Access
Level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - Access
To string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- Service
Name string - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- string
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- Access
Level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - Access
To string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- Service
Name string - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- string
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- access_
level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access_
to string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- service_
name string - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- string
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- access
Level String - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access
To String - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- service
Name String - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- String
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- access
Level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access
To string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- service
Name string - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- string
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- access_
level str - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access_
to str - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- service_
name str - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- str
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- access
Level String - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access
To String - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- service
Name String - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- String
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
Outputs
All input properties are implicitly available as output properties. Additionally, the CloudStorageFileShareAcl resource produces the following output properties:
- Checksum string
- Computed hash representing the current target specification value.
- Created
At string - Creation date of the access rule.
- Current
State CloudStorage File Share Acl Current State - Current observed state of the access rule:
- Id string
- The provider-assigned unique ID for this managed resource.
- Resource
Status string - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- Updated
At string - Last update date of the access rule.
- Checksum string
- Computed hash representing the current target specification value.
- Created
At string - Creation date of the access rule.
- Current
State CloudStorage File Share Acl Current State - Current observed state of the access rule:
- Id string
- The provider-assigned unique ID for this managed resource.
- Resource
Status string - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- Updated
At string - Last update date of the access rule.
- checksum string
- Computed hash representing the current target specification value.
- created_
at string - Creation date of the access rule.
- current_
state object - Current observed state of the access rule:
- id string
- The provider-assigned unique ID for this managed resource.
- resource_
status string - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- updated_
at string - Last update date of the access rule.
- checksum String
- Computed hash representing the current target specification value.
- created
At String - Creation date of the access rule.
- current
State CloudStorage File Share Acl Current State - Current observed state of the access rule:
- id String
- The provider-assigned unique ID for this managed resource.
- resource
Status String - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- updated
At String - Last update date of the access rule.
- checksum string
- Computed hash representing the current target specification value.
- created
At string - Creation date of the access rule.
- current
State CloudStorage File Share Acl Current State - Current observed state of the access rule:
- id string
- The provider-assigned unique ID for this managed resource.
- resource
Status string - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- updated
At string - Last update date of the access rule.
- checksum str
- Computed hash representing the current target specification value.
- created_
at str - Creation date of the access rule.
- current_
state CloudStorage File Share Acl Current State - Current observed state of the access rule:
- id str
- The provider-assigned unique ID for this managed resource.
- resource_
status str - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- updated_
at str - Last update date of the access rule.
- checksum String
- Computed hash representing the current target specification value.
- created
At String - Creation date of the access rule.
- current
State Property Map - Current observed state of the access rule:
- id String
- The provider-assigned unique ID for this managed resource.
- resource
Status String - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- updated
At String - Last update date of the access rule.
Look up Existing CloudStorageFileShareAcl Resource
Get an existing CloudStorageFileShareAcl resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: CloudStorageFileShareAclState, opts?: CustomResourceOptions): CloudStorageFileShareAcl@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
access_level: Optional[str] = None,
access_to: Optional[str] = None,
checksum: Optional[str] = None,
created_at: Optional[str] = None,
current_state: Optional[CloudStorageFileShareAclCurrentStateArgs] = None,
resource_status: Optional[str] = None,
service_name: Optional[str] = None,
share_id: Optional[str] = None,
updated_at: Optional[str] = None) -> CloudStorageFileShareAclfunc GetCloudStorageFileShareAcl(ctx *Context, name string, id IDInput, state *CloudStorageFileShareAclState, opts ...ResourceOption) (*CloudStorageFileShareAcl, error)public static CloudStorageFileShareAcl Get(string name, Input<string> id, CloudStorageFileShareAclState? state, CustomResourceOptions? opts = null)public static CloudStorageFileShareAcl get(String name, Output<String> id, CloudStorageFileShareAclState state, CustomResourceOptions options)resources: _: type: ovh:CloudStorageFileShareAcl get: id: ${id}import {
to = ovh_cloud_storage_file_share_acl.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Access
Level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - Access
To string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- Checksum string
- Computed hash representing the current target specification value.
- Created
At string - Creation date of the access rule.
- Current
State CloudStorage File Share Acl Current State - Current observed state of the access rule:
- Resource
Status string - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- Service
Name string - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- string
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- Updated
At string - Last update date of the access rule.
- Access
Level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - Access
To string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- Checksum string
- Computed hash representing the current target specification value.
- Created
At string - Creation date of the access rule.
- Current
State CloudStorage File Share Acl Current State Args - Current observed state of the access rule:
- Resource
Status string - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- Service
Name string - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- string
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- Updated
At string - Last update date of the access rule.
- access_
level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access_
to string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- checksum string
- Computed hash representing the current target specification value.
- created_
at string - Creation date of the access rule.
- current_
state object - Current observed state of the access rule:
- resource_
status string - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- service_
name string - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- string
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- updated_
at string - Last update date of the access rule.
- access
Level String - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access
To String - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- checksum String
- Computed hash representing the current target specification value.
- created
At String - Creation date of the access rule.
- current
State CloudStorage File Share Acl Current State - Current observed state of the access rule:
- resource
Status String - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- service
Name String - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- String
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- updated
At String - Last update date of the access rule.
- access
Level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access
To string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- checksum string
- Computed hash representing the current target specification value.
- created
At string - Creation date of the access rule.
- current
State CloudStorage File Share Acl Current State - Current observed state of the access rule:
- resource
Status string - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- service
Name string - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- string
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- updated
At string - Last update date of the access rule.
- access_
level str - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access_
to str - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- checksum str
- Computed hash representing the current target specification value.
- created_
at str - Creation date of the access rule.
- current_
state CloudStorage File Share Acl Current State Args - Current observed state of the access rule:
- resource_
status str - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- service_
name str - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- str
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- updated_
at str - Last update date of the access rule.
- access
Level String - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access
To String - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- checksum String
- Computed hash representing the current target specification value.
- created
At String - Creation date of the access rule.
- current
State Property Map - Current observed state of the access rule:
- resource
Status String - Access rule readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING)
- service
Name String - Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
- String
- ID of the file storage share the access rule applies to. Changing this value recreates the resource.
- updated
At String - Last update date of the access rule.
Supporting Types
CloudStorageFileShareAclCurrentState, CloudStorageFileShareAclCurrentStateArgs
- Access
Level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - Access
To string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- Created
At string - Creation date of the access rule.
- State string
- Current state of the access rule (
ACTIVE,APPLYING,DENYING,ERROR).
- Access
Level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - Access
To string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- Created
At string - Creation date of the access rule.
- State string
- Current state of the access rule (
ACTIVE,APPLYING,DENYING,ERROR).
- access_
level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access_
to string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- created_
at string - Creation date of the access rule.
- state string
- Current state of the access rule (
ACTIVE,APPLYING,DENYING,ERROR).
- access
Level String - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access
To String - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- created
At String - Creation date of the access rule.
- state String
- Current state of the access rule (
ACTIVE,APPLYING,DENYING,ERROR).
- access
Level string - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access
To string - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- created
At string - Creation date of the access rule.
- state string
- Current state of the access rule (
ACTIVE,APPLYING,DENYING,ERROR).
- access_
level str - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access_
to str - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- created_
at str - Creation date of the access rule.
- state str
- Current state of the access rule (
ACTIVE,APPLYING,DENYING,ERROR).
- access
Level String - Access level granted (
READ_WRITE,READ_ONLY). Changing this value recreates the resource. - access
To String - IP address or CIDR allowed to access the file storage share. Changing this value recreates the resource.
- created
At String - Creation date of the access rule.
- state String
- Current state of the access rule (
ACTIVE,APPLYING,DENYING,ERROR).
Import
A cloud file storage access rule can be imported using the service_name, share_id and acl_id, separated by /:
terraform
import {
to = ovh_cloud_storage_file_share_acl.acl
id = “<service_name>/<share_id>/<acl_id>”
}
bash
$ pulumi import ovh:index/cloudStorageFileShareAcl:CloudStorageFileShareAcl acl service_name/share_id/acl_id
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- ovh ovh/pulumi-ovh
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
ovhTerraform Provider.
published on Tuesday, Aug 18, 2026 by OVHcloud