OpenSearch

3 resource kinds. Generated from the operator's CRD schemas.

API Group: aws.konfig.io/v1alpha1

OpenSearchApplication # CLOUD CONTROL · AWS::OpenSearchService::Application

OpenSearchApplication manages AWS::OpenSearchService::Application through the AWS Cloud Control API.

kubectl get opensearchapplications · example on GitHub

Example

# OpenSearchApplication — OpenSearch
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/opensearch.html#opensearchapplication
apiVersion: aws.konfig.io/v1alpha1
kind: OpenSearchApplication
metadata:
  name: example-opensearchapplication
  namespace: default
spec:
  appConfigs:
  - key: opensearchDashboards.dashboardAdmin.users
    value: example
  dataSources:
  - dataSourceDescription: Managed by konfig-konector
  endpoint: example
  iamIdentityCenterOptions:
    enabled: true
    iamRoleForIdentityCenterApplicationArn: arn:aws:iam::123456789012:role/example-role
  kmsKeyArn: arn:aws:iam::123456789012:role/example-role
  name: example-opensearchapplication
  providerRef:
    name: example-opensearchapplication
    region: us-east-1
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
appConfigsarray<object>—List of application configurations.
appConfigs[].keyenumyesThe configuration key Allowed: opensearchDashboards.dashboardAdmin.users, opensearchDashboards.dashboardAdmin.groups
appConfigs[].valuestringyesThe configuration value.
dataSourcesarray<object>—List of data sources.
dataSources[].dataSourceArnobjectyesThe ARN of the data source.
dataSources[].dataSourceDescriptionstring—Description of the data source.
endpointstring—The endpoint for the application.
iamIdentityCenterOptionsobject—Options for configuring IAM Identity Center
iamIdentityCenterOptions.enabledboolean—Whether IAM Identity Center is enabled.
iamIdentityCenterOptions.iamIdentityCenterInstanceArnobject—The ARN of the IAM Identity Center instance.
iamIdentityCenterOptions.iamRoleForIdentityCenterApplicationArnstring—The ARN of the IAM role for Identity Center application.
kmsKeyArnstring—The ARN of the KMS key used to encrypt the application.
namestringyesThe name of the application.
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
tagsarray<object>—An arbitrary set of tags (key-value pairs) for this application.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
arnstring—Amazon Resource Name (ARN) format.
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
idstring—The identifier of the application.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.

OpenSearchDataSource # CLOUD CONTROL · AWS::OpenSearch::DataSource

OpenSearchDataSource manages AWS::OpenSearch::DataSource through the AWS Cloud Control API.

kubectl get opensearchdatasources · example on GitHub

Example

# OpenSearchDataSource — OpenSearch
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/opensearch.html#opensearchdatasource
apiVersion: aws.konfig.io/v1alpha1
kind: OpenSearchDataSource
metadata:
  name: example-opensearchdatasource
  namespace: default
spec:
  dataSourceType:
    s3GlueDataCatalog:
      roleArn: arn:aws:iam::123456789012:role/example-role
  description: Managed by konfig-konector
  domainName: example-opensearchdatasource
  name: example-opensearchdatasource
  providerRef:
    name: example-opensearchdatasource
    region: us-east-1

Spec

FieldTypeRequiredDescription
dataSourceTypeobjectyesOpenSearchDataSourceDataSourceType is a nested property type of AWS::OpenSearch::DataSource.
dataSourceType.s3GlueDataCatalogobject—OpenSearchDataSourceS3GlueDataCatalog is a nested property type of AWS::OpenSearch::DataSource.
dataSourceType.s3GlueDataCatalog.roleArnstringyesThe ARN of the IAM role that grants OpenSearch Service permission to access the Glue Data Catalog.
descriptionstring—A description of the data source.
domainNamestringyesThe name of the OpenSearch Service domain.
namestringyesThe name of the data source.
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.

Status

FieldTypeRequiredDescription
arnstring—The Amazon Resource Name (ARN) of the data source.
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.
statusenum—The status of the data source. Allowed: ACTIVE, DISABLED

OpenSearchDomain # GA

OpenSearchDomain is the Schema for managing AWS OpenSearch Service domains.

kubectl get opensearchdomains · example on GitHub

Example

# OpenSearchDomain — OpenSearch
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/opensearch.html#opensearchdomain
apiVersion: aws.konfig.io/v1alpha1
kind: OpenSearchDomain
metadata:
  name: example-opensearchdomain
  namespace: default
spec:
  clusterConfig:
    dedicatedMasterEnabled: true
    instanceCount: 2
    instanceType: example
  domainName: example-opensearchdomain
  engineVersion: example
  providerRef:
    name: example-opensearchdomain
    region: us-east-1
  tags:
    environment: dev
    team: platform

Spec

FieldTypeRequiredDescription
clusterConfigobject—ClusterConfig defines the cluster configuration.
clusterConfig.dedicatedMasterEnabledboolean—DedicatedMasterEnabled enables dedicated master nodes.
clusterConfig.instanceCountinteger—InstanceCount is the number of data nodes.
clusterConfig.instanceTypestring—InstanceType is the instance type for data nodes (e.g.
domainNamestringyesDomainName is the name of the domain.
engineVersionstring—EngineVersion specifies the OpenSearch or Elasticsearch version (e.g.
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
tagsmap<string>—Tags are metadata tags for the domain.

Status

FieldTypeRequiredDescription
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
domainARNstring—DomainARN is the ARN of the OpenSearch domain.
domainIDstring—DomainID is the unique identifier of the domain.
endpointstring—Endpoint is the domain endpoint URL.
lastSyncTimestring—LastSyncTime is when the resource was last successfully reconciled.
observedGenerationinteger—ObservedGeneration is the most recent .metadata.generation reconciled.
processingboolean—Processing is true when the domain is being created or updated.