diff --git a/api-ref/source/os-share-manage.inc b/api-ref/source/os-share-manage.inc index 36a171653a..76c91f3137 100644 --- a/api-ref/source/os-share-manage.inc +++ b/api-ref/source/os-share-manage.inc @@ -51,11 +51,10 @@ Request - protocol: protocol - name: name_request - display_name: display_name_request - - share_type: share_type_2 + - share_type: share_type_request - driver_options: driver_options - export_path: export_path - service_host: service_host - - is_public: is_public - description: description_request - display_description: display_description_request @@ -72,29 +71,26 @@ Response parameters - share: share - links: links - - availability_zone: availability_zone_1 + - availability_zone: availability_zone - share_network_id: share_network_id - export_locations: export_locations - share_server_id: share_server_id - - snapshot_id: snapshot_id_share_response - - id: id_4 - - size: size_2 - - share_type: share_type_1 + - snapshot_id: snapshot_id_shares_response + - id: share_id_response + - size: size_response + - share_type: share_type_shares_response - share_type_name: share_type_name - - has_replicas: has_replicas - - replication_type: replication_type - export_location: export_location - project_id: project_id - metadata: metadata - - status: status_8 + - status: share_status_response - description: description - - host: host_1 - - is_public: is_public + - host: host_resource_response + - is_public: is_public_shares_response - snapshot_support: snapshot_support - name: name - created_at: created_at - share_proto: share_proto - - volume_type: volume_type Response example ---------------- diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml index 18e33494f8..0385f397d0 100644 --- a/api-ref/source/parameters.yaml +++ b/api-ref/source/parameters.yaml @@ -491,12 +491,8 @@ source_share_group_snapshot_id_query: min_version: 2.31 status_query: description: | - Filters by a share status. A valid value is - ``creating``, ``creating_from_snapshot``, ``error``, ``available``, - ``deleting``, ``error_deleting``, ``manage_starting``, ``manage_error``, - ``unmanage_starting``, ``unmanage_error``, ``migrating``, - ``extending``, ``extending_error``, ``shrinking``, - ``shrinking_error``, or ``shrinking_possible_data_loss_error``. + Filters by a share status. For valid statuses, see the `section + above <#shares>`_. in: query required: false type: string @@ -542,8 +538,10 @@ access_level: description: | The access level to the share. To grant or deny access to a share, you specify one of the following share access - levels: - ``rw``. Read and write (RW) access. - ``ro``. Read- - only (RO) access. + levels: + + - ``rw``. Read and write (RW) access. + - ``ro``. Read-only (RO) access. in: body required: true type: string @@ -583,13 +581,6 @@ access_share_id: in: body required: true type: string -access_status: - description: | - The share access status, which is ``new``, - ``error``, ``active``. - in: body - required: true - type: string access_to: description: | The value that defines the access. The back end @@ -654,26 +645,19 @@ allow_access: type: object availability_zone: description: | - The availability zone. - in: body - required: false - type: string - min_version: 2.1 -availability_zone_1: - description: | - The availability zone. + The name of the availability zone the share exists within. in: body required: true type: string availability_zone_id: description: | - The availability zone ID. + The availability zone ID the resource exists within. in: body required: true type: string -availability_zone_id_2: +availability_zone_id_share_group: description: | - The availability zone ID for create share group. + The availability zone ID that the share group exists within. in: body required: true type: string @@ -686,7 +670,7 @@ availability_zone_name: type: string availability_zone_request: description: | - The UUID or name of an availability zone for the share network subnet. + The UUID or name of an availability zone for resource to be created within. in: body required: false type: string @@ -705,8 +689,8 @@ backend: backend_details: description: | The back-end details for a server. Each back end - can store any key- value information that it requires. For - example, the generic back- end driver might store the router ID. + can store any key-value information that it requires. For + example, the generic back-end driver might store the router ID. in: body required: true type: object @@ -719,9 +703,11 @@ backend_host: backend_name: description: | The name of the back end in this format: - ``host@backend#POOL``. - ``host``. The host name for the back - end. - ``backend``. The name of the back end. - ``POOL``. The - pool name for the back end. + ``host@backend#POOL``: + + - ``host``. The host name for the back end. + - ``backend``. The name of the back end. + - ``POOL``. The pool name for the back end. in: body required: true type: string @@ -754,7 +740,7 @@ capability_driver_version: capability_free_capacity_gb: description: | The amount of free capacity for the back end, in - GBs. A valid value is a string, such as ``unknown``, or an + GiBs. A valid value is a string, such as ``unknown``, or an integer. in: body required: true @@ -806,7 +792,7 @@ capability_storage_protocol: type: string capability_total_capacity_gb: description: | - The total capacity for the back end, in GBs. A + The total capacity for the back end, in GiBs. A valid value is a string, such as ``unknown``, or an integer. in: body required: true @@ -836,7 +822,9 @@ consistent_snapshot_support: min_version: 2.34 count: description: | - The total count of requested resource before pagination is applied. + The total count of requested resource before pagination is applied. This + parameter is only present in the API response if "with_count=True" is + supplied in the query. in: body required: false type: integer @@ -856,6 +844,15 @@ create_share_from_snapshot_support_body: in: body required: false type: boolean +create_share_from_snapshot_support_share_capability: + description: | + Whether or not this share supports snapshots that can be cloned into new + shares. Inconsequential if the share doesn't support snapshots. (see + capability "snapshot_support") + in: body + required: true + type: boolean + min_version: 2.24 created_at: description: | The date and time stamp when the resource was created within the service's @@ -941,9 +938,9 @@ export_location: The export location. For newer API versions it is available in separate APIs. See sections `Share export locations <#share-share-export-locations>`_ and `Share instance export - locations <#share-share-instance-export- locations>`_. + locations <#share-share-instance-export-locations>`_. in: body - required: false + required: true type: string max_version: 2.8 export_location_availability_zone: @@ -1007,18 +1004,19 @@ export_locations: locations. For newer API versions it is available in separate APIs. See sections `Share export locations <#share-share-export-locations>`_ and `Share instance export locations <#share-share-instance- - export- locations>`_. + export-locations>`_. in: body - required: false + required: true type: array max_version: 2.8 export_path: description: | The share export path in the format appropriate - for the protocol: - NFS protocol. ``10.0.0.1:/foo_path``. For - example, ``10.254.0.5:/shares/share-42033c24-0261-424f-abda- - 4fef2f6dbfd5``. - CIFS protocol. - ``\\10.0.0.1\foo_name_of_cifs_share``. + for the protocol: + + - NFS protocol. ``10.0.0.1:/foo_path``. For example, ``10.254.0 + .5:/shares/share-42033c24-0261-424f-abda-4fef2f6dbfd5``. + - CIFS protocol. For example, ``\\10.0.0.1\foo_name_of_cifs_share``. in: body required: true type: string @@ -1163,34 +1161,14 @@ host: in: body required: true type: string -host_1: +host_resource_response: description: | - The share host name. + The host name of the service back end that the resource is contained + within. This parameter is always present in the response schema, but the + value may be represented as "null" to non-admin users. in: body required: true type: string -host_10: - description: | - The host pool of the destination back end, in - this format: ``host@backend#POOL``. - ``host``. The host name for - the destination back end. - ``backend``. The name of the - destination back end. - ``POOL``. The pool name for the - destination back end. - in: body - required: true - type: string -host_6: - description: | - The share instance host name. - in: body - required: true - type: string -host_9: - description: | - The share host name. - in: body - required: false - type: string host_share_server_body: description: | The share server host name or IP address. @@ -1203,12 +1181,6 @@ id_13: in: body required: true type: string -id_4: - description: | - The UUID of the share. - in: body - required: true - type: string identifier: description: | The identifier of the share server in the back-end storage system. @@ -1259,26 +1231,42 @@ is_group_type_default: required: true type: boolean min_version: 2.46 -is_public: +is_public_manage_request: description: | The level of visibility for the share. Set to ``true`` to make - share public. Set to ``false`` to make it private. Default value - is ``false``. + share visible to all projects in the cloud. Set to ``false`` to make it + private to your project. Default value is ``false``. in: body required: false type: boolean min_version: 2.8 +is_public_request: + description: | + The level of visibility for the share. Set to ``true`` to make + share visible to all projects in the cloud. Set to ``false`` to make it + private to your project. Default value is ``false``. + in: body + required: false + type: boolean +is_public_shares_response: + description: | + Whether the share is visible publicly (by all projects in the cloud) or + not. + in: body + required: true + type: boolean links: description: | - The share links + Pagination and bookmark links for the resource. in: body required: true type: array manage_host: description: | The host of the destination back end, in this format: ``host@backend``. - - ``host``. The host name for the destination back end. - - ``backend``. The name of the destination back end. + + - ``host``: The host name for the destination back end. + - ``backend``: The name of the destination back end. in: body required: true type: string @@ -1437,7 +1425,7 @@ metadata: One or more metadata key and value pairs as a dictionary of strings. in: body - required: false + required: true type: object metadata_2: description: | @@ -1511,6 +1499,15 @@ mount_snapshot_support_body: in: body required: false type: boolean +mount_snapshot_support_share_capability: + description: | + Whether or not this share supports snapshots that can be mounted + and access controlled independently of the share. Inconsequential if the + share doesn't support snapshots (see capability "snapshot_support"). + in: body + required: true + type: boolean + min_version: 2.32 name: description: | The user defined name of the resource. @@ -1968,17 +1965,31 @@ replica_state: min_version: 2.11 replication_type: description: | - The share replication type. + Type of replication supported for shares of this type. Valid values are: + + - ``null``: replication is not supported + - ``readable``: users can create replicas of the share that are + read-only until they are promoted, + - ``writable``: users can create read/write replicas + - ``dr``: users can create replicas that are not exported until + they are promoted. in: body required: false type: string +replication_type_share_capability: + description: | + The share replication type. The value can be: + + - ``null``, if the share cannot be replicated. + - ``readable``, if one or more read-only replicas of the share can be + created + - ``writable``, if one or more active replicas of the share can be created + - ``dr``, if one or more replicas of the share can be created that will + remain inaccessible until they are promoted. + in: body + required: true + type: string min_version: 2.11 -replication_type_body: - description: | - The share replication type. - in: body - required: false - type: string request_id_body: description: | The UUID of the request during which the message was created. @@ -2025,6 +2036,15 @@ revert_to_snapshot_support_body: in: body required: false type: boolean +revert_to_snapshot_support_share_capability: + description: | + Whether or not this share supports being reverted to its latest snapshot. + Inconsequential if the share doesn't support snapshots (see capability + "snapshot_support"). + in: body + required: true + type: boolean + min_version: 2.27 security_service_dns_ip: description: | The DNS IP address that is used inside the project network. @@ -2200,9 +2220,11 @@ service_enable_host_response: service_host: description: | The manage-share service host in this format: - ``host@backend#POOL``. - ``host``. The host name for the back - end. - ``backend``. The name of the back end. - ``POOL``. The - pool name for the back end. + ``host@backend#POOL``: + + - ``host``. The host name for the back end. + - ``backend``. The name of the back end. + - ``POOL``. The pool name for the back end. in: body required: true type: string @@ -2332,10 +2354,15 @@ share_group_type_name_request: in: body required: false type: string -share_id_2: +share_id_response: description: | - The UUID of the share from which the share - instance was created. + The UUID of the share. + in: body + required: true + type: string +share_id_share_instances_response: + description: | + The UUID of the share to which the share instance belongs to. in: body required: true type: string @@ -2370,34 +2397,31 @@ share_network_gateway: max_version: 2.50 share_network_id: description: | - The share network ID. + The share network ID where the resource is exported to. in: body required: true type: string -share_network_id_1: +share_network_id_manage_server_request: description: | - The ID of a share network. Note that when using - a share type with the ``driver_handles_share_servers`` extra spec - as ``False``, you should not provide a ``share_network_id``. - in: body - required: false - type: string -share_network_id_2: - description: | - The UUID of a share network where the share - server exists or will be created. If ``share_network_id`` is - ``None`` and you provide a ``snapshot_id``, the - ``share_network_id`` value from the snapshot is used. - in: body - required: false - type: string -share_network_id_4: - description: | - The share network ID. + The UUID of the share network that the share server will pertain to. in: body required: true type: string -share_network_id_share_server_body: +share_network_id_request: + description: | + The ID of a share network that the resource must be exported to. Note + that when using a share type with the ``driver_handles_share_servers`` + extra spec as ``False``, you should not provide a ``share_network_id``. + in: body + required: false + type: string +share_network_id_share_networks_response: + description: | + The UUID of a share network resource. + in: body + required: true + type: string +share_network_id_share_servers_response: description: | The UUID of a share network that is associated with the share server. @@ -2540,7 +2564,7 @@ share_network_subnet_share_network_name: type: string share_new_size: description: | - New size of the share, in GBs. + New size of the share, in GiBs. in: body required: true type: integer @@ -2666,29 +2690,19 @@ share_share_type_name: required: true type: string min_version: 2.6 -share_type: +share_status_request: description: | - The share type name. If you omit this parameter, - the default share type is used. To view the default share type set - by the administrator, issue a list default share types request. - You cannot specify both the ``share_type`` and ``volume_type`` - parameters. - in: body - required: false - type: string -share_type_1: - description: | - The UUID of the share type. In minor versions, this parameter is - a share type name, as a string. + The share or share instance status to be set. Possible values are listed in + the `section above <#shares>`_. in: body required: true type: string - min_version: 2.6 -share_type_2: +share_status_response: description: | - The share type name. + The share or share instance status. Possible values are listed in + the `section above <#shares>`_. in: body - required: false + required: true type: string share_type_access:is_public: description: | @@ -2759,6 +2773,24 @@ share_type_name_request: in: body required: false type: string +share_type_request: + description: | + The name or ID of the share type to be used to create the resource. If you + omit this parameter, the default share type is used. To view the default + share type set by the administrator, issue a list default share types + request. + in: body + required: false + type: string +share_type_shares_response: + description: | + The UUID of the share type that the share belongs to. Prior to API + version 2.6, this parameter resolved to the name of the share type. In + API version 2.6 and beyond, this parameter holds the share type ID + instead of the name. + in: body + required: true + type: string share_types: description: | A list of one or more share type IDs. @@ -2790,17 +2822,17 @@ shrink: in: body required: true type: object -size: +size_request: description: | - The share size, in GBs. The requested share size - cannot be greater than the allowed GB quota. To view the allowed - quota, issue a get limits request. + The share size, in GiBs. The requested share size cannot be greater than + the allowed GiB quota. To view the allowed quota, issue a get limits + request. in: body required: true type: integer -size_2: +size_response: description: | - The share size, in GBs. + The share size, in GiBs. in: body required: true type: integer @@ -2824,7 +2856,7 @@ snapshot_id_request: in: body required: false type: string -snapshot_id_share_response: +snapshot_id_shares_response: description: | The UUID of the snapshot that was used to create the share. @@ -2911,13 +2943,13 @@ snapshot_share_protocol: type: string snapshot_share_size: description: | - The share snapshot size, in GBs. + The share snapshot size, in GiBs. in: body required: true type: integer snapshot_size: description: | - The snapshot size, in GBs. + The snapshot size, in GiBs. in: body required: true type: integer @@ -2947,13 +2979,14 @@ snapshot_support: required: true type: boolean min_version: 2.2 -snapshot_support_1: +snapshot_support_share_capability: description: | - An extra specification that filters back ends by - whether they do or do not support share snapshots. + Whether or not this share supports snapshots. Snapshots are point in + time backups of the share. in: body - required: false + required: true type: boolean + min_version: 2.2 snapshot_unmanage: description: | To unmanage a share snapshot, include this parameter and set its value to @@ -2982,6 +3015,13 @@ source_share_group_snapshot_id_response: in: body required: true type: string +source_share_group_snapshot_member_id: + description: | + ID of the group snapshot instance that was the source of this share. + in: body + required: true + type: string + min_version: 2.31 state: description: | Prior to versions 2.28, the state of all access rules of a given share @@ -2994,68 +3034,6 @@ state: in: body required: true type: string -status: - description: | - The consistency group snapshot status, which is - ``available``, ``creating``, ``error``, ``deleting``, or - ``error_deleting``. - in: body - required: true - type: string -status_1: - description: | - The consistency group status. A valid value is - ``creating``, ``available``, ``error``, ``deleting``, or - ``error_deleting``. - in: body - required: true - type: string -status_16: - description: | - The share status, which is ``creating``, ``creating_from_snapshot``, - ``error``, ``available``, ``deleting``, ``error_deleting``, - ``manage_starting``, ``manage_error``, ``unmanage_starting``, - ``unmanage_error``, ``unmanaged``, ``extend``, - ``extending_error``, ``shrinking``, ``shrinking_error``, or - ``shrinking_possible_data_loss_error``. - in: body - required: true - type: string -status_3: - description: | - The share status. A valid value is: - - ``creating``. The share is being created. - ``deleting``. The - share is being deleted. - ``error``. An error occurred during - share creation. - ``error_deleting``. An error occurred during - share deletion. - ``available``. The share is ready to use. - - ``manage_starting``. Share manage started. - ``manage_error``. - Share manage failed. - ``unmanage_starting``. Share unmanage - started. - ``unmanage_error``. Share cannot be unmanaged. - - ``unmanaged``. Share was unmanaged. - ``extending``. The extend, - or increase, share size request was issued successfully. - - ``extending_error``. Extend share failed. - ``shrinking``. Share - is being shrunk. - ``shrinking_error``. Failed to update quota on - share shrinking. - ``shrinking_possible_data_loss_error``. Shrink - share failed due to possible data loss. - ``creating_from_snapshot``. - The share is being created from a parent snapshot. - in: body - required: true - type: string -status_5: - description: | - The share instance status. A valid value is - ``available``, ``error``, ``creating``, ``deleting``, - ``creating_from_snapshot``, or ``error_deleting``. - in: body - required: true - type: string -status_8: - description: | - The share status, which is ``available``, - ``manage_starting``, or ``manage_error``. - in: body - required: true - type: string status_share_server_body: description: | The share server status, which is ``active``, @@ -3069,8 +3047,7 @@ task_state: value is ``null``, ``migration_starting``, ``migration_error``, ``migration_success``, ``migration_completing``, or ``migrating``. The ``task_state`` is ``null`` unless the share is migrated from - one back-end to another. For details, see ``os-migrate_share`` - extension request. + one back-end to another. in: body required: true type: string @@ -3294,6 +3271,14 @@ volume_type: in: body required: false type: string +volume_type_shares_response: + description: | + The share type ID. This is a legacy parameter that contains the same value + as the ``share_type`` parameter. Do not rely on this parameter as it may + be removed in a future API revision. + in: body + required: true + type: string writable: description: | Specifies whether migration should only be performed diff --git a/api-ref/source/share-actions.inc b/api-ref/source/share-actions.inc index 288401408e..a0fb31e969 100644 --- a/api-ref/source/share-actions.inc +++ b/api-ref/source/share-actions.inc @@ -271,7 +271,7 @@ Request - project_id: project_id_path - share_id: share_id - reset_status: reset_status - - status: access_status + - status: share_status_request Request example diff --git a/api-ref/source/share-groups.inc b/api-ref/source/share-groups.inc index 75efd2534c..cc621a8e54 100644 --- a/api-ref/source/share-groups.inc +++ b/api-ref/source/share-groups.inc @@ -135,7 +135,7 @@ Response parameters - share_network_id: share_network_id - share_types: share_types_1 - links: share_group_links - - availability_zone: availability_zone_id_2 + - availability_zone: availability_zone_id_share_group - consistent_snapshot_support: consistent_snapshot_support Response example @@ -180,9 +180,9 @@ Request - description: description_request - share_types: share_types - share_group_type: share_group_type_id - - share_network: share_network_id_1 + - share_network: share_network_id_request - source_share_group_snapshot: source_share_group_snapshot_id - - availability_zone: availability_zone_id_2 + - availability_zone: availability_zone_id_share_group Request example --------------- @@ -207,7 +207,7 @@ Response parameters - share_network_id: share_network_id - share_types: share_types_1 - links: share_group_links - - availability_zone: availability_zone_id_2 + - availability_zone: availability_zone_id_share_group - consistent_snapshot_support: consistent_snapshot_support Response example @@ -319,7 +319,7 @@ Response parameters - share_network_id: share_network_id - share_types: share_types_1 - links: share_group_links - - availability_zone: availability_zone_id_2 + - availability_zone: availability_zone_id_share_group - consistent_snapshot_support: consistent_snapshot_support Response example diff --git a/api-ref/source/share-instances.inc b/api-ref/source/share-instances.inc index cd005a80c0..31781485be 100644 --- a/api-ref/source/share-instances.inc +++ b/api-ref/source/share-instances.inc @@ -45,19 +45,19 @@ Response parameters .. rest_parameters:: parameters.yaml - - status: status_5 + - status: share_status_response - access_rules_status: access_rules_status - - share_id: share_id_2 + - share_id: share_id_share_instances_response - progress: progress_share_instance - - availability_zone: availability_zone_1 + - availability_zone: availability_zone - created_at: created_at - replica_state: replica_state - export_location: export_location - export_locations: export_locations - cast_rules_to_readonly: share_instance_cast_rules_to_readonly - - share_network_id: share_network_id_4 + - share_network_id: share_network_id - share_server_id: share_server_id - - host: host_6 + - host: host_resource_response - id: id_13 Response example @@ -103,19 +103,19 @@ Response parameters .. rest_parameters:: parameters.yaml - - status: status_5 + - status: share_status_response - access_rules_status: access_rules_status - - share_id: share_id_2 + - share_id: share_id_share_instances_response - progress: progress_share_instance - - availability_zone: availability_zone_1 + - availability_zone: availability_zone - created_at: created_at - replica_state: replica_state - export_location: export_location - export_locations: export_locations - cast_rules_to_readonly: share_instance_cast_rules_to_readonly - - share_network_id: share_network_id_4 + - share_network_id: share_network_id - share_server_id: share_server_id - - host: host_6 + - host: host_resource_response - id: id_13 Response example @@ -158,7 +158,7 @@ Request - project_id: project_id_path - share_instance_id: share_instance_id - - status: status_5 + - status: share_status_request Request example --------------- diff --git a/api-ref/source/share-network-subnets.inc b/api-ref/source/share-network-subnets.inc index 329eaaf38f..57ee582eb2 100644 --- a/api-ref/source/share-network-subnets.inc +++ b/api-ref/source/share-network-subnets.inc @@ -202,7 +202,7 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: share_network_id + - id: share_network_subnet_id - neutron_net_id: share_network_subnet_neutron_net_id - neutron_subnet_id: share_network_subnet_neutron_subnet_id - network_type: share_network_subnet_network_type diff --git a/api-ref/source/share-networks.inc b/api-ref/source/share-networks.inc index 12a5ef3083..54c8752101 100644 --- a/api-ref/source/share-networks.inc +++ b/api-ref/source/share-networks.inc @@ -76,7 +76,7 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: share_network_id + - id: share_network_id_share_networks_response - name: name Response example @@ -122,7 +122,7 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: share_network_id + - id: share_network_id_share_networks_response - project_id: project_id - neutron_net_id: neutron_net_id - neutron_subnet_id: neutron_subnet_id @@ -184,7 +184,7 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: share_network_id + - id: share_network_id_share_networks_response - project_id: project_id - neutron_net_id: neutron_net_id - neutron_subnet_id: neutron_subnet_id @@ -268,7 +268,7 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: share_network_id + - id: share_network_id_share_networks_response - project_id: project_id - neutron_net_id: neutron_net_id - neutron_subnet_id: neutron_subnet_id @@ -342,7 +342,7 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: share_network_id + - id: share_network_id_share_networks_response - project_id: project_id - neutron_net_id: neutron_net_id - neutron_subnet_id: neutron_subnet_id @@ -413,7 +413,7 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: share_network_id + - id: share_network_id_share_networks_response - project_id: project_id - neutron_net_id: neutron_net_id - neutron_subnet_id: neutron_subnet_id @@ -492,7 +492,7 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: share_network_id + - id: share_network_id_share_networks_response - project_id: project_id - neutron_net_id: neutron_net_id - neutron_subnet_id: neutron_subnet_id diff --git a/api-ref/source/share-servers.inc b/api-ref/source/share-servers.inc index 6174aa1f66..6aa4b8e856 100644 --- a/api-ref/source/share-servers.inc +++ b/api-ref/source/share-servers.inc @@ -75,7 +75,7 @@ Response parameters - id: share_server_id - project_id: project_id - status: status_share_server_body - - share_network_id: share_network_id + - share_network_id: share_network_id_share_servers_response - share_network_name: share_network_name - host: host_share_server_body - updated_at: updated_at @@ -126,7 +126,7 @@ Response parameters - project_id: project_id - status: status_share_server_body - backend_details: backend_details - - share_network_id: share_network_id_share_server_body + - share_network_id: share_network_id_share_servers_response - share_network_name: share_network_name - host: host_share_server_body - created_at: created_at @@ -252,7 +252,7 @@ Request - project_id: project_id_path - host: manage_host - identifier: identifier - - share_network: share_network_id + - share_network: share_network_id_manage_server_request - driver_options: driver_options - share_network_subnet_id: share_network_subnet_id_manage_server_request @@ -273,7 +273,7 @@ Response parameters - status: share_server_status - host: manage_host - share_network_name: share_network_name - - share_network_id: share_network_id + - share_network_id: share_network_id_share_servers_response - created_at: created_at - backend_details: backend_details - is_auto_deletable: is_auto_deletable diff --git a/api-ref/source/share-types.inc b/api-ref/source/share-types.inc index d641a71be1..c9cd869b03 100644 --- a/api-ref/source/share-types.inc +++ b/api-ref/source/share-types.inc @@ -124,7 +124,7 @@ Response parameters - extra_specs: extra_specs - driver_handles_share_servers: driver_handles_share_servers - replication_type: replication_type - - snapshot_support: snapshot_support_1 + - snapshot_support: snapshot_support - mount_snapshot_support: mount_snapshot_support - revert_to_snapshot_support: revert_to_snapshot_support - share_type_access:is_public: share_type_access:is_public @@ -176,7 +176,7 @@ Response parameters - required_extra_specs: required_extra_specs - extra_specs: extra_specs - driver_handles_share_servers: driver_handles_share_servers - - snapshot_support: snapshot_support_1 + - snapshot_support: snapshot_support - share_type_access:is_public: share_type_access:is_public - name: share_type_name - description: share_type_description @@ -227,7 +227,7 @@ Response Parameters - required_extra_specs: required_extra_specs - extra_specs: extra_specs - driver_handles_share_servers: driver_handles_share_servers - - snapshot_support: snapshot_support_1 + - snapshot_support: snapshot_support - replication_type: replication_type - mount_snapshot_support: mount_snapshot_support - revert_to_snapshot_support: revert_to_snapshot_support @@ -280,7 +280,7 @@ Response parameters - extra_specs: extra_specs - driver_handles_share_servers: driver_handles_share_servers - - snapshot_support: snapshot_support_1 + - snapshot_support: snapshot_support - replication_type: replication_type - mount_snapshot_support: mount_snapshot_support - revert_to_snapshot_support: revert_to_snapshot_support @@ -324,7 +324,7 @@ Request - project_id: project_id_path - extra_specs: extra_specs - driver_handles_share_servers: driver_handles_share_servers - - snapshot_support: snapshot_support_1 + - snapshot_support: snapshot_support - os-share-type-access:is_public: os-share-type-access:is_public - name: share_type_name_request - replication_type: replication_type @@ -348,7 +348,7 @@ Response parameters - required_extra_specs: required_extra_specs - extra_specs: extra_specs - driver_handles_share_servers: driver_handles_share_servers - - snapshot_support: snapshot_support_1 + - snapshot_support: snapshot_support - os-share-type-access:is_public: os-share-type-access:is_public - share_type_access:is_public: share_type_access:is_public - name: share_type_name @@ -663,10 +663,10 @@ Response parameters - required_extra_specs: required_extra_specs - extra_specs: extra_specs - driver_handles_share_servers: driver_handles_share_servers - - snapshot_support: snapshot_support_1 + - snapshot_support: snapshot_support - share_type_access:is_public: share_type_access:is_public_body - name: share_type_name - - replication_type: replication_type_body + - replication_type: replication_type - mount_snapshot_support: mount_snapshot_support_body - revert_to_snapshot_support: revert_to_snapshot_support_body - create_share_from_snapshot_support: create_share_from_snapshot_support_body diff --git a/api-ref/source/shares.inc b/api-ref/source/shares.inc index ff17a8bf43..e913989d38 100644 --- a/api-ref/source/shares.inc +++ b/api-ref/source/shares.inc @@ -140,7 +140,7 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: id_4 + - id: share_id_response - links: links - name: name - count: count @@ -208,36 +208,41 @@ Response parameters .. rest_parameters:: parameters.yaml - - share_type_name: share_type_name - - links: links + - id: share_id_response + - size: size_response - availability_zone: availability_zone - - share_network_id: share_network_id - - export_locations: export_locations - - share_server_id: share_server_id - - snapshot_id: snapshot_id_share_response - - id: id_4 - - size: size_2 - - share_type: share_type_1 - - export_location: export_location - - project_id: project_id - - metadata: metadata - - status: status_16 - - progress: progress_share_instance - - description: description - - host: host_1 - - access_rules_status: access_rules_status - - is_public: is_public - - share_group_id: share_group_id - - task_state: task_state - - snapshot_support: snapshot_support - - name: name - - has_replicas: has_replicas - - replication_type: replication_type - created_at: created_at + - status: share_status_response + - name: name + - description: description + - project_id: project_id + - snapshot_id: snapshot_id_shares_response + - share_network_id: share_network_id - share_proto: share_proto - - volume_type: volume_type - - count: count + - metadata: metadata + - share_type: share_type_shares_response + - links: links + - is_public: is_public_shares_response + - share_server_id: share_server_id + - host: host_resource_response + - snapshot_support: snapshot_support_share_capability + - task_state: task_state + - share_type_name: share_type_name + - access_rules_status: access_rules_status + - replication_type: replication_type_share_capability + - has_replicas: has_replicas - user_id: share_user_id + - create_share_from_snapshot_support: create_share_from_snapshot_support_share_capability + - revert_to_snapshot_support: revert_to_snapshot_support_share_capability + - share_group_id: share_group_id + - source_share_group_snapshot_member_id: source_share_group_snapshot_member_id + - mount_snapshot_support: mount_snapshot_support_share_capability + - progress: progress_share_instance + - count: count + - volume_type: volume_type_shares_response + - export_location: export_location + - export_locations: export_locations + Response example ---------------- @@ -281,35 +286,40 @@ Response parameters .. rest_parameters:: parameters.yaml - - share_type_name: share_type_name - - links: links - - availability_zone: availability_zone_1 - - share_network_id: share_network_id - - export_locations: export_locations - - share_server_id: share_server_id - - snapshot_id: snapshot_id_share_response - - id: id_4 - - size: size_2 - - share_type: share_type_1 - - export_location: export_location - - project_id: project_id - - metadata: metadata - - status: status_16 - - progress: progress_share_instance - - description: description - - host: host_9 - - access_rules_status: access_rules_status - - is_public: is_public - - share_group_id: share_group_id - - task_state: task_state - - snapshot_support: snapshot_support - - name: name - - has_replicas: has_replicas - - replication_type: replication_type + - id: share_id_response + - size: size_response + - availability_zone: availability_zone - created_at: created_at + - status: share_status_response + - name: name + - description: description + - project_id: project_id + - snapshot_id: snapshot_id_shares_response + - share_network_id: share_network_id - share_proto: share_proto - - volume_type: volume_type + - metadata: metadata + - share_type: share_type_shares_response + - links: links + - is_public: is_public_shares_response + - share_server_id: share_server_id + - host: host_resource_response + - snapshot_support: snapshot_support_share_capability + - task_state: task_state + - share_type_name: share_type_name + - access_rules_status: access_rules_status + - replication_type: replication_type_share_capability + - has_replicas: has_replicas - user_id: share_user_id + - create_share_from_snapshot_support: create_share_from_snapshot_support_share_capability + - revert_to_snapshot_support: revert_to_snapshot_support_share_capability + - share_group_id: share_group_id + - source_share_group_snapshot_member_id: source_share_group_snapshot_member_id + - mount_snapshot_support: mount_snapshot_support_share_capability + - progress: progress_share_instance + - count: count + - volume_type: volume_type_shares_response + - export_location: export_location + - export_locations: export_locations Response example ---------------- @@ -348,19 +358,18 @@ Request - project_id: project_id_path - share_proto: share_proto - - size: size + - size: size_request - name: name_request - description: description_request - display_name: display_name_request - display_description: display_description_request - - share_type: share_type - - volume_type: volume_type + - share_type: share_type_request - snapshot_id: snapshot_id_request - - is_public: is_public + - is_public: is_public_request - share_group_id: share_group_id_request - metadata: metadata - - share_network_id: share_network_id_2 - - availability_zone: availability_zone + - share_network_id: share_network_id_request + - availability_zone: availability_zone_request Request example --------------- @@ -373,34 +382,40 @@ Response parameters .. rest_parameters:: parameters.yaml - - id: id_4 - - status: status_3 - - progress: progress_share_instance - - links: links - - project_id: project_id - - share_proto: share_proto - - size: size + - id: share_id_response + - size: size_response + - availability_zone: availability_zone + - created_at: created_at + - status: share_status_response - name: name - description: description - - share_type: share_type_1 - - share_type_name: share_share_type_name - - has_replicas: has_replicas - - replication_type: replication_type - - volume_type: volume_type - - snapshot_id: snapshot_id_share_response - - is_public: is_public - - share_group_id: share_group_id - - metadata: metadata + - project_id: project_id + - snapshot_id: snapshot_id_shares_response - share_network_id: share_network_id - - availability_zone: availability_zone_1 + - share_proto: share_proto + - metadata: metadata + - share_type: share_type_shares_response + - links: links + - is_public: is_public_shares_response + - share_server_id: share_server_id + - host: host_resource_response + - snapshot_support: snapshot_support_share_capability + - task_state: task_state + - share_type_name: share_type_name + - access_rules_status: access_rules_status + - replication_type: replication_type_share_capability + - has_replicas: has_replicas + - user_id: share_user_id + - create_share_from_snapshot_support: create_share_from_snapshot_support_share_capability + - revert_to_snapshot_support: revert_to_snapshot_support_share_capability + - share_group_id: share_group_id + - source_share_group_snapshot_member_id: source_share_group_snapshot_member_id + - mount_snapshot_support: mount_snapshot_support_share_capability + - progress: progress_share_instance + - count: count + - volume_type: volume_type_shares_response - export_location: export_location - export_locations: export_locations - - host: host_1 - - task_state: task_state - - share_server_id: share_server_id - - snapshot_support: snapshot_support - - created_at: created_at - - user_id: share_user_id Response example ---------------- @@ -453,12 +468,12 @@ Request - share: share - protocol: protocol - name: name_request - - share_type: share_type_2 + - share_type: share_type_request - driver_options: driver_options - export_path: export_path - service_host: service_host - share_server_id: manage_share_server_id - - is_public: is_public + - is_public: is_public_manage_request - description: description_request Request example @@ -472,34 +487,40 @@ Response parameters .. rest_parameters:: parameters.yaml - - share: share - - links: links - - availability_zone: availability_zone_1 - - share_network_id: share_network_id - - export_locations: export_locations - - share_server_id: share_server_id - - snapshot_id: snapshot_id_share_response - - id: id_4 - - size: size_2 - - share_type: share_type_1 - - share_type_name: share_share_type_name - - has_replicas: has_replicas - - replication_type: replication_type - - export_location: export_location - - project_id: project_id - - metadata: metadata - - status: status_8 - - share_server_id: manage_share_server_id - - description: description - - host: host_9 - - is_public: is_public - - share_group_id: share_group_id - - snapshot_support: snapshot_support - - name: name + - id: share_id_response + - size: size_response + - availability_zone: availability_zone - created_at: created_at + - status: share_status_response + - name: name + - description: description + - project_id: project_id + - snapshot_id: snapshot_id_shares_response + - share_network_id: share_network_id - share_proto: share_proto - - volume_type: volume_type + - metadata: metadata + - share_type: share_type_shares_response + - links: links + - is_public: is_public_shares_response + - share_server_id: share_server_id + - host: host_resource_response + - snapshot_support: snapshot_support_share_capability + - task_state: task_state + - share_type_name: share_type_name + - access_rules_status: access_rules_status + - replication_type: replication_type_share_capability + - has_replicas: has_replicas - user_id: managed_share_user_id + - create_share_from_snapshot_support: create_share_from_snapshot_support_share_capability + - revert_to_snapshot_support: revert_to_snapshot_support_share_capability + - share_group_id: share_group_id + - source_share_group_snapshot_member_id: source_share_group_snapshot_member_id + - mount_snapshot_support: mount_snapshot_support_share_capability + - progress: progress_share_instance + - count: count + - volume_type: volume_type_shares_response + - export_location: export_location + - export_locations: export_locations Response example ---------------- @@ -549,7 +570,7 @@ Request - project_id: project_id_path - share_id: share_id - - is_public: is_public + - is_public: is_public_request - display_name: display_name_request - display_description: display_description_request @@ -564,34 +585,40 @@ Response parameters .. rest_parameters:: parameters.yaml - - share_type_name: share_share_type_name - - links: links - - availability_zone: availability_zone_1 - - share_network_id: share_network_id - - export_locations: export_locations - - share_server_id: share_server_id - - snapshot_id: snapshot_id_share_response - - id: id_4 - - size: size_2 - - share_type: share_type_1 - - export_location: export_location - - project_id: project_id - - metadata: metadata - - status: status_16 - - description: description - - host: host_9 - - access_rules_status: access_rules_status - - is_public: is_public - - share_group_id: share_group_id - - task_state: task_state - - snapshot_support: snapshot_support - - name: name - - has_replicas: has_replicas - - replication_type: replication_type + - id: share_id_response + - size: size_response + - availability_zone: availability_zone - created_at: created_at + - status: share_status_response + - name: name + - description: description + - project_id: project_id + - snapshot_id: snapshot_id_shares_response + - share_network_id: share_network_id - share_proto: share_proto - - volume_type: volume_type + - metadata: metadata + - share_type: share_type_shares_response + - links: links + - is_public: is_public_shares_response + - share_server_id: share_server_id + - host: host_resource_response + - snapshot_support: snapshot_support_share_capability + - task_state: task_state + - share_type_name: share_type_name + - access_rules_status: access_rules_status + - replication_type: replication_type_share_capability + - has_replicas: has_replicas - user_id: share_user_id + - create_share_from_snapshot_support: create_share_from_snapshot_support_share_capability + - revert_to_snapshot_support: revert_to_snapshot_support_share_capability + - share_group_id: share_group_id + - source_share_group_snapshot_member_id: source_share_group_snapshot_member_id + - mount_snapshot_support: mount_snapshot_support_share_capability + - progress: progress_share_instance + - count: count + - volume_type: volume_type_shares_response + - export_location: export_location + - export_locations: export_locations Response example ----------------