feat(client-servicediscovery): Updated the ListNamespaces API to support the NAME and HTTP_NAME filters, and the BEGINS_WITH filter condition.

Author: awstools

clients/client-servicediscovery/README.md

@@ -11,11 +11,12 @@ AWS SDK for JavaScript ServiceDiscovery Client for Node.js, Browser and React Na
 
 <fullname>Cloud Map</fullname>
 
-<p>With Cloud Map, you can configure public DNS, private DNS, or HTTP namespaces that your microservice
-applications run in. When an instance becomes available, you can call the Cloud Map API to register the instance
-with Cloud Map. For public or private DNS namespaces, Cloud Map automatically creates DNS records and an optional
-health check. Clients that submit public or private DNS queries, or HTTP requests, for the service receive an answer
-that contains up to eight healthy records. </p>
+<p>With Cloud Map, you can configure public DNS, private DNS, or HTTP namespaces that your
+microservice applications run in. When an instance becomes available, you can call the Cloud Map
+API to register the instance with Cloud Map. For public or private DNS namespaces, Cloud Map
+automatically creates DNS records and an optional health check. Clients that submit public or
+private DNS queries, or HTTP requests, for the service receive an answer that contains up to
+eight healthy records. </p>
 
 ## Installing
 

clients/client-servicediscovery/package.json

@@ -26,6 +26,7 @@
     "@aws-sdk/hash-node": "*",
     "@aws-sdk/invalid-dependency": "*",
     "@aws-sdk/middleware-content-length": "*",
+    "@aws-sdk/middleware-endpoint": "*",
     "@aws-sdk/middleware-host-header": "*",
     "@aws-sdk/middleware-logger": "*",
     "@aws-sdk/middleware-recursion-detection": "*",

clients/client-servicediscovery/src/ServiceDiscovery.ts

@@ -1,13 +1,7 @@
 // smithy-typescript generated code
-import {
-  EndpointsInputConfig,
-  EndpointsResolvedConfig,
-  RegionInputConfig,
-  RegionResolvedConfig,
-  resolveEndpointsConfig,
-  resolveRegionConfig,
-} from "@aws-sdk/config-resolver";
+import { RegionInputConfig, RegionResolvedConfig, resolveRegionConfig } from "@aws-sdk/config-resolver";
 import { getContentLengthPlugin } from "@aws-sdk/middleware-content-length";
+import { EndpointInputConfig, EndpointResolvedConfig, resolveEndpointConfig } from "@aws-sdk/middleware-endpoint";
 import {
   getHostHeaderPlugin,
   HostHeaderInputConfig,
@@ -41,13 +35,13 @@ import {
   Credentials as __Credentials,
   Decoder as __Decoder,
   Encoder as __Encoder,
+  EndpointV2 as __EndpointV2,
   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,
@@ -106,6 +100,12 @@ import {
   UpdatePublicDnsNamespaceCommandOutput,
 } from "./commands/UpdatePublicDnsNamespaceCommand";
 import { UpdateServiceCommandInput, UpdateServiceCommandOutput } from "./commands/UpdateServiceCommand";
+import {
+  ClientInputEndpointParameters,
+  ClientResolvedEndpointParameters,
+  EndpointParameters,
+  resolveClientEndpointParameters,
+} from "./endpoint/EndpointParameters";
 import { getRuntimeConfig as __getRuntimeConfig } from "./runtimeConfig";
 
 export type ServiceInputTypes =
@@ -273,12 +273,6 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
    */
   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
@@ -294,11 +288,12 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
 type ServiceDiscoveryClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
   ClientDefaults &
   RegionInputConfig &
-  EndpointsInputConfig &
+  EndpointInputConfig<EndpointParameters> &
   RetryInputConfig &
   HostHeaderInputConfig &
   AwsAuthInputConfig &
-  UserAgentInputConfig;
+  UserAgentInputConfig &
+  ClientInputEndpointParameters;
 /**
  * The configuration interface of ServiceDiscoveryClient class constructor that set the region, credentials and other options.
  */
@@ -307,23 +302,25 @@ export interface ServiceDiscoveryClientConfig extends ServiceDiscoveryClientConf
 type ServiceDiscoveryClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
   Required<ClientDefaults> &
   RegionResolvedConfig &
-  EndpointsResolvedConfig &
+  EndpointResolvedConfig<EndpointParameters> &
   RetryResolvedConfig &
   HostHeaderResolvedConfig &
   AwsAuthResolvedConfig &
-  UserAgentResolvedConfig;
+  UserAgentResolvedConfig &
+  ClientResolvedEndpointParameters;
 /**
  * The resolved configuration interface of ServiceDiscoveryClient class. This is resolved and normalized from the {@link ServiceDiscoveryClientConfig | constructor configuration interface}.
  */
 export interface ServiceDiscoveryClientResolvedConfig extends ServiceDiscoveryClientResolvedConfigType {}
 
 /**
  * <fullname>Cloud Map</fullname>
- *          <p>With Cloud Map, you can configure public DNS, private DNS, or HTTP namespaces that your microservice
- *    applications run in. When an instance becomes available, you can call the Cloud Map API to register the instance
- *    with Cloud Map. For public or private DNS namespaces, Cloud Map automatically creates DNS records and an optional
- *    health check. Clients that submit public or private DNS queries, or HTTP requests, for the service receive an answer
- *    that contains up to eight healthy records. </p>
+ *          <p>With Cloud Map, you can configure public DNS, private DNS, or HTTP namespaces that your
+ *    microservice applications run in. When an instance becomes available, you can call the Cloud Map
+ *    API to register the instance with Cloud Map. For public or private DNS namespaces, Cloud Map
+ *    automatically creates DNS records and an optional health check. Clients that submit public or
+ *    private DNS queries, or HTTP requests, for the service receive an answer that contains up to
+ *    eight healthy records. </p>
  */
 export class ServiceDiscoveryClient extends __Client<
   __HttpHandlerOptions,
@@ -338,14 +335,15 @@ export class ServiceDiscoveryClient extends __Client<
 
   constructor(configuration: ServiceDiscoveryClientConfig) {
     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;
+    const _config_1 = resolveClientEndpointParameters(_config_0);
+    const _config_2 = resolveRegionConfig(_config_1);
+    const _config_3 = resolveEndpointConfig(_config_2);
+    const _config_4 = resolveRetryConfig(_config_3);
+    const _config_5 = resolveHostHeaderConfig(_config_4);
+    const _config_6 = resolveAwsAuthConfig(_config_5);
+    const _config_7 = resolveUserAgentConfig(_config_6);
+    super(_config_7);
+    this.config = _config_7;
     this.middlewareStack.use(getRetryPlugin(this.config));
     this.middlewareStack.use(getContentLengthPlugin(this.config));
     this.middlewareStack.use(getHostHeaderPlugin(this.config));

clients/client-servicediscovery/src/ServiceDiscoveryClient.ts

@@ -1,4 +1,5 @@
 // smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
 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";
@@ -28,10 +29,10 @@ export interface CreateHttpNamespaceCommandInput extends CreateHttpNamespaceRequ
 export interface CreateHttpNamespaceCommandOutput extends CreateHttpNamespaceResponse, __MetadataBearer {}
 
 /**
- * <p>Creates an HTTP namespace. Service instances registered using an HTTP namespace can be discovered using a
- *     <code>DiscoverInstances</code> request but can't be discovered using DNS.</p>
- *          <p>For the current quota on the number of namespaces that you can create using the same account,
- *    see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html">Cloud Map quotas</a> in the
+ * <p>Creates an HTTP namespace. Service instances registered using an HTTP namespace can be
+ *    discovered using a <code>DiscoverInstances</code> request but can't be discovered using
+ *    DNS.</p>
+ *          <p>For the current quota on the number of namespaces that you can create using the same Amazon Web Services account, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html">Cloud Map quotas</a> in the
  *     <i>Cloud Map Developer Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -56,6 +57,15 @@ export class CreateHttpNamespaceCommand extends $Command<
   // Start section: command_properties
   // End section: command_properties
 
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "Endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
   constructor(readonly input: CreateHttpNamespaceCommandInput) {
     // Start section: command_constructor
     super();
@@ -71,6 +81,9 @@ export class CreateHttpNamespaceCommand extends $Command<
     options?: __HttpHandlerOptions
   ): Handler<CreateHttpNamespaceCommandInput, CreateHttpNamespaceCommandOutput> {
     this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, CreateHttpNamespaceCommand.getEndpointParameterInstructions())
+    );
 
     const stack = clientStack.concat(this.middlewareStack);
 

clients/client-servicediscovery/src/commands/CreateHttpNamespaceCommand.ts

@@ -1,4 +1,5 @@
 // smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
 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";
@@ -28,12 +29,13 @@ export interface CreatePrivateDnsNamespaceCommandInput extends CreatePrivateDnsN
 export interface CreatePrivateDnsNamespaceCommandOutput extends CreatePrivateDnsNamespaceResponse, __MetadataBearer {}
 
 /**
- * <p>Creates a private namespace based on DNS, which is visible only inside a specified Amazon VPC. The namespace
- *    defines your service naming scheme. For example, if you name your namespace <code>example.com</code> and name your
- *    service <code>backend</code>, the resulting DNS name for the service is <code>backend.example.com</code>. Service
- *    instances that are registered using a private DNS namespace can be discovered using either a
- *     <code>DiscoverInstances</code> request or using DNS. For the current quota on the number of namespaces that you can
- *    create using the same account, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html">Cloud Map quotas</a> in the
+ * <p>Creates a private namespace based on DNS, which is visible only inside a specified Amazon
+ *    VPC. The namespace defines your service naming scheme. For example, if you name your namespace
+ *     <code>example.com</code> and name your service <code>backend</code>, the resulting DNS name for
+ *    the service is <code>backend.example.com</code>. Service instances that are registered using a
+ *    private DNS namespace can be discovered using either a <code>DiscoverInstances</code> request or
+ *    using DNS. For the current quota on the number of namespaces that you can create using the same
+ *     Amazon Web Services account, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html">Cloud Map quotas</a> in the
  *     <i>Cloud Map Developer Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -58,6 +60,15 @@ export class CreatePrivateDnsNamespaceCommand extends $Command<
   // Start section: command_properties
   // End section: command_properties
 
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "Endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
   constructor(readonly input: CreatePrivateDnsNamespaceCommandInput) {
     // Start section: command_constructor
     super();
@@ -73,6 +84,9 @@ export class CreatePrivateDnsNamespaceCommand extends $Command<
     options?: __HttpHandlerOptions
   ): Handler<CreatePrivateDnsNamespaceCommandInput, CreatePrivateDnsNamespaceCommandOutput> {
     this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, CreatePrivateDnsNamespaceCommand.getEndpointParameterInstructions())
+    );
 
     const stack = clientStack.concat(this.middlewareStack);
 

clients/client-servicediscovery/src/commands/CreatePrivateDnsNamespaceCommand.ts

@@ -1,4 +1,5 @@
 // smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
 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";
@@ -28,12 +29,17 @@ export interface CreatePublicDnsNamespaceCommandInput extends CreatePublicDnsNam
 export interface CreatePublicDnsNamespaceCommandOutput extends CreatePublicDnsNamespaceResponse, __MetadataBearer {}
 
 /**
- * <p>Creates a public namespace based on DNS, which is visible on the internet. The namespace defines your service
- *    naming scheme. For example, if you name your namespace <code>example.com</code> and name your service
- *     <code>backend</code>, the resulting DNS name for the service is <code>backend.example.com</code>. You can discover
- *    instances that were registered with a public DNS namespace by using either a <code>DiscoverInstances</code> request
- *    or using DNS. For the current quota on the number of namespaces that you can create using the same account, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html">Cloud Map
- *     quotas</a> in the <i>Cloud Map Developer Guide</i>.</p>
+ * <p>Creates a public namespace based on DNS, which is visible on the internet. The namespace
+ *    defines your service naming scheme. For example, if you name your namespace
+ *     <code>example.com</code> and name your service <code>backend</code>, the resulting DNS name for
+ *    the service is <code>backend.example.com</code>. You can discover instances that were registered
+ *    with a public DNS namespace by using either a <code>DiscoverInstances</code> request or using
+ *    DNS. For the current quota on the number of namespaces that you can create using the same Amazon Web Services account, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html">Cloud Map quotas</a> in the
+ *     <i>Cloud Map Developer Guide</i>.</p>
+ *
+ *          <important>
+ *             <p>The <code>CreatePublicDnsNamespace</code> API operation is not supported in the Amazon Web Services GovCloud (US) Regions.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -57,6 +63,15 @@ export class CreatePublicDnsNamespaceCommand extends $Command<
   // Start section: command_properties
   // End section: command_properties
 
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "Endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
   constructor(readonly input: CreatePublicDnsNamespaceCommandInput) {
     // Start section: command_constructor
     super();
@@ -72,6 +87,9 @@ export class CreatePublicDnsNamespaceCommand extends $Command<
     options?: __HttpHandlerOptions
   ): Handler<CreatePublicDnsNamespaceCommandInput, CreatePublicDnsNamespaceCommandOutput> {
     this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, CreatePublicDnsNamespaceCommand.getEndpointParameterInstructions())
+    );
 
     const stack = clientStack.concat(this.middlewareStack);