Method: projects.locations.sites.list

Muestra los sitios en un proyecto y una ubicación determinados.

Solicitud HTTP

GET https://gdchardwaremanagement.googleapis.com/v1alpha/{parent=projects/*/locations/*}/sites

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. El proyecto y la ubicación en los que se enumerarán los sitios. Formato: projects/{project}/locations/{location}

Para enumerar sitios en todas las ubicaciones, sustituye - (el carácter de guion o guion corto) por la ubicación y verifica el campo inalcanzable en el mensaje de respuesta.

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.
pageToken

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.
filter

string

Opcional. Condición de filtrado. Consulta AIP-160.
orderBy

string

Opcional. Es una sugerencia sobre cómo ordenar los resultados.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Una lista de sitios.

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

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

object (Site)

La lista de sitios.
nextPageToken

string

Un token que identifica una página de resultados que el servidor debe devolver.
unreachable[]

string

Lista sin ordenar. Ubicaciones a las que no se pudo llegar. Solo se usa para consultas a la ubicación comodín -. Si no está vacío, indica que los resultados están incompletos.

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.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.sites.list

Para obtener más información, consulta la documentación de IAM.