Queries the basic metadata information about a compute engine instance.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

ParameterTypeRequiredExampleDescription
ActionStringYesGetMetaDBInfo

The operation that you want to perform. Set the value to GetMetaDBInfo.

AppGuidStringNoodps.some_engine_name

The ID of the compute engine instance. Specify the ID in the Engine type.Engine name format.

ClusterIdStringNoabc

The ID of the E-MapReduce (EMR) cluster. This parameter is required only if you set the DataSourceType parameter to emr.

DatabaseNameStringNoabc

The name of the metadatabase of the EMR cluster. This parameter is required only if you set the DataSourceType parameter to emr.

DataSourceTypeStringNoemr

The type of the data source. Valid values: odps and emr.

Response parameters

ParameterTypeExampleDescription
RequestIdString0bc1411515937****

The request ID.

DataObject

The business data.

TypeStringhive

The type of the metadatabase.

CommentStringComment

The comment.

CreateTimeLong1541576644000

The time when the compute engine instance was created.

ProjectIdLong22

The workspace ID.

ProjectNameStringtest

The name of the workspace.

AppGuidStringodps.engine_name

The ID of the compute engine instance. The ID is in the Engine type.Engine name format.

OwnerNameStringmy_name

The name of the workspace owner.

OwnerIdStringuserId

The ID of the Alibaba Cloud account used by the workspace owner.

EnvTypeInteger1

The type of the environment. Valid values: 0 and 1. The value 0 indicates the development environment. The value 1 indicates the production environment.

ProjectNameCnStringTest project

The display name of the workspace.

EndpointStringhttp://service.odpsstg.aliyun-inc.com/

The endpoint of the service.

ClusterBizIdStringabc

The ID of the EMR cluster. This parameter is returned only for an EMR compute engine instance.

NameStringabc

The name of the metadatabase.

LocationStringhdfs://

The storage path of the metadatabase of the EMR cluster.

TenantIdLong233

The tenant ID.

ModifyTimeLong1541576644000

The time when the compute engine instance was modified.

Examples

Sample requests

http(s)://[Endpoint]/?Action=GetMetaDBInfo
&AppGuid=odps.some_engine_name
&ClusterId=abc
&DatabaseName=abc
&DataSourceType=emr
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<GetMetaDBInfoResponse>
    <RequestId>0bc1411515937****</RequestId>
    <Data>
        <Type>hive</Type>
        <Comment>Comment</Comment>
        <CreateTime>1541576644000</CreateTime>
        <ProjectId>22</ProjectId>
        <ProjectName>test</ProjectName>
        <AppGuid>odps.engine_name</AppGuid>
        <OwnerName>323</OwnerName>
        <OwnerId>23</OwnerId>
        <EnvType>1</EnvType>
        <ProjectNameCn>Test project</ProjectNameCn>
        <Endpoint>http://service.odpsstg.aliyun-inc.com/</Endpoint>
        <ClusterBizId>abc</ClusterBizId>
        <Name>abc</Name>
        <Location>hdfs://</Location>
        <TenantId>233</TenantId>
        <ModifyTime>1541576644000</ModifyTime>
    </Data>
</GetMetaDBInfoResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0bc1411515937****",
  "Data" : {
    "Type" : "hive",
    "Comment" : "Comment",
    "CreateTime" : 1541576644000,
    "ProjectId" : 22,
    "ProjectName" : "test",
    "AppGuid" : "odps.engine_name",
    "OwnerName" : "323",
    "OwnerId" : "23",
    "EnvType" : 1,
    "ProjectNameCn" : "Test project",
    "Endpoint" : "http://service.odpsstg.aliyun-inc.com/",
    "ClusterBizId" : "abc",
    "Name" : "abc",
    "Location" : "hdfs://",
    "TenantId" : 233,
    "ModifyTime" : 1541576644000
  }
}

Error codes

HTTP status codeError codeError messageDescription
400Invalid.Meta.AppNotExistThe MaxCompute project does not exist.The MaxCompute project is not found.
400InvalidParameter.Meta.CommonErrorThe specified parameter is invalid.The values specified for one or more request parameters are invalid.
400InvalidParameter.Meta.IllegalThe app guid parameter is invalid.The values specified for one or more parameters of the application are invalid.
400InvalidParameter.Meta.IllegalDateThe date format is invalid.The date format is invalid.
400InvalidParameter.Meta.IllegalPageErrorThe parameter for paging is invalid.The value of the parameter for paging is invalid.
400InternalError.UserId.MissingAn internal system error occurred. Try again later.An internal error occurred. Try again later.
400InternalError.Meta.NoCalcEngineAn error occurred while retrieving the compute engine based on the MaxCompute project.Failed to obtain the compute engine instance based on the MaxCompute project {0}.
400InvalidParameter.Meta.NotExistThe data does not exist.The data you query is not found.
403Forbidden.Meta.NoTenantThe user is not the owner of any tenants.The current user is not a tenant owner.
429Throttling.ApiThe request for this resource has exceeded your available limit.The number of requests for the resource has exceeded the upper limit.
429Throttling.Api.RiskThe request for this resource has exceeded your daily available limit.The number of requests per day for the resource has exceeded the upper limit.
429Throttling.SystemThe DataWorks system is busy. Try again later.The DataWorks system is busy. Try again later.
429Throttling.UserYour request is too frequent. Try again later.Excessive requests have been submitted within a short period of time. Try again later.
500InternalError.SystemAn internal system error occurred. Try again later.An internal error occurred. Try again later.
500InternalError.Meta.TenantTimeOutFailed to connect to the interface network.The network cannot be connected.
500InternalError.Meta.UnknownAn unknown error occurred while processing your request.An unknown error occurred.

For a list of error codes, see Service error codes.

For more information about the example on how to use the GetMetaDBInfo operation, see Examples of DataWorks API operations.