Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Powerscale Provider
  3. API Docs
  4. S3ZoneSettings
powerscale 1.7.1 published on Wednesday, Apr 30, 2025 by dell
dell/terraform-provider-powerscale

powerscale.S3ZoneSettings

Explore with Pulumi AI

powerscale logo
powerscale 1.7.1 published on Wednesday, Apr 30, 2025 by dell
dell/terraform-provider-powerscale

    This resource is used to manage the S3 Zone Settings entity of the PowerScale Array. PowerScale S3 Zone Setting map to access zone configuration which provide default location for creating s3 buckets. We can Create, Update and Delete the S3 Zone Setting using this resource. We can also import an existing S3 Zone Settings from PowerScale array.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as powerscale from "@pulumi/powerscale";

// PowerScale S3 Zone settings allows you to configure S3 Zone settings on PowerScale.
const s3ZoneSetting = new powerscale.S3ZoneSettings("s3ZoneSetting", {
    baseDomain: "dell.com",
    bucketDirectoryCreateMode: 511,
    objectAclPolicy: "deny",
    rootPath: "/ifs/",
    zone: "tfacc-test",
});

    import pulumi
import pulumi_powerscale as powerscale

# PowerScale S3 Zone settings allows you to configure S3 Zone settings on PowerScale.
s3_zone_setting = powerscale.S3ZoneSettings("s3ZoneSetting",
    base_domain="dell.com",
    bucket_directory_create_mode=511,
    object_acl_policy="deny",
    root_path="/ifs/",
    zone="tfacc-test")

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/powerscale/powerscale"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// PowerScale S3 Zone settings allows you to configure S3 Zone settings on PowerScale.
		_, err := powerscale.NewS3ZoneSettings(ctx, "s3ZoneSetting", &powerscale.S3ZoneSettingsArgs{
			BaseDomain:                pulumi.String("dell.com"),
			BucketDirectoryCreateMode: pulumi.Float64(511),
			ObjectAclPolicy:           pulumi.String("deny"),
			RootPath:                  pulumi.String("/ifs/"),
			Zone:                      pulumi.String("tfacc-test"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Powerscale = Pulumi.Powerscale;

return await Deployment.RunAsync(() => 
{
    // PowerScale S3 Zone settings allows you to configure S3 Zone settings on PowerScale.
    var s3ZoneSetting = new Powerscale.S3ZoneSettings("s3ZoneSetting", new()
    {
        BaseDomain = "dell.com",
        BucketDirectoryCreateMode = 511,
        ObjectAclPolicy = "deny",
        RootPath = "/ifs/",
        Zone = "tfacc-test",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.powerscale.S3ZoneSettings;
import com.pulumi.powerscale.S3ZoneSettingsArgs;
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) {
        // PowerScale S3 Zone settings allows you to configure S3 Zone settings on PowerScale.
        var s3ZoneSetting = new S3ZoneSettings("s3ZoneSetting", S3ZoneSettingsArgs.builder()
            .baseDomain("dell.com")
            .bucketDirectoryCreateMode(511)
            .objectAclPolicy("deny")
            .rootPath("/ifs/")
            .zone("tfacc-test")
            .build());

    }
}

    resources:
  # PowerScale S3 Zone settings allows you to configure S3 Zone settings on PowerScale.
  s3ZoneSetting:
    type: powerscale:S3ZoneSettings
    properties:
      baseDomain: dell.com
      bucketDirectoryCreateMode: 511
      objectAclPolicy: deny
      # replace or deny
      rootPath: /ifs/
      zone: tfacc-test

    Create S3ZoneSettings Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new S3ZoneSettings(name: string, args: S3ZoneSettingsArgs, opts?: CustomResourceOptions);
    @overload
def S3ZoneSettings(resource_name: str,
                   args: S3ZoneSettingsArgs,
                   opts: Optional[ResourceOptions] = None)

@overload
def S3ZoneSettings(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   zone: Optional[str] = None,
                   base_domain: Optional[str] = None,
                   bucket_directory_create_mode: Optional[float] = None,
                   object_acl_policy: Optional[str] = None,
                   root_path: Optional[str] = None)
    func NewS3ZoneSettings(ctx *Context, name string, args S3ZoneSettingsArgs, opts ...ResourceOption) (*S3ZoneSettings, error)
    public S3ZoneSettings(string name, S3ZoneSettingsArgs args, CustomResourceOptions? opts = null)
    public S3ZoneSettings(String name, S3ZoneSettingsArgs args)
public S3ZoneSettings(String name, S3ZoneSettingsArgs args, CustomResourceOptions options)

    type: powerscale:S3ZoneSettings
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args S3ZoneSettingsArgs
    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 S3ZoneSettingsArgs
    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 S3ZoneSettingsArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args S3ZoneSettingsArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args S3ZoneSettingsArgs
    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 s3zoneSettingsResource = new Powerscale.S3ZoneSettings("s3zoneSettingsResource", new()
{
    Zone = "string",
    BaseDomain = "string",
    BucketDirectoryCreateMode = 0,
    ObjectAclPolicy = "string",
    RootPath = "string",
});

    example, err := powerscale.NewS3ZoneSettings(ctx, "s3zoneSettingsResource", &powerscale.S3ZoneSettingsArgs{
	Zone:                      pulumi.String("string"),
	BaseDomain:                pulumi.String("string"),
	BucketDirectoryCreateMode: pulumi.Float64(0),
	ObjectAclPolicy:           pulumi.String("string"),
	RootPath:                  pulumi.String("string"),
})

    var s3zoneSettingsResource = new S3ZoneSettings("s3zoneSettingsResource", S3ZoneSettingsArgs.builder()
    .zone("string")
    .baseDomain("string")
    .bucketDirectoryCreateMode(0)
    .objectAclPolicy("string")
    .rootPath("string")
    .build());

    s3zone_settings_resource = powerscale.S3ZoneSettings("s3zoneSettingsResource",
    zone="string",
    base_domain="string",
    bucket_directory_create_mode=0,
    object_acl_policy="string",
    root_path="string")

    const s3zoneSettingsResource = new powerscale.S3ZoneSettings("s3zoneSettingsResource", {
    zone: "string",
    baseDomain: "string",
    bucketDirectoryCreateMode: 0,
    objectAclPolicy: "string",
    rootPath: "string",
});

    type: powerscale:S3ZoneSettings
properties:
    baseDomain: string
    bucketDirectoryCreateMode: 0
    objectAclPolicy: string
    rootPath: string
    zone: string

    S3ZoneSettings 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 S3ZoneSettings resource accepts the following input properties:

    Zone string
    BaseDomain string
    Base Domain for S3 zone
    BucketDirectoryCreateMode double
    The permission mode for creating bucket directories.
    ObjectAclPolicy string
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    RootPath string
    The root path for the S3 bucket.
    Zone string
    BaseDomain string
    Base Domain for S3 zone
    BucketDirectoryCreateMode float64
    The permission mode for creating bucket directories.
    ObjectAclPolicy string
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    RootPath string
    The root path for the S3 bucket.
    zone String
    baseDomain String
    Base Domain for S3 zone
    bucketDirectoryCreateMode Double
    The permission mode for creating bucket directories.
    objectAclPolicy String
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    rootPath String
    The root path for the S3 bucket.
    zone string
    baseDomain string
    Base Domain for S3 zone
    bucketDirectoryCreateMode number
    The permission mode for creating bucket directories.
    objectAclPolicy string
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    rootPath string
    The root path for the S3 bucket.
    zone str
    base_domain str
    Base Domain for S3 zone
    bucket_directory_create_mode float
    The permission mode for creating bucket directories.
    object_acl_policy str
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    root_path str
    The root path for the S3 bucket.
    zone String
    baseDomain String
    Base Domain for S3 zone
    bucketDirectoryCreateMode Number
    The permission mode for creating bucket directories.
    objectAclPolicy String
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    rootPath String
    The root path for the S3 bucket.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the S3ZoneSettings resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing S3ZoneSettings Resource

    Get an existing S3ZoneSettings 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?: S3ZoneSettingsState, opts?: CustomResourceOptions): S3ZoneSettings
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        base_domain: Optional[str] = None,
        bucket_directory_create_mode: Optional[float] = None,
        object_acl_policy: Optional[str] = None,
        root_path: Optional[str] = None,
        zone: Optional[str] = None) -> S3ZoneSettings
    func GetS3ZoneSettings(ctx *Context, name string, id IDInput, state *S3ZoneSettingsState, opts ...ResourceOption) (*S3ZoneSettings, error)
    public static S3ZoneSettings Get(string name, Input<string> id, S3ZoneSettingsState? state, CustomResourceOptions? opts = null)
    public static S3ZoneSettings get(String name, Output<String> id, S3ZoneSettingsState state, CustomResourceOptions options)
    resources:  _:    type: powerscale:S3ZoneSettings    get:      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.
    The following state arguments are supported:
    BaseDomain string
    Base Domain for S3 zone
    BucketDirectoryCreateMode double
    The permission mode for creating bucket directories.
    ObjectAclPolicy string
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    RootPath string
    The root path for the S3 bucket.
    Zone string
    BaseDomain string
    Base Domain for S3 zone
    BucketDirectoryCreateMode float64
    The permission mode for creating bucket directories.
    ObjectAclPolicy string
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    RootPath string
    The root path for the S3 bucket.
    Zone string
    baseDomain String
    Base Domain for S3 zone
    bucketDirectoryCreateMode Double
    The permission mode for creating bucket directories.
    objectAclPolicy String
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    rootPath String
    The root path for the S3 bucket.
    zone String
    baseDomain string
    Base Domain for S3 zone
    bucketDirectoryCreateMode number
    The permission mode for creating bucket directories.
    objectAclPolicy string
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    rootPath string
    The root path for the S3 bucket.
    zone string
    base_domain str
    Base Domain for S3 zone
    bucket_directory_create_mode float
    The permission mode for creating bucket directories.
    object_acl_policy str
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    root_path str
    The root path for the S3 bucket.
    zone str
    baseDomain String
    Base Domain for S3 zone
    bucketDirectoryCreateMode Number
    The permission mode for creating bucket directories.
    objectAclPolicy String
    The default policy for object access control lists (ACLs), which can be either replace or deny.
    rootPath String
    The root path for the S3 bucket.
    zone String

    Import

    Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.

    Licensed under the Mozilla Public License Version 2.0 (the “License”);

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

    http://mozilla.org/MPL/2.0/

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an “AS IS” BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.

    S3 Zone Settings can be imported by the name of the S3 Zone

    The command is

    $ pulumi import powerscale:index/s3ZoneSettings:S3ZoneSettings s3_zone_settings_example <S3 zone name>

    $ pulumi import powerscale:index/s3ZoneSettings:S3ZoneSettings s3_zone_settings_example "System"

    after running this command, populate the zone field and other required parameters in the config file to start managing this resource.

    Note: running “terraform show” after importing shows the current config/state of the resource. You can copy/paste that config to make it easier to manage the resource.

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    powerscale dell/terraform-provider-powerscale
    License
    Notes
    This Pulumi package is based on the powerscale Terraform Provider.
    powerscale logo
    powerscale 1.7.1 published on Wednesday, Apr 30, 2025 by dell
    dell/terraform-provider-powerscale