Amazon DataZone

2026/09/24 - Amazon DataZone - 5 updated api methods

Changes  Amazon DataZone now supports the TOOLING blueprint category on CreateEnvironmentBlueprint, UpdateEnvironmentBlueprint, GetEnvironmentBlueprint, and ListEnvironmentBlueprints, for custom tooling blueprints. CreateConnection now accepts roleArn in iamProperties.

CreateConnection (updated) Link ¶
Changes (request)
{'props': {'iamProperties': {'roleArn': 'string'}}}

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

See also: AWS API Documentation

Request Syntax

client.create_connection(
    awsLocation={
        'accessRole': 'string',
        'awsAccountId': 'string',
        'awsRegion': 'string',
        'iamConnectionId': 'string'
    },
    clientToken='string',
    configurations=[
        {
            'classification': 'string',
            'properties': {
                'string': 'string'
            }
        },
    ],
    description='string',
    domainIdentifier='string',
    environmentIdentifier='string',
    name='string',
    props={
        'athenaProperties': {
            'workgroupName': 'string'
        },
        'glueProperties': {
            'glueConnectionInput': {
                'connectionProperties': {
                    'string': 'string'
                },
                'physicalConnectionRequirements': {
                    'subnetId': 'string',
                    'subnetIdList': [
                        'string',
                    ],
                    'securityGroupIdList': [
                        'string',
                    ],
                    'availabilityZone': 'string'
                },
                'name': 'string',
                'description': 'string',
                'connectionType': 'SNOWFLAKE'|'BIGQUERY'|'DOCUMENTDB'|'DYNAMODB'|'MYSQL'|'OPENSEARCH'|'ORACLE'|'POSTGRESQL'|'REDSHIFT'|'SAPHANA'|'SQLSERVER'|'TERADATA'|'VERTICA',
                'matchCriteria': 'string',
                'validateCredentials': True|False,
                'validateForComputeEnvironments': [
                    'SPARK'|'ATHENA'|'PYTHON',
                ],
                'sparkProperties': {
                    'string': 'string'
                },
                'athenaProperties': {
                    'string': 'string'
                },
                'pythonProperties': {
                    'string': 'string'
                },
                'authenticationConfiguration': {
                    'authenticationType': 'BASIC'|'OAUTH2'|'CUSTOM',
                    'oAuth2Properties': {
                        'oAuth2GrantType': 'AUTHORIZATION_CODE'|'CLIENT_CREDENTIALS'|'JWT_BEARER',
                        'oAuth2ClientApplication': {
                            'userManagedClientApplicationClientId': 'string',
                            'aWSManagedClientApplicationReference': 'string'
                        },
                        'tokenUrl': 'string',
                        'tokenUrlParametersMap': {
                            'string': 'string'
                        },
                        'authorizationCodeProperties': {
                            'authorizationCode': 'string',
                            'redirectUri': 'string'
                        },
                        'oAuth2Credentials': {
                            'userManagedClientApplicationClientSecret': 'string',
                            'accessToken': 'string',
                            'refreshToken': 'string',
                            'jwtToken': 'string'
                        }
                    },
                    'secretArn': 'string',
                    'kmsKeyArn': 'string',
                    'basicAuthenticationCredentials': {
                        'userName': 'string',
                        'password': 'string'
                    },
                    'customAuthenticationCredentials': {
                        'string': 'string'
                    }
                }
            }
        },
        'hyperPodProperties': {
            'clusterName': 'string'
        },
        'iamProperties': {
            'glueLineageSyncEnabled': True|False,
            'roleArn': 'string'
        },
        'redshiftProperties': {
            'storage': {
                'clusterName': 'string',
                'workgroupName': 'string'
            },
            'databaseName': 'string',
            'host': 'string',
            'port': 123,
            'credentials': {
                'secretArn': 'string',
                'usernamePassword': {
                    'password': 'string',
                    'username': 'string'
                }
            },
            'lineageSync': {
                'enabled': True|False,
                'schedule': {
                    'schedule': 'string'
                }
            }
        },
        'sparkEmrProperties': {
            'computeArn': 'string',
            'instanceProfileArn': 'string',
            'javaVirtualEnv': 'string',
            'logUri': 'string',
            'pythonVirtualEnv': 'string',
            'runtimeRole': 'string',
            'trustedCertificatesS3Uri': 'string',
            'managedEndpointArn': 'string'
        },
        'sparkGlueProperties': {
            'additionalArgs': {
                'connection': 'string'
            },
            'glueConnectionName': 'string',
            'glueConnectionNames': [
                'string',
            ],
            'glueVersion': 'string',
            'idleTimeout': 123,
            'javaVirtualEnv': 'string',
            'numberOfWorkers': 123,
            'pythonVirtualEnv': 'string',
            'workerType': 'string'
        },
        's3Properties': {
            's3Uri': 'string',
            's3AccessGrantLocationId': 'string',
            'registerS3AccessGrantLocation': True|False
        },
        'snowflakeProperties': {
            'connectivityProperties': {
                'connectionProperties': {
                    'string': 'string'
                },
                'physicalConnectionRequirements': {
                    'subnetId': 'string',
                    'subnetIdList': [
                        'string',
                    ],
                    'securityGroupIdList': [
                        'string',
                    ],
                    'availabilityZone': 'string'
                },
                'name': 'string',
                'description': 'string',
                'validateCredentials': True|False,
                'validateForComputeEnvironments': [
                    'SPARK'|'ATHENA'|'PYTHON',
                ],
                'sparkProperties': {
                    'string': 'string'
                },
                'athenaProperties': {
                    'string': 'string'
                },
                'pythonProperties': {
                    'string': 'string'
                },
                'authenticationConfiguration': {
                    'authenticationType': 'BASIC'|'OAUTH2'|'CUSTOM',
                    'oAuth2Properties': {
                        'oAuth2GrantType': 'AUTHORIZATION_CODE'|'CLIENT_CREDENTIALS'|'JWT_BEARER',
                        'oAuth2ClientApplication': {
                            'userManagedClientApplicationClientId': 'string',
                            'aWSManagedClientApplicationReference': 'string'
                        },
                        'tokenUrl': 'string',
                        'tokenUrlParametersMap': {
                            'string': 'string'
                        },
                        'authorizationCodeProperties': {
                            'authorizationCode': 'string',
                            'redirectUri': 'string'
                        },
                        'oAuth2Credentials': {
                            'userManagedClientApplicationClientSecret': 'string',
                            'accessToken': 'string',
                            'refreshToken': 'string',
                            'jwtToken': 'string'
                        }
                    },
                    'secretArn': 'string',
                    'kmsKeyArn': 'string',
                    'basicAuthenticationCredentials': {
                        'userName': 'string',
                        'password': 'string'
                    },
                    'customAuthenticationCredentials': {
                        'string': 'string'
                    }
                }
            },
            'snowflakeRole': 'string',
            'identityMapping': {
                'usernameAttribute': 'string',
                'prefix': 'string'
            },
            'lineageSync': {
                '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': {
            'isEnabled': True|False,
            'profileArn': 'string',
            'authMode': 'string'
        },
        'mlflowProperties': {
            'trackingServerArn': 'string'
        },
        'workflowsMwaaProperties': {
            'mwaaEnvironmentName': 'string'
        },
        'workflowsServerlessProperties': {}
        ,
        'lakehouseProperties': {
            'glueLineageSyncEnabled': True|False
        },
        'vpcProperties': {
            'vpcId': 'string',
            'subnetIds': [
                'string',
            ],
            'securityGroupId': 'string'
        },
        'gitProperties': {
            'codeConnectionArn': 'string',
            'repositoryId': 'string',
            'defaultBranch': 'string'
        }
    },
    enableTrustedIdentityPropagation=True|False,
    scope='DOMAIN'|'PROJECT'
)
type awsLocation:

dict

param awsLocation:

The location where the connection is created.

  • accessRole (string) --

    The access role of a connection.

  • awsAccountId (string) --

    The account ID of a connection.

  • awsRegion (string) --

    The Region of a connection.

  • iamConnectionId (string) --

    The IAM connection ID of a connection.

type clientToken:

string

param clientToken:

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type configurations:

list

param configurations:

The configurations of the connection.

  • (dict) --

    The configuration of a connection.

    • classification (string) --

      The classification of the connection configuration.

    • properties (dict) --

      The properties of the connection configuration.

      • (string) --

        • (string) --

type description:

string

param description:

A connection description.

type domainIdentifier:

string

param domainIdentifier:

[REQUIRED]

The ID of the domain where the connection is created.

type environmentIdentifier:

string

param environmentIdentifier:

The ID of the environment where the connection is created.

type name:

string

param name:

[REQUIRED]

The connection name.

type props:

dict

param props:

The connection props.

  • athenaProperties (dict) --

    The Amazon Athena properties of a connection.

    • workgroupName (string) --

      The Amazon Athena workgroup name of a connection.

  • glueProperties (dict) --

    The Amazon Web Services Glue properties of a connection.

    • glueConnectionInput (dict) --

      The Amazon Web Services Glue connection.

      • connectionProperties (dict) --

        The connection properties of the Amazon Web Services Glue connection.

        • (string) --

          • (string) --

      • physicalConnectionRequirements (dict) --

        The physical connection requirements for the Amazon Web Services Glue connection.

        • subnetId (string) --

          The subnet ID of the physical connection requirements of a connection.

        • subnetIdList (list) --

          The subnet ID list of the physical connection requirements of a connection.

          • (string) --

        • securityGroupIdList (list) --

          The group ID list of the physical connection requirements of a connection.

          • (string) --

        • availabilityZone (string) --

          The availability zone of the physical connection requirements of a connection.

      • name (string) --

        The name of the Amazon Web Services Glue connection.

      • description (string) --

        The description of the Amazon Web Services Glue connection.

      • connectionType (string) --

        The connection type of the Amazon Web Services Glue connection.

      • matchCriteria (string) --

        The match criteria of the Amazon Web Services Glue connection.

      • validateCredentials (boolean) --

        Speciefies whether to validate credentials of the Amazon Web Services Glue connection.

      • validateForComputeEnvironments (list) --

        Speciefies whether to validate for compute environments of the Amazon Web Services Glue connection.

        • (string) --

      • sparkProperties (dict) --

        The Spark properties of the Amazon Web Services Glue connection.

        • (string) --

          • (string) --

      • athenaProperties (dict) --

        The Amazon Athena properties of the Amazon Web Services Glue connection.

        • (string) --

          • (string) --

      • pythonProperties (dict) --

        The Python properties of the Amazon Web Services Glue connection.

        • (string) --

          • (string) --

      • authenticationConfiguration (dict) --

        The authentication configuration of the Amazon Web Services Glue connection.

        • authenticationType (string) --

          The authentication type of a connection.

        • oAuth2Properties (dict) --

          The oAuth2 properties of a connection.

          • oAuth2GrantType (string) --

            The OAuth2 grant type of the OAuth2 properties.

          • oAuth2ClientApplication (dict) --

            The OAuth2 client application of the OAuth2 properties.

            • userManagedClientApplicationClientId (string) --

              The user managed client application client ID in the OAuth2Client application.

            • aWSManagedClientApplicationReference (string) --

              The Amazon Web Services managed client application reference in the OAuth2Client application.

          • tokenUrl (string) --

            The OAuth2 token URL of the OAuth2 properties.

          • tokenUrlParametersMap (dict) --

            The OAuth2 token URL parameter map of the OAuth2 properties.

            • (string) --

              • (string) --

          • authorizationCodeProperties (dict) --

            The authorization code properties of the OAuth2 properties.

            • authorizationCode (string) --

              The authorization code of a connection.

            • redirectUri (string) --

              The redirect URI of a connection.

          • oAuth2Credentials (dict) --

            The OAuth2 credentials of the OAuth2 properties.

            • userManagedClientApplicationClientSecret (string) --

              The user managed client application client secret of the connection.

            • accessToken (string) --

              The access token of a connection.

            • refreshToken (string) --

              The refresh token of the connection.

            • jwtToken (string) --

              The jwt token of the connection.

        • secretArn (string) --

          The secret ARN of a connection.

        • kmsKeyArn (string) --

          The KMS key ARN of a connection.

        • basicAuthenticationCredentials (dict) --

          The basic authentication credentials of a connection.

          • userName (string) --

            The user name for the connecion.

          • password (string) --

            The password for a connection.

        • customAuthenticationCredentials (dict) --

          The custom authentication credentials of a connection.

          • (string) --

            • (string) --

  • hyperPodProperties (dict) --

    The hyper pod properties of a connection.

    • clusterName (string) -- [REQUIRED]

      The cluster name the hyper pod properties.

  • iamProperties (dict) --

    The IAM properties of a connection.

    • glueLineageSyncEnabled (boolean) --

      Specifies whether Amazon Web Services Glue lineage sync is enabled for a connection.

    • roleArn (string) --

      The ARN of the IAM role to associate with the connection as the project user role. To use this operation, you must have iam:PassRole permission for this role.

  • redshiftProperties (dict) --

    The Amazon Redshift properties of a connection.

    • storage (dict) --

      The Amazon Redshift storage.

      • clusterName (string) --

        The cluster name in the Amazon Redshift storage properties.

      • workgroupName (string) --

        The workgroup name in the Amazon Redshift storage properties.

    • databaseName (string) --

      The Amazon Redshift database name.

    • host (string) --

      The Amazon Redshift host.

    • port (integer) --

      The Amaon Redshift port.

    • credentials (dict) --

      The Amaon Redshift credentials.

      • secretArn (string) --

        The secret ARN of the Amazon Redshift credentials of a connection.

      • usernamePassword (dict) --

        The username and password of the Amazon Redshift credentials of a connection.

        • password (string) -- [REQUIRED]

          The password of a connection.

        • username (string) -- [REQUIRED]

          The username of a connection.

    • lineageSync (dict) --

      The lineage sync of the Amazon Redshift.

      • enabled (boolean) --

        Specifies whether the Amaon Redshift lineage sync configuration is enabled.

      • schedule (dict) --

        The schedule of the Amaon Redshift lineage sync configuration.

        • schedule (string) --

          The lineage sync schedule.

  • sparkEmrProperties (dict) --

    The Spark EMR properties of a connection.

    • computeArn (string) --

      The compute ARN of Spark EMR.

    • instanceProfileArn (string) --

      The instance profile ARN of Spark EMR.

    • javaVirtualEnv (string) --

      The java virtual env of the Spark EMR.

    • logUri (string) --

      The log URI of the Spark EMR.

    • pythonVirtualEnv (string) --

      The Python virtual env of the Spark EMR.

    • runtimeRole (string) --

      The runtime role of the Spark EMR.

    • trustedCertificatesS3Uri (string) --

      The certificates S3 URI of the Spark EMR.

    • managedEndpointArn (string) --

      The managed endpoint ARN of the EMR on EKS cluster.

  • sparkGlueProperties (dict) --

    The Spark Amazon Web Services Glue properties of a connection.

    • additionalArgs (dict) --

      The additional args in the Spark Amazon Web Services Glue properties.

      • connection (string) --

        The connection in the Spark Amazon Web Services Glue args.

    • glueConnectionName (string) --

      The Amazon Web Services Glue connection name in the Spark Amazon Web Services Glue properties. Specify either glueConnectionName or glueConnectionNames, but not both.

    • glueConnectionNames (list) --

      The Amazon Web Services Glue connection names in the Spark Amazon Web Services Glue properties. Specify either glueConnectionName or glueConnectionNames, but not both.

      • (string) --

    • glueVersion (string) --

      The Amazon Web Services Glue version in the Spark Amazon Web Services Glue properties.

    • idleTimeout (integer) --

      The idle timeout in the Spark Amazon Web Services Glue properties.

    • javaVirtualEnv (string) --

      The Java virtual env in the Spark Amazon Web Services Glue properties.

    • numberOfWorkers (integer) --

      The number of workers in the Spark Amazon Web Services Glue properties.

    • pythonVirtualEnv (string) --

      The Python virtual env in the Spark Amazon Web Services Glue properties.

    • workerType (string) --

      The worker type in the Spark Amazon Web Services Glue properties.

  • s3Properties (dict) --

    The Amazon S3 properties of a connection.

    • s3Uri (string) -- [REQUIRED]

      The Amazon S3 URI that's part of the Amazon S3 properties of a connection.

    • s3AccessGrantLocationId (string) --

      The Amazon S3 Access Grant location ID that's part of the Amazon S3 properties of a connection.

    • registerS3AccessGrantLocation (boolean) --

      Specifies whether to register the Amazon S3 Access Grant location.

  • snowflakeProperties (dict) --

    The Snowflake-specific connection properties to use when creating the connection.

    • connectivityProperties (dict) --

      The connectivity properties of the Snowflake connection.

      • connectionProperties (dict) --

        The connection properties for this configuration.

        • (string) --

          • (string) --

      • physicalConnectionRequirements (dict) --

        The physical network requirements for the connection, such as the subnet, security group, and VPC settings needed to reach the data source.

        • subnetId (string) --

          The subnet ID of the physical connection requirements of a connection.

        • subnetIdList (list) --

          The subnet ID list of the physical connection requirements of a connection.

          • (string) --

        • securityGroupIdList (list) --

          The group ID list of the physical connection requirements of a connection.

          • (string) --

        • availabilityZone (string) --

          The availability zone of the physical connection requirements of a connection.

      • name (string) --

        The name of the connectivity configuration.

      • description (string) --

        The description of the connectivity configuration.

      • validateCredentials (boolean) --

        Specifies whether to validate credentials for the connectivity configuration. Defaults to true if not specified.

      • validateForComputeEnvironments (list) --

        The compute environments to use when validating connectivity. The service validates that the connection is reachable from each specified environment.

        • (string) --

      • sparkProperties (dict) --

        The Spark properties for this configuration.

        • (string) --

          • (string) --

      • athenaProperties (dict) --

        The Athena properties for this configuration.

        • (string) --

          • (string) --

      • pythonProperties (dict) --

        The Python properties for this configuration.

        • (string) --

          • (string) --

      • authenticationConfiguration (dict) --

        The authentication settings for this configuration.

        • authenticationType (string) --

          The authentication type of a connection.

        • oAuth2Properties (dict) --

          The oAuth2 properties of a connection.

          • oAuth2GrantType (string) --

            The OAuth2 grant type of the OAuth2 properties.

          • oAuth2ClientApplication (dict) --

            The OAuth2 client application of the OAuth2 properties.

            • userManagedClientApplicationClientId (string) --

              The user managed client application client ID in the OAuth2Client application.

            • aWSManagedClientApplicationReference (string) --

              The Amazon Web Services managed client application reference in the OAuth2Client application.

          • tokenUrl (string) --

            The OAuth2 token URL of the OAuth2 properties.

          • tokenUrlParametersMap (dict) --

            The OAuth2 token URL parameter map of the OAuth2 properties.

            • (string) --

              • (string) --

          • authorizationCodeProperties (dict) --

            The authorization code properties of the OAuth2 properties.

            • authorizationCode (string) --

              The authorization code of a connection.

            • redirectUri (string) --

              The redirect URI of a connection.

          • oAuth2Credentials (dict) --

            The OAuth2 credentials of the OAuth2 properties.

            • userManagedClientApplicationClientSecret (string) --

              The user managed client application client secret of the connection.

            • accessToken (string) --

              The access token of a connection.

            • refreshToken (string) --

              The refresh token of the connection.

            • jwtToken (string) --

              The jwt token of the connection.

        • secretArn (string) --

          The secret ARN of a connection.

        • kmsKeyArn (string) --

          The KMS key ARN of a connection.

        • basicAuthenticationCredentials (dict) --

          The basic authentication credentials of a connection.

          • userName (string) --

            The user name for the connecion.

          • password (string) --

            The password for a connection.

        • customAuthenticationCredentials (dict) --

          The custom authentication credentials of a connection.

          • (string) --

            • (string) --

    • snowflakeRole (string) -- [REQUIRED]

      The Snowflake role used to access Snowflake resources.

    • identityMapping (dict) -- [REQUIRED]

      The identity mapping configuration for the Snowflake connection.

      • usernameAttribute (string) -- [REQUIRED]

        The username attribute used for the identity mapping.

      • prefix (string) --

        The prefix used for the identity mapping.

    • lineageSync (dict) --

      The lineage sync configuration for the Snowflake connection.

      • timezone (string) --

        The timezone of the lineage sync schedule.

      • enabled (boolean) -- [REQUIRED]

        Specifies whether lineage sync is enabled.

      • schedule (string) --

        The schedule of the lineage sync.

  • amazonQProperties (dict) --

    The Amazon Q properties of the connection.

    • isEnabled (boolean) -- [REQUIRED]

      Specifies whether Amazon Q is enabled for the connection.

    • profileArn (string) --

      The profile ARN of the connection's Amazon Q properties.

    • authMode (string) --

      The authentication mode of the connection's Amazon Q properties.

  • mlflowProperties (dict) --

    The MLflow properties of a connection.

    • trackingServerArn (string) --

      The tracking server ARN as part of the MLflow properties of a connection.

  • workflowsMwaaProperties (dict) --

    The Amazon MWAA properties of a connection.

    • mwaaEnvironmentName (string) --

      The MWAA environment name.

  • workflowsServerlessProperties (dict) --

    The MWAA serverless properties of a connection.

  • lakehouseProperties (dict) --

    The lakehouse properties of a connection.

    • glueLineageSyncEnabled (boolean) --

      Specifies whether to enable Glue lineage sync for tables managed by Glue crawlers.

  • vpcProperties (dict) --

    The VPC properties of a connection.

    • vpcId (string) -- [REQUIRED]

      The identifier of the VPC. Must match the pattern ^vpc-[a-z0-9]+$. Maximum length of 32.

    • subnetIds (list) -- [REQUIRED]

      The subnet IDs of the VPC connection. You can specify between 1 and 16 subnet IDs.

      • (string) --

    • securityGroupId (string) --

      The security group ID of the VPC connection. Must match the pattern ^sg-[a-z0-9]+$. Maximum length of 32.

  • gitProperties (dict) --

    The Git properties of a connection.

    • codeConnectionArn (string) -- [REQUIRED]

      The ARN of the CodeConnections connection used to connect to the Git repository.

    • repositoryId (string) -- [REQUIRED]

      The ID of the Git repository. This is the owner and repository name, for example, owner/repo-name.

    • defaultBranch (string) -- [REQUIRED]

      The default branch of the Git repository.

type enableTrustedIdentityPropagation:

boolean

param enableTrustedIdentityPropagation:

Specifies whether the trusted identity propagation is enabled.

type scope:

string

param scope:

The scope of the connection.

rtype:

dict

returns:

Response Syntax

{
    'connectionId': 'string',
    'configurations': [
        {
            'classification': 'string',
            'properties': {
                'string': 'string'
            }
        },
    ],
    'description': 'string',
    'domainId': 'string',
    'domainUnitId': 'string',
    'environmentId': 'string',
    'name': 'string',
    'physicalEndpoints': [
        {
            'awsLocation': {
                'accessRole': 'string',
                'awsAccountId': 'string',
                'awsRegion': 'string',
                'iamConnectionId': 'string'
            },
            'glueConnectionName': 'string',
            'glueConnectionNames': [
                'string',
            ],
            'glueConnection': {
                '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': [
                    'string',
                ],
                'connectionProperties': {
                    'string': 'string'
                },
                'sparkProperties': {
                    'string': 'string'
                },
                'athenaProperties': {
                    'string': 'string'
                },
                'pythonProperties': {
                    'string': 'string'
                },
                'physicalConnectionRequirements': {
                    'subnetId': 'string',
                    'subnetIdList': [
                        'string',
                    ],
                    'securityGroupIdList': [
                        'string',
                    ],
                    'availabilityZone': 'string'
                },
                'creationTime': datetime(2015, 1, 1),
                'lastUpdatedTime': datetime(2015, 1, 1),
                'lastUpdatedBy': 'string',
                'status': 'CREATING'|'CREATE_FAILED'|'DELETING'|'DELETE_FAILED'|'READY'|'UPDATING'|'UPDATE_FAILED'|'DELETED',
                'statusReason': 'string',
                'lastConnectionValidationTime': datetime(2015, 1, 1),
                'authenticationConfiguration': {
                    'authenticationType': 'BASIC'|'OAUTH2'|'CUSTOM',
                    'secretArn': 'string',
                    'oAuth2Properties': {
                        'oAuth2GrantType': 'AUTHORIZATION_CODE'|'CLIENT_CREDENTIALS'|'JWT_BEARER',
                        'oAuth2ClientApplication': {
                            'userManagedClientApplicationClientId': 'string',
                            'aWSManagedClientApplicationReference': 'string'
                        },
                        'tokenUrl': 'string',
                        'tokenUrlParametersMap': {
                            'string': 'string'
                        },
                        'authorizationCodeProperties': {
                            'authorizationCode': 'string',
                            'redirectUri': 'string'
                        },
                        'oAuth2Credentials': {
                            'userManagedClientApplicationClientSecret': 'string',
                            'accessToken': 'string',
                            'refreshToken': 'string',
                            'jwtToken': 'string'
                        }
                    }
                },
                'connectionSchemaVersion': 123,
                'compatibleComputeEnvironments': [
                    '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': {
        'athenaProperties': {
            'workgroupName': 'string'
        },
        'glueProperties': {
            'status': 'CREATING'|'CREATE_FAILED'|'DELETING'|'DELETE_FAILED'|'READY'|'UPDATING'|'UPDATE_FAILED'|'DELETED',
            'errorMessage': 'string'
        },
        'hyperPodProperties': {
            'clusterName': 'string',
            'clusterArn': 'string',
            'orchestrator': 'EKS'|'SLURM'
        },
        'iamProperties': {
            'environmentId': 'string',
            'glueLineageSyncEnabled': True|False
        },
        'redshiftProperties': {
            'storage': {
                'clusterName': 'string',
                'workgroupName': 'string'
            },
            'credentials': {
                'secretArn': 'string',
                'usernamePassword': {
                    'password': 'string',
                    'username': 'string'
                }
            },
            'isProvisionedSecret': True|False,
            'jdbcIamUrl': 'string',
            'jdbcUrl': 'string',
            'redshiftTempDir': 'string',
            'lineageSync': {
                'lineageJobId': 'string',
                'enabled': True|False,
                'schedule': {
                    'schedule': 'string'
                }
            },
            'status': 'CREATING'|'CREATE_FAILED'|'DELETING'|'DELETE_FAILED'|'READY'|'UPDATING'|'UPDATE_FAILED'|'DELETED',
            'databaseName': 'string'
        },
        'sparkEmrProperties': {
            'computeArn': 'string',
            'credentials': {
                'password': 'string',
                'username': 'string'
            },
            'credentialsExpiration': datetime(2015, 1, 1),
            'governanceType': 'AWS_MANAGED'|'USER_MANAGED',
            'instanceProfileArn': 'string',
            'javaVirtualEnv': 'string',
            'livyEndpoint': 'string',
            'logUri': 'string',
            'pythonVirtualEnv': 'string',
            'runtimeRole': 'string',
            'trustedCertificatesS3Uri': 'string',
            'certificateData': 'string',
            'managedEndpointArn': 'string',
            'managedEndpointCredentials': {
                'id': 'string',
                'token': 'string'
            }
        },
        'sparkGlueProperties': {
            'additionalArgs': {
                'connection': 'string'
            },
            'glueConnectionName': 'string',
            'glueConnectionNames': [
                'string',
            ],
            'glueVersion': 'string',
            'idleTimeout': 123,
            'javaVirtualEnv': 'string',
            'numberOfWorkers': 123,
            'pythonVirtualEnv': 'string',
            'workerType': 'string'
        },
        's3Properties': {
            's3Uri': 'string',
            's3AccessGrantLocationId': 'string',
            'registerS3AccessGrantLocation': True|False,
            'status': 'CREATING'|'CREATE_FAILED'|'DELETING'|'DELETE_FAILED'|'READY'|'UPDATING'|'UPDATE_FAILED'|'DELETED',
            'errorMessage': 'string'
        },
        'snowflakeProperties': {
            'snowflakeRole': 'string',
            'identityMapping': {
                'usernameAttribute': 'string',
                'prefix': 'string'
            },
            'lineageSync': {
                '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': {
            'isEnabled': True|False,
            'profileArn': 'string',
            'authMode': 'string'
        },
        'mlflowProperties': {
            'trackingServerArn': 'string'
        },
        'workflowsMwaaProperties': {
            'mwaaEnvironmentName': 'string'
        },
        'workflowsServerlessProperties': {},
        'lakehouseProperties': {
            'glueLineageSyncEnabled': True|False
        },
        'vpcProperties': {
            'vpcId': 'string',
            'subnetIds': [
                'string',
            ],
            'status': 'CREATING'|'CREATE_FAILED'|'DELETING'|'DELETE_FAILED'|'READY'|'UPDATING'|'UPDATE_FAILED'|'DELETED',
            'securityGroupId': 'string',
            'glueConnectionNames': [
                'string',
            ]
        },
        'gitProperties': {
            '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'
}

Response Structure

  • (dict) --

    • connectionId (string) --

      The ID of the connection.

    • configurations (list) --

      The configurations of the connection.

      • (dict) --

        The configuration of a connection.

        • classification (string) --

          The classification of the connection configuration.

        • properties (dict) --

          The properties of the connection configuration.

          • (string) --

            • (string) --

    • description (string) --

      The connection description.

    • domainId (string) --

      The ID of the domain where the connection is created.

    • domainUnitId (string) --

      The ID of the domain unit where the connection is created.

    • environmentId (string) --

      The ID of the environment where the connection is created.

    • name (string) --

      The connection name.

    • physicalEndpoints (list) --

      The physical endpoints of the connection.

      • (dict) --

        The physical endpoints of a connection.

        • awsLocation (dict) --

          The location of a connection.

          • accessRole (string) --

            The access role of a connection.

          • awsAccountId (string) --

            The account ID of a connection.

          • awsRegion (string) --

            The Region of a connection.

          • iamConnectionId (string) --

            The IAM connection ID of a connection.

        • glueConnectionName (string) --

          The Amazon Web Services Glue connection name.

        • glueConnectionNames (list) --

          The Amazon Web Services Glue connection names in the physical endpoint.

          • (string) --

        • glueConnection (dict) --

          The Amazon Web Services Glue connection.

          • name (string) --

            The name of the Amazon Web Services Glue connection.

          • description (string) --

            The description of the Amazon Web Services Glue connection.

          • connectionType (string) --

            The type of the Amazon Web Services Glue connection.

          • matchCriteria (list) --

            The match criteria of the Amazon Web Services Glue connection.

            • (string) --

          • connectionProperties (dict) --

            The properties of the Amazon Web Services Glue connection.

            • (string) --

              • (string) --

          • sparkProperties (dict) --

            The Spark properties of the Amazon Web Services Glue connection.

            • (string) --

              • (string) --

          • athenaProperties (dict) --

            The Amazon Athena properties of the Amazon Web Services Glue connection.

            • (string) --

              • (string) --

          • pythonProperties (dict) --

            The Python properties of the Amazon Web Services Glue connection.

            • (string) --

              • (string) --

          • physicalConnectionRequirements (dict) --

            The physical connection requirements of the Amazon Web Services Glue connection.

            • subnetId (string) --

              The subnet ID of the physical connection requirements of a connection.

            • subnetIdList (list) --

              The subnet ID list of the physical connection requirements of a connection.

              • (string) --

            • securityGroupIdList (list) --

              The group ID list of the physical connection requirements of a connection.

              • (string) --

            • availabilityZone (string) --

              The availability zone of the physical connection requirements of a connection.

          • creationTime (datetime) --

            The creation time of the Amazon Web Services Glue connection.

          • lastUpdatedTime (datetime) --

            The timestamp at which the Amazon Web Services Glue connection was last updated.

          • lastUpdatedBy (string) --

            The user who last updated the Amazon Web Services Glue connection.

          • status (string) --

            The status of the Amazon Web Services Glue connection.

          • statusReason (string) --

            The status reason of the Amazon Web Services Glue connection.

          • lastConnectionValidationTime (datetime) --

            The last validation time of the Amazon Web Services Glue connection.

          • authenticationConfiguration (dict) --

            The authentication configuration of the Amazon Web Services Glue connection.

            • authenticationType (string) --

              The authentication type of a connection.

            • secretArn (string) --

              The secret ARN of a connection.

            • oAuth2Properties (dict) --

              The oAuth2 properties of a connection.

              • oAuth2GrantType (string) --

                The OAuth2 grant type of the OAuth2 properties.

              • oAuth2ClientApplication (dict) --

                The OAuth2 client application of the OAuth2 properties.

                • userManagedClientApplicationClientId (string) --

                  The user managed client application client ID in the OAuth2Client application.

                • aWSManagedClientApplicationReference (string) --

                  The Amazon Web Services managed client application reference in the OAuth2Client application.

              • tokenUrl (string) --

                The OAuth2 token URL of the OAuth2 properties.

              • tokenUrlParametersMap (dict) --

                The OAuth2 token URL parameter map of the OAuth2 properties.

                • (string) --

                  • (string) --

              • authorizationCodeProperties (dict) --

                The authorization code properties of the OAuth2 properties.

                • authorizationCode (string) --

                  The authorization code of a connection.

                • redirectUri (string) --

                  The redirect URI of a connection.

              • oAuth2Credentials (dict) --

                The OAuth2 credentials of the OAuth2 properties.

                • userManagedClientApplicationClientSecret (string) --

                  The user managed client application client secret of the connection.

                • accessToken (string) --

                  The access token of a connection.

                • refreshToken (string) --

                  The refresh token of the connection.

                • jwtToken (string) --

                  The jwt token of the connection.

          • connectionSchemaVersion (integer) --

            The connection schema version of the Amazon Web Services Glue connection.

          • compatibleComputeEnvironments (list) --

            The compatible compute environments of the Amazon Web Services Glue connection.

            • (string) --

        • enableTrustedIdentityPropagation (boolean) --

          Specified whether trusted identity propagation for the connection is enabled.

        • host (string) --

          The host in the physical endpoints of a connection.

        • port (integer) --

          The port in the physical endpoints of a connection.

        • protocol (string) --

          The protocol in the physical endpoints of a connection.

        • stage (string) --

          The stage in the physical endpoints of a connection.

    • projectId (string) --

      The ID of the project where the connection is created.

    • props (dict) --

      The connection props.

      • athenaProperties (dict) --

        The Amazon Athena properties of a connection.

        • workgroupName (string) --

          The Amazon Athena workgroup name of a connection.

      • glueProperties (dict) --

        The Amazon Web Services Glue properties of a connection.

        • status (string) --

          The status of a connection.

        • errorMessage (string) --

          The error message generated if the action is not completed successfully.

      • hyperPodProperties (dict) --

        The hyper pod properties of a connection.

        • clusterName (string) --

          The cluster name the hyper pod properties.

        • clusterArn (string) --

          The cluster ARN of the hyper pod properties.

        • orchestrator (string) --

          The orchestrator of the hyper pod properties.

      • iamProperties (dict) --

        The IAM properties of a connection.

        • environmentId (string) --

          The environment ID of the connection.

        • glueLineageSyncEnabled (boolean) --

          Specifies whether Amazon Web Services Glue lineage sync is enabled for a connection.

      • redshiftProperties (dict) --

        The Amazon Redshift properties of a connection.

        • storage (dict) --

          The storage in the Amazon Redshift properties.

          • clusterName (string) --

            The cluster name in the Amazon Redshift storage properties.

          • workgroupName (string) --

            The workgroup name in the Amazon Redshift storage properties.

        • credentials (dict) --

          The Amazon Redshift credentials.

          • secretArn (string) --

            The secret ARN of the Amazon Redshift credentials of a connection.

          • usernamePassword (dict) --

            The username and password of the Amazon Redshift credentials of a connection.

            • password (string) --

              The password of a connection.

            • username (string) --

              The username of a connection.

        • isProvisionedSecret (boolean) --

          Specifies whether Amaon Redshift properties has a provisioned secret.

        • jdbcIamUrl (string) --

          The jdbcIam URL of the Amazon Redshift properties.

        • jdbcUrl (string) --

          The jdbcURL of the Amazon Redshift properties.

        • redshiftTempDir (string) --

          The redshiftTempDir of the Amazon Redshift properties.

        • lineageSync (dict) --

          The lineage syn of the Amazon Redshift properties.

          • lineageJobId (string) --

            The lineage job ID of the Amaon Redshift lineage sync configuration.

          • enabled (boolean) --

            Specifies whether the Amaon Redshift lineage sync configuration is enabled.

          • schedule (dict) --

            The schedule of teh Amaon Redshift lineage sync configuration.

            • schedule (string) --

              The lineage sync schedule.

        • status (string) --

          The status in the Amazon Redshift properties.

        • databaseName (string) --

          The Amazon Redshift database name.

      • sparkEmrProperties (dict) --

        The Spark EMR properties of a connection.

        • computeArn (string) --

          The compute ARN of the Spark EMR.

        • credentials (dict) --

          The credentials of the Spark EMR.

          • password (string) --

            The password of a connection.

          • username (string) --

            The username of a connection.

        • credentialsExpiration (datetime) --

          The credential expiration of the Spark EMR.

        • governanceType (string) --

          The governance type of the Spark EMR.

        • instanceProfileArn (string) --

          The instance profile ARN of the Spark EMR.

        • javaVirtualEnv (string) --

          The Java virtual env of the Spark EMR.

        • livyEndpoint (string) --

          The livy endpoint of the Spark EMR.

        • logUri (string) --

          The log URI of the Spark EMR.

        • pythonVirtualEnv (string) --

          The Python virtual env of the Spark EMR.

        • runtimeRole (string) --

          The runtime role of the Spark EMR.

        • trustedCertificatesS3Uri (string) --

          The trusted certificate S3 URL of the Spark EMR.

        • certificateData (string) --

          The certificate data of the EMR on EKS cluster.

        • managedEndpointArn (string) --

          The managed endpoint ARN of the EMR on EKS cluster.

        • managedEndpointCredentials (dict) --

          The managed endpoint credentials of the EMR on EKS cluster.

          • id (string) --

            The identifier of the managed endpoint credentials.

          • token (string) --

            The ARN of the managed endpoint credentials.

      • sparkGlueProperties (dict) --

        The Spark Amazon Web Services Glue properties of a connection.

        • additionalArgs (dict) --

          The additional args in the Spark Amazon Web Services Glue properties.

          • connection (string) --

            The connection in the Spark Amazon Web Services Glue args.

        • glueConnectionName (string) --

          The Amazon Web Services Glue connection name in the Spark Amazon Web Services Glue properties.

        • glueConnectionNames (list) --

          The Amazon Web Services Glue connection names in the Spark Amazon Web Services Glue properties.

          • (string) --

        • glueVersion (string) --

          The Amazon Web Services Glue version in the Spark Amazon Web Services Glue properties.

        • idleTimeout (integer) --

          The idle timeout in the Spark Amazon Web Services Glue properties.

        • javaVirtualEnv (string) --

          The Java virtual env in the Spark Amazon Web Services Glue properties.

        • numberOfWorkers (integer) --

          The number of workers in the Spark Amazon Web Services Glue properties.

        • pythonVirtualEnv (string) --

          The Python virtual env in the Spark Amazon Web Services Glue properties.

        • workerType (string) --

          The worker type in the Spark Amazon Web Services Glue properties.

      • s3Properties (dict) --

        The Amazon S3 properties of a connection.

        • s3Uri (string) --

          The Amazon S3 URI that's part of the Amazon S3 properties of a connection.

        • s3AccessGrantLocationId (string) --

          The Amazon S3 Access Grant location ID that's part of the Amazon S3 properties of a connection.

        • registerS3AccessGrantLocation (boolean) --

          Specifies whether to register the Amazon S3 Access Grant location.

        • status (string) --

          The status of the Amazon S3 connection.

        • errorMessage (string) --

          The error message that gets displayed.

      • snowflakeProperties (dict) --

        The Snowflake-specific connection properties for an existing connection.

        • snowflakeRole (string) --

          The Snowflake role used to access Snowflake resources.

        • identityMapping (dict) --

          The identity mapping configuration for the Snowflake connection.

          • usernameAttribute (string) --

            The username attribute used for the identity mapping.

          • prefix (string) --

            The prefix used for the identity mapping.

        • lineageSync (dict) --

          The lineage sync configuration for the Snowflake connection.

          • lineageJobId (string) --

            The ID of the lineage sync job.

          • timezone (string) --

            The timezone of the lineage sync schedule.

          • enabled (boolean) --

            Specifies whether lineage sync is enabled.

          • schedule (string) --

            The schedule of the lineage sync.

        • status (string) --

          The status of the Snowflake connection.

        • errorMessage (string) --

          An error message returned if the Snowflake connection failed to establish or validate.

      • amazonQProperties (dict) --

        The Amazon Q properties of the connection.

        • isEnabled (boolean) --

          Specifies whether Amazon Q is enabled for the connection.

        • profileArn (string) --

          The profile ARN of the connection's Amazon Q properties.

        • authMode (string) --

          The authentication mode of the connection's Amazon Q properties.

      • mlflowProperties (dict) --

        The MLflow properties of a connection.

        • trackingServerArn (string) --

          The tracking server ARN as part of the MLflow properties of a connection.

      • workflowsMwaaProperties (dict) --

        The Amazon MWAA properties of a connection.

        • mwaaEnvironmentName (string) --

          The MWAA environment name.

      • workflowsServerlessProperties (dict) --

        The MWAA serverless properties of a connection.

      • lakehouseProperties (dict) --

        The lakehouse properties of a connection.

        • glueLineageSyncEnabled (boolean) --

          Specifies whether Glue lineage sync is enabled for tables managed by Glue crawlers.

      • vpcProperties (dict) --

        The VPC properties of a connection.

        • vpcId (string) --

          The identifier of the VPC.

        • subnetIds (list) --

          The subnet IDs of the VPC connection.

          • (string) --

        • status (string) --

          The status of the VPC connection.

        • securityGroupId (string) --

          The security group ID of the VPC connection.

        • glueConnectionNames (list) --

          The Amazon Web Services Glue connection names associated with the VPC connection.

          • (string) --

      • gitProperties (dict) --

        The Git properties of a connection.

        • codeConnectionArn (string) --

          The ARN of the CodeConnections connection used to connect to the Git repository.

        • repositoryId (string) --

          The ID of the Git repository. This is the owner and repository name, for example, owner/repo-name.

        • defaultBranch (string) --

          The default branch of the Git repository.

        • status (string) --

          The status of the Git connection.

        • errorMessage (string) --

          The error message that describes why the Git connection failed. This member is populated when the connection status is CREATE_FAILED or UPDATE_FAILED.

    • type (string) --

      The connection type.

    • scope (string) --

      The scope of the connection.

CreateEnvironmentBlueprint (updated) Link ¶
Changes (both)
{'blueprintCategory': 'TOOLING'}

Creates a Amazon DataZone blueprint.

See also: AWS API Documentation

Request Syntax

client.create_environment_blueprint(
    domainIdentifier='string',
    name='string',
    description='string',
    provisioningProperties={
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    userParameters=[
        {
            'keyName': 'string',
            'description': 'string',
            'fieldType': 'string',
            'defaultValue': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'isUpdateSupported': True|False
        },
    ],
    blueprintCategory='TOOLING'
)
type domainIdentifier:

string

param domainIdentifier:

[REQUIRED]

The identifier of the domain in which this blueprint is created.

type name:

string

param name:

[REQUIRED]

The name of this Amazon DataZone blueprint.

type description:

string

param description:

The description of the Amazon DataZone blueprint.

type provisioningProperties:

dict

param provisioningProperties:

[REQUIRED]

The provisioning properties of this Amazon DataZone blueprint.

  • cloudFormation (dict) --

    The cloud formation properties included as part of the provisioning properties of an environment blueprint.

    • templateUrl (string) -- [REQUIRED]

      The template URL of the cloud formation provisioning properties of the environment blueprint.

type userParameters:

list

param userParameters:

The user parameters of this Amazon DataZone blueprint.

  • (dict) --

    The details of user parameters of an environment blueprint.

    • keyName (string) -- [REQUIRED]

      The key name of the parameter.

    • description (string) --

      The description of the parameter.

    • fieldType (string) -- [REQUIRED]

      The filed type of the parameter.

    • defaultValue (string) --

      The default value of the parameter.

    • isEditable (boolean) --

      Specifies whether the parameter is editable.

    • isOptional (boolean) --

      Specifies whether the custom parameter is optional.

    • isUpdateSupported (boolean) --

      Specifies whether a parameter value can be updated after creation.

type blueprintCategory:

string

param blueprintCategory:

The category of the Amazon DataZone blueprint. The only valid value is TOOLING, which creates a blueprint that provisions the tooling resources of a project.

rtype:

dict

returns:

Response Syntax

{
    'id': 'string',
    'name': 'string',
    'description': 'string',
    'provider': 'string',
    'provisioningProperties': {
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    'deploymentProperties': {
        'startTimeoutMinutes': 123,
        'endTimeoutMinutes': 123
    },
    'userParameters': [
        {
            'keyName': 'string',
            'description': 'string',
            'fieldType': 'string',
            'defaultValue': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'isUpdateSupported': True|False
        },
    ],
    'glossaryTerms': [
        'string',
    ],
    'blueprintCategory': 'TOOLING',
    'createdAt': datetime(2015, 1, 1),
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • id (string) --

      The ID of this Amazon DataZone blueprint.

    • name (string) --

      The name of this Amazon DataZone blueprint.

    • description (string) --

      The description of this Amazon DataZone blueprint.

    • provider (string) --

      The provider of this Amazon DataZone blueprint.

    • provisioningProperties (dict) --

      The provisioning properties of this Amazon DataZone blueprint.

      • cloudFormation (dict) --

        The cloud formation properties included as part of the provisioning properties of an environment blueprint.

        • templateUrl (string) --

          The template URL of the cloud formation provisioning properties of the environment blueprint.

    • deploymentProperties (dict) --

      The deployment properties of this Amazon DataZone blueprint.

      • startTimeoutMinutes (integer) --

        The start timeout of the environment blueprint deployment.

      • endTimeoutMinutes (integer) --

        The end timeout of the environment blueprint deployment.

    • userParameters (list) --

      The user parameters of this Amazon DataZone blueprint.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • keyName (string) --

          The key name of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • defaultValue (string) --

          The default value of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • isUpdateSupported (boolean) --

          Specifies whether a parameter value can be updated after creation.

    • glossaryTerms (list) --

      The glossary terms attached to this Amazon DataZone blueprint.

      • (string) --

    • blueprintCategory (string) --

      The category of the Amazon DataZone blueprint. The only valid value is TOOLING, which indicates a blueprint that provisions the tooling resources of a project.

    • createdAt (datetime) --

      The timestamp at which the environment blueprint was created.

    • updatedAt (datetime) --

      The timestamp of when this blueprint was updated.

GetEnvironmentBlueprint (updated) Link ¶
Changes (response)
{'blueprintCategory': 'TOOLING'}

Gets an Amazon DataZone blueprint.

See also: AWS API Documentation

Request Syntax

client.get_environment_blueprint(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier:

string

param domainIdentifier:

[REQUIRED]

The identifier of the domain in which this blueprint exists.

type identifier:

string

param identifier:

[REQUIRED]

The ID of this Amazon DataZone blueprint.

rtype:

dict

returns:

Response Syntax

{
    'id': 'string',
    'name': 'string',
    'description': 'string',
    'provider': 'string',
    'provisioningProperties': {
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    'deploymentProperties': {
        'startTimeoutMinutes': 123,
        'endTimeoutMinutes': 123
    },
    'userParameters': [
        {
            'keyName': 'string',
            'description': 'string',
            'fieldType': 'string',
            'defaultValue': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'isUpdateSupported': True|False
        },
    ],
    'glossaryTerms': [
        'string',
    ],
    'blueprintCategory': 'TOOLING',
    'createdAt': datetime(2015, 1, 1),
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • id (string) --

      The ID of this Amazon DataZone blueprint.

    • name (string) --

      The name of this Amazon DataZone blueprint.

    • description (string) --

      The description of this Amazon DataZone blueprint.

    • provider (string) --

      The provider of this Amazon DataZone blueprint.

    • provisioningProperties (dict) --

      The provisioning properties of this Amazon DataZone blueprint.

      • cloudFormation (dict) --

        The cloud formation properties included as part of the provisioning properties of an environment blueprint.

        • templateUrl (string) --

          The template URL of the cloud formation provisioning properties of the environment blueprint.

    • deploymentProperties (dict) --

      The deployment properties of this Amazon DataZone blueprint.

      • startTimeoutMinutes (integer) --

        The start timeout of the environment blueprint deployment.

      • endTimeoutMinutes (integer) --

        The end timeout of the environment blueprint deployment.

    • userParameters (list) --

      The user parameters of this blueprint.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • keyName (string) --

          The key name of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • defaultValue (string) --

          The default value of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • isUpdateSupported (boolean) --

          Specifies whether a parameter value can be updated after creation.

    • glossaryTerms (list) --

      The glossary terms attached to this Amazon DataZone blueprint.

      • (string) --

    • blueprintCategory (string) --

      The category of this Amazon DataZone blueprint. The only valid value is TOOLING, which indicates a blueprint that provisions the tooling resources of a project.

    • createdAt (datetime) --

      A timestamp of when this blueprint was created.

    • updatedAt (datetime) --

      The timestamp of when this blueprint was updated.

ListEnvironmentBlueprints (updated) Link ¶
Changes (response)
{'items': {'blueprintCategory': 'TOOLING'}}

Lists blueprints in an Amazon DataZone environment.

See also: AWS API Documentation

Request Syntax

client.list_environment_blueprints(
    domainIdentifier='string',
    maxResults=123,
    nextToken='string',
    name='string',
    managed=True|False
)
type domainIdentifier:

string

param domainIdentifier:

[REQUIRED]

The identifier of the Amazon DataZone domain.

type maxResults:

integer

param maxResults:

The maximum number of blueprints to return in a single call to ListEnvironmentBlueprints. When the number of blueprints to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to ListEnvironmentBlueprints to list the next set of blueprints.

type nextToken:

string

param nextToken:

When the number of blueprints in the environment is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of blueprints in the environment, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ``ListEnvironmentBlueprints``to list the next set of blueprints.

type name:

string

param name:

The name of the Amazon DataZone environment.

type managed:

boolean

param managed:

Specifies whether the environment blueprint is managed by Amazon DataZone.

rtype:

dict

returns:

Response Syntax

{
    'items': [
        {
            'id': 'string',
            'name': 'string',
            'description': 'string',
            'provider': 'string',
            'provisioningProperties': {
                'cloudFormation': {
                    'templateUrl': 'string'
                }
            },
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1),
            'blueprintCategory': 'TOOLING'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListEnvironmentBlueprints action.

      • (dict) --

        The details of an environment blueprint summary.

        • id (string) --

          The identifier of the blueprint.

        • name (string) --

          The name of the blueprint.

        • description (string) --

          The description of a blueprint.

        • provider (string) --

          The provider of the blueprint.

        • provisioningProperties (dict) --

          The provisioning properties of the blueprint.

          • cloudFormation (dict) --

            The cloud formation properties included as part of the provisioning properties of an environment blueprint.

            • templateUrl (string) --

              The template URL of the cloud formation provisioning properties of the environment blueprint.

        • createdAt (datetime) --

          The timestamp of when an environment blueprint was created.

        • updatedAt (datetime) --

          The timestamp of when the blueprint was enabled.

        • blueprintCategory (string) --

          The category of the environment blueprint. The only valid value is TOOLING.

    • nextToken (string) --

      When the number of blueprints in the environment is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of blueprints in the environment, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ``ListEnvironmentBlueprints``to list the next set of blueprints.

UpdateEnvironmentBlueprint (updated) Link ¶
Changes (both)
{'blueprintCategory': 'TOOLING'}

Updates an environment blueprint in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_environment_blueprint(
    domainIdentifier='string',
    identifier='string',
    description='string',
    provisioningProperties={
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    userParameters=[
        {
            'keyName': 'string',
            'description': 'string',
            'fieldType': 'string',
            'defaultValue': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'isUpdateSupported': True|False
        },
    ],
    blueprintCategory='TOOLING'
)
type domainIdentifier:

string

param domainIdentifier:

[REQUIRED]

The identifier of the Amazon DataZone domain in which an environment blueprint is to be updated.

type identifier:

string

param identifier:

[REQUIRED]

The identifier of the environment blueprint to be updated.

type description:

string

param description:

The description to be updated as part of the UpdateEnvironmentBlueprint action.

type provisioningProperties:

dict

param provisioningProperties:

The provisioning properties to be updated as part of the UpdateEnvironmentBlueprint action.

  • cloudFormation (dict) --

    The cloud formation properties included as part of the provisioning properties of an environment blueprint.

    • templateUrl (string) -- [REQUIRED]

      The template URL of the cloud formation provisioning properties of the environment blueprint.

type userParameters:

list

param userParameters:

The user parameters to be updated as part of the UpdateEnvironmentBlueprint action.

  • (dict) --

    The details of user parameters of an environment blueprint.

    • keyName (string) -- [REQUIRED]

      The key name of the parameter.

    • description (string) --

      The description of the parameter.

    • fieldType (string) -- [REQUIRED]

      The filed type of the parameter.

    • defaultValue (string) --

      The default value of the parameter.

    • isEditable (boolean) --

      Specifies whether the parameter is editable.

    • isOptional (boolean) --

      Specifies whether the custom parameter is optional.

    • isUpdateSupported (boolean) --

      Specifies whether a parameter value can be updated after creation.

type blueprintCategory:

string

param blueprintCategory:

The category to update. The only valid value is TOOLING.

rtype:

dict

returns:

Response Syntax

{
    'id': 'string',
    'name': 'string',
    'description': 'string',
    'provider': 'string',
    'provisioningProperties': {
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    'deploymentProperties': {
        'startTimeoutMinutes': 123,
        'endTimeoutMinutes': 123
    },
    'userParameters': [
        {
            'keyName': 'string',
            'description': 'string',
            'fieldType': 'string',
            'defaultValue': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'isUpdateSupported': True|False
        },
    ],
    'glossaryTerms': [
        'string',
    ],
    'blueprintCategory': 'TOOLING',
    'createdAt': datetime(2015, 1, 1),
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • id (string) --

      The identifier of the blueprint to be updated.

    • name (string) --

      The name to be updated as part of the UpdateEnvironmentBlueprint action.

    • description (string) --

      The description to be updated as part of the UpdateEnvironmentBlueprint action.

    • provider (string) --

      The provider of the blueprint to be udpated.

    • provisioningProperties (dict) --

      The provisioning properties to be updated as part of the UpdateEnvironmentBlueprint action.

      • cloudFormation (dict) --

        The cloud formation properties included as part of the provisioning properties of an environment blueprint.

        • templateUrl (string) --

          The template URL of the cloud formation provisioning properties of the environment blueprint.

    • deploymentProperties (dict) --

      The deployment properties to be updated as part of the UpdateEnvironmentBlueprint action.

      • startTimeoutMinutes (integer) --

        The start timeout of the environment blueprint deployment.

      • endTimeoutMinutes (integer) --

        The end timeout of the environment blueprint deployment.

    • userParameters (list) --

      The user parameters to be updated as part of the UpdateEnvironmentBlueprint action.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • keyName (string) --

          The key name of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • defaultValue (string) --

          The default value of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • isUpdateSupported (boolean) --

          Specifies whether a parameter value can be updated after creation.

    • glossaryTerms (list) --

      The glossary terms to be updated as part of the UpdateEnvironmentBlueprint action.

      • (string) --

    • blueprintCategory (string) --

      The category of the environment blueprint. The only valid value is TOOLING.

    • createdAt (datetime) --

      The timestamp of when the environment blueprint was created.

    • updatedAt (datetime) --

      The timestamp of when the blueprint was updated.