EntityResolution / Client / update_id_namespace

update_id_namespace#

EntityResolution.Client.update_id_namespace(**kwargs)#

Updates an existing ID namespace.

See also: AWS API Documentation

Request Syntax

response = client.update_id_namespace(
    description='string',
    idMappingWorkflowProperties=[
        {
            'idMappingType': 'PROVIDER'|'RULE_BASED',
            'providerProperties': {
                'providerConfiguration': {...}|[...]|123|123.4|'string'|True|None,
                'providerServiceArn': 'string'
            },
            'ruleBasedProperties': {
                'attributeMatchingModel': 'ONE_TO_ONE'|'MANY_TO_MANY',
                'recordMatchingModels': [
                    'ONE_SOURCE_TO_ONE_TARGET'|'MANY_SOURCE_TO_ONE_TARGET',
                ],
                'ruleDefinitionTypes': [
                    'SOURCE'|'TARGET',
                ],
                'rules': [
                    {
                        'matchingKeys': [
                            'string',
                        ],
                        'ruleName': 'string'
                    },
                ]
            }
        },
    ],
    idNamespaceName='string',
    inputSourceConfig=[
        {
            'inputSourceARN': 'string',
            'schemaName': 'string'
        },
    ],
    roleArn='string'
)
Parameters:
  • description (string) – The description of the ID namespace.

  • idMappingWorkflowProperties (list) –

    Determines the properties of IdMappingWorkflow where this IdNamespace can be used as a Source or a Target.

    • (dict) –

      An object containing IdMappingType, ProviderProperties, and RuleBasedProperties.

      • idMappingType (string) – [REQUIRED]

        The type of ID mapping.

      • providerProperties (dict) –

        An object which defines any additional configurations required by the provider service.

        • providerConfiguration (document) –

          An object which defines any additional configurations required by the provider service.

        • providerServiceArn (string) – [REQUIRED]

          The Amazon Resource Name (ARN) of the provider service.

      • ruleBasedProperties (dict) –

        An object which defines any additional configurations required by rule-based matching.

        • attributeMatchingModel (string) –

          The comparison type. You can either choose ONE_TO_ONE or MANY_TO_MANY as the attributeMatchingModel.

          If you choose MANY_TO_MANY, the system can match attributes across the sub-types of an attribute type. For example, if the value of the Email field of Profile A matches the value of BusinessEmail field of Profile B, the two profiles are matched on the Email attribute type.

          If you choose ONE_TO_ONE, the system can only match attributes if the sub-types are an exact match. For example, for the Email attribute type, the system will only consider it a match if the value of the Email field of Profile A matches the value of the Email field of Profile B.

        • recordMatchingModels (list) –

          The type of matching record that is allowed to be used in an ID mapping workflow.

          If the value is set to ONE_SOURCE_TO_ONE_TARGET, only one record in the source is matched to one record in the target.

          If the value is set to MANY_SOURCE_TO_ONE_TARGET, all matching records in the source are matched to one record in the target.

          • (string) –

        • ruleDefinitionTypes (list) –

          The sets of rules you can use in an ID mapping workflow. The limitations specified for the source and target must be compatible.

          • (string) –

        • rules (list) –

          The rules for the ID namespace.

          • (dict) –

            An object containing RuleName, and MatchingKeys.

            • matchingKeys (list) – [REQUIRED]

              A list of MatchingKeys. The MatchingKeys must have been defined in the SchemaMapping. Two records are considered to match according to this rule if all of the MatchingKeys match.

              • (string) –

            • ruleName (string) – [REQUIRED]

              A name for the matching rule.

  • idNamespaceName (string) –

    [REQUIRED]

    The name of the ID namespace.

  • inputSourceConfig (list) –

    A list of InputSource objects, which have the fields InputSourceARN and SchemaName.

    • (dict) –

      An object containing InputSourceARN and SchemaName.

      • inputSourceARN (string) – [REQUIRED]

        An Glue table Amazon Resource Name (ARN) or a matching workflow ARN for the input source table.

      • schemaName (string) –

        The name of the schema.

  • roleArn (string) – The Amazon Resource Name (ARN) of the IAM role. Entity Resolution assumes this role to access the resources defined in this IdNamespace on your behalf as part of a workflow run.

Return type:

dict

Returns:

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'description': 'string',
    'idMappingWorkflowProperties': [
        {
            'idMappingType': 'PROVIDER'|'RULE_BASED',
            'providerProperties': {
                'providerConfiguration': {...}|[...]|123|123.4|'string'|True|None,
                'providerServiceArn': 'string'
            },
            'ruleBasedProperties': {
                'attributeMatchingModel': 'ONE_TO_ONE'|'MANY_TO_MANY',
                'recordMatchingModels': [
                    'ONE_SOURCE_TO_ONE_TARGET'|'MANY_SOURCE_TO_ONE_TARGET',
                ],
                'ruleDefinitionTypes': [
                    'SOURCE'|'TARGET',
                ],
                'rules': [
                    {
                        'matchingKeys': [
                            'string',
                        ],
                        'ruleName': 'string'
                    },
                ]
            }
        },
    ],
    'idNamespaceArn': 'string',
    'idNamespaceName': 'string',
    'inputSourceConfig': [
        {
            'inputSourceARN': 'string',
            'schemaName': 'string'
        },
    ],
    'roleArn': 'string',
    'type': 'SOURCE'|'TARGET',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    • createdAt (datetime) –

      The timestamp of when the ID namespace was created.

    • description (string) –

      The description of the ID namespace.

    • idMappingWorkflowProperties (list) –

      Determines the properties of IdMappingWorkflow where this IdNamespace can be used as a Source or a Target.

      • (dict) –

        An object containing IdMappingType, ProviderProperties, and RuleBasedProperties.

        • idMappingType (string) –

          The type of ID mapping.

        • providerProperties (dict) –

          An object which defines any additional configurations required by the provider service.

          • providerConfiguration (document) –

            An object which defines any additional configurations required by the provider service.

          • providerServiceArn (string) –

            The Amazon Resource Name (ARN) of the provider service.

        • ruleBasedProperties (dict) –

          An object which defines any additional configurations required by rule-based matching.

          • attributeMatchingModel (string) –

            The comparison type. You can either choose ONE_TO_ONE or MANY_TO_MANY as the attributeMatchingModel.

            If you choose MANY_TO_MANY, the system can match attributes across the sub-types of an attribute type. For example, if the value of the Email field of Profile A matches the value of BusinessEmail field of Profile B, the two profiles are matched on the Email attribute type.

            If you choose ONE_TO_ONE, the system can only match attributes if the sub-types are an exact match. For example, for the Email attribute type, the system will only consider it a match if the value of the Email field of Profile A matches the value of the Email field of Profile B.

          • recordMatchingModels (list) –

            The type of matching record that is allowed to be used in an ID mapping workflow.

            If the value is set to ONE_SOURCE_TO_ONE_TARGET, only one record in the source is matched to one record in the target.

            If the value is set to MANY_SOURCE_TO_ONE_TARGET, all matching records in the source are matched to one record in the target.

            • (string) –

          • ruleDefinitionTypes (list) –

            The sets of rules you can use in an ID mapping workflow. The limitations specified for the source and target must be compatible.

            • (string) –

          • rules (list) –

            The rules for the ID namespace.

            • (dict) –

              An object containing RuleName, and MatchingKeys.

              • matchingKeys (list) –

                A list of MatchingKeys. The MatchingKeys must have been defined in the SchemaMapping. Two records are considered to match according to this rule if all of the MatchingKeys match.

                • (string) –

              • ruleName (string) –

                A name for the matching rule.

    • idNamespaceArn (string) –

      The Amazon Resource Name (ARN) of the ID namespace.

    • idNamespaceName (string) –

      The name of the ID namespace.

    • inputSourceConfig (list) –

      A list of InputSource objects, which have the fields InputSourceARN and SchemaName.

      • (dict) –

        An object containing InputSourceARN and SchemaName.

        • inputSourceARN (string) –

          An Glue table Amazon Resource Name (ARN) or a matching workflow ARN for the input source table.

        • schemaName (string) –

          The name of the schema.

    • roleArn (string) –

      The Amazon Resource Name (ARN) of the IAM role. Entity Resolution assumes this role to access the resources defined in this IdNamespace on your behalf as part of a workflow run.

    • type (string) –

      The type of ID namespace. There are two types: SOURCE and TARGET.

      The SOURCE contains configurations for sourceId data that will be processed in an ID mapping workflow.

      The TARGET contains a configuration of targetId to which all sourceIds will resolve to.

    • updatedAt (datetime) –

      The timestamp of when the ID namespace was last updated.

Exceptions

  • EntityResolution.Client.exceptions.ThrottlingException

  • EntityResolution.Client.exceptions.InternalServerException

  • EntityResolution.Client.exceptions.ResourceNotFoundException

  • EntityResolution.Client.exceptions.AccessDeniedException

  • EntityResolution.Client.exceptions.ValidationException