調用CreateServiceLinkedRole創建服務關聯角色。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 CreateServiceLinkedRole

要執行的操作。取值：CreateServiceLinkedRole。

ServiceName String 是 polardb.aliyuncs.com

服務名稱。

具體信息，請參見支持服務關聯角色的云服務。

CustomSuffix String 否 Example

角色名稱后綴。

角色名稱（含后綴）的總長度為1~64個字符，可包含英文字母、數字、半角句號（.）和短劃線（-）。

例如：假設后綴為Example，則角色名稱為ServiceLinkedRoleName_Example，且最大長度不能超過64個字符。

Description String 否 Service Linked Role for PolarDB. PolarDB will use this role to access your resources in other services.

服務關聯角色描述。

只有允許自定義后綴的服務關聯角色才能填寫角色描述，否則，角色描述將使用預設值且不能修改。

長度為1~1024個字符。

關于公共請求參數的詳情，請參見公共參數。

返回數據

名稱 類型 示例值 描述
Role Object

角色信息。
AssumeRolePolicyDocument String {\"Statement\":[{\"Action\":\"sts:AssumeRole\",\"Effect\":\"Allow\",\"Principal\":{\"Service\":[\"polardb.aliyuncs.com\"]}}],\"Version\":\"1\"}

角色的信任策略內容。
RolePrincipalName String AliyunServiceRoleForPolarDB@role.test.onaliyunservice.com

帶域名后綴的角色名稱。
Description String Service Linked Role for PolarDB. PolarDB will use this role to access your resources in other services.

角色描述。
RoleName String AliyunServiceRoleForPolarDB

角色名稱。
CreateDate String 2020-06-30T08:14:16Z

角色創建時間（UTC時間）。
Arn String acs:ram::177242285274****:role/aliyunserviceroleforpolardb

角色的資源描述符。
RoleId String 32833240981067****

角色ID。
IsServiceLinkedRole Boolean true

是否為服務關聯角色。取值：

  • true：是服務關聯角色。
  • false：不是服務關聯角色。
RequestId String FE58D7CF-03BC-432A-B42D-BC3390C8C2E1

請求ID。

示例

請求示例

https://resourcemanager.aliyuncs.com/?Action=CreateServiceLinkedRole
&ServiceName=polardb.aliyuncs.com
&<公共請求參數>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateServiceLinkedRoleResponse>
    <Role>
        <RoleName>AliyunServiceRoleForPolarDB</RoleName>
        <Description>Service Linked Role for PolarDB. PolarDB will use this role to access your resources in other services.</Description>
        <AssumeRolePolicyDocument>{"Statement":[{"Action":"sts:AssumeRole","Effect":"Allow","Principal":{"Service":["polardb.aliyuncs.com"]}}],"Version":"1"}</AssumeRolePolicyDocument>
        <Arn>acs:ram::177242285274****:role/aliyunserviceroleforpolardb</Arn>
        <IsServiceLinkedRole>true</IsServiceLinkedRole>
        <CreateDate>2020-06-30T08:14:16Z</CreateDate>
        <RoleId>32833240981067****</RoleId>
        <RolePrincipalName>AliyunServiceRoleForPolarDB@role.test.onaliyunservice.com</RolePrincipalName>
    </Role>
    <RequestId>FE58D7CF-03BC-432A-B42D-BC3390C8C2E1</RequestId>
</CreateServiceLinkedRoleResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Role" : {
    "RoleName" : "AliyunServiceRoleForPolarDB",
    "Description" : "Service Linked Role for PolarDB. PolarDB will use this role to access your resources in other services.",
    "AssumeRolePolicyDocument" : "{\"Statement\":[{\"Action\":\"sts:AssumeRole\",\"Effect\":\"Allow\",\"Principal\":{\"Service\":[\"polardb.aliyuncs.com\"]}}],\"Version\":\"1\"}",
    "Arn" : "acs:ram::177242285274****:role/aliyunserviceroleforpolardb",
    "IsServiceLinkedRole" : true,
    "CreateDate" : "2020-06-30T08:14:16Z",
    "RoleId" : "32833240981067****",
    "RolePrincipalName" : "AliyunServiceRoleForPolarDB@role.test.onaliyunservice.com"
  },
  "RequestId" : "FE58D7CF-03BC-432A-B42D-BC3390C8C2E1"
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InvalidParameter.CustomSuffix.NotAllowed Custom suffix is not allowed for this Service Linked Role. 該服務關聯角色不支持自定義后綴。
400 InvalidParameter.CustomSuffix.InvalidChars The parameter CustomSuffix contains invalid characters. 參數CustomSuffix包含無效字符。
400 InvalidParameter.CustomSuffix.Length The maximum length of the parameter CustomSuffix is exceeded. 參數CustomSuffix長度超限。
400 InvalidParameter.Description.Length The maximum length of the description is exceeded. It must not exceed 1024 characters. 描述長度超限。最大不得超過1024個字符。
404 EntityNotExist.Service The service does not exist. 該服務不存在。
409 EntityAlreadyExists.Role The role already exists. 角色已存在。
409 LimitExceeded.Role The maximum number of roles is exceeded. 角色數量超出限制。

訪問錯誤中心查看更多錯誤碼。