Skip to content

Updates a connection

Description

Updates a connection. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.

Usage

datazone_update_connection(configurations, domainIdentifier, identifier,
  description, awsLocation, props)

Arguments

  • configurations

The configurations of the connection.

  • domainIdentifier

[required] The ID of the domain where a connection is to be updated.

  • identifier

[required] The ID of the connection to be updated.

  • description

The description of a connection.

  • awsLocation

The location where a connection is to be updated.

  • props

The connection props.

Value

A list with the following syntax:

list(
  configurations = list(
    list(
      classification = "string",
      properties = list(
        "string"
      )
    )
  ),
  connectionId = "string",
  description = "string",
  domainId = "string",
  domainUnitId = "string",
  environmentId = "string",
  name = "string",
  physicalEndpoints = list(
    list(
      awsLocation = list(
        accessRole = "string",
        awsAccountId = "string",
        awsRegion = "string",
        iamConnectionId = "string"
      ),
      glueConnectionName = "string",
      glueConnectionNames = list(
        "string"
      ),
      glueConnection = list(
        name = "string",
        description = "string",
        connectionType = "ATHENA"|"BIGQUERY"|"DATABRICKS"|"DOCUMENTDB"|"DYNAMODB"|"HYPERPOD"|"IAM"|"MYSQL"|"OPENSEARCH"|"ORACLE"|"POSTGRESQL"|"REDSHIFT"|"S3"|"SAPHANA"|"SNOWFLAKE"|"SPARK"|"SQLSERVER"|"TERADATA"|"VERTICA"|"WORKFLOWS_MWAA"|"AMAZON_Q"|"MLFLOW"|"VPC"|"GIT",
        matchCriteria = list(
          "string"
        ),
        connectionProperties = list(
          "string"
        ),
        sparkProperties = list(
          "string"
        ),
        athenaProperties = list(
          "string"
        ),
        pythonProperties = list(
          "string"
        ),
        physicalConnectionRequirements = list(
          subnetId = "string",
          subnetIdList = list(
            "string"
          ),
          securityGroupIdList = list(
            "string"
          ),
          availabilityZone = "string"
        ),
        creationTime = as.POSIXct(
          "2015-01-01"
        ),
        lastUpdatedTime = as.POSIXct(
          "2015-01-01"
        ),
        lastUpdatedBy = "string",
        status = "CREATING"|"CREATE_FAILED"|"DELETING"|"DELETE_FAILED"|"READY"|"UPDATING"|"UPDATE_FAILED"|"DELETED",
        statusReason = "string",
        lastConnectionValidationTime = as.POSIXct(
          "2015-01-01"
        ),
        authenticationConfiguration = list(
          authenticationType = "BASIC"|"OAUTH2"|"CUSTOM",
          secretArn = "string",
          oAuth2Properties = list(
            oAuth2GrantType = "AUTHORIZATION_CODE"|"CLIENT_CREDENTIALS"|"JWT_BEARER",
            oAuth2ClientApplication = list(
              userManagedClientApplicationClientId = "string",
              aWSManagedClientApplicationReference = "string"
            ),
            tokenUrl = "string",
            tokenUrlParametersMap = list(
              "string"
            ),
            authorizationCodeProperties = list(
              authorizationCode = "string",
              redirectUri = "string"
            ),
            oAuth2Credentials = list(
              userManagedClientApplicationClientSecret = "string",
              accessToken = "string",
              refreshToken = "string",
              jwtToken = "string"
            )
          )
        ),
        connectionSchemaVersion = 123,
        compatibleComputeEnvironments = list(
          "SPARK"|"ATHENA"|"PYTHON"
        )
      ),
      enableTrustedIdentityPropagation = TRUE|FALSE,
      host = "string",
      port = 123,
      protocol = "ATHENA"|"GLUE_INTERACTIVE_SESSION"|"HTTPS"|"JDBC"|"LIVY"|"ODBC"|"PRISM",
      stage = "string"
    )
  ),
  projectId = "string",
  props = list(
    athenaProperties = list(
      workgroupName = "string"
    ),
    glueProperties = list(
      status = "CREATING"|"CREATE_FAILED"|"DELETING"|"DELETE_FAILED"|"READY"|"UPDATING"|"UPDATE_FAILED"|"DELETED",
      errorMessage = "string"
    ),
    hyperPodProperties = list(
      clusterName = "string",
      clusterArn = "string",
      orchestrator = "EKS"|"SLURM"
    ),
    iamProperties = list(
      environmentId = "string",
      glueLineageSyncEnabled = TRUE|FALSE
    ),
    redshiftProperties = list(
      storage = list(
        clusterName = "string",
        workgroupName = "string"
      ),
      credentials = list(
        secretArn = "string",
        usernamePassword = list(
          password = "string",
          username = "string"
        )
      ),
      isProvisionedSecret = TRUE|FALSE,
      jdbcIamUrl = "string",
      jdbcUrl = "string",
      redshiftTempDir = "string",
      lineageSync = list(
        lineageJobId = "string",
        enabled = TRUE|FALSE,
        schedule = list(
          schedule = "string"
        )
      ),
      status = "CREATING"|"CREATE_FAILED"|"DELETING"|"DELETE_FAILED"|"READY"|"UPDATING"|"UPDATE_FAILED"|"DELETED",
      databaseName = "string"
    ),
    sparkEmrProperties = list(
      computeArn = "string",
      credentials = list(
        password = "string",
        username = "string"
      ),
      credentialsExpiration = as.POSIXct(
        "2015-01-01"
      ),
      governanceType = "AWS_MANAGED"|"USER_MANAGED",
      instanceProfileArn = "string",
      javaVirtualEnv = "string",
      livyEndpoint = "string",
      logUri = "string",
      pythonVirtualEnv = "string",
      runtimeRole = "string",
      trustedCertificatesS3Uri = "string",
      certificateData = "string",
      managedEndpointArn = "string",
      managedEndpointCredentials = list(
        id = "string",
        token = "string"
      )
    ),
    sparkGlueProperties = list(
      additionalArgs = list(
        connection = "string"
      ),
      glueConnectionName = "string",
      glueConnectionNames = list(
        "string"
      ),
      glueVersion = "string",
      idleTimeout = 123,
      javaVirtualEnv = "string",
      numberOfWorkers = 123,
      pythonVirtualEnv = "string",
      workerType = "string"
    ),
    s3Properties = list(
      s3Uri = "string",
      s3AccessGrantLocationId = "string",
      registerS3AccessGrantLocation = TRUE|FALSE,
      status = "CREATING"|"CREATE_FAILED"|"DELETING"|"DELETE_FAILED"|"READY"|"UPDATING"|"UPDATE_FAILED"|"DELETED",
      errorMessage = "string"
    ),
    snowflakeProperties = list(
      snowflakeRole = "string",
      identityMapping = list(
        usernameAttribute = "string",
        prefix = "string"
      ),
      lineageSync = list(
        lineageJobId = "string",
        timezone = "UTC"|"AFRICA_JOHANNESBURG"|"AMERICA_MONTREAL"|"AMERICA_SAO_PAULO"|"ASIA_BAHRAIN"|"ASIA_BANGKOK"|"ASIA_CALCUTTA"|"ASIA_DUBAI"|"ASIA_HONG_KONG"|"ASIA_JAKARTA"|"ASIA_KUALA_LUMPUR"|"ASIA_SEOUL"|"ASIA_SHANGHAI"|"ASIA_SINGAPORE"|"ASIA_TAIPEI"|"ASIA_TOKYO"|"AUSTRALIA_MELBOURNE"|"AUSTRALIA_SYDNEY"|"CANADA_CENTRAL"|"CET"|"CST6CDT"|"ETC_GMT"|"ETC_GMT0"|"ETC_GMT_ADD_0"|"ETC_GMT_ADD_1"|"ETC_GMT_ADD_10"|"ETC_GMT_ADD_11"|"ETC_GMT_ADD_12"|"ETC_GMT_ADD_2"|"ETC_GMT_ADD_3"|"ETC_GMT_ADD_4"|"ETC_GMT_ADD_5"|"ETC_GMT_ADD_6"|"ETC_GMT_ADD_7"|"ETC_GMT_ADD_8"|"ETC_GMT_ADD_9"|"ETC_GMT_NEG_0"|"ETC_GMT_NEG_1"|"ETC_GMT_NEG_10"|"ETC_GMT_NEG_11"|"ETC_GMT_NEG_12"|"ETC_GMT_NEG_13"|"ETC_GMT_NEG_14"|"ETC_GMT_NEG_2"|"ETC_GMT_NEG_3"|"ETC_GMT_NEG_4"|"ETC_GMT_NEG_5"|"ETC_GMT_NEG_6"|"ETC_GMT_NEG_7"|"ETC_GMT_NEG_8"|"ETC_GMT_NEG_9"|"EUROPE_DUBLIN"|"EUROPE_LONDON"|"EUROPE_PARIS"|"EUROPE_STOCKHOLM"|"EUROPE_ZURICH"|"ISRAEL"|"MEXICO_GENERAL"|"MST7MDT"|"PACIFIC_AUCKLAND"|"US_CENTRAL"|"US_EASTERN"|"US_MOUNTAIN"|"US_PACIFIC",
        enabled = TRUE|FALSE,
        schedule = "string"
      ),
      status = "CREATING"|"CREATE_FAILED"|"DELETING"|"DELETE_FAILED"|"READY"|"UPDATING"|"UPDATE_FAILED"|"DELETED",
      errorMessage = "string"
    ),
    amazonQProperties = list(
      isEnabled = TRUE|FALSE,
      profileArn = "string",
      authMode = "string"
    ),
    mlflowProperties = list(
      trackingServerArn = "string"
    ),
    workflowsMwaaProperties = list(
      mwaaEnvironmentName = "string"
    ),
    workflowsServerlessProperties = list(),
    lakehouseProperties = list(
      glueLineageSyncEnabled = TRUE|FALSE
    ),
    vpcProperties = list(
      vpcId = "string",
      subnetIds = list(
        "string"
      ),
      status = "CREATING"|"CREATE_FAILED"|"DELETING"|"DELETE_FAILED"|"READY"|"UPDATING"|"UPDATE_FAILED"|"DELETED",
      securityGroupId = "string",
      glueConnectionNames = list(
        "string"
      )
    ),
    gitProperties = list(
      codeConnectionArn = "string",
      repositoryId = "string",
      defaultBranch = "string",
      status = "CREATING"|"CREATE_FAILED"|"DELETING"|"DELETE_FAILED"|"READY"|"UPDATING"|"UPDATE_FAILED"|"DELETED",
      errorMessage = "string"
    )
  ),
  type = "ATHENA"|"BIGQUERY"|"DATABRICKS"|"DOCUMENTDB"|"DYNAMODB"|"HYPERPOD"|"IAM"|"MYSQL"|"OPENSEARCH"|"ORACLE"|"POSTGRESQL"|"REDSHIFT"|"S3"|"SAPHANA"|"SNOWFLAKE"|"SPARK"|"SQLSERVER"|"TERADATA"|"VERTICA"|"WORKFLOWS_MWAA"|"AMAZON_Q"|"MLFLOW"|"VPC"|"GIT",
  scope = "DOMAIN"|"PROJECT"
)

Request syntax

svc$update_connection(
  configurations = list(
    list(
      classification = "string",
      properties = list(
        "string"
      )
    )
  ),
  domainIdentifier = "string",
  identifier = "string",
  description = "string",
  awsLocation = list(
    accessRole = "string",
    awsAccountId = "string",
    awsRegion = "string",
    iamConnectionId = "string"
  ),
  props = list(
    athenaProperties = list(
      workgroupName = "string"
    ),
    glueProperties = list(
      glueConnectionInput = list(
        description = "string",
        connectionProperties = list(
          "string"
        ),
        authenticationConfiguration = list(
          secretArn = "string",
          basicAuthenticationCredentials = list(
            userName = "string",
            password = "string"
          )
        )
      )
    ),
    iamProperties = list(
      glueLineageSyncEnabled = TRUE|FALSE
    ),
    redshiftProperties = list(
      storage = list(
        clusterName = "string",
        workgroupName = "string"
      ),
      databaseName = "string",
      host = "string",
      port = 123,
      credentials = list(
        secretArn = "string",
        usernamePassword = list(
          password = "string",
          username = "string"
        )
      ),
      lineageSync = list(
        enabled = TRUE|FALSE,
        schedule = list(
          schedule = "string"
        )
      )
    ),
    sparkEmrProperties = list(
      computeArn = "string",
      instanceProfileArn = "string",
      javaVirtualEnv = "string",
      logUri = "string",
      pythonVirtualEnv = "string",
      runtimeRole = "string",
      trustedCertificatesS3Uri = "string",
      managedEndpointArn = "string"
    ),
    s3Properties = list(
      s3Uri = "string",
      s3AccessGrantLocationId = "string",
      registerS3AccessGrantLocation = TRUE|FALSE
    ),
    snowflakeProperties = list(
      connectivityPropertiesPatch = list(
        description = "string",
        connectionProperties = list(
          "string"
        ),
        authenticationConfiguration = list(
          secretArn = "string",
          basicAuthenticationCredentials = list(
            userName = "string",
            password = "string"
          )
        )
      ),
      snowflakeRole = "string",
      lineageSync = list(
        timezone = "UTC"|"AFRICA_JOHANNESBURG"|"AMERICA_MONTREAL"|"AMERICA_SAO_PAULO"|"ASIA_BAHRAIN"|"ASIA_BANGKOK"|"ASIA_CALCUTTA"|"ASIA_DUBAI"|"ASIA_HONG_KONG"|"ASIA_JAKARTA"|"ASIA_KUALA_LUMPUR"|"ASIA_SEOUL"|"ASIA_SHANGHAI"|"ASIA_SINGAPORE"|"ASIA_TAIPEI"|"ASIA_TOKYO"|"AUSTRALIA_MELBOURNE"|"AUSTRALIA_SYDNEY"|"CANADA_CENTRAL"|"CET"|"CST6CDT"|"ETC_GMT"|"ETC_GMT0"|"ETC_GMT_ADD_0"|"ETC_GMT_ADD_1"|"ETC_GMT_ADD_10"|"ETC_GMT_ADD_11"|"ETC_GMT_ADD_12"|"ETC_GMT_ADD_2"|"ETC_GMT_ADD_3"|"ETC_GMT_ADD_4"|"ETC_GMT_ADD_5"|"ETC_GMT_ADD_6"|"ETC_GMT_ADD_7"|"ETC_GMT_ADD_8"|"ETC_GMT_ADD_9"|"ETC_GMT_NEG_0"|"ETC_GMT_NEG_1"|"ETC_GMT_NEG_10"|"ETC_GMT_NEG_11"|"ETC_GMT_NEG_12"|"ETC_GMT_NEG_13"|"ETC_GMT_NEG_14"|"ETC_GMT_NEG_2"|"ETC_GMT_NEG_3"|"ETC_GMT_NEG_4"|"ETC_GMT_NEG_5"|"ETC_GMT_NEG_6"|"ETC_GMT_NEG_7"|"ETC_GMT_NEG_8"|"ETC_GMT_NEG_9"|"EUROPE_DUBLIN"|"EUROPE_LONDON"|"EUROPE_PARIS"|"EUROPE_STOCKHOLM"|"EUROPE_ZURICH"|"ISRAEL"|"MEXICO_GENERAL"|"MST7MDT"|"PACIFIC_AUCKLAND"|"US_CENTRAL"|"US_EASTERN"|"US_MOUNTAIN"|"US_PACIFIC",
        enabled = TRUE|FALSE,
        schedule = "string"
      )
    ),
    amazonQProperties = list(
      isEnabled = TRUE|FALSE,
      profileArn = "string",
      authMode = "string"
    ),
    mlflowProperties = list(
      trackingServerArn = "string"
    ),
    lakehouseProperties = list(
      glueLineageSyncEnabled = TRUE|FALSE
    ),
    vpcProperties = list(
      vpcId = "string",
      subnetIds = list(
        "string"
      ),
      securityGroupId = "string"
    ),
    gitProperties = list(
      codeConnectionArn = "string",
      defaultBranch = "string"
    )
  )
)