Method: organizations.assets.list

조직의 애셋을 나열합니다.

HTTP 요청


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

경로 매개변수

매개변수
parent

string

필수 입력란입니다. 저작물이 속한 조직의 이름입니다. 형식은 'organizations/[organization_id]'입니다.

쿼리 매개변수

매개변수
filter

string

애셋 전체에 적용할 필터를 정의하는 표현식입니다. 이 표현식은 논리 연산자 AND 및 OR를 통해 결합된 0개 이상의 제한사항 목록입니다. 괄호는 지원되지 않으며 OR의 우선순위가 AND보다 높습니다.

제약조건은 <field> <operator> <value> 형식이며 앞에 - 문자가 있어 부정을 나타낼 수 있습니다. 이 필드는 저작물 리소스에 정의된 필드에 매핑됩니다. 예를 들면 다음과 같습니다.

  • name
  • securityCenterProperties.resource_name
  • resourceProperties.a_property
  • securityMarks.marks.marka

지원되는 연산자는 다음과 같습니다.

  • 모든 값 유형의 경우 =입니다.
  • 정수 값: >, <, >=, <=
  • :: 문자열의 하위 문자열 일치를 의미합니다.

지원되는 값 유형은 다음과 같습니다.

  • 문자열 리터럴을 따옴표로 묶습니다.
  • 따옴표가 없는 정수 리터럴
  • 따옴표가 없는 불리언 리터럴 true 및 false

예를 들어 resourceProperties.size = 100은 유효한 필터 문자열입니다.
orderBy

string

정렬에 사용할 필드와 순서를 정의하는 표현식입니다. 문자열 값은 SQL 구문, 즉 쉼표로 구분된 필드 목록을 따라야 합니다. 예: 'name,resourceProperties.a_property' 기본 정렬 순서는 오름차순입니다. 필드에서 내림차순으로 지정하려면 서픽스 ' desc'를 필드 이름에 추가해야 합니다. 예를 들어 'name desc,resourceProperties.a_property'와 같이 지정합니다. 구문에서 중복되는 공백 문자는 중요하지 않습니다. 'name desc,resourceProperties.a_property'와 'name desc , resourceProperties.a_property'는 동일합니다.
readTime

string (Timestamp format)

확장 소재를 필터링할 때 참조점으로 사용되는 시간입니다. 필터는 제공된 시간에 존재하는 애셋으로 제한되며 값은 해당 시간의 값입니다. 이 필드가 없으면 기본값은 API의 NOW 버전입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
compareDuration

string (Duration format)

compareDuration이 설정되면 ListAssetResult의 'state' 속성이 업데이트되어 readTime 이전의 compareDuration 기간 동안 애셋이 추가, 삭제 또는 유지되었는지 나타냅니다. (readTime - compareDuration)과 readTime 사이의 시간입니다.

상태 값은 두 시점의 애셋 존재 여부에 따라 파생됩니다. 두 시점 사이의 중간 상태 변경은 결과에 영향을 미치지 않습니다. 예를 들어 애셋을 삭제했다가 다시 만들면 결과는 영향을 받지 않습니다.

compareDuration이 지정된 경우 가능한 'state' 값:

  • 'ADDED': 애셋이 compareDuration 전에 존재하지 않았지만 readTime에 존재함을 나타냅니다.
  • 'REMOVED': 애셋이 compareDuration의 시작 부분에는 있었지만 readTime에는 없다는 것을 나타냅니다.
  • 'ACTIVE': 애셋이 compareDuration 및 readTime으로 정의된 기간의 시작과 종료 시점 모두에 있었음을 나타냅니다.

compareDuration을 지정하지 않으면 가능한 유일한 상태는 'UNUSED'이며, 이는 애셋이 readTime에 있음을 나타냅니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
fieldMask

string (FieldMask format)

선택사항입니다. 응답에 표시할 ListAssetsResult 필드를 지정하는 필드 마스크입니다. 필드 마스크가 비어 있으면 모든 필드가 표시됩니다.
pageToken

string

마지막 ListAssetsResponse에서 반환한 값입니다. 이 값은 이전 assets.list 호출의 연속이며 시스템에서 다음 데이터 페이지를 반환해야 함을 나타냅니다.
pageSize

integer

단일 응답에서 반환할 최대 결과 수입니다. 기본값은 10, 최소는 1, 최대는 1,000입니다.

요청 본문

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

응답 본문

확장 소재를 나열하기 위한 응답 메시지입니다.

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

JSON 표현 
{
  "listAssetsResults": [
    {
      object (ListAssetsResult)
    }
  ],
  "readTime": string,
  "nextPageToken": string,
  "totalSize": integer
}
필드
listAssetsResults[]

object (ListAssetsResult)

목록 요청과 일치하는 확장 소재입니다.
readTime

string (Timestamp format)

목록 요청을 실행하는 데 사용된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰으로, 결과가 더 이상 없으면 비어 있습니다.
totalSize

integer

쿼리와 일치하는 저작물의 총 개수입니다.

승인 범위

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

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

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

ListAssetsResult

확장 소재 및 상태가 포함된 결과입니다.

JSON 표현 
{
  "asset": {
    object (Asset)
  },
  "state": enum (State)
}
필드
asset

object (Asset)

검색 요청과 일치하는 확장 소재입니다.
state

enum (State)

확장 소재의 상태입니다.

애셋

Google Cloud 리소스의 Security Command Center 표현입니다.

애셋은 단일 Google Cloud 리소스에 대한 정보를 캡처하는 Security Command Center 리소스입니다. 애셋의 모든 수정사항은 Security Command Center의 컨텍스트 내에서만 적용되며 참조된 Google Cloud 리소스에 영향을 미치지 않습니다.

JSON 표현 
{
  "name": string,
  "securityCenterProperties": {
    object (SecurityCenterProperties)
  },
  "resourceProperties": {
    string: value,
    ...
  },
  "securityMarks": {
    object (SecurityMarks)
  },
  "createTime": string,
  "updateTime": string
}
필드
name

string

이 애셋의 상대 리소스 이름입니다. https://cloud.google.com/apis/design/resource_names#relative_resource_name을 참고하세요. 예: 'organizations/{organization_id}/assets/{asset_id}'.
securityCenterProperties

object (SecurityCenterProperties)

Security Command Center에서 관리하는 속성 이러한 속성은 Security Command Center에서 관리하며 사용자는 수정할 수 없습니다.
resourceProperties

map (key: string, value: value (Value format))

리소스 관리 속성 이러한 속성은 Google Cloud 리소스에서 관리하고 정의하며 사용자는 수정할 수 없습니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
securityMarks

object (SecurityMarks)

사용자가 지정한 보안 표시 이러한 마크는 사용자가 전적으로 관리하며 애셋에 속한 SecurityMarks 리소스에서 가져옵니다.
createTime

string (Timestamp format)

Security Command Center에서 애셋이 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

Security Command Center에서 애셋이 마지막으로 업데이트, 추가 또는 삭제된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

SecurityCenterProperties

Security Command Center에서 관리하는 속성 이러한 속성은 Security Command Center에서 관리하며 사용자는 수정할 수 없습니다.

JSON 표현 
{
  "resourceName": string,
  "resourceType": string,
  "resourceParent": string,
  "resourceProject": string,
  "resourceOwners": [
    string
  ]
}
필드
resourceName

string

변경할 수 없습니다. 이 애셋이 나타내는 Google Cloud 리소스의 전체 리소스 이름입니다. 이 필드는 생성 시간 후에는 변경할 수 없습니다. https://cloud.google.com/apis/design/resource_names#full_resource_name를 참고하세요.
resourceType

string

Google Cloud 리소스의 유형입니다. APPLICATION, PROJECT, ORGANIZATION 등이 여기에 해당합니다. 이 필드는 Security Command Center 또는 리소스 제작자가 정의한 대소문자 구분되지 않는 필드이며 생성 시간 이후에는 변경할 수 없습니다.
resourceParent

string

리소스의 바로 상위 요소의 전체 리소스 이름입니다. https://cloud.google.com/apis/design/resource_names#full_resource_name를 참고하세요.
resourceProject

string

리소스가 속한 프로젝트의 전체 리소스 이름입니다. https://cloud.google.com/apis/design/resource_names#full_resource_name를 참고하세요.
resourceOwners[]

string

Google Cloud 리소스의 소유자

주

확장 소재의 상태입니다.

두 시점 간에 쿼리할 때 이 속성은 두 시점 간의 변경사항(ADDED, REMOVED, ACTIVE)을 나타냅니다. 요청에 compareDuration이 제공되지 않은 경우 상태는 UNUSED여야 합니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태.
UNUSED 요청에서 결과에 이 필드의 사용을 지정하지 않았습니다.
ADDED 두 시점 사이에 확장 소재가 추가되었습니다.
REMOVED 두 시점 사이에 저작물이 삭제되었습니다.
ACTIVE 두 시점에서 모두 확장 소재가 활성 상태였습니다.