Skip to content
Internal API Catalog
/
Backup and Recovery API
/
API reference
/
v1beta1
/
Protection Store Gateway
/
Modify the configuration of a 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

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"
}

Modify the configuration of a Protection Store Gateway

Request

Update a Protection Store Gateway.

Security
bearer
Path
idstring(uuid)required

The UUID of the object

Example: c1a0eb78-41a0-4151-93b2-f057ffeca3f3
Bodyapplication/merge-patch+jsonrequired
dateTimeobject(PSGDateTime)
dnsArray of objects(DomainName)

DNS servers of the appliance

ntpArray of objects(Ntp)

NTP servers of the appliance

proxyobject(PSGProxy)
curl -i -X PATCH \
  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>' \
  -H 'Content-Type: application/merge-patch+json' \
  -d '{}'

Responses

Updated Protection Store Gateway.

Headers
Locationstring

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

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

Gets the credentials of a Protection Store Gateway console user

Request

Get credentials of a Protection Store Gateway console user

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/consoleUser \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json
passwordstring

Password for a console user

usernamestring

Username for a console user

Response
application/json
{
  "password": "string",
  "username": "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