All Products
Search
Document Center

API Gateway:DescribeBackendInfo

Last Updated:Mar 06, 2025

Queries the information about a backend service and its URL configured for each environment.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • For mandatory resource types, indicate with a prefix of * .
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
apigateway:DescribeBackendInfoget
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
BackendIdstringYes

The ID of the backend service.

739b68751c0b4e899e04d0c92b6d0be7

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The ID of the request.

0AA90E87-3506-5AA6-AFFB-A4D53B4F6231
BackendInfoobject

The information about the backend service.

BackendNamestring

The name of the backend service.

testoss2
BackendTypestring

The type of the backend service.

HTTP
ModifiedTimestring

The time when the backend service was modified.

2017-12-11T15:18:09+08:00
Descriptionstring

The description of the backend service.

add
CreatedTimestring

The time when the backend service was created.

2021-11-22T11:10:46+08:00
BackendIdstring

The ID of the backend service.

6fc978bb63574146b766863dd7bdf661
BackendModelsarray<object>

The configurations of the backend service in the environment.

BackendModelobject

The configurations of the backend service in the environment.

BackendModelIdstring

The ID of the backend service in the environment.

5c4995d08e8b4954b0f326e8e4f2b97d
StageModeIdstring

The ID of the environment.

6fc978bb63574146b766863dd7bdf661
Descriptionstring

The description of the backend service.

testDvs 1
GmtCreatestring

The time when the backend service was created.

2021-12-20T03:22:03.000+0000
GmtModifiedstring

The time when the backend service was modified.

2021-12-20T03:22:03.000+0000
StageNamestring

The environment name.

RELEASE
BackendConfigobject

The backend service configurations.

ServiceAddressstring

The URL of the backend service.

10.0.0.1
HttpTargetHostNamestring

The host of the HTTP backend service.

www.host.com
Typestring

The type of the backend service.

VPC
VpcConfigobject

The information about the backend service when the backend service is of the VPC type.

VpcIdstring

The ID of the VPC.

vpc-wz9v96hqi6d14744sxqmx
InstanceIdstring

The ID of the Elastic Compute Service (ECS) or Server Load Balancer (SLB) instance in the VPC.

i-uf6iaale3gfef9t9cb41
Portlong

The port number that corresponds to the instance.

8080
VpcAccessIdstring

The ID of the VPC access authorization.

2zej3ehuzg9m77kvwnfpn
Namestring

The name of the VPC configuration.

dypls-cn-beijing-slb-pre
VpcSchemestring

Indicates whether HTTP or HTTPS is used.

http
VpcTargetHostNamestring

The host of the VPC backend service.

openapi.alipan.com
FunctionComputeConfigobject

The information about the backend service whose type is Function Compute.

FcTypestring

The type of the service in Function Compute.

HttpTrigger
FcRegionIdstring

The region ID of the Function Compute service.

cn-hangzhou
ServiceNamestring

The service name that is defined in Function Compute.

myservice
FunctionNamestring

The function name that is defined in Function Compute.

edge_function
RoleArnstring

The Alibaba Cloud Resource Name (ARN) of the RAM role that is assumed by API Gateway to access Function Compute.

acs:ram::31985*:role/aliyunserviceroleforbastionhostpam
Qualifierstring

The alias of the function.

testQualifier
FcBaseUrlstring

The root path of the Function Compute service.

https://t*******.ap-*****.fcapp.run/
OnlyBusinessPathboolean

Indicates whether the backend service receives only the service path.

false
TriggerNamestring

The name of the trigger.

You can specify the TriggerName or TriggerUrl parameter. The TriggerName parameter is optional.

test1
OssConfigobject

The information about the backend service whose type is Object Storage Service (OSS).

OssRegionIdstring

The region ID of the OSS bucket.

cn-hangzhou
BucketNamestring

The name of the OSS bucket.

my_bucket
EventBridgeConfigobject

The information about the backend service whose type is EventBridge.

EventBridgeRegionIdstring

The region ID of the event bus in EventBridge.

cn-hangzhou
EventSourcestring

The event source.

dds_driver
EventBusstring

The event bus.

testBus
RoleArnstring

The ARN of the RAM role to be assumed by API Gateway to access EventBridge.

acs:ram::1975133748561***:role/aliyunserviceroleforiotlogexport
MockConfigobject

The information about the backend service when the backend service is of the Mock type.

MockResultstring

The mocked response.

test
MockStatusCodestring

The status code in the mocked response.

200
MockHeadersarray<object>

The header in the mocked response.

MockHeaderobject

The information about service mocking.

HeaderNamestring

The header name.

test
HeaderValuestring

The header value.

123
DiscoveryConfigobject

The information about the backend service when the backend service is of the Service Discovery type.

RcTypestring

The registry type.

NACOS
NacosConfigobject

The Nacos configurations.

ServerAddressstring

The Nacos service address.

http://1xx.2xx.3xx.4xx:8848
Namespacestring

The ID of the namespace where the microservice that is registered with Nacos resides.

public
GroupNamestring

The name of the group to which the microservice that is registered with Nacos belongs.

DEFAULT_GROUP
ServiceNamestring

The microservice name.

service-provider
Clustersstring

The name of the cluster to which the microservice belongs.

cluster1
AuthTypestring

The authentication method.

PASSWORD
UserNamestring

The username.

username
Passwordstring

The password.

password
AccessKeystring

The AccessKey of the RAM user that has the resource management permissions on Microservices Engine (MSE).

A5FIDxxxxxx
SecretKeystring

The SecretKey of the RAM user that has the resource management permissions on MSE.

dl5loxxxxxx
ZookeeperConfigobject

The ZooKeeper configuration.

ConnectStringstring

The connection URL of the ZooKeeper server.

http://192.168.1.xxx:2181
Namespacestring

The namespace.

provider
ServiceNamestring

Service name

service
ServiceTimeoutinteger

The timeout period of the backend service, in millisecond.

10000
EdasConfigobject

The EDAS configuration.

MicroserviceNamespaceNamestring

The name of the microservices namespace in EDAS.

Edas-Nacos
MicroserviceNamespaceIdstring

The ID of the microservices namespace in EDAS.

cn-hangzhou:edasNacos
MicroserviceNamespacestring

The ID of the microservices namespace in EDAS.

cn-hangzhou:edasNacos
ServiceNamestring

The service name.

service
EdasAppIdstring

The EDAS application ID.

6cd0c599-dxxx-496d-b3d5-6a71c657xxxxx
RegistryTypestring

The registration type.

EDAS
MseInstanceIdstring

The MSE instance ID.

mse-cn-jia3n1rxxxx

Examples

Sample success responses

JSONformat

{
  "RequestId": "0AA90E87-3506-5AA6-AFFB-A4D53B4F6231",
  "BackendInfo": {
    "BackendName": "testoss2",
    "BackendType": "HTTP",
    "ModifiedTime": "2017-12-11T15:18:09+08:00",
    "Description": "add",
    "CreatedTime": "2021-11-22T11:10:46+08:00",
    "BackendId": "6fc978bb63574146b766863dd7bdf661",
    "BackendModels": [
      {
        "BackendModelId": "5c4995d08e8b4954b0f326e8e4f2b97d",
        "StageModeId": "6fc978bb63574146b766863dd7bdf661",
        "Description": "testDvs 1",
        "GmtCreate": "2021-12-20T03:22:03.000+0000",
        "GmtModified": "2021-12-20T03:22:03.000+0000",
        "StageName": "RELEASE",
        "BackendConfig": {
          "ServiceAddress": "10.0.0.1",
          "HttpTargetHostName": "www.host.com",
          "Type": "VPC",
          "VpcConfig": {
            "VpcId": "vpc-wz9v96hqi6d14744sxqmx",
            "InstanceId": "i-uf6iaale3gfef9t9cb41",
            "Port": 8080,
            "VpcAccessId": "2zej3ehuzg9m77kvwnfpn",
            "Name": "dypls-cn-beijing-slb-pre",
            "VpcScheme": "http",
            "VpcTargetHostName": "openapi.alipan.com"
          },
          "FunctionComputeConfig": {
            "FcType": "HttpTrigger",
            "FcRegionId": "cn-hangzhou",
            "ServiceName": "myservice",
            "FunctionName": "edge_function",
            "RoleArn": "acs:ram::31985*:role/aliyunserviceroleforbastionhostpam",
            "Qualifier": "testQualifier",
            "FcBaseUrl": "https://t*******.ap-*****.fcapp.run/",
            "OnlyBusinessPath": false,
            "TriggerName": "test1"
          },
          "OssConfig": {
            "OssRegionId": "cn-hangzhou",
            "BucketName": "my_bucket"
          },
          "EventBridgeConfig": {
            "EventBridgeRegionId": "cn-hangzhou",
            "EventSource": "dds_driver",
            "EventBus": "testBus",
            "RoleArn": "acs:ram::1975133748561***:role/aliyunserviceroleforiotlogexport"
          },
          "MockConfig": {
            "MockResult": "test\n",
            "MockStatusCode": "200",
            "MockHeaders": [
              {
                "HeaderName": "test\n",
                "HeaderValue": "123"
              }
            ]
          },
          "DiscoveryConfig": {
            "RcType": "NACOS",
            "NacosConfig": {
              "ServerAddress": "http://1xx.2xx.3xx.4xx:8848",
              "Namespace": "public",
              "GroupName": "DEFAULT_GROUP",
              "ServiceName": "service-provider",
              "Clusters": "cluster1",
              "AuthType": "PASSWORD",
              "UserName": "username",
              "Password": "password",
              "AccessKey": "A5FIDxxxxxx",
              "SecretKey": "dl5loxxxxxx"
            },
            "ZookeeperConfig": {
              "ConnectString": "http://192.168.1.xxx:2181",
              "Namespace": "provider",
              "ServiceName": "service"
            }
          },
          "ServiceTimeout": 10000,
          "EdasConfig": {
            "MicroserviceNamespaceName": "Edas-Nacos",
            "MicroserviceNamespaceId": "cn-hangzhou:edasNacos",
            "MicroserviceNamespace": "cn-hangzhou:edasNacos\n",
            "ServiceName": "service",
            "EdasAppId": "6cd0c599-dxxx-496d-b3d5-6a71c657xxxxx",
            "RegistryType": "EDAS",
            "MseInstanceId": "mse-cn-jia3n1rxxxx"
          }
        }
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-12-19The response structure of the API has changedView Change Details
2023-12-27The response structure of the API has changedView Change Details
2023-11-09The response structure of the API has changedView Change Details
2023-09-19The response structure of the API has changedView Change Details
2023-06-03The response structure of the API has changedView Change Details
2023-05-12The response structure of the API has changedView Change Details
2022-09-22The response structure of the API has changedView Change Details