AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Detaches the specified principal from the specified thing. A principal can be X.509 certificates, IAM users, groups, and roles, Amazon Cognito identities or federated identities.

This call is asynchronous. It might take several seconds for the detachment to propagate.

Requires permission to access the DetachThingPrincipal action.

Note:

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

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

Syntax

C#
public abstract DetachThingPrincipalResponse DetachThingPrincipal(
         String thingName,
         String principal
)

Parameters

thingName
Type: System.String

The name of the thing.

principal
Type: System.String

If the principal is a certificate, this value must be ARN of the certificate. If the principal is an Amazon Cognito identity, this value must be the ID of the Amazon Cognito identity.

Return Value


The response from the DetachThingPrincipal service method, as returned by IoT.

Exceptions

ExceptionCondition
InternalFailureException An unexpected error has occurred.
InvalidRequestException The request is not valid.
ResourceNotFoundException The specified resource does not exist.
ServiceUnavailableException The service is temporarily unavailable.
ThrottlingException The rate exceeds the limit.
UnauthorizedException You are not authorized to perform this operation.

Version Information

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

See Also