software.amazon.awscdk.regioninfo

Class Fact

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.regioninfo.Fact

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-21T22:30:56.767Z")
public class Fact
extends software.amazon.jsii.JsiiObject

A database of regional information.

Example:

 public class MyFact implements IFact {
     public final Object region;
     public final Object name;
     public final Object value;
 }
 Fact.register(new MyFact());
 

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Fact(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Fact(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
static java.lang.String	find(java.lang.String region, java.lang.String name) Retrieves a fact from this Fact database.
static java.util.List<java.lang.String>	getRegions()
static void	register(IFact fact) Registers a new fact in this Fact database.
static void	register(IFact fact, java.lang.Boolean allowReplacing) Registers a new fact in this Fact database.
static java.lang.String	requireFact(java.lang.String region, java.lang.String name) Retrieve a fact from the Fact database.
static void	unregister(java.lang.String region, java.lang.String name) Removes a fact from the database.
static void	unregister(java.lang.String region, java.lang.String name, java.lang.String value) Removes a fact from the database.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Fact

protected Fact(software.amazon.jsii.JsiiObjectRef objRef)

Fact

protected Fact(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Method Detail

find

public static java.lang.String find(java.lang.String region,
                                    java.lang.String name)

Retrieves a fact from this Fact database.

Parameters:

region - the name of the region (e.g: `us-east-1`). This parameter is required.

name - the name of the fact being looked up (see the `FactName` class for details). This parameter is required.

Returns:

the fact value if it is known, and `undefined` otherwise.

register

public static void register(IFact fact,
                            java.lang.Boolean allowReplacing)

Registers a new fact in this Fact database.

Parameters:

fact - the new fact to be registered. This parameter is required.

allowReplacing - whether new facts can replace existing facts or not.

register

public static void register(IFact fact)

Registers a new fact in this Fact database.

Parameters:

fact - the new fact to be registered. This parameter is required.

requireFact

public static java.lang.String requireFact(java.lang.String region,
                                           java.lang.String name)

Retrieve a fact from the Fact database.

(retrieval will fail if the specified region or fact name does not exist.)

Parameters:

region - the name of the region (e.g: `us-east-1`). This parameter is required.

name - the name of the fact being looked up (see the `FactName` class for details). This parameter is required.

unregister

public static void unregister(java.lang.String region,
                              java.lang.String name,
                              java.lang.String value)

Removes a fact from the database.

Parameters:

region - the region for which the fact is to be removed. This parameter is required.

name - the name of the fact to remove. This parameter is required.

value - the value that should be removed (removal will fail if the value is specified, but does not match the current stored value).

unregister

public static void unregister(java.lang.String region,
                              java.lang.String name)

Removes a fact from the database.

Parameters:

region - the region for which the fact is to be removed. This parameter is required.

name - the name of the fact to remove. This parameter is required.

getRegions

public static java.util.List<java.lang.String> getRegions()

Returns:

the list of names of AWS regions for which there is at least one registered fact. This may not be an exhaustive list of all available AWS regions.