日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
產品文檔
輸入文檔關鍵字查找
首頁 云服務器 ECS 開發參考 API參考（ECS） API目錄 標簽與資源組 ListTagResources - 查詢資源已經綁定的標簽列表

ListTagResources - 查詢資源已經綁定的標簽列表

更新時間：
一鍵部署
產品詳情
相關技術圈
我的收藏

查詢一個或多個ECS資源已經綁定的標簽列表。

接口說明

請求中至少指定以下任一參數，以確定查詢對象。

  • ResourceId.N
  • Tag.N（Tag.N.Key與Tag.N.Value）
  • TagFilter.N

同時指定下列參數時，返回結果中僅包含同時滿足這兩個條件的 ECS 資源。

  • Tag.N和ResourceId.N
  • TagFilter.N和ResourceId.N

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：

  • 操作：是指具體的權限點。
  • 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
  • 資源類型：是指操作中支持授權的資源類型。具體說明如下：
    • 對于必選的資源類型，用背景高亮的方式表示。
    • 對于不支持資源級授權的操作，用全部資源表示。
  • 條件關鍵字：是指云產品自身定義的條件關鍵字。
  • 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
ecs:ListTagResourcesget
  • 全部資源
    *
    無
無

請求參數

名稱類型必填描述示例值
RegionIdstring是

資源所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
NextTokenstring否

下一個查詢開始 Token。

caeba0bbb2be03f84eb48b699f0a4883
ResourceTypestring是

資源類型定義。取值范圍：

  • instance：ECS 實例。
  • disk：磁盤。
  • snapshot：快照。
  • image：鏡像。
  • securitygroup：安全組。
  • volume：存儲卷。
  • eni：彈性網卡。
  • ddh：專有宿主機。
  • ddhcluster：專有宿主機集群。
  • keypair：SSH 密鑰對。
  • launchtemplate：啟動模板。
  • reservedinstance：預留實例券。
  • snapshotpolicy：自動快照策略。
  • elasticityassurance：彈性保障。
  • capacityreservation：容量預定。
  • command：云助手命令。
  • invocation：云助手命令執行或文件下發結果。
  • activation：云助手托管實例激活碼。
  • managedinstance：云助手托管實例。
instance
ResourceIdarray否

ECS 資源 ID。N 的取值范圍為 1~50。

string否

ECS 資源 ID。N 的取值范圍為 1~50。

i-bp1j6qtvdm8w0z1o****
Tagarray<object>否

標簽列表。

object否

標簽列表。

Keystring否

精確查找 ECS 資源時使用的標簽鍵。標簽鍵長度的取值范圍為 1~128。N 的取值范圍為 1~20。

Tag.N參數使用說明：

  • 方式一：用于精確查找綁定了指定標簽的 ECS 資源，由一個鍵值對組成。

    • 僅指定Tag.N.Key時，則返回關聯該標簽鍵的所有資源。

    • 僅指定Tag.N.Value，則報錯InvalidParameter.TagValue。

    • 同時指定多個標簽鍵值對時，僅同時滿足所有標簽鍵值對的 ECS 資源會被查找到。

  • 方式二：用于查詢非默認資源組內的資源信息。Key的取值固定為acs:rm:rgId，對應的Value取值為資源組 ID。

    • 如果Key取值為acs:rm:rgId，則Value的取值只能是非默認資源組 ID。如果指定的資源組 ID 為默認資源組，則會返回錯誤信息。

    • 如果Key取值為acs:rm:rgId，則不支持再指定其他標簽鍵值對。如果通過多個Tag.N參數同時查詢資源組和標簽對應的資源，則會返回錯誤信息。

TestKey
Valuestring否

精確查找 ECS 資源時使用的標簽值。標簽值長度的取值范圍為 1~128。N 的取值范圍為 1~20。

說明 當Key=acs:rm:rgId時，該參數只能傳入資源組 ID，且資源組 ID 不能為默認資源組。
TestValue
TagFilterarray<object>否

Tag 過濾規則。

object否

Tag 過濾規則。

TagValuesarray否

模糊查找 ECS 資源時使用的標簽值。標簽值長度的取值范圍為 1~128。N 的取值范圍為 1~5。具體的參數說明請參見TagFilter.N.TagKey參數描述。

string否

模糊查找 ECS 資源時使用的標簽值。標簽值長度的取值范圍為 1~128。N 的取值范圍為 1~5。具體的參數說明請參見TagFilter.N.TagKey參數描述。

TestTagFilter
TagKeystring否

模糊查找 ECS 資源時使用的標簽鍵。標簽鍵長度的取值范圍為 1~128。N 的取值范圍為 1~5。

TagFilter.N用于模糊查找綁定了指定標簽的 ECS 資源，由一個鍵和一個或多個值組成。模糊查詢可能會有 2 秒延時，僅支持模糊過濾后資源數小于等于 5000 的情況。

  • 通過標簽鍵（TagFilter.N.TagKey）模糊查找 ECS 資源時，標簽值（TagFilter.N.TagValues.N）必須為空。例如，模糊搜索標簽鍵為environment的 ECS 資源時，TagFilter.1.TagKey可以設置為env*（前綴匹配的模糊搜索方式）、*env*（兩邊匹配的模糊搜索方式）或者env（精確搜索方式），而TagFilter.1.TagValues必須為空。

  • 通過標簽值（TagFilter.N.TagValues.N）模糊查找 ECS 資源時，標簽鍵（TagFilter.N.TagKey）必須設置為精確值。例如，模糊搜索標簽鍵為env，標簽值為product的 ECS 資源時，TagFilter.1.TagKey必須精確設置為env，TagFilter.1.TagValues.1可以設置為proc*（前綴匹配的模糊搜索方式）、*proc*（兩邊匹配的模糊搜索方式）或者proc（精確搜索方式）。同一個TagKey下只能用同一種搜索方式，如果設置了多個不同的搜索方式，則以第一個方式為準。

  • 標簽鍵之間為交集關系，即僅同時滿足您指定的所有標簽鍵的 ECS 資源才會被查找到。

  • 同一標簽鍵下的標簽值之間為并集關系，即滿足您為該標簽鍵指定的任一標簽值的 ECS 資源均會被查找到。

說明 TagFilter.N與Tag.N參數不能同時使用，否則會返回錯誤信息。
env

返回參數

名稱類型描述示例值
object
NextTokenstring

下一個查詢開始 Token。

caeba0bbb2be03f84eb48b699f0a4883
RequestIdstring

請求 ID。

484256DA-D816-44D2-9D86-B6EE4D5BA78C
TagResourcesarray<object>

由資源及其標簽組成的集合，包含了資源 ID、資源類型和標簽鍵值等信息。

TagResourceobject
TagValuestring

標簽值。

TestValue
ResourceTypestring

資源類型。可能值：

  • instance：ECS 實例。
  • disk：磁盤。
  • snapshot：快照。
  • image：鏡像。
  • securitygroup：安全組。
  • volume：存儲卷。
  • eni：彈性網卡。
  • ddh：專有宿主機。
  • ddhcluster：專有宿主機集群。
  • keypair：SSH 密鑰對。
  • launchtemplate：啟動模板。
  • reservedinstance：預留實例券。
  • snapshotpolicy：自動快照策略。
  • elasticityassurance：彈性保障。
  • capacityreservation：容量預定。
  • command：云助手命令。
  • invocation：云助手命令執行結果。
  • activation：云助手托管實例激活碼。
  • managedinstance：云助手托管實例。
instance
ResourceIdstring

資源 ID。

i-bp1j6qtvdm8w0z1o****
TagKeystring

標簽鍵。

TestKey

示例

正常返回示例

JSON格式

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "484256DA-D816-44D2-9D86-B6EE4D5BA78C",
  "TagResources": {
    "TagResource": [
      {
        "TagValue": "TestValue",
        "ResourceType": "instance",
        "ResourceId": "i-bp1j6qtvdm8w0z1o****",
        "TagKey": "TestKey"
      }
    ]
  }
}

錯誤碼

HTTP status code錯誤碼錯誤信息描述
400InvalidDefaultResourceGroup.NotSupportedThe specified parameter Tag is not support for default resource group.不支持查詢默認資源組。
400InvalidTag.NotSupportedYou can only specify Tag for either resource tag or resource group.不支持同時查詢資源組和標簽。
400NumberExceed.ResourceIdsThe ResourceIds parameter's number is exceed , Valid : 50.-
400NumberExceed.TagsThe Tags parameter's number is exceed , Valid : 20.-
400Duplicate.TagKeyThe Tag.N.Key contain duplicate key.標簽中存在重復的鍵，請保持鍵的唯一性。
400InvalidTagKey.MalformedThe specified Tag.n.Key is not valid.指定的標簽鍵參數有誤。
400InvalidTagValue.MalformedThe specified Tag.n.Value is not valid.指定的標簽值參數有誤。
400OperationDenied.QuotaExceedThe quota of tags on resource is beyond permitted range.資源標簽已達上限。
400InvalidTag.MismatchThe specified Tag.n.Key and Tag.n.Value are not match.指定的 Tag.N.Key 和 Tag.N.Value 不匹配。
400InvalidTagCountThe specified tags are beyond the permitted range.指定的標記超出取值范圍。
400Invalid.ScopeThe specified scope is invalid.可見范圍參數無效。
400InvalidTags.MalFormedThe tags must be empty, when the tagFilters is not empty.-
403PermissionDenied.TagOwnerBidThe specified operator not have permission to set TagOwnerBid value.-
403PermissionDenied.TagOwnerUidThe specified operator not have permission to set TagOwnerUid value.無權設置標簽歸屬者。
403PermissionDenied.ScopeThe specified operator not have permission to set Scope value.指定的操作員無權設置范圍值。
403InvalidResourceId.NotSupportedThe specified ResourceId does not support tagging.指定的資源 ID 不支持標記。
403NoPermission.TagThe operator is not permission for the tag.您沒有操作該資源標簽的權限。
403BothEmpty.TagsAndResourcesThe specified Tags and ResourcesIds are not allow to both empty.-
403PermissionDenied.TagsFuzzyQueryThe specified operator has not permission to query fuzzy tags.-
403NumberExceed.TagValuesThe number of the specified TagValues is beyond permitted range, the max is 5.-
403InvalidFilter.MalformedThe specified Filter is not valid.-
403InvalidTagFilter.MalformedThe specified TagFilter is not valid.-
403Invalid.NextTokenThe specified NextToken is not valid.-
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.提供的RegionId不存在
404InvalidRegionId.NotFound%s提供的地域 ID 不存在。
404MissingParameter.ResourceIdsThe parameter - ResourceIds.N should not be null.-
404MissingParameter.TagOwnerUidThe parameter - TagOwnerUid should not be null.-
404MissingParameter.TagOwnerBidThe parameter - TagOwnerBid should not be null.-
404MissingParameter.ResourceTypeThe parameter - ResourceType should not be null.參數ResourceType不能為空。
404MissingParameter.TagsThe parameter - Tags should not be null.-
404MissingParameter.RegionIdThe parameter - RegionId should not be null.-
404InvalidResourceId.NotFoundThe specified ResourceIds are not found in our records.指定的資源不存在，請檢查參數 ResourceId 是否正確。
404InvalidResourceType.NotFoundThe ResourceType provided does not exist in our records.指定的資源類型不存在。
404InvalidRegionId.NotFoundThe specified RegionId does not exist.指定的地域 ID 不存在。
500ServiceUnavailableThe service is unavailable, please try again later.服務暫時不可用，請稍候重試。
500InternalErrorThe process of creating snapshot has failed due to some unknown error.創建快照失敗。

訪問錯誤中心查看更多錯誤碼。

變更歷史

變更時間變更內容概要操作
暫無變更歷史