All Products
Search
Document Center

Cloud Firewall:AddInstanceMembers

Last Updated:Jan 14, 2026

Adds member accounts to Cloud Firewall.

Operation description

You can call this operation to add member accounts to Cloud Firewall.

QPS limits

The queries per second (QPS) limit for a single user is 10 calls per second. If the number of calls per second exceeds the limit, throttling is triggered, which may affect your business. We recommend that you observe this limit when you call this operation.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

Members

array<object>

Yes

The member accounts of Cloud Firewall.

object

No

None

MemberDesc

string

No

The remarks of the member account. The remarks must be 1 to 256 characters in length. You can add up to 20 member accounts.

renewal

MemberUid

integer

Yes

The UID of the member account. You can add up to 20 member accounts.

258039427902****

Response elements

Element

Type

Description

Example

object

RequestId

string

The ID of the request.

B40A54DF-C142-44F7-8441-B31C1EADB36E

Examples

Success response

JSON format

{
  "RequestId": "B40A54DF-C142-44F7-8441-B31C1EADB36E"
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorParamsNotEnough Parameters are insufficient. Parameters are insufficient.
400 ErrorParamsInvalid Invalid Params The parameter is invalid.
400 ErrotMaxInstanceMemberNumExceed The maximum number of firewall instance members is exceeded. The maximum number of firewall instance members is exceeded.
400 ErrorDBSelect An error occurred while querying database. An error occurred while querying database.
400 ErrorInstanceTooManyMembersOnce too many members once. The number of members to be added or deleted at a time exceeds the limit.
400 ErrorDbFailed Query db failed. DB access error.
400 ErrorInstanceMemberAlreadyExist instance member is already exist. The member is already added to Cloud Firewall.
400 ErrorInstanceMemberIsMaster instance member is master account. A firewall is enabled for an asset of the member.
400 ErrorInstanceAliuidNotDaMa instance aliuid not DA or MA. The Alibaba Cloud account to which Cloud Firewall belongs is not specified as a delegated administrator account or management account.
400 ErrorDBInsert internal error: sql insert. Request error, database insert failed
400 ErrorInstanceMemberNotBelongRd instance member not belong rd. The member to be added does not belong to the resource directory.
400 ErrorInstanceMemberNotStsGrant instance member is not sts grant. The member of the Cloud Firewall instance to be added is not authorized.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.