REST Resource: catalogs.associations

Resource: Association

An association tuple that pairs a Catalog to a resource that can use the Catalog. After association, a [google.cloud.privatecatalog.v1beta1.Catalog][] becomes available to consumers under specified Association.resource and all of its child nodes. Users who have the cloudprivatecatalog.targets.get permission on any of the resource nodes can access the catalog and child products under the node.

For example, suppose the cloud resource hierarchy is as follows:

  • organizations/example.com
  • folders/team
    • projects/test

After creating an association with organizations/example.com, the catalog catalogs/1 is accessible from the following paths:

  • organizations/example.com
  • folders/team
  • projects/test

Users can access them by [google.cloud.v1beta1.PrivateCatalog.SearchCatalogs][] action.

JSON representation
{
  "name": string,
  "resource": string,
  "createTime": string
}
Fields
name

string

Output only. The resource name of the catalog association, in the format `catalogs/{catalog_id}/associations/{association_id}'.

A unique identifier for the catalog association, which is generated by catalog service.

resource

string

Required. The user-supplied fully qualified name of the Resource associated to the Catalog. It supports Organization, Folder, and Project. Values are of the form

  • //cloudresourcemanager.googleapis.com/projects/{product_number}
  • //cloudresourcemanager.googleapis.com/folders/{folder_id}
  • //cloudresourcemanager.googleapis.com/organizations/{organization_id}

createTime

string (Timestamp format)

The creation time of the association.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

Methods

create

Creates an Association instance under a given Catalog.

delete

Deletes the given Association.

get

Returns the requested Association resource.

list

Lists all Association resources under a catalog.