REST Resource: organizations.locations.postures

리소스: 자세

상황의 세부정보입니다.

JSON 표현
{
  "name": string,
  "state": enum (State),
  "revisionId": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "policySets": [
    {
      object (PolicySet)
    }
  ],
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "reconciling": boolean,
  "categories": [
    enum (Category)
  ]
}
필드
name

string

(필수 항목) 식별자. organizations/{organization}/locations/global/postures/{postureId} 형식의 자세 이름입니다.

state

enum (State)

필수 입력란입니다. 지정된 revisionId의 자세 상태입니다.

revisionId

string

출력 전용입니다. 변경할 수 없습니다. 자세의 버전을 식별하는 불투명 8자리 문자열입니다. 상황에는 여러 버전이 있을 수 있습니다. 상황을 배포할 때는 상황의 특정 버전을 배포합니다.

createTime

string (Timestamp format)

출력 전용입니다. 자세가 생성된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 자세가 마지막으로 업데이트된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

description

string

선택사항입니다. 자세에 대한 설명입니다.

policySets[]

object (PolicySet)

필수 입력란입니다. 자세에 포함된 PolicySet 리소스입니다.

etag

string

선택사항입니다. 지정된 revisionId의 현재 버전 상태에 대한 불투명 식별자입니다.

동시 업데이트가 서로 덮어쓰는 것을 방지하려면 상태를 업데이트할 때 항상 etag를 제공하세요. 자세를 삭제할 때 etag를 제공하여 의도한 버전의 자세를 삭제할 수도 있습니다.

annotations

map (key: string, value: string)

선택사항입니다. 사용자가 지정한 자세 주석입니다.

주석에 사용할 수 있는 값에 관한 자세한 내용은 AIP-148: 표준 필드를 참고하세요.

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

reconciling

boolean

출력 전용입니다. 상황이 업데이트되는 중인지 여부입니다.

categories[]

enum (Category)

출력 전용입니다. Security Posture API에 의해 결정된 상태가 속한 카테고리입니다.

Posture의 상태입니다.

열거형
STATE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
DEPRECATED 이 상황은 지원 중단되었으며 더 이상 배포할 수 없습니다.
DRAFT 상황은 초안이며 배포할 준비가 되지 않았습니다.
ACTIVE 상황을 완료했으며 배포할 준비가 되었습니다.

메서드

create

Posture를 만듭니다.

delete

Posture의 모든 버전을 삭제합니다.

extract

조직, 폴더 또는 프로젝트에서 기존 정책을 추출하여 다른 조직, 폴더 또는 프로젝트에 Posture로 적용합니다.

get

Posture의 단일 버전을 가져옵니다.

list

지정된 조직 및 위치의 모든 Posture 리소스의 최신 버전을 나열합니다.

listRevisions

단일 Posture의 모든 버전을 나열합니다.

patch

기존 Posture의 버전을 업데이트합니다.