Call the InitializeOperationRole to create a service linked role.

Note When using a collector to collect logs from different data sources or performing elastic cluster scaling tasks (for the China site), you must first grant permissions to create service linked roles.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request header

This operation uses only common request headers. For more information, see Common parameters.

Request structure

POST /openapi/user/slr HTTP/1.1

Request parameters

Parameter Type Position Required Example Description
ClientToken String Query No 5A2CFF0E-5718-45B5-9D4D-70B3FF****

This parameter is used to ensure the idempotence of the request. You can use the client to generate the value, but you must ensure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

RequestBody

Set the following parameters in RequestBody to specify the name of the service-linked role to be created.

Parameter

Type

Required

Example

Description

rolename

String

Yes

AliyunServiceRoleForElasticsearchCollector

The name of the service linked role. Valid values: AliyunServiceRoleForElasticsearchOps (the role used to perform the task of elastic scaling of the cluster, only applicable to the China site) and AliyunServiceRoleForElasticsearchCollector (creating and managing Beats collectors).

Response parameters

Parameter Type Example Description
RequestId String 29101430-4797-4D1D-96C3-9FCBCCA8F845

The ID of the request.
Result Boolean true

Indicates whether SQL audit was disabled for the DRDS database. Valid values:

  • true: The object is created.
  • false: creation failed

Examples

Sample requests

POST /openapi/user/slr HTTP/1.1 
common request header
{
  "rolename": "AliyunServiceRoleForElasticsearchCollector"
}

Sample success responses

JSON format 

{
    "Result": true,
    "RequestId": "29101430-4797-4D1D-96C3-9FCBCCA8F845"
}

Error codes

For a list of error codes, visit the API Error Center.