PostureDeployment

Détails d'un déploiement Posture sur une organisation, un dossier ou un projet.

Vous ne pouvez déployer qu'une seule posture par organisation, dossier ou projet. La ressource parente d'un déploiement de posture est toujours l'organisation, même si le déploiement s'applique à un dossier ou à un projet.

Représentation JSON
{
  "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)
  ]
}
Champs
name

string

Obligatoire. Identifiant. Nom du déploiement de l'état de conformité, au format organizations/{organization}/locations/global/postureDeployments/{deployment_id}.

targetResource

string

Obligatoire. Organisation, dossier ou projet où la posture est déployée. Utilise l'un des formats suivants:

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

enum (State)

Uniquement en sortie. État du déploiement de la stratégie.

postureId

string

Obligatoire. Posture utilisée lors du déploiement, au format organizations/{organization}/locations/global/postures/{postureId}.

postureRevisionId

string

Obligatoire. ID de la révision de la posture utilisée lors du déploiement.

createTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle le déploiement de la posture a été créé.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour du déploiement de l'état de conformité.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

description

string

Facultatif. Description du déploiement de la posture.

etag

string

Facultatif. Identifiant opaque pour la version actuelle du déploiement de la posture.

Pour éviter que les mises à jour simultanées ne s'écrasent, fournissez toujours etag lorsque vous mettez à jour un déploiement de posture. Vous pouvez également fournir le etag lorsque vous supprimez un déploiement de posture pour vous assurer de supprimer le déploiement de posture prévu.

annotations

map (key: string, value: string)

Facultatif. Les annotations spécifiées par l'utilisateur pour le déploiement de la posture.

Pour en savoir plus sur les valeurs que vous pouvez utiliser dans une annotation, consultez AIP-148: Champs standards.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

reconciling

boolean

Uniquement en sortie. Indique si le déploiement de la stratégie est en cours de mise à jour.

desiredPostureId

string

Uniquement en sortie. ID de posture spécifié pour le déploiement. Présent uniquement si le déploiement de l'état de conformité est en échec.

desiredPostureRevisionId

string

Uniquement en sortie. ID de la révision de la posture spécifiée pour le déploiement. Présent uniquement si le déploiement a échoué.

failureMessage

string

Uniquement en sortie. Description de la raison pour laquelle le déploiement de la posture a échoué. Présent uniquement si le déploiement a échoué.

categories[]

enum (Category)

Uniquement en sortie. Catégories auxquelles appartient le déploiement de la posture, comme déterminé par l'API Security Posture.