{"openapi":"3.0.0","info":{"title":"OVHcloud API specification","description":"Specification for OVHcloud API","version":"1.0","contact":{"name":"OVH","email":"api@ml.ovh.net"}},"servers":[{"url":"https://api.eu.ovhcloud.com/v2"}],"components":{"schemas":{"any":{"description":"Can be anything (text, int, bool, json, html, etc.)","example":"This is a content of any type !"},"backup.AddonEnum":{"type":"string","description":"Add-on features that can be enabled on a VSPC tenant","enum":["BACKUP_AGENT","BACKUP_LICENSES","MANAGED_BACKUP"]},"backup.AgentProductTypeEnum":{"type":"string","description":"Backup agent target product type for your environment","enum":["ON_PREMISE","OVHCLOUD_BAREMETAL","OVHCLOUD_PUBLIC_CLOUD","OVHCLOUD_VPS"]},"backup.BucketPerformanceEnum":{"type":"string","description":"Defines performance levels for a bucket","enum":["HIGH_PERF","STANDARD"]},"backup.BucketRoleEnum":{"type":"string","description":"Roles that a bucket can assume","enum":["PRIMARY","REPLICA"]},"backup.ManagedBackupSizeBandEnum":{"type":"string","description":"Billing size band of a protected virtual machine. Each value is the exclusive upper bound of the used size, a size on a boundary falls into the upper band.","enum":["MAX_1TB","MAX_250GB","MAX_2TB","MAX_4TB","MAX_6TB","MAX_8TB"]},"backup.ManagedBackupVaultLevelEnum":{"type":"string","description":"Protection level of a Managed Backup vault, selected per virtual machine with the vSphere tag of the same name (standard, advanced or premium)","enum":["ADVANCED","PREMIUM","STANDARD"]},"backup.ManagedBackupVmProtectionStatusEnum":{"type":"string","description":"Indicates whether a virtual machine carries a valid Managed Backup vault tag. Independent of the result of its backups.","enum":["PROTECTED","UNPROTECTED"]},"backup.RegionCodeEnum":{"type":"string","description":"Short S3 region code of the Object Storage endpoint, entered in lower case","enum":["ap-south-mum","ap-southeast-syd","bhs","ca-east-tor","de","eu-south-mil","eu-west-par","gra","rbx","sbg","sgp","uk","waw"]},"backup.VaultProductLineEnum":{"type":"string","description":"Product line that owns the vault","enum":["BACKUP_AGENT","BACKUP_LICENSES","MANAGED_BACKUP"]},"backup.VaultTypeEnum":{"type":"string","description":"Indicates a vault billing type","enum":["BUNDLE","PAYGO"]},"backup.VspcTypeEnum":{"type":"string","description":"VSPC infrastructure type backing the tenant, set by the platform at provisioning. BASIC carries backup agents, ADVANCED carries Backup Licenses and Managed Backup.","enum":["ADVANCED","BASIC"]},"backup.reference.ManagedBackupVaultRegion":{"type":"object","description":"Regions hosting the vaults of the Managed Backup service of a Hosted Private Cloud located in a given region, and the regions allowed for their replica. Static reference data, identical for every customer.","properties":{"primaryRegionName":{"allOf":[{"$ref":"#/components/schemas/common.RegionEnum"}],"description":"Region hosting the backup stack and the primary copy of the vaults for a Hosted Private Cloud located in this region, as reported in the vaultRegion of a Managed Backup service","readOnly":true},"secondaryRegions":{"type":"array","description":"Regions that can be chosen as replication secondary site when ordering a Managed Backup service for a Hosted Private Cloud located in this region","items":{"$ref":"#/components/schemas/backup.reference.ManagedBackupVaultRegionCandidate"},"readOnly":true}}},"backup.reference.ManagedBackupVaultRegionCandidate":{"type":"object","description":"A region that can be chosen as replication secondary site","properties":{"name":{"allOf":[{"$ref":"#/components/schemas/common.RegionEnum"}],"description":"Region that can be chosen as replication secondary site","readOnly":true},"preferred":{"type":"boolean","description":"True for the default secondary region proposed at order time. Absent for the other candidates.","readOnly":true}}},"backup.tenant":{"type":"object","description":"Backup tenant resource","properties":{"createdAt":{"type":"string","description":"Date and time the backup tenant is created","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.CurrentState"}],"description":"Current operational state of the backup tenant","readOnly":true},"currentTasks":{"type":"array","description":"List of tasks that are currently running for the backup tenant","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"id":{"type":"string","description":"Unique identifier of the backup tenant","format":"uuid","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Readiness status of the backup tenant","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.TargetSpec"}],"description":"Specification of the target state of the backup tenant","readOnly":true},"updatedAt":{"type":"string","description":"Date and time the backup tenant is last updated","format":"date-time","readOnly":true}}},"backup.tenant.CurrentState":{"type":"object","description":"Shows the current state of a backup tenant with its associated VSPC tenants and vaults","properties":{"id":{"type":"string","description":"Identifier of the backup tenant","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the backup tenant","readOnly":true},"vaults":{"type":"array","description":"List of vault resource names associated with the backup tenant","items":{"type":"string"},"readOnly":true},"vspcTenants":{"type":"array","description":"List of VSPC tenant resource names associated with the backup tenant","items":{"type":"string"},"readOnly":true}}},"backup.tenant.TargetSpec":{"type":"object","description":"Specifies the target state of your backup tenant","properties":{"name":{"type":"string","description":"The display name of your backup tenant","readOnly":true}}},"backup.tenant.vault":{"type":"object","description":"Represents a backup tenant vault","properties":{"createdAt":{"type":"string","description":"Date and time when you created the vault","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vault.CurrentState"}],"description":"Current state of your vault","readOnly":true},"currentTasks":{"type":"array","description":"List of tasks currently running on your vault","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"id":{"type":"string","description":"Unique identifier of your vault. A UUID for Backup Agent and Backup Licenses vaults, the vault name for Managed Backup vaults.","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Indicates the readiness of your vault","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vault.TargetSpec"}],"description":"Specification of your vault target","readOnly":true},"updatedAt":{"type":"string","description":"Date and time when you last updated the vault","format":"date-time","readOnly":true}}},"backup.tenant.vault.CurrentState":{"type":"object","description":"Provides vault resource for a backup tenant","properties":{"buckets":{"type":"array","description":"Provides list of vault buckets","items":{"$ref":"#/components/schemas/backup.tenant.vault.bucket"},"readOnly":true},"id":{"type":"string","description":"Identifies the vault uniquely. A UUID for Backup Agent and Backup Licenses vaults, the vault name for Managed Backup vaults.","readOnly":true},"includedSoftQuotaGb":{"type":"integer","description":"Included soft quota in GB for a Backup Licenses BUNDLE vault. Null for PAYGO, BACKUP_AGENT, MANAGED_BACKUP or when not applicable.","nullable":true,"readOnly":true},"name":{"type":"string","description":"Specifies the vault name","readOnly":true},"region":{"allOf":[{"$ref":"#/components/schemas/common.RegionEnum"}],"description":"Specifies the region where the vault is located","readOnly":true},"resourceName":{"type":"string","description":"Specifies the vault resource name","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Indicates the current status of the vault","readOnly":true},"type":{"allOf":[{"$ref":"#/components/schemas/backup.VaultTypeEnum"}],"description":"Specifies the vault type","readOnly":true},"vaultProductLine":{"allOf":[{"$ref":"#/components/schemas/backup.VaultProductLineEnum"}],"description":"Product line that owns the vault. Interpret it together with type to tell the two PAYGO offers apart. Null for vaults created before this field existed.","nullable":true,"readOnly":true},"vspcTenants":{"type":"array","description":"Lists resource names of VSPC tenants linked to the vault","items":{"type":"string"},"readOnly":true}}},"backup.tenant.vault.TargetSpec":{"type":"object","description":"Specifies the target state of your vault","properties":{"name":{"type":"string","description":"Display name of your vault"}},"required":["name"]},"backup.tenant.vault.bucket":{"type":"object","description":"Represents a bucket resource for a vault","properties":{"encrypted":{"type":"boolean","description":"Whether the backup data stored in the bucket is encrypted. Always true for Managed Backup buckets. Null when not reported by the platform.","nullable":true,"readOnly":true},"id":{"type":"string","description":"Specifies the unique identifier of the bucket","format":"uuid","readOnly":true},"immutability":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vault.bucket.Immutability"}],"description":"Immutability settings of the bucket, enabled on the buckets of a PREMIUM Managed Backup vault. Null when not reported by the platform.","nullable":true,"readOnly":true},"name":{"type":"string","description":"Specifies the name of the bucket","readOnly":true},"performance":{"allOf":[{"$ref":"#/components/schemas/backup.BucketPerformanceEnum"}],"description":"Specifies the performance tier of the bucket","readOnly":true},"region":{"allOf":[{"$ref":"#/components/schemas/common.RegionEnum"}],"description":"Specifies the geographic region where the bucket is located","readOnly":true},"role":{"allOf":[{"$ref":"#/components/schemas/backup.BucketRoleEnum"}],"description":"Specifies the role assigned to the bucket","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Specifies the current status of the bucket","readOnly":true}}},"backup.tenant.vault.bucket.Credentials":{"type":"object","description":"S3 credentials and connection endpoint of a vault bucket. Credentials are sensitive, never log or cache them.","properties":{"accessKey":{"type":"string","description":"S3 access key","readOnly":true},"bucketName":{"type":"string","description":"Name of the bucket these credentials belong to","readOnly":true},"endpoint":{"type":"string","description":"S3 endpoint URL to configure in your environment","readOnly":true},"regionCode":{"allOf":[{"$ref":"#/components/schemas/backup.RegionCodeEnum"}],"description":"Short region code of the bucket","readOnly":true},"secretKey":{"type":"string","description":"S3 secret key, sensitive value","format":"password","readOnly":true}}},"backup.tenant.vault.bucket.Immutability":{"type":"object","description":"Immutability settings of a vault bucket. When enabled, no one can modify or delete a restore point during the retention period.","properties":{"enabled":{"type":"boolean","description":"Whether restore points stored in the bucket are immutable","readOnly":true},"retentionDays":{"type":"integer","description":"Number of days during which a restore point can neither be modified nor deleted. Null when immutability is disabled.","nullable":true,"readOnly":true}}},"backup.tenant.vaultWithIAM":{"type":"object","description":"Represents a backup tenant vault","properties":{"createdAt":{"type":"string","description":"Date and time when you created the vault","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vault.CurrentState"}],"description":"Current state of your vault","readOnly":true},"currentTasks":{"type":"array","description":"List of tasks currently running on your vault","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"iam":{"allOf":[{"$ref":"#/components/schemas/iam.ResourceMetadata"}],"description":"IAM resource metadata","nullable":true,"readOnly":true},"id":{"type":"string","description":"Unique identifier of your vault. A UUID for Backup Agent and Backup Licenses vaults, the vault name for Managed Backup vaults.","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Indicates the readiness of your vault","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vault.TargetSpec"}],"description":"Specification of your vault target","readOnly":true},"updatedAt":{"type":"string","description":"Date and time when you last updated the vault","format":"date-time","readOnly":true}}},"backup.tenant.vspc":{"type":"object","description":"Represents a VSPC tenant","properties":{"createdAt":{"type":"string","description":"Date and time when the tenant is created","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vspc.CurrentState"}],"description":"Current state of the tenant","readOnly":true},"currentTasks":{"type":"array","description":"List of tasks currently running for the tenant","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"id":{"type":"string","description":"Unique identifier of the tenant","format":"uuid","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Indicates whether the vault is ready","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vspc.TargetSpec"}],"description":"Specification of the target for the tenant","readOnly":true},"updatedAt":{"type":"string","description":"Date and time when the tenant is last updated","format":"date-time","readOnly":true}}},"backup.tenant.vspc.CurrentState":{"type":"object","description":"Details about a VSPC tenant","properties":{"accessUrl":{"type":"string","description":"URL you use to access the tenant","readOnly":true},"backupAgents":{"type":"array","description":"Backup agents associated with the tenant","items":{"$ref":"#/components/schemas/backup.tenant.vspc.backupAgent.CurrentState"},"readOnly":true},"backupLicensesId":{"type":"string","description":"Backup Licenses subscription identifier of the tenant. Null when the Backup Licenses add-on is not enabled.","nullable":true,"readOnly":true},"companyName":{"type":"string","description":"Name of your tenant company in VSPC","readOnly":true},"enabledAddons":{"type":"array","description":"Add-ons active on this tenant","items":{"$ref":"#/components/schemas/backup.AddonEnum"},"readOnly":true},"id":{"type":"string","description":"Unique identifier of the tenant","format":"uuid","readOnly":true},"managedBackupIds":{"type":"array","description":"Managed Backup service identifiers of the tenant, one per protected Hosted Private Cloud, each formatted managed-backup- followed by the Hosted Private Cloud service name. Null when the Managed Backup add-on is not enabled.","nullable":true,"items":{"type":"string"},"readOnly":true},"name":{"type":"string","description":"Display name of the tenant","readOnly":true},"region":{"allOf":[{"$ref":"#/components/schemas/common.RegionEnum"}],"description":"Region where the tenant is located","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Current status of the tenant","readOnly":true},"vaults":{"type":"array","description":"Vaults linked to the tenant","items":{"$ref":"#/components/schemas/backup.tenant.vspc.vault"},"readOnly":true},"vspcType":{"allOf":[{"$ref":"#/components/schemas/backup.VspcTypeEnum"}],"description":"VSPC infrastructure type backing this tenant. BASIC carries backup agents, ADVANCED carries Backup Licenses and Managed Backup.","readOnly":true}}},"backup.tenant.vspc.TargetSpec":{"type":"object","description":"Specifies the target state of your VSPC tenant","properties":{"name":{"type":"string","description":"Display name of the tenant"}},"required":["name"]},"backup.tenant.vspc.backupAgent.CurrentState":{"type":"object","description":"Represents a VSPC backup agent","properties":{"id":{"type":"string","description":"Unique identifier of the backup agent","format":"uuid","readOnly":true},"ips":{"type":"array","description":"List of IP addresses assigned to the backup agent","items":{"$ref":"#/components/schemas/ipBlock"},"readOnly":true},"name":{"type":"string","description":"Name of the backup agent","readOnly":true},"policy":{"type":"string","description":"VSPC backup policy configured for the agent","readOnly":true},"productResourceName":{"type":"string","description":"Resource name of the product backed up by the agent","readOnly":true},"type":{"allOf":[{"$ref":"#/components/schemas/backup.AgentProductTypeEnum"}],"description":"Type of the product managed by the agent","readOnly":true},"vaultId":{"type":"string","description":"Unique identifier of the vault storing the backup agent data","nullable":true,"format":"uuid","readOnly":true}}},"backup.tenant.vspc.managedBackup":{"type":"object","description":"Represents a Managed Backup service protecting one Hosted Private Cloud. Ordered and terminated through the OVHcloud Control Panel.","properties":{"createdAt":{"type":"string","description":"Date and time when the service is created","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup.CurrentState"}],"description":"Current state of the service","readOnly":true},"currentTasks":{"type":"array","description":"Current tasks running on the service","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"id":{"type":"string","description":"Unique identifier of the Managed Backup service, formatted managed-backup- followed by the service name of the protected Hosted Private Cloud","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Indicates the readiness of the service. SUSPENDED while backup schedules are stopped.","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup.TargetSpec"}],"description":"Target specification for the service","readOnly":true},"updatedAt":{"type":"string","description":"Date and time when the service is last updated","format":"date-time","readOnly":true}}},"backup.tenant.vspc.managedBackup.Consumption":{"type":"object","description":"Current billable consumption of a Managed Backup service: number of backed up virtual machines per vault level and size band. No price is returned.","properties":{"billedVmCount":{"type":"integer","description":"Number of virtual machines generating a billing line, the sum of the vmCount of all lines","readOnly":true},"lines":{"type":"array","description":"One line per non-empty combination of vault level and size band. Empty while the service is suspended.","items":{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup.ConsumptionLine"},"readOnly":true}}},"backup.tenant.vspc.managedBackup.ConsumptionLine":{"type":"object","description":"Number of backed up virtual machines for one combination of vault level and size band","properties":{"planCode":{"type":"string","description":"Plan code of the consumption plan the line is billed on","readOnly":true},"sizeBand":{"allOf":[{"$ref":"#/components/schemas/backup.ManagedBackupSizeBandEnum"}],"description":"Billing size band of the line","readOnly":true},"vaultLevel":{"allOf":[{"$ref":"#/components/schemas/backup.ManagedBackupVaultLevelEnum"}],"description":"Vault level of the line","readOnly":true},"vmCount":{"type":"integer","description":"Number of virtual machines whose last backup was validated in this vault level and size band","readOnly":true}}},"backup.tenant.vspc.managedBackup.CurrentState":{"type":"object","description":"Observed state of a Managed Backup service, collected from the backup platform","properties":{"hostedPrivateCloudServiceName":{"type":"string","description":"Service name of the protected Hosted Private Cloud. Set at order time, cannot be changed.","readOnly":true},"protectedVmCount":{"type":"integer","description":"Number of virtual machines carrying a valid vault tag","readOnly":true},"unprotectedVmCount":{"type":"integer","description":"Number of virtual machines without a valid vault tag, not backed up and not billed","readOnly":true},"vaultRegion":{"allOf":[{"$ref":"#/components/schemas/common.RegionEnum"}],"description":"Region hosting the backup stack and the primary copy of the vaults of the service","readOnly":true},"vaultSecondaryRegion":{"allOf":[{"$ref":"#/components/schemas/common.RegionEnum"}],"description":"Region hosting the replicated copy of the ADVANCED and PREMIUM vaults of the service. Chosen at order time, cannot be changed.","readOnly":true},"vbrLogin":{"type":"string","description":"Username of your account on the Veeam Backup & Replication web interface. Its password is delivered at activation and on every resetPassword action. Null while the service is being created.","nullable":true,"readOnly":true},"vbrUrl":{"type":"string","description":"URL of the Veeam Backup & Replication web interface where backup jobs, restores and file-level recoveries are managed. Null while the service is being created.","nullable":true,"readOnly":true}}},"backup.tenant.vspc.managedBackup.TargetSpec":{"type":"object","description":"Specifies the desired state of a Managed Backup service","properties":{"displayName":{"type":"string","description":"Display name of the service"}},"required":["displayName"]},"backup.tenant.vspc.managedBackup.virtualMachine":{"type":"object","description":"Protection state of a virtual machine of the Hosted Private Cloud covered by the Managed Backup service","properties":{"id":{"type":"string","description":"vSphere managed object reference of the virtual machine, vm- prefix included, for example vm-4021. A restored virtual machine is a new vSphere object with a new identifier.","readOnly":true},"lastBackupAt":{"type":"string","description":"Date and time of the last backup cycle that included the virtual machine. Null when it has never been backed up.","nullable":true,"format":"date-time","readOnly":true},"name":{"type":"string","description":"Name of the virtual machine in vSphere at the last refresh","readOnly":true},"protectionStatus":{"allOf":[{"$ref":"#/components/schemas/backup.ManagedBackupVmProtectionStatusEnum"}],"description":"Indicates whether the virtual machine carries a valid vault tag. Independent of the result of its backups.","readOnly":true},"refreshedAt":{"type":"string","description":"Date and time when this entry was last refreshed from the backup platform","format":"date-time","readOnly":true},"restorePointCount":{"type":"integer","description":"Number of restore points currently held for the virtual machine. 0 when it has never been backed up.","readOnly":true},"sizeBand":{"allOf":[{"$ref":"#/components/schemas/backup.ManagedBackupSizeBandEnum"}],"description":"Billing size band validated at the last backup of the virtual machine. Null when no backup has been validated yet.","nullable":true,"readOnly":true},"vaultLevel":{"allOf":[{"$ref":"#/components/schemas/backup.ManagedBackupVaultLevelEnum"}],"description":"Vault level resolved from the vSphere tag of the virtual machine at the last backup cycle. The tag category allows a single vault tag per virtual machine. Null when the virtual machine is unprotected.","nullable":true,"readOnly":true},"vmSizeGb":{"type":"integer","description":"Used size of the virtual machine in GB, measured at the last backup and used to compute its sizeBand. Null when no measurement is available yet.","nullable":true,"readOnly":true}}},"backup.tenant.vspc.managedBackupWithIAM":{"type":"object","description":"Represents a Managed Backup service protecting one Hosted Private Cloud. Ordered and terminated through the OVHcloud Control Panel.","properties":{"createdAt":{"type":"string","description":"Date and time when the service is created","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup.CurrentState"}],"description":"Current state of the service","readOnly":true},"currentTasks":{"type":"array","description":"Current tasks running on the service","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"iam":{"allOf":[{"$ref":"#/components/schemas/iam.ResourceMetadata"}],"description":"IAM resource metadata","nullable":true,"readOnly":true},"id":{"type":"string","description":"Unique identifier of the Managed Backup service, formatted managed-backup- followed by the service name of the protected Hosted Private Cloud","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Indicates the readiness of the service. SUSPENDED while backup schedules are stopped.","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup.TargetSpec"}],"description":"Target specification for the service","readOnly":true},"updatedAt":{"type":"string","description":"Date and time when the service is last updated","format":"date-time","readOnly":true}}},"backup.tenant.vspc.vault":{"type":"object","description":"Represent a vault linked to your VSPC tenant","properties":{"allowedIps":{"type":"array","description":"Provides list of allowed IPs at the vault level","items":{"$ref":"#/components/schemas/ipBlock"},"readOnly":true},"id":{"type":"string","description":"Unique identifier of the vault","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the vault","readOnly":true},"performance":{"allOf":[{"$ref":"#/components/schemas/backup.BucketPerformanceEnum"}],"description":"Performance tier of the vault","readOnly":true},"region":{"allOf":[{"$ref":"#/components/schemas/common.RegionEnum"}],"description":"Geographic region where the vault is located","readOnly":true},"resourceName":{"type":"string","description":"Resource name of the vault as used in the system","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Current status of the vault","readOnly":true},"type":{"allOf":[{"$ref":"#/components/schemas/backup.VaultTypeEnum"}],"description":"Kind of vault","readOnly":true}}},"backup.tenant.vspcWithIAM":{"type":"object","description":"Represents a VSPC tenant","properties":{"createdAt":{"type":"string","description":"Date and time when the tenant is created","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vspc.CurrentState"}],"description":"Current state of the tenant","readOnly":true},"currentTasks":{"type":"array","description":"List of tasks currently running for the tenant","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"iam":{"allOf":[{"$ref":"#/components/schemas/iam.ResourceMetadata"}],"description":"IAM resource metadata","nullable":true,"readOnly":true},"id":{"type":"string","description":"Unique identifier of the tenant","format":"uuid","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Indicates whether the vault is ready","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.vspc.TargetSpec"}],"description":"Specification of the target for the tenant","readOnly":true},"updatedAt":{"type":"string","description":"Date and time when the tenant is last updated","format":"date-time","readOnly":true}}},"backup.tenantWithIAM":{"type":"object","description":"Backup tenant resource","properties":{"createdAt":{"type":"string","description":"Date and time the backup tenant is created","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.CurrentState"}],"description":"Current operational state of the backup tenant","readOnly":true},"currentTasks":{"type":"array","description":"List of tasks that are currently running for the backup tenant","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"iam":{"allOf":[{"$ref":"#/components/schemas/iam.ResourceMetadata"}],"description":"IAM resource metadata","nullable":true,"readOnly":true},"id":{"type":"string","description":"Unique identifier of the backup tenant","format":"uuid","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Readiness status of the backup tenant","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/backup.tenant.TargetSpec"}],"description":"Specification of the target state of the backup tenant","readOnly":true},"updatedAt":{"type":"string","description":"Date and time the backup tenant is last updated","format":"date-time","readOnly":true}}},"common.CurrentTask":{"type":"object","description":"Asynchronous operation currently running","properties":{"errors":{"type":"array","description":"Errors that occurred on the task","nullable":true,"items":{"$ref":"#/components/schemas/common.TaskError"},"readOnly":true},"id":{"type":"string","description":"Identifier of the current task","format":"uuid","readOnly":true},"link":{"type":"string","description":"Link to the task details","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/common.CurrentTaskStatusEnum"}],"description":"Current global status of the current task","nullable":true,"readOnly":true},"type":{"type":"string","description":"Type of the current task","readOnly":true}}},"common.CurrentTaskStatusEnum":{"type":"string","description":"Current status of a task. A task in ERROR cannot be retried without your inputs. PENDING tasks will be executed as soon as possible. A RUNNING task is currently executing your original request. SCHEDULED is used for tasks that will be executed in the future.","enum":["ERROR","PENDING","RUNNING","SCHEDULED","WAITING_USER_INPUT"]},"common.RegionEnum":{"type":"string","description":"OVHcloud region identifier","enum":["af-north-lz-rba","ap-south-mum","ap-southeast-sgp","ap-southeast-syd","ca-east-bhs","ca-east-tor","eu-central-lz-buh","eu-central-lz-prg","eu-central-lz-sof","eu-central-waw","eu-north-lz-cph","eu-north-lz-hel","eu-north-lz-osl","eu-north-lz-sto","eu-south-lz-lis","eu-south-lz-mad","eu-south-lz-mil","eu-south-mil","eu-west-eri","eu-west-gra","eu-west-gra-snc","eu-west-lim","eu-west-lz-ams","eu-west-lz-bru","eu-west-lz-dln","eu-west-lz-lux","eu-west-lz-mnc","eu-west-lz-mrs","eu-west-lz-vie","eu-west-lz-zrh","eu-west-par","eu-west-rbx","eu-west-rbx-snc","eu-west-sbg","eu-west-sbg-snc","us-central-lz-slc","us-central-lz-stl","us-east-lz-atl","us-east-lz-bos","us-east-lz-chi","us-east-lz-dal","us-east-lz-mia","us-east-lz-nyc","us-east-vin","us-west-hil","us-west-lz-den","us-west-lz-lax","us-west-lz-pao","us-west-lz-phx","us-west-lz-sea"]},"common.ResourceStatusEnum":{"type":"string","description":"Current status of a resource","enum":["CREATING","CREATION_PLANNED","DELETING","ERROR","OUT_OF_SYNC","READY","SUSPENDED","UNKNOWN","UPDATING"]},"common.TaskError":{"type":"object","description":"Errors that occurred on the task","properties":{"message":{"type":"string","description":"Error description","readOnly":true}}},"duration":{"type":"string","description":"Duration (e.g., P1Y2M3DT4H6M9S)","example":"P1Y2M3DT4H6M9S"},"email":{"type":"string","description":"Email address (e.g., api@ml.ovh.net)","format":"email","example":"api@ml.ovh.net"},"iam.ResourceMetadata":{"type":"object","description":"IAM resource metadata embedded in services models","properties":{"displayName":{"type":"string","description":"Resource display name","nullable":true,"readOnly":true},"id":{"type":"string","description":"Unique identifier of the resource","format":"uuid","readOnly":true},"state":{"allOf":[{"$ref":"#/components/schemas/iam.ResourceMetadata.StateEnum"}],"description":"Resource state","nullable":true,"readOnly":true},"tags":{"type":"object","description":"Resource tags. Tags that were internally computed are prefixed with ovh:","nullable":true,"additionalProperties":{"type":"string"},"readOnly":true},"urn":{"type":"string","description":"Unique resource name used in policies","readOnly":true}}},"iam.ResourceMetadata.StateEnum":{"type":"string","description":"Resource state","enum":["EXPIRED","IN_CREATION","OK","SUSPENDED"]},"iam.resource.TagFilter":{"type":"object","description":"Resource tag filter","properties":{"operator":{"allOf":[{"$ref":"#/components/schemas/iam.resource.TagFilter.OperatorEnum"}],"description":"Operator to use in order to filter on the value. Defaults to `EQ`.","nullable":true,"readOnly":true},"value":{"type":"string","description":"Value to use in order to filter tags","readOnly":true}}},"iam.resource.TagFilter.OperatorEnum":{"type":"string","description":"Operator that can be used in order to filter resources tags","enum":["EQ","EXISTS","ILIKE","LIKE","NEQ","NEXISTS"]},"internationalPhoneNumber":{"type":"string","description":"International phone number","format":"phone-number"},"ip":{"type":"string","description":"IP address (e.g., 192.0.2.0)","format":"ipv4","example":"192.0.2.0"},"ipBlock":{"type":"string","description":"IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)","format":"ip-block","example":"192.0.2.0/24"},"ipInterface":{"type":"string","description":"IP address (e.g., 192.0.2.0)","format":"ipv4","example":"192.0.2.0"},"ipv4":{"type":"string","description":"IPv4 address (e.g., 192.0.2.0)","format":"ipv4","example":"192.0.2.0"},"ipv4Block":{"type":"string","description":"IPv4 CIDR notation (e.g., 192.0.2.0/24)","format":"ipv4-block","example":"192.0.2.0/24"},"ipv6":{"type":"string","description":"IPv6 address (e.g., 2001:41d0:1:1994::1)","format":"ipv6","example":"2001:41d0:1:1994::1"},"ipv6Block":{"type":"string","description":"IPv6 CIDR notation (e.g., 2001:41d0::/128)","format":"ipv6-block","example":"2001:41d0::/128"},"macAddress":{"type":"string","description":"MAC address (e.g., 00:00:5e:00:53:01)","format":"mac-address","example":"00:00:5e:00:53:01"},"phoneNumber":{"type":"string","description":"Phone number","format":"phone-number"},"time":{"type":"string","description":"Time (e.g., 15:04:05)","format":"time","example":"15:04:05"}},"securitySchemes":{"oAuth2AuthCode":{"type":"oauth2","description":"Oauth2","x-client-id":"1bb9c7df371741c0","x-client-secret":"a5b4de870aca620d10fbf63cd18d205b","flows":{"authorizationCode":{"authorizationUrl":"https://auth.eu.ovhcloud.com/oauth2/authorize","tokenUrl":"https://auth.eu.ovhcloud.com/oauth2/token","scopes":{"account/all":"Manage your account","all":"Manage your whole account and all your services","services/all":"Manage your services lifecycle and billing"}}}}}},"paths":{"/backupServices/reference/managedBackupVaultRegion":{"get":{"operationId":"getManagedBackupVaultRegions","summary":"Lists, per region where a Hosted Private Cloud is located, the region hosting the vaults of its Managed Backup service and the regions allowed as replication secondary site","security":[{"oAuth2AuthCode":[]}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/backup.reference.ManagedBackupVaultRegion"}}}}}},"x-developer-hub-navigation":[["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/reference/managedBackupVaultRegion\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/reference/managedBackupVaultRegion\");\n\nprint_r($result);\n?>"}]}},"/backupServices/tenant":{"get":{"operationId":"getAllBackupTenants","summary":"Retrieves the backup tenants you manage","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"query","name":"iamTags","description":"Filter resources on IAM tags","schema":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/iam.resource.TagFilter"}}}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/backup.tenantWithIAM"}}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:get","required":true}],"x-expanded-response":"BackupTenantWithIAM"}},"/backupServices/tenant/{backupServicesId}":{"get":{"operationId":"getBackupTenant","summary":"Retrieves the details of your backup tenant","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenantWithIAM"}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:get","required":true}]}},"/backupServices/tenant/{backupServicesId}/vault":{"get":{"operationId":"getAllBackupVaults","summary":"Lists vaults for your tenant","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"query","name":"iamTags","description":"Filter resources on IAM tags","schema":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/iam.resource.TagFilter"}}}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/backup.tenant.vaultWithIAM"}}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vault\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vault\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vault/get","required":true}],"x-expanded-response":"BackupTenantVaultWithIAM"}},"/backupServices/tenant/{backupServicesId}/vault/{vaultId}":{"get":{"operationId":"getBackupVault","summary":"Retrieves specific vault details","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"vaultId","description":"Vault ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vaultWithIAM"}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vault/get","required":true}]},"put":{"operationId":"editBackupVault","summary":"Updates vault display name and cloud repository","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"vaultId","description":"Vault ID","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vault.TargetSpec"}}}},"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vault"}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\n# Request body type: backup.tenant.vault.TargetSpec\nresult = client.put(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}\",\n\tname = None, # Display name of your vault (type: string)\n)\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n// Request body type: backup.tenant.vault.TargetSpec\n$result = $ovh->put(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}\", array(\n\tname => null, // Display name of your vault (type: string)\n));\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vault/edit","required":true}]}},"/backupServices/tenant/{backupServicesId}/vault/{vaultId}/bucket":{"get":{"operationId":"getAllBackupVaultBuckets","summary":"Lists buckets of the vault","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"vaultId","description":"Vault ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/backup.tenant.vault.bucket"}}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}/bucket\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}/bucket\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vault/get","required":true}],"x-response-identifier":"id","x-expanded-response":"BackupTenantVaultBucket"}},"/backupServices/tenant/{backupServicesId}/vault/{vaultId}/bucket/{bucketId}":{"get":{"operationId":"getBackupVaultBucket","summary":"Gets specific vault bucket details","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"bucketId","description":"Bucket ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"vaultId","description":"Vault ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vault.bucket"}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}/bucket/{bucketId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}/bucket/{bucketId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vault/get","required":true}],"x-response-identifier":"id"}},"/backupServices/tenant/{backupServicesId}/vault/{vaultId}/bucket/{bucketId}/credentials":{"get":{"operationId":"getBackupVaultBucketCredentials","summary":"Retrieves S3™*-compatible credentials and connection endpoint for a vault bucket","description":"<sup>*</sup> S3 is a trademark filed by Amazon Technologies,Inc. OVHcloud's service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies,Inc.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"bucketId","description":"Bucket ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"vaultId","description":"Vault ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vault.bucket.Credentials"}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}/bucket/{bucketId}/credentials\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vault/{vaultId}/bucket/{bucketId}/credentials\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vault/credentials/get","required":true}]}},"/backupServices/tenant/{backupServicesId}/vspc":{"get":{"operationId":"getAllVspcTenants","summary":"Retrieves list of VSPC tenants","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"query","name":"iamTags","description":"Filter resources on IAM tags","schema":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/iam.resource.TagFilter"}}}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/backup.tenant.vspcWithIAM"}}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vspc\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vspc\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/get","required":true}],"x-expanded-response":"BackupTenantVspcWithIAM"}},"/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}":{"get":{"operationId":"getVspcTenant","summary":"Retrieves details of a specific VSPC tenant","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"vspcTenantId","description":"Vspc tenant ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vspcWithIAM"}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/get","required":true}]},"put":{"operationId":"editVspcTenant","summary":"Updates the display name of a VSPC tenant","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"vspcTenantId","description":"Vspc tenant ID","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vspc.TargetSpec"}}}},"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vspc"}}}}},"x-developer-hub-navigation":[["Storage & Backup","Backup & Disaster recovery solutions","Backup Agent"],["Storage & Backup","Backup & Disaster recovery solutions","Backup Licenses"],["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\n# Request body type: backup.tenant.vspc.TargetSpec\nresult = client.put(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}\",\n\tname = None, # Display name of the tenant (type: string)\n)\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n// Request body type: backup.tenant.vspc.TargetSpec\n$result = $ovh->put(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}\", array(\n\tname => null, // Display name of the tenant (type: string)\n));\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/edit","required":true}]}},"/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup":{"get":{"operationId":"getAllManagedBackups","summary":"Retrieves the Managed Backup services of the VSPC tenant, one per protected Hosted Private Cloud; empty when the Managed Backup add-on is not enabled","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"query","name":"iamTags","description":"Filter resources on IAM tags","schema":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/iam.resource.TagFilter"}}}},{"in":"path","name":"vspcTenantId","description":"Vspc tenant ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackupWithIAM"}}}}}},"x-developer-hub-navigation":[["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/managedBackup/get","required":true}],"x-expanded-response":"BackupTenantVspcManagedBackupWithIAM"}},"/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}":{"get":{"operationId":"getManagedBackup","summary":"Retrieves a Managed Backup service of the VSPC tenant","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"managedBackupId","description":"Managed backup ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"vspcTenantId","description":"Vspc tenant ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackupWithIAM"}}}}},"x-developer-hub-navigation":[["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/managedBackup/get","required":true}]},"put":{"operationId":"editManagedBackup","summary":"Updates the display name of a Managed Backup service","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"managedBackupId","description":"Managed backup ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"vspcTenantId","description":"Vspc tenant ID","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup.TargetSpec"}}}},"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup"}}}}},"x-developer-hub-navigation":[["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\n# Request body type: backup.tenant.vspc.managedBackup.TargetSpec\nresult = client.put(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}\",\n\tdisplayName = None, # Display name of the service (type: string)\n)\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n// Request body type: backup.tenant.vspc.managedBackup.TargetSpec\n$result = $ovh->put(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}\", array(\n\tdisplayName => null, // Display name of the service (type: string)\n));\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/managedBackup/edit","required":true}]}},"/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/consumption":{"get":{"operationId":"getManagedBackupConsumption","summary":"Retrieves the current billable consumption of the Managed Backup service: number of backed up virtual machines per vault level and size band with the matching plan code; no price is returned","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"managedBackupId","description":"Managed backup ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"vspcTenantId","description":"Vspc tenant ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup.Consumption"}}}}},"x-developer-hub-navigation":[["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/consumption\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/consumption\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/managedBackup/get","required":true}]}},"/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/resetPassword":{"post":{"operationId":"resetManagedBackupPassword","summary":"Resets the password of your account on the Veeam Backup & Replication web interface of the Managed Backup service","description":"The account is the one reported in currentState.vbrLogin. The new password is generated by the platform and delivered to the contacts of your account. It is never returned by the API. Accepted on a READY or SUSPENDED service without a password reset already in progress.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"managedBackupId","description":"Managed backup ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"vspcTenantId","description":"Vspc tenant ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup"}}}},"403":{"description":"Error 403 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::Forbidden::Busy":{"value":{"class":"Client::Forbidden::Busy","message":"A task is already running on this resource. Please try again later"}}}}}},"409":{"description":"Error 409 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::Conflict::ResourceInInvalidState":{"value":{"class":"Client::Conflict::ResourceInInvalidState","message":"The Managed Backup service is not in a status that allows this action"}}}}}}},"x-developer-hub-navigation":[["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.post(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/resetPassword\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->post(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/resetPassword\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/managedBackup/resetPassword","required":true}]}},"/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/virtualMachine":{"get":{"operationId":"getAllManagedBackupVirtualMachines","summary":"Lists the virtual machines known to the Managed Backup service with their protection state, billing dimensions and last backup information","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"managedBackupId","description":"Managed backup ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"vspcTenantId","description":"Vspc tenant ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup.virtualMachine"}}}}}},"x-developer-hub-navigation":[["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/virtualMachine\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/virtualMachine\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/managedBackup/get","required":true}],"x-response-identifier":"id","x-expanded-response":"BackupTenantVspcManagedBackupVirtualMachine"}},"/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/virtualMachine/{virtualMachineId}":{"get":{"operationId":"getManagedBackupVirtualMachine","summary":"Retrieves the protection state, billing dimensions and last backup information of a virtual machine","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"backupServicesId","description":"Backup services ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"managedBackupId","description":"Managed backup ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"virtualMachineId","description":"Virtual machine ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"vspcTenantId","description":"Vspc tenant ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/backup.tenant.vspc.managedBackup.virtualMachine"}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"A request parameter is invalid; check its format and value"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::VirtualMachineDoesNotExist":{"value":{"class":"Client::NotFound::VirtualMachineDoesNotExist","message":"This virtual machine is not known to the Managed Backup service"}}}}}}},"x-developer-hub-navigation":[["Private Cloud","Managed VMware vSphere","Backup & Replication","Veeam Managed Backup"]],"x-badges":[{"color":"blue","label":"Beta version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/virtualMachine/{virtualMachineId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/backupServices/tenant/{backupServicesId}/vspc/{vspcTenantId}/managedBackup/{managedBackupId}/virtualMachine/{virtualMachineId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"backupServices:apiovh:vspc/managedBackup/get","required":true}],"x-response-identifier":"id"}}}}
