DETACHTHINGPRINCIPAL()`¶

About DetachThingPrincipal¶

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.

Method Signature¶

METHODS /AWS1/IF_IOT~DETACHTHINGPRINCIPAL
  IMPORTING
    !IV_THINGNAME TYPE /AWS1/IOTTHINGNAME OPTIONAL
    !IV_PRINCIPAL TYPE /AWS1/IOTPRINCIPAL OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_iotdetachthgprincrsp
  RAISING
    /AWS1/CX_IOTINTERNALFAILUREEX
    /AWS1/CX_IOTINVALIDREQUESTEX
    /AWS1/CX_IOTRESOURCENOTFOUNDEX
    /AWS1/CX_IOTSERVICEUNAVAILEX
    /AWS1/CX_IOTTHROTTLINGEX
    /AWS1/CX_IOTUNAUTHORIZEDEX
    /AWS1/CX_IOTCLIENTEXC
    /AWS1/CX_IOTSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_thingname` `TYPE /AWS1/IOTTHINGNAME` `/AWS1/IOTTHINGNAME`¶

The name of the thing.

`iv_principal` `TYPE /AWS1/IOTPRINCIPAL` `/AWS1/IOTPRINCIPAL`¶

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.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_iotdetachthgprincrsp` `/AWS1/CL_IOTDETACHTHGPRINCRSP`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->detachthingprincipal(
  iv_principal = |string|
  iv_thingname = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
ENDIF.

/AWS1/IF_IOT=>DETACHTHINGPRINCIPAL()¶