Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Elastic IP/ Referência de API/ APIs/ EIP Tag Management/ Batch Creating or Deleting EIP Tags
Atualizado em 2024-09-25 GMT+08:00
Ver PDF
Compartilhar

Batch Creating or Deleting EIP Tags

Function

This API is used to add multiple tags to or delete multiple tags from an EIP at a time.

This API is idempotent.

If there are duplicate keys in the request body when you add tags, an error is reported.

During tag creation, duplicate keys are not allowed. If a key already exists in the database, its value will be overwritten by the new duplicate key.

During tag deletion, if some tags do not exist, the operation is considered to be successful by default. The character set of the tags will not be checked. When you delete tags, the tag structure cannot be missing, and the key cannot be left blank or be an empty string.

URI

POST /v2.0/{project_id}/publicips/{publicip_id}/tags/action

Tabela 1 describes the parameters.

Tabela 1 Parameter description

Name

Mandatory

Description

project_id

Yes

Specifies the project ID.

publicip_id

Yes

Specifies the unique identifier of an EIP.

Request Message

  • Request parameter
    Tabela 2 Request header parameter

    Parameter

    Mandatory

    Type

    Description

    X-Auth-Token

    Yes

    String

    Specifies the user token. The token can be obtained by calling the IAM API used for obtaining a user token. The value of X-Subject-Token in the response header is the user token.
    Tabela 3 Request parameter

    Parameter

    Type

    Mandatory

    Description

    tags

    Array of tag objects

    Yes

    Specifies the tag object list. For details, see Tabela 4.

    action

    String

    Yes

    Specifies the operation. Possible values are as follows:

    • create
    • delete
    Tabela 4 tag objects

    Attribute

    Type

    Mandatory

    Description

    key

    String

    Yes
    • Specifies the tag key.
    • Cannot be left blank.
    • Can contain a maximum of 36 characters.
    • Can contain letters, digits, underscores (_), and hyphens (-).
    • The tag key of a VPC must be unique.

    value

    String

    Yes
    • Specifies the tag value.
    • Can contain a maximum of 43 characters.
    • Can contain letters, digits, underscores (_), periods (.), and hyphens (-).
  • Request example 1: Creating tags in batches 
    POST https://{Endpoint}/v2.0/{project_id}/publicips/{publicip_id}/tags/action

{
    "action": "create",
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        },
        {
            "key": "key2",
            "value": "value3"
        }
    ]
}
  • Request example 2: Deleting tags in batches 
    POST https://{Endpoint}/v2.0/{project_id}/publicips/{publicip_id}/tags/action

{
    "action": "delete",
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        },
        {
            "key": "key2",
            "value": "value3"
        }
    ]
}

Response Message

  • Response parameter

    None

  • Example response

    None

    Or

    {
       "code":"xxx",
       "message":"xxxxx"
}
Tópico principal: EIP Tag Management