Method: projects.locations.datastores.list

Enumera los recursos Datastore en una ubicación y un proyecto determinados.

Solicitud HTTP

GET https://vmwareengine.googleapis.com/v1/{parent=projects/*/locations/*}/datastores

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso de la ubicación para la que se consultan los almacenes de datos. Los nombres de recursos son URIs sin esquema que siguen las convenciones que se indican en https://cloud.google.com/apis/design/resource_names. Por ejemplo: projects/my-project/locations/us-central1.

La autorización requiere el siguiente permiso de IAM en el recurso especificado parent:

  • vmwareengine.datastores.list

Parámetros de consulta

Parámetros
pageSize

integer

Es opcional. Es la cantidad máxima de resultados que se devolverán en una página. El valor máximo se convierte a 1,000. El valor predeterminado de este campo es 500.

pageToken

string

Es opcional. Un token de página, recibido desde una llamada datastores.list anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a datastores.list deben coincidir con la llamada que proporcionó el token de la página.

filter

string

Es opcional. Es una expresión de filtro que coincide con los recursos que se muestran en la respuesta. La expresión debe especificar el nombre del campo, un operador de comparación y el valor que deseas usar para el filtrado. El valor debe ser una cadena, un número o un valor booleano. El operador de comparación debe ser =, !=, > o <.

Por ejemplo, si filtras una lista de almacenes de datos, puedes excluir los que se llamen example-datastore especificando name != "example-datastore".

Para filtrar en función de varias expresiones, proporciona cada expresión separada entre paréntesis. Por ejemplo:

(name = "example-datastore")
(createTime > "2021-04-12T08:15:10.40Z")

De forma predeterminada, cada expresión es una expresión AND. Sin embargo, puedes incluir expresiones AND y OR de forma explícita. Por ejemplo:

(name = "example-datastore-1") AND
(createTime > "2021-04-12T08:15:10.40Z") OR
(name = "example-datastore-2")
orderBy

string

Es opcional. Ordena los resultados de la lista según un orden determinado. De forma predeterminada, los resultados que se muestran se ordenan por name en orden ascendente. También puedes ordenar los resultados en orden descendente según el valor de name con orderBy="name desc". Actualmente, solo se admite el ordenamiento por name.

requestId

string

Es opcional. El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000).

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para VmwareEngine.ListDatastores

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "datastores": [
    {
      object (Datastore)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
datastores[]

object (Datastore)

Es una lista de almacenes de datos.

nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

unreachable[]

string

Recursos inaccesibles.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.