Method: projects.locations.hardware.list

특정 프로젝트와 위치의 하드웨어를 나열합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 하드웨어를 나열할 프로젝트 및 위치입니다. 형식: projects/{project}/locations/{location}

모든 위치의 하드웨어를 나열하려면 위치를 - (하이픈 또는 대시 문자)으로 대체하고 응답 메시지에서 도달할 수 없는 필드를 확인합니다.

쿼리 파라미터

파라미터
pageSize

integer

(선택사항) 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

pageToken

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 필터링 조건입니다. AIP-160을 참조하세요.

orderBy

string

선택사항입니다. 결과를 정렬하는 방법에 대한 힌트입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

하드웨어 목록입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "hardware": [
    {
      object (Hardware)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
필드
hardware[]

object (Hardware)

하드웨어 목록입니다.

nextPageToken

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다. 와일드 카드 위치 -에 대한 쿼리에만 사용됩니다. 비어 있지 않으면 결과가 불완전함을 나타냅니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardware.list

자세한 내용은 IAM 문서를 참조하세요.