Skip to content

Latest commit

 

History

History
1427 lines (886 loc) · 60.6 KB

File metadata and controls

1427 lines (886 loc) · 60.6 KB

provider Submodule

Constructs

GithubProvider

Represents a {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs github}.

Initializers

import io.cdktn.providers.github.provider.GithubProvider;

GithubProvider.Builder.create(Construct scope, java.lang.String id)
//  .alias(java.lang.String)
//  .appAuth(GithubProviderAppAuth)
//  .baseUrl(java.lang.String)
//  .cachePath(java.lang.String)
//  .insecure(java.lang.Boolean|IResolvable)
//  .legacyClient(java.lang.Boolean|IResolvable)
//  .maxPerPage(java.lang.Number)
//  .maxRetries(java.lang.Number)
//  .organization(java.lang.String)
//  .owner(java.lang.String)
//  .parallelRequests(java.lang.Boolean|IResolvable)
//  .readDelayMs(java.lang.Number)
//  .retryableErrors(java.util.List<java.lang.Number>)
//  .retryDelayMs(java.lang.Number)
//  .token(java.lang.String)
//  .writeDelayMs(java.lang.Number)
    .build();
Name Type Description
scope software.constructs.Construct The scope in which to define this construct.
id java.lang.String The scoped construct ID.
alias java.lang.String Alias name.
appAuth GithubProviderAppAuth app_auth block.
baseUrl java.lang.String The base URL for the GitHub API;
cachePath java.lang.String The path to the cache directory for persisting GitHub API requests between runs;
insecure java.lang.Boolean|io.cdktn.cdktn.IResolvable Allow insecure server connections when using SSL.
legacyClient java.lang.Boolean|io.cdktn.cdktn.IResolvable Use the legacy GitHub client implementation;
maxPerPage java.lang.Number The maximum number of results per page for paginated API requests;
maxRetries java.lang.Number The maximum number of retries for failed requests; this defaults to 3.
organization java.lang.String GitHub organization to manage. This can also be set by the GITHUB_ORGANIZATION environment variable.
owner java.lang.String GitHub organization or user account to manage;
parallelRequests java.lang.Boolean|io.cdktn.cdktn.IResolvable Allow the provider to make parallel API calls;
readDelayMs java.lang.Number The delay in milliseconds between read operations;
retryableErrors java.util.List<java.lang.Number> List of HTTP status codes that should be retried;
retryDelayMs java.lang.Number The delay in milliseconds between retry attempts;
token java.lang.String GitHub OAuth or Personal Access Token (PAT) to use for authentication.
writeDelayMs java.lang.Number The delay in milliseconds between write operations;

scopeRequired
  • Type: software.constructs.Construct

The scope in which to define this construct.


idRequired
  • Type: java.lang.String

The scoped construct ID.

Must be unique amongst siblings in the same scope


aliasOptional
  • Type: java.lang.String

Alias name.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#alias GithubProvider#alias}


appAuthOptional

app_auth block.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#app_auth GithubProvider#app_auth}


baseUrlOptional
  • Type: java.lang.String

The base URL for the GitHub API;

this defaults to the GitHub API URL. If you are using GitHub Enterprise Server (GHES) or GitHub Enterprise Cloud with Data Residency (GHEC-DR), this is required. This can also be set by the GITHUB_BASE_URL environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#base_url GithubProvider#base_url}


cachePathOptional
  • Type: java.lang.String

The path to the cache directory for persisting GitHub API requests between runs;

if not set there will be no caching between runs. This can also be set by the GITHUB_CACHE_PATH environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#cache_path GithubProvider#cache_path}


insecureOptional
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

Allow insecure server connections when using SSL.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#insecure GithubProvider#insecure}


legacyClientOptional
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

Use the legacy GitHub client implementation;

if set to false, the new client implementation is used. This can also be set by the GITHUB_LEGACY_CLIENT environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#legacy_client GithubProvider#legacy_client}


maxPerPageOptional
  • Type: java.lang.Number

The maximum number of results per page for paginated API requests;

this defaults to 100. This can also be set by the GITHUB_MAX_PER_PAGE environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#max_per_page GithubProvider#max_per_page}


maxRetriesOptional
  • Type: java.lang.Number

The maximum number of retries for failed requests; this defaults to 3.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#max_retries GithubProvider#max_retries}


organizationOptional
  • Type: java.lang.String

GitHub organization to manage. This can also be set by the GITHUB_ORGANIZATION environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#organization GithubProvider#organization}


ownerOptional
  • Type: java.lang.String

GitHub organization or user account to manage;

this is required when authenticating using a GitHub App. If the owner is not provided and a token is provided, the provider will attempt to auto-detect the owner associated with the token. This can also be set by the GITHUB_OWNER environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#owner GithubProvider#owner}


parallelRequestsOptional
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

Allow the provider to make parallel API calls;

this is experimental and may cause concurrency and rate limiting issues. This is ignored for the REST API when legacy_client is false since the new client implementation is designed to safely handle parallel requests.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#parallel_requests GithubProvider#parallel_requests}


readDelayMsOptional
  • Type: java.lang.Number

The delay in milliseconds between read operations;

this defaults to 0. This can be used to mitigate rate limiting issues when performing a large number of read operations. This is ignored for the REST API when legacy_client is false since the new client implementation is GitHub rate limit aware.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#read_delay_ms GithubProvider#read_delay_ms}


retryableErrorsOptional
  • Type: java.util.List<java.lang.Number>

List of HTTP status codes that should be retried;

if not set this uses the provider defaults. This setting only applies when max_retries is greater than 0. This is ignored for the REST API when legacy_client is false since the new client implementation handles the retry logic.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#retryable_errors GithubProvider#retryable_errors}


retryDelayMsOptional
  • Type: java.lang.Number

The delay in milliseconds between retry attempts;

this defaults to 1000. This setting only applies when max_retries is greater than 0.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#retry_delay_ms GithubProvider#retry_delay_ms}


tokenOptional
  • Type: java.lang.String

GitHub OAuth or Personal Access Token (PAT) to use for authentication.

This can also be set by the GITHUB_TOKEN environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#token GithubProvider#token}


writeDelayMsOptional
  • Type: java.lang.Number

The delay in milliseconds between write operations;

this defaults to 1000. This is used to mitigate the GitHub API's abuse rate limits when writing. Note that ALL requests to the GraphQL API are implemented as POST requests under the hood, so this setting affects those calls as well. This is ignored for the REST API when legacy_client is false since the new client implementation is GitHub rate limit aware.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#write_delay_ms GithubProvider#write_delay_ms}


Methods

Name Description
toString Returns a string representation of this construct.
with Applies one or more mixins to this construct.
addOverride No description.
overrideLogicalId Overrides the auto-generated logical ID with a specific ID.
resetOverrideLogicalId Resets a previously passed logical Id to use the auto-generated logical id again.
toHclTerraform No description.
toMetadata No description.
toTerraform Adds this resource to the terraform JSON output.
resetAlias No description.
resetAppAuth No description.
resetBaseUrl No description.
resetCachePath No description.
resetInsecure No description.
resetLegacyClient No description.
resetMaxPerPage No description.
resetMaxRetries No description.
resetOrganization No description.
resetOwner No description.
resetParallelRequests No description.
resetReadDelayMs No description.
resetRetryableErrors No description.
resetRetryDelayMs No description.
resetToken No description.
resetWriteDelayMs No description.

toString
public java.lang.String toString()

Returns a string representation of this construct.

with
public IConstruct with(IMixin... mixins)

Applies one or more mixins to this construct.

Mixins are applied in order. The list of constructs is captured at the start of the call, so constructs added by a mixin will not be visited. Use multiple with() calls if subsequent mixins should apply to added constructs.

mixinsRequired
  • Type: software.constructs.IMixin...

The mixins to apply.


addOverride
public void addOverride(java.lang.String path, java.lang.Object value)
pathRequired
  • Type: java.lang.String

valueRequired
  • Type: java.lang.Object

overrideLogicalId
public void overrideLogicalId(java.lang.String newLogicalId)

Overrides the auto-generated logical ID with a specific ID.

newLogicalIdRequired
  • Type: java.lang.String

The new logical ID to use for this stack element.


resetOverrideLogicalId
public void resetOverrideLogicalId()

Resets a previously passed logical Id to use the auto-generated logical id again.

toHclTerraform
public java.lang.Object toHclTerraform()
toMetadata
public java.lang.Object toMetadata()
toTerraform
public java.lang.Object toTerraform()

Adds this resource to the terraform JSON output.

resetAlias
public void resetAlias()
resetAppAuth
public void resetAppAuth()
resetBaseUrl
public void resetBaseUrl()
resetCachePath
public void resetCachePath()
resetInsecure
public void resetInsecure()
resetLegacyClient
public void resetLegacyClient()
resetMaxPerPage
public void resetMaxPerPage()
resetMaxRetries
public void resetMaxRetries()
resetOrganization
public void resetOrganization()
resetOwner
public void resetOwner()
resetParallelRequests
public void resetParallelRequests()
resetReadDelayMs
public void resetReadDelayMs()
resetRetryableErrors
public void resetRetryableErrors()
resetRetryDelayMs
public void resetRetryDelayMs()
resetToken
public void resetToken()
resetWriteDelayMs
public void resetWriteDelayMs()

Static Functions

Name Description
isConstruct Checks if x is a construct.
isTerraformElement No description.
isTerraformProvider No description.
generateConfigForImport Generates CDKTN code for importing a GithubProvider resource upon running "cdktn plan ".

isConstruct
import io.cdktn.providers.github.provider.GithubProvider;

GithubProvider.isConstruct(java.lang.Object x)

Checks if x is a construct.

Use this method instead of instanceof to properly detect Construct instances, even when the construct library is symlinked.

Explanation: in JavaScript, multiple copies of the constructs library on disk are seen as independent, completely different libraries. As a consequence, the class Construct in each copy of the constructs library is seen as a different class, and an instance of one class will not test as instanceof the other class. npm install will not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of the constructs library can be accidentally installed, and instanceof will behave unpredictably. It is safest to avoid using instanceof, and using this type-testing method instead.

xRequired
  • Type: java.lang.Object

Any object.


isTerraformElement
import io.cdktn.providers.github.provider.GithubProvider;

GithubProvider.isTerraformElement(java.lang.Object x)
xRequired
  • Type: java.lang.Object

isTerraformProvider
import io.cdktn.providers.github.provider.GithubProvider;

GithubProvider.isTerraformProvider(java.lang.Object x)
xRequired
  • Type: java.lang.Object

generateConfigForImport
import io.cdktn.providers.github.provider.GithubProvider;

GithubProvider.generateConfigForImport(Construct scope, java.lang.String importToId, java.lang.String importFromId),GithubProvider.generateConfigForImport(Construct scope, java.lang.String importToId, java.lang.String importFromId, TerraformProvider provider)

Generates CDKTN code for importing a GithubProvider resource upon running "cdktn plan ".

scopeRequired
  • Type: software.constructs.Construct

The scope in which to define this construct.


importToIdRequired
  • Type: java.lang.String

The construct id used in the generated config for the GithubProvider to import.


importFromIdRequired
  • Type: java.lang.String

The id of the existing GithubProvider that should be imported.

Refer to the {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#import import section} in the documentation of this resource for the id to use


providerOptional
  • Type: io.cdktn.cdktn.TerraformProvider

? Optional instance of the provider where the GithubProvider to import is found.


Properties

Name Type Description
node software.constructs.Node The tree node.
cdktfStack io.cdktn.cdktn.TerraformStack No description.
fqn java.lang.String No description.
friendlyUniqueId java.lang.String No description.
metaAttributes java.util.Map<java.lang.String, java.lang.Object> No description.
terraformResourceType java.lang.String No description.
terraformGeneratorMetadata io.cdktn.cdktn.TerraformProviderGeneratorMetadata No description.
terraformProviderSource java.lang.String No description.
alias java.lang.String No description.
aliasInput java.lang.String No description.
appAuthInput GithubProviderAppAuth No description.
baseUrlInput java.lang.String No description.
cachePathInput java.lang.String No description.
insecureInput java.lang.Boolean|io.cdktn.cdktn.IResolvable No description.
legacyClientInput java.lang.Boolean|io.cdktn.cdktn.IResolvable No description.
maxPerPageInput java.lang.Number No description.
maxRetriesInput java.lang.Number No description.
organizationInput java.lang.String No description.
ownerInput java.lang.String No description.
parallelRequestsInput java.lang.Boolean|io.cdktn.cdktn.IResolvable No description.
readDelayMsInput java.lang.Number No description.
retryableErrorsInput java.util.List<java.lang.Number> No description.
retryDelayMsInput java.lang.Number No description.
tokenInput java.lang.String No description.
writeDelayMsInput java.lang.Number No description.
appAuth GithubProviderAppAuth No description.
baseUrl java.lang.String No description.
cachePath java.lang.String No description.
insecure java.lang.Boolean|io.cdktn.cdktn.IResolvable No description.
legacyClient java.lang.Boolean|io.cdktn.cdktn.IResolvable No description.
maxPerPage java.lang.Number No description.
maxRetries java.lang.Number No description.
organization java.lang.String No description.
owner java.lang.String No description.
parallelRequests java.lang.Boolean|io.cdktn.cdktn.IResolvable No description.
readDelayMs java.lang.Number No description.
retryableErrors java.util.List<java.lang.Number> No description.
retryDelayMs java.lang.Number No description.
token java.lang.String No description.
writeDelayMs java.lang.Number No description.

nodeRequired
public Node getNode();
  • Type: software.constructs.Node

The tree node.


cdktfStackRequired
public TerraformStack getCdktfStack();
  • Type: io.cdktn.cdktn.TerraformStack

fqnRequired
public java.lang.String getFqn();
  • Type: java.lang.String

friendlyUniqueIdRequired
public java.lang.String getFriendlyUniqueId();
  • Type: java.lang.String

metaAttributesRequired
public java.util.Map<java.lang.String, java.lang.Object> getMetaAttributes();
  • Type: java.util.Map<java.lang.String, java.lang.Object>

terraformResourceTypeRequired
public java.lang.String getTerraformResourceType();
  • Type: java.lang.String

terraformGeneratorMetadataOptional
public TerraformProviderGeneratorMetadata getTerraformGeneratorMetadata();
  • Type: io.cdktn.cdktn.TerraformProviderGeneratorMetadata

terraformProviderSourceOptional
public java.lang.String getTerraformProviderSource();
  • Type: java.lang.String

aliasOptional
public java.lang.String getAlias();
  • Type: java.lang.String

aliasInputOptional
public java.lang.String getAliasInput();
  • Type: java.lang.String

appAuthInputOptional
public GithubProviderAppAuth getAppAuthInput();

baseUrlInputOptional
public java.lang.String getBaseUrlInput();
  • Type: java.lang.String

cachePathInputOptional
public java.lang.String getCachePathInput();
  • Type: java.lang.String

insecureInputOptional
public java.lang.Boolean|IResolvable getInsecureInput();
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

legacyClientInputOptional
public java.lang.Boolean|IResolvable getLegacyClientInput();
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

maxPerPageInputOptional
public java.lang.Number getMaxPerPageInput();
  • Type: java.lang.Number

maxRetriesInputOptional
public java.lang.Number getMaxRetriesInput();
  • Type: java.lang.Number

organizationInputOptional
public java.lang.String getOrganizationInput();
  • Type: java.lang.String

ownerInputOptional
public java.lang.String getOwnerInput();
  • Type: java.lang.String

parallelRequestsInputOptional
public java.lang.Boolean|IResolvable getParallelRequestsInput();
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

readDelayMsInputOptional
public java.lang.Number getReadDelayMsInput();
  • Type: java.lang.Number

retryableErrorsInputOptional
public java.util.List<java.lang.Number> getRetryableErrorsInput();
  • Type: java.util.List<java.lang.Number>

retryDelayMsInputOptional
public java.lang.Number getRetryDelayMsInput();
  • Type: java.lang.Number

tokenInputOptional
public java.lang.String getTokenInput();
  • Type: java.lang.String

writeDelayMsInputOptional
public java.lang.Number getWriteDelayMsInput();
  • Type: java.lang.Number

appAuthOptional
public GithubProviderAppAuth getAppAuth();

baseUrlOptional
public java.lang.String getBaseUrl();
  • Type: java.lang.String

cachePathOptional
public java.lang.String getCachePath();
  • Type: java.lang.String

insecureOptional
public java.lang.Boolean|IResolvable getInsecure();
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

legacyClientOptional
public java.lang.Boolean|IResolvable getLegacyClient();
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

maxPerPageOptional
public java.lang.Number getMaxPerPage();
  • Type: java.lang.Number

maxRetriesOptional
public java.lang.Number getMaxRetries();
  • Type: java.lang.Number

organizationOptional
public java.lang.String getOrganization();
  • Type: java.lang.String

ownerOptional
public java.lang.String getOwner();
  • Type: java.lang.String

parallelRequestsOptional
public java.lang.Boolean|IResolvable getParallelRequests();
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

readDelayMsOptional
public java.lang.Number getReadDelayMs();
  • Type: java.lang.Number

retryableErrorsOptional
public java.util.List<java.lang.Number> getRetryableErrors();
  • Type: java.util.List<java.lang.Number>

retryDelayMsOptional
public java.lang.Number getRetryDelayMs();
  • Type: java.lang.Number

tokenOptional
public java.lang.String getToken();
  • Type: java.lang.String

writeDelayMsOptional
public java.lang.Number getWriteDelayMs();
  • Type: java.lang.Number

Constants

Name Type Description
tfResourceType java.lang.String No description.

tfResourceTypeRequired
public java.lang.String getTfResourceType();
  • Type: java.lang.String

Structs

GithubProviderAppAuth

Initializer

import io.cdktn.providers.github.provider.GithubProviderAppAuth;

GithubProviderAppAuth.builder()
    .id(java.lang.String)
    .installationId(java.lang.String)
    .pemFile(java.lang.String)
    .build();

Properties

Name Type Description
id java.lang.String The GitHub App's identifier. This can also be set by the GITHUB_APP_ID environment variable.
installationId java.lang.String The GitHub App's installation identifier. This can also be set by the GITHUB_APP_INSTALLATION_ID environment variable.
pemFile java.lang.String The GitHub App's PEM file content;

idRequired
public java.lang.String getId();
  • Type: java.lang.String

The GitHub App's identifier. This can also be set by the GITHUB_APP_ID environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#id GithubProvider#id}

Please be aware that the id field is automatically added to all resources in Terraform providers using a Terraform provider SDK version below 2. If you experience problems setting this value it might not be settable. Please take a look at the provider documentation to ensure it should be settable.


installationIdRequired
public java.lang.String getInstallationId();
  • Type: java.lang.String

The GitHub App's installation identifier. This can also be set by the GITHUB_APP_INSTALLATION_ID environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#installation_id GithubProvider#installation_id}


pemFileRequired
public java.lang.String getPemFile();
  • Type: java.lang.String

The GitHub App's PEM file content;

\n can be used for newlines. This can also be set by the GITHUB_APP_PEM_FILE environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#pem_file GithubProvider#pem_file}


GithubProviderConfig

Initializer

import io.cdktn.providers.github.provider.GithubProviderConfig;

GithubProviderConfig.builder()
//  .alias(java.lang.String)
//  .appAuth(GithubProviderAppAuth)
//  .baseUrl(java.lang.String)
//  .cachePath(java.lang.String)
//  .insecure(java.lang.Boolean|IResolvable)
//  .legacyClient(java.lang.Boolean|IResolvable)
//  .maxPerPage(java.lang.Number)
//  .maxRetries(java.lang.Number)
//  .organization(java.lang.String)
//  .owner(java.lang.String)
//  .parallelRequests(java.lang.Boolean|IResolvable)
//  .readDelayMs(java.lang.Number)
//  .retryableErrors(java.util.List<java.lang.Number>)
//  .retryDelayMs(java.lang.Number)
//  .token(java.lang.String)
//  .writeDelayMs(java.lang.Number)
    .build();

Properties

Name Type Description
alias java.lang.String Alias name.
appAuth GithubProviderAppAuth app_auth block.
baseUrl java.lang.String The base URL for the GitHub API;
cachePath java.lang.String The path to the cache directory for persisting GitHub API requests between runs;
insecure java.lang.Boolean|io.cdktn.cdktn.IResolvable Allow insecure server connections when using SSL.
legacyClient java.lang.Boolean|io.cdktn.cdktn.IResolvable Use the legacy GitHub client implementation;
maxPerPage java.lang.Number The maximum number of results per page for paginated API requests;
maxRetries java.lang.Number The maximum number of retries for failed requests; this defaults to 3.
organization java.lang.String GitHub organization to manage. This can also be set by the GITHUB_ORGANIZATION environment variable.
owner java.lang.String GitHub organization or user account to manage;
parallelRequests java.lang.Boolean|io.cdktn.cdktn.IResolvable Allow the provider to make parallel API calls;
readDelayMs java.lang.Number The delay in milliseconds between read operations;
retryableErrors java.util.List<java.lang.Number> List of HTTP status codes that should be retried;
retryDelayMs java.lang.Number The delay in milliseconds between retry attempts;
token java.lang.String GitHub OAuth or Personal Access Token (PAT) to use for authentication.
writeDelayMs java.lang.Number The delay in milliseconds between write operations;

aliasOptional
public java.lang.String getAlias();
  • Type: java.lang.String

Alias name.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#alias GithubProvider#alias}


appAuthOptional
public GithubProviderAppAuth getAppAuth();

app_auth block.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#app_auth GithubProvider#app_auth}


baseUrlOptional
public java.lang.String getBaseUrl();
  • Type: java.lang.String

The base URL for the GitHub API;

this defaults to the GitHub API URL. If you are using GitHub Enterprise Server (GHES) or GitHub Enterprise Cloud with Data Residency (GHEC-DR), this is required. This can also be set by the GITHUB_BASE_URL environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#base_url GithubProvider#base_url}


cachePathOptional
public java.lang.String getCachePath();
  • Type: java.lang.String

The path to the cache directory for persisting GitHub API requests between runs;

if not set there will be no caching between runs. This can also be set by the GITHUB_CACHE_PATH environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#cache_path GithubProvider#cache_path}


insecureOptional
public java.lang.Boolean|IResolvable getInsecure();
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

Allow insecure server connections when using SSL.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#insecure GithubProvider#insecure}


legacyClientOptional
public java.lang.Boolean|IResolvable getLegacyClient();
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

Use the legacy GitHub client implementation;

if set to false, the new client implementation is used. This can also be set by the GITHUB_LEGACY_CLIENT environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#legacy_client GithubProvider#legacy_client}


maxPerPageOptional
public java.lang.Number getMaxPerPage();
  • Type: java.lang.Number

The maximum number of results per page for paginated API requests;

this defaults to 100. This can also be set by the GITHUB_MAX_PER_PAGE environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#max_per_page GithubProvider#max_per_page}


maxRetriesOptional
public java.lang.Number getMaxRetries();
  • Type: java.lang.Number

The maximum number of retries for failed requests; this defaults to 3.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#max_retries GithubProvider#max_retries}


organizationOptional
public java.lang.String getOrganization();
  • Type: java.lang.String

GitHub organization to manage. This can also be set by the GITHUB_ORGANIZATION environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#organization GithubProvider#organization}


ownerOptional
public java.lang.String getOwner();
  • Type: java.lang.String

GitHub organization or user account to manage;

this is required when authenticating using a GitHub App. If the owner is not provided and a token is provided, the provider will attempt to auto-detect the owner associated with the token. This can also be set by the GITHUB_OWNER environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#owner GithubProvider#owner}


parallelRequestsOptional
public java.lang.Boolean|IResolvable getParallelRequests();
  • Type: java.lang.Boolean|io.cdktn.cdktn.IResolvable

Allow the provider to make parallel API calls;

this is experimental and may cause concurrency and rate limiting issues. This is ignored for the REST API when legacy_client is false since the new client implementation is designed to safely handle parallel requests.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#parallel_requests GithubProvider#parallel_requests}


readDelayMsOptional
public java.lang.Number getReadDelayMs();
  • Type: java.lang.Number

The delay in milliseconds between read operations;

this defaults to 0. This can be used to mitigate rate limiting issues when performing a large number of read operations. This is ignored for the REST API when legacy_client is false since the new client implementation is GitHub rate limit aware.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#read_delay_ms GithubProvider#read_delay_ms}


retryableErrorsOptional
public java.util.List<java.lang.Number> getRetryableErrors();
  • Type: java.util.List<java.lang.Number>

List of HTTP status codes that should be retried;

if not set this uses the provider defaults. This setting only applies when max_retries is greater than 0. This is ignored for the REST API when legacy_client is false since the new client implementation handles the retry logic.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#retryable_errors GithubProvider#retryable_errors}


retryDelayMsOptional
public java.lang.Number getRetryDelayMs();
  • Type: java.lang.Number

The delay in milliseconds between retry attempts;

this defaults to 1000. This setting only applies when max_retries is greater than 0.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#retry_delay_ms GithubProvider#retry_delay_ms}


tokenOptional
public java.lang.String getToken();
  • Type: java.lang.String

GitHub OAuth or Personal Access Token (PAT) to use for authentication.

This can also be set by the GITHUB_TOKEN environment variable.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#token GithubProvider#token}


writeDelayMsOptional
public java.lang.Number getWriteDelayMs();
  • Type: java.lang.Number

The delay in milliseconds between write operations;

this defaults to 1000. This is used to mitigate the GitHub API's abuse rate limits when writing. Note that ALL requests to the GraphQL API are implemented as POST requests under the hood, so this setting affects those calls as well. This is ignored for the REST API when legacy_client is false since the new client implementation is GitHub rate limit aware.

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/integrations/github/6.13.0/docs#write_delay_ms GithubProvider#write_delay_ms}