Skip to content

Synchronizes the gateway targets by fetching the latest tool definitions from the target endpoints

Description

Synchronizes the gateway targets by fetching the latest tool definitions from the target endpoints.

You cannot synchronize a target that is in a pending authorization state (CREATE_PENDING_AUTH, UPDATE_PENDING_AUTH, or SYNCHRONIZE_PENDING_AUTH). Wait for the authorization to complete or fail before synchronizing.

You cannot synchronize a target that has a static tool schema (mcpToolSchema) configured. Remove the static schema through an update_gateway_target call to enable dynamic tool synchronization.

Usage

bedrockagentcorecontrol_synchronize_gateway_targets(gatewayIdentifier,
  targetIdList)

Arguments

  • gatewayIdentifier

    [required] The gateway Identifier.

  • targetIdList

    [required] The target ID list.

Value

A list with the following syntax:

list(
  targets = list(
    list(
      gatewayArn = "string",
      targetId = "string",
      createdAt = as.POSIXct(
        "2015-01-01"
      ),
      updatedAt = as.POSIXct(
        "2015-01-01"
      ),
      status = "CREATING"|"UPDATING"|"UPDATE_UNSUCCESSFUL"|"DELETING"|"READY"|"FAILED"|"SYNCHRONIZING"|"SYNCHRONIZE_UNSUCCESSFUL"|"CREATE_PENDING_AUTH"|"UPDATE_PENDING_AUTH"|"SYNCHRONIZE_PENDING_AUTH",
      statusReasons = list(
        "string"
      ),
      name = "string",
      description = "string",
      targetConfiguration = list(
        mcp = list(
          openApiSchema = list(
            s3 = list(
              uri = "string",
              bucketOwnerAccountId = "string"
            ),
            inlinePayload = "string"
          ),
          smithyModel = list(
            s3 = list(
              uri = "string",
              bucketOwnerAccountId = "string"
            ),
            inlinePayload = "string"
          ),
          lambda = list(
            lambdaArn = "string",
            toolSchema = list(
              s3 = list(
                uri = "string",
                bucketOwnerAccountId = "string"
              ),
              inlinePayload = list(
                list(
                  name = "string",
                  description = "string",
                  inputSchema = list(
                    type = "string"|"number"|"object"|"array"|"boolean"|"integer",
                    properties = list(
                      list()
                    ),
                    required = list(
                      "string"
                    ),
                    items = list(),
                    description = "string"
                  ),
                  outputSchema = list(
                    type = "string"|"number"|"object"|"array"|"boolean"|"integer",
                    properties = list(
                      list()
                    ),
                    required = list(
                      "string"
                    ),
                    items = list(),
                    description = "string"
                  )
                )
              )
            )
          ),
          mcpServer = list(
            endpoint = "string",
            mcpToolSchema = list(
              s3 = list(
                uri = "string",
                bucketOwnerAccountId = "string"
              ),
              inlinePayload = "string"
            ),
            listingMode = "DEFAULT"|"DYNAMIC",
            resourcePriority = 123
          ),
          apiGateway = list(
            restApiId = "string",
            stage = "string",
            apiGatewayToolConfiguration = list(
              toolOverrides = list(
                list(
                  name = "string",
                  description = "string",
                  path = "string",
                  method = "GET"|"DELETE"|"HEAD"|"OPTIONS"|"PATCH"|"PUT"|"POST"
                )
              ),
              toolFilters = list(
                list(
                  filterPath = "string",
                  methods = list(
                    "GET"|"DELETE"|"HEAD"|"OPTIONS"|"PATCH"|"PUT"|"POST"
                  )
                )
              )
            )
          ),
          connector = list(
            source = list(
              connectorId = "string",
              version = "string"
            ),
            enabled = list(
              "string"
            ),
            configurations = list(
              list(
                name = "string",
                description = "string",
                parameterValues = list(),
                parameterOverrides = list(
                  list(
                    path = "string",
                    description = "string",
                    visible = TRUE|FALSE
                  )
                )
              )
            )
          )
        ),
        http = list(
          agentcoreRuntime = list(
            arn = "string",
            qualifier = "string",
            schema = list(
              source = list(
                s3 = list(
                  uri = "string",
                  bucketOwnerAccountId = "string"
                ),
                inlinePayload = "string"
              )
            )
          ),
          passthrough = list(
            endpoint = "string",
            protocolType = "MCP"|"A2A"|"INFERENCE"|"CUSTOM",
            schema = list(
              source = list(
                s3 = list(
                  uri = "string",
                  bucketOwnerAccountId = "string"
                ),
                inlinePayload = "string"
              )
            ),
            stickinessConfiguration = list(
              identifier = "string",
              timeout = 123,
              compositeIdentifier = list(
                "string"
              )
            ),
            staticQueryParameters = list(
              "string"
            ),
            staticQueryParameterConflictResolution = "CLIENT_OVERRIDE"|"STATIC_OVERRIDE"
          ),
          connector = list(
            source = list(
              connectorId = "string"
            ),
            parameters = list(
              "string"
            )
          )
        ),
        inference = list(
          connector = list(
            source = list(
              connectorId = "string"
            )
          ),
          provider = list(
            endpoint = "string",
            modelMapping = list(
              providerPrefix = list(
                strip = TRUE|FALSE,
                separator = "string"
              )
            ),
            operations = list(
              list(
                path = "string",
                providerPath = "string",
                models = list(
                  list(
                    model = "string"
                  )
                )
              )
            )
          )
        )
      ),
      credentialProviderConfigurations = list(
        list(
          credentialProviderType = "GATEWAY_IAM_ROLE"|"OAUTH"|"API_KEY"|"CALLER_IAM_CREDENTIALS"|"JWT_PASSTHROUGH",
          credentialProvider = list(
            oauthCredentialProvider = list(
              providerArn = "string",
              scopes = list(
                "string"
              ),
              customParameters = list(
                "string"
              ),
              grantType = "CLIENT_CREDENTIALS"|"AUTHORIZATION_CODE"|"TOKEN_EXCHANGE",
              defaultReturnUrl = "string"
            ),
            apiKeyCredentialProvider = list(
              providerArn = "string",
              credentialParameterName = "string",
              credentialPrefix = "string",
              credentialLocation = "HEADER"|"QUERY_PARAMETER"
            ),
            iamCredentialProvider = list(
              service = "string",
              region = "string"
            )
          )
        )
      ),
      lastSynchronizedAt = as.POSIXct(
        "2015-01-01"
      ),
      metadataConfiguration = list(
        allowedRequestHeaders = list(
          "string"
        ),
        allowedQueryParameters = list(
          "string"
        ),
        allowedResponseHeaders = list(
          "string"
        )
      ),
      privateEndpoint = list(
        selfManagedLatticeResource = list(
          resourceConfigurationIdentifier = "string"
        ),
        managedVpcResource = list(
          vpcIdentifier = "string",
          subnetIds = list(
            "string"
          ),
          endpointIpAddressType = "IPV4"|"IPV6",
          securityGroupIds = list(
            "string"
          ),
          tags = list(
            "string"
          ),
          routingDomain = "string"
        )
      ),
      privateEndpointManagedResources = list(
        list(
          domain = "string",
          resourceGatewayArn = "string",
          resourceAssociationArn = "string"
        )
      ),
      authorizationData = list(
        oauth2 = list(
          authorizationUrl = "string",
          userId = "string"
        )
      ),
      protocolType = "MCP"|"HTTP",
      certificateConfigurations = list(
        list(
          s3 = list(
            uri = "string",
            bucketOwnerAccountId = "string"
          ),
          secretsManager = list(
            secretArn = "string"
          )
        )
      )
    )
  )
)

Request syntax

svc$synchronize_gateway_targets(
  gatewayIdentifier = "string",
  targetIdList = list(
    "string"
  )
)