IAmazonServiceDiscovery.DeregisterInstance Method (DeregisterInstanceRequest)

Deletes the Amazon Route 53 DNS records and health check, if any, that Cloud Map created for the specified instance.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to DeregisterInstanceAsync.

Namespace: Amazon.ServiceDiscovery
Assembly: AWSSDK.ServiceDiscovery.dll
Version: 3.x.y.z

Syntax

public abstract DeregisterInstanceResponse DeregisterInstance(
         DeregisterInstanceRequest request
)

Parameters

request: Type: Amazon.ServiceDiscovery.Model.DeregisterInstanceRequest

Container for the necessary parameters to execute the DeregisterInstance service method.

Return Value

Type: DeregisterInstanceResponse

The response from the DeregisterInstance service method, as returned by ServiceDiscovery.

Exceptions

Exception	Condition
DuplicateRequestException	The operation is already in progress.
InstanceNotFoundException	No instance exists with the specified ID, or the instance was recently registered, and information about the instance hasn't propagated yet.
InvalidInputException	One or more specified values aren't valid. For example, a required value might be missing, a numeric value might be outside the allowed range, or a string value might exceed length constraints.
ResourceInUseException	The specified resource can't be deleted because it contains other resources. For example, you can't delete a service that contains any instances.
ServiceNotFoundException	No service exists with the specified ID.

Examples

Example: Deregister a service instance


var client = new AmazonServiceDiscoveryClient();
var response = client.DeregisterInstance(new DeregisterInstanceRequest 
{
    InstanceId = "myservice-53",
    ServiceId = "srv-p5zdwlg5uvvzjita"
});

string operationId = response.OperationId;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

IAmazonServiceDiscovery.DeregisterInstance (DeregisterInstanceRequest)

Method