Authorize Serverless Assets via ModifyServerlessAuthToMachine API - Security Center - Alibaba Cloud - Security Center

Manages Serverless asset authorization.

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

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

yundun-sas:ModifyServerlessAuthToMachine

update

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
BindUuidList	array	No	The list of asset UUIDs to bind.
	string	No	The UUID of the asset to bind.	96a005f3-051a698
UnBindUuidList	array	No	The list of asset UUIDs to unbind.
	string	No	The UUID of the asset to unbind.	96a005f3-051a698
Criteria	string	No	The search conditions for assets. This parameter is in JSON format. Pay attention to letter case when you specify this parameter. Note You can search for assets by instance ID, instance name, VPC ID, region, public IP address, and other conditions. Call the DescribeCriteria operation to query the supported search conditions.	[{"name":"vulStatus","value":"YES","logicalExp":"AND"}]
LogicalExp	string	No	The logical relationship among multiple search conditions. Valid values: OR: Multiple conditions are evaluated using a logical OR. AND: Multiple conditions are evaluated using a logical AND.	OR
BindAll	boolean	No	Specifies whether to bind all assets. Default value: false. Valid values: true: Bind all assets. false: Do not bind all assets.	false
AutoBind	integer	No	Specifies whether to enable automatic binding. Valid values: 0: Disable automatic binding. 1: Enable automatic binding.	1
PreBindOrderId	integer	No	The pre-binding order ID.	233016**0482
PreBind	integer	No	Specifies whether to perform a pre-binding operation. Valid values: 0: No. 1: Yes. Note After pre-binding is enabled, the corresponding number of authorization licenses are automatically bound to the specified servers after the purchase is completed.	1
NtmVersion	string	No	The NTM version code for pre-binding.	level2
AuthItem	string	No	The instance type. Valid values: SERVERLESS: Serverless asset.	SERVERLESS
BindAssetType	string	No	The Asset Type for the operation. Valid values: INSTANCE: Instance. APP: Application.	APP
BindAppList	array	No	The list of application IDs to bind. Note Obtain the IDs by calling the ListMachineApps operation.
	string	No	The application ID.	**7ad7e3a
UnBindAppList	array	No	The list of application IDs to unbind. Note Obtain the IDs by calling the ListMachineApps operation.
	string	No	The application ID to unbind.	**7ad7e3a
AppCriteria	string	No	The application query conditions.	**7ad7e3a
ResourceDirectoryUid	integer	No	The UID of the resource directory.	123456
ClientToken	string	No	The client token that is used to ensure the idempotence of the request. Use a different token for each request. The token can contain only ASCII characters and cannot exceed 64 characters in length.
		No	Specifies whether to perform a dry run. true: performs only a check without executing the actual operation. false: performs the actual operation. Default value: false.

Response elements

Element	Type	Description	Example
	object	PlainResult
Data	object	The returned data details.
ResultCode	integer	The result code. Valid values: 0: Success. 1: Parameter error.	0
RequestId	string	The request ID generated by Alibaba Cloud for the request. You can use this ID to troubleshoot issues.	A47F77A1***8CD37050E

Examples

Success response

JSON format

{
  "Data": {
    "ResultCode": 0
  },
  "RequestId": "A47F77A1***8CD37050E"
}

Error codes

HTTP status code	Error code	Error message	Description
400	IdempotentParameterMismatch	相同的 ClientToken 被用于不同的请求参数。
500	ServerError	ServerError
403	NoPermission	caller has no permission	You are not authorized to do this operation.
409	IdempotentRequestInProgress	使用相同 ClientToken 的请求正在处理中。

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.