Documentation
Reference lookups for the emulated partition: its regions, supported instance types, versions, models, endpoints, and service principals, and the trust policy for a self-managed IAM role.
List service endpoints
Returns the hostname of each supported service endpoint in each region of the active emulated partition, keyed by region ID and then by the endpoint's display name (for example EC2 or S3 Control). An endpoint prefix that the region does not support is left out. Returns an empty object when no partition is active.
List supported VPC endpoint service names
Returns the supported VPC endpoint service names for each region of the active emulated partition, in alphabetical order of region ID, written as the emulated partition names them. In each configured name, a leading * becomes com.amazonaws. followed by the region ID, any other * is replaced by the region ID, and the prefix of a service that the emulated partition names with its own prefix is replaced by that prefix (for example gov.ic.c2s.us-iso-east-1.autoscaling). A region with no names configured has an empty list. Returns an empty array when no partition is active.
List supported instance types
Returns the supported instance types for EC2, ElastiCache, RDS, and EMR in the active emulated partition, one entry for each service, grouped by instance family. Each region's list is read from its per-Region Configuration Value, such as combine.endpoints.aws.metadata.ec2.supportedTypes.us-iso-east-1. Returns an empty array when no partition is active.
List supported Bedrock models
Returns the supported Bedrock models for the active emulated environment, both as a union and for each Region. Each Region's list is read from its per-Region Configuration Value, such as combine.endpoints.aws.metadata.bedrock.supportedModels.us-iso-east-1. Returns an empty array when no partition is active.
List supported EKS cluster versions
Returns the supported EKS cluster versions for the active emulated partition: the partition's list, or the list in its override Configuration Value (such as combine.endpoints.aws.filter.eks.clusterVersion.aws_c2s.override.versions.allowed) when that is set, without any version listed in the matching .except Configuration Value. Returns an empty array when no partition is active.
List supported RDS engine versions
Returns the supported RDS engine versions for each engine of the active emulated partition, in no guaranteed order. An engine's list is the partition's list, or the list in its override Configuration Value (such as combine.endpoints.aws.filter.rds.engineVersion.aws_c2s.engine.mysql.override.supportedVersions) when that is set. Returns an empty array when no partition is active.
Get the emulated partition details
Returns the AWS partition ID, endpoint domain, and root region of the active emulated partition, and the host region that each of its regions is mapped to. Returns an empty object when no partition is active. Available to any authenticated user.
Get the trust policy for a self-managed IAM role
Returns the IAM trust policy statement that a self-managed IAM role needs so that Combine can assume it. The statement trusts the deployment's Combine Endpoints role and, when a User Management Account is configured, that account's follower principal (or its root when no follower principal is set). Returns an empty object when the statement could not be built. Available to any authenticated user.
List supported ElastiCache engine versions
Returns the supported ElastiCache engine versions of the active emulated partition for the memcached, redis, and valkey engines, in that order. Each list is read from a Configuration Value such as combine.endpoints.aws.metadata.elasticache.engineVersion.aws_c2s.engine.redis.versions. An engine with no versions configured is omitted. Returns an empty array when no partition is active.
List supported Lambda runtimes
Returns the supported Lambda runtimes of the active emulated partition. Returns an empty array when no partition is active.
List supported FIPS endpoints
Returns the services that have a FIPS endpoint in the active emulated partition, and the FIPS endpoint hostnames of each region by service. When a region's override Configuration Value (such as combine.endpoints.aws.metadata.serviceEndpoints.fips.supported.override.us-iso-east-1) is set, the region's supported services that it names are listed. Otherwise, the region's supported services that are in its FIPS endpoint list are listed, or every supported service when the region does not enforce that list. Returns an empty array when no partition is active.
List service principal suffixes
Returns the service principal domain suffixes of the active emulated partition and the services whose service principal uses the partition's suffix. Returns an empty array when no partition is active, or when the partition has no service that uses its suffix (servicePrincipalsWithSuffix, servicePrincipalsWithSuffixOptional, and servicePrincipalsWithOptionalSuffixOverride are all empty).