Skip to content
Internal API Catalog
/
Backup and Recovery API
/
API reference
/
v1beta1
/
Protection Store Gateway
/
Reconfigures the CPU, memory and storage requirements of the Protection Store Gateway.

Backup and Recovery API (1.1.0)

Backup and Recovery API

Download OpenAPI description
backup-recovery-api.json
backup-recovery-api.yaml
Overview
License

HPE End User License Agreement

Languages
Servers
Mock server

https://stage-developer-portal-hpe.redocly.app/_mock/docs/greenlake/services/backup-recovery/public/openapi/backup-recovery-public-v1beta1/backup-recovery-api/

https://us-west.api.greenlake.hpe.com/

https://eu-west.api.greenlake.hpe.com/

https://eu-central.api.greenlake.hpe.com/

https://ap-northeast.api.greenlake.hpe.com/

Protection Store Gateway

Protection Store Gateway APIs

Operations

Recover a Protection Store Gateway within DSCC

Request

Recover a Protection Store Gateway

Security
bearer
Path
idstring(uuid)required

The UUID of the object

Example: c1a0eb78-41a0-4151-93b2-f057ffeca3f3
Query
forceboolean

Forces recovery to be initiated even if the Protection Store Gateway is in a Connected state.

Example: force=true
Bodyapplication/jsonrequired
hypervisorManagerIdstringrequired

Unique identifier, UUID.

Example: "aa1974ec-3b28-406f-8d84-85528d590a6b"
namestringrequired

The name of the Protection Store Gateway

Example: "EG-172.31.57.71"
vmConfigobject(VMConfig)required
Example: {"datastoreIds":["70968004-886c-582e-b09a-c98396d0db68","098c18ff-ae3d-55a7-8967-00869c1ac71c"],"hostId":"234f54ab-e93c-5bc7-9daa-3dcd93fc0ae0","maxInCloudDailyProtectedDataInTiB":90,"maxInCloudRetentionDays":90,"maxOnPremDailyProtectedDataInTiB":5,"maxOnPremRetentionDays":5,"network":{"dns":[{"networkAddress":"172.31.56.9"},{"networkAddress":"172.31.56.10"},{"networkAddress":"172.31.35.101"}],"gateway":"172.31.63.254","name":"dvportgroup-30","networkAddress":"172.31.57.71","networkType":"STATIC","subnetMask":"255.255.248.0"}}
vmConfig.​clusterIdstring

Id of the cluster. Only required if host or resource pool is not given

vmConfig.​contentLibraryIdstring

Id of the datastore for the content library

vmConfig.​datastoreIdsArray of strings(uuid)
Example: ["70968004-886c-582e-b09a-c98396d0db68","098c18ff-ae3d-55a7-8967-00869c1ac71c"]
vmConfig.​folderIdstring

Id of the folder

vmConfig.​hostIdstring

Id of the Host. Only required if cluster or resource pool is not given

Example: "234f54ab-e93c-5bc7-9daa-3dcd93fc0ae0"
vmConfig.​networkobject
Example: {"dns":[{"networkAddress":"172.31.56.9"},{"networkAddress":"172.31.56.10"},{"networkAddress":"172.31.35.101"}],"gateway":"172.31.63.254","name":"dvportgroup-30","networkAddress":"172.31.57.71","networkType":"STATIC","subnetMask":"255.255.248.0"}
vmConfig.​overrideobject

Override automatic VM resource configuration with a fixed configuration.

vmConfig.​resourcePoolIdstring

Id of the resource pool. Only required if cluster or host is not given

vmConfig.​maxInCloudDailyProtectedDataInTiBnumber

The maximum total size of the assets that is expected to be protected each day in the Cloud Protection Stores.

Example: 90
vmConfig.​maxInCloudRetentionDaysnumber

The maximum retention period for cloud backups in days.

Example: 90
vmConfig.​maxOnPremDailyProtectedDataInTiBnumber

The maximum total size of the assets that is expected to be protected each day in the On-Prem Protection Store.

Example: 5
vmConfig.​maxOnPremRetentionDaysnumber

The maximum retention period for local backups in days.

Example: 5
curl -i -X POST \
  https://stage-developer-portal-hpe.redocly.app/_mock/docs/greenlake/services/backup-recovery/public/openapi/backup-recovery-public-v1beta1/backup-recovery-api/backup-recovery/v1beta1/protection-store-gateways/c1a0eb78-41a0-4151-93b2-f057ffeca3f3/recover \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "hypervisorManagerId": "aa1974ec-3b28-406f-8d84-85528d590a6b",
    "name": "EG-172.31.57.71",
    "vmConfig": {
      "datastoreIds": [
        "70968004-886c-582e-b09a-c98396d0db68",
        "098c18ff-ae3d-55a7-8967-00869c1ac71c"
      ],
      "hostId": "234f54ab-e93c-5bc7-9daa-3dcd93fc0ae0",
      "maxInCloudDailyProtectedDataInTiB": 90,
      "maxInCloudRetentionDays": 90,
      "maxOnPremDailyProtectedDataInTiB": 5,
      "maxOnPremRetentionDays": 5,
      "network": {
        "dns": [
          {
            "networkAddress": "172.31.56.9"
          },
          {
            "networkAddress": "172.31.56.10"
          },
          {
            "networkAddress": "172.31.35.101"
          }
        ],
        "gateway": "172.31.63.254",
        "name": "dvportgroup-30",
        "networkAddress": "172.31.57.71",
        "networkType": "STATIC",
        "subnetMask": "255.255.248.0"
      }
    }
  }'

Responses

Accepted

Headers
Locationstring

This contains the URI of the task used to monitor the request.

Bodyapplication/json
object(EmptyResponse)
Response
application/json
{}

Reconfigures the CPU, memory and storage requirements of the Protection Store Gateway.

Request

Reconfigure the CPU, memory and storage requirements of the Protection Store Gateway.

Security
bearer
Path
idstring(uuid)required

The UUID of the object

Example: c1a0eb78-41a0-4151-93b2-f057ffeca3f3
Bodyapplication/jsonrequired
datastoreIdsArray of strings(uuid)

IDs of datastores PSG should use. Including existing ones

Example: ["aaaaaaa8-aaa4-aaa4-aaa4-aaaaaaaaaa12","aaaaaaa8-aaa4-bbb4-aaa4-aaaaaaaaaa12"]
overrideobject

Override automatic VM resource configuration with a fixed configuration.

maxInCloudDailyProtectedDataInTiBnumber

The maximum total size of the assets that is expected to be protected each day in the Cloud Protection Stores.

Example: 3
maxInCloudRetentionDaysnumber

The maximum retention period for cloud backups in days.

Example: 5
maxOnPremDailyProtectedDataInTiBnumber

The maximum total size of the assets that is expected to be protected each day in the On-Prem Protection Store.

Example: 5
maxOnPremRetentionDaysnumber

The maximum retention period for local backups in days.

Example: 5
curl -i -X POST \
  https://stage-developer-portal-hpe.redocly.app/_mock/docs/greenlake/services/backup-recovery/public/openapi/backup-recovery-public-v1beta1/backup-recovery-api/backup-recovery/v1beta1/protection-store-gateways/c1a0eb78-41a0-4151-93b2-f057ffeca3f3/resize \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "datastoreIds": [
      "aaaaaaa8-aaa4-aaa4-aaa4-aaaaaaaaaa12",
      "aaaaaaa8-aaa4-bbb4-aaa4-aaaaaaaaaa12"
    ],
    "maxInCloudDailyProtectedDataInTiB": 3,
    "maxInCloudRetentionDays": 5,
    "maxOnPremDailyProtectedDataInTiB": 5,
    "maxOnPremRetentionDays": 5
  }'

Responses

Accepted

Headers
Locationstring

This contains the URI of the task used to monitor the request.

Bodyapplication/json
object(EmptyResponse)
Response
application/json
{}

Restarts the Protection Store Gateway

Request

Restart the Protection Store Gateway

Security
bearer
Path
idstring(uuid)required

The UUID of the object

Example: c1a0eb78-41a0-4151-93b2-f057ffeca3f3
curl -i -X POST \
  https://stage-developer-portal-hpe.redocly.app/_mock/docs/greenlake/services/backup-recovery/public/openapi/backup-recovery-public-v1beta1/backup-recovery-api/backup-recovery/v1beta1/protection-store-gateways/c1a0eb78-41a0-4151-93b2-f057ffeca3f3/restart-guest-os \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Restart Protection Store Gateway accepted

Headers
Locationstring

This contains the URI of the task used to monitor the request.

Bodyapplication/json
object(EmptyResponse)
Response
application/json
{}

StoreOnce

StoreOnce APIs

Operations

application-hosts

The Application Hosts API allows the registration and management of Application Hosts.

Operations

data-orchestrators

APIs for managing Data Orchestrator operations.

Operations

datastores

The datastores API allows the data management operations on datastores.

Operations

mssql-database-backups

The MSSQL database backups API allows the creation and management of MSSQL database backups.

Operations

mssql-database-protection-groups

The MSSQL database Protection Groups API allows management of MSSQL database Protection Groups.

Operations

mssql-database-snapshots

The MSSQL database snapshots API allows the creation and management of MSSQL database snapshots.

Operations

mssql-databases

The MSSQL Databases API allows management of MSSQL databases.

Operations

mssql-instances

The MSSQL Instances API allows management of MSSQL instances.

Operations

protection-jobs

The Protection Jobs API allows the creation and management of Protection Jobs.

Operations

protection-policies

The Protection Policies API allows the creation and management of Protection Policies.

Operations

protection-stores

This API allows the creation and management of Protection Stores that represents the backup target for the copies.

Operations

virtual-machine-protection-groups

The virtual machine Protection Groups API allows the creation and management of virtual machine Protection Groups (Group of Virtual Machines, Datastores or Folder for Protection).

Operations

virtual-machines

The virtual machines API allows the data management operations on virtual machines.

Operations

volume-protection-groups

The Volume Protection Groups API allows the creation and management of Volume Protection Groups (Group of Volumes for Protection).

Operations

datastore-backups

Operations

datastore-snapshots

Operations

virtual-machine-backups

Operations

virtual-machine-snapshots

Operations

volume-protection-group-backups

Operations

volume-protection-group-snapshots

Operations