Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Ibm Provider
  3. API Docs
  4. MetricsRouterSettings
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud
ibm-cloud/terraform-provider-ibm

ibm.MetricsRouterSettings

Explore with Pulumi AI

ibm logo
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud
ibm-cloud/terraform-provider-ibm

    Provides a resource for metrics_router_settings. This allows metrics_router_settings to be updated.

    Example Usage

    Example with no default_targets

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

const metricsRouterSettingsInstance = new ibm.MetricsRouterSettings("metricsRouterSettingsInstance", {
    backupMetadataRegion: "us-east",
    permittedTargetRegions: ["us-south"],
    primaryMetadataRegion: "us-south",
    privateApiEndpointOnly: false,
});

    import pulumi
import pulumi_ibm as ibm

metrics_router_settings_instance = ibm.MetricsRouterSettings("metricsRouterSettingsInstance",
    backup_metadata_region="us-east",
    permitted_target_regions=["us-south"],
    primary_metadata_region="us-south",
    private_api_endpoint_only=False)

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ibm.NewMetricsRouterSettings(ctx, "metricsRouterSettingsInstance", &ibm.MetricsRouterSettingsArgs{
			BackupMetadataRegion: pulumi.String("us-east"),
			PermittedTargetRegions: pulumi.StringArray{
				pulumi.String("us-south"),
			},
			PrimaryMetadataRegion:  pulumi.String("us-south"),
			PrivateApiEndpointOnly: pulumi.Bool(false),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var metricsRouterSettingsInstance = new Ibm.MetricsRouterSettings("metricsRouterSettingsInstance", new()
    {
        BackupMetadataRegion = "us-east",
        PermittedTargetRegions = new[]
        {
            "us-south",
        },
        PrimaryMetadataRegion = "us-south",
        PrivateApiEndpointOnly = false,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.MetricsRouterSettings;
import com.pulumi.ibm.MetricsRouterSettingsArgs;
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 metricsRouterSettingsInstance = new MetricsRouterSettings("metricsRouterSettingsInstance", MetricsRouterSettingsArgs.builder()
            .backupMetadataRegion("us-east")
            .permittedTargetRegions("us-south")
            .primaryMetadataRegion("us-south")
            .privateApiEndpointOnly(false)
            .build());

    }
}

    resources:
  metricsRouterSettingsInstance:
    type: ibm:MetricsRouterSettings
    properties:
      backupMetadataRegion: us-east
      permittedTargetRegions:
        - us-south
      primaryMetadataRegion: us-south
      privateApiEndpointOnly: false

    Example with single default_targets

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

const metricsRouterSettingsInstance = new ibm.MetricsRouterSettings("metricsRouterSettingsInstance", {
    backupMetadataRegion: "us-east",
    defaultTargets: [{
        id: "c3af557f-fb0e-4476-85c3-0889e7fe7bc4",
    }],
    permittedTargetRegions: ["us-south"],
    primaryMetadataRegion: "us-south",
    privateApiEndpointOnly: false,
});

    import pulumi
import pulumi_ibm as ibm

metrics_router_settings_instance = ibm.MetricsRouterSettings("metricsRouterSettingsInstance",
    backup_metadata_region="us-east",
    default_targets=[{
        "id": "c3af557f-fb0e-4476-85c3-0889e7fe7bc4",
    }],
    permitted_target_regions=["us-south"],
    primary_metadata_region="us-south",
    private_api_endpoint_only=False)

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ibm.NewMetricsRouterSettings(ctx, "metricsRouterSettingsInstance", &ibm.MetricsRouterSettingsArgs{
			BackupMetadataRegion: pulumi.String("us-east"),
			DefaultTargets: ibm.MetricsRouterSettingsDefaultTargetArray{
				&ibm.MetricsRouterSettingsDefaultTargetArgs{
					Id: pulumi.String("c3af557f-fb0e-4476-85c3-0889e7fe7bc4"),
				},
			},
			PermittedTargetRegions: pulumi.StringArray{
				pulumi.String("us-south"),
			},
			PrimaryMetadataRegion:  pulumi.String("us-south"),
			PrivateApiEndpointOnly: pulumi.Bool(false),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var metricsRouterSettingsInstance = new Ibm.MetricsRouterSettings("metricsRouterSettingsInstance", new()
    {
        BackupMetadataRegion = "us-east",
        DefaultTargets = new[]
        {
            new Ibm.Inputs.MetricsRouterSettingsDefaultTargetArgs
            {
                Id = "c3af557f-fb0e-4476-85c3-0889e7fe7bc4",
            },
        },
        PermittedTargetRegions = new[]
        {
            "us-south",
        },
        PrimaryMetadataRegion = "us-south",
        PrivateApiEndpointOnly = false,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.MetricsRouterSettings;
import com.pulumi.ibm.MetricsRouterSettingsArgs;
import com.pulumi.ibm.inputs.MetricsRouterSettingsDefaultTargetArgs;
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 metricsRouterSettingsInstance = new MetricsRouterSettings("metricsRouterSettingsInstance", MetricsRouterSettingsArgs.builder()
            .backupMetadataRegion("us-east")
            .defaultTargets(MetricsRouterSettingsDefaultTargetArgs.builder()
                .id("c3af557f-fb0e-4476-85c3-0889e7fe7bc4")
                .build())
            .permittedTargetRegions("us-south")
            .primaryMetadataRegion("us-south")
            .privateApiEndpointOnly(false)
            .build());

    }
}

    resources:
  metricsRouterSettingsInstance:
    type: ibm:MetricsRouterSettings
    properties:
      backupMetadataRegion: us-east
      defaultTargets:
        - id: c3af557f-fb0e-4476-85c3-0889e7fe7bc4
      permittedTargetRegions:
        - us-south
      primaryMetadataRegion: us-south
      privateApiEndpointOnly: false

    Example with multiple default_targets

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

const metricsRouterSettingsInstance = new ibm.MetricsRouterSettings("metricsRouterSettingsInstance", {
    backupMetadataRegion: "us-east",
    defaultTargets: [
        {
            id: "c3af557f-fb0e-4476-85c3-0889e7fe7bc4",
        },
        {
            id: "c3af557f-fb0e-2222-85c3-0889e7fe7bc4",
        },
    ],
    permittedTargetRegions: [
        "us-south",
        "us-east",
    ],
    primaryMetadataRegion: "us-south",
    privateApiEndpointOnly: false,
});

    import pulumi
import pulumi_ibm as ibm

metrics_router_settings_instance = ibm.MetricsRouterSettings("metricsRouterSettingsInstance",
    backup_metadata_region="us-east",
    default_targets=[
        {
            "id": "c3af557f-fb0e-4476-85c3-0889e7fe7bc4",
        },
        {
            "id": "c3af557f-fb0e-2222-85c3-0889e7fe7bc4",
        },
    ],
    permitted_target_regions=[
        "us-south",
        "us-east",
    ],
    primary_metadata_region="us-south",
    private_api_endpoint_only=False)

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ibm.NewMetricsRouterSettings(ctx, "metricsRouterSettingsInstance", &ibm.MetricsRouterSettingsArgs{
			BackupMetadataRegion: pulumi.String("us-east"),
			DefaultTargets: ibm.MetricsRouterSettingsDefaultTargetArray{
				&ibm.MetricsRouterSettingsDefaultTargetArgs{
					Id: pulumi.String("c3af557f-fb0e-4476-85c3-0889e7fe7bc4"),
				},
				&ibm.MetricsRouterSettingsDefaultTargetArgs{
					Id: pulumi.String("c3af557f-fb0e-2222-85c3-0889e7fe7bc4"),
				},
			},
			PermittedTargetRegions: pulumi.StringArray{
				pulumi.String("us-south"),
				pulumi.String("us-east"),
			},
			PrimaryMetadataRegion:  pulumi.String("us-south"),
			PrivateApiEndpointOnly: pulumi.Bool(false),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var metricsRouterSettingsInstance = new Ibm.MetricsRouterSettings("metricsRouterSettingsInstance", new()
    {
        BackupMetadataRegion = "us-east",
        DefaultTargets = new[]
        {
            new Ibm.Inputs.MetricsRouterSettingsDefaultTargetArgs
            {
                Id = "c3af557f-fb0e-4476-85c3-0889e7fe7bc4",
            },
            new Ibm.Inputs.MetricsRouterSettingsDefaultTargetArgs
            {
                Id = "c3af557f-fb0e-2222-85c3-0889e7fe7bc4",
            },
        },
        PermittedTargetRegions = new[]
        {
            "us-south",
            "us-east",
        },
        PrimaryMetadataRegion = "us-south",
        PrivateApiEndpointOnly = false,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.MetricsRouterSettings;
import com.pulumi.ibm.MetricsRouterSettingsArgs;
import com.pulumi.ibm.inputs.MetricsRouterSettingsDefaultTargetArgs;
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 metricsRouterSettingsInstance = new MetricsRouterSettings("metricsRouterSettingsInstance", MetricsRouterSettingsArgs.builder()
            .backupMetadataRegion("us-east")
            .defaultTargets(            
                MetricsRouterSettingsDefaultTargetArgs.builder()
                    .id("c3af557f-fb0e-4476-85c3-0889e7fe7bc4")
                    .build(),
                MetricsRouterSettingsDefaultTargetArgs.builder()
                    .id("c3af557f-fb0e-2222-85c3-0889e7fe7bc4")
                    .build())
            .permittedTargetRegions(            
                "us-south",
                "us-east")
            .primaryMetadataRegion("us-south")
            .privateApiEndpointOnly(false)
            .build());

    }
}

    resources:
  metricsRouterSettingsInstance:
    type: ibm:MetricsRouterSettings
    properties:
      backupMetadataRegion: us-east
      defaultTargets:
        - id: c3af557f-fb0e-4476-85c3-0889e7fe7bc4
        - id: c3af557f-fb0e-2222-85c3-0889e7fe7bc4
      permittedTargetRegions:
        - us-south
        - us-east
      primaryMetadataRegion: us-south
      privateApiEndpointOnly: false

    Example without permitted_target_regions

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

const metricsRouterSettingsInstance = new ibm.MetricsRouterSettings("metricsRouterSettingsInstance", {
    backupMetadataRegion: "us-east",
    permittedTargetRegions: [],
    primaryMetadataRegion: "us-south",
    privateApiEndpointOnly: false,
});

    import pulumi
import pulumi_ibm as ibm

metrics_router_settings_instance = ibm.MetricsRouterSettings("metricsRouterSettingsInstance",
    backup_metadata_region="us-east",
    permitted_target_regions=[],
    primary_metadata_region="us-south",
    private_api_endpoint_only=False)

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ibm.NewMetricsRouterSettings(ctx, "metricsRouterSettingsInstance", &ibm.MetricsRouterSettingsArgs{
			BackupMetadataRegion:   pulumi.String("us-east"),
			PermittedTargetRegions: pulumi.StringArray{},
			PrimaryMetadataRegion:  pulumi.String("us-south"),
			PrivateApiEndpointOnly: pulumi.Bool(false),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var metricsRouterSettingsInstance = new Ibm.MetricsRouterSettings("metricsRouterSettingsInstance", new()
    {
        BackupMetadataRegion = "us-east",
        PermittedTargetRegions = new[] {},
        PrimaryMetadataRegion = "us-south",
        PrivateApiEndpointOnly = false,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.MetricsRouterSettings;
import com.pulumi.ibm.MetricsRouterSettingsArgs;
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 metricsRouterSettingsInstance = new MetricsRouterSettings("metricsRouterSettingsInstance", MetricsRouterSettingsArgs.builder()
            .backupMetadataRegion("us-east")
            .permittedTargetRegions()
            .primaryMetadataRegion("us-south")
            .privateApiEndpointOnly(false)
            .build());

    }
}

    resources:
  metricsRouterSettingsInstance:
    type: ibm:MetricsRouterSettings
    properties:
      backupMetadataRegion: us-east
      permittedTargetRegions: []
      primaryMetadataRegion: us-south
      privateApiEndpointOnly: false

    Provider Configuration

    The IBM Cloud provider offers a flexible means of providing credentials for authentication. The following methods are supported, in this order, and explained below:

    • Static credentials
    • Environment variables

    To find which credentials are required for this resource, see the service table here.

    Static credentials

    You can provide your static credentials by adding the ibmcloud_api_key, iaas_classic_username, and iaas_classic_api_key arguments in the IBM Cloud provider block.

    Usage:

    provider "ibm" {
  ibmcloud_api_key = ""
  iaas_classic_username = ""
  iaas_classic_api_key = ""
}

    Environment variables

    You can provide your credentials by exporting the IC_API_KEY, IAAS_CLASSIC_USERNAME, and IAAS_CLASSIC_API_KEY environment variables, representing your IBM Cloud platform API key, IBM Cloud Classic Infrastructure (SoftLayer) user name, and IBM Cloud infrastructure API key, respectively.

    provider "ibm" {}

    Usage:

    export IC_API_KEY="ibmcloud_api_key"
export IAAS_CLASSIC_USERNAME="iaas_classic_username"
export IAAS_CLASSIC_API_KEY="iaas_classic_api_key"
pulumi preview

    Note:

    1. Create or find your ibmcloud_api_key and iaas_classic_api_key here.
    • Select My IBM Cloud API Keys option from view dropdown for ibmcloud_api_key
    • Select Classic Infrastructure API Keys option from view dropdown for iaas_classic_api_key
    1. For iaas_classic_username
    • Go to Users
    • Click on user.
    • Find user name in the VPN password section under User Details tab

    For more informaton, see here.

    Create MetricsRouterSettings Resource

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

    Constructor syntax

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

@overload
def MetricsRouterSettings(resource_name: str,
                          opts: Optional[ResourceOptions] = None,
                          backup_metadata_region: Optional[str] = None,
                          default_targets: Optional[Sequence[MetricsRouterSettingsDefaultTargetArgs]] = None,
                          metrics_router_settings_id: Optional[str] = None,
                          permitted_target_regions: Optional[Sequence[str]] = None,
                          primary_metadata_region: Optional[str] = None,
                          private_api_endpoint_only: Optional[bool] = None)
    func NewMetricsRouterSettings(ctx *Context, name string, args *MetricsRouterSettingsArgs, opts ...ResourceOption) (*MetricsRouterSettings, error)
    public MetricsRouterSettings(string name, MetricsRouterSettingsArgs? args = null, CustomResourceOptions? opts = null)
    public MetricsRouterSettings(String name, MetricsRouterSettingsArgs args)
public MetricsRouterSettings(String name, MetricsRouterSettingsArgs args, CustomResourceOptions options)

    type: ibm:MetricsRouterSettings
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 MetricsRouterSettingsArgs
    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 MetricsRouterSettingsArgs
    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 MetricsRouterSettingsArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MetricsRouterSettingsArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MetricsRouterSettingsArgs
    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 metricsRouterSettingsResource = new Ibm.MetricsRouterSettings("metricsRouterSettingsResource", new()
{
    BackupMetadataRegion = "string",
    DefaultTargets = new[]
    {
        new Ibm.Inputs.MetricsRouterSettingsDefaultTargetArgs
        {
            Id = "string",
        },
    },
    MetricsRouterSettingsId = "string",
    PermittedTargetRegions = new[]
    {
        "string",
    },
    PrimaryMetadataRegion = "string",
    PrivateApiEndpointOnly = false,
});

    example, err := ibm.NewMetricsRouterSettings(ctx, "metricsRouterSettingsResource", &ibm.MetricsRouterSettingsArgs{
	BackupMetadataRegion: pulumi.String("string"),
	DefaultTargets: ibm.MetricsRouterSettingsDefaultTargetArray{
		&ibm.MetricsRouterSettingsDefaultTargetArgs{
			Id: pulumi.String("string"),
		},
	},
	MetricsRouterSettingsId: pulumi.String("string"),
	PermittedTargetRegions: pulumi.StringArray{
		pulumi.String("string"),
	},
	PrimaryMetadataRegion:  pulumi.String("string"),
	PrivateApiEndpointOnly: pulumi.Bool(false),
})

    var metricsRouterSettingsResource = new MetricsRouterSettings("metricsRouterSettingsResource", MetricsRouterSettingsArgs.builder()
    .backupMetadataRegion("string")
    .defaultTargets(MetricsRouterSettingsDefaultTargetArgs.builder()
        .id("string")
        .build())
    .metricsRouterSettingsId("string")
    .permittedTargetRegions("string")
    .primaryMetadataRegion("string")
    .privateApiEndpointOnly(false)
    .build());

    metrics_router_settings_resource = ibm.MetricsRouterSettings("metricsRouterSettingsResource",
    backup_metadata_region="string",
    default_targets=[{
        "id": "string",
    }],
    metrics_router_settings_id="string",
    permitted_target_regions=["string"],
    primary_metadata_region="string",
    private_api_endpoint_only=False)

    const metricsRouterSettingsResource = new ibm.MetricsRouterSettings("metricsRouterSettingsResource", {
    backupMetadataRegion: "string",
    defaultTargets: [{
        id: "string",
    }],
    metricsRouterSettingsId: "string",
    permittedTargetRegions: ["string"],
    primaryMetadataRegion: "string",
    privateApiEndpointOnly: false,
});

    type: ibm:MetricsRouterSettings
properties:
    backupMetadataRegion: string
    defaultTargets:
        - id: string
    metricsRouterSettingsId: string
    permittedTargetRegions:
        - string
    primaryMetadataRegion: string
    privateApiEndpointOnly: false

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

    BackupMetadataRegion string
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    DefaultTargets List<MetricsRouterSettingsDefaultTarget>
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    MetricsRouterSettingsId string
    The unique identifier of the metrics_router_settings.
    PermittedTargetRegions List<string>
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    PrimaryMetadataRegion string
    To store all your meta data in a single region.
    PrivateApiEndpointOnly bool
    If you set this true then you cannot access api through public network.
    BackupMetadataRegion string
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    DefaultTargets []MetricsRouterSettingsDefaultTargetArgs
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    MetricsRouterSettingsId string
    The unique identifier of the metrics_router_settings.
    PermittedTargetRegions []string
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    PrimaryMetadataRegion string
    To store all your meta data in a single region.
    PrivateApiEndpointOnly bool
    If you set this true then you cannot access api through public network.
    backupMetadataRegion String
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    defaultTargets List<MetricsRouterSettingsDefaultTarget>
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    metricsRouterSettingsId String
    The unique identifier of the metrics_router_settings.
    permittedTargetRegions List<String>
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    primaryMetadataRegion String
    To store all your meta data in a single region.
    privateApiEndpointOnly Boolean
    If you set this true then you cannot access api through public network.
    backupMetadataRegion string
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    defaultTargets MetricsRouterSettingsDefaultTarget[]
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    metricsRouterSettingsId string
    The unique identifier of the metrics_router_settings.
    permittedTargetRegions string[]
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    primaryMetadataRegion string
    To store all your meta data in a single region.
    privateApiEndpointOnly boolean
    If you set this true then you cannot access api through public network.
    backup_metadata_region str
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    default_targets Sequence[MetricsRouterSettingsDefaultTargetArgs]
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    metrics_router_settings_id str
    The unique identifier of the metrics_router_settings.
    permitted_target_regions Sequence[str]
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    primary_metadata_region str
    To store all your meta data in a single region.
    private_api_endpoint_only bool
    If you set this true then you cannot access api through public network.
    backupMetadataRegion String
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    defaultTargets List<Property Map>
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    metricsRouterSettingsId String
    The unique identifier of the metrics_router_settings.
    permittedTargetRegions List<String>
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    primaryMetadataRegion String
    To store all your meta data in a single region.
    privateApiEndpointOnly Boolean
    If you set this true then you cannot access api through public network.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the MetricsRouterSettings 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 MetricsRouterSettings Resource

    Get an existing MetricsRouterSettings 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?: MetricsRouterSettingsState, opts?: CustomResourceOptions): MetricsRouterSettings
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        backup_metadata_region: Optional[str] = None,
        default_targets: Optional[Sequence[MetricsRouterSettingsDefaultTargetArgs]] = None,
        metrics_router_settings_id: Optional[str] = None,
        permitted_target_regions: Optional[Sequence[str]] = None,
        primary_metadata_region: Optional[str] = None,
        private_api_endpoint_only: Optional[bool] = None) -> MetricsRouterSettings
    func GetMetricsRouterSettings(ctx *Context, name string, id IDInput, state *MetricsRouterSettingsState, opts ...ResourceOption) (*MetricsRouterSettings, error)
    public static MetricsRouterSettings Get(string name, Input<string> id, MetricsRouterSettingsState? state, CustomResourceOptions? opts = null)
    public static MetricsRouterSettings get(String name, Output<String> id, MetricsRouterSettingsState state, CustomResourceOptions options)
    resources:  _:    type: ibm:MetricsRouterSettings    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:
    BackupMetadataRegion string
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    DefaultTargets List<MetricsRouterSettingsDefaultTarget>
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    MetricsRouterSettingsId string
    The unique identifier of the metrics_router_settings.
    PermittedTargetRegions List<string>
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    PrimaryMetadataRegion string
    To store all your meta data in a single region.
    PrivateApiEndpointOnly bool
    If you set this true then you cannot access api through public network.
    BackupMetadataRegion string
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    DefaultTargets []MetricsRouterSettingsDefaultTargetArgs
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    MetricsRouterSettingsId string
    The unique identifier of the metrics_router_settings.
    PermittedTargetRegions []string
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    PrimaryMetadataRegion string
    To store all your meta data in a single region.
    PrivateApiEndpointOnly bool
    If you set this true then you cannot access api through public network.
    backupMetadataRegion String
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    defaultTargets List<MetricsRouterSettingsDefaultTarget>
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    metricsRouterSettingsId String
    The unique identifier of the metrics_router_settings.
    permittedTargetRegions List<String>
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    primaryMetadataRegion String
    To store all your meta data in a single region.
    privateApiEndpointOnly Boolean
    If you set this true then you cannot access api through public network.
    backupMetadataRegion string
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    defaultTargets MetricsRouterSettingsDefaultTarget[]
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    metricsRouterSettingsId string
    The unique identifier of the metrics_router_settings.
    permittedTargetRegions string[]
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    primaryMetadataRegion string
    To store all your meta data in a single region.
    privateApiEndpointOnly boolean
    If you set this true then you cannot access api through public network.
    backup_metadata_region str
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    default_targets Sequence[MetricsRouterSettingsDefaultTargetArgs]
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    metrics_router_settings_id str
    The unique identifier of the metrics_router_settings.
    permitted_target_regions Sequence[str]
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    primary_metadata_region str
    To store all your meta data in a single region.
    private_api_endpoint_only bool
    If you set this true then you cannot access api through public network.
    backupMetadataRegion String
    To backup all your meta data in a different region.

    • Constraints: The maximum length is 256 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-_]+$/.
    defaultTargets List<Property Map>
    A list of default target references.

    • Constraints: The maximum length is 2 items. The minimum length is 0 items. Nested scheme for default_targets:
    metricsRouterSettingsId String
    The unique identifier of the metrics_router_settings.
    permittedTargetRegions List<String>
    If present then only these regions may be used to define a target.

    • Constraints: The list items must match regular expression /^[a-zA-Z0-9 \\-_]+$/. The maximum length is 16 items. The minimum length is 0 items.
    primaryMetadataRegion String
    To store all your meta data in a single region.
    privateApiEndpointOnly Boolean
    If you set this true then you cannot access api through public network.

    Supporting Types

    MetricsRouterSettingsDefaultTarget, MetricsRouterSettingsDefaultTargetArgs

    Id string
    The target uuid for a pre-defined metrics router target.

    • Constraints: The maximum length is 1000 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-._:]+$/.
    Id string
    The target uuid for a pre-defined metrics router target.

    • Constraints: The maximum length is 1000 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-._:]+$/.
    id String
    The target uuid for a pre-defined metrics router target.

    • Constraints: The maximum length is 1000 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-._:]+$/.
    id string
    The target uuid for a pre-defined metrics router target.

    • Constraints: The maximum length is 1000 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-._:]+$/.
    id str
    The target uuid for a pre-defined metrics router target.

    • Constraints: The maximum length is 1000 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-._:]+$/.
    id String
    The target uuid for a pre-defined metrics router target.

    • Constraints: The maximum length is 1000 characters. The minimum length is 3 characters. The value must match regular expression /^[a-zA-Z0-9 \\-._:]+$/.

    Import

    You can import the ibm_metrics_router_settings resource by using primary_metadata_region. To store all your meta data in a single region.

    Syntax

    $ pulumi import ibm:index/metricsRouterSettings:MetricsRouterSettings metrics_router_settings <primary_metadata_region>

    Example

    $ pulumi import ibm:index/metricsRouterSettings:MetricsRouterSettings metrics_router_settings us-south

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

    Package Details

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