Create an AgentStorage instance - Tablestore API - Tablestore

Limites

Chaque compte Alibaba Cloud peut disposer d'un maximum de 10 instances AgentStorage. Les noms des instances doivent être uniques au sein de chaque région.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Un compte Alibaba Cloud avec une paire AccessKey pour signer les requêtes OpenAPI du plan de contrôle
Des permissions de gestion AgentStorage, telles que AliyunOTSFullAccess ou une politique équivalente du plan de contrôle, accordées au compte Alibaba Cloud ou à l'utilisateur Resource Access Management (RAM)

Syntaxe de la requête

POST /v2/openapi/createagentstorage HTTP/1.1

Paramètres de la requête

Parameter

Type

Required

Description

AgentStorageName

string

Yes

Le nom de l'instance. Le nom doit comporter entre 3 et 16 caractères, commencer par une lettre et contenir uniquement des lettres, des chiffres et des traits d'union (-). Le nom n'est pas sensible à la casse et ne peut pas se terminer par un trait d'union (-). Il ne peut pas contenir ali, ay, ots, taobao ni admin.

AgentStorageDescription

string

No

La description de l'instance. La description doit comporter entre 3 et 256 caractères.

ResourceGroupId

string

No

L'ID du groupe de ressources.

NetworkTypeACL

array<string>

No

Les types de réseau autorisés. Valeurs valides : CLASSIC, INTERNET et VPC. Si vous ne spécifiez pas ce paramètre, tous les types de réseau sont autorisés.

NetworkSourceACL

array<string>

No

Les sources réseau autorisées. TRUST_PROXY spécifie la console. Si vous ne spécifiez pas ce paramètre, toutes les sources réseau sont autorisées.

Policy

string

No

La politique de contrôle d'accès de l'instance au format JSON.

Tags

array<object>

No

Les tags à ajouter à l'instance. Chaque tag doit contenir une Key et une Value. Chacun peut comporter jusqu'à 64 caractères.

Exemple de requête

{
  "AgentStorageName": "agent-prod",
  "AgentStorageDescription": "Production storage for AI agents",
  "ResourceGroupId": "rg-example",
  "NetworkTypeACL": ["INTERNET", "VPC"],
  "Tags": [
    {"Key": "Environment", "Value": "production"}
  ]
}

Éléments de réponse

Parameter

Type

Description

RequestId

string

L'ID de la requête.

Code

string

Le code d'état de la réponse.

Message

string

Le message de réponse.

Exemple de réponse

{
  "RequestId": "18DD77BF-F967-576D-80D1-79121399AB53",
  "Code": "200",
  "Message": "success"
}

Une fois la requête réussie, interrogez l'instance AgentStorage en appelant GetAgentStorage jusqu'à ce que AgentStorageStatus soit normal. Vous pouvez ensuite créer des bases de connaissances ou des magasins de mémoire.