@aws-sdk/client-sagemaker-runtime 3.35.0 → 3.38.0

package/src/SageMakerRuntimeClient.ts

@@ -1,241 +0,0 @@
-import {
-  EndpointsInputConfig,
-  EndpointsResolvedConfig,
-  RegionInputConfig,
-  RegionResolvedConfig,
-  resolveEndpointsConfig,
-  resolveRegionConfig,
-} from "@aws-sdk/config-resolver";
-import { getContentLengthPlugin } from "@aws-sdk/middleware-content-length";
-import {
-  getHostHeaderPlugin,
-  HostHeaderInputConfig,
-  HostHeaderResolvedConfig,
-  resolveHostHeaderConfig,
-} from "@aws-sdk/middleware-host-header";
-import { getLoggerPlugin } from "@aws-sdk/middleware-logger";
-import { getRetryPlugin, resolveRetryConfig, RetryInputConfig, RetryResolvedConfig } from "@aws-sdk/middleware-retry";
-import {
-  AwsAuthInputConfig,
-  AwsAuthResolvedConfig,
-  getAwsAuthPlugin,
-  resolveAwsAuthConfig,
-} from "@aws-sdk/middleware-signing";
-import {
-  getUserAgentPlugin,
-  resolveUserAgentConfig,
-  UserAgentInputConfig,
-  UserAgentResolvedConfig,
-} from "@aws-sdk/middleware-user-agent";
-import { HttpHandler as __HttpHandler } from "@aws-sdk/protocol-http";
-import {
-  Client as __Client,
-  SmithyConfiguration as __SmithyConfiguration,
-  SmithyResolvedConfiguration as __SmithyResolvedConfiguration,
-} from "@aws-sdk/smithy-client";
-import {
-  Credentials as __Credentials,
-  Decoder as __Decoder,
-  Encoder as __Encoder,
-  Hash as __Hash,
-  HashConstructor as __HashConstructor,
-  HttpHandlerOptions as __HttpHandlerOptions,
-  Logger as __Logger,
-  Provider as __Provider,
-  Provider,
-  RegionInfoProvider,
-  StreamCollector as __StreamCollector,
-  UrlParser as __UrlParser,
-  UserAgent as __UserAgent,
-} from "@aws-sdk/types";
-
-import {
-  InvokeEndpointAsyncCommandInput,
-  InvokeEndpointAsyncCommandOutput,
-} from "./commands/InvokeEndpointAsyncCommand";
-import { InvokeEndpointCommandInput, InvokeEndpointCommandOutput } from "./commands/InvokeEndpointCommand";
-import { getRuntimeConfig as __getRuntimeConfig } from "./runtimeConfig";
-
-export type ServiceInputTypes = InvokeEndpointAsyncCommandInput | InvokeEndpointCommandInput;
-
-export type ServiceOutputTypes = InvokeEndpointAsyncCommandOutput | InvokeEndpointCommandOutput;
-
-export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__HttpHandlerOptions>> {
-  /**
-   * The HTTP handler to use. Fetch in browser and Https in Nodejs.
-   */
-  requestHandler?: __HttpHandler;
-
-  /**
-   * A constructor for a class implementing the {@link __Hash} interface
-   * that computes the SHA-256 HMAC or checksum of a string or binary buffer.
-   * @internal
-   */
-  sha256?: __HashConstructor;
-
-  /**
-   * The function that will be used to convert strings into HTTP endpoints.
-   * @internal
-   */
-  urlParser?: __UrlParser;
-
-  /**
-   * A function that can calculate the length of a request body.
-   * @internal
-   */
-  bodyLengthChecker?: (body: any) => number | undefined;
-
-  /**
-   * A function that converts a stream into an array of bytes.
-   * @internal
-   */
-  streamCollector?: __StreamCollector;
-
-  /**
-   * The function that will be used to convert a base64-encoded string to a byte array.
-   * @internal
-   */
-  base64Decoder?: __Decoder;
-
-  /**
-   * The function that will be used to convert binary data to a base64-encoded string.
-   * @internal
-   */
-  base64Encoder?: __Encoder;
-
-  /**
-   * The function that will be used to convert a UTF8-encoded string to a byte array.
-   * @internal
-   */
-  utf8Decoder?: __Decoder;
-
-  /**
-   * The function that will be used to convert binary data to a UTF-8 encoded string.
-   * @internal
-   */
-  utf8Encoder?: __Encoder;
-
-  /**
-   * The runtime environment.
-   * @internal
-   */
-  runtime?: string;
-
-  /**
-   * Disable dyanamically changing the endpoint of the client based on the hostPrefix
-   * trait of an operation.
-   */
-  disableHostPrefix?: boolean;
-
-  /**
-   * Value for how many times a request will be made at most in case of retry.
-   */
-  maxAttempts?: number | __Provider<number>;
-
-  /**
-   * Specifies which retry algorithm to use.
-   */
-  retryMode?: string | __Provider<string>;
-
-  /**
-   * Optional logger for logging debug/info/warn/error.
-   */
-  logger?: __Logger;
-
-  /**
-   * Unique service identifier.
-   * @internal
-   */
-  serviceId?: string;
-
-  /**
-   * The AWS region to which this client will send requests
-   */
-  region?: string | __Provider<string>;
-
-  /**
-   * Default credentials provider; Not available in browser runtime.
-   * @internal
-   */
-  credentialDefaultProvider?: (input: any) => __Provider<__Credentials>;
-
-  /**
-   * Fetch related hostname, signing name or signing region with given region.
-   * @internal
-   */
-  regionInfoProvider?: RegionInfoProvider;
-
-  /**
-   * The provider populating default tracking information to be sent with `user-agent`, `x-amz-user-agent` header
-   * @internal
-   */
-  defaultUserAgentProvider?: Provider<__UserAgent>;
-}
-
-type SageMakerRuntimeClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
-  ClientDefaults &
-  RegionInputConfig &
-  EndpointsInputConfig &
-  RetryInputConfig &
-  HostHeaderInputConfig &
-  AwsAuthInputConfig &
-  UserAgentInputConfig;
-/**
- * The configuration interface of SageMakerRuntimeClient class constructor that set the region, credentials and other options.
- */
-export interface SageMakerRuntimeClientConfig extends SageMakerRuntimeClientConfigType {}
-
-type SageMakerRuntimeClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
-  Required<ClientDefaults> &
-  RegionResolvedConfig &
-  EndpointsResolvedConfig &
-  RetryResolvedConfig &
-  HostHeaderResolvedConfig &
-  AwsAuthResolvedConfig &
-  UserAgentResolvedConfig;
-/**
- * The resolved configuration interface of SageMakerRuntimeClient class. This is resolved and normalized from the {@link SageMakerRuntimeClientConfig | constructor configuration interface}.
- */
-export interface SageMakerRuntimeClientResolvedConfig extends SageMakerRuntimeClientResolvedConfigType {}
-
-/**
- * <p> The Amazon SageMaker runtime API. </p>
- */
-export class SageMakerRuntimeClient extends __Client<
-  __HttpHandlerOptions,
-  ServiceInputTypes,
-  ServiceOutputTypes,
-  SageMakerRuntimeClientResolvedConfig
-> {
-  /**
-   * The resolved configuration of SageMakerRuntimeClient class. This is resolved and normalized from the {@link SageMakerRuntimeClientConfig | constructor configuration interface}.
-   */
-  readonly config: SageMakerRuntimeClientResolvedConfig;
-
-  constructor(configuration: SageMakerRuntimeClientConfig) {
-    const _config_0 = __getRuntimeConfig(configuration);
-    const _config_1 = resolveRegionConfig(_config_0);
-    const _config_2 = resolveEndpointsConfig(_config_1);
-    const _config_3 = resolveRetryConfig(_config_2);
-    const _config_4 = resolveHostHeaderConfig(_config_3);
-    const _config_5 = resolveAwsAuthConfig(_config_4);
-    const _config_6 = resolveUserAgentConfig(_config_5);
-    super(_config_6);
-    this.config = _config_6;
-    this.middlewareStack.use(getRetryPlugin(this.config));
-    this.middlewareStack.use(getContentLengthPlugin(this.config));
-    this.middlewareStack.use(getHostHeaderPlugin(this.config));
-    this.middlewareStack.use(getLoggerPlugin(this.config));
-    this.middlewareStack.use(getAwsAuthPlugin(this.config));
-    this.middlewareStack.use(getUserAgentPlugin(this.config));
-  }
-
-  /**
-   * Destroy underlying resources, like sockets. It's usually not necessary to do this.
-   * However in Node.js, it's best to explicitly shut down the client's agent when it is no longer needed.
-   * Otherwise, sockets might stay open for quite a long time before the server terminates them.
-   */
-  destroy(): void {
-    super.destroy();
-  }
-}

package/src/commands/InvokeEndpointAsyncCommand.ts

@@ -1,111 +0,0 @@
-import { getSerdePlugin } from "@aws-sdk/middleware-serde";
-import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
-import { Command as $Command } from "@aws-sdk/smithy-client";
-import {
-  FinalizeHandlerArguments,
-  Handler,
-  HandlerExecutionContext,
-  HttpHandlerOptions as __HttpHandlerOptions,
-  MetadataBearer as __MetadataBearer,
-  MiddlewareStack,
-  SerdeContext as __SerdeContext,
-} from "@aws-sdk/types";
-
-import { InvokeEndpointAsyncInput, InvokeEndpointAsyncOutput } from "../models/models_0";
-import {
-  deserializeAws_restJson1InvokeEndpointAsyncCommand,
-  serializeAws_restJson1InvokeEndpointAsyncCommand,
-} from "../protocols/Aws_restJson1";
-import { SageMakerRuntimeClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SageMakerRuntimeClient";
-
-export interface InvokeEndpointAsyncCommandInput extends InvokeEndpointAsyncInput {}
-export interface InvokeEndpointAsyncCommandOutput extends InvokeEndpointAsyncOutput, __MetadataBearer {}
-
-/**
- * <p>After you deploy a model into production using Amazon SageMaker hosting services,
- *             your client applications use this API to get inferences from the model hosted at
- *             the specified endpoint in an asynchronous manner.</p>
- *
- *         <p>Inference requests sent to this API are enqueued for asynchronous processing.
- *             The processing of the inference request may or may not complete before the
- *             you receive a response from this API. The response from this API will
- *             not contain the result of the inference request but contain information
- *             about where you can locate it.</p>
- *
- *         <p>Amazon SageMaker strips all <code>POST</code> headers except those supported by the API.
- *             Amazon SageMaker might add additional headers. You should not rely on the behavior
- *             of headers outside those enumerated in the request syntax.</p>
- *
- *         <p>Calls to <code>InvokeEndpointAsync</code> are authenticated by using AWS Signature
- *             Version 4. For information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html">Authenticating Requests (AWS Signature Version 4)</a> in the <i>Amazon S3 API
- *                 Reference</i>.</p>
- * @example
- * Use a bare-bones client and the command you need to make an API call.
- * ```javascript
- * import { SageMakerRuntimeClient, InvokeEndpointAsyncCommand } from "@aws-sdk/client-sagemaker-runtime"; // ES Modules import
- * // const { SageMakerRuntimeClient, InvokeEndpointAsyncCommand } = require("@aws-sdk/client-sagemaker-runtime"); // CommonJS import
- * const client = new SageMakerRuntimeClient(config);
- * const command = new InvokeEndpointAsyncCommand(input);
- * const response = await client.send(command);
- * ```
- *
- * @see {@link InvokeEndpointAsyncCommandInput} for command's `input` shape.
- * @see {@link InvokeEndpointAsyncCommandOutput} for command's `response` shape.
- * @see {@link SageMakerRuntimeClientResolvedConfig | config} for command's `input` shape.
- *
- */
-export class InvokeEndpointAsyncCommand extends $Command<
-  InvokeEndpointAsyncCommandInput,
-  InvokeEndpointAsyncCommandOutput,
-  SageMakerRuntimeClientResolvedConfig
-> {
-  // Start section: command_properties
-  // End section: command_properties
-
-  constructor(readonly input: InvokeEndpointAsyncCommandInput) {
-    // Start section: command_constructor
-    super();
-    // End section: command_constructor
-  }
-
-  /**
-   * @internal
-   */
-  resolveMiddleware(
-    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
-    configuration: SageMakerRuntimeClientResolvedConfig,
-    options?: __HttpHandlerOptions
-  ): Handler<InvokeEndpointAsyncCommandInput, InvokeEndpointAsyncCommandOutput> {
-    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
-
-    const stack = clientStack.concat(this.middlewareStack);
-
-    const { logger } = configuration;
-    const clientName = "SageMakerRuntimeClient";
-    const commandName = "InvokeEndpointAsyncCommand";
-    const handlerExecutionContext: HandlerExecutionContext = {
-      logger,
-      clientName,
-      commandName,
-      inputFilterSensitiveLog: InvokeEndpointAsyncInput.filterSensitiveLog,
-      outputFilterSensitiveLog: InvokeEndpointAsyncOutput.filterSensitiveLog,
-    };
-    const { requestHandler } = configuration;
-    return stack.resolve(
-      (request: FinalizeHandlerArguments<any>) =>
-        requestHandler.handle(request.request as __HttpRequest, options || {}),
-      handlerExecutionContext
-    );
-  }
-
-  private serialize(input: InvokeEndpointAsyncCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
-    return serializeAws_restJson1InvokeEndpointAsyncCommand(input, context);
-  }
-
-  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<InvokeEndpointAsyncCommandOutput> {
-    return deserializeAws_restJson1InvokeEndpointAsyncCommand(output, context);
-  }
-
-  // Start section: command_body_extra
-  // End section: command_body_extra
-}

package/src/commands/InvokeEndpointCommand.ts

@@ -1,114 +0,0 @@
-import { getSerdePlugin } from "@aws-sdk/middleware-serde";
-import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
-import { Command as $Command } from "@aws-sdk/smithy-client";
-import {
-  FinalizeHandlerArguments,
-  Handler,
-  HandlerExecutionContext,
-  HttpHandlerOptions as __HttpHandlerOptions,
-  MetadataBearer as __MetadataBearer,
-  MiddlewareStack,
-  SerdeContext as __SerdeContext,
-} from "@aws-sdk/types";
-
-import { InvokeEndpointInput, InvokeEndpointOutput } from "../models/models_0";
-import {
-  deserializeAws_restJson1InvokeEndpointCommand,
-  serializeAws_restJson1InvokeEndpointCommand,
-} from "../protocols/Aws_restJson1";
-import { SageMakerRuntimeClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SageMakerRuntimeClient";
-
-export interface InvokeEndpointCommandInput extends InvokeEndpointInput {}
-export interface InvokeEndpointCommandOutput extends InvokeEndpointOutput, __MetadataBearer {}
-
-/**
- * <p>After you deploy a model into production using Amazon SageMaker hosting services, your
- *             client applications use this API to get inferences from the model hosted at the
- *             specified endpoint. </p>
- *         <p>For an overview of Amazon SageMaker, see <a href="https://docs.aws.amazon.com/sagemaker/latest/dg/how-it-works.html">How It Works</a>. </p>
- *         <p>Amazon SageMaker strips all POST headers except those supported by the API. Amazon SageMaker might add
- *             additional headers. You should not rely on the behavior of headers outside those
- *             enumerated in the request syntax. </p>
- *         <p>Calls to <code>InvokeEndpoint</code> are authenticated by using AWS Signature Version
- *             4. For information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html">Authenticating
- *                 Requests (AWS Signature Version 4)</a> in the <i>Amazon S3 API
- *                 Reference</i>.</p>
- *         <p>A customer's model containers must respond to requests within 60 seconds. The model
- *             itself can have a maximum processing time of 60 seconds before responding to
- *             invocations. If your model is going to take 50-60 seconds of processing time, the SDK
- *             socket timeout should be set to be 70 seconds.</p>
- *         <note>
- *             <p>Endpoints are scoped to an individual account, and are not public. The URL does
- *                 not contain the account ID, but Amazon SageMaker determines the account ID from the
- *                 authentication token that is supplied by the caller.</p>
- *         </note>
- * @example
- * Use a bare-bones client and the command you need to make an API call.
- * ```javascript
- * import { SageMakerRuntimeClient, InvokeEndpointCommand } from "@aws-sdk/client-sagemaker-runtime"; // ES Modules import
- * // const { SageMakerRuntimeClient, InvokeEndpointCommand } = require("@aws-sdk/client-sagemaker-runtime"); // CommonJS import
- * const client = new SageMakerRuntimeClient(config);
- * const command = new InvokeEndpointCommand(input);
- * const response = await client.send(command);
- * ```
- *
- * @see {@link InvokeEndpointCommandInput} for command's `input` shape.
- * @see {@link InvokeEndpointCommandOutput} for command's `response` shape.
- * @see {@link SageMakerRuntimeClientResolvedConfig | config} for command's `input` shape.
- *
- */
-export class InvokeEndpointCommand extends $Command<
-  InvokeEndpointCommandInput,
-  InvokeEndpointCommandOutput,
-  SageMakerRuntimeClientResolvedConfig
-> {
-  // Start section: command_properties
-  // End section: command_properties
-
-  constructor(readonly input: InvokeEndpointCommandInput) {
-    // Start section: command_constructor
-    super();
-    // End section: command_constructor
-  }
-
-  /**
-   * @internal
-   */
-  resolveMiddleware(
-    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
-    configuration: SageMakerRuntimeClientResolvedConfig,
-    options?: __HttpHandlerOptions
-  ): Handler<InvokeEndpointCommandInput, InvokeEndpointCommandOutput> {
-    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
-
-    const stack = clientStack.concat(this.middlewareStack);
-
-    const { logger } = configuration;
-    const clientName = "SageMakerRuntimeClient";
-    const commandName = "InvokeEndpointCommand";
-    const handlerExecutionContext: HandlerExecutionContext = {
-      logger,
-      clientName,
-      commandName,
-      inputFilterSensitiveLog: InvokeEndpointInput.filterSensitiveLog,
-      outputFilterSensitiveLog: InvokeEndpointOutput.filterSensitiveLog,
-    };
-    const { requestHandler } = configuration;
-    return stack.resolve(
-      (request: FinalizeHandlerArguments<any>) =>
-        requestHandler.handle(request.request as __HttpRequest, options || {}),
-      handlerExecutionContext
-    );
-  }
-
-  private serialize(input: InvokeEndpointCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
-    return serializeAws_restJson1InvokeEndpointCommand(input, context);
-  }
-
-  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<InvokeEndpointCommandOutput> {
-    return deserializeAws_restJson1InvokeEndpointCommand(output, context);
-  }
-
-  // Start section: command_body_extra
-  // End section: command_body_extra
-}

package/src/endpoints.ts

@@ -1,82 +0,0 @@
-import { getRegionInfo, PartitionHash, RegionHash } from "@aws-sdk/config-resolver";
-import { RegionInfoProvider } from "@aws-sdk/types";
-
-const regionHash: RegionHash = {
-  "us-east-1-fips": {
-    hostname: "runtime-fips.sagemaker.us-east-1.amazonaws.com",
-    signingRegion: "us-east-1",
-  },
-  "us-east-2-fips": {
-    hostname: "runtime-fips.sagemaker.us-east-2.amazonaws.com",
-    signingRegion: "us-east-2",
-  },
-  "us-gov-west-1-fips": {
-    hostname: "runtime.sagemaker.us-gov-west-1.amazonaws.com",
-    signingRegion: "us-gov-west-1",
-  },
-  "us-west-1-fips": {
-    hostname: "runtime-fips.sagemaker.us-west-1.amazonaws.com",
-    signingRegion: "us-west-1",
-  },
-  "us-west-2-fips": {
-    hostname: "runtime-fips.sagemaker.us-west-2.amazonaws.com",
-    signingRegion: "us-west-2",
-  },
-};
-
-const partitionHash: PartitionHash = {
-  aws: {
-    regions: [
-      "af-south-1",
-      "ap-east-1",
-      "ap-northeast-1",
-      "ap-northeast-2",
-      "ap-northeast-3",
-      "ap-south-1",
-      "ap-southeast-1",
-      "ap-southeast-2",
-      "ca-central-1",
-      "eu-central-1",
-      "eu-north-1",
-      "eu-south-1",
-      "eu-west-1",
-      "eu-west-2",
-      "eu-west-3",
-      "me-south-1",
-      "sa-east-1",
-      "us-east-1",
-      "us-east-1-fips",
-      "us-east-2",
-      "us-east-2-fips",
-      "us-west-1",
-      "us-west-1-fips",
-      "us-west-2",
-      "us-west-2-fips",
-    ],
-    hostname: "runtime.sagemaker.{region}.amazonaws.com",
-  },
-  "aws-cn": {
-    regions: ["cn-north-1", "cn-northwest-1"],
-    hostname: "runtime.sagemaker.{region}.amazonaws.com.cn",
-  },
-  "aws-iso": {
-    regions: ["us-iso-east-1"],
-    hostname: "runtime.sagemaker.{region}.c2s.ic.gov",
-  },
-  "aws-iso-b": {
-    regions: ["us-isob-east-1"],
-    hostname: "runtime.sagemaker.{region}.sc2s.sgov.gov",
-  },
-  "aws-us-gov": {
-    regions: ["us-gov-east-1", "us-gov-west-1", "us-gov-west-1-fips"],
-    hostname: "runtime.sagemaker.{region}.amazonaws.com",
-  },
-};
-
-export const defaultRegionInfoProvider: RegionInfoProvider = async (region: string, options?: any) =>
-  getRegionInfo(region, {
-    ...options,
-    signingService: "sagemaker",
-    regionHash,
-    partitionHash,
-  });

package/src/index.ts

@@ -1,5 +0,0 @@
-export * from "./SageMakerRuntimeClient";
-export * from "./SageMakerRuntime";
-export * from "./commands/InvokeEndpointCommand";
-export * from "./commands/InvokeEndpointAsyncCommand";
-export * from "./models/index";

package/src/models/index.ts

@@ -1 +0,0 @@
-export * from "./models_0";