All Products
Search
Document Center

BSS OpenAPI:ModifyAccountRelation

Last Updated:Mar 01, 2024

Adds or removes permissions granted to a member in a financial relationship.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RelationTypestringNo

The type of the financial relationship. Set the value to enterprise_group.

enterprise_group
RelationOperationstringYes

The operation to be performed. Valid values:

  • ADD
  • DELETE
ADD
ParentUserIdlongNo

The ID of the Alibaba Cloud account that is used as the management account.

1738376485192612
ChildNickstringYes

The display name of the member. This helps clarify the scenario in which the account is used.

Display name of the member
ChildUserIdlongNo

The ID of the Alibaba Cloud account that is used as the member.

1512996702208737
RequestIdstringYes

The unique ID of the request. The ID is used to mark a request and troubleshoot a problem.

request_id
RoleCodesarrayNo

The roles that can be assigned to the member. You cannot modify the roles.

stringNo

The role that is assigned to the member.

trusteeship
PermissionCodesarrayNo

The permissions that can be modified. Valid values:

  • SYNCHRONIZE_FINANCE_IDENTITY: allows the credit control identity to be shared with the member.
  • SYNCHRONIZE_FINANCE_DISCOUNT_POLICY_TO_TARGET: allows the discount policy to be shared with the member.
  • FORBID_WITHDRAW_CASH: does not allow the member to withdraw the balance.
  • FORBID_MANAGE_INVOICE: does not allow the member to manage invoices.
  • CHECK_FINANCE_INFO: requests to view information about the financial relationship.
  • MANAGE_TARGET_INVOICE: allows the member to manage invoices.
  • CHECK_TARGET_CONSUMPTION: allows the member to view the bills.
stringNo

The permission that is granted.

SYNCHRONIZE_FINANCE_IDENTITY
RelationIdlongNo

The ID of the financial relationship. Set this parameter to the value of the relationId response parameter returned by calling the QueryRelationList operation.

51463

Response parameters

ParameterTypeDescriptionExample
object
Codestring

The status code returned.

200
Messagestring

The message returned.

Message returned
RequestIdstring

The unique ID of the request.

request_id
Successboolean

Indicates whether the request is successful.

true
Dataobject

The data returned.

HostIdstring

HostId

HostId

Examples

Sample success responses

JSONformat

{
  "Code": "200",
  "Message": "Message returned\n",
  "RequestId": "request_id",
  "Success": true,
  "Data": {
    "HostId": "HostId"
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2021-12-14The request parameters of the API has changedsee changesets
Change itemChange content
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: RelationId