diff --git a/api-ref-guides/pom.xml b/api-ref-guides/pom.xml index 150d6cbda..7484d8390 100644 --- a/api-ref-guides/pom.xml +++ b/api-ref-guides/pom.xml @@ -94,17 +94,6 @@ api-ref-clustering-v1 - - os-api-ref-compute-v2.1 - - generate-pdf - - generate-sources - - bk-api-ref-compute-v2.1.xml - api-ref-compute-v2.1 - - os-api-ref-database-v1 diff --git a/api-ref-guides/src/bk-api-ref-compute-v2.1.xml b/api-ref-guides/src/bk-api-ref-compute-v2.1.xml deleted file mode 100644 index 56b41b27b..000000000 --- a/api-ref-guides/src/bk-api-ref-compute-v2.1.xml +++ /dev/null @@ -1,37 +0,0 @@ - - - - OpenStack Compute API Reference - API Reference - - - - - - - OpenStack Foundation - - - - 2010-2016 - OpenStack Foundation - - OpenStack Compute - - - - Copyright details are filled in by the - template. - - - - - - diff --git a/api-ref-guides/src/bk-api-ref.xml b/api-ref-guides/src/bk-api-ref.xml index 9a683ceb6..afc7e3350 100644 --- a/api-ref-guides/src/bk-api-ref.xml +++ b/api-ref-guides/src/bk-api-ref.xml @@ -36,7 +36,6 @@ - diff --git a/api-ref/README.rst b/api-ref/README.rst new file mode 100644 index 000000000..980998ff8 --- /dev/null +++ b/api-ref/README.rst @@ -0,0 +1,2 @@ +Compute API was migrated into the ``api-ref`` directory +on the ``openstack/nova`` repository. diff --git a/api-ref/pom.xml b/api-ref/pom.xml index 896492733..d70f746bc 100644 --- a/api-ref/pom.xml +++ b/api-ref/pom.xml @@ -91,17 +91,6 @@ bk-api-ref-clustering-v1 - - os-api-ref-compute-v2.1 - - generate-html - - generate-sources - - api-ref-compute-v2.1.xml - bk-api-ref-compute-v2.1 - - os-api-ref-data-processing-v1.1 diff --git a/api-ref/src/docbkx/api-ref-compute-v2.1.xml b/api-ref/src/docbkx/api-ref-compute-v2.1.xml deleted file mode 100644 index e84353c42..000000000 --- a/api-ref/src/docbkx/api-ref-compute-v2.1.xml +++ /dev/null @@ -1,23 +0,0 @@ - - - - OpenStack Compute API (CURRENT) - - 2010-2016 - - - - - - - - - - diff --git a/api-ref/src/docbkx/ch_compute-v2.1.xml b/api-ref/src/docbkx/ch_compute-v2.1.xml deleted file mode 100644 index bb9220aa6..000000000 --- a/api-ref/src/docbkx/ch_compute-v2.1.xml +++ /dev/null @@ -1,874 +0,0 @@ - - - %common_project; - ]> - - Compute API (CURRENT) - - This documentation supports the API v2.1 base version. If you enable all - extensions, the Compute API v1.1 and v2.0 requests and responses match the - API v2.1 requests and responses. - - - Each API version lists the extensions that it requires to make the full - request and responses available. API v2.1 must enable all extensions all - the time. It uses micro-version headers to expose any additional - functionality. - - - - Effective in the OpenStack Kilo release, the Compute API no longer - supports XML in requests and responses. - - - - For details about the Compute API, see the Compute - API. - -
- API versions - - Lists information for all API versions. - - - - - - - - - - - - -
-
- Servers (servers) - Lists, creates, shows details for, updates, and deletes servers. - Passwords - - When you create a server, you can specify a password through the - optional adminPass attribute. The password must - meet the complexity requirements set by your OpenStack Compute - provider. The server might enter an ERROR state if the - complexity requirements are not met. In this case, a client might - issue a change password action to reset the server password. - - - If you do not specify a password, the API generates and assigns a - random password that it returns in the response object. This password - meets the security requirements set by the compute provider. For - security reasons, subsequent &GET; calls do not require this password. - - Server metadata - - You can specify custom server metadata at server launch time. The - maximum size for each metadata key-value pair is 255 bytes. The - compute provider determines the maximum number of key-value pairs for - each server. You can query this value through the - maxServerMeta absolute limit. - - Server networks - - You can specify one or more networks to which the server connects at - launch time. Users can also specify a specific port on the network - or the fixed IP address to assign to the server interface. - - - - You can use both IPv4 and IPv6 addresses as access addresses and - you can assign both addresses simultaneously. You can update - access addresses after you create a server. - - - Server personality - - To customize the personality of a server instance, you can - inject data into its file system. For example, you might - insert ssh keys, set configuration files, or store data - that you want to retrieve from inside the instance. This - customization method provides minimal launch-time - personalization. If you require significant customization, - create a custom image. - - - Follow these guidelines when you inject files: - - - - - The maximum size of the file path data is 255 bytes. - - - - - Encode the file contents as a Base64 string. The compute provider - determines the maximum size of the file contents. The image that - you use to create the server determines this value. - - - - The maximum limit refers to the number of bytes in the decoded - data and not to the number of characters in the encoded data. - - - - - - The maxPersonality absolute limit defines - the maximum number of file path and content pairs that - you can supply. The compute provider determines this - value. - - - - - The maxPersonalitySize absolute limit is a byte limit - that applies to all images in the deployment. Providers can set - additional per-image personality limits. - - - - - The file injection might not occur until after the server - builds and boots. - - - After file injection, only system administrators can access - personality files. For example, on Linux, all files have root as the - owner and the root group as the group owner, and allow only user and - group read access (chmod 440). - - Server access addresses - - In a hybrid environment, the underlying implementation might not - control the IP address of a server. Instead, the access IP address - might be part of the dedicated hardware; for example, a router/NAT - device. In this case, you cannot use the addresses that the - implementation provides to access the server from outside the local - LAN. Instead, the API might assign a separate access - address at creation time to provide access to the server. - This address might not be directly bound to a network interface on the - server and might not necessarily appear when you query the server - addresses. However, clients should use an access address to access the - server directly. - - -
-
- Servers multiple create (servers) - - Creates one or more servers. - - - Optionally, you can set "return_reservation_id": "True" - in the request body to request that a reservation ID be returned - instead of the newly created instance information. With this - parameter, the response shows only the reservation ID. - - -
-
- Servers - run an action (servers, action) - - Enables all users to performs an action on a server. Specify the action - in the request body. - - - You can associate a fixed or floating IP address with a server instance, - or disassociate a fixed or floating IP address from a server instance. - You can attach a volume to a server. - - - You can create an image from a server, evacuate a server from a failed - host to a new host, and force-delete a server before deferred cleanup. - You can lock, pause, reboot, rebuild, rescue, resize, resume, confirm - the resize of, revert a pending resize for, shelve, shelf-offload, - unshelve, start, stop, unlock, unpause, and unrescue a server. You can - also change the password of the server and add a security group to or - remove a security group from a server. You can also trigger a crash - dump into a server since Mitaka release. - - - You can get an RDP, serial, SPICE, or VNC console for a server. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- Servers - run an administrative action (servers, action) - - Enables administrators to perform an action on a server. Specify the - action in the request body. - - - You can change the administrative password for, create a back up of, and - inject network information into a server. - - - You can migrate, live-migrate, reset networking on, and reset the state - of a server. - - -
-
- Servers diagnostics (servers, diagnostics) - - Shows the usage data for a server. - - -
-
- Servers IPs (servers, ips) - - Lists the IP addresses for an instance and shows details for - an IP address. - - -
-
- Server metadata (servers, metadata) - - Lists metadata, creates or replaces one or more metadata - items, and updates one or more metadata items for a server. - - - Shows details for, creates or replaces, and updates a metadata item, - by key, for a server. - - -
-
- Servers - list actions (servers, os-instance-actions) - - All users can list available actions for a server. - - - All users can show details for a server action; however, only - administrators can view server events in server action details. - - -
-
- Port interfaces (servers, os-interface) - - Creates a port interface and uses it to attach a port to a server and - detaches a port interface from a server. Also, lists all port - interfaces and shows details for a port interface. - - -
-
- Servers password (servers, os-server-password) - - Shows the encrypted administrative password. Also, clears the - encrypted administrative password for a server, which removes it from - the metadata server. - - -
-
- Servers virtual interfaces (servers, os-virtual-interfaces) - - Lists virtual interfaces for a server instance. - - -
-
- Servers with volume attachments (servers, os-volume_attachments) - - Attaches volumes that are created through the volume API to server - instances. Also, lists volume attachments for a server instance, shows - details for a volume attachment, and detaches a volume. - - -
-
- Flavors with extended attributes (flavors) - - Shows information about flavors. - - -
-
- Flavors access (flavors, os-flavor-access, action) - - Lists tenants who have access to a private flavor and adds private - flavor access to and removes private flavor access from tenants. By - default, only administrators can manage private flavor access. A private - flavor has is_public set to false while a - public flavor has is_public set to true. - - - - - - - - - - -
-
- Flavors extra-specs (flavors, os-flavor-extra-specs) - - Lists, creates, deletes, and updates the extra-specs or keys for a - flavor. - - -
-
- Keypairs (keypairs) - Generates, imports, and deletes SSH keys. - -
-
- Limits (limits) - - Shows rate and absolute limits for the tenant. - - -
-
- Extensions (extensions) - - Lists available extensions and shows information for an extension, by - alias. - - - OpenStack Compute API v2.0 supports extensions. However, extensions are - deprecated in Compute API v2.1. For information about extensions, see Extensions. - - -
-
- Images - - Lists, shows details for, and deletes images. Also sets, lists, - shows details for, and deletes image metadata. - - - An image is a collection of files that you use to create and - rebuild a server. By default, operators provide pre-built - operating system images. You can also create custom images. See - Compute server actions. - - - By default, the policy.json file authorizes all users to - view the image size in the OS-EXT-IMG-SIZE:size extended - attribute. - - - - - - - - - - - - - -
-
- Image metadata - - Shows details for, sets, updates, and deletes image metadata or metadata - items. - - - - - - - - - - - - - -
-
- Guest agents (os-agents) - - Creates, lists, updates, and deletes guest agent builds. Use guest - agents to access files on the disk, configure networking, or run other - applications or scripts in the guest while the agent runs. This - hypervisor-specific extension is not currently enabled for KVM. Use of - guest agents is possible only if the underlying service provider uses - the Xen driver. - - -
-
- Host aggregates (os-aggregates, action) - - Creates and manages host aggregates. An aggregate assigns metadata to - groups of compute nodes. Aggregates are only visible to the cloud - provider. - - -
-
- Assisted volume snapshots (os-assisted-volume-snapshots) - - Creates and deletes snapshots through an emulator/hypervisor. - The qcow2 file format is supported. - - - An internal snapshot that lacks storage such as NFS or GlusterFS - can use an emulator/hypervisor to add the snapshot feature. - - -
-
- Availability zones (os-availability-zone) - - Shows availability zone information. - - -
-
- Bare metal nodes (os-baremetal-nodes) - Bare metal nodes. - -
-
- Cells (os-cells, capacities) - - Adds neighbor cells, lists neighbor cells, and shows the capabilities - of the local cell. - - -
-
- Root certificates (os-certificates) - Creates and shows details for a root certificate. - -
-
- Cloudpipe (os-cloudpipe) - Manages virtual VPNs for projects. - -
-
- Server consoles (servers, os-consoles, os-console-auth-token) - Manages server consoles. - -
-
- Fixed IPs (os-fixed-ips) - - Shows data for a fixed IP, such as host name, CIDR, and - address. Also, reserves and frees a fixed IP address. - - -
-
- Floating IP DNS records (os-floating-ip-dns) - - Manages DNS records associated with floating IP addresses. The API - dispatches requests to a DNS driver that is selected at startup. - - -
-
- Floating IP pools (os-floating-ip-pools) - - Manages groups of floating IPs. - - -
-
- Floating IPs (os-floating-ips) - - Lists floating IP addresses for a project. Also, creates (allocates) a - floating IP address for a project, shows floating IP address details, - and deletes (deallocates) a floating IP address from a project. - - - - The cloud administrator configures a pool of floating IP addresses in - OpenStack Compute. The project quota defines the maximum number of - floating IP addresses that you can allocate to the project. - After you allocate - a floating IP address for a project, you can: - - - - - Add - (associate) the floating - IP address with an instance in the project. You can associate only one - floating IP address with an instance at a time. - - - - - Remove - (disassociate) the floating IP address from an instance in the project. - - - - - Delete, or deallocate, a floating IP from the project, which - automatically deletes any associations for that IP address. - - - - -
-
- Floating IPs bulk (os-floating-ips-bulk) - - (nova-network only) Bulk-creates, deletes, and lists floating IPs. - Default pool name is nova. - - - To view available pools, use the os-floating-ip-pools - extension. - - -
-
- Ping instances (os-fping) - - Pings instances and reports which ones are alive. - - -
-
- Hosts (os-hosts) - - Manages physical hosts. Some virt drivers don not support all host - functions. For more information, see - nova virt support matrix - - -
-
- Hypervisors (os-hypervisors) - - Lists all hypervisors, shows summary statistics for all hypervisors - over all compute nodes, shows details for a hypervisor, and shows the - uptime for a hypervisor. - - -
-
- Instance usage audit log (os-instance-usage-audit-log) - - Administrator only. Monitors task logs. - - -
-
- Migrations (os-migrations) - - Shows data on migrations. - - -
-
- Networks (os-networks) - - Creates, lists, shows information for, and deletes networks. - - - Adds network to a project, disassociates a network from a project, - and disassociates a project from a network. - - - Associates host with and disassociates host from a network. - - -
-
- Quota class (os-quota-class-sets) - - Provides quota classes management support. - - -
-
- Quota sets (os-quota-sets) - - Permits administrators, depending on policy settings, to view default - quotas, view details for quotas, revert quotas to defaults, and update the - quotas for a project or a project and user. - - - - - - - - - - - - - -
-
- Security groups (os-security-groups) - - Lists, shows information for, creates, and deletes security groups. - - -
-
- Rules for default security group - (os-security-group-default-rules) - - Lists, shows information for, and creates default security - group rules. - - -
-
- Rules for security group (os-security-group-rules) - - Creates and deletes security group rules. - - -
-
- Create external events (os-server-external-events) - - Creates one or more external events. The API dispatches each event to a - server instance. - - -
-
- Server groups (os-server-groups) - - Lists, shows information for, creates, and deletes server groups. - - - - - - - - - - - -
-
- Compute services (os-services) - - Lists all running Compute services for a tenant, enables or disables - scheduling for a Compute service, logs disabled Compute service - information, and deletes a Compute service. - - - For an overview of Compute services, see OpenStack Compute. - - -
-
- Usage reports (os-simple-tenant-usage) - - Reports usage statistics on compute and storage resources. - - -
-
- Project networks (os-tenant-networks) - - Creates, lists, shows information for, and deletes project networks. - - -
-
- Volume extension (os-volumes, os-snapshots) - - Manages volumes and snapshots for use with the Compute API. - - -
-
- diff --git a/api-ref/src/docbkx/itemizedlist-service-list.xml b/api-ref/src/docbkx/itemizedlist-service-list.xml index ba8b64fff..5de54a638 100644 --- a/api-ref/src/docbkx/itemizedlist-service-list.xml +++ b/api-ref/src/docbkx/itemizedlist-service-list.xml @@ -27,7 +27,7 @@ - Compute API (CURRENT) + Compute API (CURRENT) diff --git a/api-ref/src/wadls/compute-api/src/v2.1/common.ent b/api-ref/src/wadls/compute-api/src/v2.1/common.ent deleted file mode 100644 index c15d61ab0..000000000 --- a/api-ref/src/wadls/compute-api/src/v2.1/common.ent +++ /dev/null @@ -1,3764 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - -'> - - - - -'> - - - - - - - - -'> - - - -'> - - - - -'> - - - -'> - - - - -'> - - - - - The UUID of the administrative tenant. - - -'> - - - - The UUID of the agent build. - - -'> - - - - The aggregate ID. - - -'> - - - - An alias for the extension name. - For example, os-server-external-events. - - -'> - - - - The UUID of the attachment. - - -'> - - - - The UUID of the cell. - - -'> - - - - The certificate ID, as a string. The only valid value is root. - - -'> - - - - The UUID of the quota class. - - -'> - - - - The UUID of the console. - - -'> - - - - The name of the DNS entry. - - -'> - - - - The dns_entry object. - - -'> - - - - The dns_entries object. - - -'> - - - - The registered DNS domain that the DNS drivers publish. - - -'> - - - - The extra spec key for the flavor. - - -'> - - - - The ID of the flavor. - - -'> - - - - The ID of the floating IP address. - - -'> - - - - The fixed IP of interest to you. - - -'> - - - - The name of the host. - - -'> - - - - The UUID of the hypervisor. - -'> - - - - The UUID of the image. - - -'> - - - - The UUID of the instance. - -'> - - - - The IP address. - -'> - - - - The metadata item key, as a string. Maximum length is 255 characters. - - -'> - - - - The keypair name. - - -'> - - - - The UUID of the network. - -'> - - - - The network label, such as public or private. - - -'> - - - - The node ID. - - -'> - - - - The UUID of the port. - - -'> - - - - The ID of the request. - -'> - - - - The ID of the security group. - - -'> - - - - The UUID of the security group rule. - - -'> - - - - The ID of the security group rule. - - -'> - - - - The UUID of the server. - - -'> - - - - The UUID of the server group. - - -'> - - - - The UUID of the service. - - -'> - - - - The UUID of the snapshot. - - -'> - - - - The UUID of the tenant in a multi-tenancy cloud. - - -'> - - - - The unique ID for a volume. - - -'> - - - - The unique ID for a volume type. - - -'> - - - - - Filters the response by a server, as a URL. - - - - - - - Filters the response by a server name, as a string. - - - - - - - Filters the response by an image status, as a string. For example, - ACTIVE. - - - -&limitMarkerReqParameter; - - - - Filters the response by an image type, as a string. For example, - BASE, SERVER, or ALL. - - -