ListTagResources - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Sorgu hedefini belirlemek için bir istekte aşağıdaki parametrelerden veya parametre çiftlerinden en az birini belirtin:

ResourceId.N
Tag.N parametre çifti (Tag.N.Key ve Tag.N.Value)
TagFilter.N

Aşağıdaki istek parametre kümelerinden biri filtre koşulu olarak belirtilirse, yalnızca belirtilen tüm filtre koşullarını karşılayan ECS kaynakları döndürülür:

Küme 1: Tag.N.Key, Tag.N.Value ve ResourceId.N
Küme 2: TagFilter.N.TagKey, TagFilter.N.TagValues.N ve ResourceId.N

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'ler için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	ListTagResources	Gerçekleştirmek istediğiniz işlem. Değeri ListTagResources olarak ayarlayın.
RegionId	String	Yes	cn-hangzhou	Kaynağın bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
NextToken	String	No	caeba0bbb2be03f84eb48b699f0a4883	Bir sayfalama belirteci.
ResourceType	String	Yes	instance	Kaynak türü. Geçerli değerler: instance: örnek disk: disk snapshot: anlık görüntü image: görüntü securitygroup: güvenlik grubu volume: depolama birimi eni: elastik ağ arabirimi (ENI) ddh: özel ana bilgisayar ddhcluster: özel ana bilgisayar kümesi keypair: SSH anahtar çifti launchtemplate: başlatma şablonu reservedinstance: ayrılmış örnek snapshotpolicy: otomatik anlık görüntü ilkesi elasticityassurance: esneklik garantisi capacityreservation: kapasite rezervasyonu command: Cloud Assistant komutu invocation: Cloud Assistant komutu çalıştırma sonucu veya dosya teslimatı sonucu activation: Cloud Assistant yönetilen örneği için aktivasyon kodu managedinstance: Cloud Assistant yönetilen örneği
ResourceId.N	String	No	i-bp1j6qtvdm8w0z1o****	N kaynağının kimliği. N için geçerli değerler: 1 ile 50 arasında.
Tag.N.Key	String	No	TestKey	ECS kaynaklarının tam eşleşme ile aranması için kullanılan N etiketinin anahtarı. Etiket anahtarı 1 ila 128 karakter uzunluğunda olmalıdır. N için geçerli değerler: 1 ile 20 arasında. `Tag.N` parametre çiftini (Tag.N.Key ve Tag.N.Value) kullanma yöntemleri: Yöntem 1: Belirtilen etiketlere sahip ECS kaynaklarını tam eşleşme ile aramak için bu parametre çiftini kullanın. Her etiket bir anahtar-değer çiftidir. Yalnızca `Tag.N.Key` belirtirseniz, etiketleri belirtilen etiket anahtarını içeren tüm ECS kaynakları döndürülür. Yalnızca `Tag.N.Value` belirtirseniz, `InvalidParameter.TagValue` hatası döndürülür. Birden fazla etiket anahtar-değer çifti belirtirseniz, yalnızca tüm bu etiket anahtar-değer çiftlerine sahip olan ECS kaynakları döndürülür. Yöntem 2: Varsayılan olmayan bir kaynak grubunun kaynak bilgilerini sorgulamak için bu parametre çiftini kullanın. `Key` değerini `acs:rm:rgId` olarak, `Value` değerini ise bir kaynak grubunun kimliği olarak ayarlayın. `Key` değerini `acs:rm:rgId` olarak ayarlarsanız, `Value` değerini varsayılan olmayan bir kaynak grubunun kimliğine ayarlamanız gerekir. Value değerini varsayılan kaynak grubunun kimliğine ayarlarsanız bir hata mesajı döndürülür. `Key` değerini `acs:rm:rgId` olarak ayarlarsanız, başka Tag.N parametre çiftleri belirtemezsiniz. Kaynak gruplarını ve kaynakları aynı anda sorgulamak için birden fazla `Tag.N` parametre çifti belirtirseniz bir hata mesajı döndürülür.
Tag.N.Value	String	No	TestValue	ECS kaynaklarının tam eşleşme ile aranması için kullanılan N etiketinin değeri. Etiket değeri 1 ila 128 karakter uzunluğunda olmalıdır. N için geçerli değerler: 1 ile 20 arasında. Not Tag.1.Key değeri `acs:rm:rgId` olarak ayarlandığında, Tag.1.Value değerini yalnızca varsayılan olmayan bir kaynak grubunun kimliğine ayarlayabilirsiniz.
TagFilter.N.TagValues.N	String	No	TestTagFilter	ECS kaynaklarının bulanık arama ile aranması için kullanılan N etiketinin değeri. Etiket değeri 1 ila 128 karakter uzunluğunda olmalıdır. N için geçerli değerler: 1 ile 5 arasında. Daha fazla bilgi için `TagFilter.N.TagKey` açıklamasına bakın.
TagFilter.N.TagKey	String	No	env	ECS kaynaklarının bulanık arama ile aranması için kullanılan N etiketinin anahtarı. Etiket anahtarı 1 ila 128 karakter uzunluğunda olmalıdır. N için geçerli değerler: 1 ile 5 arasında. `TagFilter.N` parametre çifti (TagFilter.N.TagKey ve TagFilter.N.TagValues.N), belirtilen etiketlere sahip ECS kaynaklarını bulanık arama ile aramak için kullanılır. Belirtilen etiketlerde tek bir etiket anahtarı bir veya daha fazla etiket değerine karşılık gelebilir. Bulanık aramanın gecikme süresi 2 saniye olabilir. Bir bulanık arama, en fazla 5.000 kaynakla ilgili girişlerden oluşan bir sonuç kümesi döndürebilir. ECS kaynaklarını bulanık arama ile aramak için `TagFilter.N.TagKey` kullanırken, `TagFilter.N.TagValues.N` boş bırakılmalıdır. Örneğin, etiketleri `environment` etiket anahtarını içeren ECS kaynaklarını sorgulamak için ön ek araması yapmak üzere `TagFilter.1.TagKey` değerini `env`, içeren araması yapmak için `env` veya tam eşleşme araması yapmak için `env` olarak ayarlayabilir, ancak `TagFilter.1.TagValues` değerini boş bırakmanız gerekir. ECS kaynaklarını bulanık arama ile aramak için `TagFilter.N.TagValues.N` kullanırken, `TagFilter.N.TagKey` değerini tam bir değere ayarlamanız gerekir. Örneğin, `env` etiket anahtarı ve `product` etiket değerinden oluşan bir etikete sahip ECS kaynaklarını sorgulamak için `TagFilter.1.TagKey` değerini `env` olarak ayarlamalı ve ön ek araması yapmak için `TagFilter.1.TagValues.1` değerini `proc`, içeren araması yapmak için `proc` veya tam eşleşme araması yapmak için `proc` olarak ayarlayabilirsiniz. Her etiket anahtarı (`TagFilter.N.TagKey`) için yalnızca yukarıdaki arama yöntemlerinden biri kullanılabilir. Bir etiket anahtarı için birden fazla arama yöntemi yapılandırılırsa ilk arama yöntemi geçerli olur. Birden fazla etiket anahtarı belirtirseniz, yalnızca belirtilen tüm etiket anahtarlarına sahip olan ECS kaynakları döndürülür. Birden fazla etiket değerine karşılık gelen bir etiket anahtarı belirtirseniz, bu etiket anahtar-değer çiftlerinden birine veya daha fazlasına sahip olan tüm ECS kaynakları döndürülür. Not `TagFilter.N` parametre çifti (TagFilter.N.TagKey ve TagFilter.N.TagValues.N), `Tag.N` parametre çifti (Tag.N.Key ve Tag.N.Value) ile birlikte kullanılamaz. Aksi takdirde bir hata mesajı döndürülür.

Yanıt parametreleri

Parameter	Type	Example	Description
NextToken	String	caeba0bbb2be03f84eb48b699f0a4883	Sonraki sorgu için gerekli olan belirteç.
RequestId	String	484256DA-D816-44D2-9D86-B6EE4D5BA78C	İsteğin kimliği.
TagResources	Array of TagResource		Kaynak kimlikleri, kaynak türleri ve etiket anahtar-değer çiftleri dahil olmak üzere kaynaklar ve etiketler hakkında ayrıntılar.
TagResource
TagValue	String	TestValue	Kaynağın etiket değeri.
ResourceType	String	instance	Kaynak türü. Geçerli değerler: instance: ECS örneği disk: disk snapshot: anlık görüntü image: görüntü securitygroup: güvenlik grubu volume: depolama birimi eni: ENI ddh: özel ana bilgisayar ddhcluster: özel ana bilgisayar kümesi keypair: SSH anahtar çifti launchtemplate: başlatma şablonu reservedinstance: ayrılmış örnek snapshotpolicy: otomatik anlık görüntü ilkesi elasticityassurance: esneklik garantisi capacityreservation: kapasite rezervasyonu command: Cloud Assistant komutu invocation: Cloud Assistant komutu çalıştırma sonucu
ResourceId	String	i-bp1j6qtvdm8w0z1o****	Kaynak kimliği.
TagKey	String	TestKey	Etiket anahtarı.

Örnekler

Örnek istekler

http(s)://ecs.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=instance
&ResourceId.1=i-bp1j6qtvdm8w0z1o****
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

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

<ListTagResourcesResponse>
    <TagResources>
        <TagResource>
            <ResourceType>instance</ResourceType>
            <TagValue>TestValue</TagValue>
            <ResourceId>i-bp1j6qtvdm8w0z1o****</ResourceId>
            <TagKey>TestKey</TagKey>
        </TagResource>
    </TagResources>
    <RequestId>DE65F6B7-7566-4802-9007-96F2494AC512</RequestId>
</ListTagResourcesResponse>

JSON biçimi

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

{
  "TagResources" : {
    "TagResource" : [ {
      "ResourceType" : "instance",
      "TagValue" : "TestValue",
      "ResourceId" : "i-bp1j6qtvdm8w0z1o****",
      "TagKey" : "TestKey"
    } ]
  },
  "RequestId" : "DE65F6B7-7566-4802-9007-96F2494AC512"
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	InvalidDefaultResourceGroup.NotSupported	The specified parameter Tag is not support for default resource group.	Varsayılan kaynak grubu sorgulanamaz.
400	InvalidTag.NotSupported	You can only specify Tag for either resource tag or resource group.	Kaynak grupları ve etiketler aynı anda sorgulanamaz.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Etiket anahtarı zaten mevcut. Etiket anahtarları benzersiz olmalıdır.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Geçersiz Tag.N.Key değeri.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Geçersiz Tag.N.Value değeri.
400	OperationDenied.QuotaExceed	The quota of tags on resource is beyond permitted range.	Maksimum etiket sayısı aşıldı.
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	Tag.N.Key ve Tag.N.Value değerleri birbirine karşılık gelmiyor.
400	InvalidTagCount	The specified tags are beyond the permitted range.	Maksimum etiket sayısı aşıldı.
400	Invalid.Scope	The specified scope is invalid.	Geçersiz Scope değeri.
403	PermissionDenied.TagOwnerUid	The specified operator not have permission to set TagOwnerUid value.	TagOwnerUid parametresini belirtme yetkiniz yok.
403	PermissionDenied.Scope	The specified operator not have permission to set Scope value.	Scope parametresini belirtme yetkiniz yok.
403	InvalidResourceId.NotSupported	The specified ResourceId does not support tagging.	Belirtilen kaynak etiketlemeyi desteklemiyor.
403	NoPermission.Tag	The operator is not permission for the tag.	Etiketi yönetme yetkiniz yok.
404	InvalidRegionId.NotFound	%s	Belirtilen bölge kimliği bulunamadı.
404	MissingParameter.ResourceType	The parameter - ResourceType should not be null.	ResourceType gereklidir.
404	InvalidResourceId.NotFound	The specified ResourceIds are not found in our records.	Belirtilen kaynak kimliği bulunamadı. Kaynak kimliğinin doğru olup olmadığını kontrol edin.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	Belirtilen kaynak türü bulunamadı.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	Geçersiz RegionId değeri.
500	ServiceUnavailable	The service is unavailable, please try again later.	Hizmet geçici olarak kullanılamıyor. Daha sonra tekrar deneyin.
500	InternalError	The process of creating snapshot has failed due to some unknown error.	Anlık görüntü oluşturulamadı.

Hata kodlarının listesi için Hizmet hata kodları bölümüne bakın.