DataSync

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

API Group: aws.konfig.io/v1alpha1

DataSyncAgent # CLOUD CONTROL · AWS::DataSync::Agent

DataSyncAgent manages AWS::DataSync::Agent through the AWS Cloud Control API.

kubectl get datasyncagents · example on GitHub

Example

# DataSyncAgent — DataSync
# 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/datasync.html#datasyncagent
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncAgent
metadata:
  name: example-datasyncagent
  namespace: default
spec:
  activationKey: example
  agentName: example-datasyncagent
  providerRef:
    name: example-datasyncagent
    region: us-east-1
  securityGroupArns:
  - example
  subnetArns:
  - example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
activationKeystring—Activation key of the Agent.
agentNamestring—The name configured for the agent.
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.
securityGroupArnsarray<string>—The ARNs of the security group used to protect your data transfer task subnets.
subnetArnsarray<string>—The ARNs of the subnets in which DataSync will create elastic network interfaces for each data transfer task.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes
vpcEndpointIdstring—The ID of the VPC endpoint that the agent has access to.

Status

FieldTypeRequiredDescription
agentArnstring—The DataSync Agent ARN.
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.
endpointTypeenum—The service endpoints that the agent will connect to. Allowed: FIPS, PUBLIC, PRIVATE_LINK
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.

DataSyncLocationAzureBlob # CLOUD CONTROL · AWS::DataSync::LocationAzureBlob

DataSyncLocationAzureBlob manages AWS::DataSync::LocationAzureBlob through the AWS Cloud Control API.

kubectl get datasynclocationazureblobs · example on GitHub

Example

# DataSyncLocationAzureBlob — DataSync
# 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/datasync.html#datasynclocationazureblob
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationAzureBlob
metadata:
  name: example-datasynclocationazureblob
  namespace: default
spec:
  agentArns:
  - example
  azureAccessTier: HOT
  azureBlobAuthenticationType: SAS
  azureBlobContainerUrl: example
  azureBlobSasConfiguration:
    azureBlobSasToken: example
  azureBlobType: BLOCK
  cmkSecretConfig:
    kmsKeyArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  customSecretConfig:
    secretAccessRoleArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  providerRef:
    name: example-datasynclocationazureblob
    region: us-east-1
  subdirectory: example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
agentArnsarray<string>—Specifies the Amazon Resource Name (ARN) of the DataSync agent that can connect with your Azure Blob Storage container.
azureAccessTierenum—Specifies an access tier for the objects you're transferring into your Azure Blob Storage container. Allowed: HOT, COOL, ARCHIVE
azureBlobAuthenticationTypeenumyesThe specific authentication type that you want DataSync to use to access your Azure Blob Container. Allowed: SAS, NONE
azureBlobContainerUrlstring—The URL of the Azure Blob container that was described.
azureBlobSasConfigurationobject—DataSyncLocationAzureBlobAzureBlobSasConfiguration is a nested property type of AWS::DataSync::LocationAzureBlob.
azureBlobSasConfiguration.azureBlobSasTokenstringyesSpecifies the shared access signature (SAS) token, which indicates the permissions DataSync needs to access your Azure Blob Storage container.
azureBlobTypeenum—Specifies a blob type for the objects you're transferring into your Azure Blob Storage container. Allowed: BLOCK
cmkSecretConfigobject—DataSyncLocationAzureBlobCmkSecretConfig is a nested property type of AWS::DataSync::LocationAzureBlob.
cmkSecretConfig.kmsKeyArnstring—Specifies the ARN for the customer-managed AWS KMS key used to encrypt the secret specified for SecretArn.
cmkSecretConfig.secretArnstring—Specifies the ARN for an AWS Secrets Manager secret, managed by DataSync.
customSecretConfigobject—DataSyncLocationAzureBlobCustomSecretConfig is a nested property type of AWS::DataSync::LocationAzureBlob.
customSecretConfig.secretAccessRoleArnstringyesSpecifies the ARN for the AWS Identity and Access Management role that DataSync uses to access the secret specified for SecretArn.
customSecretConfig.secretArnstringyesSpecifies the ARN for a customer created AWS Secrets Manager secret.
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.
subdirectorystring—The subdirectory in the Azure Blob Container that is used to read data from the Azure Blob Source Location.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the Azure Blob Location that is created.
locationUristring—The URL of the Azure Blob Location that was described.
managedSecretConfigobject—Read-only: reported by AWS after creation.
managedSecretConfig.secretArnstringyesSpecifies the ARN for an AWS Secrets Manager secret.
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.

DataSyncLocationEFS # CLOUD CONTROL · AWS::DataSync::LocationEFS

DataSyncLocationEFS manages AWS::DataSync::LocationEFS through the AWS Cloud Control API.

kubectl get datasynclocationefses · example on GitHub

Example

# DataSyncLocationEFS — DataSync
# 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/datasync.html#datasynclocationefs
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationEFS
metadata:
  name: example-datasynclocationefs
  namespace: default
spec:
  accessPointArn: arn:aws:iam::123456789012:role/example-role
  ec2Config:
    securityGroupArns:
    - example
    subnetArn: arn:aws:iam::123456789012:role/example-role
  efsFilesystemArn: arn:aws:iam::123456789012:role/example-role
  fileSystemAccessRoleArn: arn:aws:iam::123456789012:role/example-role
  inTransitEncryption: NONE
  providerRef:
    name: example-datasynclocationefs
    region: us-east-1
  subdirectory: example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
accessPointArnstring—The Amazon Resource Name (ARN) for the Amazon EFS Access point that DataSync uses when accessing the EFS file system.
ec2ConfigobjectyesCreate-only in AWS: changing it requires replacing the resource.
ec2Config.securityGroupArnsarray<string>yesThe Amazon Resource Names (ARNs) of the security groups that are configured for the Amazon EC2 resource.
ec2Config.subnetArnstringyesThe ARN of the subnet that DataSync uses to access the target EFS file system.
efsFilesystemArnstring—The Amazon Resource Name (ARN) for the Amazon EFS file system.
fileSystemAccessRoleArnstring—The Amazon Resource Name (ARN) of the AWS IAM role that the DataSync will assume when mounting the EFS file system.
inTransitEncryptionenum—Protocol that is used for encrypting the traffic exchanged between the DataSync Agent and the EFS file system. Allowed: NONE, TLS1_2
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.
subdirectorystring—A subdirectory in the location's path.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the Amazon EFS file system location that is created.
locationUristring—The URL of the EFS location that was described.
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.

DataSyncLocationFSxLustre # CLOUD CONTROL · AWS::DataSync::LocationFSxLustre

DataSyncLocationFSxLustre manages AWS::DataSync::LocationFSxLustre through the AWS Cloud Control API.

kubectl get datasynclocationfsxlustres · example on GitHub

Example

# DataSyncLocationFSxLustre — DataSync
# 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/datasync.html#datasynclocationfsxlustre
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationFSxLustre
metadata:
  name: example-datasynclocationfsxlustre
  namespace: default
spec:
  fsxFilesystemArn: arn:aws:iam::123456789012:role/example-role
  providerRef:
    name: example-datasynclocationfsxlustre
    region: us-east-1
  securityGroupArns:
  - example
  subdirectory: example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
fsxFilesystemArnstring—The Amazon Resource Name (ARN) for the FSx for Lustre file system.
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.
securityGroupArnsarray<string>yesThe ARNs of the security groups that are to use to configure the FSx for Lustre file system.
subdirectorystring—A subdirectory in the location's path.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the Amazon FSx for Lustre file system location that is created.
locationUristring—The URL of the FSx for Lustre location that was described.
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.

DataSyncLocationFSxONTAP # CLOUD CONTROL · AWS::DataSync::LocationFSxONTAP

DataSyncLocationFSxONTAP manages AWS::DataSync::LocationFSxONTAP through the AWS Cloud Control API.

kubectl get datasynclocationfsxontaps · example on GitHub

Example

# DataSyncLocationFSxONTAP — DataSync
# 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/datasync.html#datasynclocationfsxontap
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationFSxONTAP
metadata:
  name: example-datasynclocationfsxontap
  namespace: default
spec:
  protocol:
    nfs:
      mountOptions:
        version: AUTOMATIC
    smb:
      cmkSecretConfig:
        kmsKeyArn: arn:aws:iam::123456789012:role/example-role
        secretArn: arn:aws:iam::123456789012:role/example-role
      customSecretConfig:
        secretAccessRoleArn: arn:aws:iam::123456789012:role/example-role
        secretArn: arn:aws:iam::123456789012:role/example-role
      domain: example
      managedSecretConfig:
        secretArn: arn:aws:iam::123456789012:role/example-role
      mountOptions:
        version: AUTOMATIC
      password: example
      user: example
  providerRef:
    name: example-datasynclocationfsxontap
    region: us-east-1
  securityGroupArns:
  - example
  storageVirtualMachineArn: arn:aws:iam::123456789012:role/example-role
  subdirectory: example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
protocolobject—DataSyncLocationFSxONTAPProtocol is a nested property type of AWS::DataSync::LocationFSxONTAP.
protocol.nfsobject—DataSyncLocationFSxONTAPNFS is a nested property type of AWS::DataSync::LocationFSxONTAP.
protocol.nfs.mountOptionsobjectyesDataSyncLocationFSxONTAPNfsMountOptions is a nested property type of AWS::DataSync::LocationFSxONTAP.
protocol.nfs.mountOptions.versionenum—The specific NFS version that you want DataSync to use to mount your NFS share. Allowed: AUTOMATIC, NFS3, NFS4_0, NFS4_1
protocol.smbobject—DataSyncLocationFSxONTAPSMB is a nested property type of AWS::DataSync::LocationFSxONTAP.
protocol.smb.cmkSecretConfigobject—DataSyncLocationFSxONTAPCmkSecretConfig is a nested property type of AWS::DataSync::LocationFSxONTAP.
protocol.smb.cmkSecretConfig.kmsKeyArnstring—Specifies the ARN for the customer-managed AWS KMS key used to encrypt the secret specified for SecretArn.
protocol.smb.cmkSecretConfig.secretArnstring—Specifies the ARN for an AWS Secrets Manager secret, managed by DataSync.
protocol.smb.customSecretConfigobject—DataSyncLocationFSxONTAPCustomSecretConfig is a nested property type of AWS::DataSync::LocationFSxONTAP.
protocol.smb.customSecretConfig.secretAccessRoleArnstringyesSpecifies the ARN for the AWS Identity and Access Management role that DataSync uses to access the secret specified for SecretArn.
protocol.smb.customSecretConfig.secretArnstringyesSpecifies the ARN for a customer created AWS Secrets Manager secret.
protocol.smb.domainstring—The name of the Windows domain that the SMB server belongs to.
protocol.smb.managedSecretConfigobject—DataSyncLocationFSxONTAPManagedSecretConfig is a nested property type of AWS::DataSync::LocationFSxONTAP.
protocol.smb.managedSecretConfig.secretArnstringyesSpecifies the ARN for an AWS Secrets Manager secret.
protocol.smb.mountOptionsobjectyesDataSyncLocationFSxONTAPSmbMountOptions is a nested property type of AWS::DataSync::LocationFSxONTAP.
protocol.smb.mountOptions.versionenum—The specific SMB version that you want DataSync to use to mount your SMB share. Allowed: AUTOMATIC, SMB2, SMB3
protocol.smb.passwordstring—The password of the user who can mount the share and has the permissions to access files and folders in the SMB share.
protocol.smb.userstringyesThe user who can mount the share, has the permissions to access files and folders in the SMB share.
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.
securityGroupArnsarray<string>yesThe ARNs of the security groups that are to use to configure the FSx ONTAP file system.
storageVirtualMachineArnstringyesThe Amazon Resource Name (ARN) for the FSx ONTAP SVM.
subdirectorystring—A subdirectory in the location's path.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
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.
fsxFilesystemArnstring—The Amazon Resource Name (ARN) for the FSx ONAP file system.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
locationArnstring—The Amazon Resource Name (ARN) of the Amazon FSx ONTAP file system location that is created.
locationUristring—The URL of the FSx ONTAP file system that was described.
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.

DataSyncLocationFSxOpenZFS # CLOUD CONTROL · AWS::DataSync::LocationFSxOpenZFS

DataSyncLocationFSxOpenZFS manages AWS::DataSync::LocationFSxOpenZFS through the AWS Cloud Control API.

kubectl get datasynclocationfsxopenzfses · example on GitHub

Example

# DataSyncLocationFSxOpenZFS — DataSync
# 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/datasync.html#datasynclocationfsxopenzfs
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationFSxOpenZFS
metadata:
  name: example-datasynclocationfsxopenzfs
  namespace: default
spec:
  fsxFilesystemArn: arn:aws:iam::123456789012:role/example-role
  protocol:
    nfs:
      mountOptions:
        version: AUTOMATIC
  providerRef:
    name: example-datasynclocationfsxopenzfs
    region: us-east-1
  securityGroupArns:
  - example
  subdirectory: example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
fsxFilesystemArnstring—The Amazon Resource Name (ARN) for the FSx OpenZFS file system.
protocolobjectyesDataSyncLocationFSxOpenZFSProtocol is a nested property type of AWS::DataSync::LocationFSxOpenZFS.
protocol.nfsobject—DataSyncLocationFSxOpenZFSNFS is a nested property type of AWS::DataSync::LocationFSxOpenZFS.
protocol.nfs.mountOptionsobjectyesDataSyncLocationFSxOpenZFSMountOptions is a nested property type of AWS::DataSync::LocationFSxOpenZFS.
protocol.nfs.mountOptions.versionenum—The specific NFS version that you want DataSync to use to mount your NFS share. Allowed: AUTOMATIC, NFS3, NFS4_0, NFS4_1
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.
securityGroupArnsarray<string>yesThe ARNs of the security groups that are to use to configure the FSx OpenZFS file system.
subdirectorystring—A subdirectory in the location's path.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the Amazon FSx OpenZFS file system location that is created.
locationUristring—The URL of the FSx OpenZFS that was described.
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.

DataSyncLocationFSxWindows # CLOUD CONTROL · AWS::DataSync::LocationFSxWindows

DataSyncLocationFSxWindows manages AWS::DataSync::LocationFSxWindows through the AWS Cloud Control API.

kubectl get datasynclocationfsxwindows · example on GitHub

Example

# DataSyncLocationFSxWindows — DataSync
# 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/datasync.html#datasynclocationfsxwindows
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationFSxWindows
metadata:
  name: example-datasynclocationfsxwindows
  namespace: default
spec:
  cmkSecretConfig:
    kmsKeyArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  customSecretConfig:
    secretAccessRoleArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  domain: example
  fsxFilesystemArn: arn:aws:iam::123456789012:role/example-role
  password: example
  providerRef:
    name: example-datasynclocationfsxwindows
    region: us-east-1
  securityGroupArns:
  - example
  subdirectory: example
  tags:
  - key: example
    value: example
  user: example

Spec

FieldTypeRequiredDescription
cmkSecretConfigobject—DataSyncLocationFSxWindowsCmkSecretConfig is a nested property type of AWS::DataSync::LocationFSxWindows.
cmkSecretConfig.kmsKeyArnstring—Specifies the ARN for the customer-managed AWS KMS key used to encrypt the secret specified for SecretArn.
cmkSecretConfig.secretArnstring—Specifies the ARN for an AWS Secrets Manager secret, managed by DataSync.
customSecretConfigobject—DataSyncLocationFSxWindowsCustomSecretConfig is a nested property type of AWS::DataSync::LocationFSxWindows.
customSecretConfig.secretAccessRoleArnstringyesSpecifies the ARN for the AWS Identity and Access Management role that DataSync uses to access the secret specified for SecretArn.
customSecretConfig.secretArnstringyesSpecifies the ARN for a customer created AWS Secrets Manager secret.
domainstring—The name of the Windows domain that the FSx for Windows server belongs to.
fsxFilesystemArnstring—The Amazon Resource Name (ARN) for the FSx for Windows file system.
passwordstring—The password of the user who has the permissions to access files and folders in the FSx for Windows file system.
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.
securityGroupArnsarray<string>yesThe ARNs of the security groups that are to use to configure the FSx for Windows file system.
subdirectorystring—A subdirectory in the location's path.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes
userstringyesThe user who has the permissions to access files and folders in the FSx for Windows file system.

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the Amazon FSx for Windows file system location that is created.
locationUristring—The URL of the FSx for Windows location that was described.
managedSecretConfigobject—Read-only: reported by AWS after creation.
managedSecretConfig.secretArnstringyesSpecifies the ARN for an AWS Secrets Manager secret.
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.

DataSyncLocationHDFS # CLOUD CONTROL · AWS::DataSync::LocationHDFS

DataSyncLocationHDFS manages AWS::DataSync::LocationHDFS through the AWS Cloud Control API.

kubectl get datasynclocationhdfses · example on GitHub

Example

# DataSyncLocationHDFS — DataSync
# 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/datasync.html#datasynclocationhdfs
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationHDFS
metadata:
  name: example-datasynclocationhdfs
  namespace: default
spec:
  agentArns:
  - example
  authenticationType: SIMPLE
  blockSize: 1048576
  cmkSecretConfig:
    kmsKeyArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  customSecretConfig:
    secretAccessRoleArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  kerberosKeytab: example
  kerberosKrb5Conf: example
  kerberosPrincipal: example
  kmsKeyProviderUri: example
  nameNodes:
  - hostname: example-datasynclocationhdfs
    port: 1
  providerRef:
    name: example-datasynclocationhdfs
    region: us-east-1
  qopConfiguration:
    dataTransferProtection: AUTHENTICATION
    rpcProtection: AUTHENTICATION
  replicationFactor: 1
  simpleUser: example
  subdirectory: example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
agentArnsarray<string>yesARN(s) of the agent(s) to use for an HDFS location.
authenticationTypeenumyesThe authentication mode used to determine identity of user. Allowed: SIMPLE, KERBEROS
blockSizeinteger—Size of chunks (blocks) in bytes that the data is divided into when stored in the HDFS cluster.
cmkSecretConfigobject—DataSyncLocationHDFSCmkSecretConfig is a nested property type of AWS::DataSync::LocationHDFS.
cmkSecretConfig.kmsKeyArnstring—Specifies the ARN for the customer-managed AWS KMS key used to encrypt the secret specified for SecretArn.
cmkSecretConfig.secretArnstring—Specifies the ARN for an AWS Secrets Manager secret, managed by DataSync.
customSecretConfigobject—DataSyncLocationHDFSCustomSecretConfig is a nested property type of AWS::DataSync::LocationHDFS.
customSecretConfig.secretAccessRoleArnstringyesSpecifies the ARN for the AWS Identity and Access Management role that DataSync uses to access the secret specified for SecretArn.
customSecretConfig.secretArnstringyesSpecifies the ARN for a customer created AWS Secrets Manager secret.
kerberosKeytabstring—The Base64 string representation of the Keytab file.
kerberosKrb5Confstring—The string representation of the Krb5Conf file, or the presigned URL to access the Krb5.conf file within an S3 bucket.
kerberosPrincipalstring—The unique identity, or principal, to which Kerberos can assign tickets.
kmsKeyProviderUristring—The identifier for the Key Management Server where the encryption keys that encrypt data inside HDFS clusters are stored.
nameNodesarray<object>yesAn array of Name Node(s) of the HDFS location.
nameNodes[].hostnamestringyesThe DNS name or IP address of the Name Node in the customer's on premises HDFS cluster.
nameNodes[].portintegeryesThe port on which the Name Node is listening on for client requests.
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.
qopConfigurationobject—DataSyncLocationHDFSQopConfiguration is a nested property type of AWS::DataSync::LocationHDFS.
qopConfiguration.dataTransferProtectionenum—Configuration for Data Transfer Protection. Allowed: AUTHENTICATION, INTEGRITY, PRIVACY, DISABLED
qopConfiguration.rpcProtectionenum—Configuration for RPC Protection. Allowed: AUTHENTICATION, INTEGRITY, PRIVACY, DISABLED
replicationFactorinteger—Number of copies of each block that exists inside the HDFS cluster.
simpleUserstring—The user name that has read and write permissions on the specified HDFS cluster.
subdirectorystring—The subdirectory in HDFS that is used to read data from the HDFS source location or write data to the HDFS destination.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the HDFS location.
locationUristring—The URL of the HDFS location that was described.
managedSecretConfigobject—Read-only: reported by AWS after creation.
managedSecretConfig.secretArnstringyesSpecifies the ARN for an AWS Secrets Manager secret.
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.

DataSyncLocationNFS # CLOUD CONTROL · AWS::DataSync::LocationNFS

DataSyncLocationNFS manages AWS::DataSync::LocationNFS through the AWS Cloud Control API.

kubectl get datasynclocationnfses · example on GitHub

Example

# DataSyncLocationNFS — DataSync
# 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/datasync.html#datasynclocationnfs
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationNFS
metadata:
  name: example-datasynclocationnfs
  namespace: default
spec:
  mountOptions:
    version: AUTOMATIC
  onPremConfig:
    agentArns:
    - example
  providerRef:
    name: example-datasynclocationnfs
    region: us-east-1
  serverHostname: example-datasynclocationnfs
  subdirectory: example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
mountOptionsobject—DataSyncLocationNFSMountOptions is a nested property type of AWS::DataSync::LocationNFS.
mountOptions.versionenum—The specific NFS version that you want DataSync to use to mount your NFS share. Allowed: AUTOMATIC, NFS3, NFS4_0, NFS4_1
onPremConfigobjectyesDataSyncLocationNFSOnPremConfig is a nested property type of AWS::DataSync::LocationNFS.
onPremConfig.agentArnsarray<string>yesARN(s) of the agent(s) to use for an NFS location.
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.
serverHostnamestring—The name of the NFS server.
subdirectorystring—The subdirectory in the NFS file system that is used to read data from the NFS source location or write data to the NFS destination.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the NFS location.
locationUristring—The URL of the NFS location that was described.
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.

DataSyncLocationObjectStorage # CLOUD CONTROL · AWS::DataSync::LocationObjectStorage

DataSyncLocationObjectStorage manages AWS::DataSync::LocationObjectStorage through the AWS Cloud Control API.

kubectl get datasynclocationobjectstorages · example on GitHub

Example

# DataSyncLocationObjectStorage — DataSync
# 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/datasync.html#datasynclocationobjectstorage
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationObjectStorage
metadata:
  name: example-datasynclocationobjectstorage
  namespace: default
spec:
  accessKey: example
  agentArns:
  - example
  bucketName: example-datasynclocationobjectstorage
  cmkSecretConfig:
    kmsKeyArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  customSecretConfig:
    secretAccessRoleArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  providerRef:
    name: example-datasynclocationobjectstorage
    region: us-east-1
  secretKey: example
  serverCertificate: example
  serverHostname: example-datasynclocationobjectstorage
  serverPort: 1
  serverProtocol: HTTPS
  subdirectory: example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
accessKeystring—Optional.
agentArnsarray<string>—Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can connect with your object storage system.
bucketNamestring—The name of the bucket on the self-managed object storage server.
cmkSecretConfigobject—DataSyncLocationObjectStorageCmkSecretConfig is a nested property type of AWS::DataSync::LocationObjectStorage.
cmkSecretConfig.kmsKeyArnstring—Specifies the ARN for the customer-managed AWS KMS key used to encrypt the secret specified for SecretArn.
cmkSecretConfig.secretArnstring—Specifies the ARN for an AWS Secrets Manager secret, managed by DataSync.
customSecretConfigobject—DataSyncLocationObjectStorageCustomSecretConfig is a nested property type of AWS::DataSync::LocationObjectStorage.
customSecretConfig.secretAccessRoleArnstringyesSpecifies the ARN for the AWS Identity and Access Management role that DataSync uses to access the secret specified for SecretArn.
customSecretConfig.secretArnstringyesSpecifies the ARN for a customer created AWS Secrets Manager secret.
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.
secretKeystring—Optional.
serverCertificatestring—X.509 PEM content containing a certificate authority or chain to trust.
serverHostnamestring—The name of the self-managed object storage server.
serverPortinteger—The port that your self-managed server accepts inbound network traffic on.
serverProtocolenum—The protocol that the object storage server uses to communicate. Allowed: HTTPS, HTTP
subdirectorystring—The subdirectory in the self-managed object storage server that is used to read data from.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the location that is created.
locationUristring—The URL of the object storage location that was described.
managedSecretConfigobject—Read-only: reported by AWS after creation.
managedSecretConfig.secretArnstringyesSpecifies the ARN for an AWS Secrets Manager secret.
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.

DataSyncLocationS3 # CLOUD CONTROL · AWS::DataSync::LocationS3

DataSyncLocationS3 manages AWS::DataSync::LocationS3 through the AWS Cloud Control API.

kubectl get datasynclocations3s · example on GitHub

Example

# DataSyncLocationS3 — DataSync
# 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/datasync.html#datasynclocations3
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationS3
metadata:
  name: example-datasynclocations3
  namespace: default
spec:
  providerRef:
    name: example-datasynclocations3
    region: us-east-1
  s3BucketArn: arn:aws:iam::123456789012:role/example-role
  s3Config:
    bucketAccessRoleArn: arn:aws:iam::123456789012:role/example-role
  s3StorageClass: STANDARD
  subdirectory: example
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
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.
s3BucketArnstring—The Amazon Resource Name (ARN) of the Amazon S3 bucket.
s3ConfigobjectyesDataSyncLocationS3S3Config is a nested property type of AWS::DataSync::LocationS3.
s3Config.bucketAccessRoleArnstringyesThe ARN of the IAM role of the Amazon S3 bucket.
s3StorageClassenum—The Amazon S3 storage class you want to store your files in when this location is used as a task destination. Allowed: STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, GLACIER_INSTANT_RETRIEVAL, DEEP_ARCHIVE
subdirectorystring—A subdirectory in the Amazon S3 bucket.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the Amazon S3 bucket location.
locationUristring—The URL of the S3 location that was described.
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.

DataSyncLocationSMB # CLOUD CONTROL · AWS::DataSync::LocationSMB

DataSyncLocationSMB manages AWS::DataSync::LocationSMB through the AWS Cloud Control API.

kubectl get datasynclocationsmbs · example on GitHub

Example

# DataSyncLocationSMB — DataSync
# 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/datasync.html#datasynclocationsmb
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncLocationSMB
metadata:
  name: example-datasynclocationsmb
  namespace: default
spec:
  agentArns:
  - example
  authenticationType: NTLM
  cmkSecretConfig:
    kmsKeyArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  customSecretConfig:
    secretAccessRoleArn: arn:aws:iam::123456789012:role/example-role
    secretArn: arn:aws:iam::123456789012:role/example-role
  dnsIpAddresses:
  - example
  domain: example
  kerberosKeytab: example
  kerberosKrb5Conf: example
  kerberosPrincipal: example
  mountOptions:
    version: AUTOMATIC
  password: example
  providerRef:
    name: example-datasynclocationsmb
    region: us-east-1
  serverHostname: example-datasynclocationsmb
  subdirectory: example
  tags:
  - key: example
    value: example
  user: example

Spec

FieldTypeRequiredDescription
agentArnsarray<string>yesThe Amazon Resource Names (ARNs) of agents to use for a Simple Message Block (SMB) location.
authenticationTypeenum—The authentication mode used to determine identity of user. Allowed: NTLM, KERBEROS
cmkSecretConfigobject—DataSyncLocationSMBCmkSecretConfig is a nested property type of AWS::DataSync::LocationSMB.
cmkSecretConfig.kmsKeyArnstring—Specifies the ARN for the customer-managed AWS KMS key used to encrypt the secret specified for SecretArn.
cmkSecretConfig.secretArnstring—Specifies the ARN for an AWS Secrets Manager secret, managed by DataSync.
customSecretConfigobject—DataSyncLocationSMBCustomSecretConfig is a nested property type of AWS::DataSync::LocationSMB.
customSecretConfig.secretAccessRoleArnstringyesSpecifies the ARN for the AWS Identity and Access Management role that DataSync uses to access the secret specified for SecretArn.
customSecretConfig.secretArnstringyesSpecifies the ARN for a customer created AWS Secrets Manager secret.
dnsIpAddressesarray<string>—Specifies the IPv4 addresses for the DNS servers that your SMB file server belongs to.
domainstring—The name of the Windows domain that the SMB server belongs to.
kerberosKeytabstring—The Base64 string representation of the Keytab file.
kerberosKrb5Confstring—The string representation of the Krb5Conf file, or the presigned URL to access the Krb5.conf file within an S3 bucket.
kerberosPrincipalstring—Specifies a service principal name (SPN), which is an identity in your Kerberos realm that has permission to access the files, folders, and file metadata in your SMB file server.
mountOptionsobject—DataSyncLocationSMBMountOptions is a nested property type of AWS::DataSync::LocationSMB.
mountOptions.versionenum—The specific SMB version that you want DataSync to use to mount your SMB share. Allowed: AUTOMATIC, SMB1, SMB2_0, SMB2, SMB3
passwordstring—The password of the user who can mount the share and has the permissions to access files and folders in the SMB share.
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.
serverHostnamestring—The name of the SMB server.
subdirectorystring—The subdirectory in the SMB file system that is used to read data from the SMB source location or write data to the SMB destination
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes
userstring—The user who can mount the share, has the permissions to access files and folders in the SMB share.

Status

FieldTypeRequiredDescription
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—
locationArnstring—The Amazon Resource Name (ARN) of the SMB location that is created.
locationUristring—The URL of the SMB location that was described.
managedSecretConfigobject—Read-only: reported by AWS after creation.
managedSecretConfig.secretArnstringyesSpecifies the ARN for an AWS Secrets Manager secret.
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.

DataSyncTask # CLOUD CONTROL · AWS::DataSync::Task

DataSyncTask manages AWS::DataSync::Task through the AWS Cloud Control API.

kubectl get datasynctasks · example on GitHub

Example

# DataSyncTask — DataSync
# 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/datasync.html#datasynctask
apiVersion: aws.konfig.io/v1alpha1
kind: DataSyncTask
metadata:
  name: example-datasynctask
  namespace: default
spec:
  cloudWatchLogGroupArn: arn:aws:iam::123456789012:role/example-role
  destinationLocationArn: arn:aws:iam::123456789012:role/example-role
  excludes:
  - filterType: SIMPLE_PATTERN
    value: example
  includes:
  - filterType: SIMPLE_PATTERN
    value: example
  manifestConfig:
    action: TRANSFER
    format: CSV
    source:
      s3:
        bucketAccessRoleArn: arn:aws:iam::123456789012:role/example-role
        manifestObjectPath: example
        s3BucketArn: arn:aws:iam::123456789012:role/example-role
  name: example-datasynctask
  options:
    atime: NONE
    bytesPerSecond: 1
    gid: NONE
    logLevel: 'OFF'
    mtime: NONE
    objectTags: PRESERVE
    overwriteMode: ALWAYS
    posixPermissions: NONE
    preserveDeletedFiles: PRESERVE
    preserveDevices: NONE
    securityDescriptorCopyFlags: NONE
    taskQueueing: ENABLED
    transferMode: CHANGED
    uid: NONE
    verifyMode: POINT_IN_TIME_CONSISTENT
  providerRef:
    name: example-datasynctask
    region: us-east-1
  schedule:
    scheduleExpression: example
    status: ENABLED
  sourceLocationArn: arn:aws:iam::123456789012:role/example-role
  tags:
  - key: example
    value: example
  taskMode: BASIC
  taskReportConfig:
    destination:
      s3:
        bucketAccessRoleArn: arn:aws:iam::123456789012:role/example-role
        s3BucketArn: arn:aws:iam::123456789012:role/example-role
        subdirectory: example
    objectVersionIds: INCLUDE
    outputType: SUMMARY_ONLY
    overrides:
      deleted:
        reportLevel: ERRORS_ONLY
      skipped:
        reportLevel: ERRORS_ONLY
      transferred:
        reportLevel: ERRORS_ONLY
      verified:
        reportLevel: ERRORS_ONLY
    reportLevel: ERRORS_ONLY

Spec

FieldTypeRequiredDescription
cloudWatchLogGroupArnstring—The ARN of the Amazon CloudWatch log group that is used to monitor and log events in the task.
destinationLocationArnstringyesThe ARN of an AWS storage resource's location.
excludesarray<object>—
excludes[].filterTypeenum—The type of filter rule to apply. Allowed: SIMPLE_PATTERN
excludes[].valuestring—A single filter string that consists of the patterns to include or exclude.
includesarray<object>—
includes[].filterTypeenum—The type of filter rule to apply. Allowed: SIMPLE_PATTERN
includes[].valuestring—A single filter string that consists of the patterns to include or exclude.
manifestConfigobject—DataSyncTaskManifestConfig is a nested property type of AWS::DataSync::Task.
manifestConfig.actionenum—Specifies what DataSync uses the manifest for. Allowed: TRANSFER
manifestConfig.formatenum—Specifies the file format of your manifest. Allowed: CSV
manifestConfig.sourceobjectyesSpecifies the manifest that you want DataSync to use and where it's hosted.
manifestConfig.source.s3object—DataSyncTaskManifestConfigSourceS3 is a nested property type of AWS::DataSync::Task.
manifestConfig.source.s3.bucketAccessRoleArnstring—Specifies the AWS Identity and Access Management (IAM) role that allows DataSync to access your manifest.
manifestConfig.source.s3.manifestObjectPathstring—Specifies the Amazon S3 object key of your manifest.
manifestConfig.source.s3.manifestObjectVersionIdstring—Specifies the object version ID of the manifest that you want DataSync to use.
manifestConfig.source.s3.s3BucketArnstring—Specifies the Amazon Resource Name (ARN) of the S3 bucket where you're hosting your manifest.
namestring—The name of a task.
optionsobject—DataSyncTaskOptions is a nested property type of AWS::DataSync::Task.
options.atimeenum—A file metadata value that shows the last time a file was accessed (that is, when the file was read or written to). Allowed: NONE, BEST_EFFORT
options.bytesPerSecondinteger—A value that limits the bandwidth used by AWS DataSync.
options.gidenum—The group ID (GID) of the file's owners. Allowed: NONE, INT_VALUE, NAME, BOTH
options.logLevelenum—A value that determines the types of logs that DataSync publishes to a log stream in the Amazon CloudWatch log group that you provide. Allowed: OFF, BASIC, TRANSFER
options.mtimeenum—A value that indicates the last time that a file was modified (that is, a file was written to) before the PREPARING phase. Allowed: NONE, PRESERVE
options.objectTagsenum—A value that determines whether object tags should be read from the source object store and written to the destination object store. Allowed: PRESERVE, NONE
options.overwriteModeenum—A value that determines whether files at the destination should be overwritten or preserved when copying files. Allowed: ALWAYS, NEVER
options.posixPermissionsenum—A value that determines which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file. Allowed: NONE, PRESERVE
options.preserveDeletedFilesenum—A value that specifies whether files in the destination that don't exist in the source file system should be preserved. Allowed: PRESERVE, REMOVE
options.preserveDevicesenum—A value that determines whether AWS DataSync should preserve the metadata of block and character devices in the source file system, and recreate the files with that device name and metadata on the destination. Allowed: NONE, PRESERVE
options.securityDescriptorCopyFlagsenum—A value that determines which components of the SMB security descriptor are copied during transfer. Allowed: NONE, OWNER_DACL, OWNER_DACL_SACL
options.taskQueueingenum—A value that determines whether tasks should be queued before executing the tasks. Allowed: ENABLED, DISABLED
options.transferModeenum—A value that determines whether DataSync transfers only the data and metadata that differ between the source and the destination location, or whether DataSync transfers all the content from the source, without comparing to the destination location. Allowed: CHANGED, ALL
options.uidenum—The user ID (UID) of the file's owner. Allowed: NONE, INT_VALUE, NAME, BOTH
options.verifyModeenum—A value that determines whether a data integrity verification should be performed at the end of a task execution after all data and metadata have been transferred. Allowed: POINT_IN_TIME_CONSISTENT, ONLY_FILES_TRANSFERRED, NONE
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.
scheduleobject—DataSyncTaskTaskSchedule is a nested property type of AWS::DataSync::Task.
schedule.scheduleExpressionstring—A cron expression that specifies when AWS DataSync initiates a scheduled transfer from a source to a destination location
schedule.statusenum—Specifies status of a schedule. Allowed: ENABLED, DISABLED
sourceLocationArnstringyesThe ARN of the source location for the task.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes
taskModeenum—Specifies the task mode for the task. Allowed: BASIC, ENHANCED
taskReportConfigobject—DataSyncTaskTaskReportConfig is a nested property type of AWS::DataSync::Task.
taskReportConfig.destinationobjectyesSpecifies where DataSync uploads your task report.
taskReportConfig.destination.s3object—DataSyncTaskTaskReportConfigDestinationS3 is a nested property type of AWS::DataSync::Task.
taskReportConfig.destination.s3.bucketAccessRoleArnstring—Specifies the Amazon Resource Name (ARN) of the IAM policy that allows Datasync to upload a task report to your S3 bucket.
taskReportConfig.destination.s3.s3BucketArnstring—Specifies the ARN of the S3 bucket where Datasync uploads your report.
taskReportConfig.destination.s3.subdirectorystring—Specifies a bucket prefix for your report.
taskReportConfig.objectVersionIdsenum—Specifies whether your task report includes the new version of each object transferred into an S3 bucket, this only applies if you enable versioning on your bucket. Allowed: INCLUDE, NONE
taskReportConfig.outputTypeenumyesSpecifies the type of task report that you want. Allowed: SUMMARY_ONLY, STANDARD
taskReportConfig.overridesobject—Customizes the reporting level for aspects of your task report.
taskReportConfig.overrides.deletedobject—Specifies the level of reporting for the files, objects, and directories that Datasync attempted to delete in your destination location.
taskReportConfig.overrides.deleted.reportLevelenum—Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Allowed: ERRORS_ONLY, SUCCESSES_AND_ERRORS
taskReportConfig.overrides.skippedobject—Specifies the level of reporting for the files, objects, and directories that Datasync attempted to skip during your transfer.
taskReportConfig.overrides.skipped.reportLevelenum—Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Allowed: ERRORS_ONLY, SUCCESSES_AND_ERRORS
taskReportConfig.overrides.transferredobject—Specifies the level of reporting for the files, objects, and directories that Datasync attempted to transfer.
taskReportConfig.overrides.transferred.reportLevelenum—Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Allowed: ERRORS_ONLY, SUCCESSES_AND_ERRORS
taskReportConfig.overrides.verifiedobject—Specifies the level of reporting for the files, objects, and directories that Datasync attempted to verify at the end of your transfer.
taskReportConfig.overrides.verified.reportLevelenum—Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Allowed: ERRORS_ONLY, SUCCESSES_AND_ERRORS
taskReportConfig.reportLevelenum—Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Allowed: ERRORS_ONLY, SUCCESSES_AND_ERRORS

Status

FieldTypeRequiredDescription
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.
destinationNetworkInterfaceArnsarray<string>—Read-only: reported by AWS after creation.
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.
sourceNetworkInterfaceArnsarray<string>—Read-only: reported by AWS after creation.
statusenum—The status of the task that was described. Allowed: AVAILABLE, CREATING, QUEUED, RUNNING, UNAVAILABLE
taskArnstring—The ARN of the task.