Formato de URL
Sugerir cambios
PDF
La estructura general de la URL utilizada para acceder a una instancia de recurso o a una colección a través de la API DE REST está compuesta por varios valores. Esta estructura refleja el modelo de objeto subyacente y el diseño del sistema.
La raíz de la ruta de recursos a cada extremo DE REST es la cuenta Astra. Por lo tanto, todas las rutas de la URL comienzan con /account/{account_id} donde account_id Es el valor único UUIDv4 de la cuenta. Estructura interna esto refleja un diseño en el que todo el acceso a los recursos se basa en una cuenta específica.
Los extremos de recursos de Astra se dividen en tres categorías diferentes:
-
Núcleo (
/core) -
Aplicación gestionada (
/k8s) -
Topología (
/topology)
Consulte "Recursos" si quiere más información.
Cada una de las tres categorías de recursos tiene una versión global que controla la versión de los recursos a los que se tiene acceso. Por convención y definición, pasar a una nueva versión principal de una categoría de recursos (como, por ejemplo, de /v1 para /v2) Introducirá cambios de ruptura en la API.
Se puede usar una combinación de tipos de recursos e identificadores en la ruta de acceso, en función de si se accede a una instancia de recurso o a una recopilación.
-
Ruta de recursos
En función de la estructura presentada anteriormente, una ruta típica a un punto final es:
/accounts/{account_id}/core/v1/users. -
Complete la dirección URL
La dirección URL completa del punto final correspondiente es:
https://astra.netapp.io/accounts/{account_id}/core/v1/users.