diff --git a/docs/ecs/dev/ALL_META.TXT.json b/docs/ecs/dev/ALL_META.TXT.json index 101bc813..899dfbdc 100644 --- a/docs/ecs/dev/ALL_META.TXT.json +++ b/docs/ecs/dev/ALL_META.TXT.json @@ -13,7 +13,7 @@ "uri":"en-us_topic_0134327704.html", "product_code":"ecs", "code":"2", - "des":"Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see section API Usage Guidelines.", + "des":"Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see API Usage Guidelines.", "doc_type":"devg", "kw":"Notes,Developer Guide", "title":"Notes", diff --git a/docs/ecs/dev/CLASS.TXT.json b/docs/ecs/dev/CLASS.TXT.json index b1484a2c..aed291e4 100644 --- a/docs/ecs/dev/CLASS.TXT.json +++ b/docs/ecs/dev/CLASS.TXT.json @@ -9,7 +9,7 @@ "code":"1" }, { - "desc":"Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see section API Usage Guidelines.", + "desc":"Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see API Usage Guidelines.", "product_code":"ecs", "title":"Notes", "uri":"en-us_topic_0134327704.html", diff --git a/docs/ecs/dev/en-us_topic_0134192987.html b/docs/ecs/dev/en-us_topic_0134192987.html index 7187eb4a..b5a23a24 100644 --- a/docs/ecs/dev/en-us_topic_0134192987.html +++ b/docs/ecs/dev/en-us_topic_0134192987.html @@ -40,7 +40,7 @@
  • Select a flavor based on site requirements and record the flavor ID.

  • Determine the image.

    1. View images.
      • API

        URI format: GET /v2/{tenant_id}/images/detail

        -

        For details, see section "Querying Image Details" in Elastic Cloud Server API Reference.

        +

        For details, see section "Querying Image Details" in Elastic Cloud Server API Reference.

      • Request example

        GET: https://{endpoint}/v2/74610f3a5ad941998e91f076297ecf27/images/detail

        Obtain the endpoint from Regions and Endpoints.

      • Response example
        {
@@ -90,7 +90,7 @@
    2. Select an image based on site requirements and record the image ID.

  • Determine the network configuration.

    1. View networks.
      • API

        URI format: GET /v2/{tenant_id}/os-networks

        -

        For details, see section "Querying Networks" in Elastic Cloud Server API Reference.

        +

        For details, see section "Querying Networks" in Elastic Cloud Server API Reference.

      • Request example

        GET: https://{endpoint}/v2/74610f3a5ad941998e91f076297ecf27/os-networks

        Obtain the endpoint from Regions and Endpoints.

      • Response example
        {
@@ -113,7 +113,7 @@
    2. Select a network based on site requirements and record the network ID.

  • Set the login mode to key pair.

    1. Create a key pair.
      • API

        URI format: POST /v2/{tenant_id}/os-keypairs

        -

        For details, see section "Creating and Importing an SSH Key Pair" in Elastic Cloud Server API Reference.

        +

        For details, see section "Creating and Importing an SSH Key Pair" in Elastic Cloud Server API Reference.

      • Request example

        POST: https://{endpoint}/v2/74610f3a5ad941998e91f076297ecf27/os-keypairs

        Obtain the endpoint from Regions and Endpoints.

        Body

        @@ -135,7 +135,7 @@ }
    2. Import the key pair.
      • API

        URI format: POST /v2/{tenant_id}/os-keypairs

        -

        For details, see section "Creating and Importing an SSH Key Pair" in Elastic Cloud Server API Reference.

        +

        For details, see section "Creating and Importing an SSH Key Pair" in Elastic Cloud Server API Reference.

      • Request example

        POST: https://{endpoint}/v2/74610f3a5ad941998e91f076297ecf27/os-keypairs

        Obtain the endpoint from Regions and Endpoints.

        Body

        @@ -160,7 +160,7 @@

      • Create an ECS authenticated using the key pair.

        • API

          URI format: POST /v2/{tenant_id}/servers

          For details about API constraints and request parameters, see section "Creating an ECS" in Elastic Cloud Server API Reference.

          In this example, the ECS is created using a specified image. Therefore,

          -
          • In block_device_mapping_v2, set source_type to image, uuid to the image ID, destination_type to volume, and boot_index to 0.
          • The volume_size must be greater than or equal to the minimum value specified in the image metadata.
          +
          • In block_device_mapping_v2, set source_type to image, uuid to the image ID, destination_type to volume, and boot_index to 0.
          • The volume_size must be greater than or equal to the minimum value specified in the image metadata.
        • Request example

          POST: https://{endpoint}/v2/74610f3a5ad941998e91f076297ecf27/servers

          Obtain the endpoint from Regions and Endpoints.

          @@ -209,7 +209,7 @@ }

      • Verify the ECS creation.

        • API

          URI format: GET /v2/{tenant_id}/servers/{server_id}

          -

          For details, see section "Querying Details About an ECS" in Elastic Cloud Server API Reference.

          +

          For details, see section "Querying Details About an ECS" in Elastic Cloud Server API Reference.

        • Request example

          GET: https://{endpoint}/v2/74610f3a5ad941998e91f076297ecf27/servers/0c71c0da-8852-4c56-a1d1-3a9b9bcb6da6

          Where,

          0c71c0da-8852-4c56-a1d1-3a9b9bcb6da6 is the UUID of the created ECS.

          diff --git a/docs/ecs/dev/en-us_topic_0134192993.html b/docs/ecs/dev/en-us_topic_0134192993.html index 572efe0f..423cc34f 100644 --- a/docs/ecs/dev/en-us_topic_0134192993.html +++ b/docs/ecs/dev/en-us_topic_0134192993.html @@ -9,7 +9,7 @@
          • API for modifying the specifications of an ECS
          • API for confirming ECS specifications modification
          • API for rolling back ECS specifications modification

          Procedure

          1. Modify the ECS specifications.

            • API

              URI format: POST /v2/{tenant_id}/servers/{server_id}/action

              -

              For details, see section "Modifying the Specifications of an ECS" in Elastic Cloud Server API Reference.

              +

              For details, see section "Modifying the Specifications of an ECS" in Elastic Cloud Server API Reference.

            • Request example
              {
     "resize": {
                   "flavorRef": "4"
@@ -18,7 +18,7 @@
            • Response example

              N/A

          2. Confirm the specifications modification.

            The ECS must be in resized state. That is, the OS-EXT-STS:vm_state value of the ECS must be resized.
            • API

              URI format: POST /v2/{tenant_id}/servers/{server_id}/action

              -

              For details, see section "Confirming ECS Specifications Modification" in Elastic Cloud Server API Reference.

              +

              For details, see section "Confirming ECS Specifications Modification" in Elastic Cloud Server API Reference.

            • Request example
              {
    "confirmResize": null
 }
              @@ -29,7 +29,7 @@

              The ECS must be in resized state. That is, the OS-EXT-STS:vm_state value of the ECS must be resized.

              The data modified during specifications modification will be lost after the rollback.

              • API

                URI format: POST /v2/{tenant_id}/servers/{server_id}/action

                -

                For details, see section "Rolling Back ECS Specifications Modification" in Elastic Cloud Server API Reference.

                +

                For details, see section "Rolling Back ECS Specifications Modification" in Elastic Cloud Server API Reference.

              • Request example
                {
     "revertResize": null
 }
                diff --git a/docs/ecs/dev/en-us_topic_0134193006.html b/docs/ecs/dev/en-us_topic_0134193006.html index 68093034..5899273f 100644 --- a/docs/ecs/dev/en-us_topic_0134193006.html +++ b/docs/ecs/dev/en-us_topic_0134193006.html @@ -1,15 +1,15 @@

                Microversions

                -

                v2.1 APIs support microversions for small/medium API changes or document changes.

                -

                Users can use a microversion to obtain the latest API microversion supported by a cloud service. A cloud service that has been upgraded to the latest microversion is compatible with the original microversions. Users can also use a microversion to obtain new cloud service properties.

                -

                The version API returns the minimum and maximum microversions. The client uses the two values to specify the microversion range supported by an API.

                +

                v2.1 APIs support microversions for small/medium API changes or document changes.

                +

                Users can use a microversion to obtain the latest API microversion supported by a cloud service. A cloud service that has been upgraded to the latest microversion is compatible with the original microversions. Users can also use a microversion to obtain new cloud service properties.

                +

                The version API returns the minimum and maximum microversions. The client uses the two values to specify the microversion range supported by an API.

                Microversion Response Example

                If the values of version and min_version are null, the endpoint does not support microversions.

                -
                • version: indicates the maximum microversion.
                • min_version: indicates the minimum microversion.
                -

                A microversion on the client must be within the range specified by version and min_version to access the endpoint. The client uses the following HTTP header to specify a microversion:

                -

                X-OpenStack-Nova-API-Version: 2.4

                -

                Since microversion 2.27, the client can also use the following header to specify a microversion:

                -

                Openstack-API-Version: compute 2.27

                +
                • version: indicates the maximum microversion.
                • min_version: indicates the minimum microversion.
                +

                A microversion on the client must be within the range specified by version and min_version to access the endpoint. The client uses the following HTTP header to specify a microversion:

                +

                X-OpenStack-Nova-API-Version: 2.4

                +

                Since microversion 2.27, the client can also use the following header to specify a microversion:

                +

                Openstack-API-Version: compute 2.27

                In the following response example, the maximum microversion is 2.14 and the minimum one is 2.1:

                {
   "versions": [
@@ -42,9 +42,8 @@
   ]
 }
                -

                Microversion Request Example

                For example, you are required to use the API for details about an ECS to view the OS-EXT-SRV-ATTR:hostname field.

                -
                -
                • Using a v2 API without a microversion
                  • GET: https://{endpoint}/v2/74610f3a5ad941998e91f076297ecf27/servers/detail

                    Obtain the endpoint from Regions and Endpoints.

                    +

                    Microversion Request Example

                    For example, you are required to use the API for details about an ECS to view the OS-EXT-SRV-ATTR:hostname field.

                    +
                    • Using a v2 API without a microversion
                      • GET: https://{endpoint}/v2/74610f3a5ad941998e91f076297ecf27/servers/detail

                        Obtain the endpoint from Regions and Endpoints.

                      • Headers
                        @@ -83,7 +82,7 @@ "metadata": {}, "OS-EXT-STS:task_state": null, "OS-DCF:diskConfig": "MANUAL", - "OS-EXT-AZ:availability_zone": "eu-de-01", + "OS-EXT-AZ:availability_zone":"az1-dc1", "links": [ { "rel": "self", @@ -144,9 +143,9 @@ } ] } -
                      • Conclusion: The response body does not contain the OS-EXT-SRV-ATTR:hostname field.
                        • +
                      • Conclusion: The response body does not contain the OS-EXT-SRV-ATTR:hostname field.
                        • -
                        • Using a v2.1 API with a microversion
                          • GET: https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/servers/detail

                            Obtain the endpoint from Regions and Endpoints.

                            +
                            • Using a v2.1 API with a microversion
                              • GET: https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/servers/detail

                                Obtain the endpoint from Regions and Endpoints.

                              • Headers

                        Content-Type
                        @@ -263,9 +262,10 @@ } ] } -
                      • Conclusion: The response body contains the OS-EXT-SRV-ATTR:hostname field.
                        • +
                      • Conclusion: The response body contains the OS-EXT-SRV-ATTR:hostname field.
                        • +
                        Parent topic: Request Format
                        diff --git a/docs/ecs/dev/en-us_topic_0134327704.html b/docs/ecs/dev/en-us_topic_0134327704.html index ea872ce8..1e6247f8 100644 --- a/docs/ecs/dev/en-us_topic_0134327704.html +++ b/docs/ecs/dev/en-us_topic_0134327704.html @@ -1,7 +1,7 @@

                        Notes

                        -

                        Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see section API Usage Guidelines.

                        +

                        Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see API Usage Guidelines.

                        diff --git a/docs/ecs/dev/en-us_topic_0134883593.html b/docs/ecs/dev/en-us_topic_0134883593.html index 0ac6f841..2440b015 100644 --- a/docs/ecs/dev/en-us_topic_0134883593.html +++ b/docs/ecs/dev/en-us_topic_0134883593.html @@ -8,7 +8,13 @@
                        - + + +

                        Content-Type

                        2021-10-20

                        +

                        2022-10-30

                        +

                        This issue is the third official release.

                        + +

                        2021-10-20

                        This issue is the second official release.

                        Optimized descriptions in Overview.

                        diff --git a/docs/ecs/dev/public_sys-resources/commonrtl.css b/docs/ecs/dev/public_sys-resources/commonrtl.css index 947a9a03..f261da75 100644 --- a/docs/ecs/dev/public_sys-resources/commonrtl.css +++ b/docs/ecs/dev/public_sys-resources/commonrtl.css @@ -1,2 +1,2 @@ -.msgph{font-family:Courier New}.unresolved{background-color:#87ceeb}.noTemplate{background-color:#ff0}.base{background-color:#fff}/*! Add space for top level topics */.nested0,.p{margin-top:1em}/*! div with class=p is used for paragraphs that contain blocks, to keep the XHTML valid *//*! Default of italics to set apart figure captions */.figcap,.italic,.var{font-style:italic}.figdesc{font-style:normal}/*! Use @frame to create frames on figures */.figborder{padding-left:3px;padding-right:3px;margin-top:1em;border:2px solid Silver}.figsides{margin-top:1em;padding-left:3px;padding-right:3px;border-left:2px solid Silver;border-right:2px solid Silver}.figtop{border-top:2px solid Silver;margin-top:1em}.figbottom{border-bottom:2px solid Silver}.figtopbot{border-top:2px solid Silver;border-bottom:2px solid Silver;margin-top:1em}/*! Most link groups are created with
                        . Ensure they have space before and after. */.ullinks,ul.simple{list-style-type:none}.attention,.danger,.ddexpand,.dlexpand,.example,.fastpath,.important,.liexpand,.linklist,.note,.notice,.olchildlink,.relconcepts,.relinfo,.relref,.reltasks,.remember,.restriction,.section,.sliexpand,.stepexpand,.substepexpand,.tip,.ulchildlink,.warning{margin-top:1em;margin-bottom:1em}.linklistwithchild,.sublinklist{margin-top:1em;margin-right:1.5em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-right:20px}/*! Set heading sizes, getting smaller for deeper nesting */.topictitle1{font-size:1.34em;margin-top:0;margin-bottom:.1em}.topictitle2,.topictitle3,.topictitle4,.topictitle5,.topictitle6,.sectiontitle{font-size:1.17em}.topictitle2{margin-top:1pc;margin-bottom:.45em}.topictitle3{margin-top:1pc;margin-bottom:.17em;font-weight:700}.topictitle4{margin-top:.83em;font-weight:700}.topictitle5{font-weight:700}.topictitle6{font-style:italic}.sectiontitle{margin-top:1em;margin-bottom:0;color:#000;font-weight:700}/*! All note formats have the same default presentation */.attentiontitle,.bold,.cautiontitle,.dangertitle,.dlterm,.fastpathtitle,.firstcol,.importanttitle,.notelisttitle,.notetitle,.noticetitle,.parmname,.remembertitle,.restrictiontitle,.tiptitle,.uicontrol,.warningtitle{font-weight:700}.caution{font-weight:700;margin-bottom:1em}/*! Simple lists do not get a bullet *//*! Used on the first column of a table, when rowheader="firstcol" is used *//*! Various basic phrase styles */.boldItalic{font-weight:700;font-style:italic}.shortcut,.underlined{text-decoration:underline}/*! 2008-10-27 keyword采用跟随上下文的样式 +/*! Copyright (c) Huawei Technologies Co., Ltd. 2020-2022. All rights reserved. */.msgph{font-family:Courier New}.unresolved{background-color:#87ceeb}.noTemplate{background-color:#ff0}.base{background-color:#fff}/*! Add space for top level topics */.nested0,.p{margin-top:1em}/*! div with class=p is used for paragraphs that contain blocks, to keep the XHTML valid *//*! Default of italics to set apart figure captions */.figcap,.italic,.var{font-style:italic}.figdesc{font-style:normal}/*! Use @frame to create frames on figures */.figborder{padding-left:3px;padding-right:3px;margin-top:1em;border:2px solid Silver}.figsides{margin-top:1em;padding-left:3px;padding-right:3px;border-left:2px solid Silver;border-right:2px solid Silver}.figtop{border-top:2px solid Silver;margin-top:1em}.figbottom{border-bottom:2px solid Silver}.figtopbot{border-top:2px solid Silver;border-bottom:2px solid Silver;margin-top:1em}/*! Most link groups are created with
                        . Ensure they have space before and after. */.ullinks,ul.simple{list-style-type:none}.attention,.danger,.ddexpand,.dlexpand,.example,.fastpath,.important,.liexpand,.linklist,.note,.notice,.olchildlink,.relconcepts,.relinfo,.relref,.reltasks,.remember,.restriction,.section,.sliexpand,.stepexpand,.substepexpand,.tip,.ulchildlink,.warning{margin-top:1em;margin-bottom:1em}.linklistwithchild,.sublinklist{margin-top:1em;margin-right:1.5em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-right:20px}/*! Set heading sizes, getting smaller for deeper nesting */.topictitle1{font-size:1.34em;margin-top:0;margin-bottom:.1em}.topictitle2,.topictitle3,.topictitle4,.topictitle5,.topictitle6,.sectiontitle{font-size:1.17em}.topictitle2{margin-top:1pc;margin-bottom:.45em}.topictitle3{margin-top:1pc;margin-bottom:.17em;font-weight:700}.topictitle4{margin-top:.83em;font-weight:700}.topictitle5{font-weight:700}.topictitle6{font-style:italic}.sectiontitle{margin-top:1em;margin-bottom:0;color:#000;font-weight:700}/*! All note formats have the same default presentation */.attentiontitle,.bold,.cautiontitle,.dangertitle,.dlterm,.fastpathtitle,.firstcol,.importanttitle,.notelisttitle,.notetitle,.noticetitle,.parmname,.remembertitle,.restrictiontitle,.tiptitle,.uicontrol,.warningtitle{font-weight:700}.caution{font-weight:700;margin-bottom:1em}/*! Simple lists do not get a bullet *//*! Used on the first column of a table, when rowheader="firstcol" is used *//*! Various basic phrase styles */.boldItalic{font-weight:700;font-style:italic}.shortcut,.underlined{text-decoration:underline}/*! 2008-10-27 keyword采用跟随上下文的样式 *//*! Default of bold for definition list terms *//*! Use CSS to expand lists with @compact="no" */.dltermexpand{font-weight:700;margin-top:1em}[compact="yes"]>li{margin-top:0}[compact="no"]>li{margin-top:.53em}/*! Align images based on @align on topic/image */div.imageleft,.text-align-left{text-align:left}div.imagecenter,.text-align-center{text-align:center}div.imageright,.text-align-right{text-align:right}div.imagejustify,.text-align-justify{text-align:justify}.cellrowborder{border-right:0;border-top:0;border-left:1px solid;border-bottom:1px solid}.row-nocellborder{border-left:hidden;border-right:0;border-top:0;border-bottom:1px solid}.cell-norowborder{border-top:0;border-bottom:hidden;border-right:0;border-left:1px solid}.nocellnorowborder{border:0;border-left:hidden;border-bottom:hidden}pre.codeblock,pre.screen{padding:5px;border:outset;background-color:#ccc;margin-top:2px;margin-bottom:2px;white-space:pre} \ No newline at end of file diff --git a/docs/ecs/dev/public_sys-resources/imageclose.gif b/docs/ecs/dev/public_sys-resources/imageclose.gif index 56818c26..3a3344af 100644 Binary files a/docs/ecs/dev/public_sys-resources/imageclose.gif and b/docs/ecs/dev/public_sys-resources/imageclose.gif differ diff --git a/docs/ecs/dev/public_sys-resources/imageclosehover.gif b/docs/ecs/dev/public_sys-resources/imageclosehover.gif index 3bcf231f..8699d5e3 100644 Binary files a/docs/ecs/dev/public_sys-resources/imageclosehover.gif and b/docs/ecs/dev/public_sys-resources/imageclosehover.gif differ diff --git a/docs/ecs/dev/public_sys-resources/imagemax.gif b/docs/ecs/dev/public_sys-resources/imagemax.gif index 49fe390b..99c07dc2 100644 Binary files a/docs/ecs/dev/public_sys-resources/imagemax.gif and b/docs/ecs/dev/public_sys-resources/imagemax.gif differ diff --git a/docs/ecs/dev/public_sys-resources/imagemaxhover.gif b/docs/ecs/dev/public_sys-resources/imagemaxhover.gif index 387b0a98..d01d77d6 100644 Binary files a/docs/ecs/dev/public_sys-resources/imagemaxhover.gif and b/docs/ecs/dev/public_sys-resources/imagemaxhover.gif differ diff --git a/docs/ecs/dev/public_sys-resources/macFFBgHack.png b/docs/ecs/dev/public_sys-resources/macFFBgHack.png index c6473b32..ec811470 100644 Binary files a/docs/ecs/dev/public_sys-resources/macFFBgHack.png and b/docs/ecs/dev/public_sys-resources/macFFBgHack.png differ