Updated on 2026-06-25 GMT+08:00

Deleting a Gateway

Function

This API is used to delete a gateway.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    asm:mesh:deleteGateway

    Write

    mesh *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>

    -

    -

URI

POST /v2/meshes/{mesh_id}/gateways/{gateway}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

mesh_id

Yes

String

Mesh ID

gateway

Yes

String

Service name

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format)

Range:

  • application/json;charset=utf-8: The content is in JSON format and encoded using UTF-8.

  • application/json: The content is in JSON format.

X-Auth-Token

Yes

String

API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

Namespace

Yes

Map<String,String>

Namespace where the gateway to be deleted is located. The key is namespace, and the value is the namespace name.

Response Parameters

Status code: 200

The gateway is deleted.

Status code: 500

Table 4 Response body parameters

Parameter

Type

Description

errorCode

String

Error code

Example Requests

{
  "Namespace" : [ null ]
}

Example Responses

None

Status Codes

Status Code

Description

200

The gateway is deleted.

500

Internal error.

Error Codes

See Error Codes.