trove/api-ref/source/parameters.yaml
Fan Zhang 3301a2a740 [api-ref] Add sections for backups.
Change-Id: If3a929e9de31dd901c4838e85f91f76941f33d05
Closes-bug: #1663096
Signed-off-by: Fan Zhang <zh.f@outlook.com>
2018-02-27 19:28:38 +08:00

766 lines
16 KiB
YAML
Executable File

# variables in path
accountId:
description: |
The account ID of the owner of the instance.
in: path
required: false
type: string
backup_id:
description: |
The ID of the backup.
in: path
required: true
type: string
configId:
description: |
The ID of the configuration group.
in: path
required: false
type: string
databaseName:
description: |
The name for the database.
in: path
required: false
type: string
datastore_name:
description: |
The name of the data store.
in: path
required: false
type: string
datastore_version_id:
description: |
The UUID of the data store version.
in: path
required: false
type: string
flavorId:
description: |
The ID of the flavor.
in: path
required: false
type: string
instanceId:
description: |
The ID of the database instance.
in: path
required: false
type: string
parameter_name:
description: |
The name of the parameter for which to show
details.
in: path
required: false
type: string
user_name:
description: |
The name of the user.
in: path
required: false
type: string
# variables in body
availability_zone:
description: |
The availability zone of the instance.
in: body
required: false
type: string
backup_description:
description: |
An optional description for the backup.
in: body
required: false
type: string
backup_description1:
description: |
An optional description for the backup.
in: body
required: true
type: string
backup_incremental:
description: |
Create an incremental backup based on the last full backup by setting this
parameter to 1 or 0. It will create a full backup if no existing backup
found.
in: body
required: false
type: integer
backup_instanceId:
description: |
The ID of the instance to create backup for.
in: body
required: true
type: string
backup_list:
description: |
A list of ``backup`` objects.
in: body
required: true
type: array
backup_locationRef:
description: |
The URL of the backup location.
in: body
required: true
type: string
backup_name:
description: |
Name of the backup.
in: body
required: true
type: string
backup_parentId:
description: |
ID of the parent backup to perform an incremental backup from.
in: body
required: false
type: string
backup_parentId1:
description: |
ID of the parent backup to perform an incremental backup from.
in: body
required: true
type: string
backup_size:
description: |
Size of the backup, the unit is GB.
in: body
required: true
type: string
backup_status:
description: |
Status of the backup.
in: body
required: true
type: string
characterSet:
description: |
A set of symbols and encodings. Default is
``utf8``. For information about supported character sets and
collations, see `Character Sets and Collations in MySQL
<https://dev.mysql.com/doc/refman/5.7/en/charset-mysql.html>`_.
in: body
required: false
type: string
cluster_id:
description: |
The cluster ID of an instance.
in: body
required: false
type: string
collate:
description: |
A set of rules for comparing characters in a
character set. Default is ``utf8_general_ci``. For information
about supported character sets and collations, see `Character Sets
and Collations in MySQL <https://dev.mysql.com/doc/refman/5.7/en
/charset-mysql.html>`_.
in: body
required: false
type: string
configuration:
description: |
ID of the configuration group that you want to
attach to the instance.
in: body
required: true
type: string
configuration1:
description: |
A ``configuration`` object.
in: body
required: false
type: object
configuration_id:
description: |
The ID of a configuration.
in: body
required: true
type: string
configuration_link_href:
description: |
The ``href`` attribute of a configuration link.
in: body
required: true
type: string
configuration_link_rel:
description: |
The ``rel`` attribute of a configuration link.
in: body
required: true
type: string
configuration_links:
description: |
The ``links`` object of a configuration.
in: body
required: true
type: array
configuration_name:
description: |
The name of a configuration.
in: body
required: true
type: string
created:
description: |
The date and time when the resource was created.
The date and time stamp format is `ISO 8601
<https://en.wikipedia.org/wiki/ISO_8601>`_:
::
CCYY-MM-DDThh:mm:ss±hh:mm
For example, ``2015-08-27T09:49:58-05:00``.
The ``±hh:mm`` value, if included, is the time zone as an offset
from UTC. In the previous example, the offset value is ``-05:00``.
in: body
required: true
type: string
database_name:
description: |
The name of a database.
in: body
required: true
type: string
databases:
description: |
A ``databases`` object.
in: body
required: false
type: array
datastore:
description: |
Data store assigned to the configuration group.
Required if you did not configure the default data store.
in: body
required: true
type: string
datastore1:
description: |
A ``datastore`` object.
in: body
required: false
type: object
datastore2:
description: |
A ``datastore`` object.
in: body
required: true
type: object
datastore_type:
description: |
The type of a datastore.
in: body
required: false
type: string
datastore_type1:
description: |
The type of a datastore.
in: body
required: true
type: string
datastore_version:
description: |
Name of the datastore version to use when
creating/updating the instance.
in: body
required: false
type: string
datastore_version1:
description: |
Name or ID of a datastore version.
in: body
required: true
type: string
datastore_version_id1:
description: |
The UUID of the data store version.
in: body
required: true
type: string
datastore_version_name:
description: |
The name of the datastore version.
in: body
required: true
type: string
description:
description: |
New description of the configuration group.
in: body
required: true
type: string
encrypted_rpc_messaging:
description: |
Whether the instance is using encrypted
rpm messaging feature or not.
in: body
required: false
type: boolean
flavor:
description: |
A ``flavor`` object, which includes the flavor ID
(integer) and flavor relative links.
in: body
required: true
type: object
flavor_link_href:
description: |
The ``href`` attribute of a flavor link.
in: body
required: true
type: string
flavor_link_rel:
description: |
The ``rel`` attribute of a flavor link.
in: body
required: true
type: string
flavor_links:
description: |
The ``links`` object of a flavor.
in: body
required: true
type: array
flavorId1:
description: |
The ID of the flavor.
in: body
required: true
type: string
flavorRef:
description: |
Reference (href), which is the actual URI to a
flavor as it appears in the list flavors response. Rather than
the flavor URI, you can also pass the flavor ID (integer) as the
``flavorRef`` value. For example, ``1``.
in: body
required: true
type: string
instance:
description: |
An ``instance`` object.
in: body
required: true
type: object
instance_fault:
description: |
The ``fault`` object of an instance.
in: body
required: false
type: object
instance_fault_created:
description: |
The update timestamp of the fault message
for an instance.
in: body
required: true
type: string
instance_fault_details:
description: |
The detail fault explanation of an instance.
in: body
required: true
type: string
instance_fault_message:
description: |
The fault message of an instance.
in: body
required: true
type: string
instance_hostname:
description: |
The hostname of an instance.
in: body
require: false
type: string
instance_ip_address:
description: |
The IP address of an instance.
in: body
require: false
type: string
instance_link_href:
description: |
The ``href`` attribute of an instance link.
in: body
required: true
type: string
instance_link_rel:
description: |
The ``rel`` attribute of an instance link.
in: body
required: true
type: string
instance_links:
description: |
The ``links`` object of of the instance.
in: body
required: true
type: array
instance_log:
description: |
A ``log`` objects.
in: body
required: true
type: array
instance_logs:
description: |
A list of ``log`` objects.
in: body
required: true
type: array
instance_replica_id:
description:
The ID of a replica instance.
in: body
required: true
type: string
instance_replica_link_href:
description: |
The ``href`` attribute of a replica instance link.
in: body
required: true
type: string
instance_replica_link_rel:
description: |
The ``rel`` attribute of a replica instance link.
in: body
required: true
type: string
instance_replica_links:
description:
The ``links`` object of a replica instance.
in: body
required: true
type: array
instance_replicas:
description: |
The ``replicas`` object of an instance.
in: body
required: false
type: array
instance_status:
description: |
Status of the instance.
in: body
required: true
type: string
instanceId1:
description: |
The ID of the database instance.
in: body
required: true
type: string
instanceName:
description: |
Name of the instance.
in: body
required: false
type: string
instanceName1:
description: |
Name of the instance.
in: body
required: true
type: string
local_storage_used:
description: |
The used space of the ephemeral disk, in gigabytes (GB).
in: body
required: false
type: float
locality:
description: |
The scheduler hint when creating underlying
Nova instances. Valide values are:
``affinity``, ``anti-affinity``.
in: body
required: false
type: string
log_container:
description: |
The object store container where the published
log data will be stored. Defaults to ``None``
before the log has been published.
in: body
required: true
type: string
log_disable_action:
description: |
To disable a log type, this should always set to 1.
in: body
required: false
type: integer
log_discard_action:
description: |
To discard a log type which has been published previously,
this should always set to 1.
in: body
required: false
type: integer
log_enable_action:
description: |
To enable a log type, this should always set to 1.
in: body
required: false
type: integer
log_metafile:
description: |
The log metafile location.
in: body
required: true
type: string
log_name:
description: |
The name of the log.
in: body
required: true
type: string
log_pending_size:
description: |
Log file size pending to be published.
in: body
required: true
type: string
log_prefix:
description: |
If the log has been published, thi is the prefix location
of where the log data are stored. Otherwize the prefix is
``None``.
in: body
required: true
type: string
log_publish_action:
description: |
To publish a log type, this should always set to 1.
in: body
required: false
type: integer
log_published_size:
description: |
Published size of the log.
in: body
required: true
type: string
log_status:
description: |
The log status.
in: body
required: true
type: string
log_type:
description: |
The type of the log.
in: body
required: true
type: string
module_id:
description: |
The ID of a module.
in: body
required: true
type: string
modules:
description: |
The ``modules`` object.
in: body
required: false
type: object
name:
description: |
Name of the configuration group you are creating.
in: body
required: true
type: string
nics:
description: |
Network interfaces when creating underlying Nova
instances.
``NOTE:`` this parameter use the same schema when
novaclient creating servers.
in: body
required: false
type: array
region_name:
description: |
The region name of an instance.
in: body
required: false
type: string
region_name2:
description: |
The region name of an instance.
in: body
required: true
type: string
replica_count:
description: |
Number of replicas to create (defaults to 1).
in: body
required: false
type: integer
replica_of:
description: |
ID or name of an existing instance to replicate
from.
in: body
required: false
type: string
restore_point:
description: |
The ``restorePoint`` object. Use this paramter
to create an instance from a backup.
in: body
required: false
type: object
restore_point_backupref:
description:
The backup id used from which a new instance
is created.
in: body
required: true
type: string
root_password:
description: |
The password of the database root user(i.e. the
administrative user).
in: body
required: false
type: string
server_id:
description: |
The ID of the underlying Nova instance for an instance.
in: body
required: false
type: string
shard_id:
description: |
The shard ID of an instance.
in: body
required: false
type: string
slave_of:
description: |
To detach a replica, set ``slave_of`` to null.
in: body
required: true
type: string
tenant_id:
description: |
The ID of a tenant.
in: body
required: false
type: string
updated:
description: |
The date and time when the resource was updated.
The date and time stamp format is `ISO 8601
<https://en.wikipedia.org/wiki/ISO_8601>`_:
::
CCYY-MM-DDThh:mm:ss±hh:mm
The ``±hh:mm`` value, if included, is the time zone as an offset
from UTC.
For example, ``2015-08-27T09:49:58-05:00``.
The UTC time zone is assumed.
in: body
required: true
type: string
user_database_name:
description: |
The name of a database which the user
can access.
in: body
required: true
type: string
user_databases:
description: |
The ``databases`` object. This is a list
of databases which the user can access.
in: body
required: false
type: array
user_host:
description: |
A host allowed for a user.
in: body
required: false
type: string
user_name1:
description: |
The name of a user.
in: body
required: true
type: string
user_password:
description: |
The password of a user.
in: body
required: true
type: string
users:
description: |
A ``users`` object.
in: body
required: false
type: array
values:
description: |
Dictionary that lists configuration parameter
names and associated values.
in: body
required: true
type: string
volume:
description: |
A ``volume`` object.
in: body
required: false
type: object
volume_id:
description: |
The ID of a volume.
in: body
required: false
type: string
volume_size:
description: |
The volume size, in gigabytes (GB). A valid value
is from 1 to 50(this limit is controlled by the
configration ``max_accepted_volume_size``).
in: body
required: true
type: integer
volume_size2:
description: |
The volume size, in gigabytes (GB).
in: body
required: true
type: integer
volume_type:
description: |
The volume type to use. You can list the
available volume types on your system by using the ``cinder type-
list`` command. If you want to specify a volume type, you must
also specify a volume size.
in: body
required: false
type: string
volume_used:
description: |
The used space of the volume, in gigabytes (GB).
in: body
required: false
type: float