com.pulumi.alicloud.alb.ServerGroup Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of alicloud Show documentation
Show all versions of alicloud Show documentation
A Pulumi package for creating and managing AliCloud resources.
// *** WARNING: this file was generated by pulumi-java-gen. ***
// *** Do not edit by hand unless you're certain you know what you are doing! ***
package com.pulumi.alicloud.alb;
import com.pulumi.alicloud.Utilities;
import com.pulumi.alicloud.alb.ServerGroupArgs;
import com.pulumi.alicloud.alb.inputs.ServerGroupState;
import com.pulumi.alicloud.alb.outputs.ServerGroupHealthCheckConfig;
import com.pulumi.alicloud.alb.outputs.ServerGroupServer;
import com.pulumi.alicloud.alb.outputs.ServerGroupStickySessionConfig;
import com.pulumi.core.Output;
import com.pulumi.core.annotations.Export;
import com.pulumi.core.annotations.ResourceType;
import com.pulumi.core.internal.Codegen;
import java.lang.Boolean;
import java.lang.String;
import java.util.List;
import java.util.Map;
import java.util.Optional;
import javax.annotation.Nullable;
/**
* Provides an ALB Server Group resource.
*
* For information about ALB Server Group and how to use it, see [What is Server Group](https://www.alibabacloud.com/help/en/slb/application-load-balancer/developer-reference/api-alb-2020-06-16-createservergroup).
*
* > **NOTE:** Available since v1.131.0.
*
* ## Example Usage
*
* Basic Usage
*
* <!--Start PulumiCodeChooser -->
*
* {@code
* package generated_program;
*
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.alicloud.resourcemanager.ResourcemanagerFunctions;
* import com.pulumi.alicloud.resourcemanager.inputs.GetResourceGroupsArgs;
* import com.pulumi.alicloud.AlicloudFunctions;
* import com.pulumi.alicloud.inputs.GetZonesArgs;
* import com.pulumi.alicloud.ecs.EcsFunctions;
* import com.pulumi.alicloud.ecs.inputs.GetInstanceTypesArgs;
* import com.pulumi.alicloud.ecs.inputs.GetImagesArgs;
* import com.pulumi.alicloud.vpc.Network;
* import com.pulumi.alicloud.vpc.NetworkArgs;
* import com.pulumi.alicloud.vpc.Switch;
* import com.pulumi.alicloud.vpc.SwitchArgs;
* import com.pulumi.alicloud.ecs.SecurityGroup;
* import com.pulumi.alicloud.ecs.SecurityGroupArgs;
* import com.pulumi.alicloud.ecs.Instance;
* import com.pulumi.alicloud.ecs.InstanceArgs;
* import com.pulumi.alicloud.alb.ServerGroup;
* import com.pulumi.alicloud.alb.ServerGroupArgs;
* import com.pulumi.alicloud.alb.inputs.ServerGroupStickySessionConfigArgs;
* import com.pulumi.alicloud.alb.inputs.ServerGroupHealthCheckConfigArgs;
* import com.pulumi.alicloud.alb.inputs.ServerGroupServerArgs;
* 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) {
* final var config = ctx.config();
* final var name = config.get("name").orElse("terraform-example");
* final var example = ResourcemanagerFunctions.getResourceGroups();
*
* final var exampleGetZones = AlicloudFunctions.getZones(GetZonesArgs.builder()
* .availableResourceCreation("Instance")
* .build());
*
* final var exampleGetInstanceTypes = EcsFunctions.getInstanceTypes(GetInstanceTypesArgs.builder()
* .availabilityZone(exampleGetZones.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
* .cpuCoreCount(1)
* .memorySize(2)
* .build());
*
* final var exampleGetImages = EcsFunctions.getImages(GetImagesArgs.builder()
* .nameRegex("^ubuntu_18.*64")
* .owners("system")
* .build());
*
* var exampleNetwork = new Network("exampleNetwork", NetworkArgs.builder()
* .vpcName(name)
* .cidrBlock("10.4.0.0/16")
* .build());
*
* var exampleSwitch = new Switch("exampleSwitch", SwitchArgs.builder()
* .vswitchName(name)
* .cidrBlock("10.4.0.0/16")
* .vpcId(exampleNetwork.id())
* .zoneId(exampleGetZones.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
* .build());
*
* var exampleSecurityGroup = new SecurityGroup("exampleSecurityGroup", SecurityGroupArgs.builder()
* .name(name)
* .description(name)
* .vpcId(exampleNetwork.id())
* .build());
*
* var exampleInstance = new Instance("exampleInstance", InstanceArgs.builder()
* .availabilityZone(exampleGetZones.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
* .instanceName(name)
* .imageId(exampleGetImages.applyValue(getImagesResult -> getImagesResult.images()[0].id()))
* .instanceType(exampleGetInstanceTypes.applyValue(getInstanceTypesResult -> getInstanceTypesResult.instanceTypes()[0].id()))
* .securityGroups(exampleSecurityGroup.id())
* .vswitchId(exampleSwitch.id())
* .build());
*
* var exampleServerGroup = new ServerGroup("exampleServerGroup", ServerGroupArgs.builder()
* .protocol("HTTP")
* .vpcId(exampleNetwork.id())
* .serverGroupName(name)
* .resourceGroupId(example.applyValue(getResourceGroupsResult -> getResourceGroupsResult.groups()[0].id()))
* .stickySessionConfig(ServerGroupStickySessionConfigArgs.builder()
* .stickySessionEnabled(true)
* .cookie("tf-example")
* .stickySessionType("Server")
* .build())
* .healthCheckConfig(ServerGroupHealthCheckConfigArgs.builder()
* .healthCheckConnectPort("46325")
* .healthCheckEnabled(true)
* .healthCheckHost("tf-example.com")
* .healthCheckCodes(
* "http_2xx",
* "http_3xx",
* "http_4xx")
* .healthCheckHttpVersion("HTTP1.1")
* .healthCheckInterval("2")
* .healthCheckMethod("HEAD")
* .healthCheckPath("/tf-example")
* .healthCheckProtocol("HTTP")
* .healthCheckTimeout(5)
* .healthyThreshold(3)
* .unhealthyThreshold(3)
* .build())
* .servers(ServerGroupServerArgs.builder()
* .description(name)
* .port(80)
* .serverId(exampleInstance.id())
* .serverIp(exampleInstance.privateIp())
* .serverType("Ecs")
* .weight(10)
* .build())
* .tags(Map.of("Created", "TF"))
* .build());
*
* }
* }
* }
*
* <!--End PulumiCodeChooser -->
*
* ## Import
*
* ALB Server Group can be imported using the id, e.g.
*
* ```sh
* $ pulumi import alicloud:alb/serverGroup:ServerGroup example <id>
* ```
*
*/
@ResourceType(type="alicloud:alb/serverGroup:ServerGroup")
public class ServerGroup extends com.pulumi.resources.CustomResource {
/**
* The dry run.
*
*/
@Export(name="dryRun", refs={Boolean.class}, tree="[0]")
private Output dryRun;
/**
* @return The dry run.
*
*/
public Output> dryRun() {
return Codegen.optional(this.dryRun);
}
/**
* The configuration of health checks. See `health_check_config` below.
*
*/
@Export(name="healthCheckConfig", refs={ServerGroupHealthCheckConfig.class}, tree="[0]")
private Output healthCheckConfig;
/**
* @return The configuration of health checks. See `health_check_config` below.
*
*/
public Output healthCheckConfig() {
return this.healthCheckConfig;
}
/**
* The server protocol. Valid values: ` HTTP `, `HTTPS`, `gRPC`. While `server_group_type` is `Fc` this parameter will not take effect. From version 1.215.0, `protocol` can be set to `gRPC`.
*
*/
@Export(name="protocol", refs={String.class}, tree="[0]")
private Output protocol;
/**
* @return The server protocol. Valid values: ` HTTP `, `HTTPS`, `gRPC`. While `server_group_type` is `Fc` this parameter will not take effect. From version 1.215.0, `protocol` can be set to `gRPC`.
*
*/
public Output protocol() {
return this.protocol;
}
/**
* The ID of the resource group.
*
*/
@Export(name="resourceGroupId", refs={String.class}, tree="[0]")
private Output resourceGroupId;
/**
* @return The ID of the resource group.
*
*/
public Output resourceGroupId() {
return this.resourceGroupId;
}
/**
* The scheduling algorithm. Valid values: ` Sch `, ` Wlc `, `Wrr`. **NOTE:** This parameter takes effect when the `server_group_type` parameter is set to `Instance` or `Ip`.
*
*/
@Export(name="scheduler", refs={String.class}, tree="[0]")
private Output scheduler;
/**
* @return The scheduling algorithm. Valid values: ` Sch `, ` Wlc `, `Wrr`. **NOTE:** This parameter takes effect when the `server_group_type` parameter is set to `Instance` or `Ip`.
*
*/
public Output scheduler() {
return this.scheduler;
}
/**
* The name of the server group.
*
*/
@Export(name="serverGroupName", refs={String.class}, tree="[0]")
private Output serverGroupName;
/**
* @return The name of the server group.
*
*/
public Output serverGroupName() {
return this.serverGroupName;
}
/**
* The type of the server group. Default value: `Instance`. Valid values:
* - `Instance`: allows you add servers by specifying Ecs, Ens, or Eci.
* - `Ip`: allows you to add servers by specifying IP addresses.
* - `Fc`: allows you to add servers by specifying functions of Function Compute.
*
*/
@Export(name="serverGroupType", refs={String.class}, tree="[0]")
private Output serverGroupType;
/**
* @return The type of the server group. Default value: `Instance`. Valid values:
* - `Instance`: allows you add servers by specifying Ecs, Ens, or Eci.
* - `Ip`: allows you to add servers by specifying IP addresses.
* - `Fc`: allows you to add servers by specifying functions of Function Compute.
*
*/
public Output serverGroupType() {
return this.serverGroupType;
}
/**
* The backend servers. See `servers` below.
*
*/
@Export(name="servers", refs={List.class,ServerGroupServer.class}, tree="[0,1]")
private Output> servers;
/**
* @return The backend servers. See `servers` below.
*
*/
public Output>> servers() {
return Codegen.optional(this.servers);
}
/**
* The status of the backend server.
*
*/
@Export(name="status", refs={String.class}, tree="[0]")
private Output status;
/**
* @return The status of the backend server.
*
*/
public Output status() {
return this.status;
}
/**
* The configuration of session persistence. See `sticky_session_config` below.
*
*/
@Export(name="stickySessionConfig", refs={ServerGroupStickySessionConfig.class}, tree="[0]")
private Output stickySessionConfig;
/**
* @return The configuration of session persistence. See `sticky_session_config` below.
*
*/
public Output stickySessionConfig() {
return this.stickySessionConfig;
}
/**
* A mapping of tags to assign to the resource.
*
*/
@Export(name="tags", refs={Map.class,String.class}, tree="[0,1,1]")
private Output> tags;
/**
* @return A mapping of tags to assign to the resource.
*
*/
public Output>> tags() {
return Codegen.optional(this.tags);
}
/**
* The ID of the VPC that you want to access. **NOTE:** This parameter takes effect when the `server_group_type` parameter is set to `Instance` or `Ip`.
*
*/
@Export(name="vpcId", refs={String.class}, tree="[0]")
private Output vpcId;
/**
* @return The ID of the VPC that you want to access. **NOTE:** This parameter takes effect when the `server_group_type` parameter is set to `Instance` or `Ip`.
*
*/
public Output> vpcId() {
return Codegen.optional(this.vpcId);
}
/**
*
* @param name The _unique_ name of the resulting resource.
*/
public ServerGroup(java.lang.String name) {
this(name, ServerGroupArgs.Empty);
}
/**
*
* @param name The _unique_ name of the resulting resource.
* @param args The arguments to use to populate this resource's properties.
*/
public ServerGroup(java.lang.String name, ServerGroupArgs args) {
this(name, args, null);
}
/**
*
* @param name The _unique_ name of the resulting resource.
* @param args The arguments to use to populate this resource's properties.
* @param options A bag of options that control this resource's behavior.
*/
public ServerGroup(java.lang.String name, ServerGroupArgs args, @Nullable com.pulumi.resources.CustomResourceOptions options) {
super("alicloud:alb/serverGroup:ServerGroup", name, makeArgs(args, options), makeResourceOptions(options, Codegen.empty()), false);
}
private ServerGroup(java.lang.String name, Output id, @Nullable ServerGroupState state, @Nullable com.pulumi.resources.CustomResourceOptions options) {
super("alicloud:alb/serverGroup:ServerGroup", name, state, makeResourceOptions(options, id), false);
}
private static ServerGroupArgs makeArgs(ServerGroupArgs args, @Nullable com.pulumi.resources.CustomResourceOptions options) {
if (options != null && options.getUrn().isPresent()) {
return null;
}
return args == null ? ServerGroupArgs.Empty : args;
}
private static com.pulumi.resources.CustomResourceOptions makeResourceOptions(@Nullable com.pulumi.resources.CustomResourceOptions options, @Nullable Output id) {
var defaultOptions = com.pulumi.resources.CustomResourceOptions.builder()
.version(Utilities.getVersion())
.build();
return com.pulumi.resources.CustomResourceOptions.merge(defaultOptions, options, id);
}
/**
* Get an existing Host resource's state with the given name, ID, and optional extra
* properties used to qualify the lookup.
*
* @param name The _unique_ name of the resulting resource.
* @param id The _unique_ provider ID of the resource to lookup.
* @param state
* @param options Optional settings to control the behavior of the CustomResource.
*/
public static ServerGroup get(java.lang.String name, Output id, @Nullable ServerGroupState state, @Nullable com.pulumi.resources.CustomResourceOptions options) {
return new ServerGroup(name, id, state, options);
}
}