All Products
Search
Document Center

Cloud Control API:GetResourceType

Last Updated:Mar 06, 2025
This topic is generated by a machine translation engine without any human intervention. ALIBABA CLOUD DOES NOT GUARANTEE THE ACCURACY OF MACHINE TRANSLATED CONTENT. To request a human-translated version of this topic or provide feedback on this translation, please include it in the feedback form.

You can call the operation to obtain resource metadata.

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

There is currently no authorization information disclosed in the API.

Request syntax

GET /api/v1/providers/{provider}/products/{product}/resourceTypes/* HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
x-acs-accept-languagestringNo

The language selected for the returned product.

zh_CH: Chinese (default)

en_US: English

zh_CH
requestPathstringYes

The request path. Specify this parameter in the following format: /api/v1/providers/{provider}/products/{product}/resourceTypes/{resourceType}

Variables in the request path. Valid values:

provider: the cloud service provider. Currently, only Aliyun is supported.

product: the product code.

resourceType: the type of the resource. If there is a parent resource, the format is {parent resource type code}/{resource type code}

/api/v1/providers/Aliyun/products/Redis/resourceTypes/DBInstance

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

requestIdstring

The ID of the request.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
resourceTypeobject

The resource type. Valid values:

createOnlyPropertiesarray

The properties that are specific to the create operation. You need to specify these properties when you create the resource. These properties are not returned when you query the resource.

createOnlyPropertystring

The property that is specific to the create operation.

/properties/AutoRenew
deleteOnlyPropertiesarray

The properties that are specific to the delete operation. You need to specify these properties when you delete the resource. These properties are not returned when you query the resource.

deleteOnlyPropertystring

The property that is specific to the delete operation.

/properties/ForceDelete
filterPropertiesarray

The properties that can be used to filter the resource when you list the resource.

filterPropertystring

The filter parameter.

/properties/ResourceGroupId
getOnlyPropertiesarray

The properties that are specific to the query operation. You need to specify these properties when you query the resource. These properties are not returned in the query result.

getOnlyPropertystring

The property that is specific to the query operation.

/properties/DryRun
getResponsePropertiesarray

The properties that are returned when you query the resource.

getResponsePropertystring

The property that is returned when you query the resource.

/properties/NetworkInterfaces/items/properties/IpvSets
handlersobject

The information about the operation, including the required Resource Access Management (RAM) permissions.

createobject

The information about the create operation.

permissionsarray

The information about the required RAM permissions.

permissionstring

RAM permissions.

ecs:CreateInstance
deleteobject

The information about the delete operation.

permissionsarray

The information about the required RAM permissions.

permissionstring

RAM permissions.

ecs:DeleteInstance
getobject

The information about the query operation.

permissionsarray

The information about the required RAM permissions.

permissionstring

RAM permissions.

ecs:DescribeInstanceAttachmentAttributes
listobject

The information about the list operation.

permissionsarray

The information about the required RAM permissions.

permissionstring

RAM permissions.

ecs:DescribeInstances
updateobject

The information about the update operation.

permissionsarray

The information about the required RAM permissions.

permissionstring

RAM permissions.

ecs:ModifyInstanceNetworkSpec
infoobject

The basic information about the resource type.

chargeTypestring

The payment form. Valid values:

paid free

paid
deliveryScopestring

The delivery level. Valid values:

center

region

zone

region
descriptionstring

The description of the resource type.

An ECS instance is equivalent to a virtual machine, including the most basic computing components such as CPU, memory, operating system, network, and disk. You can easily customize and change the configuration of the instance. You have full control over the virtual machine.
titlestring

The name of the resource type.

Instance
listOnlyPropertiesarray

The properties that are specific to the list operation. You need to specify these properties when you list the resource. These properties are not returned when you query the resource.

listOnlyPropertystring

The property that is specific to the list operation.

/properties/DryRun
listResponsePropertiesarray

The properties that are returned when you list the resource.

listResponsePropertystring

The property that is returned when you query the resource.

/properties/InstanceId
primaryIdentifierstring

The ID of the resource.

/properties/InstanceId
productstring

The code of the service.

ECS
propertiesobject

The resource properties. The key specifies the property name and the value specifies the details of the property.

publicPropertiesarray

The common properties of the resource. The common properties are not operation-specific.

publicPropertystring

The common property.

/properties/Description
readOnlyPropertiesarray

The read-only properties. These properties are returned only when you perform the List or Get operation. You do not need to specify these properties when you create or update the resource.

readOnlyPropertystring

The read-only property.

/properties/CreateTime
requiredarray

The properties that must be specified when you create the resource.

requiredstring

The property that must be specified when you create the resource.

RegionId
resourceTypestring

The type of the resource. If the resource belongs to a parent resource, the return format is {parent resource type code /resource type code}.

Instance
sensitiveInfoPropertiesarray

The sensitive properties, such as the password.

sensitiveInfoPropertystring

The sensitive property.

/properties/VncPassword
updateOnlyPropertiesarray

The properties that are specific to the update operation. You need to specify these properties when you update the resource. These properties are not returned when you query the resource.

updateOnlyPropertystring

The property that is specific to the update operation.

/properties/DryRun
updateTypePropertiesarray

The properties that can be modified.

updateTypePropertystring

The property that can be modified.

/properties/InstanceName

Examples

Sample success responses

JSONformat

{
  "requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "resourceType": {
    "createOnlyProperties": [
      "/properties/AutoRenew"
    ],
    "deleteOnlyProperties": [
      "/properties/ForceDelete"
    ],
    "filterProperties": [
      "\t\n/properties/ResourceGroupId"
    ],
    "getOnlyProperties": [
      "/properties/DryRun"
    ],
    "getResponseProperties": [
      "/properties/NetworkInterfaces/items/properties/IpvSets"
    ],
    "handlers": {
      "create": {
        "permissions": [
          "ecs:CreateInstance"
        ]
      },
      "delete": {
        "permissions": [
          "ecs:DeleteInstance"
        ]
      },
      "get": {
        "permissions": [
          "ecs:DescribeInstanceAttachmentAttributes"
        ]
      },
      "list": {
        "permissions": [
          "ecs:DescribeInstances"
        ]
      },
      "update": {
        "permissions": [
          "ecs:ModifyInstanceNetworkSpec"
        ]
      }
    },
    "info": {
      "chargeType": "paid",
      "deliveryScope": "region",
      "description": "An ECS instance is equivalent to a virtual machine, including the most basic computing components such as CPU, memory, operating system, network, and disk. You can easily customize and change the configuration of the instance. You have full control over the virtual machine.",
      "title": "Instance"
    },
    "listOnlyProperties": [
      "/properties/DryRun"
    ],
    "listResponseProperties": [
      "/properties/InstanceId"
    ],
    "primaryIdentifier": "/properties/InstanceId\n",
    "product": "ECS",
    "properties": {
      "test": "test",
      "test2": 1
    },
    "publicProperties": [
      "\t\n/properties/Description"
    ],
    "readOnlyProperties": [
      "/properties/CreateTime"
    ],
    "required": [
      "RegionId"
    ],
    "resourceType": "Instance",
    "sensitiveInfoProperties": [
      "/properties/VncPassword"
    ],
    "updateOnlyProperties": [
      "/properties/DryRun"
    ],
    "updateTypeProperties": [
      "/properties/InstanceName"
    ]
  }
}

Error codes

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

Change history

Change timeSummary of changesOperation
No change history