create(parent, body=None, x__xgafv=None)
Creates a feed in a parent project/folder/organization to listen to its
Deletes an asset feed.
Gets details about an asset feed.
Lists all asset feeds in a parent project/folder/organization.
patch(name, body=None, x__xgafv=None)
Updates an asset feed configuration.
create(parent, body=None, x__xgafv=None)
Creates a feed in a parent project/folder/organization to listen to its
asset updates.
Args:
parent: string, Required. The name of the project/folder/organization where this feed
should be created in. It can only be an organization number (such as
"organizations/123"), a folder number (such as "folders/123"), a project ID
(such as "projects/my-project-id")", or a project number (such as
"projects/12345"). (required)
body: object, The request body.
The object takes the form of:
{ # Create asset feed request.
"feedId": "A String", # Required. This is the client-assigned asset feed identifier and it needs to
# be unique under a specific parent project/folder/organization.
"feed": { # An asset feed used to export asset updates to a destinations. # Required. The feed details. The field `name` must be empty and it will be generated
# in the format of:
# projects/project_number/feeds/feed_id
# folders/folder_number/feeds/feed_id
# organizations/organization_number/feeds/feed_id
# An asset feed filter controls what updates are exported.
# The asset feed must be created within a project, organization, or
# folder. Supported destinations are:
# Pub/Sub topics.
"assetTypes": [ # A list of types of the assets to receive updates. You must specify either
# or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example: `"compute.googleapis.com/Disk"`
#
# See [this
# topic](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
# for a list of all supported asset types.
"A String",
],
"feedOutputConfig": { # Output configuration for asset feed destination. # Required. Feed output configuration defining where the asset updates are
# published to.
"pubsubDestination": { # A Pub/Sub destination. # Destination on Pub/Sub.
"topic": "A String", # The name of the Pub/Sub topic to publish to.
# Example: `projects/PROJECT_ID/topics/TOPIC_ID`.
},
},
"assetNames": [ # A list of the full names of the assets to receive updates. You must specify
# either or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example:
# `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
# See [Resource
# Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
# for more info.
"A String",
],
"name": "A String", # Required. The format will be
# projects/{project_number}/feeds/{client-assigned_feed_identifier} or
# folders/{folder_number}/feeds/{client-assigned_feed_identifier} or
# organizations/{organization_number}/feeds/{client-assigned_feed_identifier}
#
# The client-assigned feed identifier must be unique within the parent
# project/folder/organization.
"contentType": "A String", # Asset content type. If not specified, no content but the asset name and
# type will be returned.
},
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An asset feed used to export asset updates to a destinations.
# An asset feed filter controls what updates are exported.
# The asset feed must be created within a project, organization, or
# folder. Supported destinations are:
# Pub/Sub topics.
"assetTypes": [ # A list of types of the assets to receive updates. You must specify either
# or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example: `"compute.googleapis.com/Disk"`
#
# See [this
# topic](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
# for a list of all supported asset types.
"A String",
],
"feedOutputConfig": { # Output configuration for asset feed destination. # Required. Feed output configuration defining where the asset updates are
# published to.
"pubsubDestination": { # A Pub/Sub destination. # Destination on Pub/Sub.
"topic": "A String", # The name of the Pub/Sub topic to publish to.
# Example: `projects/PROJECT_ID/topics/TOPIC_ID`.
},
},
"assetNames": [ # A list of the full names of the assets to receive updates. You must specify
# either or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example:
# `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
# See [Resource
# Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
# for more info.
"A String",
],
"name": "A String", # Required. The format will be
# projects/{project_number}/feeds/{client-assigned_feed_identifier} or
# folders/{folder_number}/feeds/{client-assigned_feed_identifier} or
# organizations/{organization_number}/feeds/{client-assigned_feed_identifier}
#
# The client-assigned feed identifier must be unique within the parent
# project/folder/organization.
"contentType": "A String", # Asset content type. If not specified, no content but the asset name and
# type will be returned.
}
delete(name, x__xgafv=None)
Deletes an asset feed.
Args:
name: string, Required. The name of the feed and it must be in the format of:
projects/project_number/feeds/feed_id
folders/folder_number/feeds/feed_id
organizations/organization_number/feeds/feed_id (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated
# empty messages in your APIs. A typical example is to use it as the request
# or the response type of an API method. For instance:
#
# service Foo {
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
# }
#
# The JSON representation for `Empty` is empty JSON object `{}`.
}
get(name, x__xgafv=None)
Gets details about an asset feed.
Args:
name: string, Required. The name of the Feed and it must be in the format of:
projects/project_number/feeds/feed_id
folders/folder_number/feeds/feed_id
organizations/organization_number/feeds/feed_id (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An asset feed used to export asset updates to a destinations.
# An asset feed filter controls what updates are exported.
# The asset feed must be created within a project, organization, or
# folder. Supported destinations are:
# Pub/Sub topics.
"assetTypes": [ # A list of types of the assets to receive updates. You must specify either
# or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example: `"compute.googleapis.com/Disk"`
#
# See [this
# topic](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
# for a list of all supported asset types.
"A String",
],
"feedOutputConfig": { # Output configuration for asset feed destination. # Required. Feed output configuration defining where the asset updates are
# published to.
"pubsubDestination": { # A Pub/Sub destination. # Destination on Pub/Sub.
"topic": "A String", # The name of the Pub/Sub topic to publish to.
# Example: `projects/PROJECT_ID/topics/TOPIC_ID`.
},
},
"assetNames": [ # A list of the full names of the assets to receive updates. You must specify
# either or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example:
# `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
# See [Resource
# Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
# for more info.
"A String",
],
"name": "A String", # Required. The format will be
# projects/{project_number}/feeds/{client-assigned_feed_identifier} or
# folders/{folder_number}/feeds/{client-assigned_feed_identifier} or
# organizations/{organization_number}/feeds/{client-assigned_feed_identifier}
#
# The client-assigned feed identifier must be unique within the parent
# project/folder/organization.
"contentType": "A String", # Asset content type. If not specified, no content but the asset name and
# type will be returned.
}
list(parent, x__xgafv=None)
Lists all asset feeds in a parent project/folder/organization.
Args:
parent: string, Required. The parent project/folder/organization whose feeds are to be
listed. It can only be using project/folder/organization number (such as
"folders/12345")", or a project ID (such as "projects/my-project-id"). (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{
"feeds": [ # A list of feeds.
{ # An asset feed used to export asset updates to a destinations.
# An asset feed filter controls what updates are exported.
# The asset feed must be created within a project, organization, or
# folder. Supported destinations are:
# Pub/Sub topics.
"assetTypes": [ # A list of types of the assets to receive updates. You must specify either
# or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example: `"compute.googleapis.com/Disk"`
#
# See [this
# topic](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
# for a list of all supported asset types.
"A String",
],
"feedOutputConfig": { # Output configuration for asset feed destination. # Required. Feed output configuration defining where the asset updates are
# published to.
"pubsubDestination": { # A Pub/Sub destination. # Destination on Pub/Sub.
"topic": "A String", # The name of the Pub/Sub topic to publish to.
# Example: `projects/PROJECT_ID/topics/TOPIC_ID`.
},
},
"assetNames": [ # A list of the full names of the assets to receive updates. You must specify
# either or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example:
# `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
# See [Resource
# Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
# for more info.
"A String",
],
"name": "A String", # Required. The format will be
# projects/{project_number}/feeds/{client-assigned_feed_identifier} or
# folders/{folder_number}/feeds/{client-assigned_feed_identifier} or
# organizations/{organization_number}/feeds/{client-assigned_feed_identifier}
#
# The client-assigned feed identifier must be unique within the parent
# project/folder/organization.
"contentType": "A String", # Asset content type. If not specified, no content but the asset name and
# type will be returned.
},
],
}
patch(name, body=None, x__xgafv=None)
Updates an asset feed configuration.
Args:
name: string, Required. The format will be
projects/{project_number}/feeds/{client-assigned_feed_identifier} or
folders/{folder_number}/feeds/{client-assigned_feed_identifier} or
organizations/{organization_number}/feeds/{client-assigned_feed_identifier}
The client-assigned feed identifier must be unique within the parent
project/folder/organization. (required)
body: object, The request body.
The object takes the form of:
{ # Update asset feed request.
"updateMask": "A String", # Required. Only updates the `feed` fields indicated by this mask.
# The field mask must not be empty, and it must not contain fields that
# are immutable or only set by the server.
"feed": { # An asset feed used to export asset updates to a destinations. # Required. The new values of feed details. It must match an existing feed and the
# field `name` must be in the format of:
# projects/project_number/feeds/feed_id or
# folders/folder_number/feeds/feed_id or
# organizations/organization_number/feeds/feed_id.
# An asset feed filter controls what updates are exported.
# The asset feed must be created within a project, organization, or
# folder. Supported destinations are:
# Pub/Sub topics.
"assetTypes": [ # A list of types of the assets to receive updates. You must specify either
# or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example: `"compute.googleapis.com/Disk"`
#
# See [this
# topic](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
# for a list of all supported asset types.
"A String",
],
"feedOutputConfig": { # Output configuration for asset feed destination. # Required. Feed output configuration defining where the asset updates are
# published to.
"pubsubDestination": { # A Pub/Sub destination. # Destination on Pub/Sub.
"topic": "A String", # The name of the Pub/Sub topic to publish to.
# Example: `projects/PROJECT_ID/topics/TOPIC_ID`.
},
},
"assetNames": [ # A list of the full names of the assets to receive updates. You must specify
# either or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example:
# `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
# See [Resource
# Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
# for more info.
"A String",
],
"name": "A String", # Required. The format will be
# projects/{project_number}/feeds/{client-assigned_feed_identifier} or
# folders/{folder_number}/feeds/{client-assigned_feed_identifier} or
# organizations/{organization_number}/feeds/{client-assigned_feed_identifier}
#
# The client-assigned feed identifier must be unique within the parent
# project/folder/organization.
"contentType": "A String", # Asset content type. If not specified, no content but the asset name and
# type will be returned.
},
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An asset feed used to export asset updates to a destinations.
# An asset feed filter controls what updates are exported.
# The asset feed must be created within a project, organization, or
# folder. Supported destinations are:
# Pub/Sub topics.
"assetTypes": [ # A list of types of the assets to receive updates. You must specify either
# or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example: `"compute.googleapis.com/Disk"`
#
# See [this
# topic](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
# for a list of all supported asset types.
"A String",
],
"feedOutputConfig": { # Output configuration for asset feed destination. # Required. Feed output configuration defining where the asset updates are
# published to.
"pubsubDestination": { # A Pub/Sub destination. # Destination on Pub/Sub.
"topic": "A String", # The name of the Pub/Sub topic to publish to.
# Example: `projects/PROJECT_ID/topics/TOPIC_ID`.
},
},
"assetNames": [ # A list of the full names of the assets to receive updates. You must specify
# either or both of asset_names and asset_types. Only asset updates matching
# specified asset_names or asset_types are exported to the feed.
# Example:
# `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
# See [Resource
# Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
# for more info.
"A String",
],
"name": "A String", # Required. The format will be
# projects/{project_number}/feeds/{client-assigned_feed_identifier} or
# folders/{folder_number}/feeds/{client-assigned_feed_identifier} or
# organizations/{organization_number}/feeds/{client-assigned_feed_identifier}
#
# The client-assigned feed identifier must be unique within the parent
# project/folder/organization.
"contentType": "A String", # Asset content type. If not specified, no content but the asset name and
# type will be returned.
}