doc: update metadata service doc
1 update to the latest metadata version in the examples 2 fix a typo 3 update a url Change-Id: I5a78088413ba3e15d3f3c19392effa898205f502
This commit is contained in:
parent
0ba34a8184
commit
1142f64ba2
|
@ -51,23 +51,63 @@ earlier version if the most recent one is not available.
|
|||
|
||||
Metadata from the OpenStack API is distributed in JSON format. To retrieve the
|
||||
metadata, make a GET request to
|
||||
``http://169.254.169.254/openstack/2012-08-10/meta_data.json``:
|
||||
``http://169.254.169.254/openstack/2018-08-27/meta_data.json``:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ curl http://169.254.169.254/openstack/2012-08-10/meta_data.json
|
||||
$ curl http://169.254.169.254/openstack/2018-08-27/meta_data.json
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
{
|
||||
"random_seed": "yu5ZnkqF2CqnDZVAfZgarGLoFubhcK5wHG4fcNfVZEtie/bTV8k2dDXK\
|
||||
C7krP2cjp9A7g9LIWe5+WSaZ3zpvQ03hp/4mMNy9V1U/mnRMZyQ3W4Fn\
|
||||
Nex7UP/0Smjb9rVzfUb2HrVUCN61Yo4jHySTd7UeEasF0nxBrx6NFY6e\
|
||||
KRoELGPPr1S6+ZDcDT1Sp7pRoHqwVbzyJZc80ICndqxGkZOuvwDgVKZD\
|
||||
B6O3kFSLuqOfNRaL8y79gJizw/MHI7YjOxtPMr6g0upIBHFl8Vt1VKjR\
|
||||
s3zB+c3WkC6JsopjcToHeR4tPK0RtdIp6G2Bbls5cblQUAc/zG0a8BAm\
|
||||
p6Pream9XRpaQBDk4iXtjIn8Bf56SCANOFfeI5BgBeTwfdDGoM0Ptml6\
|
||||
BJQiyFtc3APfXVVswrCq2SuJop+spgrpiKXOzXvve+gEWVhyfbigI52e\
|
||||
l1VyMoyZ7/pbdnX0LCGHOdAU8KRnBoo99ZOErv+p7sROEIN4Yywq/U/C\
|
||||
xXtQ5BNCtae389+3yT5ZCV7fYzLYChgDMJSZ9ds9fDFIWKmsRu3N+wUg\
|
||||
eL4klxAjRgzQ7MMlap5kppnIYRxXVy0a5j1qOaBAzJB5LLJ7r3/Om38x\
|
||||
Z4+XGWjqd6KbSwhUVs1aqzxpep1Sp3nTurQCuYjgMchjslt0O5oJjh5Z\
|
||||
hbCZT3YUc8M=\n",
|
||||
"uuid": "d8e02d56-2648-49a3-bf97-6be8f1204f38",
|
||||
"availability_zone": "nova",
|
||||
"keys": [
|
||||
{
|
||||
"data": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDYVEprvtYJXVOBN0XNKV\
|
||||
VRNCRX6BlnNbI+USLGais1sUWPwtSg7z9K9vhbYAPUZcq8c/s5S9dg5vTH\
|
||||
bsiyPCIDOKyeHba4MUJq8Oh5b2i71/3BISpyxTBH/uZDHdslW2a+SrPDCe\
|
||||
uMMoss9NFhBdKtDkdG9zyi0ibmCP6yMdEX8Q== Generated by Nova\n",
|
||||
"type": "ssh",
|
||||
"name": "mykey"
|
||||
}
|
||||
],
|
||||
"hostname": "test.novalocal",
|
||||
"launch_index": 0,
|
||||
"meta": {
|
||||
"priority": "low",
|
||||
"role": "webserver"
|
||||
},
|
||||
"devices": [
|
||||
{
|
||||
"type": "nic",
|
||||
"bus": "pci",
|
||||
"address": "0000:00:02.0",
|
||||
"mac": "00:11:22:33:44:55",
|
||||
"tags": ["trusted"]
|
||||
},
|
||||
{
|
||||
"type": "disk",
|
||||
"bus": "ide",
|
||||
"address": "0:0",
|
||||
"serial": "disk-vol-2352423",
|
||||
"path": "/dev/sda",
|
||||
"tags": ["baz"]
|
||||
}
|
||||
],
|
||||
"project_id": "f7ac731cc11f40efbc03a9f9e1d1d21f",
|
||||
"public_keys": {
|
||||
"mykey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDYVEprvtYJXVOBN0XNKV\
|
||||
|
@ -79,19 +119,19 @@ metadata, make a GET request to
|
|||
}
|
||||
|
||||
Instances also retrieve user data (passed as the ``user_data`` parameter in the
|
||||
API call or by the ``--user_data`` flag in the :command:`openstack server
|
||||
API call or by the ``--user-data`` flag in the :command:`openstack server
|
||||
create` command) through the metadata service, by making a GET request to
|
||||
``http://169.254.169.254/openstack/2012-08-10/user_data``:
|
||||
``http://169.254.169.254/openstack/2018-08-27/user_data``:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ curl http://169.254.169.254/openstack/2012-08-10/user_data
|
||||
$ curl http://169.254.169.254/openstack/2018-08-27/user_data
|
||||
#!/bin/bash
|
||||
echo 'Extra user data here'
|
||||
|
||||
The metadata service has an API that is compatible with version 2009-04-04 of
|
||||
the `Amazon EC2 metadata service
|
||||
<http://docs.amazonwebservices.com/AWSEC2/2009-04-04/UserGuide/AESDG-chapter-instancedata.html>`__.
|
||||
<https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html>`__.
|
||||
This means that virtual machine images designed for EC2 will work properly with
|
||||
OpenStack.
|
||||
|
||||
|
|
Loading…
Reference in New Issue