UPDATECHANNEL()`¶

About UpdateChannel¶

Update the specified channel. You can edit if MediaPackage sends ingest or egress access logs to the CloudWatch log group, if content will be encrypted, the description on a channel, and your channel's policy settings. You can't edit the name of the channel or CloudFront distribution details.

Any edits you make that impact the video output may not be reflected for a few minutes.

Method Signature¶

METHODS /AWS1/IF_MD2~UPDATECHANNEL
  IMPORTING
    !IV_CHANNELGROUPNAME TYPE /AWS1/MD2RESOURCENAME OPTIONAL
    !IV_CHANNELNAME TYPE /AWS1/MD2RESOURCENAME OPTIONAL
    !IV_ETAG TYPE /AWS1/MD2ENTITYTAG OPTIONAL
    !IV_DESCRIPTION TYPE /AWS1/MD2RESOURCEDESCRIPTION OPTIONAL
    !IO_INPUTSWITCHCONFIGURATION TYPE REF TO /AWS1/CL_MD2INPUTSWITCHCONF OPTIONAL
    !IO_OUTPUTHEADERCONFIGURATION TYPE REF TO /AWS1/CL_MD2OUTPUTHEADERCONF OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_md2updatechannelrsp
  RAISING
    /AWS1/CX_MD2ACCESSDENIEDEX
    /AWS1/CX_MD2CONFLICTEXCEPTION
    /AWS1/CX_MD2INTERNALSERVEREX
    /AWS1/CX_MD2RESOURCENOTFOUNDEX
    /AWS1/CX_MD2THROTTLINGEX
    /AWS1/CX_MD2VALIDATIONEX
    /AWS1/CX_MD2CLIENTEXC
    /AWS1/CX_MD2SERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_channelgroupname` `TYPE /AWS1/MD2RESOURCENAME` `/AWS1/MD2RESOURCENAME`¶

The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.

`iv_channelname` `TYPE /AWS1/MD2RESOURCENAME` `/AWS1/MD2RESOURCENAME`¶

The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.

Optional arguments:¶

`iv_etag` `TYPE /AWS1/MD2ENTITYTAG` `/AWS1/MD2ENTITYTAG`¶

The expected current Entity Tag (ETag) for the resource. If the specified ETag does not match the resource's current entity tag, the update request will be rejected.

`iv_description` `TYPE /AWS1/MD2RESOURCEDESCRIPTION` `/AWS1/MD2RESOURCEDESCRIPTION`¶

Any descriptive information that you want to add to the channel for future identification purposes.

`io_inputswitchconfiguration` `TYPE REF TO /AWS1/CL_MD2INPUTSWITCHCONF` `/AWS1/CL_MD2INPUTSWITCHCONF`¶

The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.

`io_outputheaderconfiguration` `TYPE REF TO /AWS1/CL_MD2OUTPUTHEADERCONF` `/AWS1/CL_MD2OUTPUTHEADERCONF`¶

The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_md2updatechannelrsp` `/AWS1/CL_MD2UPDATECHANNELRSP`¶

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->updatechannel(
  io_inputswitchconfiguration = new /aws1/cl_md2inputswitchconf(
    iv_mqcsinputswitching = ABAP_TRUE
    iv_preferredinput = 123
  )
  io_outputheaderconfiguration = new /aws1/cl_md2outputheaderconf( ABAP_TRUE )
  iv_channelgroupname = |string|
  iv_channelname = |string|
  iv_description = |string|
  iv_etag = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_string = lo_result->get_arn( ).
  lv_string = lo_result->get_channelname( ).
  lv_string = lo_result->get_channelgroupname( ).
  lv_timestamp = lo_result->get_createdat( ).
  lv_timestamp = lo_result->get_modifiedat( ).
  lv_resourcedescription = lo_result->get_description( ).
  LOOP AT lo_result->get_ingestendpoints( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_string = lo_row_1->get_id( ).
      lv_string = lo_row_1->get_url( ).
    ENDIF.
  ENDLOOP.
  lv_inputtype = lo_result->get_inputtype( ).
  lv_entitytag = lo_result->get_etag( ).
  LOOP AT lo_result->get_tags( ) into ls_row_2.
    lv_key = ls_row_2-key.
    lo_value = ls_row_2-value.
    IF lo_value IS NOT INITIAL.
      lv_tagvalue = lo_value->get_value( ).
    ENDIF.
  ENDLOOP.
  lo_inputswitchconfiguratio = lo_result->get_inputswitchconfiguration( ).
  IF lo_inputswitchconfiguratio IS NOT INITIAL.
    lv_boolean = lo_inputswitchconfiguratio->get_mqcsinputswitching( ).
    lv_integer = lo_inputswitchconfiguratio->get_preferredinput( ).
  ENDIF.
  lo_outputheaderconfigurati = lo_result->get_outputheaderconf( ).
  IF lo_outputheaderconfigurati IS NOT INITIAL.
    lv_boolean = lo_outputheaderconfigurati->get_publishmqcs( ).
  ENDIF.
ENDIF.

Updating a Channel¶

Updating a Channel

DATA(lo_result) = lo_client->updatechannel(
  iv_channelgroupname = |exampleChannelGroup|
  iv_channelname = |exampleChannel|
  iv_description = |Updated description for exampleChannel|
).

/AWS1/IF_MD2=>UPDATECHANNEL()¶