Updated on 2026-11-12 GMT+08:00

Querying the Agency Authorization Status

Function

This API is used to check whether agency authorization has been enabled for ModelArts. It is used when you need to check whether ModelArts authorization has been enabled for subsequent operations (such as model training and deployment). Before using this API, ensure that you have logged in to the system and have the query permission. The agency authorization status (enabled or disabled) is returned in the query result. If you do not have the query permission or the service is abnormal, an error message is returned.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permissions are required for calling this API.

URI

GET /v2/{project_id}/auth/grant

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID. For details, see Obtaining a Project ID and Name. Constraints: N/A Range: N/A Default Value: N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
service_name	String	Definition: Service name. Range: N/A
status	Boolean	Definition: Authorization status. true indicates that the authorization has been granted, and false indicates that the authorization has not been granted. Range true: Authorized. false: Not authorized.

Status code: 400

**Table 3** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Requests

None

Example Responses

Status code: 200

{
  "service_name" : "ModelArts",
  "status" : true
}

Status Codes

Status Code	Description
200	The agency authorization status is queried.
400	Error response

Error Codes

See Error Codes.

Parent topic: Authorization Management