ConfirmRelation - BSS OpenAPI - Alibaba Cloud Documentation Center

Confirms the invitation initiated by the master account.

Operation description

1. A member needs to confirm an invitation only if a financial management relationship is established between the management account and the member and enterprise names used by the management account and the member for real-name verification are different. 2. The permissions to be confirmed must be the same as those granted to the member when the management account initiates the invitation.

Debugging

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

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
RelationType	string	Yes	The type of the financial relationship. Set the value to enterprise_group.	Type of the financial relationship
ParentUserId	long	Yes	The ID of the Alibaba Cloud account that is used as the management account.	1738376485192612
ConfirmCode	string	Yes	The operation to be performed to confirm the invitation. Valid values: child_agree: The member accepts the invitation. child_disagree: The member rejects the invitation. Canceled by the master account: The management account cancels the confirmation.	child_agree
ChildUserId	long	Yes	The ID of the Alibaba Cloud account that is used as the member.	1512996702208737
RequestId	string	Yes	The unique ID of the request.	request_id
PermissionCodes	array	Yes	The permissions that can be granted to the member. 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.
	string	Yes		SYNCHRONIZE_FINANCE_IDENTITY
RelationId	long	No	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

Parameter	Type	Description	Example
	object
Code	string	The status code returned.	200
Message	string	The message returned.	Message returned
RequestId	string	The unique ID of the request.	request_id
Success	boolean	Indicates whether the request is successful.	true
Data	object	The data returned.
HostId	string	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 time

Summary of changes

Operation

2021-12-14

The request parameters of the API has changed

see changesets

Change item	Change content
Input Parameters	The request parameters of the API has changed.
	Added Input Parameters: RelationId