Method: projects.assets.list

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

string

필수 입력란입니다. 애셋이 포함된 상위 리소스의 이름입니다. 상위에서 지정할 수 있는 값은 상위를 지정하는 방법에 따라 다릅니다. organizations/[organization_id], folders/[folder_id], projects/[projectId] 중 하나를 지정할 수 있습니다.

string

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

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

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

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

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

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

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

다음은 허용되는 필드 및 연산자 조합입니다.

• 이름: =
• updateTime: =, >, <, >=, <=

사용법: 에포크 이후 밀리초 또는 RFC3339 문자열이어야 합니다. 예: updateTime = "2019-06-10T16:07:18-07:00" updateTime = 1560208038000

• createTime: =, >, <, >=, <=

사용법: 에포크 이후 밀리초 또는 RFC3339 문자열이어야 합니다. 예: createTime = "2019-06-10T16:07:18-07:00" createTime = 1560208038000

• iamPolicy.policy_blob: =, :
• resourceProperties: =, :, >, <, >=, <=
• securityMarks.marks: =, :
• securityCenterProperties.resource_name: =, :
• securityCenterProperties.resource_display_name: =, :
• securityCenterProperties.resource_type: =, :
• securityCenterProperties.resource_parent: =, :
• securityCenterProperties.resource_parent_display_name: =, :
• securityCenterProperties.resource_project: =, :
• securityCenterProperties.resource_project_display_name: =, :
• securityCenterProperties.resource_owners: =, :

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

빈 문자열에 부분 일치를 사용하여 기존 속성을 기반으로 필터링합니다. resourceProperties.my_property : ""

빈 문자열에 대한 부정 부분 일치를 사용하여 존재하지 않는 속성을 기반으로 필터링합니다. -resourceProperties.my_property : ""

string

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

다음 필드가 지원됩니다. name updateTime resourceProperties securityMarks.marks securityCenterProperties.resource_name securityCenterProperties.resource_display_name securityCenterProperties.resource_parent securityCenterProperties.resource_parent_display_name securityCenterProperties.resource_project securityCenterProperties.resource_project_display_name securityCenterProperties.resource_type

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"입니다.

string (Duration format)

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

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

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

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

compareDuration을 지정하지 않으면 가능한 유일한 stateChange는 'UNUSED'이며, 이는 readTime에 있는 모든 애셋에 설정된 stateChange입니다.

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

string (FieldMask format)

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

string

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

integer

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