kongctl adopt konnect

Uses: kongctl
Related Documentation
Related Resources

Adopt Konnect resources.

Command usage

Usage:
  kongctl adopt konnect [flags]
  kongctl adopt konnect [command]

Aliases:
  konnect, k, K

Examples:
  # Retrieve the Konnect Kong Gateway control planes from the current organization
  kongctl get konnect gateway control-planes

Available Commands:
  analytics     Adopt Konnect Analytics resources into namespace management
  api           Adopt an existing Konnect API into namespace management
  auth-strategy Adopt an existing Konnect auth strategy into namespace management
  control-plane Adopt an existing Konnect control plane into namespace management
  dcr-provider  Adopt an existing Konnect DCR provider into namespace management
  event-gateway Adopt an existing Konnect Event Gateway Control Plane into namespace management
  organization  Adopt organization resources into namespace management
  portal        Adopt an existing Konnect portal into namespace management


Flags:
      --base-url string       Base URL for Konnect API requests.
                              - Config path: [ konnect.base-url ]
                              - Default   : [ https://us.api.konghq.com ]
      --color-theme string    Configures the CLI UI/theme (prompt, tables, TUI elements).
                              - Config path: [ color-theme ]
                              - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                              - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string    Path to the configuration file to load.
                              - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -h, --help                  help for konnect
      --log-file string       Write execution logs to the specified file instead of STDERR.
                              - Config path: [ log-file ]
      --log-level string      Configures the logging level. Execution logs are written to STDERR.
                              - Config path: [ log-level ]
                              - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --namespace string      Namespace label to apply to the resource (required)
      --no-telemetry          Disable telemetry for this command invocation. Overrides config and env.
                              - Config path: [ telemetry.enabled ]
                              - Env var    : [ KONGCTL_NO_TELEMETRY ]
                              - Default    : [ false ]
  -o, --output string         Configures the format of data written to STDOUT.
                              - Config path: [ output ]
                              - Allowed    : [ json|yaml|text ] (default "text")
      --overwrite-namespace   Overwrite an existing namespace label on the resource
      --pat string            Konnect Personal Access Token (PAT) used to authenticate the CLI. 
                              Setting this value overrides tokens obtained from the login command.
                              - Config path: [ konnect.pat ]
  -p, --profile string        Specify the profile to use for this command. (default "default")
      --region string         Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                              - Config path: [ konnect.region ]

Use "kongctl adopt konnect [command] --help" for more information about a command.

kongctl adopt konnect analytics

The analytics command adopts Konnect Observability resources into namespace management.

Usage:
  kongctl adopt konnect analytics [flags]
  kongctl adopt konnect analytics [command]

Aliases:
  analytics, analytic

Examples:
  # Adopt a dashboard by ID
  kongctl adopt analytics dashboard 22cd8a0b-72e7-4212-9099-0764f8e9c5ac --namespace analytics
  # Adopt a dashboard using explicit konnect product
  kongctl adopt konnect analytics dashboard 22cd8a0b-72e7-4212-9099-0764f8e9c5ac --namespace analytics

Available Commands:
  dashboard   Adopt an existing Konnect dashboard into namespace management


Flags:
      --base-url string       Base URL for Konnect API requests.
                              - Config path: [ konnect.base-url ]
                              - Default   : [ https://us.api.konghq.com ]
      --color-theme string    Configures the CLI UI/theme (prompt, tables, TUI elements).
                              - Config path: [ color-theme ]
                              - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                              - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string    Path to the configuration file to load.
                              - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -h, --help                  help for analytics
      --log-file string       Write execution logs to the specified file instead of STDERR.
                              - Config path: [ log-file ]
      --log-level string      Configures the logging level. Execution logs are written to STDERR.
                              - Config path: [ log-level ]
                              - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --namespace string      Namespace label to apply to the resource (required)
      --no-telemetry          Disable telemetry for this command invocation. Overrides config and env.
                              - Config path: [ telemetry.enabled ]
                              - Env var    : [ KONGCTL_NO_TELEMETRY ]
                              - Default    : [ false ]
  -o, --output string         Configures the format of data written to STDOUT.
                              - Config path: [ output ]
                              - Allowed    : [ json|yaml|text ] (default "text")
      --overwrite-namespace   Overwrite an existing namespace label on the resource
      --pat string            Konnect Personal Access Token (PAT) used to authenticate the CLI.
                              Setting this value overrides tokens obtained from the login command.
                              - Config path: [ konnect.pat ]
  -p, --profile string        Specify the profile to use for this command. (default "default")
      --region string         Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                              - Config path: [ konnect.region ]

Use "kongctl adopt konnect analytics [command] --help" for more information about a command.

kongctl adopt konnect api

Adopt Konnect APIs.

Usage:
  kongctl adopt konnect api <api-id|api-name> [flags]


Flags:
      --base-url string       Base URL for Konnect API requests.
                              - Config path: [ konnect.base-url ]
                              - Default   : [ https://us.api.konghq.com ]
      --color-theme string    Configures the CLI UI/theme (prompt, tables, TUI elements).
                              - Config path: [ color-theme ]
                              - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                              - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string    Path to the configuration file to load.
                              - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -h, --help                  help for api
      --log-file string       Write execution logs to the specified file instead of STDERR.
                              - Config path: [ log-file ]
      --log-level string      Configures the logging level. Execution logs are written to STDERR.
                              - Config path: [ log-level ]
                              - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --namespace string      Namespace label to apply to the resource (required)
      --no-telemetry          Disable telemetry for this command invocation. Overrides config and env.
                              - Config path: [ telemetry.enabled ]
                              - Env var    : [ KONGCTL_NO_TELEMETRY ]
                              - Default    : [ false ]
  -o, --output string         Configures the format of data written to STDOUT.
                              - Config path: [ output ]
                              - Allowed    : [ json|yaml|text ] (default "text")
      --overwrite-namespace   Overwrite an existing namespace label on the resource
      --pat string            Konnect Personal Access Token (PAT) used to authenticate the CLI. 
                              Setting this value overrides tokens obtained from the login command.
                              - Config path: [ konnect.pat ]
  -p, --profile string        Specify the profile to use for this command. (default "default")
      --region string         Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                              - Config path: [ konnect.region ]

kongctl adopt konnect auth-strategy

Adopt Konnect authentication strategies.

Usage:
  kongctl adopt konnect auth-strategy <auth-strategy-id|auth-strategy-name> [flags]


Flags:
      --base-url string       Base URL for Konnect API requests.
                              - Config path: [ konnect.base-url ]
                              - Default   : [ https://us.api.konghq.com ]
      --color-theme string    Configures the CLI UI/theme (prompt, tables, TUI elements).
                              - Config path: [ color-theme ]
                              - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                              - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string    Path to the configuration file to load.
                              - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -h, --help                  help for auth-strategy
      --log-file string       Write execution logs to the specified file instead of STDERR.
                              - Config path: [ log-file ]
      --log-level string      Configures the logging level. Execution logs are written to STDERR.
                              - Config path: [ log-level ]
                              - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --namespace string      Namespace label to apply to the resource (required)
      --no-telemetry          Disable telemetry for this command invocation. Overrides config and env.
                              - Config path: [ telemetry.enabled ]
                              - Env var    : [ KONGCTL_NO_TELEMETRY ]
                              - Default    : [ false ]
  -o, --output string         Configures the format of data written to STDOUT.
                              - Config path: [ output ]
                              - Allowed    : [ json|yaml|text ] (default "text")
      --overwrite-namespace   Overwrite an existing namespace label on the resource
      --pat string            Konnect Personal Access Token (PAT) used to authenticate the CLI. 
                              Setting this value overrides tokens obtained from the login command.
                              - Config path: [ konnect.pat ]
  -p, --profile string        Specify the profile to use for this command. (default "default")
      --region string         Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                              - Config path: [ konnect.region ]

kongctl adopt konnect control-plane

Adopt Konnect control plane configuration.

Usage:
  kongctl adopt konnect control-plane <control-plane-id|control-plane-name> [flags]


Flags:
      --base-url string       Base URL for Konnect API requests.
                              - Config path: [ konnect.base-url ]
                              - Default   : [ https://us.api.konghq.com ]
      --color-theme string    Configures the CLI UI/theme (prompt, tables, TUI elements).
                              - Config path: [ color-theme ]
                              - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                              - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string    Path to the configuration file to load.
                              - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -h, --help                  help for control-plane
      --log-file string       Write execution logs to the specified file instead of STDERR.
                              - Config path: [ log-file ]
      --log-level string      Configures the logging level. Execution logs are written to STDERR.
                              - Config path: [ log-level ]
                              - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --namespace string      Namespace label to apply to the resource (required)
      --no-telemetry          Disable telemetry for this command invocation. Overrides config and env.
                              - Config path: [ telemetry.enabled ]
                              - Env var    : [ KONGCTL_NO_TELEMETRY ]
                              - Default    : [ false ]
  -o, --output string         Configures the format of data written to STDOUT.
                              - Config path: [ output ]
                              - Allowed    : [ json|yaml|text ] (default "text")
      --overwrite-namespace   Overwrite an existing namespace label on the resource
      --pat string            Konnect Personal Access Token (PAT) used to authenticate the CLI. 
                              Setting this value overrides tokens obtained from the login command.
                              - Config path: [ konnect.pat ]
  -p, --profile string        Specify the profile to use for this command. (default "default")
      --region string         Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                              - Config path: [ konnect.region ]

kongctl adopt konnect dcr-provider

Apply the KONGCTL-namespace label to an existing Konnect DCR provider that is not currently managed by kongctl.

Usage:
  kongctl adopt konnect dcr-provider <dcr-provider-id|dcr-provider-name> [flags]

Aliases:
  dcr-provider, dcr-providers, dcrp, dcrps, DCRP, DCRPS


Flags:
      --base-url string       Base URL for Konnect API requests.
                              - Config path: [ konnect.base-url ]
                              - Default   : [ https://us.api.konghq.com ]
      --color-theme string    Configures the CLI UI/theme (prompt, tables, TUI elements).
                              - Config path: [ color-theme ]
                              - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                              - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string    Path to the configuration file to load.
                              - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -h, --help                  help for dcr-provider
      --log-file string       Write execution logs to the specified file instead of STDERR.
                              - Config path: [ log-file ]
      --log-level string      Configures the logging level. Execution logs are written to STDERR.
                              - Config path: [ log-level ]
                              - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --namespace string      Namespace label to apply to the resource (required)
      --no-telemetry          Disable telemetry for this command invocation. Overrides config and env.
                              - Config path: [ telemetry.enabled ]
                              - Env var    : [ KONGCTL_NO_TELEMETRY ]
                              - Default    : [ false ]
  -o, --output string         Configures the format of data written to STDOUT.
                              - Config path: [ output ]
                              - Allowed    : [ json|yaml|text ] (default "text")
      --overwrite-namespace   Overwrite an existing namespace label on the resource
      --pat string            Konnect Personal Access Token (PAT) used to authenticate the CLI. 
                              Setting this value overrides tokens obtained from the login command.
                              - Config path: [ konnect.pat ]
  -p, --profile string        Specify the profile to use for this command. (default "default")
      --region string         Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                              - Config path: [ konnect.region ]

kongctl adopt konnect event-gateway

Apply the KONGCTL-namespace label to an existing Konnect Event Gateway Control Plane that is not currently managed by kongctl.

Usage:
  kongctl adopt konnect event-gateway <event-gateway-id|event-gateway-name> [flags]


Flags:
      --base-url string       Base URL for Konnect API requests.
                              - Config path: [ konnect.base-url ]
                              - Default   : [ https://us.api.konghq.com ]
      --color-theme string    Configures the CLI UI/theme (prompt, tables, TUI elements).
                              - Config path: [ color-theme ]
                              - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                              - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string    Path to the configuration file to load.
                              - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -h, --help                  help for event-gateway
      --log-file string       Write execution logs to the specified file instead of STDERR.
                              - Config path: [ log-file ]
      --log-level string      Configures the logging level. Execution logs are written to STDERR.
                              - Config path: [ log-level ]
                              - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --namespace string      Namespace label to apply to the resource (required)
      --no-telemetry          Disable telemetry for this command invocation. Overrides config and env.
                              - Config path: [ telemetry.enabled ]
                              - Env var    : [ KONGCTL_NO_TELEMETRY ]
                              - Default    : [ false ]
  -o, --output string         Configures the format of data written to STDOUT.
                              - Config path: [ output ]
                              - Allowed    : [ json|yaml|text ] (default "text")
      --overwrite-namespace   Overwrite an existing namespace label on the resource
      --pat string            Konnect Personal Access Token (PAT) used to authenticate the CLI. 
                              Setting this value overrides tokens obtained from the login command.
                              - Config path: [ konnect.pat ]
  -p, --profile string        Specify the profile to use for this command. (default "default")
      --region string         Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                              - Config path: [ konnect.region ]

kongctl adopt konnect organization

Adopt Konnect organization settings.

Usage:
  kongctl adopt konnect organization [flags]
  kongctl adopt konnect organization [command]

Aliases:
  organization, org, orgs

Examples:
  # Get current organization information
  kongctl get organization
  # Get current organization information using explicit product
  kongctl get konnect organization

Available Commands:
  team        Adopt an existing Konnect team into namespace management


Flags:
      --base-url string       Base URL for Konnect API requests.
                              - Config path: [ konnect.base-url ]
                              - Default   : [ https://us.api.konghq.com ]
      --color-theme string    Configures the CLI UI/theme (prompt, tables, TUI elements).
                              - Config path: [ color-theme ]
                              - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                              - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string    Path to the configuration file to load.
                              - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -h, --help                  help for organization
      --log-file string       Write execution logs to the specified file instead of STDERR.
                              - Config path: [ log-file ]
      --log-level string      Configures the logging level. Execution logs are written to STDERR.
                              - Config path: [ log-level ]
                              - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --namespace string      Namespace label to apply to the resource (required)
      --no-telemetry          Disable telemetry for this command invocation. Overrides config and env.
                              - Config path: [ telemetry.enabled ]
                              - Env var    : [ KONGCTL_NO_TELEMETRY ]
                              - Default    : [ false ]
  -o, --output string         Configures the format of data written to STDOUT.
                              - Config path: [ output ]
                              - Allowed    : [ json|yaml|text ] (default "text")
      --overwrite-namespace   Overwrite an existing namespace label on the resource
      --pat string            Konnect Personal Access Token (PAT) used to authenticate the CLI.
                              Setting this value overrides tokens obtained from the login command.
                              - Config path: [ konnect.pat ]
  -p, --profile string        Specify the profile to use for this command. (default "default")
      --region string         Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                              - Config path: [ konnect.region ]

Use "kongctl adopt konnect organization [command] --help" for more information about a command.

kongctl adopt konnect portal

Adopt Konnect Developer Portal configuration.

Usage:
  kongctl adopt konnect portal <portal-id|portal-name> [flags]


Flags:
      --base-url string       Base URL for Konnect API requests.
                              - Config path: [ konnect.base-url ]
                              - Default   : [ https://us.api.konghq.com ]
      --color-theme string    Configures the CLI UI/theme (prompt, tables, TUI elements).
                              - Config path: [ color-theme ]
                              - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                              - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string    Path to the configuration file to load.
                              - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -h, --help                  help for portal
      --log-file string       Write execution logs to the specified file instead of STDERR.
                              - Config path: [ log-file ]
      --log-level string      Configures the logging level. Execution logs are written to STDERR.
                              - Config path: [ log-level ]
                              - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --namespace string      Namespace label to apply to the resource (required)
      --no-telemetry          Disable telemetry for this command invocation. Overrides config and env.
                              - Config path: [ telemetry.enabled ]
                              - Env var    : [ KONGCTL_NO_TELEMETRY ]
                              - Default    : [ false ]
  -o, --output string         Configures the format of data written to STDOUT.
                              - Config path: [ output ]
                              - Allowed    : [ json|yaml|text ] (default "text")
      --overwrite-namespace   Overwrite an existing namespace label on the resource
      --pat string            Konnect Personal Access Token (PAT) used to authenticate the CLI. 
                              Setting this value overrides tokens obtained from the login command.
                              - Config path: [ konnect.pat ]
  -p, --profile string        Specify the profile to use for this command. (default "default")
      --region string         Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                              - Config path: [ konnect.region ]

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!