Skip to content
Internal API Catalog
/
Backup and Recovery API
/
API reference
/
v1beta1
/
Protection Store Gateway
/
Deletes a Protection Store Gateway within DSCC

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

Create a new Protection Store Gateway within DSCC

Request

Create a Protection Store Gateway

Security
bearer
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 \
  -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
{}

Deletes a Protection Store Gateway within DSCC

Request

Delete the Protection Store Gateway

Security
bearer
Path
idstring(uuid)required

The UUID of the object

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

Forces deletion of the Protection Store Gateway regardless of store data.

Example: force=true
curl -i -X DELETE \
  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 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Accepted

Headers
Locationstring

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

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

Get details of a Protection Store Gateway within DSCC

Request

Get details of a Protection Store Gateway

Security
bearer
Path
idstring(uuid)required

The UUID of the object

Example: c1a0eb78-41a0-4151-93b2-f057ffeca3f3
curl -i -X GET \
  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 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json
idstring(uuid)read-onlyrequired

An identifier for the resource, usually a UUID.

typestringread-onlyrequired

The type of resource.

generationinteger(int64)read-onlyrequired

A monotonically increasing value. This value updates when the resource is updated and can be used as a short way to determine if a resource has changed or which of two different copies of a resource is more up to date.

createdAtstring(date-time)required
updatedAtstring(date-time)required
resourceUristringread-onlyrequired

The self reference for this resource.

customerIdstringread-onlyrequired

The customer application identifier

namestring

A system specified name for the resource.

adminUserCiphertextstring
consoleUristring

URI for the console screen that displays this resource

dataOrchestratorIdstring

The id of the Data Orchestrator this Protection Store Gateway is associated with

datastoresInfoArray of objects(PSGDatastoreInfo)
displayNamestring

The display name of this Protection Store Gateway

healthobject

Health of Protection Store Gateway.

networkobject

Network of Protection Store Gateway.

overrideobject

User supplied parameters used to override automatic VM resource configuration with a fixed configuration. If 0 is returned for the values then no override has been configured.

remoteAccessEnabledboolean
remoteAccessStationIdstring

The station ID (SID) that is required for remote desktop access

serialNumberstring

The serial number of this Protection Store Gateway

sizeobject

User supplied parameters used to size the Protection Store Gateway.

softwareVersionstring

Software version of the Protection Store Gateway

statestring

State of Protection Store Gateway.

Enum"PSG_STATE_QUERYING_CATALOGUE""PSG_STATE_DEPLOYING""PSG_STATE_DEPLOYED"
supportUserCiphertextstring
vmIdstring

Id of the VM

Response
application/json
{
  "createdAt": "2019-08-24T14:15:22Z",
  "customerId": "string",
  "generation": 0,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "resourceUri": "string",
  "type": "string",
  "updatedAt": "2019-08-24T14:15:22Z",
  "adminUserCiphertext": "string",
  "consoleUri": "string",
  "dataOrchestratorId": "string",
  "datastoresInfo": [
    { … }
  ],
  "displayName": "string",
  "health": {
    "state": "PSG_HEALTH_STATE_UNKNOWN",
    "stateReason": "string",
    "status": "PSG_HEALTH_STATUS_CONNECTED",
    "updatedAt": "2019-08-24T14:15:22Z"
  },
  "network": {
    "dns": [ … ],
    "hostname": "string",
    "nics": [ … ],
    "ntp": [ … ],
    "proxy": { … }
  },
  "override": {
    "cpu": 8,
    "ramInGiB": 24,
    "storageInTiB": 2
  },
  "remoteAccessEnabled": true,
  "remoteAccessStationId": "string",
  "serialNumber": "string",
  "size": {
    "maxInCloudDailyProtectedDataInTiB": 2,
    "maxInCloudRetentionDays": 2,
    "maxOnPremDailyProtectedDataInTiB": 2,
    "maxOnPremRetentionDays": 2
  },
  "softwareVersion": "string",
  "state": "PSG_STATE_QUERYING_CATALOGUE",
  "supportUserCiphertext": "string",
  "vmId": "string"
}

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