REST Resource: organizations.locations.postureDeployments

Ressource: PostureDeployment

Details zu einer Posture-Bereitstellung für eine Organisation, einen Ordner oder ein Projekt.

Sie können für jede Organisation, jeden Ordner oder jedes Projekt maximal eine Posture bereitstellen. Die übergeordnete Ressource für eine Bereitstellung der Gerätesicherheit ist immer die Organisation, auch wenn die Bereitstellung auf einen Ordner oder ein Projekt angewendet wird.

JSON-Darstellung 
{
  "name": string,
  "targetResource": string,
  "state": enum (State),
  "postureId": string,
  "postureRevisionId": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "reconciling": boolean,
  "desiredPostureId": string,
  "desiredPostureRevisionId": string,
  "failureMessage": string,
  "categories": [
    enum (Category)
  ]
}
Felder
name

string

Erforderlich. Kennung. Der Name der Bereitstellung der Gerätesicherheit im Format organizations/{organization}/locations/global/postureDeployments/{deployment_id}.
targetResource

string

Pflichtangabe. Die Organisation, der Ordner oder das Projekt, in dem die Bewertung bereitgestellt wird. Verwendet eines der folgenden Formate:

  • organizations/{organization_number}
  • folders/{folder_number}
  • projects/{project_number}
state

enum (State)

Nur Ausgabe. Der Status der Bereitstellung der Gerätestatusprüfung.
postureId

string

Pflichtangabe. Die bei der Bereitstellung verwendete Haltung im Format organizations/{organization}/locations/global/postures/{postureId}.
postureRevisionId

string

Pflichtangabe. Die Versions-ID der in der Bereitstellung verwendeten Posture.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Bereitstellung der Gerätestatuserfassung 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 Bereitstellung der Sicherheitskonfiguration 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 Bereitstellung der Sicherheitskonfiguration.
etag

string

Optional. Eine intransparente Kennung für die aktuelle Version der Bereitstellung der Gerätesicherheit.

Damit verhindert wird, dass sich gleichzeitige Updates gegenseitig überschreiben, geben Sie immer die etag an, wenn Sie eine Posture-Bereitstellung aktualisieren. Sie können die etag auch angeben, wenn Sie eine Bereitstellung der Gerätestatusprüfung löschen, um sicherzustellen, dass Sie die gewünschte Bereitstellung löschen.
annotations

map (key: string, value: string)

Optional. Die vom Nutzer angegebenen Anmerkungen für die Bereitstellung der 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 die Statusbereitstellung gerade aktualisiert wird.
desiredPostureId

string

Nur Ausgabe. Die für die Bereitstellung angegebene Posture-ID. Nur vorhanden, wenn die Bereitstellung der Gerätestatuserfassung fehlgeschlagen ist.
desiredPostureRevisionId

string

Nur Ausgabe. Die Versions-ID der Haltung, die für die Bereitstellung angegeben wurde. Nur vorhanden, wenn die Bereitstellung fehlgeschlagen ist.
failureMessage

string

Nur Ausgabe. Eine Beschreibung, warum die Bereitstellung der Gerätestatuserfassung fehlgeschlagen ist. Nur vorhanden, wenn die Bereitstellung fehlgeschlagen ist.
categories[]

enum (Category)

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

Bundesland

Der Status einer PostureDeployment.

Enums
STATE_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
CREATING Die Bereitstellung des Sicherheitsstatus wird erstellt.
DELETING Die Bereitstellung des Sicherheitsstatus wird gelöscht.
UPDATING Die Bereitstellung des Sicherheitsstatus wird aktualisiert.
ACTIVE Die Bereitstellung der Gerätestatusprüfung ist aktiv und wird verwendet.
CREATE_FAILED Die Bereitstellung der Gerätestatusprüfung konnte nicht erstellt werden.
UPDATE_FAILED Die Bereitstellung der Gerätestatusprüfung konnte nicht aktualisiert werden.
DELETE_FAILED Die Bereitstellung der Gerätestatusprüfung konnte nicht gelöscht werden.

Methoden

create

 Erstellt eine neue PostureDeployment in einem bestimmten Projekt und an einem bestimmten Ort.

delete

 Löscht einen PostureDeployment.

get

 Ruft Details für einen PostureDeployment ab.

list

 Listet alle PostureDeployment in einem Projekt und an einem Standort auf.

patch

 Aktualisiert eine vorhandene Buchung (PostureDeployment).