REST Resource: organizations.locations.postures

Ressource: Körperhaltung

Die Details einer Haltung.

JSON-Darstellung 
{
  "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)
  ]
}
Felder
name

string

Erforderlich. Kennung. Der Name der Körperhaltung im Format organizations/{organization}/locations/global/postures/{postureId}.
state

enum (State)

Pflichtangabe. Der Status der Haltung an der angegebenen revisionId.
revisionId

string

Nur Ausgabe. Nicht veränderbar. Ein undurchsichtiger String mit acht Zeichen, der die Überarbeitung der Haltung identifiziert. Ein Status kann mehrere Versionen haben. Wenn Sie einen Status bereitstellen, stellen Sie eine bestimmte Version des Status bereit.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Körperhaltung erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Position zuletzt aktualisiert wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
description

string

Optional. Eine Beschreibung der Haltung.
policySets[]

object (PolicySet)

Pflichtangabe. Die PolicySet-Ressourcen, die die Position enthalten.
etag

string

Optional. Eine intransparente Kennung für die aktuelle Version der Haltung an der angegebenen revisionId.

Damit verhindert wird, dass sich gleichzeitige Aktualisierungen gegenseitig überschreiben, geben Sie beim Aktualisieren einer Haltung immer die etag an. Sie können die etag auch angeben, wenn Sie eine Haltung löschen, um sicherzustellen, dass Sie die gewünschte Version der Haltung löschen.
annotations

map (key: string, value: string)

Optional. Die vom Nutzer angegebenen Anmerkungen zur Haltung.

Weitere Informationen zu den Werten, die Sie in einer Anmerkung verwenden können, finden Sie unter AIP-148: Standardfelder.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
reconciling

boolean

Nur Ausgabe. Gibt an, ob der Sicherheitsstatus gerade aktualisiert wird.
categories[]

enum (Category)

Nur Ausgabe. Die Kategorien, zu denen die Position gehört, wie von der Security Posture API bestimmt.

Bundesland

Der Status einer Posture.

Enums
STATE_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
DEPRECATED Der Status wurde eingestellt und kann nicht mehr bereitgestellt werden.
DRAFT Der Status ist ein Entwurf und die Bereitstellung ist noch nicht möglich.
ACTIVE Die Bewertung ist abgeschlossen und die Bereitstellung kann erfolgen.

Methoden

create

 Erstellt einen neuen Posture

delete

 Alle Überarbeitungen einer Posture werden gelöscht.

extract

 Hiermit werden vorhandene Richtlinien aus einer Organisation, einem Ordner oder einem Projekt extrahiert und als Posture auf eine andere Organisation, einen anderen Ordner oder ein anderes Projekt angewendet.

get

 Ruft eine einzelne Version eines Posture ab.

list

 Listet die neuesten Versionen aller Posture-Ressourcen in einer bestimmten Organisation und an einem bestimmten Standort auf.

listRevisions

 Listet alle Versionen einer einzelnen Posture auf.

patch

 Aktualisiert eine Version einer vorhandenen Buchung (Posture).