Formato de URL
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
.