vsphere

package

Go to main page

Versions in this module

v0

v0.1.6

Dec 16, 2024

v0.1.5

Dec 10, 2024

v0.1.4

Oct 3, 2024

v0.1.3

Sep 12, 2024

Changes in this version

type VCenterDriver

+ func (v *VCenterDriver) GetDistributedVirtualSwitchNameFromPortGroup(ctx context.Context, dvp *object.DistributedVirtualPortgroup) (string, error)

v0.1.2

Sep 11, 2024

v0.1.1

Sep 11, 2024

v0.1.0

Sep 10, 2024

Changes in this version

+ const K8sComputeClusterTagCategory

+ const K8sDatacenterTagCategory

type Driver

+ GetClusters func(ctx context.Context, datacenter string) ([]string, error)

+ GetClustersByTag func(ctx context.Context, datacenter, tagCategory string) ([]string, error)

+ GetDatacenters func(ctx context.Context) ([]string, error)

+ GetDatacentersByTag func(ctx context.Context, tagCategory string) ([]string, error)

+ GetDatastores func(ctx context.Context, datacenter string) ([]string, error)

+ GetDistributedVirtualPortgroups func(ctx context.Context, datacenter string) ([]string, error)

+ GetDistributedVirtualSwitches func(ctx context.Context, datacenter string) ([]string, error)

+ GetHostSystems func(ctx context.Context, datacenter, cluster string) ([]vcenter.HostSystem, error)

+ GetNetworks func(ctx context.Context, datacenter string) ([]string, error)

+ GetVApps func(ctx context.Context) ([]mo.VirtualApp, error)

+ GetVMFolders func(ctx context.Context, datacenter string) ([]string, error)

+ GetVMs func(ctx context.Context, dcName string) ([]vcenter.VM, error)

+ ValidateCredentials func() (bool, error)

+ ValidateVersion func(constraint string) error

type MockVsphereDriver

+ Datastores []string

+ DistributedVirtualPortgroups []string

+ DistributedVirtualSwitches []string

+ Networks []string

+ func (d MockVsphereDriver) GetClusters(_ context.Context, _ string) ([]string, error)

+ func (d MockVsphereDriver) GetClustersByTag(_ context.Context, _, _ string) ([]string, error)

+ func (d MockVsphereDriver) GetDatacenters(_ context.Context) ([]string, error)

+ func (d MockVsphereDriver) GetDatacentersByTag(_ context.Context, _ string) ([]string, error)

+ func (d MockVsphereDriver) GetDatastores(_ context.Context, _ string) ([]string, error)

+ func (d MockVsphereDriver) GetDistributedVirtualPortgroups(_ context.Context, _ string) ([]string, error)

+ func (d MockVsphereDriver) GetDistributedVirtualSwitches(_ context.Context, _ string) ([]string, error)

+ func (d MockVsphereDriver) GetHostSystems(_ context.Context, datacenter, cluster string) ([]vcenter.HostSystem, error)

+ func (d MockVsphereDriver) GetNetworks(_ context.Context, _ string) ([]string, error)

+ func (d MockVsphereDriver) GetVApps(_ context.Context) ([]mo.VirtualApp, error)

+ func (d MockVsphereDriver) GetVMFolders(_ context.Context, _ string) ([]string, error)

+ func (d MockVsphereDriver) GetVMs(_ context.Context, _ string) ([]vcenter.VM, error)

+ func (d MockVsphereDriver) ValidateCredentials() (bool, error)

+ func (d MockVsphereDriver) ValidateVersion(_ string) error

+ type VCenterDriver struct

+ Account vcenter.Account

+ Client *govmomi.Client

+ Datacenter string

+ RestClient *rest.Client

+ func NewVCenterDriver(account vcenter.Account, datacenter string, log logr.Logger) (*VCenterDriver, error)

+ func (v *VCenterDriver) CurrentDomains(ctx context.Context) ([]string, error)

+ func (v *VCenterDriver) CurrentUser(ctx context.Context) (string, error)

+ func (v *VCenterDriver) FolderExists(ctx context.Context, finder *find.Finder, name string) bool

+ func (v *VCenterDriver) GetCluster(ctx context.Context, finder *find.Finder, datacenter, clusterName string) (*object.ClusterComputeResource, error)

+ func (v *VCenterDriver) GetClusters(ctx context.Context, datacenter string) ([]string, error)

+ func (v *VCenterDriver) GetClustersByTag(ctx context.Context, datacenter, tagCategory string) ([]string, error)

+ func (v *VCenterDriver) GetDatacenter(ctx context.Context, finder *find.Finder, datacenter string) (*object.Datacenter, error)

+ func (v *VCenterDriver) GetDatacenters(ctx context.Context) ([]string, error)

+ func (v *VCenterDriver) GetDatacentersByTag(ctx context.Context, tagCategory string) ([]string, error)

+ func (v *VCenterDriver) GetDatastore(ctx context.Context, finder *find.Finder, datastore string) (*object.Datastore, error)

+ func (v *VCenterDriver) GetDatastores(ctx context.Context, datacenter string) ([]string, error)

+ func (v *VCenterDriver) GetDistributedVirtualPortgroup(ctx context.Context, finder *find.Finder, path string) (*object.DistributedVirtualPortgroup, error)

+ func (v *VCenterDriver) GetDistributedVirtualPortgroups(ctx context.Context, datacenter string) ([]string, error)

+ func (v *VCenterDriver) GetDistributedVirtualSwitch(ctx context.Context, finder *find.Finder, path string) (*object.DistributedVirtualSwitch, error)

+ func (v *VCenterDriver) GetDistributedVirtualSwitches(ctx context.Context, datacenter string) ([]string, error)

+ func (v *VCenterDriver) GetFinderWithDatacenter(ctx context.Context, datacenter string) (*find.Finder, string, error)

+ func (v *VCenterDriver) GetFolder(ctx context.Context, finder *find.Finder, name string) (*object.Folder, error)

+ func (v *VCenterDriver) GetHost(ctx context.Context, finder *find.Finder, ...) (*object.HostSystem, error)

+ func (v *VCenterDriver) GetHostClusterMapping(ctx context.Context) (map[string]string, error)

+ func (v *VCenterDriver) GetHostSystems(ctx context.Context, datacenter, cluster string) ([]vcenter.HostSystem, error)

+ func (v *VCenterDriver) GetMetrics(ctx context.Context, c *vim25.Client) ([]performance.EntityMetric, error)

+ func (v *VCenterDriver) GetNetwork(ctx context.Context, finder *find.Finder, path string) (*object.Network, error)

+ func (v *VCenterDriver) GetNetworkTypeByName(ctx context.Context, datacenter, name string) (string, error)

+ func (v *VCenterDriver) GetNetworks(ctx context.Context, datacenter string) ([]string, error)

+ func (v *VCenterDriver) GetOpaqueNetwork(ctx context.Context, finder *find.Finder, path string) (*object.OpaqueNetwork, error)

+ func (v *VCenterDriver) GetOpaqueNetworks(ctx context.Context, datacenter string) ([]string, error)

+ func (v *VCenterDriver) GetResourcePool(ctx context.Context, finder *find.Finder, ...) (*object.ResourcePool, error)

+ func (v *VCenterDriver) GetResourcePools(ctx context.Context, datacenter string, cluster string) ([]*object.ResourcePool, error)

+ func (v *VCenterDriver) GetResourceTags(ctx context.Context, resourceType string) (map[string]tags.AttachedTags, error)

+ func (v *VCenterDriver) GetVApp(ctx context.Context, finder *find.Finder, vAppName string) (*object.VirtualApp, error)

+ func (v *VCenterDriver) GetVApps(ctx context.Context) ([]mo.VirtualApp, error)

+ func (v *VCenterDriver) GetVM(ctx context.Context, finder *find.Finder, vmName string) (*object.VirtualMachine, error)

+ func (v *VCenterDriver) GetVMFolders(ctx context.Context, datacenter string) ([]string, error)

+ func (v *VCenterDriver) GetVMs(ctx context.Context, datacenter string) ([]vcenter.VM, error)

+ func (v *VCenterDriver) GetVSphereResourcePools(ctx context.Context, datacenter string, cluster string) (resourcePools []string, err error)

+ func (v *VCenterDriver) ValidateCredentials() (bool, error)

+ func (v *VCenterDriver) ValidateHostNTPSettings(ctx context.Context, finder *find.Finder, datacenter, clusterName string, ...) (bool, []string, error)

+ func (v *VCenterDriver) ValidateUserPrivilegeOnEntities(ctx context.Context, authManager *object.AuthorizationManager, ...) ([]string, error)

+ func (v *VCenterDriver) ValidateVersion(constraint string) error

v0.0.34

Aug 24, 2024

v0.0.33

Aug 23, 2024

v0.0.32

Aug 22, 2024

v0.0.31

Aug 22, 2024

v0.0.30

Aug 12, 2024

v0.0.29

Aug 6, 2024

v0.0.28

Jul 26, 2024

v0.0.27

Jul 16, 2024

Changes in this version

+ type CloudAccount struct

+ Insecure bool

+ Password string

+ Username string

+ VcenterServer string

+ type CloudDriver struct

+ Client *govmomi.Client

+ Datacenter string

+ RestClient *rest.Client

+ VCenterPassword string

+ VCenterServer string

+ VCenterUsername string

+ func (v *CloudDriver) CreateVSphereVMFolder(ctx context.Context, datacenter string, folders []string) error

+ func (v *CloudDriver) FolderExists(ctx context.Context, finder *find.Finder, folderName string) (bool, error)

+ func (v *CloudDriver) GetClusterIfExists(ctx context.Context, finder *find.Finder, datacenter, clusterName string) (bool, *object.ClusterComputeResource, error)

+ func (v *CloudDriver) GetCurrentVmwareUser(ctx context.Context) (string, error)

+ func (v *CloudDriver) GetDatacenterIfExists(ctx context.Context, finder *find.Finder, datacenter string) (bool, *object.Datacenter, error)

+ func (v *CloudDriver) GetFinderWithDatacenter(ctx context.Context, datacenter string) (*find.Finder, string, error)

+ func (v *CloudDriver) GetFolderIfExists(ctx context.Context, finder *find.Finder, folderName string) (bool, *object.Folder, error)

+ func (v *CloudDriver) GetFolderNameByID(ctx context.Context, datacenter, id string) (string, error)

+ func (v *CloudDriver) GetHostClusterMapping(ctx context.Context) (map[string]string, error)

+ func (v *CloudDriver) GetHostIfExists(ctx context.Context, finder *find.Finder, ...) (bool, *object.HostSystem, error)

+ func (v *CloudDriver) GetMetrics(ctx context.Context, c *vim25.Client) ([]performance.EntityMetric, error)

+ func (v *CloudDriver) GetResourcePoolIfExists(ctx context.Context, finder *find.Finder, ...) (bool, *object.ResourcePool, error)

+ func (v *CloudDriver) GetResourcePools(ctx context.Context, datacenter string, cluster string) ([]*object.ResourcePool, error)

+ func (v *CloudDriver) GetResourceTags(ctx context.Context, resourceType string) (map[string]tags.AttachedTags, error)

+ func (v *CloudDriver) GetVAppIfExists(ctx context.Context, finder *find.Finder, vAppName string) (bool, *object.VirtualApp, error)

+ func (v *CloudDriver) GetVMIfExists(ctx context.Context, finder *find.Finder, vmName string) (bool, *object.VirtualMachine, error)

+ func (v *CloudDriver) GetVSphereClusters(ctx context.Context, datacenter string) ([]string, error)

+ func (v *CloudDriver) GetVSphereDatacenters(ctx context.Context) ([]string, error)

+ func (v *CloudDriver) GetVSphereHostSystems(ctx context.Context, datacenter, cluster string) ([]HostSystem, error)

+ func (v *CloudDriver) GetVSphereResourcePools(ctx context.Context, datacenter string, cluster string) (resourcePools []string, err error)

+ func (v *CloudDriver) GetVSphereVMFolders(ctx context.Context, datacenter string) ([]string, error)

+ func (v *CloudDriver) GetVSphereVms(ctx context.Context, dcName string) ([]VM, error)

+ func (v *CloudDriver) GetVapps(ctx context.Context) ([]mo.VirtualApp, error)

+ func (v *CloudDriver) IsAdminAccount(ctx context.Context) (bool, error)

+ func (v *CloudDriver) IsValidVSphereCredentials() (bool, error)

+ func (v *CloudDriver) ValidateHostNTPSettings(ctx context.Context, finder *find.Finder, datacenter, clusterName string, ...) (bool, []string, error)

+ func (v *CloudDriver) ValidateUserPrivilegeOnEntities(ctx context.Context, authManager *object.AuthorizationManager, ...) (isValid bool, failures []string, err error)

+ func (v *CloudDriver) ValidateVsphereVersion(constraint string) error

type Datastore

+ ID string

+ type Driver interface

+ GetHostClusterMapping func(ctx context.Context) (map[string]string, error)

+ GetResourcePools func(ctx context.Context, datacenter string, cluster string) ([]*object.ResourcePool, error)

+ GetResourceTags func(ctx context.Context, resourceType string) (map[string]tags.AttachedTags, error)

+ GetVSphereClusters func(ctx context.Context, datacenter string) ([]string, error)

+ GetVSphereDatacenters func(ctx context.Context) ([]string, error)

+ GetVSphereHostSystems func(ctx context.Context, datacenter, cluster string) ([]HostSystem, error)

+ GetVSphereVMFolders func(ctx context.Context, datacenter string) ([]string, error)

+ GetVSphereVms func(ctx context.Context, dcName string) ([]VM, error)

+ GetVapps func(ctx context.Context) ([]mo.VirtualApp, error)

+ IsAdminAccount func(ctx context.Context) (bool, error)

+ IsValidVSphereCredentials func() (bool, error)

+ ValidateVsphereVersion func(constraint string) error

+ type HostSystem struct

+ Name string

+ Reference string

+ type LibvirtVMInfo struct

+ DataPool string

+ ImagePool string

type Metrics

+ CPUCores string

+ CPUUsage string

+ func ToVMMetrics(name string, metrics []performance.EntityMetric) Metrics

+ type Network struct

+ IP string

+ Interface string

+ Type string

+ type SSHInfo struct

+ Password string

+ PrivateKey []string

+ PublicKey []string

+ Username string

+ type VM struct

+ AdditionalDisk []AdditionalDisk

+ CPU int32

+ Host string

+ IPAddress string

+ LibvirtVMInfo LibvirtVMInfo

+ Memory int32

+ Metrics Metrics

+ Name string

+ Network []Network

+ RootDiskSize int32

+ SSHInfo SSHInfo

+ Status string

+ Storage []Datastore

+ Type string

+ VMInfo VMInfo

+ type VMInfo struct

+ Cluster string

+ Datastore string

+ Folder string

+ Network string

v0.0.26

Jun 12, 2024

Changes in this version

type MockVsphereDriver

+ func (d MockVsphereDriver) IsAdminAccount(ctx context.Context) (bool, error)

type VSphereCloudDriver

+ func (v *VSphereCloudDriver) IsAdminAccount(ctx context.Context) (bool, error)

type VsphereDriver

+ IsAdminAccount func(ctx context.Context) (bool, error)

v0.0.25

Jun 12, 2024

Changes in this version

+ var IsAdminAccount = isAdminAccount

+ func ConfigureSSOClient(ctx context.Context, driver *VSphereCloudDriver) (*ssoadmin.Client, error)

v0.0.24

Jun 9, 2024

v0.0.23

Jun 6, 2024

Changes in this version

+ const ComputeClusterTagCategory

+ const DatacenterTagCategory

+ type AdditionalDisk struct

+ Available string

+ Capacity string

+ Device string

+ Name string

+ Usage string

+ Used string

+ type Datastore struct

+ Id string

+ Name string

+ type LibvirtVmInfo struct

+ DataPool string

+ ImagePool string

+ type Metrics struct

+ CpuCores string

+ CpuUsage string

+ DiskProvisioned string

+ DiskUsage string

+ MemoryBytes string

+ MemoryUsage string

+ func ToVmMetrics(name string, metrics []performance.EntityMetric) Metrics

+ func ToVsphereMetrics(metric performance.EntityMetric) Metrics

+ type MockVsphereDriver struct

+ Clusters []string

+ Datacenters []string

+ HostClusterMapping map[string]string

+ HostSystems map[string][]VSphereHostSystem

+ ResourcePools []*object.ResourcePool

+ ResourceTags map[string]tags.AttachedTags

+ VApps []mo.VirtualApp

+ VMFolders []string

+ VMs []VSphereVM

+ func (d MockVsphereDriver) GetHostClusterMapping(ctx context.Context) (map[string]string, error)

+ func (d MockVsphereDriver) GetResourcePools(ctx context.Context, datacenter string, cluster string) ([]*object.ResourcePool, error)

+ func (d MockVsphereDriver) GetResourceTags(ctx context.Context, resourceType string) (map[string]tags.AttachedTags, error)

+ func (d MockVsphereDriver) GetVSphereClusters(ctx context.Context, datacenter string) ([]string, error)

+ func (d MockVsphereDriver) GetVSphereDatacenters(ctx context.Context) ([]string, error)

+ func (d MockVsphereDriver) GetVSphereHostSystems(ctx context.Context, datacenter, cluster string) ([]VSphereHostSystem, error)

+ func (d MockVsphereDriver) GetVSphereVMFolders(ctx context.Context, datacenter string) ([]string, error)

+ func (d MockVsphereDriver) GetVSphereVms(ctx context.Context, dcName string) ([]VSphereVM, error)

+ func (d MockVsphereDriver) GetVapps(ctx context.Context) ([]mo.VirtualApp, error)

+ func (d MockVsphereDriver) IsValidVSphereCredentials(ctx context.Context) (bool, error)

+ func (d MockVsphereDriver) ValidateVsphereVersion(constraint string) error

+ type SshInfo struct

+ Password string

+ PrivateKey []string

+ PublicKey []string

+ Username string

type VSphereCloudDriver

+ func (v *VSphereCloudDriver) GetHostClusterMapping(ctx context.Context) (map[string]string, error)

+ func (v *VSphereCloudDriver) GetMetrics(ctx context.Context, c *vim25.Client, vms []mo.VirtualMachine) ([]performance.EntityMetric, error)

+ func (v *VSphereCloudDriver) GetResourcePools(ctx context.Context, datacenter string, cluster string) ([]*object.ResourcePool, error)

+ func (v *VSphereCloudDriver) GetResourceTags(ctx context.Context, resourceType string) (map[string]tags.AttachedTags, error)

+ func (v *VSphereCloudDriver) GetVSphereClusters(ctx context.Context, datacenter string) ([]string, error)

+ func (v *VSphereCloudDriver) GetVSphereDatacenters(ctx context.Context) ([]string, error)

+ func (v *VSphereCloudDriver) GetVSphereHostSystems(ctx context.Context, datacenter, cluster string) ([]VSphereHostSystem, error)

+ func (v *VSphereCloudDriver) GetVSphereVMFolders(ctx context.Context, datacenter string) ([]string, error)

+ func (v *VSphereCloudDriver) GetVSphereVms(ctx context.Context, dcName string) ([]VSphereVM, error)

+ func (v *VSphereCloudDriver) GetVapps(ctx context.Context) ([]mo.VirtualApp, error)

+ func (v *VSphereCloudDriver) IsValidVSphereCredentials(ctx context.Context) (bool, error)

+ func (v *VSphereCloudDriver) ValidateVsphereVersion(constraint string) error

+ type VSphereHostSystem struct

+ Name string

+ Reference string

+ type VSphereNetwork struct

+ Interface string

+ Ip string

+ Type string

+ type VSphereVM struct

+ AdditionalDisk []AdditionalDisk

+ Cpu int32

+ Host string

+ IpAddress string

+ LibvirtVmInfo LibvirtVmInfo

+ Memory int32

+ Metrics Metrics

+ Name string

+ Network []VSphereNetwork

+ RootDiskSize int32

+ SshInfo SshInfo

+ Status string

+ Storage []Datastore

+ Type string

+ VSphereVmInfo VSphereVmInfo

+ func ToVSphereVM(param mo.VirtualMachine, metrics []performance.EntityMetric, ...) VSphereVM

+ func ToVSphereVMs(params []mo.VirtualMachine, metrics []performance.EntityMetric, ...) []VSphereVM

+ type VSphereVmInfo struct

+ Cluster string

+ Datastore string

+ Folder string

+ Network string

+ type VsphereDriver interface

+ GetHostClusterMapping func(ctx context.Context) (map[string]string, error)

+ GetResourcePools func(ctx context.Context, datacenter string, cluster string) ([]*object.ResourcePool, error)

+ GetResourceTags func(ctx context.Context, resourceType string) (map[string]tags.AttachedTags, error)

+ GetVSphereClusters func(ctx context.Context, datacenter string) ([]string, error)

+ GetVSphereDatacenters func(ctx context.Context) ([]string, error)

+ GetVSphereHostSystems func(ctx context.Context, datacenter, cluster string) ([]VSphereHostSystem, error)

+ GetVSphereVMFolders func(ctx context.Context, datacenter string) ([]string, error)

+ GetVSphereVms func(ctx context.Context, dcName string) ([]VSphereVM, error)

+ GetVapps func(ctx context.Context) ([]mo.VirtualApp, error)

+ IsValidVSphereCredentials func(ctx context.Context) (bool, error)

+ ValidateVsphereVersion func(constraint string) error

v0.0.22

May 28, 2024

v0.0.21

May 23, 2024

v0.0.20

May 17, 2024

Changes in this version

+ const KeepAliveIntervalInMinute

+ func ClearCache(sessionKey string)

+ func GetVmwareUserPrivileges(userPrincipal string, groupPrincipals []string, ...) (map[string]bool, error)

+ type HostDateInfo struct

+ ClientStatus string

+ Current *time.Time

+ HostName string

+ NtpServers []string

+ Service *types.HostService

+ ServiceStatus string

+ type Session struct

+ GovmomiClient *govmomi.Client

+ RestClient *rest.Client

+ func GetOrCreateSession(ctx context.Context, server, username, password string, refreshRestClient bool) (Session, error)

+ type VSphereCloudDriver struct

+ Client *govmomi.Client

+ Datacenter string

+ RestClient *rest.Client

+ VCenterPassword string

+ VCenterServer string

+ VCenterUsername string

+ func NewVSphereDriver(VCenterServer, VCenterUsername, VCenterPassword, datacenter string) (*VSphereCloudDriver, error)

+ func (v *VSphereCloudDriver) CreateVSphereVMFolder(ctx context.Context, datacenter string, folders []string) error

+ func (v *VSphereCloudDriver) FolderExists(ctx context.Context, finder *find.Finder, datacenter, folderName string) (bool, error)

+ func (v *VSphereCloudDriver) GetClusterIfExists(ctx context.Context, finder *find.Finder, datacenter, clusterName string) (bool, *object.ClusterComputeResource, error)

+ func (v *VSphereCloudDriver) GetCurrentVmwareUser(ctx context.Context) (string, error)

+ func (v *VSphereCloudDriver) GetDatacenterIfExists(ctx context.Context, finder *find.Finder, datacenter string) (bool, *object.Datacenter, error)

+ func (v *VSphereCloudDriver) GetFinderWithDatacenter(ctx context.Context, datacenter string) (*find.Finder, string, error)

+ func (v *VSphereCloudDriver) GetFolderIfExists(ctx context.Context, finder *find.Finder, datacenter, folderName string) (bool, *object.Folder, error)

+ func (v *VSphereCloudDriver) GetFolderNameByID(ctx context.Context, datacenter, id string) (string, error)

+ func (v *VSphereCloudDriver) GetHostIfExists(ctx context.Context, finder *find.Finder, ...) (bool, *object.HostSystem, error)

+ func (v *VSphereCloudDriver) GetResourcePoolIfExists(ctx context.Context, finder *find.Finder, ...) (bool, *object.ResourcePool, error)

+ func (v *VSphereCloudDriver) GetVAppIfExists(ctx context.Context, finder *find.Finder, datacenter, vAppName string) (bool, *object.VirtualApp, error)

+ func (v *VSphereCloudDriver) GetVMIfExists(ctx context.Context, finder *find.Finder, datacenter, cluster, vmName string) (bool, *object.VirtualMachine, error)

+ func (v *VSphereCloudDriver) GetVSphereResourcePools(ctx context.Context, datacenter string, cluster string) (resourcePools []string, err error)

+ func (v *VSphereCloudDriver) ValidateHostNTPSettings(ctx context.Context, finder *find.Finder, datacenter, clusterName string, ...) (bool, []string, error)

+ func (v *VSphereCloudDriver) ValidateUserPrivilegeOnEntities(ctx context.Context, authManager *object.AuthorizationManager, ...) (isValid bool, failures []string, err error)

+ type VsphereCloudAccount struct

+ Insecure bool

+ Password string

+ Username string

+ VcenterServer string

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL