All Products
Search

This Product

    Lindorm:ListTagResources

    Document Center

    Lindorm:ListTagResources

    Last Updated:Mar 03, 2024

    Queries the tags associated with the specified Lindorm instance.

    Debugging

    OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

    Authorization information

    There is currently no authorization information disclosed in the API.

    Request parameters

    ParameterTypeRequiredDescriptionExample
    RegionIdstringYes

    The ID of the region in which the instances whose tags you want to query are located. You can call the DescribeRegions operation to query the region ID.

    		cn-hangzhou
    ResourceIdarrayYes

    The list of resource IDs.

    stringYes

    The IDs of the instances whose tags you want to query. You can specify multiple instance IDs to query the tags associated with the instances. You can call the GetLindormInstanceList operation to query the instance IDs.

    		ld-bp17j28j2y7pm****
    NextTokenstringNo

    The token used to start the next query to retrieve more results.

    Note This parameter is not required in the first query. If not all results are returned in one query, you can pass in the NextToken value returned for the query to perform the next query.
    		212db86****
    ResourceTypestringYes

    The resource type. Set the value to INSTANCE.

    		INSTANCE
    Tagobject []No

    The list of tags associated with the instances you want to query.

    KeystringNo

    The keys of the tags associated with the instances you want to query.

    Note You can specify the keys of multiple tags. For example, you can specify the key of the first tag in the first key-value pair contained in the value of this parameter and specify the key of the second tag in the second key-value pair.
    		test
    ValuestringNo

    The values of the tags associated with the instances you want to query.

    Note You can specify the values of multiple tags. For example, you can specify the value of the first tag in the first key-value pair contained in the value of this parameter and specify the value of the second tag in the second key-value pair.
    		2.2.8

    Response parameters

    ParameterTypeDescriptionExample
    object
    RequestIdstring

    The ID of the request.

    		05CB115C-91CB-529F-9098-50C1F6CB3BD3
    TagResourcesobject []

    The list of resources.

    ResourceTypestring

    The type of the resources. The returned value is fixed to ALIYUN::HITSDB::INSTANCE.

    		ALIYUN::HITSDB::INSTANCE
    TagValuestring

    The value of the tag associated with the instance.

    		2.2.8
    ResourceIdstring

    The ID of the resource, which is the ID of the instance.

    		ld-bp17j28j2y7pm****
    TagKeystring

    The key of the tag associated with the instance.

    		test
    NextTokenstring

    The token used to start the next query.

    Note If not all results are returned in the first query, this parameter is returned. You can pass in the returned value of this parameter for the next query.
    		212db86****

    Examples

    Sample success responses

    JSONformat

    {
  "RequestId": "05CB115C-91CB-529F-9098-50C1F6CB3BD3",
  "TagResources": [
    {
      "ResourceType": "ALIYUN::HITSDB::INSTANCE",
      "TagValue": "2.2.8",
      "ResourceId": "ld-bp17j28j2y7pm****",
      "TagKey": "test"
    }
  ],
  "NextToken": "212db86****"
}

    Error codes

    HTTP status codeError codeError messageDescription
    400Lindorm.Errorcode.MissingParameterYou must specify ResourceId.N or Tags-
    400Lindorm.Errorcode.NumberExceed.TagsThe maximum number of Tags is exceeded.-
    400Lindorm.Errorcode.NumberExceed.ResourceIdsThe maximum number of ResourceIds is exceeded.-
    403API.ForbiddenThe API operation is forbidden in this environment.This operation is not supported in the current environment.
    403Lindorm.Errorcode.OperationDeniedYou are not authorized to operate on the specified resource.You are not authorized to manage the specified resource.
    403Lindorm.Errorcode.ServiceLinkedRoleNoPermissionNo permission to create service linked role.You are not authorized to create the service-linked role.
    404Lindorm.Errorcode.InstanceNotFoundThe instance is not found.The specified instance does not exist.

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

    Change history

    Change timeSummary of changesOperation
    No change history