ATTACHPRINCIPALPOLICY()`¶

About AttachPrincipalPolicy¶

Attaches the specified policy to the specified principal (certificate or other credential).

Note: This action is deprecated and works as expected for backward compatibility, but we won't add enhancements. Use AttachPolicy instead.

Requires permission to access the AttachPrincipalPolicy action.

Method Signature¶

METHODS /AWS1/IF_IOT~ATTACHPRINCIPALPOLICY
  IMPORTING
    !IV_POLICYNAME TYPE /AWS1/IOTPOLICYNAME OPTIONAL
    !IV_PRINCIPAL TYPE /AWS1/IOTPRINCIPAL OPTIONAL
  RAISING
    /AWS1/CX_IOTINTERNALFAILUREEX
    /AWS1/CX_IOTINVALIDREQUESTEX
    /AWS1/CX_IOTLIMITEXCEEDEDEX
    /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_policyname` `TYPE /AWS1/IOTPOLICYNAME` `/AWS1/IOTPOLICYNAME`¶

The policy name.

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

The principal, which can be a certificate ARN (as returned from the CreateCertificate operation) or an Amazon Cognito ID.

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.

lo_client->attachprincipalpolicy(
  iv_policyname = |string|
  iv_principal = |string|
).

/AWS1/IF_IOT=>ATTACHPRINCIPALPOLICY()¶