audit/destinations/{id}

Endpoint

/v2/audit/destinations/{id}

GET

Retrieves configuration for a specific audit log destination.

Parameters

Name	Description	Required
`id`	ID of the audit destination	Yes

Response

Codes

Code	Description
200	Return value on success

Schema

{
  "description": "api_audit_destination",
  "type": "object",
  "properties": {
    "id": {
      "description": "id",
      "type": "string"
    },
    "config": {
      "description": "config",
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "SYSLOG",
            "CLOUDWATCH"
          ],
          "description": "type:\n * `CLOUDWATCH` - AUDIT_DESTINATION_CLOUDWATCH,\n * `SYSLOG` - AUDIT_DESTINATION_SYSLOG"
        },
        "name": {
          "description": "name",
          "type": "string"
        },
        "enabled": {
          "description": "enabled",
          "type": "boolean"
        },
        "server_address": {
          "description": "server_address",
          "type": "string"
        },
        "server_port": {
          "description": "server_port",
          "type": "number"
        },
        "format": {
          "description": "format",
          "type": "string"
        },
        "local_enabled": {
          "description": "local_enabled",
          "type": "boolean"
        },
        "log_group_name": {
          "description": "log_group_name",
          "type": "string"
        },
        "region": {
          "description": "region",
          "type": "string"
        }
      }
    }
  }
}

PUT

Replaces configuration for an existing audit log destination.

Parameters

Name	Description	Required
`id`	ID of the audit destination	Yes
`If-Match`	ETag for expected version	No

Request

Schema

{
  "description": "api_audit_destination_config",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "SYSLOG",
        "CLOUDWATCH"
      ],
      "description": "type:\n * `CLOUDWATCH` - AUDIT_DESTINATION_CLOUDWATCH,\n * `SYSLOG` - AUDIT_DESTINATION_SYSLOG"
    },
    "name": {
      "description": "name",
      "type": "string"
    },
    "enabled": {
      "description": "enabled",
      "type": "boolean"
    },
    "server_address": {
      "description": "server_address",
      "type": "string"
    },
    "server_port": {
      "description": "server_port",
      "type": "number"
    },
    "format": {
      "description": "format",
      "type": "string"
    },
    "local_enabled": {
      "description": "local_enabled",
      "type": "boolean"
    },
    "log_group_name": {
      "description": "log_group_name",
      "type": "string"
    },
    "region": {
      "description": "region",
      "type": "string"
    }
  }
}

Response

Codes

Code	Description
200	Return value on success

Schema

{
  "description": "api_audit_destination",
  "type": "object",
  "properties": {
    "id": {
      "description": "id",
      "type": "string"
    },
    "config": {
      "description": "config",
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "SYSLOG",
            "CLOUDWATCH"
          ],
          "description": "type:\n * `CLOUDWATCH` - AUDIT_DESTINATION_CLOUDWATCH,\n * `SYSLOG` - AUDIT_DESTINATION_SYSLOG"
        },
        "name": {
          "description": "name",
          "type": "string"
        },
        "enabled": {
          "description": "enabled",
          "type": "boolean"
        },
        "server_address": {
          "description": "server_address",
          "type": "string"
        },
        "server_port": {
          "description": "server_port",
          "type": "number"
        },
        "format": {
          "description": "format",
          "type": "string"
        },
        "local_enabled": {
          "description": "local_enabled",
          "type": "boolean"
        },
        "log_group_name": {
          "description": "log_group_name",
          "type": "string"
        },
        "region": {
          "description": "region",
          "type": "string"
        }
      }
    }
  }
}

DELETE

Deletes an audit log destination.

Parameters

Name	Description	Required
`id`	ID of the audit destination	Yes
`If-Match`	ETag for expected version	No

Response

Codes

Code	Description
200	Return value on success

PATCH

Modifies configuration for a specific audit log destination.

Parameters

Name	Description	Required
`id`	ID of the audit destination	Yes
`If-Match`	ETag for expected version	No

Request

Schema

{
  "description": "audit_destination_config_delta",
  "type": "object",
  "properties": {
    "enabled": {
      "description": "enabled",
      "type": "boolean"
    }
  }
}

Response

Codes

Code	Description
200	Return value on success

Schema

{
  "description": "api_audit_destination",
  "type": "object",
  "properties": {
    "id": {
      "description": "id",
      "type": "string"
    },
    "config": {
      "description": "config",
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "SYSLOG",
            "CLOUDWATCH"
          ],
          "description": "type:\n * `CLOUDWATCH` - AUDIT_DESTINATION_CLOUDWATCH,\n * `SYSLOG` - AUDIT_DESTINATION_SYSLOG"
        },
        "name": {
          "description": "name",
          "type": "string"
        },
        "enabled": {
          "description": "enabled",
          "type": "boolean"
        },
        "server_address": {
          "description": "server_address",
          "type": "string"
        },
        "server_port": {
          "description": "server_port",
          "type": "number"
        },
        "format": {
          "description": "format",
          "type": "string"
        },
        "local_enabled": {
          "description": "local_enabled",
          "type": "boolean"
        },
        "log_group_name": {
          "description": "log_group_name",
          "type": "string"
        },
        "region": {
          "description": "region",
          "type": "string"
        }
      }
    }
  }
}