All Products
Search
Document Center

Bastionhost:GetProjectAuthorization

Last Updated:Aug 14, 2026

Queries the details of a project 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

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

Request syntax

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

The instance ID of the bastion host.

Note

You can invoke the DescribeInstances operation to obtain this parameter.

bastionhost-cn-st220aw****

RegionId

string

No

The region ID of the bastion host.

Note

For the mapping between region IDs and region names, see Regions and zones.

cn-hangzhou

AuthorizationId

integer

Yes

The ID of the project authorization to query.

Note

You can call the ListProjectAuthorizations operation to obtain this parameter.

1

Response elements

Element

Type

Description

Example

object

Schema of Response

ProjectAuthorization

object

The details of the project authorization.

AuthorizationId

integer

The project authorization ID.

1

Name

string

The project authorization name.

name

Description

string

The description of the project authorization.

description

ScopeType

integer

The scope of manageable assets associated with the authorization. Valid values:

  • 1: All projects.

  • 2: Specified projects.

1

Principals

array<object>

The information about the project administrators specified in the project authorization.

object

The project administrator information.

PrincipalType

string

RamRole

PrincipalId

string

2036****6767

PrincipalName

string

name

ProjectIds

array

The list of project IDs associated with the project authorization.

integer

The array of project IDs.

1,2,3

Projects

array<object>

The information about the projects associated with the project authorization.

object

The project details.

ProjectId

integer

1

Name

string

project1

Description

string

comment

IsDefault

boolean

false

RequestId

string

The request ID generated by Alibaba Cloud for this request.

EC9BF0F4-8983-491A-BC8C-1B4DD94976DE

Examples

Success response

JSON format

{
  "ProjectAuthorization": {
    "AuthorizationId": 1,
    "Name": "name",
    "Description": "description",
    "ScopeType": 1,
    "Principals": [
      {
        "PrincipalType": "RamRole",
        "PrincipalId": "2036****6767",
        "PrincipalName": "name"
      }
    ],
    "ProjectIds": [
      0
    ],
    "Projects": [
      {
        "ProjectId": 1,
        "Name": "project1",
        "Description": "comment",
        "IsDefault": false
      }
    ]
  },
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.