Alibaba Cloud v3.37.0, May 15 23
Alibaba Cloud v3.37.0, May 15 23
alicloud.alb.Acl
Explore with Pulumi AI
Provides a Application Load Balancer (ALB) Acl resource.
For information about ALB Acl and how to use it, see What is Acl.
NOTE: Available in v1.133.0+.
Example Usage
Basic Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var example = new AliCloud.Alb.Acl("example", new()
{
AclEntries = new[]
{
new AliCloud.Alb.Inputs.AclAclEntryArgs
{
Description = "example_value",
Entry = "10.0.0.0/24",
},
},
AclName = "example_value",
});
});
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/alb"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := alb.NewAcl(ctx, "example", &alb.AclArgs{
AclEntries: alb.AclAclEntryArray{
&alb.AclAclEntryArgs{
Description: pulumi.String("example_value"),
Entry: pulumi.String("10.0.0.0/24"),
},
},
AclName: pulumi.String("example_value"),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.alb.Acl;
import com.pulumi.alicloud.alb.AclArgs;
import com.pulumi.alicloud.alb.inputs.AclAclEntryArgs;
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 example = new Acl("example", AclArgs.builder()
.aclEntries(AclAclEntryArgs.builder()
.description("example_value")
.entry("10.0.0.0/24")
.build())
.aclName("example_value")
.build());
}
}
import pulumi
import pulumi_alicloud as alicloud
example = alicloud.alb.Acl("example",
acl_entries=[alicloud.alb.AclAclEntryArgs(
description="example_value",
entry="10.0.0.0/24",
)],
acl_name="example_value")
import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const example = new alicloud.alb.Acl("example", {
aclEntries: [{
description: "example_value",
entry: "10.0.0.0/24",
}],
aclName: "example_value",
});
resources:
example:
type: alicloud:alb:Acl
properties:
aclEntries:
- description: example_value
entry: 10.0.0.0/24
aclName: example_value
Create Acl Resource
new Acl(name: string, args: AclArgs, opts?: CustomResourceOptions);
@overload
def Acl(resource_name: str,
opts: Optional[ResourceOptions] = None,
acl_entries: Optional[Sequence[AclAclEntryArgs]] = None,
acl_name: Optional[str] = None,
dry_run: Optional[bool] = None,
resource_group_id: Optional[str] = None,
tags: Optional[Mapping[str, Any]] = None)
@overload
def Acl(resource_name: str,
args: AclArgs,
opts: Optional[ResourceOptions] = None)
func NewAcl(ctx *Context, name string, args AclArgs, opts ...ResourceOption) (*Acl, error)
public Acl(string name, AclArgs args, CustomResourceOptions? opts = null)
type: alicloud:alb:Acl
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AclArgs
- 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 AclArgs
- 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 AclArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AclArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AclArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Acl Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Acl resource accepts the following input properties:
- Acl
Name string The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- Acl
Entries List<Pulumi.Ali Cloud. Alb. Inputs. Acl Acl Entry Args> The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- Dry
Run bool Specifies whether to precheck the API request.
- Resource
Group stringId The ID of the resource group.
- Dictionary<string, object>
A mapping of tags to assign to the resource.
- Acl
Name string The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- Acl
Entries []AclAcl Entry Args The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- Dry
Run bool Specifies whether to precheck the API request.
- Resource
Group stringId The ID of the resource group.
- map[string]interface{}
A mapping of tags to assign to the resource.
- acl
Name String The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- acl
Entries List<AclAcl Entry Args> The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- dry
Run Boolean Specifies whether to precheck the API request.
- resource
Group StringId The ID of the resource group.
- Map<String,Object>
A mapping of tags to assign to the resource.
- acl
Name string The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- acl
Entries AclAcl Entry Args[] The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- dry
Run boolean Specifies whether to precheck the API request.
- resource
Group stringId The ID of the resource group.
- {[key: string]: any}
A mapping of tags to assign to the resource.
- acl_
name str The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- acl_
entries Sequence[AclAcl Entry Args] The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- dry_
run bool Specifies whether to precheck the API request.
- resource_
group_ strid The ID of the resource group.
- Mapping[str, Any]
A mapping of tags to assign to the resource.
- acl
Name String The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- acl
Entries List<Property Map> The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- dry
Run Boolean Specifies whether to precheck the API request.
- resource
Group StringId The ID of the resource group.
- Map<Any>
A mapping of tags to assign to the resource.
Outputs
All input properties are implicitly available as output properties. Additionally, the Acl resource produces the following output properties:
Look up Existing Acl Resource
Get an existing Acl 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?: AclState, opts?: CustomResourceOptions): Acl
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
acl_entries: Optional[Sequence[AclAclEntryArgs]] = None,
acl_name: Optional[str] = None,
dry_run: Optional[bool] = None,
resource_group_id: Optional[str] = None,
status: Optional[str] = None,
tags: Optional[Mapping[str, Any]] = None) -> Acl
func GetAcl(ctx *Context, name string, id IDInput, state *AclState, opts ...ResourceOption) (*Acl, error)
public static Acl Get(string name, Input<string> id, AclState? state, CustomResourceOptions? opts = null)
public static Acl get(String name, Output<String> id, AclState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- 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.
- Acl
Entries List<Pulumi.Ali Cloud. Alb. Inputs. Acl Acl Entry Args> The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- Acl
Name string The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- Dry
Run bool Specifies whether to precheck the API request.
- Resource
Group stringId The ID of the resource group.
- Status string
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.- Dictionary<string, object>
A mapping of tags to assign to the resource.
- Acl
Entries []AclAcl Entry Args The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- Acl
Name string The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- Dry
Run bool Specifies whether to precheck the API request.
- Resource
Group stringId The ID of the resource group.
- Status string
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.- map[string]interface{}
A mapping of tags to assign to the resource.
- acl
Entries List<AclAcl Entry Args> The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- acl
Name String The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- dry
Run Boolean Specifies whether to precheck the API request.
- resource
Group StringId The ID of the resource group.
- status String
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.- Map<String,Object>
A mapping of tags to assign to the resource.
- acl
Entries AclAcl Entry Args[] The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- acl
Name string The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- dry
Run boolean Specifies whether to precheck the API request.
- resource
Group stringId The ID of the resource group.
- status string
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.- {[key: string]: any}
A mapping of tags to assign to the resource.
- acl_
entries Sequence[AclAcl Entry Args] The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- acl_
name str The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- dry_
run bool Specifies whether to precheck the API request.
- resource_
group_ strid The ID of the resource group.
- status str
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.- Mapping[str, Any]
A mapping of tags to assign to the resource.
- acl
Entries List<Property Map> The list of the ACL entries. You can add up to
20
entries in each call. NOTE: "Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.",Field 'acl_entries' has been deprecated from provider version 1.166.0 and it will be removed in the future version. Please use the new resource 'alicloud_alb_acl_entry_attachment'.
- acl
Name String The name of the ACL. The name must be
2
to128
characters in length, and can contain letters, digits, hyphens (-) and underscores (_). It must start with a letter.- dry
Run Boolean Specifies whether to precheck the API request.
- resource
Group StringId The ID of the resource group.
- status String
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.- Map<Any>
A mapping of tags to assign to the resource.
Supporting Types
AclAclEntry
- Description string
The description of the ACL entry. The description must be
1
to256
characters in length, and can contain letters, digits, hyphens (-), forward slashes (/), periods (.),and underscores (_). It can also contain Chinese characters.- Entry string
The IP address for the ACL entry.
- Status string
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.
- Description string
The description of the ACL entry. The description must be
1
to256
characters in length, and can contain letters, digits, hyphens (-), forward slashes (/), periods (.),and underscores (_). It can also contain Chinese characters.- Entry string
The IP address for the ACL entry.
- Status string
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.
- description String
The description of the ACL entry. The description must be
1
to256
characters in length, and can contain letters, digits, hyphens (-), forward slashes (/), periods (.),and underscores (_). It can also contain Chinese characters.- entry String
The IP address for the ACL entry.
- status String
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.
- description string
The description of the ACL entry. The description must be
1
to256
characters in length, and can contain letters, digits, hyphens (-), forward slashes (/), periods (.),and underscores (_). It can also contain Chinese characters.- entry string
The IP address for the ACL entry.
- status string
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.
- description str
The description of the ACL entry. The description must be
1
to256
characters in length, and can contain letters, digits, hyphens (-), forward slashes (/), periods (.),and underscores (_). It can also contain Chinese characters.- entry str
The IP address for the ACL entry.
- status str
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.
- description String
The description of the ACL entry. The description must be
1
to256
characters in length, and can contain letters, digits, hyphens (-), forward slashes (/), periods (.),and underscores (_). It can also contain Chinese characters.- entry String
The IP address for the ACL entry.
- status String
The state of the ACL. Valid values:
Provisioning
,Available
andConfiguring
.Provisioning
: The ACL is being created.Available
: The ACL is available.Configuring
: The ACL is being configured.
Import
ALB Acl can be imported using the id, e.g.
$ pulumi import alicloud:alb/acl:Acl example <id>
Package Details
- Repository
- Alibaba Cloud pulumi/pulumi-alicloud
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
alicloud
Terraform Provider.