1. Docs
  2. Reference
  3. API
  4. @pulumi/consul
  5. types
  6. input

Module types/input

APIs

APIs

interface AclRoleServiceIdentity

interface AclRoleServiceIdentity

property datacenters

datacenters?: pulumi.Input<pulumi.Input<string>[]>;

The datacenters the effective policy is valid within.

property serviceName

serviceName: pulumi.Input<string>;

The name of the service.

interface CatalogEntryService

interface CatalogEntryService

property address

address?: pulumi.Input<string>;

The address of the service. Defaults to the node address.

property id

id?: pulumi.Input<string>;

The ID of the service. Defaults to the name.

property name

name: pulumi.Input<string>;

The name of the service

property port

port?: pulumi.Input<number>;

The port of the service.

property tags

tags?: pulumi.Input<pulumi.Input<string>[]>;

A list of values that are opaque to Consul, but can be used to distinguish between services or nodes.

interface GetAclRolePolicy

interface GetAclRolePolicy

property id

id?: undefined | string;

property name

name?: undefined | string;

The name of the ACL Role.

interface GetAclRoleServiceIdentity

interface GetAclRoleServiceIdentity

property datacenters

datacenters?: string[];

property serviceName

serviceName?: undefined | string;

interface GetAclTokenPolicy

interface GetAclTokenPolicy

property id

id?: undefined | string;

property name

name?: undefined | string;

interface GetCatalogNodesQueryOption

interface GetCatalogNodesQueryOption

property allowStale

allowStale?: undefined | false | true;

property datacenter

datacenter?: undefined | string;

property near

near?: undefined | string;

property nodeMeta

nodeMeta?: undefined | {[key: string]: string};

property requireConsistent

requireConsistent?: undefined | false | true;

property token

token?: undefined | string;

property waitIndex

waitIndex?: undefined | number;

property waitTime

waitTime?: undefined | string;

interface GetCatalogServiceQueryOption

interface GetCatalogServiceQueryOption

property allowStale

allowStale?: undefined | false | true;

property datacenter

datacenter?: undefined | string;

property namespace

namespace?: undefined | string;

property near

near?: undefined | string;

property nodeMeta

nodeMeta?: undefined | {[key: string]: string};

property requireConsistent

requireConsistent?: undefined | false | true;

property token

token?: undefined | string;

property waitIndex

waitIndex?: undefined | number;

property waitTime

waitTime?: undefined | string;

interface GetCatalogServicesQueryOption

interface GetCatalogServicesQueryOption

property allowStale

allowStale?: undefined | false | true;

property datacenter

datacenter?: undefined | string;

property namespace

namespace?: undefined | string;

property near

near?: undefined | string;

property nodeMeta

nodeMeta?: undefined | {[key: string]: string};

property requireConsistent

requireConsistent?: undefined | false | true;

property token

token?: undefined | string;

property waitIndex

waitIndex?: undefined | number;

property waitTime

waitTime?: undefined | string;

interface GetKeyPrefixSubkeyCollection

interface GetKeyPrefixSubkeyCollection

property default

default?: undefined | string;

This is the default value to set for var.<name> if the key does not exist in Consul. Defaults to an empty string.

property name

name: string;

This is the name of the key. This value of the key is exposed as var.<name>. This is not the path of the subkey in Consul.

property path

path: string;

This is the subkey path in Consul (which will be appended to the given pathPrefix) to construct the full key that will be used to read the value.

interface GetKeysKey

interface GetKeysKey

property default

default?: undefined | string;

This is the default value to set for var.<name> if the key does not exist in Consul. Defaults to an empty string.

property name

name: string;

This is the name of the key. This value of the key is exposed as var.<name>. This is not the path of the key in Consul.

property path

path: string;

This is the path in Consul that should be read or written to.

interface GetNodesQueryOption

interface GetNodesQueryOption

property allowStale

allowStale?: undefined | false | true;

When true, the default, allow responses from Consul servers that are followers.

property datacenter

datacenter?: undefined | string;

The Consul datacenter to query. Defaults to the same value found in queryOptions parameter specified below, or if that is empty, the datacenter value found in the Consul agent that this provider is configured to talk to then the datacenter in the provider setup.

property near

near?: undefined | string;

property nodeMeta

nodeMeta?: undefined | {[key: string]: string};

property requireConsistent

requireConsistent?: undefined | false | true;

When true force the client to perform a read on at least quorum servers and verify the result is the same. Defaults to false.

property token

token?: undefined | string;

Specify the Consul ACL token to use when performing the request. This defaults to the same API token configured by the consul provider but may be overriden if necessary.

property waitIndex

waitIndex?: undefined | number;

Index number used to enable blocking quereis.

property waitTime

waitTime?: undefined | string;

Max time the client should wait for a blocking query to return.

interface GetServiceQueryOption

interface GetServiceQueryOption

property allowStale

allowStale?: undefined | false | true;

When true, the default, allow responses from Consul servers that are followers.

property datacenter

datacenter?: undefined | string;

The Consul datacenter to query. Defaults to the same value found in queryOptions parameter specified below, or if that is empty, the datacenter value found in the Consul agent that this provider is configured to talk to.

property namespace

namespace?: undefined | string;

The namespace to lookup the service.

property near

near?: undefined | string;

property nodeMeta

nodeMeta?: undefined | {[key: string]: string};

property requireConsistent

requireConsistent?: undefined | false | true;

When true force the client to perform a read on at least quorum servers and verify the result is the same. Defaults to false.

property token

token?: undefined | string;

Specify the Consul ACL token to use when performing the request. This defaults to the same API token configured by the consul provider but may be overriden if necessary.

property waitIndex

waitIndex?: undefined | number;

Index number used to enable blocking quereis.

property waitTime

waitTime?: undefined | string;

Max time the client should wait for a blocking query to return.

interface GetServicesQueryOption

interface GetServicesQueryOption

property allowStale

allowStale?: undefined | false | true;

When true, the default, allow responses from Consul servers that are followers.

property datacenter

datacenter?: undefined | string;

The Consul datacenter to query. Defaults to the same value found in queryOptions parameter specified below, or if that is empty, the datacenter value found in the Consul agent that this provider is configured to talk to.

property namespace

namespace?: undefined | string;

The namespace to lookup the services.

property near

near?: undefined | string;

property nodeMeta

nodeMeta?: undefined | {[key: string]: string};

property requireConsistent

requireConsistent?: undefined | false | true;

When true force the client to perform a read on at least quorum servers and verify the result is the same. Defaults to false.

property token

token?: undefined | string;

Specify the Consul ACL token to use when performing the request. This defaults to the same API token configured by the consul provider but may be overriden if necessary.

property waitIndex

waitIndex?: undefined | number;

Index number used to enable blocking quereis.

property waitTime

waitTime?: undefined | string;

Max time the client should wait for a blocking query to return.

interface KeyPrefixSubkeyCollection

interface KeyPrefixSubkeyCollection

property flags

flags?: pulumi.Input<number>;

An unsigned integer value to attach to the key (defaults to 0).

property path

path: pulumi.Input<string>;

This is the path (which will be appended to the given pathPrefix) in Consul that should be written to.

property value

value: pulumi.Input<string>;

The value to write to the given path.

interface KeysKey

interface KeysKey

property default

default?: pulumi.Input<string>;

property delete

delete?: pulumi.Input<boolean>;

If true, then the key will be deleted when either its configuration block is removed from the configuration or the entire resource is destroyed. Otherwise, it will be left in Consul. Defaults to false.

property flags

flags?: pulumi.Input<number>;

An unsigned integer value to attach to the key (defaults to 0).

property name

name?: pulumi.Input<string>;

property path

path: pulumi.Input<string>;

This is the path in Consul that should be written to.

property value

value?: pulumi.Input<string>;

The value to write to the given path.

interface PreparedQueryDns

interface PreparedQueryDns

property ttl

ttl?: pulumi.Input<string>;

The TTL to send when returning DNS results.

interface PreparedQueryFailover

interface PreparedQueryFailover

property datacenters

datacenters?: pulumi.Input<pulumi.Input<string>[]>;

Remote datacenters to return results from.

property nearestN

nearestN?: pulumi.Input<number>;

Return results from this many datacenters, sorted in ascending order of estimated RTT.

interface PreparedQueryTemplate

interface PreparedQueryTemplate

property regexp

regexp: pulumi.Input<string>;

The regular expression to match with. When using namePrefixMatch, this regex is applied against the query name.

property type

type: pulumi.Input<string>;

The type of template matching to perform. Currently only namePrefixMatch is supported.

interface ServiceCheck

interface ServiceCheck

property checkId

checkId: pulumi.Input<string>;

An ID, unique per agent. Will default to name if not set.

property deregisterCriticalServiceAfter

deregisterCriticalServiceAfter?: pulumi.Input<string>;

The time after which the service is automatically deregistered when in the critical state. Defaults to 30s.

property headers

headers?: pulumi.Input<pulumi.Input<ServiceCheckHeader>[]>;

The headers to send for an HTTP check. The attributes of each header is given below.

property http

http?: pulumi.Input<string>;

The HTTP endpoint to call for an HTTP check.

property interval

interval: pulumi.Input<string>;

The interval to wait between each health-check invocation.

property method

method?: pulumi.Input<string>;

The method to use for HTTP health-checks. Defaults to GET.

property name

name: pulumi.Input<string>;

The name of the health-check.

property notes

notes?: pulumi.Input<string>;

An opaque field meant to hold human readable text.

property status

status?: pulumi.Input<string>;

The initial health-check status.

property tcp

tcp?: pulumi.Input<string>;

The TCP address and port to connect to for a TCP check.

property timeout

timeout: pulumi.Input<string>;

The timeout value for HTTP checks.

property tlsSkipVerify

tlsSkipVerify?: pulumi.Input<boolean>;

Whether to deactivate certificate verification for HTTP health-checks. Defaults to false.

interface ServiceCheckHeader

interface ServiceCheckHeader

property name

name: pulumi.Input<string>;

The name of the header.

property values

values: pulumi.Input<pulumi.Input<string>[]>;

The header’s list of values.