Skip to content

Put Service Linked Configuration Recorder

configservice_put_service_linked_configuration_recorder R Documentation

Creates a service-linked configuration recorder that is linked to a specific Amazon Web Services service based on the ServicePrincipal you specify

Description

Creates a service-linked configuration recorder that is linked to a specific Amazon Web Services service based on the ServicePrincipal you specify.

The configuration recorder's name, recordingGroup, recordingMode, and recordingScope is set by the service that is linked to the configuration recorder.

For more information, see Working with the Configuration Recorder in the Config Developer Guide.

This API creates a service-linked role AWSServiceRoleForConfig in your account. The service-linked role is created only when the role does not exist in your account.

The recording scope determines if you receive configuration items

The recording scope is set by the service that is linked to the configuration recorder and determines whether you receive configuration items (CIs) in the delivery channel. If the recording scope is internal, you will not receive CIs in the delivery channel.

Tags are added at creation and cannot be updated with this operation

Use tag_resource and untag_resource to update tags after creation.

Usage

configservice_put_service_linked_configuration_recorder(
  ServicePrincipal, Tags)

Arguments

ServicePrincipal

[required] The service principal of the Amazon Web Services service for the service-linked configuration recorder that you want to create.

Tags

The tags for a service-linked configuration recorder. Each tag consists of a key and an optional value, both of which you define.

Value

A list with the following syntax: 

list(
  Arn = "string",
  Name = "string"
)

Request syntax

svc$put_service_linked_configuration_recorder(
  ServicePrincipal = "string",
  Tags = list(
    list(
      Key = "string",
      Value = "string"
    )
  )
)