ModifyIntegrationCommand

Suggest an Edit

Modifies a Zero-ETL integration in the caller's account.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { GlueClient, ModifyIntegrationCommand } from "@aws-sdk/client-glue"; // ES Modules import
// const { GlueClient, ModifyIntegrationCommand } = require("@aws-sdk/client-glue"); // CommonJS import
const client = new GlueClient(config);
const input = { // ModifyIntegrationRequest
  IntegrationIdentifier: "STRING_VALUE", // required
  Description: "STRING_VALUE",
  DataFilter: "STRING_VALUE",
  IntegrationName: "STRING_VALUE",
};
const command = new ModifyIntegrationCommand(input);
const response = await client.send(command);
// { // ModifyIntegrationResponse
//   SourceArn: "STRING_VALUE", // required
//   TargetArn: "STRING_VALUE", // required
//   IntegrationName: "STRING_VALUE", // required
//   Description: "STRING_VALUE",
//   IntegrationArn: "STRING_VALUE", // required
//   KmsKeyId: "STRING_VALUE",
//   AdditionalEncryptionContext: { // IntegrationAdditionalEncryptionContextMap
//     "<keys>": "STRING_VALUE",
//   },
//   Tags: [ // IntegrationTagsList
//     { // Tag
//       key: "STRING_VALUE",
//       value: "STRING_VALUE",
//     },
//   ],
//   Status: "CREATING" || "ACTIVE" || "MODIFYING" || "FAILED" || "DELETING" || "SYNCING" || "NEEDS_ATTENTION", // required
//   CreateTime: new Date("TIMESTAMP"), // required
//   Errors: [ // IntegrationErrorList
//     { // IntegrationError
//       ErrorCode: "STRING_VALUE",
//       ErrorMessage: "STRING_VALUE",
//     },
//   ],
//   DataFilter: "STRING_VALUE",
// };

ModifyIntegrationCommand Input

See ModifyIntegrationCommandInput for more details

Parameter
Type
Description
IntegrationIdentifier
Required
string | undefined

The Amazon Resource Name (ARN) for the integration.

DataFilter
string | undefined

Selects source tables for the integration using Maxwell filter syntax.

Description
string | undefined

A description of the integration.

IntegrationName
string | undefined

A unique name for an integration in Glue.

ModifyIntegrationCommand Output

See ModifyIntegrationCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
CreateTime
Required
Date | undefined

The time when the integration was created, in UTC.

IntegrationArn
Required
string | undefined

The Amazon Resource Name (ARN) for the integration.

IntegrationName
Required
string | undefined

A unique name for an integration in Glue.

SourceArn
Required
string | undefined

The ARN of the source for the integration.

Status
Required
IntegrationStatus | undefined

The status of the integration being modified.

The possible statuses are:

  • CREATING: The integration is being created.

  • ACTIVE: The integration creation succeeds.

  • MODIFYING: The integration is being modified.

  • FAILED: The integration creation fails.

  • DELETING: The integration is deleted.

  • SYNCING: The integration is synchronizing.

  • NEEDS_ATTENTION: The integration needs attention, such as synchronization.

TargetArn
Required
string | undefined

The ARN of the target for the integration.

AdditionalEncryptionContext
Record<string, string> | undefined

An optional set of non-secret key–value pairs that contains additional contextual information for encryption.

DataFilter
string | undefined

Selects source tables for the integration using Maxwell filter syntax.

Description
string | undefined

A description of the integration.

Errors
IntegrationError[] | undefined

A list of errors associated with the integration modification.

KmsKeyId
string | undefined

The ARN of a KMS key used for encrypting the channel.

Tags
Tag[] | undefined

Metadata assigned to the resource consisting of a list of key-value pairs.

Throws

Name
Fault
Details
AccessDeniedException
client

Access to a resource was denied.

ConflictException
client

The CreatePartitions API was called on a table that has indexes enabled.

EntityNotFoundException
client

A specified entity does not exist

IntegrationConflictOperationFault
client

The requested operation conflicts with another operation.

IntegrationNotFoundFault
client

The specified integration could not be found.

InternalServerException
server

An internal server error occurred.

InternalServiceException
server

An internal service error occurred.

InvalidInputException
client

The input provided was not valid.

InvalidIntegrationStateFault
client

The integration is in an invalid state.

InvalidStateException
client

An error that indicates your data is in an invalid state.

ValidationException
client

A value could not be validated.

GlueServiceException
Base exception class for all service exceptions from Glue service.