google-api-client 0.28.7 → 0.29.0

data/generated/google/apis/file_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/filestore/
     module FileV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20190312'
+      REVISION = '20190430'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/file_v1beta1/classes.rb

@@ -80,6 +80,397 @@ module Google
         end
       end
       
+      # Instance represents the interface for SLM services to actuate the state
+      # of control plane resources.
+      # Example Instance in JSON, where
+      # consumer-project=snapchat,
+      # producer-project=cloud-sql:
+      # ```json
+      # Instance:
+      # `
+      # "name":
+      # "projects/snapchat/locations/us-east1/instances/prod-instance",
+      # "create_time": `
+      # "seconds": 1526406431,
+      # `,
+      # "labels": `
+      # "env": "prod",
+      # "foo": "bar"
+      # `,
+      # "state": READY,
+      # "software_versions": `
+      # "software_update": "cloud-sql-09-28-2018",
+      # `,
+      # "maintenance_policy_names": `
+      # "UpdatePolicy":
+      # "projects/snapchat/locations/us-east1/maintenancePolicies/prod-update-
+      # policy",
+      # `
+      # "rollout_metadata": `
+      # "projects/cloud-sql/locations/global/rolloutTypes/software_update": `
+      # "release":
+      # "projects/cloud-sql/locations/global/releases/cloud-sql-09-28-2018",
+      # "rollout":
+      # "projects/cloud-sql/locations/us-east1/rollouts/cloud-sql-09-28-2018-
+      # canary",
+      # `,
+      # "projects/cloud-sql/locations/global/rolloutTypes/instance_restart": `
+      # "release":
+      # "projects/cloud-sql/locations/global/releases/cloud-sql-09-20-repair",
+      # "rollout":
+      # "projects/cloud-sql/locations/us-east1/rollouts/cloud-sql-09-20-repair-
+      # 100-percent",
+      # `
+      # `
+      # "tenant_project_id": "cloud-sql-test-tenant",
+      # "producer_metadata": `
+      # "cloud-sql-tier": "basic",
+      # "cloud-sql-instance-size": "1G",
+      # `,
+      # "provisioned_resources": [
+      # `
+      # "resource-type": "compute-instance",
+      # "resource-url":
+      # "https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-
+      # b/instances/vm-1",
+      # `
+      # ],
+      # `
+      # ```
+      class GoogleCloudSaasacceleratorManagementProvidersV1Instance
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Timestamp when the resource was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Optional. Resource labels to represent user provided metadata. Each label
+        # is a key-value pair, where both the key and the value are arbitrary strings
+        # provided by the user.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
+        # The MaintenancePolicies that have been attached to the instance.
+        # The key must be of the type name of the oneof policy name defined in
+        # MaintenancePolicy, and the referenced policy must define the same policy
+        # type. For complete details of MaintenancePolicy, please refer to
+        # go/cloud-saas-mw-ug.
+        # Corresponds to the JSON property `maintenancePolicyNames`
+        # @return [Hash<String,String>]
+        attr_accessor :maintenance_policy_names
+      
+        # Unique name of the resource. It uses the form:
+        # `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. Custom string attributes used primarily to expose
+        # producer-specific information in monitoring dashboards.
+        # See go/get-instance-metadata.
+        # Corresponds to the JSON property `producerMetadata`
+        # @return [Hash<String,String>]
+        attr_accessor :producer_metadata
+      
+        # Output only. The list of data plane resources provisioned for this
+        # instance, e.g. compute VMs. See go/get-instance-metadata.
+        # Corresponds to the JSON property `provisionedResources`
+        # @return [Array<Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource>]
+        attr_accessor :provisioned_resources
+      
+        # The map between RolloutType and the corresponding RolloutMetadata.
+        # This is only mutated by rollout service. For actuation implementation,
+        # this information is pass-through for Rollout management. Producer shall
+        # not modify by itself.
+        # For update of a single entry in this map, the update field mask shall
+        # follow this sementics: go/advanced-field-masks
+        # Corresponds to the JSON property `rolloutMetadata`
+        # @return [Hash<String,Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1RolloutMetadata>]
+        attr_accessor :rollout_metadata
+      
+        # SloMetadata contains resources required for proper SLO classification of the
+        # instance.
+        # Corresponds to the JSON property `sloMetadata`
+        # @return [Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata]
+        attr_accessor :slo_metadata
+      
+        # Software versions that are used to deploy this instance. This can be
+        # mutated by rollout services.
+        # Corresponds to the JSON property `softwareVersions`
+        # @return [Hash<String,String>]
+        attr_accessor :software_versions
+      
+        # Output only. Current lifecycle state of the resource (e.g. if it's being
+        # created or ready to use).
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Output only. ID of the associated GCP tenant project.
+        # See go/get-instance-metadata.
+        # Corresponds to the JSON property `tenantProjectId`
+        # @return [String]
+        attr_accessor :tenant_project_id
+      
+        # Output only. Timestamp when the resource was last modified.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @labels = args[:labels] if args.key?(:labels)
+          @maintenance_policy_names = args[:maintenance_policy_names] if args.key?(:maintenance_policy_names)
+          @name = args[:name] if args.key?(:name)
+          @producer_metadata = args[:producer_metadata] if args.key?(:producer_metadata)
+          @provisioned_resources = args[:provisioned_resources] if args.key?(:provisioned_resources)
+          @rollout_metadata = args[:rollout_metadata] if args.key?(:rollout_metadata)
+          @slo_metadata = args[:slo_metadata] if args.key?(:slo_metadata)
+          @software_versions = args[:software_versions] if args.key?(:software_versions)
+          @state = args[:state] if args.key?(:state)
+          @tenant_project_id = args[:tenant_project_id] if args.key?(:tenant_project_id)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Node information for custom per-node SLO implementations.
+      # SSA does not support per-node SLO, but producers can populate per-node
+      # information in SloMetadata for custom precomputations.
+      # SSA Eligibility Exporter will emit per-node metric based on this information.
+      class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata
+        include Google::Apis::Core::Hashable
+      
+        # By default node is eligible if instance is eligible.
+        # But individual node might be excluded from SLO by adding entry here.
+        # For semantic see SloMetadata.exclusions.
+        # If both instance and node level exclusions are present for time period,
+        # the node level's reason will be reported by Eligibility Exporter.
+        # Corresponds to the JSON property `exclusions`
+        # @return [Array<Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion>]
+        attr_accessor :exclusions
+      
+        # The id of the node.
+        # This should be equal to SaasInstanceNode.node_id.
+        # Corresponds to the JSON property `nodeId`
+        # @return [String]
+        attr_accessor :node_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @exclusions = args[:exclusions] if args.key?(:exclusions)
+          @node_id = args[:node_id] if args.key?(:node_id)
+        end
+      end
+      
+      # NotificationMetadata is the notification state for an instance.
+      class GoogleCloudSaasacceleratorManagementProvidersV1NotificationMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Whether the instance update has been rescheduled.
+        # Corresponds to the JSON property `rescheduled`
+        # @return [Boolean]
+        attr_accessor :rescheduled
+        alias_method :rescheduled?, :rescheduled
+      
+        # The scheduled end time for the maintenance window during which update
+        # can be performed on the instance.
+        # Corresponds to the JSON property `scheduledEndTime`
+        # @return [String]
+        attr_accessor :scheduled_end_time
+      
+        # The scheduled start time for the maintenance window during which
+        # update can be performed on the instance.
+        # Corresponds to the JSON property `scheduledStartTime`
+        # @return [String]
+        attr_accessor :scheduled_start_time
+      
+        # The target release to be applied to the instance.
+        # Corresponds to the JSON property `targetRelease`
+        # @return [String]
+        attr_accessor :target_release
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @rescheduled = args[:rescheduled] if args.key?(:rescheduled)
+          @scheduled_end_time = args[:scheduled_end_time] if args.key?(:scheduled_end_time)
+          @scheduled_start_time = args[:scheduled_start_time] if args.key?(:scheduled_start_time)
+          @target_release = args[:target_release] if args.key?(:target_release)
+        end
+      end
+      
+      # Describes provisioned dataplane resources.
+      class GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource
+        include Google::Apis::Core::Hashable
+      
+        # Type of the resource. This can be either a GCP resource or a custom one
+        # (e.g. another cloud provider's VM). For GCP compute resources use singular
+        # form of the names listed in GCP compute API documentation
+        # (https://cloud.google.com/compute/docs/reference/rest/v1/), prefixed with
+        # 'compute-', for example: 'compute-instance', 'compute-disk',
+        # 'compute-autoscaler'.
+        # Corresponds to the JSON property `resourceType`
+        # @return [String]
+        attr_accessor :resource_type
+      
+        # URL identifying the resource, e.g.
+        # "https://www.googleapis.com/compute/v1/projects/...)".
+        # Corresponds to the JSON property `resourceUrl`
+        # @return [String]
+        attr_accessor :resource_url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @resource_type = args[:resource_type] if args.key?(:resource_type)
+          @resource_url = args[:resource_url] if args.key?(:resource_url)
+        end
+      end
+      
+      # RolloutMetadata for an actuation instance. It maps to a single RolloutType.
+      class GoogleCloudSaasacceleratorManagementProvidersV1RolloutMetadata
+        include Google::Apis::Core::Hashable
+      
+        # NotificationMetadata is the notification state for an instance.
+        # Corresponds to the JSON property `notification`
+        # @return [Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NotificationMetadata]
+        attr_accessor :notification
+      
+        # The last Release that has been applied to the instance.
+        # Corresponds to the JSON property `releaseName`
+        # @return [String]
+        attr_accessor :release_name
+      
+        # The last rollout that has been applied to the instance.
+        # Corresponds to the JSON property `rolloutName`
+        # @return [String]
+        attr_accessor :rollout_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @notification = args[:notification] if args.key?(:notification)
+          @release_name = args[:release_name] if args.key?(:release_name)
+          @rollout_name = args[:rollout_name] if args.key?(:rollout_name)
+        end
+      end
+      
+      # A temporal SLO exclusion specification.
+      class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion
+        include Google::Apis::Core::Hashable
+      
+        # Exclusion duration. No restrictions on the possible values.
+        # When an ongoing operation is taking longer than initially expected,
+        # an existing entry in the exclusion list can be updated by extending the
+        # duration. This is supported by the subsystem exporting eligibility data
+        # as long as such extension is committed at least 10 minutes before the
+        # original exclusion expiration - otherwise it is possible that there will
+        # be "gaps" in the exclusion application in the exported timeseries.
+        # Corresponds to the JSON property `exclusionDuration`
+        # @return [String]
+        attr_accessor :exclusion_duration
+      
+        # Start time of the exclusion. No alignment (e.g. to a full minute) needed.
+        # Corresponds to the JSON property `exclusionStartTime`
+        # @return [String]
+        attr_accessor :exclusion_start_time
+      
+        # Human-readable reason for the exclusion.
+        # This should be a static string (e.g. "Disruptive update in progress")
+        # and should not contain dynamically generated data (e.g. instance name).
+        # Can be left empty.
+        # Corresponds to the JSON property `reason`
+        # @return [String]
+        attr_accessor :reason
+      
+        # Name of an SLI/SLO that this exclusion applies to. Can be left empty,
+        # signaling that the instance should be excluded from all SLI/SLOs defined
+        # in the service SLO configuration.
+        # Corresponds to the JSON property `sloName`
+        # @return [String]
+        attr_accessor :slo_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @exclusion_duration = args[:exclusion_duration] if args.key?(:exclusion_duration)
+          @exclusion_start_time = args[:exclusion_start_time] if args.key?(:exclusion_start_time)
+          @reason = args[:reason] if args.key?(:reason)
+          @slo_name = args[:slo_name] if args.key?(:slo_name)
+        end
+      end
+      
+      # SloMetadata contains resources required for proper SLO classification of the
+      # instance.
+      class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata
+        include Google::Apis::Core::Hashable
+      
+        # List of SLO exclusion windows. When multiple entries in the list match
+        # (matching the exclusion time-window against current time point)
+        # the exclusion reason used in the first matching entry will be published.
+        # It is not needed to include expired exclusion in this list, as only the
+        # currently applicable exclusions are taken into account by the eligibility
+        # exporting subsystem (the historical state of exclusions will be reflected
+        # in the historically produced timeseries regardless of the current state).
+        # This field can be used to mark the instance as temporary ineligible
+        # for the purpose of SLO calculation. For permanent instance SLO exclusion,
+        # a dedicated tier name can be used that does not have targets specified
+        # in the service SLO configuration.
+        # Corresponds to the JSON property `exclusions`
+        # @return [Array<Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion>]
+        attr_accessor :exclusions
+      
+        # Optional: list of nodes.
+        # Some producers need to use per-node metadata to calculate SLO.
+        # This field allows such producers to publish per-node SLO meta data,
+        # which will be consumed by SSA Eligibility Exporter and published in the
+        # form of per node metric to Monarch.
+        # Corresponds to the JSON property `nodes`
+        # @return [Array<Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata>]
+        attr_accessor :nodes
+      
+        # Name of the SLO tier the Instance belongs to. This name will be expected to
+        # match the tiers specified in the service SLO configuration.
+        # Field is mandatory and must not be empty.
+        # Corresponds to the JSON property `tier`
+        # @return [String]
+        attr_accessor :tier
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @exclusions = args[:exclusions] if args.key?(:exclusions)
+          @nodes = args[:nodes] if args.key?(:nodes)
+          @tier = args[:tier] if args.key?(:tier)
+        end
+      end
+      
       # A Cloud Filestore instance.
       class Instance
         include Google::Apis::Core::Hashable
@@ -301,8 +692,8 @@ module Google
         # Output only.
         # IPv4 addresses in the format
         # `octet 1`.`octet 2`.`octet 3`.`octet 4` or IPv6 addresses in the format
-        # `block 1`:`block 2`:`block 3`:`block 4`:`block 5`:`block 6`:`block 7`:`block 8`
-        # .
+        # `block 1`:`block 2`:`block 3`:`block 4`:`block 5`:`block 6`:`block
+        # 7`:`block 8`.
         # Corresponds to the JSON property `ipAddresses`
         # @return [Array<String>]
         attr_accessor :ip_addresses
@@ -321,12 +712,12 @@ module Google
         attr_accessor :network
       
         # A /29 CIDR block in one of the
-        # [internal IP address ranges](https://www.arin.net/knowledge/address_filters.
-        # html)
-        # that identifies the range of IP addresses reserved for this
-        # instance. For example, 10.0.0.0/29 or 192.168.0.0/29. The range you specify
-        # can't overlap with either existing subnets or assigned IP address ranges
-        # for other Cloud Filestore instances in the selected VPC network.
+        # [internal IP address
+        # ranges](https://www.arin.net/knowledge/address_filters.html) that
+        # identifies the range of IP addresses reserved for this instance. For
+        # example, 10.0.0.0/29 or 192.168.0.0/29. The range you specify can't overlap
+        # with either existing subnets or assigned IP address ranges for other Cloud
+        # Filestore instances in the selected VPC network.
         # Corresponds to the JSON property `reservedIpRange`
         # @return [String]
         attr_accessor :reserved_ip_range

data/generated/google/apis/file_v1beta1/representations.rb

@@ -40,6 +40,48 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudSaasacceleratorManagementProvidersV1Instance
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1NotificationMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1RolloutMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Instance
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -114,6 +156,85 @@ module Google
         end
       end
       
+      class GoogleCloudSaasacceleratorManagementProvidersV1Instance
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          hash :labels, as: 'labels'
+          hash :maintenance_policy_names, as: 'maintenancePolicyNames'
+          property :name, as: 'name'
+          hash :producer_metadata, as: 'producerMetadata'
+          collection :provisioned_resources, as: 'provisionedResources', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource::Representation
+      
+          hash :rollout_metadata, as: 'rolloutMetadata', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1RolloutMetadata, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1RolloutMetadata::Representation
+      
+          property :slo_metadata, as: 'sloMetadata', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata::Representation
+      
+          hash :software_versions, as: 'softwareVersions'
+          property :state, as: 'state'
+          property :tenant_project_id, as: 'tenantProjectId'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :exclusions, as: 'exclusions', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion::Representation
+      
+          property :node_id, as: 'nodeId'
+        end
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1NotificationMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :rescheduled, as: 'rescheduled'
+          property :scheduled_end_time, as: 'scheduledEndTime'
+          property :scheduled_start_time, as: 'scheduledStartTime'
+          property :target_release, as: 'targetRelease'
+        end
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :resource_type, as: 'resourceType'
+          property :resource_url, as: 'resourceUrl'
+        end
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1RolloutMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :notification, as: 'notification', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NotificationMetadata, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NotificationMetadata::Representation
+      
+          property :release_name, as: 'releaseName'
+          property :rollout_name, as: 'rolloutName'
+        end
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :exclusion_duration, as: 'exclusionDuration'
+          property :exclusion_start_time, as: 'exclusionStartTime'
+          property :reason, as: 'reason'
+          property :slo_name, as: 'sloName'
+        end
+      end
+      
+      class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :exclusions, as: 'exclusions', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion::Representation
+      
+          collection :nodes, as: 'nodes', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata::Representation
+      
+          property :tier, as: 'tier'
+        end
+      end
+      
       class Instance
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation