@aws-sdk/client-servicediscovery 3.873.0 → 3.876.0

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

@@ -198,6 +198,7 @@ declare const CreateServiceCommand_base: {
  *   Service: {
  *     Arn: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita",
  *     CreateDate: 1.587081768334E9,
+ *     CreatedByAccount: "123456789012",
  *     CreatorRequestId: "567c1193-6b00-4308-bd57-ad38a8822d25",
  *     DnsConfig: {
  *       DnsRecords: [
@@ -210,8 +211,59 @@ declare const CreateServiceCommand_base: {
  *       RoutingPolicy: "MULTIVALUE"
  *     },
  *     Id: "srv-p5zdwlg5uvvzjita",
+ *     InstanceCount: 0,
  *     Name: "myservice",
- *     NamespaceId: "ns-ylexjili4cdxy3xm"
+ *     NamespaceId: "ns-ylexjili4cdxy3xm",
+ *     ResourceOwner: "123456789012",
+ *     Type: "DNS_HTTP"
+ *   }
+ * }
+ * *\/
+ * ```
+ *
+ * @example Create service using namespace ARN
+ * ```javascript
+ * // Namespace sharee creates a service using a namespace ARN instead of namespace ID, useful when working with shared namespaces.
+ * const input = {
+ *   Description: "Example service using namespace ARN",
+ *   DnsConfig: {
+ *     DnsRecords: [
+ *       {
+ *         TTL: 300,
+ *         Type: "A"
+ *       }
+ *     ],
+ *     RoutingPolicy: "MULTIVALUE"
+ *   },
+ *   Name: "example-service",
+ *   NamespaceId: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678"
+ * };
+ * const command = new CreateServiceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   Service: {
+ *     Arn: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
+ *     CreateDate: 1.7051616E9,
+ *     CreatedByAccount: "111122223333",
+ *     CreatorRequestId: "abcd1234-xmpl-5678-9012-abcd1234xmpl",
+ *     Description: "Example service using namespace ARN",
+ *     DnsConfig: {
+ *       DnsRecords: [
+ *         {
+ *           TTL: 300,
+ *           Type: "A"
+ *         }
+ *       ],
+ *       NamespaceId: "ns-abcd1234xmpl5678",
+ *       RoutingPolicy: "MULTIVALUE"
+ *     },
+ *     Id: "srv-abcd1234xmpl5678",
+ *     InstanceCount: 0,
+ *     Name: "example-service",
+ *     NamespaceId: "ns-abcd1234xmpl5678",
+ *     ResourceOwner: "123456789012",
+ *     Type: "DNS_HTTP"
  *   }
  * }
  * *\/

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

@@ -81,7 +81,22 @@ declare const DeleteNamespaceCommand_base: {
  * const response = await client.send(command);
  * /* response is
  * {
- *   OperationId: "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk"
+ *   OperationId: "abcd1234-xmpl-5678-9012-abcd1234xmplabcd"
+ * }
+ * *\/
+ * ```
+ *
+ * @example Delete namespace using namespace ARN
+ * ```javascript
+ * // Deletes a namespace using a namespace ARN instead of namespace ID, useful when working with shared namespaces.
+ * const input = {
+ *   Id: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678"
+ * };
+ * const command = new DeleteNamespaceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   OperationId: "abcd1234-xmpl-5678-9012-abcd1234xmplabcd"
  * }
  * *\/
  * ```

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

@@ -80,6 +80,22 @@ declare const DeleteServiceAttributesCommand_base: {
  * *\/
  * ```
  *
+ * @example Delete service attributes using service ARN
+ * ```javascript
+ * // Deletes service attributes using a service ARN instead of service ID, useful for cross-account scenarios or when working with shared namespaces.
+ * const input = {
+ *   Attributes: [
+ *     "Port"
+ *   ],
+ *   ServiceId: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678"
+ * };
+ * const command = new DeleteServiceAttributesCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * { /* empty *\/ }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class DeleteServiceAttributesCommand extends DeleteServiceAttributesCommand_base {

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

@@ -79,6 +79,19 @@ declare const DeleteServiceCommand_base: {
  * *\/
  * ```
  *
+ * @example Delete service using service ARN
+ * ```javascript
+ * // Deletes a service using a service ARN instead of service ID, useful when working with shared namespaces.
+ * const input = {
+ *   Id: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678"
+ * };
+ * const command = new DeleteServiceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * { /* empty *\/ }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class DeleteServiceCommand extends DeleteServiceCommand_base {

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

@@ -92,6 +92,22 @@ declare const DeregisterInstanceCommand_base: {
  * *\/
  * ```
  *
+ * @example Deregister instance using service ARN
+ * ```javascript
+ * // Deregisters an instance using a service ARN instead of service ID, useful when working with shared namespaces.
+ * const input = {
+ *   InstanceId: "i-abcd1234xmpl5678",
+ *   ServiceId: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678"
+ * };
+ * const command = new DeregisterInstanceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   OperationId: "abcd1234-xmpl-5678-9012-abcd1234xmpl"
+ * }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class DeregisterInstanceCommand extends DeregisterInstanceCommand_base {

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

@@ -96,6 +96,44 @@ declare const DiscoverInstancesCommand_base: {
  * <p>Base exception class for all service exceptions from ServiceDiscovery service.</p>
  *
  *
+ * @example Discover instances using owner account
+ * ```javascript
+ * // Discovers instances in a shared namespace by specifying the OwnerAccount parameter, useful when working with shared namespaces.
+ * const input = {
+ *   NamespaceName: "example-shared-namespace",
+ *   OwnerAccount: "123456789012",
+ *   ServiceName: "shared-namespace-service"
+ * };
+ * const command = new DiscoverInstancesCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   Instances: [
+ *     {
+ *       Attributes: {
+ *         AWS_INSTANCE_IPV4: "192.0.2.44",
+ *         AWS_INSTANCE_PORT: "80"
+ *       },
+ *       HealthStatus: "HEALTHY",
+ *       InstanceId: "i-abcd1234xmpl5678",
+ *       NamespaceName: "example-shared-namespace",
+ *       ServiceName: "shared-service"
+ *     },
+ *     {
+ *       Attributes: {
+ *         AWS_INSTANCE_IPV4: "192.0.2.45",
+ *         AWS_INSTANCE_PORT: "80"
+ *       },
+ *       HealthStatus: "HEALTHY",
+ *       InstanceId: "i-efgh5678xmpl9012",
+ *       NamespaceName: "example-shared-namespace",
+ *       ServiceName: "shared-service"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * ```
+ *
  * @example Example: Discover registered instances
  * ```javascript
  * // Example: Discover registered instances

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

@@ -73,6 +73,23 @@ declare const DiscoverInstancesRevisionCommand_base: {
  * <p>Base exception class for all service exceptions from ServiceDiscovery service.</p>
  *
  *
+ * @example Discover instances revision using owner account
+ * ```javascript
+ * // Discovers the instances revision in a shared namespace by specifying the OwnerAccount parameter, useful when working with shared namespaces.
+ * const input = {
+ *   NamespaceName: "example-shared-namespace",
+ *   OwnerAccount: "123456789012",
+ *   ServiceName: "shared-service"
+ * };
+ * const command = new DiscoverInstancesRevisionCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   InstancesRevision: 1001
+ * }
+ * *\/
+ * ```
+ *
  * @example To discover the revision for a registered instance
  * ```javascript
  * // The following example discovers the revision ID for a registered instance.

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

@@ -95,8 +95,37 @@ declare const GetInstanceCommand_base: {
  *       region: "us-west-2",
  *       stage: "beta"
  *     },
+ *     CreatedByAccount: "123456789012",
  *     Id: "i-abcd1234"
- *   }
+ *   },
+ *   ResourceOwner: "123456789012"
+ * }
+ * *\/
+ * ```
+ *
+ * @example Get instance details using service ARN for shared namespace
+ * ```javascript
+ * // This example gets information about an instance using a service ARN instead of service ID. This is useful for listing instances associated with shared namespaces.
+ * const input = {
+ *   InstanceId: "i-abcd1234",
+ *   ServiceId: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-e4anhexample0004"
+ * };
+ * const command = new GetInstanceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   Instance: {
+ *     Attributes: {
+ *       AWS_INSTANCE_IPV4: "192.0.2.44",
+ *       AWS_INSTANCE_PORT: "80",
+ *       color: "green",
+ *       region: "us-west-2",
+ *       stage: "beta"
+ *     },
+ *     CreatedByAccount: "111122223333",
+ *     Id: "i-abcd1234"
+ *   },
+ *   ResourceOwner: "123456789012"
  * }
  * *\/
  * ```

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

@@ -99,6 +99,24 @@ declare const GetInstancesHealthStatusCommand_base: {
  * *\/
  * ```
  *
+ * @example Get instances health status using service ARN for shared namespace
+ * ```javascript
+ * // This example gets the current health status of instances using a service ARN instead of service ID. This is useful for checking health status of instances associated with shared namespaces.
+ * const input = {
+ *   ServiceId: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-e4anhexample0004"
+ * };
+ * const command = new GetInstancesHealthStatusCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   Status: {
+ *     i-abcd1234: "HEALTHY",
+ *     i-abcd1235: "UNHEALTHY"
+ *   }
+ * }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class GetInstancesHealthStatusCommand extends GetInstancesHealthStatusCommand_base {

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

@@ -69,6 +69,27 @@ declare const GetServiceAttributesCommand_base: {
  * <p>Base exception class for all service exceptions from ServiceDiscovery service.</p>
  *
  *
+ * @example Get service attributes using service ARN
+ * ```javascript
+ * // Gets service attributes using a service ARN instead of service ID, useful when working with shared namespaces. Shows attributes for a service created by a sharee in a namespace owned by another account.
+ * const input = {
+ *   ServiceId: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678"
+ * };
+ * const command = new GetServiceAttributesCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   ServiceAttributes: {
+ *     Attributes: {
+ *       Port: "80"
+ *     },
+ *     ResourceOwner: "123456789012",
+ *     ServiceArn: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678"
+ *   }
+ * }
+ * *\/
+ * ```
+ *
  * @example GetServiceAttributes Example
  * ```javascript
  * // This example gets the attributes for a specified service.
@@ -83,6 +104,7 @@ declare const GetServiceAttributesCommand_base: {
  *     Attributes: {
  *       port: "80"
  *     },
+ *     ResourceOwner: "123456789012",
  *     ServiceArn: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-e4anhexample0004"
  *   }
  * }

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

@@ -93,6 +93,43 @@ declare const GetServiceCommand_base: {
  * <p>Base exception class for all service exceptions from ServiceDiscovery service.</p>
  *
  *
+ * @example Get service using service ARN
+ * ```javascript
+ * // Gets service settings using a service ARN instead of service ID, useful when working with shared namespaces. Shows a service created by a sharee (111122223333) in a namespace owned by another account (123456789012).
+ * const input = {
+ *   Id: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678"
+ * };
+ * const command = new GetServiceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   Service: {
+ *     Arn: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
+ *     CreateDate: 1.7051616E9,
+ *     CreatedByAccount: "111122223333",
+ *     CreatorRequestId: "abcd1234-xmpl-5678-9012-abcd1234xmpl",
+ *     Description: "Example service",
+ *     DnsConfig: {
+ *       DnsRecords: [
+ *         {
+ *           TTL: 300,
+ *           Type: "A"
+ *         }
+ *       ],
+ *       NamespaceId: "ns-abcd1234xmpl5678",
+ *       RoutingPolicy: "MULTIVALUE"
+ *     },
+ *     Id: "srv-abcd1234xmpl5678",
+ *     InstanceCount: 2,
+ *     Name: "example-service",
+ *     NamespaceId: "ns-abcd1234xmpl5678",
+ *     ResourceOwner: "123456789012",
+ *     Type: "DNS_HTTP"
+ *   }
+ * }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class GetServiceCommand extends GetServiceCommand_base {

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

@@ -99,6 +99,30 @@ declare const ListInstancesCommand_base: {
  * *\/
  * ```
  *
+ * @example List instances using service ARN for shared namespace
+ * ```javascript
+ * // This example lists instances using a service ARN instead of service ID. This is useful for listing instances associated with shared namespaces.
+ * const input = {
+ *   ServiceId: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-e4anhexample0004"
+ * };
+ * const command = new ListInstancesCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   Instances: [
+ *     {
+ *       Attributes: {
+ *         AWS_INSTANCE_IPV4: "192.0.2.44",
+ *         AWS_INSTANCE_PORT: "80"
+ *       },
+ *       Id: "i-abcd1234"
+ *     }
+ *   ],
+ *   ResourceOwner: "123456789012"
+ * }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class ListInstancesCommand extends ListInstancesCommand_base {

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

@@ -104,46 +104,106 @@ declare const ListNamespacesCommand_base: {
  *   Namespaces: [
  *     {
  *       Arn: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-a3ccy2e7e3a7rile",
- *       CreateDate: 1.585354387357E9,
+ *       CreateDate: 1.7051616E9,
  *       Id: "ns-a3ccy2e7e3a7rile",
  *       Name: "local",
  *       Properties: {
  *         DnsProperties: {
- *           HostedZoneId: "Z06752353VBUDTC32S84S"
+ *           HostedZoneId: "Z06752353VBUDTC32S84S",
+ *           SOA: {
+ *             TTL: 60
+ *           }
  *         },
  *         HttpProperties: {
  *           HttpName: "local"
  *         }
  *       },
+ *       ResourceOwner: "123456789012",
+ *       ServiceCount: 2,
  *       Type: "DNS_PRIVATE"
  *     },
  *     {
  *       Arn: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-pocfyjtrsmwtvcxx",
- *       CreateDate: 1.586468974698E9,
+ *       CreateDate: 1.7051616E9,
  *       Description: "My second namespace",
  *       Id: "ns-pocfyjtrsmwtvcxx",
  *       Name: "My-second-namespace",
  *       Properties: {
- *         DnsProperties:         { /* empty *\/ },
+ *         DnsProperties: {
+ *           SOA: {
+ *             TTL: 60
+ *           }
+ *         },
  *         HttpProperties: {
  *           HttpName: "My-second-namespace"
  *         }
  *       },
+ *       ResourceOwner: "123456789012",
+ *       ServiceCount: 1,
  *       Type: "HTTP"
  *     },
  *     {
  *       Arn: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-ylexjili4cdxy3xm",
- *       CreateDate: 1.587055896798E9,
+ *       CreateDate: 1.7051616E9,
  *       Id: "ns-ylexjili4cdxy3xm",
  *       Name: "example.com",
  *       Properties: {
  *         DnsProperties: {
- *           HostedZoneId: "Z09983722P0QME1B3KC8I"
+ *           HostedZoneId: "Z09983722P0QME1B3KC8I",
+ *           SOA: {
+ *             TTL: 60
+ *           }
  *         },
  *         HttpProperties: {
  *           HttpName: "example.com"
  *         }
  *       },
+ *       ResourceOwner: "123456789012",
+ *       ServiceCount: 3,
+ *       Type: "DNS_PRIVATE"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * ```
+ *
+ * @example List namespaces filtered by resource owner
+ * ```javascript
+ * // This example shows how to list namespaces that are shared with you from other AWS accounts using the RESOURCE_OWNER filter.
+ * const input = {
+ *   Filters: [
+ *     {
+ *       Name: "RESOURCE_OWNER",
+ *       Values: [
+ *         "OTHER_ACCOUNTS"
+ *       ]
+ *     }
+ *   ]
+ * };
+ * const command = new ListNamespacesCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   Namespaces: [
+ *     {
+ *       Arn: "arn:aws:servicediscovery:us-west-2:111122223333:namespace/ns-abcd1234xmpl5678",
+ *       CreateDate: 1.7051616E9,
+ *       Description: "Example private DNS namespace",
+ *       Id: "ns-abcd1234xmpl5678",
+ *       Name: "example-namespace",
+ *       Properties: {
+ *         DnsProperties: {
+ *           HostedZoneId: "Z1D633PJN98FT9",
+ *           SOA: {
+ *             TTL: 60
+ *           }
+ *         },
+ *         HttpProperties: {
+ *           HttpName: "example-namespace"
+ *         }
+ *       },
+ *       ResourceOwner: "111122223333",
+ *       ServiceCount: 2,
  *       Type: "DNS_PRIVATE"
  *     }
  *   ]

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

@@ -114,6 +114,7 @@ declare const ListServicesCommand_base: {
  *     {
  *       Arn: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita",
  *       CreateDate: 1.587081768334E9,
+ *       CreatedByAccount: "123456789012",
  *       DnsConfig: {
  *         DnsRecords: [
  *           {
@@ -124,7 +125,9 @@ declare const ListServicesCommand_base: {
  *         RoutingPolicy: "MULTIVALUE"
  *       },
  *       Id: "srv-p5zdwlg5uvvzjita",
- *       Name: "myservice"
+ *       Name: "myservice",
+ *       ResourceOwner: "123456789012",
+ *       Type: "DNS"
  *     }
  *   ]
  * }

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

@@ -143,6 +143,26 @@ declare const RegisterInstanceCommand_base: {
  * *\/
  * ```
  *
+ * @example Register instance using service ARN
+ * ```javascript
+ * // Registers an instance using a service ARN instead of service ID, useful when working with shared namespaces. Shows registering an instance to a service created by a sharee in a namespace owned by another account.
+ * const input = {
+ *   Attributes: {
+ *     AWS_INSTANCE_IPV4: "192.0.2.44",
+ *     AWS_INSTANCE_PORT: "80"
+ *   },
+ *   InstanceId: "i-abcd1234xmpl5678",
+ *   ServiceId: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678"
+ * };
+ * const command = new RegisterInstanceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   OperationId: "abcd1234-xmpl-5678-9012-abcd1234xmpl"
+ * }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class RegisterInstanceCommand extends RegisterInstanceCommand_base {

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

@@ -93,6 +93,24 @@ declare const UpdateHttpNamespaceCommand_base: {
  * *\/
  * ```
  *
+ * @example Update HTTP namespace using namespace ARN for shared namespace
+ * ```javascript
+ * // This example updates an HTTP namespace using a namespace ARN instead of namespace ID.
+ * const input = {
+ *   Id: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-vh4nbmexample",
+ *   Namespace: {
+ *     Description: "Updated description for shared HTTP namespace."
+ *   }
+ * };
+ * const command = new UpdateHttpNamespaceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   OperationId: "ft52xe2koxhoeormaceymagglsdjyvexample"
+ * }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class UpdateHttpNamespaceCommand extends UpdateHttpNamespaceCommand_base {

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

@@ -77,6 +77,21 @@ declare const UpdateInstanceCustomHealthStatusCommand_base: {
  * <p>Base exception class for all service exceptions from ServiceDiscovery service.</p>
  *
  *
+ * @example Update instance custom health status using service ARN
+ * ```javascript
+ * // Updates instance custom health status using a service ARN instead of service ID, useful when working with shared namespaces.
+ * const input = {
+ *   InstanceId: "i-abcd1234xmpl5678",
+ *   ServiceId: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
+ *   Status: "HEALTHY"
+ * };
+ * const command = new UpdateInstanceCustomHealthStatusCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * { /* empty *\/ }
+ * *\/
+ * ```
+ *
  * @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.

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

@@ -101,21 +101,20 @@ declare const UpdatePrivateDnsNamespaceCommand_base: {
  * *\/
  * ```
  *
- * @example To update a public DNS namespace
+ * @example Update private DNS namespace using namespace ARN for shared namespace
  * ```javascript
- * // The following example updates the description of a public DNS namespace.
+ * // This example updates a private DNS namespace using a namespace ARN instead of namespace ID.
  * const input = {
- *   Id: "ns-bk3aEXAMPLE",
+ *   Id: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-bk3aexample",
  *   Namespace: {
- *     Description: "The updated namespace description."
- *   },
- *   UpdaterRequestId: ""
+ *     Description: "Updated description for shared private DNS namespace."
+ *   }
  * };
  * const command = new UpdatePrivateDnsNamespaceCommand(input);
  * const response = await client.send(command);
  * /* response is
  * {
- *   OperationId: "ft52xe2koxhoeormaceymagglsdjEXAMPLE"
+ *   OperationId: "ft52xe2koxhoeormaceymagglsdjyvexample"
  * }
  * *\/
  * ```

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

@@ -81,6 +81,43 @@ declare const UpdatePublicDnsNamespaceCommand_base: {
  * <p>Base exception class for all service exceptions from ServiceDiscovery service.</p>
  *
  *
+ * @example To update a public DNS namespace
+ * ```javascript
+ * // The following example updates the description of a public DNS namespace.
+ * const input = {
+ *   Id: "ns-bk3aEXAMPLE",
+ *   Namespace: {
+ *     Description: "The updated namespace description."
+ *   },
+ *   UpdaterRequestId: ""
+ * };
+ * const command = new UpdatePublicDnsNamespaceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   OperationId: "ft52xe2koxhoeormaceymagglsdjEXAMPLE"
+ * }
+ * *\/
+ * ```
+ *
+ * @example Update public DNS namespace using namespace ARN for shared namespace
+ * ```javascript
+ * // This example updates a public DNS namespace using a namespace ARN instead of namespace ID.
+ * const input = {
+ *   Id: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-bk3aexample",
+ *   Namespace: {
+ *     Description: "Updated description for shared public DNS namespace."
+ *   }
+ * };
+ * const command = new UpdatePublicDnsNamespaceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   OperationId: "ft52xe2koxhoeormaceymagglsdjexample"
+ * }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class UpdatePublicDnsNamespaceCommand extends UpdatePublicDnsNamespaceCommand_base {

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

@@ -68,6 +68,23 @@ declare const UpdateServiceAttributesCommand_base: {
  * <p>Base exception class for all service exceptions from ServiceDiscovery service.</p>
  *
  *
+ * @example Update service attributes using service ARN
+ * ```javascript
+ * // Updates service attributes using a service ARN instead of service ID, useful when working with shared namespaces.
+ * const input = {
+ *   Attributes: {
+ *     Port: "8080",
+ *     Protocol: "HTTP"
+ *   },
+ *   ServiceId: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678"
+ * };
+ * const command = new UpdateServiceAttributesCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * { /* empty *\/ }
+ * *\/
+ * ```
+ *
  * @example UpdateServiceAttributes Example
  * ```javascript
  * // This example submits a request to update the specified service to add a port attribute with the value 80.

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

@@ -152,6 +152,24 @@ declare const UpdateServiceCommand_base: {
  * *\/
  * ```
  *
+ * @example Update service using service ARN for shared namespace
+ * ```javascript
+ * // This example updates a service using a service ARN instead of service ID. This is useful for updating services associated with shared namespaces.
+ * const input = {
+ *   Id: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-e4anhexample0004",
+ *   Service: {
+ *     Description: "Updated service description for shared namespace"
+ *   }
+ * };
+ * const command = new UpdateServiceCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   OperationId: "m35hsdrkxwjffm3xef4bxyy6vc3ewakx-jdn3y5g5"
+ * }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class UpdateServiceCommand extends UpdateServiceCommand_base {

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.873.0",
+  "version": "3.876.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-servicediscovery",
@@ -20,17 +20,17 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/core": "3.873.0",
-    "@aws-sdk/credential-provider-node": "3.873.0",
+    "@aws-sdk/core": "3.876.0",
+    "@aws-sdk/credential-provider-node": "3.876.0",
     "@aws-sdk/middleware-host-header": "3.873.0",
-    "@aws-sdk/middleware-logger": "3.873.0",
+    "@aws-sdk/middleware-logger": "3.876.0",
     "@aws-sdk/middleware-recursion-detection": "3.873.0",
-    "@aws-sdk/middleware-user-agent": "3.873.0",
+    "@aws-sdk/middleware-user-agent": "3.876.0",
     "@aws-sdk/region-config-resolver": "3.873.0",
     "@aws-sdk/types": "3.862.0",
     "@aws-sdk/util-endpoints": "3.873.0",
     "@aws-sdk/util-user-agent-browser": "3.873.0",
-    "@aws-sdk/util-user-agent-node": "3.873.0",
+    "@aws-sdk/util-user-agent-node": "3.876.0",
     "@smithy/config-resolver": "^4.1.5",
     "@smithy/core": "^3.8.0",
     "@smithy/fetch-http-handler": "^5.1.1",