1. Packages
  2. Zscaler Private Access (ZPA)
  3. API Docs
  4. getMachineGroup
Zscaler Private Access v0.0.12 published on Tuesday, Jul 30, 2024 by Zscaler

zpa.getMachineGroup

Explore with Pulumi AI

zpa logo
Zscaler Private Access v0.0.12 published on Tuesday, Jul 30, 2024 by Zscaler

    Use the zpa_machine_group data source to get information about a machine group created in the Zscaler Private Access cloud. This data source can then be referenced in an Access Policy, Timeout policy, Forwarding Policy, Inspection Policy or Isolation Policy.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as zpa from "@pulumi/zpa";
    
    const example = zpa.getMachineGroup({
        name: "MGR01",
    });
    
    import pulumi
    import pulumi_zpa as zpa
    
    example = zpa.get_machine_group(name="MGR01")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/zscaler/pulumi-zpa/sdk/go/zpa"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := zpa.GetMachineGroup(ctx, &zpa.GetMachineGroupArgs{
    			Name: pulumi.StringRef("MGR01"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Zpa = Pulumi.Zpa;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Zpa.GetMachineGroup.Invoke(new()
        {
            Name = "MGR01",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.zpa.ZpaFunctions;
    import com.pulumi.zpa.inputs.GetMachineGroupArgs;
    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 example = ZpaFunctions.getMachineGroup(GetMachineGroupArgs.builder()
                .name("MGR01")
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          Function: zpa:getMachineGroup
          Arguments:
            name: MGR01
    
    import * as pulumi from "@pulumi/pulumi";
    import * as zpa from "@pulumi/zpa";
    
    const example = zpa.getMachineGroup({
        id: "1234567890",
    });
    
    import pulumi
    import pulumi_zpa as zpa
    
    example = zpa.get_machine_group(id="1234567890")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/zscaler/pulumi-zpa/sdk/go/zpa"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := zpa.GetMachineGroup(ctx, &zpa.GetMachineGroupArgs{
    			Id: pulumi.StringRef("1234567890"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Zpa = Pulumi.Zpa;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Zpa.GetMachineGroup.Invoke(new()
        {
            Id = "1234567890",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.zpa.ZpaFunctions;
    import com.pulumi.zpa.inputs.GetMachineGroupArgs;
    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 example = ZpaFunctions.getMachineGroup(GetMachineGroupArgs.builder()
                .id("1234567890")
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          Function: zpa:getMachineGroup
          Arguments:
            id: '1234567890'
    

    Using getMachineGroup

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getMachineGroup(args: GetMachineGroupArgs, opts?: InvokeOptions): Promise<GetMachineGroupResult>
    function getMachineGroupOutput(args: GetMachineGroupOutputArgs, opts?: InvokeOptions): Output<GetMachineGroupResult>
    def get_machine_group(id: Optional[str] = None,
                          microtenant_id: Optional[str] = None,
                          microtenant_name: Optional[str] = None,
                          name: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetMachineGroupResult
    def get_machine_group_output(id: Optional[pulumi.Input[str]] = None,
                          microtenant_id: Optional[pulumi.Input[str]] = None,
                          microtenant_name: Optional[pulumi.Input[str]] = None,
                          name: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetMachineGroupResult]
    func GetMachineGroup(ctx *Context, args *GetMachineGroupArgs, opts ...InvokeOption) (*GetMachineGroupResult, error)
    func GetMachineGroupOutput(ctx *Context, args *GetMachineGroupOutputArgs, opts ...InvokeOption) GetMachineGroupResultOutput

    > Note: This function is named GetMachineGroup in the Go SDK.

    public static class GetMachineGroup 
    {
        public static Task<GetMachineGroupResult> InvokeAsync(GetMachineGroupArgs args, InvokeOptions? opts = null)
        public static Output<GetMachineGroupResult> Invoke(GetMachineGroupInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetMachineGroupResult> getMachineGroup(GetMachineGroupArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: zpa:index/getMachineGroup:getMachineGroup
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Id string
    MicrotenantId string
    MicrotenantName string
    Name string
    Id string
    MicrotenantId string
    MicrotenantName string
    Name string
    id String
    microtenantId String
    microtenantName String
    name String
    id string
    microtenantId string
    microtenantName string
    name string
    id String
    microtenantId String
    microtenantName String
    name String

    getMachineGroup Result

    The following output properties are available:

    Supporting Types

    GetMachineGroupMachine

    CreationTime string
    Description string
    Fingerprint string
    Id string
    IssuedCertId string
    MachineGroupId string
    MachineGroupName string
    MachineTokenId string
    ModifiedBy string
    ModifiedTime string
    Name string
    SigningCert Dictionary<string, string>
    MicrotenantId string
    MicrotenantName string
    CreationTime string
    Description string
    Fingerprint string
    Id string
    IssuedCertId string
    MachineGroupId string
    MachineGroupName string
    MachineTokenId string
    ModifiedBy string
    ModifiedTime string
    Name string
    SigningCert map[string]string
    MicrotenantId string
    MicrotenantName string
    creationTime String
    description String
    fingerprint String
    id String
    issuedCertId String
    machineGroupId String
    machineGroupName String
    machineTokenId String
    modifiedBy String
    modifiedTime String
    name String
    signingCert Map<String,String>
    microtenantId String
    microtenantName String
    creationTime string
    description string
    fingerprint string
    id string
    issuedCertId string
    machineGroupId string
    machineGroupName string
    machineTokenId string
    modifiedBy string
    modifiedTime string
    name string
    signingCert {[key: string]: string}
    microtenantId string
    microtenantName string

    Package Details

    Repository
    zpa zscaler/pulumi-zpa
    License
    MIT
    Notes
    This Pulumi package is based on the zpa Terraform Provider.
    zpa logo
    Zscaler Private Access v0.0.12 published on Tuesday, Jul 30, 2024 by Zscaler