@aws-sdk/client-servicediscovery 3.288.0 → 3.289.0

package/dist-types/commands/CreateHttpNamespaceCommand.d.ts

@@ -33,6 +33,24 @@ export interface CreateHttpNamespaceCommandOutput extends CreateHttpNamespaceRes
  * @see {@link CreateHttpNamespaceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example CreateHttpNamespace example
+ * ```javascript
+ * // This example creates an HTTP namespace.
+ * const input = {
+ *   "CreatorRequestId": "example-creator-request-id-0001",
+ *   "Description": "Example.com AWS Cloud Map HTTP Namespace",
+ *   "Name": "example-http.com"
+ * };
+ * const command = new CreateHttpNamespaceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OperationId": "httpvoqozuhfet5kzxoxg-a-response-example"
+ * }
+ * *\/
+ * // example id: createhttpnamespace-example-1590114811304
+ * ```
+ *
  */
 export declare class CreateHttpNamespaceCommand extends $Command<CreateHttpNamespaceCommandInput, CreateHttpNamespaceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: CreateHttpNamespaceCommandInput;

package/dist-types/commands/CreatePrivateDnsNamespaceCommand.d.ts

@@ -36,6 +36,24 @@ export interface CreatePrivateDnsNamespaceCommandOutput extends CreatePrivateDns
  * @see {@link CreatePrivateDnsNamespaceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: Create private DNS namespace
+ * ```javascript
+ * // Example: Create private DNS namespace
+ * const input = {
+ *   "CreatorRequestId": "eedd6892-50f3-41b2-8af9-611d6e1d1a8c",
+ *   "Name": "example.com",
+ *   "Vpc": "vpc-1c56417b"
+ * };
+ * const command = new CreatePrivateDnsNamespaceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
+ * }
+ * *\/
+ * // example id: example-create-private-dns-namespace-1587058592930
+ * ```
+ *
  */
 export declare class CreatePrivateDnsNamespaceCommand extends $Command<CreatePrivateDnsNamespaceCommandInput, CreatePrivateDnsNamespaceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: CreatePrivateDnsNamespaceCommandInput;

package/dist-types/commands/CreatePublicDnsNamespaceCommand.d.ts

@@ -38,6 +38,24 @@ export interface CreatePublicDnsNamespaceCommandOutput extends CreatePublicDnsNa
  * @see {@link CreatePublicDnsNamespaceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example CreatePublicDnsNamespace example
+ * ```javascript
+ * // This example creates a public namespace based on DNS.
+ * const input = {
+ *   "CreatorRequestId": "example-creator-request-id-0003",
+ *   "Description": "Example.com AWS Cloud Map Public DNS Namespace",
+ *   "Name": "example-public-dns.com"
+ * };
+ * const command = new CreatePublicDnsNamespaceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OperationId": "dns2voqozuhfet5kzxoxg-a-response-example"
+ * }
+ * *\/
+ * // example id: createpublicdnsnamespace-example-1590114940910
+ * ```
+ *
  */
 export declare class CreatePublicDnsNamespaceCommand extends $Command<CreatePublicDnsNamespaceCommandInput, CreatePublicDnsNamespaceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: CreatePublicDnsNamespaceCommandInput;

package/dist-types/commands/CreateServiceCommand.d.ts

@@ -70,6 +70,51 @@ export interface CreateServiceCommandOutput extends CreateServiceResponse, __Met
  * @see {@link CreateServiceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: Create service
+ * ```javascript
+ * // Example: Create service
+ * const input = {
+ *   "CreatorRequestId": "567c1193-6b00-4308-bd57-ad38a8822d25",
+ *   "DnsConfig": {
+ *     "DnsRecords": [
+ *       {
+ *         "TTL": 60,
+ *         "Type": "A"
+ *       }
+ *     ],
+ *     "NamespaceId": "ns-ylexjili4cdxy3xm",
+ *     "RoutingPolicy": "MULTIVALUE"
+ *   },
+ *   "Name": "myservice",
+ *   "NamespaceId": "ns-ylexjili4cdxy3xm"
+ * };
+ * const command = new CreateServiceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Service": {
+ *     "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita",
+ *     "CreateDate": 1587081768.334,
+ *     "CreatorRequestId": "567c1193-6b00-4308-bd57-ad38a8822d25",
+ *     "DnsConfig": {
+ *       "DnsRecords": [
+ *         {
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       ],
+ *       "NamespaceId": "ns-ylexjili4cdxy3xm",
+ *       "RoutingPolicy": "MULTIVALUE"
+ *     },
+ *     "Id": "srv-p5zdwlg5uvvzjita",
+ *     "Name": "myservice",
+ *     "NamespaceId": "ns-ylexjili4cdxy3xm"
+ *   }
+ * }
+ * *\/
+ * // example id: example-create-service-1587235913584
+ * ```
+ *
  */
 export declare class CreateServiceCommand extends $Command<CreateServiceCommandInput, CreateServiceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: CreateServiceCommandInput;

package/dist-types/commands/DeleteNamespaceCommand.d.ts

@@ -30,6 +30,22 @@ export interface DeleteNamespaceCommandOutput extends DeleteNamespaceResponse, _
  * @see {@link DeleteNamespaceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: Delete namespace
+ * ```javascript
+ * // Example: Delete namespace
+ * const input = {
+ *   "Id": "ns-ylexjili4cdxy3xm"
+ * };
+ * const command = new DeleteNamespaceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk"
+ * }
+ * *\/
+ * // example id: example-delete-namespace-1587416093508
+ * ```
+ *
  */
 export declare class DeleteNamespaceCommand extends $Command<DeleteNamespaceCommandInput, DeleteNamespaceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: DeleteNamespaceCommandInput;

package/dist-types/commands/DeleteServiceCommand.d.ts

@@ -30,6 +30,17 @@ export interface DeleteServiceCommandOutput extends DeleteServiceResponse, __Met
  * @see {@link DeleteServiceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: Delete service
+ * ```javascript
+ * // Example: Delete service
+ * const input = {
+ *   "Id": "srv-p5zdwlg5uvvzjita"
+ * };
+ * const command = new DeleteServiceCommand(input);
+ * await client.send(command);
+ * // example id: example-delete-service-1587416462902
+ * ```
+ *
  */
 export declare class DeleteServiceCommand extends $Command<DeleteServiceCommandInput, DeleteServiceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: DeleteServiceCommandInput;

package/dist-types/commands/DeregisterInstanceCommand.d.ts

@@ -30,6 +30,23 @@ export interface DeregisterInstanceCommandOutput extends DeregisterInstanceRespo
  * @see {@link DeregisterInstanceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: Deregister a service instance
+ * ```javascript
+ * // Example: Deregister a service instance
+ * const input = {
+ *   "InstanceId": "myservice-53",
+ *   "ServiceId": "srv-p5zdwlg5uvvzjita"
+ * };
+ * const command = new DeregisterInstanceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq"
+ * }
+ * *\/
+ * // example id: example-deregister-a-service-instance-1587416305738
+ * ```
+ *
  */
 export declare class DeregisterInstanceCommand extends $Command<DeregisterInstanceCommandInput, DeregisterInstanceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: DeregisterInstanceCommandInput;

package/dist-types/commands/DiscoverInstancesCommand.d.ts

@@ -31,6 +31,36 @@ export interface DiscoverInstancesCommandOutput extends DiscoverInstancesRespons
  * @see {@link DiscoverInstancesCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: Discover registered instances
+ * ```javascript
+ * // Example: Discover registered instances
+ * const input = {
+ *   "HealthStatus": "ALL",
+ *   "MaxResults": 10,
+ *   "NamespaceName": "example.com",
+ *   "ServiceName": "myservice"
+ * };
+ * const command = new DiscoverInstancesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Instances": [
+ *     {
+ *       "Attributes": {
+ *         "AWS_INSTANCE_IPV4": "172.2.1.3",
+ *         "AWS_INSTANCE_PORT": "808"
+ *       },
+ *       "HealthStatus": "UNKNOWN",
+ *       "InstanceId": "myservice-53",
+ *       "NamespaceName": "example.com",
+ *       "ServiceName": "myservice"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-discover-registered-instances-1587236343568
+ * ```
+ *
  */
 export declare class DiscoverInstancesCommand extends $Command<DiscoverInstancesCommandInput, DiscoverInstancesCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: DiscoverInstancesCommandInput;

package/dist-types/commands/GetInstanceCommand.d.ts

@@ -29,6 +29,32 @@ export interface GetInstanceCommandOutput extends GetInstanceResponse, __Metadat
  * @see {@link GetInstanceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example GetInstance example
+ * ```javascript
+ * // This example gets information about a specified instance.
+ * const input = {
+ *   "InstanceId": "i-abcd1234",
+ *   "ServiceId": "srv-e4anhexample0004"
+ * };
+ * const command = new GetInstanceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Instance": {
+ *     "Attributes": {
+ *       "AWS_INSTANCE_IPV4": "192.0.2.44",
+ *       "AWS_INSTANCE_PORT": "80",
+ *       "color": "green",
+ *       "region": "us-west-2",
+ *       "stage": "beta"
+ *     },
+ *     "Id": "i-abcd1234"
+ *   }
+ * }
+ * *\/
+ * // example id: getinstance-example-1590115065598
+ * ```
+ *
  */
 export declare class GetInstanceCommand extends $Command<GetInstanceCommandInput, GetInstanceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: GetInstanceCommandInput;

package/dist-types/commands/GetInstancesHealthStatusCommand.d.ts

@@ -35,6 +35,25 @@ export interface GetInstancesHealthStatusCommandOutput extends GetInstancesHealt
  * @see {@link GetInstancesHealthStatusCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example GetInstancesHealthStatus example
+ * ```javascript
+ * // This example gets the current health status of one or more instances that are associate with a specified service.
+ * const input = {
+ *   "ServiceId": "srv-e4anhexample0004"
+ * };
+ * const command = new GetInstancesHealthStatusCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Status": {
+ *     "i-abcd1234": "HEALTHY",
+ *     "i-abcd1235": "UNHEALTHY"
+ *   }
+ * }
+ * *\/
+ * // example id: getinstanceshealthstatus-example-1590115176146
+ * ```
+ *
  */
 export declare class GetInstancesHealthStatusCommand extends $Command<GetInstancesHealthStatusCommandInput, GetInstancesHealthStatusCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: GetInstancesHealthStatusCommandInput;

package/dist-types/commands/GetNamespaceCommand.d.ts

@@ -29,6 +29,36 @@ export interface GetNamespaceCommandOutput extends GetNamespaceResponse, __Metad
  * @see {@link GetNamespaceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example GetNamespace example
+ * ```javascript
+ * // This example gets information about a specified namespace.
+ * const input = {
+ *   "Id": "ns-e4anhexample0004"
+ * };
+ * const command = new GetNamespaceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Namespace": {
+ *     "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e1tpmexample0001",
+ *     "CreateDate": "20181118T211712Z",
+ *     "CreatorRequestId": "example-creator-request-id-0001",
+ *     "Description": "Example.com AWS Cloud Map HTTP Namespace",
+ *     "Id": "ns-e1tpmexample0001",
+ *     "Name": "example-http.com",
+ *     "Properties": {
+ *       "DnsProperties": {},
+ *       "HttpProperties": {
+ *         "HttpName": "example-http.com"
+ *       }
+ *     },
+ *     "Type": "HTTP"
+ *   }
+ * }
+ * *\/
+ * // example id: getnamespace-example-1590115383708
+ * ```
+ *
  */
 export declare class GetNamespaceCommand extends $Command<GetNamespaceCommandInput, GetNamespaceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: GetNamespaceCommandInput;

package/dist-types/commands/GetOperationCommand.d.ts

@@ -33,6 +33,31 @@ export interface GetOperationCommandOutput extends GetOperationResponse, __Metad
  * @see {@link GetOperationCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: Get operation result
+ * ```javascript
+ * // Example: Get operation result
+ * const input = {
+ *   "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
+ * };
+ * const command = new GetOperationCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Operation": {
+ *     "CreateDate": 1587055860.121,
+ *     "Id": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd",
+ *     "Status": "SUCCESS",
+ *     "Targets": {
+ *       "NAMESPACE": "ns-ylexjili4cdxy3xm"
+ *     },
+ *     "Type": "CREATE_NAMESPACE",
+ *     "UpdateDate": 1587055900.469
+ *   }
+ * }
+ * *\/
+ * // example id: example-get-operation-result-1587073807124
+ * ```
+ *
  */
 export declare class GetOperationCommand extends $Command<GetOperationCommandInput, GetOperationCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: GetOperationCommandInput;

package/dist-types/commands/GetServiceCommand.d.ts

@@ -29,6 +29,35 @@ export interface GetServiceCommandOutput extends GetServiceResponse, __MetadataB
  * @see {@link GetServiceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example GetService Example
+ * ```javascript
+ * // This example gets the settings for a specified service.
+ * const input = {
+ *   "Id": "srv-e4anhexample0004"
+ * };
+ * const command = new GetServiceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Service": {
+ *     "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-e4anhexample0004",
+ *     "CreateDate": "20181118T211707Z",
+ *     "CreatorRequestId": "example-creator-request-id-0004",
+ *     "Description": "Example.com AWS Cloud Map HTTP Service",
+ *     "HealthCheckConfig": {
+ *       "FailureThreshold": 3,
+ *       "ResourcePath": "/",
+ *       "Type": "HTTPS"
+ *     },
+ *     "Id": "srv-e4anhexample0004",
+ *     "Name": "example-http-service",
+ *     "NamespaceId": "ns-e4anhexample0004"
+ *   }
+ * }
+ * *\/
+ * // example id: getservice-example-1590117234294
+ * ```
+ *
  */
 export declare class GetServiceCommand extends $Command<GetServiceCommandInput, GetServiceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: GetServiceCommandInput;

package/dist-types/commands/ListInstancesCommand.d.ts

@@ -30,6 +30,30 @@ export interface ListInstancesCommandOutput extends ListInstancesResponse, __Met
  * @see {@link ListInstancesCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: List service instances
+ * ```javascript
+ * // Example: List service instances
+ * const input = {
+ *   "ServiceId": "srv-qzpwvt2tfqcegapy"
+ * };
+ * const command = new ListInstancesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Instances": [
+ *     {
+ *       "Attributes": {
+ *         "AWS_INSTANCE_IPV4": "172.2.1.3",
+ *         "AWS_INSTANCE_PORT": "808"
+ *       },
+ *       "Id": "i-06bdabbae60f65a4e"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-list-service-instances-1587236237008
+ * ```
+ *
  */
 export declare class ListInstancesCommand extends $Command<ListInstancesCommandInput, ListInstancesCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: ListInstancesCommandInput;

package/dist-types/commands/ListNamespacesCommand.d.ts

@@ -29,6 +29,65 @@ export interface ListNamespacesCommandOutput extends ListNamespacesResponse, __M
  * @see {@link ListNamespacesCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: List namespaces
+ * ```javascript
+ * // Example: List namespaces
+ * const input = {};
+ * const command = new ListNamespacesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Namespaces": [
+ *     {
+ *       "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-a3ccy2e7e3a7rile",
+ *       "CreateDate": 1585354387.357,
+ *       "Id": "ns-a3ccy2e7e3a7rile",
+ *       "Name": "local",
+ *       "Properties": {
+ *         "DnsProperties": {
+ *           "HostedZoneId": "Z06752353VBUDTC32S84S"
+ *         },
+ *         "HttpProperties": {
+ *           "HttpName": "local"
+ *         }
+ *       },
+ *       "Type": "DNS_PRIVATE"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-pocfyjtrsmwtvcxx",
+ *       "CreateDate": 1586468974.698,
+ *       "Description": "My second namespace",
+ *       "Id": "ns-pocfyjtrsmwtvcxx",
+ *       "Name": "My-second-namespace",
+ *       "Properties": {
+ *         "DnsProperties": {},
+ *         "HttpProperties": {
+ *           "HttpName": "My-second-namespace"
+ *         }
+ *       },
+ *       "Type": "HTTP"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-ylexjili4cdxy3xm",
+ *       "CreateDate": 1587055896.798,
+ *       "Id": "ns-ylexjili4cdxy3xm",
+ *       "Name": "example.com",
+ *       "Properties": {
+ *         "DnsProperties": {
+ *           "HostedZoneId": "Z09983722P0QME1B3KC8I"
+ *         },
+ *         "HttpProperties": {
+ *           "HttpName": "example.com"
+ *         }
+ *       },
+ *       "Type": "DNS_PRIVATE"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-list-namespaces-1587401553154
+ * ```
+ *
  */
 export declare class ListNamespacesCommand extends $Command<ListNamespacesCommandInput, ListNamespacesCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: ListNamespacesCommandInput;

package/dist-types/commands/ListOperationsCommand.d.ts

@@ -29,6 +29,44 @@ export interface ListOperationsCommandOutput extends ListOperationsResponse, __M
  * @see {@link ListOperationsCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example ListOperations Example
+ * ```javascript
+ * // This example gets the operations that have a STATUS of either PENDING or SUCCESS.
+ * const input = {
+ *   "Filters": [
+ *     {
+ *       "Condition": "IN",
+ *       "Name": "STATUS",
+ *       "Values": [
+ *         "PENDING",
+ *         "SUCCESS"
+ *       ]
+ *     }
+ *   ]
+ * };
+ * const command = new ListOperationsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Operations": [
+ *     {
+ *       "Id": "76yy8ovhpdz0plmjzbsnqgnrqvpv2qdt-kexample",
+ *       "Status": "SUCCESS"
+ *     },
+ *     {
+ *       "Id": "prysnyzpji3u2ciy45nke83x2zanl7yk-dexample",
+ *       "Status": "SUCCESS"
+ *     },
+ *     {
+ *       "Id": "ko4ekftir7kzlbechsh7xvcdgcpk66gh-7example",
+ *       "Status": "PENDING"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: listoperations-example-1590117354396
+ * ```
+ *
  */
 export declare class ListOperationsCommand extends $Command<ListOperationsCommandInput, ListOperationsCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: ListOperationsCommandInput;

package/dist-types/commands/ListServicesCommand.d.ts

@@ -30,6 +30,36 @@ export interface ListServicesCommandOutput extends ListServicesResponse, __Metad
  * @see {@link ListServicesCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: List services
+ * ```javascript
+ * // Example: List services
+ * const input = {};
+ * const command = new ListServicesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Services": [
+ *     {
+ *       "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita",
+ *       "CreateDate": 1587081768.334,
+ *       "DnsConfig": {
+ *         "DnsRecords": [
+ *           {
+ *             "TTL": 60,
+ *             "Type": "A"
+ *           }
+ *         ],
+ *         "RoutingPolicy": "MULTIVALUE"
+ *       },
+ *       "Id": "srv-p5zdwlg5uvvzjita",
+ *       "Name": "myservice"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-list-services-1587236889840
+ * ```
+ *
  */
 export declare class ListServicesCommand extends $Command<ListServicesCommandInput, ListServicesCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: ListServicesCommandInput;

package/dist-types/commands/ListTagsForResourceCommand.d.ts

@@ -29,6 +29,31 @@ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceRes
  * @see {@link ListTagsForResourceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example ListTagsForResource example
+ * ```javascript
+ * // This example lists the tags of a resource.
+ * const input = {
+ *   "ResourceARN": "arn:aws:servicediscovery:us-east-1:123456789012:namespace/ns-ylexjili4cdxy3xm"
+ * };
+ * const command = new ListTagsForResourceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Tags": [
+ *     {
+ *       "Key": "Project",
+ *       "Value": "Zeta"
+ *     },
+ *     {
+ *       "Key": "Department",
+ *       "Value": "Engineering"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: listtagsforresource-example-1590093928416
+ * ```
+ *
  */
 export declare class ListTagsForResourceCommand extends $Command<ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: ListTagsForResourceCommandInput;

package/dist-types/commands/RegisterInstanceCommand.d.ts

@@ -72,6 +72,28 @@ export interface RegisterInstanceCommandOutput extends RegisterInstanceResponse,
  * @see {@link RegisterInstanceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example Example: Register Instance
+ * ```javascript
+ * // Example: Register Instance
+ * const input = {
+ *   "Attributes": {
+ *     "AWS_INSTANCE_IPV4": "172.2.1.3",
+ *     "AWS_INSTANCE_PORT": "808"
+ *   },
+ *   "CreatorRequestId": "7a48a98a-72e6-4849-bfa7-1a458e030d7b",
+ *   "InstanceId": "myservice-53",
+ *   "ServiceId": "srv-p5zdwlg5uvvzjita"
+ * };
+ * const command = new RegisterInstanceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7"
+ * }
+ * *\/
+ * // example id: example-register-instance-1587236116314
+ * ```
+ *
  */
 export declare class RegisterInstanceCommand extends $Command<RegisterInstanceCommandInput, RegisterInstanceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: RegisterInstanceCommandInput;

package/dist-types/commands/TagResourceCommand.d.ts

@@ -29,6 +29,27 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
  * @see {@link TagResourceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example TagResource example
+ * ```javascript
+ * // This example adds "Department" and "Project" tags to a resource.
+ * const input = {
+ *   "ResourceARN": "arn:aws:servicediscovery:us-east-1:123456789012:namespace/ns-ylexjili4cdxy3xm",
+ *   "Tags": [
+ *     {
+ *       "Key": "Department",
+ *       "Value": "Engineering"
+ *     },
+ *     {
+ *       "Key": "Project",
+ *       "Value": "Zeta"
+ *     }
+ *   ]
+ * };
+ * const command = new TagResourceCommand(input);
+ * await client.send(command);
+ * // example id: tagresource-example-1590093532240
+ * ```
+ *
  */
 export declare class TagResourceCommand extends $Command<TagResourceCommandInput, TagResourceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: TagResourceCommandInput;

package/dist-types/commands/UntagResourceCommand.d.ts

@@ -29,6 +29,21 @@ export interface UntagResourceCommandOutput extends UntagResourceResponse, __Met
  * @see {@link UntagResourceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example UntagResource example
+ * ```javascript
+ * // This example removes the "Department" and "Project" tags from a resource.
+ * const input = {
+ *   "ResourceARN": "arn:aws:servicediscovery:us-east-1:123456789012:namespace/ns-ylexjili4cdxy3xm",
+ *   "TagKeys": [
+ *     "Project",
+ *     "Department"
+ *   ]
+ * };
+ * const command = new UntagResourceCommand(input);
+ * await client.send(command);
+ * // example id: untagresource-example-1590094024672
+ * ```
+ *
  */
 export declare class UntagResourceCommand extends $Command<UntagResourceCommandInput, UntagResourceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: UntagResourceCommandInput;

package/dist-types/commands/UpdateInstanceCustomHealthStatusCommand.d.ts

@@ -35,6 +35,19 @@ export interface UpdateInstanceCustomHealthStatusCommandOutput extends __Metadat
  * @see {@link UpdateInstanceCustomHealthStatusCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example UpdateInstanceCustomHealthStatus Example
+ * ```javascript
+ * // This example submits a request to change the health status of an instance associated with a service with a custom health check to HEALTHY.
+ * const input = {
+ *   "InstanceId": "i-abcd1234",
+ *   "ServiceId": "srv-e4anhexample0004",
+ *   "Status": "HEALTHY"
+ * };
+ * const command = new UpdateInstanceCustomHealthStatusCommand(input);
+ * await client.send(command);
+ * // example id: updateinstancecustomhealthstatus-example-1590118408574
+ * ```
+ *
  */
 export declare class UpdateInstanceCustomHealthStatusCommand extends $Command<UpdateInstanceCustomHealthStatusCommandInput, UpdateInstanceCustomHealthStatusCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: UpdateInstanceCustomHealthStatusCommandInput;

package/dist-types/commands/UpdateServiceCommand.d.ts

@@ -55,6 +55,37 @@ export interface UpdateServiceCommandOutput extends UpdateServiceResponse, __Met
  * @see {@link UpdateServiceCommandOutput} for command's `response` shape.
  * @see {@link ServiceDiscoveryClientResolvedConfig | config} for ServiceDiscoveryClient's `config` shape.
  *
+ * @example UpdateService Example
+ * ```javascript
+ * // This example submits a request to replace the DnsConfig and HealthCheckConfig settings of a specified service.
+ * const input = {
+ *   "Id": "srv-e4anhexample0004",
+ *   "Service": {
+ *     "DnsConfig": {
+ *       "DnsRecords": [
+ *         {
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       ]
+ *     },
+ *     "HealthCheckConfig": {
+ *       "FailureThreshold": 2,
+ *       "ResourcePath": "/",
+ *       "Type": "HTTP"
+ *     }
+ *   }
+ * };
+ * const command = new UpdateServiceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OperationId": "m35hsdrkxwjffm3xef4bxyy6vc3ewakx-jdn3y5g5"
+ * }
+ * *\/
+ * // example id: updateservice-example-1590117830880
+ * ```
+ *
  */
 export declare class UpdateServiceCommand extends $Command<UpdateServiceCommandInput, UpdateServiceCommandOutput, ServiceDiscoveryClientResolvedConfig> {
     readonly input: UpdateServiceCommandInput;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-servicediscovery",
   "description": "AWS SDK for JavaScript Servicediscovery Client for Node.js, Browser and React Native",
-  "version": "3.288.0",
+  "version": "3.289.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -20,37 +20,37 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.288.0",
-    "@aws-sdk/config-resolver": "3.287.0",
-    "@aws-sdk/credential-provider-node": "3.288.0",
-    "@aws-sdk/fetch-http-handler": "3.282.0",
-    "@aws-sdk/hash-node": "3.272.0",
-    "@aws-sdk/invalid-dependency": "3.272.0",
-    "@aws-sdk/middleware-content-length": "3.282.0",
-    "@aws-sdk/middleware-endpoint": "3.282.0",
-    "@aws-sdk/middleware-host-header": "3.282.0",
-    "@aws-sdk/middleware-logger": "3.288.0",
-    "@aws-sdk/middleware-recursion-detection": "3.282.0",
-    "@aws-sdk/middleware-retry": "3.287.0",
-    "@aws-sdk/middleware-serde": "3.272.0",
-    "@aws-sdk/middleware-signing": "3.282.0",
-    "@aws-sdk/middleware-stack": "3.272.0",
-    "@aws-sdk/middleware-user-agent": "3.282.0",
-    "@aws-sdk/node-config-provider": "3.287.0",
-    "@aws-sdk/node-http-handler": "3.282.0",
-    "@aws-sdk/protocol-http": "3.282.0",
-    "@aws-sdk/smithy-client": "3.279.0",
-    "@aws-sdk/types": "3.272.0",
-    "@aws-sdk/url-parser": "3.272.0",
+    "@aws-sdk/client-sts": "3.289.0",
+    "@aws-sdk/config-resolver": "3.289.0",
+    "@aws-sdk/credential-provider-node": "3.289.0",
+    "@aws-sdk/fetch-http-handler": "3.289.0",
+    "@aws-sdk/hash-node": "3.289.0",
+    "@aws-sdk/invalid-dependency": "3.289.0",
+    "@aws-sdk/middleware-content-length": "3.289.0",
+    "@aws-sdk/middleware-endpoint": "3.289.0",
+    "@aws-sdk/middleware-host-header": "3.289.0",
+    "@aws-sdk/middleware-logger": "3.289.0",
+    "@aws-sdk/middleware-recursion-detection": "3.289.0",
+    "@aws-sdk/middleware-retry": "3.289.0",
+    "@aws-sdk/middleware-serde": "3.289.0",
+    "@aws-sdk/middleware-signing": "3.289.0",
+    "@aws-sdk/middleware-stack": "3.289.0",
+    "@aws-sdk/middleware-user-agent": "3.289.0",
+    "@aws-sdk/node-config-provider": "3.289.0",
+    "@aws-sdk/node-http-handler": "3.289.0",
+    "@aws-sdk/protocol-http": "3.289.0",
+    "@aws-sdk/smithy-client": "3.289.0",
+    "@aws-sdk/types": "3.289.0",
+    "@aws-sdk/url-parser": "3.289.0",
     "@aws-sdk/util-base64": "3.208.0",
     "@aws-sdk/util-body-length-browser": "3.188.0",
     "@aws-sdk/util-body-length-node": "3.208.0",
-    "@aws-sdk/util-defaults-mode-browser": "3.279.0",
-    "@aws-sdk/util-defaults-mode-node": "3.287.0",
-    "@aws-sdk/util-endpoints": "3.272.0",
-    "@aws-sdk/util-retry": "3.272.0",
-    "@aws-sdk/util-user-agent-browser": "3.282.0",
-    "@aws-sdk/util-user-agent-node": "3.287.0",
+    "@aws-sdk/util-defaults-mode-browser": "3.289.0",
+    "@aws-sdk/util-defaults-mode-node": "3.289.0",
+    "@aws-sdk/util-endpoints": "3.289.0",
+    "@aws-sdk/util-retry": "3.289.0",
+    "@aws-sdk/util-user-agent-browser": "3.289.0",
+    "@aws-sdk/util-user-agent-node": "3.289.0",
     "@aws-sdk/util-utf8": "3.254.0",
     "tslib": "^2.3.1",
     "uuid": "^8.3.2"