Tüm Ürünler
Search

Bu Ürün

    :DescribeAgenticSpaces

    Belge Merkezi

    :DescribeAgenticSpaces

    Son Güncelleme:Oct 13, 2026

    Agentic alanlarını sorgular.

    Operation description

    Agentic dosya sistemleri için geçerlidir.

    Başlamadan önce

    Bu işlemi çağırmadan önce kaynakları aşağıdaki sırayla oluşturun:

    1. Agentic dosya sistemi oluşturma: Bir dosya sistemi oluşturmak için CreateFileSystem işlemini çağırırken aşağıdaki parametreleri ayarlayın:

      • StorageType: Agentic olarak ayarlayın.

      • ProtocolType: NFS olarak ayarlayın.

      • Desteklenen bölgeler: Agentic depolama türü yalnızca belirli bölgelerde ve alanlarda kullanılabilir. Daha fazla bilgi için konsola bakın.

    2. Agentic alan listesini sorgulama: Dosya sistemi oluşturulduktan ve durumu Running olarak değiştikten sonra, dosya sistemindeki Agentic alanlarını sorgulamak için DescribeAgenticSpaces işlemini çağırın.

      • Dosya sisteminde Agentic alanları oluşturulmuşsa, listenin tamamı döndürülür.

      • Dosya sisteminde hiçbir Agentic alanı oluşturulmamışsa, boş bir liste döndürülür.

    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

    nas:DescribeAgenticSpaces

    list

    *Dosya Sistemi.

    acs:nas:{#regionId}:{#accountId}:filesystem/{#FileSystemId}

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    FileSystemId

    string

    Yes

    Dosya sisteminin kimliği.

    1ca404****
    Filters

    array<object>

    No

    Filtre anahtarları koleksiyonu.

    object

    No

    Filtre anahtarı.

    Key

    string

    No

    Filtre anahtarının adı. Geçerli değerler:

    • AgenticSpaceIds

    Valid values:

    • AgenticSpaceIds :

      Agentic alan kimlikleri koleksiyonu için filtre adı.

    AgenticSpaceIds
    Value

    string

    No

    Filtre anahtarının değeri. Bu parametre joker karakterleri desteklemez.

    • AgenticSpaceIds: Yalnızca bir kimlik desteklenir.

    06229oypxjgox0u****
    NextToken

    string

    No

    Sayfalandırma belirteci. Bu parametreyi, önceki çağrıdan döndürülen NextToken değerine ayarlayın.

    MTc3OTkzNTA0Mjg0NTc1MDI4OCM0MDQ0MzA****=
    MaxResults

    integer

    No

    Çağrı başına döndürülecek maksimum sonuç sayısı.

    Geçerli değerler: 10 ile 100 arası. Varsayılan değer: 20.

    20

    Response elements

    Element

    Type

    Description

    Example

    object

    AgenticSpaces

    object

    AgenticSpace

    array<object>

    Agentic alan bilgileri.

    array<object>

    Agentic alan bilgileri.

    AgenticSpaceId

    string

    AgenticSpace kimliği.

    agentic-229oypxjgpau2****
    Azone

    string

    Bölge kimliği.

    cn-hangzhou-i
    CreateTimeUtc

    string

    Agentic alanının oluşturulduğu zaman. Zaman UTC olarak görüntülenir ve yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını takip eder.

    2026-06-10T10:08:08Z
    Description

    string

    Agentic alanının açıklaması.

    Description
    FileCountUsage

    integer

    Kullanılan dosya sayısı.

    100
    FileSystemId

    string

    Dosya sisteminin kimliği.

    0322djegiekcia5****
    FileSystemPath

    string

    Mutlak dosya yolu.

    /test/
    Quota

    object

    Kota bilgileri.

    FileCountLimit

    integer

    Kota için dosya sayısı sınırı. Geçerli değerler:

    • Minimum değer: 10.000.

    • Maksimum değer: 100.000.000.

    10000000
    SizeLimit

    integer

    Kota için toplam kapasite sınırı. Birim: bayt.

    Geçerli değerler:

    • Minimum değer: 10.737.418.240 (10 GiB).

    • Maksimum değer: 1.099.511.627.776.000 (1.024.000 GiB).

    • Adım: 1.073.741.824 (1 GiB).

    10737418240
    SpaceUsage

    integer

    Kullanılan kapasite. Birim: bayt.

    1024
    Status

    string

    Agentic alanının durumu. Geçerli değerler:

    • Running

    Running
    UpdateTimeUtc

    string

    Agentic alanının güncellendiği zaman. Zaman UTC olarak görüntülenir ve yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını takip eder.

    2026-06-10T10:08:08Z
    NextToken

    string

    Sayfalandırma belirteci. Bu parametreyi, önceki çağrıdan döndürülen NextToken değerine ayarlayın.

    MTc2NTg1MTUyMzA1OTczNTc1OCM0NjQxMzQ****=
    RequestId

    string

    İstek kimliği.

    BC7C825C-5F65-4B56-BEF6-98C56C7C****

    Examples

    Success response

    JSON format

    {
  "AgenticSpaces": {
    "AgenticSpace": [
      {
        "AgenticSpaceId": "agentic-229oypxjgpau2****",
        "Azone": "cn-hangzhou-i",
        "CreateTimeUtc": "2026-06-10T10:08:08Z",
        "Description": "Description",
        "FileCountUsage": 100,
        "FileSystemId": "0322djegiekcia5****",
        "FileSystemPath": "/test/",
        "Quota": {
          "FileCountLimit": 10000000,
          "SizeLimit": 10737418240
        },
        "SpaceUsage": 1024,
        "Status": "Running",
        "UpdateTimeUtc": "2026-06-10T10:08:08Z"
      }
    ]
  },
  "NextToken": "MTc2NTg1MTUyMzA1OTczNTc1OCM0NjQxMzQ****=",
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalCharacters The parameter contains illegal characters. Geçersiz parametre.
    400 MissingFileSystemId FileSystemId is mandatory for this action. FileSystemId parametresi belirtilmedi.
    400 InvalidParameter.SortOrder Invalid sort order. SortOrder parametresi geçersizdir.
    400 InvalidParameter.SortOrderField Invalid sort order field. SortOrderField parametresi geçersizdir.
    400 InvalidFilesystemType.NotSupport The API operation does not support the file system type. Geçerli işlem bu dosya sistemi türünü desteklemez.
    403 OperationDenied.FilesetNotSupported The operation is not supported. Dosya sistemi Fileset'i desteklemez.
    404 InvalidFileSystem.NotFound The specified file system does not exist. Belirtilen dosya sistemi mevcut değil.
    404 InvalidFilterParam The specified Filter.N.Key is invalid. Belirtilen Filter.N.Key parametresi geçersizdir.
    404 InvalidFilterValue The specified Filter.N.Value is invalid. Filter.1.Value değeri geçersizdir.
    404 InvalidParameter.InvalidNextToken The specified NextToken is invaild.
    404 InvalidParameter.InvalidMaxResults The specified MaxResults is invalid. Belirtilen MaxResults geçersizdir.
    404 InvalidAgenticSpace.NotFound The specified AgenticSpace is not found. Belirtilen AgenticSpace bulunamadı.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.