ListObjects - - Alibaba Cloud Dokümantasyon Merkezi

Bir kovadaki tüm nesnelerle ilgili bilgileri sorgular.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ens:ListObjects

list

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
BucketName	string	Yes	Kovanın adı.	test
EncodingType	string	No	Yanıttaki nesne adlarının kodlama türü. Yalnızca URL kodlaması desteklenir.	url
Marker	string	No	Liste işleminin başladığı konum. Bu parametre belirtilirse, adları alfabetik olarak Marker değerinden büyük olan nesneler döndürülür. Marker parametresi, döndürülen nesneleri sayfalamak için kullanılır ve değerinin uzunluğu 1.024 bayttan küçük olmalıdır. Koşullu bir sorgu sırasında Marker için belirtilen değer listede mevcut olmasa bile, liste adı alfabetik olarak Marker değerinden büyük olan nesneden başlar.	a
MaxKeys	integer	No	Döndürülecek maksimum nesne sayısı. Geçerli değerler: 0 ile 1000 arası. Varsayılan değer: 100.	100
Prefix	string	No	Listelemek istediğiniz nesnelerin adlarında bulunması gereken ön ek. Nesneleri sorgulamak için bir ön ek belirtirseniz, döndürülen nesne adları bu ön eki içerir. Parametrenin değerinin uzunluğu 1.000 bayttan az olmalıdır.	b
ContinuationToken	string	No	Bu liste işleminde kullanılan belirteç. Nesne sayısı MaxKeys değerini aşarsa, yanıtta bir sonraki liste işlemi için belirteç olarak NextContinuationToken yer alır.	test1.txt
StartAfter	string	No	Liste işleminin başladığı konum. Bu parametre belirtilirse, adları alfabetik olarak StartAfter değerinden büyük olan nesneler döndürülür. StartAfter parametresi, döndürülen nesneleri sayfalamak için kullanılır ve değerinin uzunluğu 1.000 bayttan az olmalıdır. Koşullu bir sorgu sırasında StartAfter için belirtilen değer listede mevcut olmasa bile, liste adı alfabetik olarak StartAfter değerinden büyük olan nesneden başlar.	b

Response elements

Element	Type	Description	Example
	object
CommonPrefixes	array	İstekte delimiter parametresi belirtilmişse, yanıt CommonPrefixes öğesini içerir. Adlarında, ön ekten ayırıcının bir sonraki görünümüne kadar olan aynı dizeyi içeren nesneler, CommonPrefixes içinde tek bir sonuç öğesi olarak gruplandırılır.	Not applicable
	string	İstekte delimiter parametresi belirtilmişse, yanıt CommonPrefixes öğesini içerir. Adlarında, ön ekten ayırıcının bir sonraki görünümüne kadar olan aynı dizeyi içeren nesneler, CommonPrefixes içinde tek bir sonuç öğesi olarak gruplandırılır.	不涉及
NextContinuationToken	string	Bir sonraki liste işleminde kullanılan belirteç.	CgJiYw--
ContinuationToken	string	Bu liste işleminde kullanılan belirteç.	test1.txt
Delimiter	string	Nesneleri ada göre gruplandırmak için kullanılan karakter.	/
EncodingType	string	Yanıttaki nesne adlarının kodlama türü.	不涉及
Prefix	string	Döndürülen nesnelerin adlarında bulunan ön ek.	b
Marker	string	Liste işleminin başladığı konum.	ceshi.txt1617853707991
BucketName	string	Kovanın adı.	test
Contents	array<object>	Nesne üst verilerinin listesi.
	object
Key	string	Nesnenin adı.	ceshi.txt1617853706546
LastModified	string	Nesnenin en son değiştirildiği zaman.	2021-04-08T03:48:47.488Z
ETag	string	Varlık etiketi (ETag). Bir nesne oluşturulduğunda, nesnenin içeriğini tanımlamak için bir ETag oluşturulur. PutObject işlemi çağrılarak oluşturulan bir nesne için, nesnenin ETag değeri nesne içeriğinin MD5 karmasıdır. PutObject işlemi çağrılarak oluşturulmayan bir nesne için, nesnenin ETag değeri nesne içeriğinin UUID'sidir. Bir nesnenin ETag değeri, nesne içeriğinin değiştirilip değiştirilmediğini kontrol etmek için kullanılabilir. Ancak, veri bütünlüğünü doğrulamak için nesnenin ETag değeri yerine nesnenin MD5 karmasını kullanmanızı öneririz.	5B3C1A2E053D763E1B002CC607C5****
Size	integer	Döndürülen nesnenin boyutu. Birim: bayt.	15
IsTruncated	boolean	Listelenen nesnelerin kırpılıp kırpılmadığını gösterir. Geçerli değerler: false true	true
KeyCount	integer	Bu istek için döndürülen anahtar sayısı.	10
NextMarker	string	Bir sonraki liste işleminin başladığı konum.	ceshi.txt1617853707991
MaxKeys	integer	Döndürülen maksimum nesne sayısı.	10
RequestId	string	İsteğin kimliği.	4833C4AC-9396-458C-8F25-1D701334E560

Examples

Success response

JSON format

{
  "CommonPrefixes": [
    "不涉及"
  ],
  "NextContinuationToken": "CgJiYw--",
  "ContinuationToken": "test1.txt",
  "Delimiter": "/",
  "EncodingType": "Not applicable",
  "Prefix": "b",
  "Marker": "ceshi.txt1617853707991",
  "BucketName": "test",
  "Contents": [
    {
      "Key": "ceshi.txt1617853706546",
      "LastModified": "2021-04-08T03:48:47.488Z",
      "ETag": "5B3C1A2E053D763E1B002CC607C5****",
      "Size": 15
    }
  ],
  "IsTruncated": true,
  "KeyCount": 10,
  "NextMarker": "ceshi.txt1617853707991",
  "MaxKeys": 10,
  "RequestId": "4833C4AC-9396-458C-8F25-1D701334E560"
}

Error codes

HTTP status code	Error code	Error message	Description
400	Invalid%s	Specified parameter %s is not valid
400	InvalidBucketName	Specified parameter BucketName is not valid.	The specified BucketName parameter is invalid.
400	InvalidPrefix	Specified parameter Prefix is not valid.
400	InvalidStartAfter	Specified parameter StartAfter is not valid.
400	InvalidMarker	Specified parameter Marker is not valid.
400	InvalidDelimiter	Specified parameter Delimiter is not valid.
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.
400	InvalidArgument	Specified parameter ContinuationToken is incorrect.	The ContinuationToken parameters set are incorrect.
500	InternalError	The request processing has failed due to some unknown error.
403	AccessDenied	auth is not valid
403	UserDisable	The user has been disabled due to arrears.	The user has been disabled due to arrears.
404	NoSuchBucket	The specified bucket does not exist.	The requested bucket does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.